Pi-WiringPi-Reference-Serial
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().
Pour utiliser le port série, vous devez vous assurer que votre programme inclus la ligne suivante:
#include <wiringSerial.h>
fonctions
Le fonctions du port série s'appuie sur un file descriptor (fd) qui est un "descripteur de fichier" standard en Linux.
Vous pouvez utiliser les fonctions d'appels système standards read(), write(), etc. qui utilisent aussi ce file descriptor.
Par exemple, si vous désirez envoyer un large bloc de données binaires, vous pourriez utiliser la fonction write() pour les envoyer. En effet, les fonctions serialPutchar() ou serialPuts() ne seraient pas les plus appropriés.
Une fois wiringSerial inclus, les fonctions suivantes sont disponibles :
serialOpen
int serialOpen(char *device, int baud) ;
Ouvre et initialise le port série en spécifiant le débit (baud rate). Elle initialise le port en mode “raw” (un caractère à la fois sans translations). Le timeout de lecture est fixé à 10 secondes. La valeur retourné est le file descriptor (référence vers une structure décrivant un fichier) ou -1 en cas d'erreur. En cas d'erreur, la variable errno est initialisé avec le code d'erreur correspondant.
Paramètres:
- device: chaine de caractère identifiant le périphérique à ouvrir
- baud: le débit de la connexion série qui s'exprime en baud (les valeurs les plus communes sont 9600, 19200, 115200 bauds).
serialClose
void serialClose(int fd);
Ferme le périphérique série identifié par son file descriptor.
- fd: la structure file descriptor retournée lors de l'appel de serialOpen.
serialPutChar
void serialPutchar(int fd, unsigned char c);
Envoi un simple octet/byte sur le périphérique série identifié par le file descriptor.
Paramètres:
- fd: le file descriptor obtenu lors de lapper de la fonction sérialOpen. Permet d'identifier le port série.
- c: l'octet/byte à envoyer sur le port série.
serialPuts
void serialPuts(int fd, char *s);
Envoi une chaine de caractère (de type null-terminated) sur le port série identifié par le file descriptor.
Paramètres:
- fd: le file descriptor obtenu lors de lapper de la fonction serialOpen. Permet d'identifier le port série.
- s: chaîne de caractères à envoyer (chaine de type null terminated, qui se termine donc par le caractère 0x00).
serialPrintf
void serialPrintf (int fd, char *message, …) ;
Emule le système printf avec le port série identifié par son file descriptor.
serialDataAvail
int serialDataAvail(int fd);
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.
En cas d'erreur, la variable errno est initialisée avec le code d'erreur correspondant.
serialGetChar
int serialGetchar(int fd);
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);
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
La librairie wiringSerial à pour but de simplifier le contrôle du port série – ce qui est approprié pour la plupart des applications.
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).
Par exemple – si vous voulez placez la ligne série en mode 7 bits plus parité paire, vous aurez besoin de ceci...
Dans votre programme:
#include <termios.h>
Et des appels de fonctions:
struct termios options ;
tcgetattr (fd, &options) ; // Lire les options actuelles
options.c_cflag &= ~CSIZE ; // Masquer la "taille" ("''size''" en anglais)
options.c_cflag |= CS7 ; // Faire un "ou" pour le 7-bits
options.c_cflag |= PARENB ; // Activer la Parité - paire (even) par défaut
tcsetattr (fd, &options) ; // Activer les nouvelles options
La variable ‘fd’ utilisé ci-dessus est le file descriptor retourné par la fonction serialOpen().
Si vous voulez plus d'information sur les options possibles, vous pouvez consulter les pages man de tcgetattr.
man tcgetattr
Source: WiringPi.com. WiringPi est une libraire sous licence GPL écrite par Gordon Henderson. Crédit: wiringpi.com
Traduit de l'anglais par Meurisse D. pour MCHobby.be
Traduit avec l'accord de Gordon Henderson, créateur de wiringPi - Translated with authorization of Gordon Henderson, creator of wiringPi
Toute référence, mention ou extrait de cette traduction doit être explicitement accompagné du texte suivant : « Traduction par MCHobby (www.MCHobby.be) - Vente de kit et composants » avec un lien vers la source (donc cette page) et ce quelque soit le média utilisé.
L'utilisation commercial de la traduction (texte) et/ou réalisation, même partielle, pourrait être soumis à redevance. Dans tous les cas de figures, vous devez également obtenir l'accord du(des) détenteur initial des droits. Celui de MC Hobby s'arrêtant au travail de traduction proprement dit.