Pi-WiringPi-Reference-Serial - Historique des versions

Admin : /* La librairie série */

2013-10-12T20:32:54Z

La librairie série

Admin : /* Contrôle avancé du port série */

2013-10-12T20:32:22Z

Contrôle avancé du port série

Admin : /* Contrôle avancé du port série */

2013-10-12T20:25:15Z

Contrôle avancé du port série

Admin le 12 octobre 2013 à 20:04

2013-10-12T20:04:30Z

Admin le 12 octobre 2013 à 19:19

2013-10-12T19:19:48Z

Admin : Page créée avec « {{Pi-WiringPi-NAV}} == La librairie série == WiringPi includes a simplified serial port handling library. It can use the on-board serial port, or any USB serial device wit... »

2013-10-12T19:19:00Z

Page créée avec « {{Pi-WiringPi-NAV}} == La librairie série == WiringPi includes a simplified serial port handling library. It can use the on-board serial port, or any USB serial device wit... »

Nouvelle page

{{Pi-WiringPi-NAV}}

== La librairie série ==

WiringPi includes a simplified serial port handling library. It can use the on-board serial port, or any USB serial device with no special distinctions between them. You just specify the device name in the initial open function.

To use, you need to make sure your program includes the following file:

<nowiki>#include <wiringSerial.h></nowiki>

== fonctions ==
Then the following functions are available:

== serialOpen ==
int serialOpen (char *device, int baud) ;

This opens and initialises the serial device and sets the baud rate. It sets the port into “raw” mode (character at a time and no translations), and sets the read timeout to 10 seconds. The return value is the file descriptor or -1 for any error, in which case errno will be set as appropriate.

== serialClose ==
void serialClose (int fd) ;

Closes the device identified by the file descriptor given.

== serialPutChar==
void serialPutchar (int fd, unsigned char c) ;

Sends the single byte to the serial device identified by the given file descriptor.

== serialPuts ==
void serialPuts (int fd, char *s) ;

Sends the nul-terminated string to the serial device identified by the given file descriptor.

== serialPrintf ==
void serialPrintf (int fd, char *message, …) ;

Emulates the system printf function to the serial device.

== serialDataAvail ==
int serialDataAvail (int fd) ;

Returns the number of characters available for reading, or -1 for any error condition, in which case errno will be set appropriately.

== serialGetChar ==
int serialGetchar (int fd) ;

Returns the next character available on the serial device. This call will block for up to 10 seconds if no data is available (when it will return -1)

== serialFlush ==
void serialFlush(int fd);

This discards all data received, or waiting to be send down the given device.

Note: The file descriptor (fd) returned is a standard Linux file descriptor. You can use the standard read(), write(), etc. system calls on this file descriptor as required. E.g. you may wish to write a larger block of binary data where the serialPutchar() or serialPuts() function may not be the most appropriate function to use, in which case, you can use write() to send the data.

== Contrôle avancé du port série ==

The wiringSerial library is intended to provide simplified control – suitable for most applications, however if you need advanced control – e.g. parity control, modem control lines (via a USB adapter, there are none on the Pi’s on-board UART!) and so on, then you need to do some of this the “old fashioned” way.

For example – To set the serial line into 7 bit mode plus even parity, you need to do this…

In your program:

<nowiki>#include <termios.h></nowiki>

and in a function:

<nowiki>struct termios options ;
tcgetattr (fd, &options) ; // Read current options
options.c_cflag &= ~CSIZE ; // Mask out size
options.c_cflag |= CS7 ; // Or in 7-bits
options.c_cflag |= PARENB ; // Enable Parity - even by default
tcsetattr (fd, &options) ; // Set new options </nowiki>

The ‘fd’ variable above is the file descriptor that serialOpen() returns.

Please see the man page for tcgetattr for all the options that you can set.

man tcgetattr

{{Pi-WiringPi-TRAILER}}

@@ Ligne 3 : / Ligne 3 : @@
 == La librairie série ==
-WiringPi inclus une librairie simplifié de manipulation du port série. Elle est capable d'utiliser le port série de la carte ou n'importe quel port série USB sans aucune distinction particulière. Vous avez seulement besoin de spécifier le nom du périphérique lorsque vous ouvrez le port série avec la fonction serialOpen().
+{{bloc-etroit|text=WiringPi inclus une librairie simplifié de manipulation du port série. Elle est capable d'utiliser le port série de la carte ou n'importe quel port série USB sans aucune distinction particulière. Vous avez seulement besoin de spécifier le nom du périphérique lorsque vous ouvrez le port série avec la fonction serialOpen().
-Pour utiliser le port série, vous devez vous assurer que votre programme inclus la ligne suivante:
+Pour utiliser le port série, vous devez vous assurer que votre programme inclus la ligne suivante: }}
   <nowiki>#include <wiringSerial.h></nowiki>

@@ Ligne 89 : / Ligne 89 : @@
 Et des appels de fonctions:
   <nowiki>struct termios options ;
@@ Ligne 98 : / Ligne 97 : @@
 tcsetattr (fd, &options) ;   // Activer les nouvelles options </nowiki>
-The ‘fd’ variable above is the file descriptor that serialOpen() returns.
+La variable ‘fd’ utilisé ci-dessus est le ''file descriptor'' retourné par la fonction serialOpen().
-Please see the man page for tcgetattr for all the options that you can set.
+Si vous voulez plus d'information sur les options possibles, vous pouvez consulter les pages man de tcgetattr.
   man tcgetattr
 {{Pi-WiringPi-TRAILER}}

@@ Ligne 3 : / Ligne 3 : @@
 == La librairie série ==
-WiringPi includes a simplified serial port handling library. It can use the on-board serial port, or any USB serial device with no special distinctions between them. You just specify the device name in the initial open function.
+WiringPi inclus une librairie simplifié de manipulation du port série. Elle est capable d'utiliser le port série de la carte ou n'importe quel port série USB sans aucune distinction particulière. Vous avez seulement besoin de spécifier le nom du périphérique lorsque vous ouvrez le port série avec la fonction serialOpen().
-To use, you need to make sure your program includes the following file:
+Pour utiliser le port série, vous devez vous assurer que votre programme inclus la ligne suivante:
   <nowiki>#include <wiringSerial.h></nowiki>
 == fonctions ==
-Then the following functions are available:
+Le fonctions du port série s'appuie sur un ''file descriptor'' (fd) qui est un "descripteur de fichier" standard en Linux.
 === serialOpen ===
-  int serialOpen (char *device, int baud) ;
+  int serialOpen(char *device, int baud) ;
-This opens and initialises the serial device and sets the baud rate. It sets the port into “raw” mode (character at a time and no translations), and sets the read timeout to 10 seconds. The return value is the file descriptor or -1 for any error, in which case errno will be set as appropriate.
+Paramètres:
 === serialClose ===
-  void serialClose (int fd) ;
+  void serialClose(int fd);
-Closes the device identified by the file descriptor given.
+* '''fd''': la structure ''file descriptor'' retournée lors de l'appel de serialOpen.
 === serialPutChar ===
-  void  serialPutchar (int fd, unsigned char c) ;
+  void  serialPutchar(int fd, unsigned char c);
-Sends the single byte to the serial device identified by the given file descriptor.
+Envoi un simple octet/byte sur le périphérique série identifié par le ''file descriptor''.
 === serialPuts ===
-  void  serialPuts (int fd, char *s) ;
+  void  serialPuts(int fd, char *s);
-Sends the nul-terminated string to the serial device identified by the given file descriptor.
+Envoi une chaine de caractère (de type ''null-terminated'') sur le port série identifié par le ''file descriptor''.
 === serialPrintf ===
   void  serialPrintf (int fd, char *message, …) ;
-Emulates the system printf function to the serial device.
+Emule le système printf avec le port série identifié par son ''file descriptor''.
 === serialDataAvail ===
-  int serialDataAvail (int fd) ;
+  int serialDataAvail(int fd);
-Returns the number of characters available for reading, or -1 for any error condition, in which case errno will be set appropriately.
+Retourne le nombre de caractères disponible sur le port série pour une opération de lecture ou -1 en cas d'erreur quelconque.
 === serialGetChar ===
-   int serialGetchar (int fd) ;
+   int serialGetchar(int fd);
-Returns the next character available on the serial device. This call will block for up to 10 seconds if no data is available (when it will return -1)
+Retourne le prochain caractère disponible sur le port série. Cette fonction peut bloquer le processus jusqu'à 10 secondes s'il n'y a pas de donnée disponible (alors il retourne -1)
 === serialFlush ===
    void serialFlush(int fd);
-This discards all data received, or waiting to be send down the given device.
+Efface toutes les données reçues ou en attente d'envoi sur le port série spécifié par le ''file descriptor''.
 == Contrôle avancé du port série ==

@@ Ligne 78 : / Ligne 78 : @@
 == Contrôle avancé du port série ==
-The wiringSerial library is intended to provide simplified control – suitable for most applications, however if you need advanced control – e.g. parity control, modem control lines (via a USB adapter, there are none on the Pi’s on-board UART!) and so on, then you need to do some of this the “old fashioned” way.
+La librairie wiringSerial à pour but de simplifier le contrôle du port série – ce qui est approprié pour la plupart des applications.
-For example – To set the serial line into 7 bit mode plus even parity, you need to do this…
+Vous pourriez cependant avoir besoin d'un contrôle avancé – ex: contrôle de parité, contrôle de ligne modem (via un adaptateur USB, car il n'y en a pas sur l'UART du Pi!) et ainsi de suite. Si c'est le cas, vous aurez besoin de le faire à l'ancienne (ou à "la sauce Linux" si vous préférez).
-In your program:
+Par exemple – si vous voulez placez la ligne série en mode 7 bits plus parité paire, vous aurez besoin de ceci...
   <nowiki>#include <termios.h></nowiki>
-and in a function:
+Et des appels de fonctions:
   <nowiki>struct termios options ;
-tcgetattr (fd, &options) ;   // Read current options
+tcgetattr (fd, &options) ;   // Lire les options actuelles
-options.c_cflag &= ~CSIZE ;  // Mask out size
+options.c_cflag &= ~CSIZE ;  // Masquer la "taille" ("''size''" en anglais)
-options.c_cflag |= CS7 ;     // Or in 7-bits
+options.c_cflag |= CS7 ;     // Faire un "ou" pour le 7-bits
-options.c_cflag |= PARENB ;  // Enable Parity - even by default
+options.c_cflag |= PARENB ;  // Activer la Parité - paire (even) par défaut
-tcsetattr (fd, &options) ;   // Set new options </nowiki>
+tcsetattr (fd, &options) ;   // Activer les nouvelles options </nowiki>
 The ‘fd’ variable above is the file descriptor that serialOpen() returns.