Différences entre versions de « LCD-USB-TTL-Reference »

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche
 
(6 versions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
 
{{LCD-USB-TTL-NAV}}
 
{{LCD-USB-TTL-NAV}}
  
−
{{bloc-etroit|text=The command set is based on the Matrix Orbital specification. We added a few commands to support the RGB backlight and to adjust the size of the display (so one firmware can support 16x2 or 20x4) If you're using software that support Matrix Orbital displays, this backpack should work identically (if not, please let us know!)
+
== Introduction ==
 +
{{bloc-etroit|text=L'ensemble des commandes est basée sur sur les spécifications ''Matrix Orbital''. Adafruit à ajouté quelques commandes pour le support du rétro-éclairage RGB et pour ajuster la taille de l'afficheur (le firmware est capable de supporter les écrans 16x2 ou 20x4). Si vous utilisez un logiciel supportant les afficheurs ''Matrix Orbital'', ce backpack devrait fonctionner à l'identique (dans le cas contraire, prenez contact avec AdaFruit par l'intermédiaire de ses Forums!)
  
−
All commands start with the special character '''0xFE''' (in hex) which tells the backpack to watch for a special command next.}}
+
Toutes les commandes commencent par le caractère spécial '''0xFE''' (en Hexadécimal, valeur 255 en décimal) qui informe le backpack que le/les caractères suivants est une commande avec ses paramètres.}}
  
−
Basic commands:
+
== Commandes de base ==
−
{{bloc-etroit|text=.
+
{{bloc-etroit|text=Commandes de bases:
−
* Display On - 0xFE 0x42 - This command turns the display backlight on . The argument is how many minutes to stay on, the command is supported but we don't handle the timeout so that number is ignored
+
* '''Display On''' - 0xFE 0x42 - Cette commande active le rétro-éclairage. L'argument est le nombre de minutes que l'afficheur doit rester allumé. La commande est supportée mais backpack mais, par contre, il ne gère pas le time-out (de façon à ignorer ce nombre)
−
* Display On - 0xFE 0x46 - turn the display backlight off
+
* '''Display Off''' - 0xFE 0x46 - Désactive le rétro-éclairage.
−
* Set Brightness - 0xFE 0x99 - set the overall brightness of the backlight (the color component is set separately - brightness setting takes effect after the color is set). Setting is saved to EEPROM
+
* Set Brightness - 0xFE 0x99 - fixe la luminosité du du rétro-éclairage (la couleur est fixée séparément - la configuration de la luminosité ne prends effet qu'après avoir fixé la couleur). Ce paramètre est sauvé dans l'EEPROM
−
* Set & Save Brightness - 0xFE 0x98 - same as above
+
* '''Set & Save Brightness''' - 0xFE 0x98 - Identique à la commande ci-dessous
−
* Set Contrast - 0xFE 0x50 - set the display contrast. In general, around 180-220 value is what works well. Setting is saved to EEPROM
+
* '''Set Contrast''' - 0xFE 0x50 - configure le contraste de l'afficheur. En générale, une valeur entre 180 et 220 fonctionne correctement. Ce paramètre est sauvé dans l'EEPROM.
−
* Set & Save Contrast - 0xFE 0x91 - same as above
+
* '''Set & Save Contrast''' - 0xFE 0x91 - Identique à la commande ci-dessus.
 
}}
 
}}
  
−
* Autoscroll on - 0xFE 0x51 - this will make it so when text is received and there's no more space on the display, the text will automatically 'scroll' so the second line becomes the first line, etc. and new text is always at the bottom of the display
+
* '''Autoscroll on''' - 0xFE 0x51 - Défilement automatique. Le défilement automatique est activé lorsqu'il y a plus de texte reçu que de place sur l'écran.  Dans ce cas, le texte défile (''scroll'') automatiquement et, par conséquent, la deuxième ligne devient la première ligne, etc. Le nouveau texte est toujours affiché en bas de l'écran.
−
* Autoscroll off - 0xFE 0x52 - this will make it so when text is received and there's no more space on the display, the text will wrap around to start at the top of the display.
+
* '''Autoscroll off''' - 0xFE 0x52 - Désactive de défilement automatique. Quand l'afficheur reçoit du texte et s'il n'y a plus de place à l'écran alors l'afficheur recommence en haut à gauche de l'écran pour poursuivre l'affichage.
−
* Clear screen - 0xFE 0x58 - this will clear the screen of any text
+
* '''Clear screen''' - 0xFE 0x58 - efface le contenu de l'écran LCD
−
* Change startup splash screen - 0xFE 0x40 - after sending this command, write up to 32 characters (for 16x2) or up to 80 characters (for 20x4) that will appear as the splash screen during startup. If you don't want a splash screen, write a bunch of spacesMoving and changing the cursor:
+
* '''Change startup splash screen''' - 0xFE 0x40 - Change le message au démarrage du LCD (le ''splash screen''). Après l'envoi de cette commande, vous devez envoyer 32 caractères (pour un LCD 16x2) ou jusqu'a 80 caractères (pour un LCD 20x4). Si vous ne voulez pas de ''splash screen'', écrivez une série d'espace
  
−
* Set cursor position - 0xFE 0x47 - set the position of text entry cursor. Column and row numbering starts with 1 so the first position in the very top left is (1, 1)
+
== Commandes de déplacement & modification de curseur ==
−
* Go home - 0xFE 0x48 - place the cursor at location (1, 1)
 
−
* Cursor back - 0xFE 0x4C - move cursor back one space, if at location (1,1) it will 'wrap' to the last position.
 
−
* Cursor forward - 0xFE 0x4D - move cursor back one space, if at the last location location it will 'wrap' to the (1,1) position.
 
−
* Underline cursor on - 0xFE 0x4A - turn on the underline cursor
 
−
* Underline cursor off - 0xFE 0x4B - turn off the underline cursor
 
−
* Block cursor on - 0xFE 0x53 - turn on the blinking block cursor
 
−
* Block cursor off - 0xFE 0x54 - turn off the blinking block cursor
 
  
−
RGB Backlight and LCD size
+
* '''Set cursor position''' - 0xFE 0x47 - Déplace la position du curseur. Le numéro de colonne (''column'') et ligne (''row'') commencent à 1. La première position en haut à gauche est 1, 1
 +
* '''Go home''' - 0xFE 0x48 - Retourné à l'emplacement d'origine. La position (1, 1)
 +
* '''Cursor back''' - 0xFE 0x4C - Déplace le curseur d'un caractère en arrière. Si la position est déjà (1,1) le curseur est déplacé à la dernière position de l'écran.
 +
* '''Cursor forward''' - 0xFE 0x4D - Déplace le curseur d'un caractère en avant. Si le curseur est à la dernière position, il est déplacé l'emplacement d'origine (1,1).
 +
* '''Underline cursor on''' - 0xFE 0x4A - Affiche le curseur souligné (dit ''underline'')
 +
* '''Underline cursor off''' - 0xFE 0x4B - Désactive le curseur souligné.
 +
* '''Block cursor on''' - 0xFE 0x53 - Active le curseur "bloc clignotant".
 +
* '''Block cursor off''' - 0xFE 0x54 - Désactive le curseur "bloc clignotant".
  
 +
== Rétroéclairage RGB et taille du LCD ==
  
−
* Set RGB Backlight Color - 0xFE 0xD0 - Sets the backlight to the red, green and blue component colors. The values of can range from 0 to 255 (one byte). This is saved to EEPROM. Each color R, G, and B is represented by a byte following the command. Color values range from 0 to 255. To set the backlight to Red, the command is 0xFE 0xD0 0x255 0x0 0x0. Blue is 0xFE 0xD0 0x0 0x0 0x255. White is 0xFE 0xD0 0x255 0x255 0x255.
+
* '''Set RGB Backlight Color''' - 0xFE 0xD0 - initialise les composantes rouge (''red''), vert (''green'') et bleu (''blue'') du rétro-éclairage. Les valeurs des couleurs doivent évoluer entre 0 et 255 (un octet/byte). La couleur est sauvée dans l'EEPROM. Chacune des couleurs R, G et B est représenté dans un byte/octet juste après la commande. Pour fiixer le rétro-éclairage à rouge, il faut envoyer la commande 0xFE 0xD0 0xFF 0x0 0x0. En bleu c'est 0xFE 0xD0 0x0 0x0 0xFF. En blanc c'est 0xFE 0xD0 0xFF 0xFF 0xFF.
−
* Set LCD size - 0xFE 0xD1 - You can configure the backpack to what size display is attached. This is saved to EEPROM so you only have to do it once.Custom Characters
+
* '''Set LCD size''' - 0xFE 0xD1 - Cette commande permet d'indiquer au backpack la taille de l'écran qui lui est attaché. Cette valeur est sauvé dans l'EEPROM et par conséquent, cette opération ne doit être réalisé qu'une seule fois.
−
* Create custom character - 0xFE 0x4E - this will create a custom character in spot . can be between 0 and 7 (8 spots). 8 bytes are sent which indicate how the character should appear
 
−
* Save custom character to EEPROM bank - 0xFE 0xC1 - this will save the custom character to EEPROM bank for later use. There are 4 banks and 8 locations per bank.
 
−
* Load custom characters from EEPROM bank - 0xFE 0xC0 - this will load all 8 characters saved to an EEPROM bank into the LCD's memoryGeneral Purpose Output
 
  
−
The general purpose outputs are 4 pins that are not used by the backpack, you can set these pins high or low.GPO1 is labeled PB0, GPO2 is labeled PC2, GPO3 is labeled PC4 and GPO4 is PC7
+
== Caractères personnalisés ==
 +
* '''Create custom character''' - 0xFE 0x4E - Crée un caractère personnalisé dans un emplacement de stockage donné (une position). Cette position doit être entre 0 et 7 (8 il y a 8 emplacements mémoire pour stocker des caractères personnalisés). 8 octets.bytes sont envoyés pour indiquer au backpack comment il doit être affiché.
 +
* '''Save custom character to EEPROM bank''' - 0xFE 0xC1 - Sauver le caractère personnalisé dans une ''bank'' de l'EEPROM pour pouvoir les réutiliser plus tard. Il y a 4 ''bank'' de stockage et 8 positions par ''bank''.
 +
* '''Load custom characters from EEPROM bank''' - 0xFE 0xC0 - Cela charge les 8 caractères sauvés dans une ''bank'' de l'EEPROM dans la mémoire du LCD.
  
−
* GPO Off - 0xFE 0x56 - set the general purpose pin to LOW (0V)
+
== Les sorties d'usage Général ==
−
* GPO On - 0xFE 0x57 - set the general purpose pin to HIGH (5V)
+
Comme il ne s'agit que de sorties, ces dernières sont appelées GPO pour ''General Purpose Output''.
−
* GPO Start State - 0xFE 0xC3 - sets the 'initial' stae of the GPO pin Not handled!
 
  
−
* Set auto-line-wrap on - 0xFE 0x43- and Set auto-line-wrap off - 0xFE 0x44- are not supported. We found that having auto-line wrap off was just not very useful so its automatically on all the time.
+
Il reste 4 broches non utilisés par le backpack, elles sont mises à disposition à l'arrière (en breakout) et vous pouvez les passer au niveau haut ou bas.
−
* Initialize/Place Medium & Large Numbers, Horizontal bar and vertical bar -this is not supported
+
 
 +
Voici la correspondance GPOx et libellé sur la carte.
 +
* Le GPO1 porte le libellé PB0,
 +
* Le GPO2 porte le libellé PC2,
 +
* Le GPO3 porte le libellé PC4,
 +
* Le GPO4 porte le libellé PC7
 +
 
 +
* '''GPO Off''' - 0xFE 0x56 - Le niveau logique du GPOx est placé au niveau BAS/LOW (0V)
 +
* '''GPO On''' - 0xFE 0x57 - Le niveau logique du GPOx est placé au niveau HAUT/HIGH (5V)
 +
* '''GPO Start State''' - 0xFE 0xC3 - Initialise l'état 'initial' de la broche GPO
 +
 
 +
== Fonctionnalités non supportées ==
 +
 
 +
* '''Set auto-line-wrap on''' - 0xFE 0x43- et '''Set auto-line-wrap off''' - 0xFE 0x44- ne sont pas supportés. Adafruit pense que désactiver le retour à la ligne automatique n'est pas vraiment utile. Par conséquent, l'option retour à la ligne est ''toujours activé''.
 +
* '''Initialize/Place Medium & Large Numbers, Horizontal bar and vertical bar''' - non supporté.
  
  
 
{{LCD-USB-TTL-TRAILER}}
 
{{LCD-USB-TTL-TRAILER}}

Version actuelle datée du 27 juillet 2014 à 21:21


MCHobby investit du temps et de l'argent dans la réalisation de traduction et/ou documentation. C'est un travail long et fastidieux réalisé dans l'esprit Open-Source... donc gratuit et librement accessible.
SI vous aimez nos traductions et documentations ALORS aidez nous à en produire plus en achetant vos produits chez MCHobby.

Introduction

L'ensemble des commandes est basée sur sur les spécifications Matrix Orbital. Adafruit à ajouté quelques commandes pour le support du rétro-éclairage RGB et pour ajuster la taille de l'afficheur (le firmware est capable de supporter les écrans 16x2 ou 20x4). Si vous utilisez un logiciel supportant les afficheurs Matrix Orbital, ce backpack devrait fonctionner à l'identique (dans le cas contraire, prenez contact avec AdaFruit par l'intermédiaire de ses Forums!)

Toutes les commandes commencent par le caractère spécial 0xFE (en Hexadécimal, valeur 255 en décimal) qui informe le backpack que le/les caractères suivants est une commande avec ses paramètres.

Commandes de base

Commandes de bases:

  • Display On - 0xFE 0x42 - Cette commande active le rétro-éclairage. L'argument est le nombre de minutes que l'afficheur doit rester allumé. La commande est supportée mais backpack mais, par contre, il ne gère pas le time-out (de façon à ignorer ce nombre)
  • Display Off - 0xFE 0x46 - Désactive le rétro-éclairage.
  • Set Brightness - 0xFE 0x99 - fixe la luminosité du du rétro-éclairage (la couleur est fixée séparément - la configuration de la luminosité ne prends effet qu'après avoir fixé la couleur). Ce paramètre est sauvé dans l'EEPROM
  • Set & Save Brightness - 0xFE 0x98 - Identique à la commande ci-dessous
  • Set Contrast - 0xFE 0x50 - configure le contraste de l'afficheur. En générale, une valeur entre 180 et 220 fonctionne correctement. Ce paramètre est sauvé dans l'EEPROM.
  • Set & Save Contrast - 0xFE 0x91 - Identique à la commande ci-dessus.
  • Autoscroll on - 0xFE 0x51 - Défilement automatique. Le défilement automatique est activé lorsqu'il y a plus de texte reçu que de place sur l'écran. Dans ce cas, le texte défile (scroll) automatiquement et, par conséquent, la deuxième ligne devient la première ligne, etc. Le nouveau texte est toujours affiché en bas de l'écran.
  • Autoscroll off - 0xFE 0x52 - Désactive de défilement automatique. Quand l'afficheur reçoit du texte et s'il n'y a plus de place à l'écran alors l'afficheur recommence en haut à gauche de l'écran pour poursuivre l'affichage.
  • Clear screen - 0xFE 0x58 - efface le contenu de l'écran LCD
  • Change startup splash screen - 0xFE 0x40 - Change le message au démarrage du LCD (le splash screen). Après l'envoi de cette commande, vous devez envoyer 32 caractères (pour un LCD 16x2) ou jusqu'a 80 caractères (pour un LCD 20x4). Si vous ne voulez pas de splash screen, écrivez une série d'espace

Commandes de déplacement & modification de curseur

  • Set cursor position - 0xFE 0x47 - Déplace la position du curseur. Le numéro de colonne (column) et ligne (row) commencent à 1. La première position en haut à gauche est 1, 1
  • Go home - 0xFE 0x48 - Retourné à l'emplacement d'origine. La position (1, 1)
  • Cursor back - 0xFE 0x4C - Déplace le curseur d'un caractère en arrière. Si la position est déjà (1,1) le curseur est déplacé à la dernière position de l'écran.
  • Cursor forward - 0xFE 0x4D - Déplace le curseur d'un caractère en avant. Si le curseur est à la dernière position, il est déplacé l'emplacement d'origine (1,1).
  • Underline cursor on - 0xFE 0x4A - Affiche le curseur souligné (dit underline)
  • Underline cursor off - 0xFE 0x4B - Désactive le curseur souligné.
  • Block cursor on - 0xFE 0x53 - Active le curseur "bloc clignotant".
  • Block cursor off - 0xFE 0x54 - Désactive le curseur "bloc clignotant".

Rétroéclairage RGB et taille du LCD

  • Set RGB Backlight Color - 0xFE 0xD0 - initialise les composantes rouge (red), vert (green) et bleu (blue) du rétro-éclairage. Les valeurs des couleurs doivent évoluer entre 0 et 255 (un octet/byte). La couleur est sauvée dans l'EEPROM. Chacune des couleurs R, G et B est représenté dans un byte/octet juste après la commande. Pour fiixer le rétro-éclairage à rouge, il faut envoyer la commande 0xFE 0xD0 0xFF 0x0 0x0. En bleu c'est 0xFE 0xD0 0x0 0x0 0xFF. En blanc c'est 0xFE 0xD0 0xFF 0xFF 0xFF.
  • Set LCD size - 0xFE 0xD1 - Cette commande permet d'indiquer au backpack la taille de l'écran qui lui est attaché. Cette valeur est sauvé dans l'EEPROM et par conséquent, cette opération ne doit être réalisé qu'une seule fois.

Caractères personnalisés

  • Create custom character - 0xFE 0x4E - Crée un caractère personnalisé dans un emplacement de stockage donné (une position). Cette position doit être entre 0 et 7 (8 il y a 8 emplacements mémoire pour stocker des caractères personnalisés). 8 octets.bytes sont envoyés pour indiquer au backpack comment il doit être affiché.
  • Save custom character to EEPROM bank - 0xFE 0xC1 - Sauver le caractère personnalisé dans une bank de l'EEPROM pour pouvoir les réutiliser plus tard. Il y a 4 bank de stockage et 8 positions par bank.
  • Load custom characters from EEPROM bank - 0xFE 0xC0 - Cela charge les 8 caractères sauvés dans une bank de l'EEPROM dans la mémoire du LCD.

Les sorties d'usage Général

Comme il ne s'agit que de sorties, ces dernières sont appelées GPO pour General Purpose Output.

Il reste 4 broches non utilisés par le backpack, elles sont mises à disposition à l'arrière (en breakout) et vous pouvez les passer au niveau haut ou bas.

Voici la correspondance GPOx et libellé sur la carte.

  • Le GPO1 porte le libellé PB0,
  • Le GPO2 porte le libellé PC2,
  • Le GPO3 porte le libellé PC4,
  • Le GPO4 porte le libellé PC7
  • GPO Off - 0xFE 0x56 - Le niveau logique du GPOx est placé au niveau BAS/LOW (0V)
  • GPO On - 0xFE 0x57 - Le niveau logique du GPOx est placé au niveau HAUT/HIGH (5V)
  • GPO Start State - 0xFE 0xC3 - Initialise l'état 'initial' de la broche GPO

Fonctionnalités non supportées

  • Set auto-line-wrap on - 0xFE 0x43- et Set auto-line-wrap off - 0xFE 0x44- ne sont pas supportés. Adafruit pense que désactiver le retour à la ligne automatique n'est pas vraiment utile. Par conséquent, l'option retour à la ligne est toujours activé.
  • Initialize/Place Medium & Large Numbers, Horizontal bar and vertical bar - non supporté.


Tutoriel USB + Serial RGB Backlight Character LCD Backpack créé par Tyler Cooper pour AdaFruit Industries.

Tutoriel traduit et augmenté par Meurisse D. pour MCHobby.be

Traduit avec l'autorisation d'AdaFruit Industries - Translated with the permission from Adafruit Industries - www.adafruit.com

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.

Récupérée de « https://wiki.mchobby.be/index.php?title=LCD-USB-TTL-Reference&oldid=11329 »