Ligne 1 : |
Ligne 1 : |
| {{Rasp-Hack-Led-Backpack-NAV}} | | {{Rasp-Hack-Led-Backpack-NAV}} |
| | | |
− | {{traduction}}
| + | == Sommaire == |
| + | Si vous êtes intéressé d'écrire votre propre code, la manière la plus simple est de partir des exemples disponible avec le pilote Python (les fichiers .py commençant par 'ex_'), mais l'information suivante sera également fort utile. |
| | | |
− | == Sommaire ==
| + | '''Mémoire tampon - Buffer:''' |
− | If you're interested in writing your own code, the easy way is to start with the examples in the code repository (the .py files starting with 'ex_'), but the following information may be helpful as well.
| + | |
| + | Le HT16K33 qui constitue le Led backpack/contrôleur contient une mémoire interne de 8 lignes, chaque ligne étant composée de 16 bits de données. Cette mémoire tampon est souvent appelée "buffer", un anglicisme souvent usité par facilité. |
| + | |
| + | Chaque ligne de donnée correspond en général: |
| + | * A un des caractères 7 segments de l'afficheur 4x7 segments OU |
| + | * A une ligne de point (''pixels'') d'un afficheur matrice 8x8. |
| + | |
| + | La librairie dispose donc aussi de fonction permettant de manipuler ce buffer :-) |
| | | |
| == Adafruit_LEDBackpack == | | == Adafruit_LEDBackpack == |
− | All of the low-level IO and I2C access is passed through A'''dafruit_LEDBackpack.py''', which is used by all of the other classes and examples in the library. This file implements a class named '''LEDBackpack''', which has the following functions:
| + | Tous les accès de bas niveau IO et I2C sont pris en charge par '''Adafruit_LEDBackpack.py'''. '''Adafruit_LEDBackpack.py''' est utilisé dans toutes les autres classes et exemples de la librairie. |
| + | |
| + | Ce fichier implémente une classe nommée '''LEDBackpack''', qui dispose des fonctions suivantes: |
| | | |
− | === setBrightness === | + | === Luminotisté === |
| setBrightness(brightness) | | setBrightness(brightness) |
| | | |
− | Sets the display brightness with a value between 0 and 15
| + | Permet de fixer la brillance de tout l'afficheur avec une valeur entre 0 et 15 |
| | | |
− | === setBlinkRate === | + | === Clignotement === |
| setBlinkRate(blinkRate) | | setBlinkRate(blinkRate) |
| | | |
− | Sets the optional blink rate for the display, with one of the following values for blinkRate
| + | Permet de fixer le clignotement (aussi que sa vitesse) de l'afficheur. |
− |
| + | Faire clignoter l'afficheur est optionnel... mais peut être utile. |
− | * 0 = No Blinking
| |
− | * 1 = Blink at 2Hz
| |
− | * 2 = Blink at 1Hz
| |
− | * 3 = Blink at 1/2 Hz
| |
| | | |
− | === setBufferRow === | + | Le paramètre blinkRate peut prendre l'une des valeurs suivantes: |
| + | * 0 = pas de clignotement (affichage fixe) |
| + | * 1 = Clignoter à 2Hz (2 fois par seconde) |
| + | * 2 = Clignoter à 1Hz (1 fois par seconde) |
| + | * 3 = clignoter à 1/2 Hz (1 fois toutes les deux secondes) |
| + | |
| + | === MàJ mémoire tampon === |
| setBufferRow(row, value) | | setBufferRow(row, value) |
| | | |
− | Updates a single row of data. The HT16K33 contains an internal memory of 8 rows, with each row having 16 bits of data. Each row generally corresponds to one character on a 7-segment display or one row of pixels on an 8x8 display. | + | Effectue la mise à jour d'une ligne de donnée (''Updates a single row of data'') dans la mémoire tampon du HT16K33. Cette mémoire tampon est généralement appelée "Buffer" (terme anglais très usité en langue française). |
| | | |
− | === getBuffer === | + | Le HT16K33 contient une mémoire interne de 8 lignes, chaque ligne étant composée de 16 bits de données. |
| + | |
| + | Chaque ligne de donnée correspond également (en général): |
| + | * A un des caractères 7 segments de l'afficheur OU |
| + | * A une ligne de point (''pixels'') d'un afficheur matrice 8x8. |
| + | |
| + | === Lire la mémoire tampon === |
| getBuffer() | | getBuffer() |
| | | |
− | Returns a list of 8 16-bit values representing the current state of the internal buffer, which can be used to update the display without affecting the rest of the content.
| + | Permet d'obtenir le contenu de la mémoire tampon (aussi appelé "Buffer") du HT16K33. |
| + | |
| + | Retourne une liste de 8 valeurs 16-bit représentant l'état interne actuel du buffer. |
| + | |
| + | Cette fonction est utile si vous voulez rafraichir l'état de l'afficheur sans modifier le reste de son contenu. |
| + | Exemple pratique... faire clignoter juste un point (dans un coin)... peu importe l'image affichée. |
| | | |
− | === clear === | + | === Effacer === |
| clear() | | clear() |
| | | |
− | Clears the contents of the entire buffer
| + | Nettoie/efface tout le contenu de la mémoire tampon (buffer). |
| | | |
| == Adafruit_7Segment == | | == Adafruit_7Segment == |
− | The 7-Segment library is encapsulated in the file '''Adafruit_7Segment.py''', and implements a class named '''SevenSegment''' (since class names can't start with a digit). It instantiates and instance of '''Adafruit_LEDBackpack''' internally, and you normally won't need to use the lower level class directly. It implements the following functions:
| + | La librairie 7-Segment est encapsulée dans le fichier '''Adafruit_7Segment.py''' et implémente une classe nommée '''SevenSegment''' (littéralement "sept segments"). |
| + | La classe est nommée comme tel car en Python, il est interdit de commencer un nom de classe par un chiffre ("7segment" serait invalide). |
| | | |
− | === writeDigitRaw === | + | En interne, la casse '''SevenSegment''' crée une instance de la classe '''Adafruit_LEDBackpack''', et vous ne devriez pas avoir besoin d'utiliser directement l'instance de AdaFruit_LEDBackpack. |
| + | |
| + | La classe '''SevenSegment''' implémente les fonctions suivantes: |
| + | |
| + | === Ecriture brute d'un caractère === |
| writeDigitRaw(charNumber, value) | | writeDigitRaw(charNumber, value) |
| | | |
− | This will raw a raw 16-bit value to the specified charNumber, which corresponds to a single row in the HT16K33, and one character in the 4x7-segment displays. (Note: row 2 is the colon on most 4 character displays). You can use this to display custom characters that aren't supported natively by the current library.
| + | Permet d'écrite une valeur 16bit dans la ligne du buffer correspondant à un des caractères de l'afficheur 4x7 segment. |
| + | |
| + | Cette méthode dite "d'écriture de données brute"/"écriture brute" (write raw) permet de manipuler chaque segment de l'afficheur... et donc de concevoir de nouveau "caractères" ou animations :-) |
| + | |
| + | Pour rappel, le HT16K33 contient une mémoire tampon (buffer) de 8 lignes de 16bits. Chaque ligne correspondant à un caractère de l'afficheur. |
| | | |
− | === writeDigit === | + | === Ecriture d'un chiffre === |
| writeDigit(charNumber, value, dot=False) | | writeDigit(charNumber, value, dot=False) |
| | | |
− | Writes a single decimal (0..9) or hexadecimal (0..9 and A..F) character to the display, with charNumber being the character to update, and value being the digit. You can set a third optional argument, dot, to True to set the decimal place after each character.
| + | Ecrit une chiffre décimal (0..9, appelé ''digit'' en anglais) ou un caractère HexaDecimal (0..9 et A..F) sur l'afficheur. |
| + | |
| + | * '''charNumber''' (littéralement ''numéro de caractère'' indique la position du caractère à modifier). |
| + | * '''value''' indique le caractère à afficher. |
| + | * Le troisième caractère est optionel. placez le paramètre '''dot''' (littéralement ''point'') à True pour afficher/activer le point derrière le chiffre. |
| | | |
− | === setColon === | + | === Activer le double point === |
| setColon(state) | | setColon(state) |
| | | |
− | You can pass either True of False to this function to enable or disable the colon that is usually connected to row 2 of the HT16K33.
| + | L'afficheur dispose d'un "double point" au centre de l'afficheur 4x7-segments. |
| + | |
| + | Vous pouvez utiliser la valeur True ou False comme valeur pour le paramètre '''dot''')... pour activer/désactiver le double point qui est habituellement connecté à la ligne 2 du buffer du HT16K33. |
| | | |
| | | |
| == Adafruit_8x8.py == | | == Adafruit_8x8.py == |
− | The '''Adafruit_8x8.py''' file implements a class names '''EightByEight''' that can be used to drive 8x8 pixel square LED blocks. It contains the following functions:
| + | Le fichier '''Adafruit_8x8.py''' implémente la classe '''EightByEight''' qui est utilisée pour piloter une matrice LEDs de 8x8. |
| | | |
− | === writeRowRaw === | + | Cette classe implémente les fonctions suivantes: |
| + | |
| + | === Ecriture brute d'une ligne === |
| writeRowRaw(charNumber, value) | | writeRowRaw(charNumber, value) |
| | | |
− | This will update an entire row of data with the specified 16-bit value (though normally only the last 8-bits are used on one-color 8x8 displays. This is faster than setting individual pixels.
| + | Cette fonction modifiera une ligne entière de donnée dans la mémoire tampon du HT16K33. Elle y place la valeur 16bits spécifié dans le paramètre '''value''' (cependant dans le cas d'une matrice 8x8 à une seule couleur, seul les 8 derniers bits sont utilisés). |
| + | |
| + | C'est beaucoup plus rapide que d'activer point par point. |
| + | |
| + | Note: en anglais, un point graphique (celui d'un affichage) se nomme "pixels". C'est un terme que vous rencontrer souvent sur le net. |
| | | |
| === setPixel === | | === setPixel === |