*** EN CONSTRUCTION – NON VALIDER *

RÉFÉRENCES

Infos techniques Écran WAVESHARE ESP32-S3 Touch LCD 4.3B

Arduino Board Managers Tutorial (install Online)

Démo et pilotes : ESP32-S3-Touch-LCD-4.3B Demo.zip

Tutoriel de configuration : ESP32 avec écran, écran LCD tactile capacitif, 4,3 pouces, prend en charge le Wi-Fi et le Bluetooth

LVGL Documentation officielle

Waveshare SquareLine Studio

Tutoriel SquareLine Studio

bibliothèques esp-arduino/Panneau d’affichage ESP32

bibliothèques esp-arduino/ESP32_IO_Expander

Mise en route du WAVESHARE ESP32-S3 Touch LCD 4.3B

DÉMARRAGE

Le « WAVESHARE ESP32-S3 Touch LCD 4.3B » est livré avec un programme préinstallé. Relier le « WAVESHARE ESP32-S3 Touch LCD 4.3B » sur une source d’alimentation USB, le programme démarre automatiquement.

INSTALLATION DE L’ENVIRONNEMENT ARDUINO

Se référer à la partie Arduino de Wiki WAVESHARE ESP32-S3 Touch LCD 4.3B

Ajout du package ESP32 version 3.1.1

Faire l’installation « En Ligne » du package_esp32

Arduino Board Managers Tutorial

Installer « esp32 par Espressif Systems » la version 3.1.1

Ajout de la bibliothèque ESP32-S3 Display

Fichiers sources : contenu de « librairies » de Démo et pilotes : ESP32-S3-Touch-LCD-4.3B Demo.zip

Copier les fichiers dans votre répertoire « librairies » d’Arduino (selon votre configuration « La localisation du croquis »).

Vidéo d’installation de la bibliothèque

Essais de l’écran WAVESHARE ESP32-S3 Touch LCD4.3B avec les croquis de démonstration

Fichiers sources : contenu de « examples » : Démo et pilotes : ESP32-S3-Touch-LCD-4.3B Demo.zip

**** Démo : DrawColorBar ****

Ouvrir « 08_DrawColorBar.ino » avec l’IDE Arduino

Sélectionner la carte « Waveshare ESP32-S3-Touch-LCD-4.3B » et le port COM adéquat

Faire les sélections ci-dessous

Téléverser le programme dans le « Waveshare ESP32-S3-Touch-LCD-4.3B »

Le « Waveshare ESP32-S3-Touch-LCD-4.3B » affiche 3 barres de couleur graduées.

**** Démo : lvgl_Porting ****

Ouvrir « 09_lvgl_Porting.ino » avec l’IDE Arduino

Sélectionner la carte « Waveshare ESP32-S3-Touch-LCD-4.3B » et le port COM adéquat

Faire les sélections ci-dessous

Téléverser le programme dans le « Waveshare ESP32-S3-Touch-LCD-4.3B »

Le « Waveshare ESP32-S3-Touch-LCD-4.3B » affiche un ensemble de fenêtres qui s’interchangent.

**** Autres démos ****

Il est possible de sélectionner différents démos dans le croquis « 09_lvgl_Porting.ino ».

Modifier la ligne 98 et 95 comme suit : Ajouter « // » au début de la ligne 98 et enlever les « // » au début de la ligne 95.

Télécharger le croquis dans le « Waveshare ESP32-S3-Touch-LCD-4.3B ».

Suite au démarrage, le « Waveshare ESP32-S3-Touch-LCD-43B » affiche l’écran démo inclus à la livraison.

Exemples compris avec les démos

Il est possible de sélectionner différents exemples dans le croquis « 09_lvgl_Porting.ino ».

Modifier les lignes 7, 19, 89 et 95 comme suit :

Ajouter les « // » au début de la ligne 7
Enlever les « // » au début de la ligne 19
Enlever les « // » au début de la ligne 88
Ajouter les « // » au début de la ligne 95

Télécharger le croquis dans le « Waveshare ESP32-S3-Touch-LCD-4.3B ».

Suite au démarrage, le « Waveshare ESP32-S3-Touch-LCD-43B » affiche 2 boutons.

Autres exemples compris avec les démos

Les fichiers exemples se retrouvent dans le répertoire :

ESP32-S3-Touch-LCD-4.3B-Demo\ESP32-S3-Touch-LCD-4.3B-Demo\Arduino\libraries\lvgl\examples\widgets\

Modifier la ligne 88 en inscrivant l’exemple désiré :

ROTATION DE L’AFFICHAGE

Modifier la ligne 101 du fichier lvgl_v8.h

SOLUTION EN CAS DE MANQUE DE MÉMOIRE

Si le croquis est volumineux, il se peut que la mémoire soit insuffisante, dans ce cas une des solutions est de changer le partitionnement de la mémoire.

L’option Partition Scheme dans Arduino se réfère à la manière dont la mémoire flash est divisée pour une carte microcontrôleur, en particulier pour des cartes comme celles basées sur l’ESP32 ou l’ESP8266. Ces cartes disposent d’une mémoire flash qui peut être partitionnée de différentes manières pour répondre aux besoins spécifiques d’une application.

Contexte

Un microcontrôleur comme l’ESP32 possède une mémoire flash qui contient :

Le firmware : Le code que vous téléchargez et exécutez.
Le système de fichiers : Pour stocker des fichiers comme des images, des données ou des journaux.
Les données d’utilisateur : Variables ou configurations sauvegardées.
D’autres parties spécifiques : Comme la mémoire OTA (Over-The-Air updates) pour la mise à jour à distance.

La manière dont cet espace est partagé est définie par le Partition Scheme.

Les différentes options de Partition Scheme

Voici les principales configurations disponibles (en fonction du matériel utilisé) :

Default (par défaut) :
- Espace équilibré entre le firmware et le système de fichiers SPIFFS ou LittleFS.
- Convient pour des applications générales avec un peu de stockage pour les fichiers.
No OTA (pas de mise à jour Over-The-Air) :
- Tout l’espace disponible est alloué au firmware.
- Pas de prise en charge des mises à jour OTA.
- Convient pour des projets nécessitant un firmware volumineux sans besoin de mise à jour OTA.
Minimal SPIFFS :
- Une partition minimaliste pour le système de fichiers.
- Réduit l’espace de stockage des fichiers au minimum pour maximiser celui du firmware.
Large App :
- Espace maximal alloué pour le firmware de l’application.
- Réduit ou supprime complètement l’espace du système de fichiers.
- Idéal pour les applications complexes avec de gros firmwares.
Custom :
- Permet de définir manuellement la taille des partitions.
- Convient pour des besoins spécifiques où ni l’espace par défaut ni les autres schémas ne sont adaptés.

Comment sélectionner un Partition Scheme ?

Dans l’IDE Arduino :
- Lorsque vous sélectionnez une carte compatible (ESP32 ou ESP8266), vous verrez l’option Partition Scheme dans le menu Tools (Outils).
- Sélectionnez le schéma correspondant à vos besoins.
Basé sur le type de projet :
- Si vous avez besoin d’un grand espace pour stocker des fichiers (images, données), choisissez un schéma avec un grand SPIFFS ou LittleFS.
- Si vous n’utilisez pas OTA et avez un gros firmware, optez pour No OTA ou Large App.
- Si vous effectuez des mises à jour OTA, un schéma avec OTA support est nécessaire (par exemple, Default).

Exemple d’usage

Pour un projet où vous stockez des journaux et effectuez des mises à jour OTA :

Partition Scheme recommandé : Default.
Vous disposez d’un équilibre entre le firmware, le système de fichiers et la prise en charge OTA.

Pour un projet nécessitant uniquement un firmware volumineux sans fichiers :

Partition Scheme recommandé : Large App.

Pourquoi est-ce important ?

La sélection du schéma de partition affecte :

Les performances : Un firmware volumineux ou mal partitionné peut ne pas fonctionner correctement.
Les fonctionnalités : Certains schémas peuvent désactiver des fonctionnalités comme OTA.
Le stockage : Si vous manquez d’espace pour les fichiers ou le firmware, votre projet pourrait échouer.

En résumé, l’option Partition Scheme est cruciale pour configurer la mémoire flash de votre carte en fonction des besoins spécifiques de votre projet.

LA SOLUTION « CUSTOM »

Créer le fichier « partitions.csv » et le placer dans le même répertoire que le fichier « xxxxx.ino »

# Name, Type, SubType, Offset, Size, Flags

# Note: if you have increased the bootloader size, make sure to update the offsets to avoid overlap

nvs, data, nvs, 0x9000, 0x6000,

phy_init, data, phy, 0xf000, 0x1000,

factory, app, factory, 0x10000, 7M,

Choisir le cas échéant, la partition « Custom » lors des réglages

Voici une explication détaillée de cette partition scheme spécifique pour une carte ESP32 ou ESP8266 :

Format de la partition scheme

Chaque ligne suit ce format :
Nom, Type, Sous-type, Offset, Taille, Flags (optionnel)

Les colonnes décrivent comment chaque partition est utilisée dans la mémoire flash.

Détails des partitions dans ce schéma

NVS (Non-Volatile Storage)
- Ligne : nvs, data, nvs, 0x9000, 0x6000,
- Utilité : Stocke les données non volatiles, comme les paramètres de configuration ou des données persistantes.
- Détails :
  - Type : data
  - Sous-type : nvs (spécifie que cette partition est dédiée au stockage NVS).
  - Offset : 0x9000 (emplacement de départ dans la mémoire flash).
  - Taille : 0x6000 (6 kB).
- Note : Cette partition est essentielle pour les applications utilisant des données persistantes.
PHY_INIT
- Ligne : phy_init, data, phy, 0xf000, 0x1000,
- Utilité : Stocke les données d’initialisation pour la configuration radio (Wi-Fi et Bluetooth).
- Détails :
  - Type : data
  - Sous-type : phy (spécifique pour les données PHY).
  - Offset : 0xf000 (emplacement de départ).
  - Taille : 0x1000 (4 kB).
- Note : Indispensable pour le bon fonctionnement des communications sans fil.
Factory App
- Ligne : factory, app, factory, 0x10000, 8M,
- Utilité : Contient le firmware principal de l’application.
- Détails :
  - Type : app
  - Sous-type : factory (indique que c’est l’application principale chargée au démarrage).
  - Offset : 0x10000 (emplacement de départ, généralement après le bootloader).
  - Taille : 8M (8 MB, une grande partie de la mémoire flash est réservée au firmware).
- Note : Une partition volumineuse, adaptée pour un firmware complexe.

Explications supplémentaires

Bootloader (non mentionné)
Bien que non listé ici, le bootloader est généralement situé à l’adresse 0x0000 et occupe environ 0x8000 (32 kB). Si le bootloader est modifié ou agrandi, il faut ajuster les offsets des autres partitions pour éviter des chevauchements.
Offsets et alignement
- Les offsets sont alignés sur des multiples de 4 kB (taille de la page de mémoire flash) pour des raisons de performance.
- L’offset de 0x10000 pour la partition factory est classique après un bootloader standard (0x8000) et les partitions NVS et PHY_INIT.
Flags (optionnel)
Dans ce schéma, aucune partition n’a de drapeau spécifique défini. Les drapeaux sont rarement utilisés mais peuvent indiquer des options particulières pour des partitions.

Visualisation de la mémoire flash

Partition	Type	Offset	Taille	Description
Bootloader	Boot	`0x0000`	`0x8000`	Chargeur de démarrage (non listé)
NVS	Data	`0x9000`	`0x6000`	Stockage persistant (NVS)
PHY_INIT	Data	`0xf000`	`0x1000`	Configuration radio Wi-Fi/Bluetooth
Factory	App	`0x10000`	`8M`	Firmware principal de l’application

Points importants

Adapter les offsets si nécessaire
Si vous utilisez un bootloader personnalisé ou d’autres partitions supplémentaires, assurez-vous que les offsets ne se chevauchent pas.
Partition factory large
Avec une taille de 7M, ce schéma est parfait pour des firmwares volumineux ou des projets complexes.
Outils nécessaires
Utilisez les outils d’ESP-IDF ou l’IDE Arduino pour flasher le firmware tout en respectant ce schéma.

En résumé, ce schéma est conçu pour une application nécessitant un firmware complexe tout en réservant suffisamment d’espace pour les données persistantes et la configuration réseau.

Voici une version mise à jour du tableau avec la quantité de mémoire en mégaoctets (Mo) incluse pour chaque partition :

Partition	Type	Offset	Taille	Taille en Mo	Description
Bootloader	Boot	`0x0000`	`0x8000`	0.03125 Mo	Chargeur de démarrage (non listé)
NVS	Data	`0x9000`	`0x6000`	0.0234375 Mo	Stockage persistant (NVS)
PHY_INIT	Data	`0xf000`	`0x1000`	0.00390625 Mo	Configuration radio Wi-Fi/Bluetooth
Factory	App	`0x10000`	`8M`	8 Mo	Firmware principal de l’application

Notes

La taille en Mo est calculée comme suit :
Taille en Mo=Taille en bytes/(1024×1024)\text{Taille en Mo} = \text{Taille en bytes} / (1024 \times 1024)
- Exemple pour NVS : 0x6000=24,576 bytes0x6000 = 24,576 \, \text{bytes}, soit 24,576/1,048,576≈0.0234375 Mo24,576 / 1,048,576 \approx 0.0234375 \, \text{Mo}.
La partition Factory occupe 8 Mo.
Les partitions Bootloader, NVS et PHY_INIT sont très petites en comparaison, mais elles sont essentielles pour le fonctionnement du système.

Ce tableau donne une vue claire de la répartition en bytes et en Mo, permettant d’optimiser la gestion de la mémoire flash selon les besoins du projet.

******* EN CONSTRUCTION – NON VALIDER *****