Différences

Ci-dessous, les différences entre deux révisions de la page.

--- issue209:micro-ci_micro-la [2024/09/28 22:57] – d52fr
+++ issue209:micro-ci_micro-la [2024/10/01 15:43] (Version actuelle) – auntiee
@@ Ligne 8: / Ligne 8: @@
 There seem to be many variants of the CYD out there from many different vendors. The one I got (from Amazon) is made by AITRIP. Just make sure that you get a board that is described as ESP32-2432S028R. There seems to be at least three versions of this board (again from various manufacturers). Mine seems to be revision 3, and has not only the USB-C connector but also the old style USB micro. Both work to power and program the board, so if you don’t have a USB-C connector cable yet, you might want to look for the revision 3 board if you can find it.**
+CYD (Cheap Yellow Display) ESP-32
+Je vous salue à nouveau, chers frères et sœurs de la forme de vie sensible. Les choses ici, sur la plateforme d'atterrissage 2997 sur Terra, ne se sont toujours pas calmées au cours des deux derniers mois, mais j'espère qu'avec le début de l'automne, les choses se détendront un peu (avant les fêtes de fin d'année).
+Ce mois-ci, nous allons nous pencher sur l'ESP32-2432S028, ou Cheap Yellow Display - l'écran jaune bon marché. Bien sûr, celui que j'ai acheté est plus orange que jaune pour mes vieux yeux, mais je ne l'appellerai pas COD, puisque cela signifie normalement Collect On Delivery (payer à la livraison), ou une cause de mort. Je vais donc faire comme s'il était jaune et l'appeler CYD.
+Il s'agit d'une petite carte très soignée, pilotée par un ESP32-WROOM auquel est attaché un écran ILI9341 320 x 240. L'écran est également un écran tactile résistif, ce qui le rend plutôt agréable pour tenir lieu d'interface graphique ou pour devenir un plateau de jeu.
+Il semble qu'il y ait de nombreuses variantes du CYD chez différents vendeurs. Celui que j'ai acheté (sur Amazon) est fabriqué par AITRIP. Assurez-vous que vous obtenez une carte décrite comme ESP32-2432S028R. Il semble qu'il y ait au moins trois versions de cette carte (encore une fois de différents fabricants). La mienne semble être la révision 3 et possède non seulement le connecteur USB-C mais aussi le micro USB à l'ancienne. Les deux fonctionnent pour alimenter et programmer la carte, donc si vous n'avez pas encore de câble USB-C, vous devriez chercher la carte révision 3 si vous pouvez la trouver.
 **A quick note here on obtaining the board. There are MANY places that you can get this board from. I used Amazon and got a two-pack of the boards for about $35 USD. There are some places that show getting the board plus a front and back protective plate set for less than $5.00 USD. PLEASE don't fall for that. Even though the entire web page continually says that the board is included, it isn’t. Look for the board to cost somewhere between $12 USD and $20 USD in single quantities. PLEASE remember the old saying “If it seems too good to be true, it probably is”.
 As far as I can tell, there are at least four ways to program these boards. The first (and most prevalent on the Internet) is using the Arduino programming language and the Arduino IDE. There are lots of examples of this out there, so I won’t deal with this too much this month. The best place I’ve found is to look at the Random Nerds website (https://randomnerdtutorials.com/cheap-yellow-display-esp32-2432s028r/). This is a really good write up, BUT PLEASE go slowly and carefully. Follow the directions EXACTLY or it won’t work for you.**
+Une petite remarque sur l'obtention de la carte. Il y a BEAUCOUP d'endroits où vous pouvez vous procurer cette carte. J'ai utilisé Amazon et j'ai obtenu un pack de deux cartes pour environ 35 $ US. Certains sites indiquent qu'il est possible d'obtenir la carte ainsi qu'un ensemble de plaques de protection avant et arrière pour moins de 5,00 $ US. S'il vous plaît, ne tombez pas dans le panneau. Même si toute la page Web indique tout le temps que la carte est incluse, ce n'est pas le cas. Il faut s'attendre à ce que le prix de la carte se situe entre 12 et 20 dollars américains en quantités individuelles. N'oubliez pas le vieil adage : « Si cela semble trop beau pour être vrai, c'est probablement le cas. »
+Pour autant que je sache, il existe au moins quatre façons de programmer ces cartes. La première (et la plus répandue sur Internet) consiste à utiliser le langage de programmation Arduino et l'IDE Arduino. Il existe de nombreux exemples de cette méthode et je ne m'y attarderai donc pas trop ce mois-ci. Le meilleur endroit que j'ai trouvé est le site Web Random Nerds (https://randomnerdtutorials.com/cheap-yellow-display-esp32-2432s028r/). Il s'agit d'un très bon article, MAIS je vous prie d'y aller lentement et prudemment. Suivez les instructions EXACTEMENT ; sinon, ça ne fonctionnera pas.
 **The second way to program the board is to use MicroPython. There are many (but not as many as for the Arduino code) websites for this. The two very best drivers (currently) are at
@@ Ligne 20: / Ligne 36: @@
 Finally, there is a special GUI library called LVGL which works with this (and many other boards) that, for the moment, is best done using Arduino code. You can find a very good tutorial again at the Random Nerds site at https://randomnerdtutorials.com/lvgl-cheap-yellow-display-esp32-2432s028r/. Again, PLEASE go slowly and follow EVERY step.**
+La deuxième façon de programmer la carte est d'utiliser MicroPython. Il existe de nombreux sites Web (mais pas autant que pour le code Arduino) pour cela. Les deux meilleurs pilotes (actuellement) sont à https://github.com/jtobinart/MicroPython_CYD_ESP32-2432S028R et https://github.com/rdagger/micropython-ili9341/. Le premier lien renvoie également au second. Vous devez télécharger (ou cloner) les deux sites et mettre les bibliothèques qu'ils contiennent dans un dossier de travail spécial. Plus d'informations à ce sujet dans un instant.
+La troisième façon de programmer la carte est d'utiliser l'un des ESPHome. Cependant, je n'ai pas encore pris le temps d'étudier cette possibilité.
+Enfin, il existe une bibliothèque GUI spéciale appelée LVGL qui fonctionne avec cette carte (et beaucoup d'autres) et qui, pour l'instant, est plus facile à utiliser en utilisant le code Arduino. Vous pouvez trouver un très bon tutoriel sur le site Random Nerds à l'adresse https://randomnerdtutorials.com/lvgl-cheap-yellow-display-esp32-2432s028r/. Encore une fois, SVP, allez-y lentement et suivez CHAQUE étape.
 **There is a newish product called platformIO that is a plugin for Visual Studio code, and there are some good tutorials for the LVGL programming using this. I’ll address this in a future article.
@@ Ligne 26: / Ligne 49: @@
 Here is what the back of my board looks like. On the left, you can see the USB-C connector in the middle and the old style USB connector towards the bottom.**
+Il existe un relativement nouveau produit appelé platformIO qui est un plugin pour le code Visual Studio, et il y a quelques bons tutoriels pour la programmation LVGL en l'utilisant. J'en parlerai dans un prochain article.
+Pour utiliser LVGL sur MicroPython, vous devez créer votre propre micrologiciel MicroPython qui inclut le support pour LVGL. Croyez-moi, ce n'est pas à la portée de tout le monde. Cela nécessite l'installation de plusieurs kits d'outils et prend du temps à faire et à tester. J'essaierai de vous fournir des instructions étape par étape dans un futur proche.
+Voici à quoi ressemble l'arrière de ma carte. Sur la gauche, vous pouvez voir le connecteur USB-C au milieu et le connecteur USB à l'ancienne vers le bas.
 **Connectors
@@ Ligne 32: / Ligne 62: @@
 Using the (hopefully) included JST cable, the pins (looking from the display side of the board and the connector at the bottom) from left to right, are [in the table below].**
+Connecteurs
+Bien qu'il semble y avoir beaucoup de broches disponibles pour les capteurs et autres connexions, il n'y en a pas autant qu'on pourrait le penser. Le long du bas de la carte, au milieu, se trouve le slot MicroSD, et juste à droite de celui-ci se trouvent deux connecteurs JST qui semblent être conformes à la norme STEMMA Qwiic, mais ce n'est pas le cas. Ils mesurent 1,25 mm et les connecteurs Qwiic normaux sont juste un peu plus petits. Les deux cartes que j'ai achetées étaient équipées d'un connecteur à cet effet et la plupart des cartes que j'ai examinées semblent en être équipées également. Le connecteur CN1 (le plus proche de l'emplacement MicroSD) est normalement utilisé pour connecter des périphériques I2C. Malheureusement, le jeu de broches I2C « normal » de l'ESP-32 ne peut pas être utilisé, car le rétroéclairage occupe l'une de ces broches normales. J'ai créé un « tableau pense-bête » pour vous...
+En utilisant le câble JST (que j'espère inclus), les broches (en regardant du côté de l'écran de la carte et du connecteur en bas) de gauche à droite, sont [dans le tableau ci-dessous].
 **As I said, you can’t use the “normal” I2C pin assignment. You have to “roll your own”. Here is the MicroPython code, using an SI7021 Temp/Humidity sensor:
@@ Ligne 42: / Ligne 79: @@
 If you want to use a DHT11 or DHT22, you can use this pinout as well. Here’s (above) a pinout for the DHT22. You only need to use three of the four pins.And the MicroPython code to support it…**
+Comme je l'ai dit, vous ne pouvez pas utiliser l'affectation « normale » des broches I2C. Vous devez faire vos propres calculs. Voici le code MicroPython, utilisant un capteur de température/humidité SI7021 :
+i2c = SoftI2C(scl=Pin(27), sda=Pin(22), freq=100000)
+si7021 = SI7021(i2c)
+Bien sûr, vous devez d'abord importer la bibliothèque. Il peut s'agir de n'importe quel périphérique I2C tant que les broches sont définies correctement.
+Si vous voulez utiliser un DHT11 ou un DHT22, vous pouvez aussi utiliser ce brochage. Voici (ci-dessus) un brochage pour le DHT22. Vous n'avez besoin d'utiliser que trois des quatre broches... Et le code MicroPython pour le supporter :
 **# =========================
@@ Ligne 60: / Ligne 107: @@
 There are a couple of things here you need to be aware of. First, the red wire is NOT 3.3v, but a GPIO pin. Don’t try to use this to power your device. In addition, the yellow wire is the same GPIO pin as the blue wire on connector CN1. Why in the world they did this, I can not speculate. Just be aware that your best bet for using I2C devices… use CN1.**
+# =========================
+# initialize si7021 Temp & Humidity sensor
+# =========================
+import dht
+d = dht.DHT22(Pin(27))
+d.measure()
+Bien sûr, vous ne pouvez pas utiliser le dispositif DHT en même temps qu'un capteur I2C sur CN1.
+Si vous souhaitez utiliser le connecteur P3, voici son brochage (ci-dessous).
+Il y a deux choses dont vous devez être conscient. Tout d'abord, le fil rouge n'est PAS le 3.3v, mais une broche GPIO. N'essayez pas de l'utiliser pour alimenter votre appareil. De plus, le fil jaune est sur la même broche GPIO que le fil bleu sur le connecteur CN1. Je ne peux pas spéculer sur la raison pour laquelle ils ont fait cela. Sachez simplement que votre meilleure chance d'utiliser des périphériques I2C est d'utiliser CN1.
 **One other connector you should be aware of is the P1 connector, which is next to the USB-C Data/power port. This is mostly to be used as a SERIAL port. From top to button the pins are shown above.
@@ Ligne 68: / Ligne 134: @@
 One of the other things I should tell you about is that the screen isn’t your “normal” RGB display. It uses color565. You can find more information, and their justification for creating such a thing, at https://rgbcolorpicker.com/565.**
+Un autre connecteur que vous devez connaître est le connecteur P1, qui se trouve à côté du port de données/d'alimentation USB-C. Il est principalement destiné à être utilisé comme port SÉRIE. De haut en bas, les broches sont indiquées ci-dessus.
+Vous vous demandez peut-être pourquoi GPIO 01 et GPIO 03 sont marqués d'un point d'interrogation. C'est l'information dont je dispose et elle est incluse de cette façon. Je n'essaierais pas d'utiliser ces broches comme des broches GPIO à ce stade. Il faut faire plus de recherches !
+LED RVB intégrée
+Une des autres choses dont je dois vous parler est que l'écran n'est pas un écran RVB « normal ». Il utilise la norme color565. Vous pouvez trouver plus d'informations, et leur justification pour créer une telle chose, sur https://rgbcolorpicker.com/565.
 **Drivers
@@ Ligne 83: / Ligne 158: @@
 The IO connectors P1, P3 and CN1 are 4 pin 1.25mm JST connectors. At least one is included with most CYD boards.**
+Pilotes
+Le meilleur endroit que j'ai trouvé pour obtenir des pilotes pour MicroPython est https://awesome-micropython.com/.
+Comme je l'ai dit plus haut, les deux meilleurs pilotes (actuellement) se trouvent sur https://github.com/jtobinart/MicroPython_CYD_ESP32-2432S028R et sur https://github.com/rdagger/micropython-ili9341/.
+Notez que vous devez avoir les pilotes micropython-ili9341 pour pouvoir utiliser le pilote Micropython_CYD. Plus d'informations à ce sujet dans un instant.
+Connecteurs JST
+Le connecteur du haut-parleur (P4) nécessite un connecteur JST à 2 broches de 1,25 mm qui n'est généralement pas inclus.
+Les connecteurs d'E/S P1, P3 et CN1 sont des connecteurs JST à 4 broches de 1,25 mm. Au moins un de ces connecteurs est inclus dans la plupart des cartes CYD.
 **Since these JST connectors are NOT the same as “normal” STEMMA QT/Qwiic JST connectors that you can easily find, I dug around on Amazon.com and found a couple of candidates.However, I have NOT verified that these will work.
@@ Ligne 94: / Ligne 184: @@
 In case you want to “roll your own” connectors, there seems to be a DIY kit that contains 2,3,4,5,6,7,8,9 and 10 pin empty connectors with wires ready to insert into the blank connectors. Again, I don’t currently know if this is a good kit. You can check it out at…
 https://www.amazon.com/1-25mm-Connectors-Pre-Crimped-Pixhawk-Silicone/dp/B07S18D3RN/ref=sr_1_1_sspa?s=electronics&sr=1-1-spons&sp_csd=d2lkZ2V0TmFtZT1zcF9hdGY&psc=1**
+Comme ces connecteurs JST ne sont pas les mêmes que les connecteurs JST STEMMA QT/Qwiic « normaux » que vous pouvez facilement trouver, j'ai cherché sur Amazon.com et j'ai trouvé quelques candidats. Je n'ai PAS vérifié qu'ils fonctionneront.
+Pour le connecteur du HP (2 broches), vous pouvez essayer :
+https://www.amazon.com/Letool%C2%AE30-1-25mm-Female-Connector-Cables/dp/B013JRWCBU
+Pour les connecteurs IO (4 broches), vous pouvez essayer :
+https://www.amazon.com/Micro-Connector-Socket-1-25mm-Female/dp/B09DYLY95R/ref=sr_1_3?s=electronics&sr=1-3
+Au cas où vous voudriez « rouler vos propres » connecteurs, il semble qu'il existe un kit de bricolage qui contient des connecteurs vides à 2, 3, 4, 5, 6, 7, 8, 9 et 10 broches avec des fils prêts à être insérés dans les connecteurs vierges. Encore une fois, je ne sais pas si c'est un bon kit. Vous pouvez le consulter sur :
+https://www.amazon.com/1-25mm-Connectors-Pre-Crimped-Pixhawk-Silicone/dp/B07S18D3RN/ref=sr_1_1_sspa?s=electronics&sr=1-1-spons&sp_csd=d2lkZ2V0TmFtZT1zcF9hdGY&psc=1
 **MicroPython Coding
@@ Ligne 102: / Ligne 204: @@
 While you can use just the ili9341 drivers, there is a bit of a problem. This was designed to be a very generic low-level driver set, and can be used with any ili9341 display board, not just the one on the CYD board. The CYD driver set uses the ili9341 drivers and wraps all of the functions of the display driver, the touchscreen, and the RGB LEDs, into a higher level library that is MUCH easier to use and focuses on just the CYD board.**
+Codage en MicroPython
+Vous devez avoir cydr.py, ili9341.py, xpt2046.py, et xglcd_font.py sur le périphérique CYD, et NORMALEMENT ils sont placés dans un dossier nommé lib. Vous pouvez les placer à la racine du périphérique, mais il est d'usage de les placer dans le dossier lib.
+Je vais maintenant vous expliquer pourquoi vous avez besoin des deux jeux de pilotes CYD et ili9341.
+Bien que vous puissiez utiliser uniquement les pilotes ili9341, il y a un petit problème. Ce jeu de pilotes a été conçu pour être un jeu de pilotes de bas niveau très générique et peut être utilisé avec n'importe quelle carte d'affichage ili9341, pas seulement celle de la carte CYD. Le jeu de pilotes CYD utilise les pilotes ili9341 et enveloppe toutes les fonctions du pilote d'affichage, de l'écran tactile et des LEDs RVB, dans une bibliothèque de plus haut niveau qui est BEAUCOUP plus facile à utiliser et qui se concentre uniquement sur la carte CYD.
 **The ili9341.py driver concentrates on the Display board and some generic RGB LED functions. There are two other drivers included, which are xpt2046.py which deals with the touchscreen functions and the xglcd_font.py which allows you to use some different fonts instead of a very simple 8x8 font. The ili9341.py driver includes things like drawing lines, rectangles, circles and drawing text.
@@ Ligne 108: / Ligne 219: @@
 Another reason to use the CYD driver is that the ili9341 driver is so generic that the demo programs won’t run on the CYD because the SPI interface uses different pins that the generic interface provides by default. For example, the demos initialize the SPI interface like this (shown above).**
+Le pilote ili9341.py se concentre sur la carte d'affichage et quelques fonctions génériques des LED RVB. Deux autres pilotes sont inclus : xpt2046.py, qui gère les fonctions de l'écran tactile, et xglcd_font.py, qui permet d'utiliser des polices différentes au lieu d'une police 8x8 très simple. Le pilote ili9341.py permet de dessiner des lignes, des rectangles, des cercles et du texte.
+Le pilote CYD importe le pilote d'affichage et les bibliothèques d'écran tactile pour vous et fournit une interface unique qui est (comme je l'ai dit plus haut) BEAUCOUP plus facile à utiliser. Si vous souhaitez utiliser des polices spéciales, vous devrez les importer vous-même dans votre programme.
+Une autre raison d'utiliser le pilote CYD est que le pilote ili9341 est tellement générique que les programmes de démonstration ne fonctionneront pas sur le CYD parce que l'interface SPI utilise des broches différentes de celles que l'interface générique fournit par défaut. Par exemple, les démos initialisent l'interface SPI comme suit (voir ci-dessus).
 **You can see that, while the sck and mosi pins are the same between both drivers, the dc, cs and rst pins are all different. The CYD driver is already set up for this.
@@ Ligne 122: / Ligne 240: @@
 cyd.display.clear()**
+Vous pouvez voir que, alors que les broches sck et mosi sont les mêmes entre les deux pilotes, les broches dc, cs et rst sont toutes différentes. Le pilote CYD est déjà configuré pour cela.
+L'utilisation du pilote CYD est très simple. Tout d'abord, vous devez importer la bibliothèque, puis initialiser un objet de l'objet maître CDY.
+from cydr import CYD
+cyd = CYD(rgb_pwm=False, speaker_gain=512, displaywidth=320, display_height = 240, wifi_ssid=None, wif_password=None)
+La plupart des paramètres de l'objet CYD sont facultatifs. Notez que le support du wifi est également intégré au pilote CYD, ce qui le rend très flexible.
+Maintenant que nous avons instancié l'objet CYD et que nous l'avons nommé cyd, vous pouvez effacer l'affichage avec un simple appel comme celui-ci :
+cyd.display.clear()
 **To print text on the display is just as easy.
@@ Ligne 134: / Ligne 267: @@
 I’ve created a github repository at https://github.com/gregwa1953/MTMT-209 that will hold a few of the demo programs that I wrote for my CYD.**
+Il est tout aussi facile d'imprimer du texte sur l'écran.
+text = « Ceci est un test ! »
+cyd.display.draw_text8x8(xposition, yposition, text, colour)
+Dans la ligne d'initialisation, vous remarquerez que j'ai placé l'appareil en mode « paysage » avec le grand côté (320) de l'écran en haut et en bas et les petits côtés (240) à droite et à gauche.
+Dans ce mode, la position (0,0) se trouve dans le coin supérieur gauche de l'écran (lorsqu'il est orienté avec la prise USB sur le côté droit de l'appareil).
+J'ai créé un dépôt github à https://github.com/gregwa1953/MTMT-209 qui contiendra quelques-uns des programmes de démonstration que j'ai écrits pour mon CYD.
 **One of the demos that I’ve included is an app that uses the OpenWeatherMap API over a WIFI connection to get the current outside conditions of my location and a DHT22 Temp/Humidity sensor to show the inside temperature and humidity. Of course, they both use a different polling time. Here is a very poor image taken with my cell phone camera of the CYD screen.
@@ Ligne 140: / Ligne 286: @@
 Until next time, as always; stay safe, healthy, positive and creative!**
+L'une des démonstrations que j'ai incluses est une application qui utilise l'API OpenWeatherMap via une connexion WIFI pour obtenir les conditions extérieures actuelles de mon emplacement et un capteur DHT22 Temp/Humidity pour afficher la température et l'humidité à l'intérieur. Bien sûr, ils utilisent tous deux un temps d'interrogation différent. Voici une très mauvaise image de l'écran de la CYD prise avec l'appareil photo de mon téléphone portable.
+C'est tout pour ce mois-ci. Je suis certain que nous aborderons à nouveau la question de la CYD dans un prochain article.
+Jusqu'à la prochaine fois, comme toujours, restez en sécurité, en bonne santé, positifs et créatifs !
+// Texte en noir, page 40, encadré du haut //
+**BUT the CYD board has diﬀerent pins for the SPI conﬁguration.**
+ MAIS la carte CYD a des broches différentes pour la configuration SPI.