Pi-WiringPi-Reference-Setup-Functions - Historique des versions

Admin : /* wiringPiSetupSys */

2013-10-12T18:29:04Z

wiringPiSetupSys

Admin : /* Les fonctions d'initialisation */

2013-10-12T18:28:48Z

Les fonctions d'initialisation

Admin : /* Initialisation */

2013-10-12T18:28:05Z

Initialisation

Admin le 10 octobre 2013 à 11:22

2013-10-10T11:22:33Z

Admin : Page créée avec « {{Pi-WiringPi-NAV}} == Initialisation == There are four ways to initialise wiringPi. * int wiringPiSetup (void) ; * int wiringPiSetupGpio (void) ; * int wiringPiSetupPhys (v... »

2013-10-09T13:10:25Z

Page créée avec « {{Pi-WiringPi-NAV}} == Initialisation == There are four ways to initialise wiringPi. * int wiringPiSetup (void) ; * int wiringPiSetupGpio (void) ; * int wiringPiSetupPhys (v... »

Nouvelle page

{{Pi-WiringPi-NAV}}

== Initialisation ==
There are four ways to initialise wiringPi.
* int wiringPiSetup (void) ;
* int wiringPiSetupGpio (void) ;
* int wiringPiSetupPhys (void) ;
* int wiringPiSetupSys (void) ;

One of the '''setup''' functions <font color="red">'''must'''</font> be called at the start of your program or your program will fail to work correctly. You may experience symptoms from it simply not working to segfaults and timing issues.

=== Note ===
Note: wiringPi version 1 returned an error code if these functions failed for whatever reason. Version 2 returns always returns zero. After discussions and inspection of many programs written by users of wiringPi and observing that many people don’t bother checking the return code, I took the stance that should one of the wiringPi setup functions fail, then it would be considered a fatal program fault and the program execution will be terminated at that point with an error message printed on the terminal.

* If you want to restore the v1 behaviour, then you need to set the environment variable: WIRINGPI_CODES (to any value, it just needs to exist)

== Les fonctions d'initialisation ==
Voici les différentes méthodes d'initialisation disponibles.

=== wiringPiSetup(void) ===
wiringPiSetup(void);

This initialises wiringPi and assumes that the calling program is going to be using the wiringPi pin numbering scheme. This is a simplified numbering scheme which provides a mapping from virtual pin numbers 0 through 16 to the real underlying Broadcom GPIO pin numbers. See the pins page for a table which maps the wiringPi pin number to the Broadcom GPIO pin number to the physical location on the edge connector.

This function needs to be called with root privileges.

=== wiringPiSetupGpio(void) ===
wiringPiSetupGpio(void);

This is identical to above, however it allows the calling programs to use the Broadcom GPIO pin numbers directly with no re-mapping.

As above, this function needs to be called with root privileges, and note that some pins are different from revision 1 to revision 2 boards.

=== wiringPiSetupPhys(void) ===
wiringPiSetupPhys(void);

Identical to above, however it allows the calling programs to use the physical pin numbers on ''the P1 connector only''.

As above, this function needs to be called with root priviliges.

=== wiringPiSetupSys(void) ===
wiringPiSetupSys(void);

This initialises wiringPi but uses the /sys/class/gpio interface rather than accessing the hardware directly. This can be called as a non-root user provided the GPIO pins have been exported before-hand using the '''gpio''' program. Pin numbering in this mode is the native Broadcom GPIO numbers – the same as wiringPiSetupGpio() above, so be aware of the differences between Rev 1 and Rev 2 boards.

'''Note:'''

In this mode you can only use the pins which have been exported via the /sys/class/gpio interface before you run your program. You can do this in a separate shell-script, or by using the system() function from inside your program to call the '''gpio''' program.

Also note that some functions have no effect when using this mode as they’re not currently possible to action unless called with root privileges. (although you can use system() to call '''gpio''' to set/change modes if needed)

{{Pi-WiringPi-TRAILER}}

@@ Ligne 56 : / Ligne 56 : @@
 Dans ce mode, vous pouvez seulement utiliser les broches qui ont été exportées via l'interface ''/sys/class/gpio'' avant d'exécuter votre programme. Vous pouvez effectuer cette opération à l'aide d'un script shell séparé, ou en utilisant la fonction system() à l'intérieur de votre programme qui appelle le logiciel '''gpio'''.
-Notez également que certaines fonction n'ont aucun effet en utilisant ce mode puisqu'il ne leur est pas possible d'agir à moins d'être appelée avec le privilège ''root'' (administrateur). (
+Notez également que certaines fonction n'ont aucun effet en utilisant ce mode puisqu'il ne leur est pas possible d'agir à moins d'être appelée avec le privilège ''root'' (administrateur).
 Vous pouvez néanmoins utiliser system() pour faire un appel '''gpio''' afin de changer/initialiser les modes (si cela est nécessaire)
 {{Pi-WiringPi-TRAILER}}

@@ Ligne 22 : / Ligne 22 : @@
 Voici les différentes méthodes d'initialisation disponibles.
-=== wiringPiSetup(void) ===
+=== wiringPiSetup ===
   wiringPiSetup(void);
@@ Ligne 31 : / Ligne 31 : @@
 Cette fonction à besoin d'être appelée avec le privilège root (administrateur).
-=== wiringPiSetupGpio(void) ===
+=== wiringPiSetupGpio ===
   wiringPiSetupGpio(void);
@@ Ligne 38 : / Ligne 38 : @@
 Comme la précédente, cette fonction doit être appelée avec le privilège ''root'' (administrateur). Faite attention car certaines broches du connecteur GPIO sont différentes entre la révision 1 et la révision 2 des cartes.
-=== wiringPiSetupPhys(void) ===
+=== wiringPiSetupPhys ===
   wiringPiSetupPhys(void);
-Fonction identique à la précedente. Mais permet au programme appelant d'utiliser les numéros de broche physique sur ''le connecteur P1 seulement''.
+Fonction identique à la précédente. Mais permet au programme appelant d'utiliser les numéros de broche physique sur ''le connecteur P1 seulement''.
 Comme pour les autres, cette fonction soit être appelée avec les privilèges ''root''.
-=== wiringPiSetupSys(void) ===
+=== wiringPiSetupSys ===
   wiringPiSetupSys(void);

@@ Ligne 10 : / Ligne 10 : @@
 {{bloc-etroit|text=Une des fonctions '''setup''' <font color="red">'''doit'''</font> être appelée au démarrage de votre programme sinon votre programme ne fonctionnera pas correctement.
-Les symptômes que vous découvririez irait du "non fonctionnement" à l'erreur de segmentation (segfaults) en passant pas les erreurs de temps.
+Les symptômes que vous découvririez irait du "non fonctionnement" à l'erreur de segmentation (segfaults) en passant pas les erreurs de temps.}}
 === Note ===

@@ Ligne 8 : / Ligne 8 : @@
 * int wiringPiSetupSys (void) ;
-One of the '''setup''' functions <font color="red">'''must'''</font> be called at the start of your program or your program will fail to work correctly. You may experience symptoms from it simply not working to segfaults and timing issues.
+{{bloc-etroit|text=Une des fonctions '''setup''' <font color="red">'''doit'''</font> être appelée au démarrage de votre programme sinon votre programme ne fonctionnera pas correctement.
 === Note ===
-Note: wiringPi version 1 returned an error code if these functions failed for whatever reason. Version 2 returns always returns zero. After discussions and inspection of many programs written by users of wiringPi and observing that many people don’t bother checking the return code, I took the stance that should one of the wiringPi setup functions fail, then it would be considered a fatal program fault and the program execution will be terminated at that point with an error message printed on the terminal.
+La version 1  de wiringPi retournait un code d'erreur si l'une de ces fonctions échouait pour une raison quelconque.
-* If you want to restore the v1 behaviour, then you need to set the environment variable: WIRINGPI_CODES (to any value, it just needs to exist)
+la version Version 2 retourne toujours zéro. Après de nombreuses discussions et inspections de programme écrit par des utilisateurs de wiringPi, il apparait que peut d'utilisateur soient concerné par ce code de retour, Gordon en est arrivé au point de considérer que si une fonction setup de wiringPi échoue, cela serait alors considéré comme une erreur fatale du programme et que l'exécution du programme se termine à ce point avec l'affichage d'un message d'erreur sur le terminal.
 == Les fonctions d'initialisation ==
@@ Ligne 21 : / Ligne 25 : @@
   wiringPiSetup(void);
-This initialises wiringPi and assumes that the calling program is going to be using the wiringPi pin numbering scheme. This is a simplified numbering scheme which provides a mapping from virtual pin numbers 0 through 16 to the real underlying Broadcom GPIO pin numbers. See the pins page for a table which maps the wiringPi pin number to the Broadcom GPIO pin number to the physical location on the edge connector.
+Initialise wiringPi et par du principe que le programme appelant va utilisé le principe de numérotation wiringPi. C'est un schéma de numérotation simplifié qui fournit une correspondance ("''mapping''" en anglais) de broches virtuelle allant de 0 à 16 vers les vrais numéros de broches du GPIO Broadcom.
-This function needs to be called with root privileges.
+Voyez [[Pi-WiringPi-GPIO-Numbering|la page dédicacée aux numéros de broche]] pour une table de correspondance entre la numérotation wiringPi et la numération des broches du GPIO Broadcom GPIO et leur localisation physique sur le connecteur GPIO du pi.
 === wiringPiSetupGpio(void) ===
   wiringPiSetupGpio(void);
-This is identical to above, however it allows the calling programs to use the Broadcom GPIO pin numbers directly with no re-mapping.
+Fonction identique à la précédente, mais permet au programme appelant d'utiliser la numérotation des broches du GPIO Broadcom directement... et donc sans ''re-mapping''.
-As above, this function needs to be called with root privileges, and note that some pins are different from revision 1 to revision 2 boards.
+Comme la précédente, cette fonction doit être appelée avec le privilège ''root'' (administrateur). Faite attention car certaines broches du connecteur GPIO sont différentes entre la révision 1 et la révision 2 des cartes.
 === wiringPiSetupPhys(void) ===
   wiringPiSetupPhys(void);
-Identical to above, however it allows the calling programs to use the physical pin numbers on ''the P1 connector only''.
+Fonction identique à la précedente. Mais permet au programme appelant d'utiliser les numéros de broche physique sur ''le connecteur P1 seulement''.
-As above, this function needs to be called with root priviliges.
+Comme pour les autres, cette fonction soit être appelée avec les privilèges ''root''.
 === wiringPiSetupSys(void) ===
   wiringPiSetupSys(void);
-This initialises wiringPi but uses the /sys/class/gpio interface rather than accessing the hardware directly. This can be called as a non-root user provided the GPIO pins have been exported before-hand using the '''gpio''' program. Pin numbering in this mode is the native Broadcom GPIO numbers – the same as wiringPiSetupGpio() above, so be aware of the differences between Rev 1 and Rev 2 boards.
+Initialise également wiringPi mais utilise l'interface /sys/class/gpio plutôt que de faire des accès matériels direct. Peut-être appelé avec un privilège utilisateur ''non-root'' ayant exporté les broches du GPIO au préalable avec les programme '''gpio'''.
 '''Note:'''
-In this mode you can only use the pins which have been exported via the /sys/class/gpio interface before you run your program. You can do this in a separate shell-script, or by using the system() function from inside your program to call the '''gpio''' program.
+Dans ce mode, vous pouvez seulement utiliser les broches qui ont été exportées via l'interface ''/sys/class/gpio'' avant d'exécuter votre programme. Vous pouvez effectuer cette opération à l'aide d'un script shell séparé, ou en utilisant la fonction system() à l'intérieur de votre programme qui appelle le logiciel '''gpio'''.
-Also note that some functions have no effect when using this mode as they’re not currently possible to action unless called with root privileges. (although you can use system() to call '''gpio''' to set/change modes if needed)
+Vous pouvez néanmoins utiliser system() pour faire un appel '''gpio''' afin de changer/initialiser les modes (si cela est nécessaire)
 {{Pi-WiringPi-TRAILER}}