Skip to Content

Premiers pas avec T-Camera S3

0 Comments
Premiers pas avec T-Camera S3

Dans ce tutoriel, vous apprendrez comment démarrer avec la carte LILIGO T-Camera S3.

La LILYGO T-Camera S3 est une carte de développement compacte basée sur le microcontrôleur dual-core ESP32-S3 FN16R8, associée à un module caméra OV2640, 8 Mo de PSRAM et 16 Mo de mémoire flash.

Dans cet article, nous allons parcourir les étapes essentielles de configuration, comme l’installation des bibliothèques, du core ESP32, et la préparation du code pour un serveur web qui diffuse en streaming vidéo via Wi-Fi depuis la T-Camera S3 vers votre navigateur web.

Pièces requises

Vous aurez besoin d’une T-Camera S3 et d’un câble USB-C pour programmer la carte et tester les exemples de code. Les liens suivants vous indiquent où les obtenir.

LILYGO T-Camera S3

Find at Amazon

Câble USB-C

Find at Amazon

Makerguides is a participant in affiliate advertising programs designed to provide a means for sites to earn advertising fees by linking to Amazon, AliExpress, Elecrow, and other sites. As an Affiliate we may earn from qualifying purchases.

Matériel de la T-Camera S3

La LILYGO T-Camera S3 est une carte de développement utilisant le microcontrôleur dual-core ESP32‑S3FN16R8. Ce SoC fonctionne jusqu’à 240 MHz et inclut un support d’extension vectorielle, ce qui le rend adapté aux tâches d’apprentissage automatique et de vision. La carte intègre 8 Mo de PSRAM et 16 Mo de mémoire flash, permettant de stocker des modèles, des images ou des données de journalisation.

Front and back of the LILYGO T-Camera S3 board
Face avant et arrière de la carte LILYGO T-Camera S3 (source)

Composants

Pour la capture d’image, la carte intègre un module caméra OV2640 de 2 mégapixels (résolution UXGA 1622×1200) en standard ; une version optionnelle de 5 mégapixels est également disponible. Un petit écran OLED monochrome (0,96 pouce, 128×64 pixels) piloté par SSD1306 via I²C est inclus, offrant une interface visuelle simple ou un affichage de statut. Côté audio, un microphone est présent et un capteur de mouvement PIR fournit des capacités basiques de détection de mouvement sur la carte.

Connectivité

La connectivité est assurée par les radios WiFi 2,4 GHz (802.11 b/g/n) et Bluetooth 5 (LE) intégrées à l’ESP32-S3, permettant la communication sans fil et l’accès à distance. Un port USB-C fournit l’alimentation et l’accès au programmateur/debugger, et un connecteur JST 5 broches offre un accès I/O supplémentaire comme GPIO, UART, 3,3 V/5 V et masse. Les dimensions de la carte sont d’environ 69 × 28 × 18,5 mm. L’image ci-dessous montre le brochage de la carte :

Pinout of the LILYGO T-Camera S3 board
Brochage de la carte LILYGO T-Camera S3 (source)

Alimentation

La gestion de l’alimentation inclut la prise en charge de l’alimentation USB et un connecteur JST-GH pour une batterie Li-Po monocellulaire, rendant la carte adaptée aux déploiements portables. La carte expose également un bouton de démarrage et un bouton d’alimentation.

Spécifications techniques

Le tableau suivant résume les spécifications techniques de la carte LILYGO T-Camera S3 :

ParamètreSpécification
MicrocontrôleurESP32-S3FN16R8 dual-core (Tensilica LX7, jusqu’à 240 MHz)
PSRAM8 Mo
Mémoire Flash16 Mo
Module CaméraOV2640 (2 MP, UXGA 1622×1200) standard ; variante 5 MP optionnelle
ÉcranOLED 0,96″, 128×64 pixels, SSD1306 via I²C
Connectivité sans filWiFi 2,4 GHz 802.11 b/g/n ; Bluetooth 5.0 LE
Capteur de mouvementPIR (infrarouge passif)
Entrée audioMicrophone embarqué
Alimentation & rechargePort USB-C ; connecteur batterie Li-Po JST-GH
Dimensions de la carteEnviron 69 × 28 × 18,5 mm (carte) ; 75 × 35 × 12 mm (avec boîtier)
Interfaces de programmation & I/OUSB-C pour programmation

Installation des bibliothèques

Dans cette section, nous allons installer les bibliothèques nécessaires pour compiler le code pour la carte T-Camera S3. Rendez-vous sur le dépôt GitHub de LILYGO pour l’écran à LilyGo-Cam-ESP32S3. Cliquez sur le bouton vert « <> Code » puis sur « Download ZIP » pour télécharger le dépôt en fichier ZIP :

Ensuite, décompressez le fichier ZIP pour en extraire le contenu. Vous devriez voir les fichiers suivants dans le dossier décompressé nommé « LilyGo-Cam-ESP32S-master » :

Nous devons copier le contenu du dossier « lib » dans le dossier « libraries » de l’IDE Arduino. Sous Windows, le dossier « libraries » se trouve généralement sous :

C:\Users\<username>\OneDrive\Documents\Arduino\libraries

Comme ce dossier contient déjà des bibliothèques installées, je vous recommande de le renommer temporairement, par exemple en « _libraries », puis de créer un nouveau dossier nommé « libraries ». Ainsi, vous évitez les conflits avec vos bibliothèques déjà installées sans les perdre. Vous pourrez facilement revenir en arrière plus tard. L’image ci-dessous montre à quoi devrait ressembler votre dossier « Arduino » avec les bibliothèques :

Ensuite, copiez les fichiers du dossier « lib » dans le nouveau dossier « libraries » comme illustré ci-dessous :

Cela complète l’installation des bibliothèques requises (AceButton, ESP32QRCodeReader, U8g2, XPowersLib). Dans la section suivante, nous installerons le core ESP32.

Installation du core ESP32

En plus des bibliothèques, nous devons aussi installer une version spécifique du core ESP32. Le github repo pour la T-Camera S3 indique que la Version 2.0.17 doit être utilisée. Il semble que la version actuelle (3.3.x) ne soit pas supportée (à partir de novembre 2025) et que le code ne compile pas – bien que je ne l’aie pas testé.

Rétrograder la version du core ESP32 est simple. Ouvrez le BOARDS MANAGER, tapez « ESP32 » pour filtrer les cartes ESP32, puis sélectionnez Version 2.0.17 pour l’esp32 par Espressif Systems. L’image ci-dessous montre à quoi cela ressemble après la rétrogradation du core ESP32 :

Nous sommes maintenant presque prêts à tester la caméra.

Code pour l’exemple minimal de caméra

Dans cette section, nous allons préparer, flasher et exécuter le code pour le Minimal Camera Example que l’on trouve dans le examples folder du dépôt GitHub. Puisque nous avons téléchargé le dépôt GitHub, vous avez déjà le code exemple sur votre ordinateur. Ouvrez le dossier « LilyGo-Cam-ESP32S-master » sur votre ordinateur, puis allez dans « examples » et ouvrez le dossier « MinimalCameraExample » :

Il y a quelques modifications à faire pour pouvoir exécuter le MinimalCameraExample.ino, cependant.

Renommer le fichier Secrets

Tout d’abord, renommez le fichier « secrets.h.example » en « secrets.h », car ce fichier est nécessaire pour les identifiants WiFi :

Remplir les Secrets

Si vous ouvrez maintenant le projet MinimalCameraExample.ino dans votre IDE Arduino, vous devriez voir un onglet avec le fichier « secrets.h ».

Cliquez dessus et saisissez le SSID et le mot de passe de votre WiFi. Vous pouvez remplir le même SSID et mot de passe trois fois :

// If using station mode, please fill in the wifi ssid and password here, cahnge as per your wireless settings
#define WIFI_SSID1 "ssid_from_AP_1"
#define WIFI_SSID_PASSWORD1 "your_password_for_AP_1"

#define WIFI_SSID2 "ssid_from_AP_2"
#define WIFI_SSID_PASSWORD2 "your_password_for_AP_2"

#define WIFI_SSID3 "ssid_from_AP_3"
#define WIFI_SSID_PASSWORD3 "your_password_for_AP_3"

Sélectionner le mode WiFi

Enfin, nous devons faire deux modifications dans le fichier MinimalCameraExample.ino. Remplacez les chevrons autour de l’inclusion de secrets.h par des guillemets et définissez le drapeau use_ap_mode à false :

Après ces modifications, le début du fichier MinimalCameraExample.ino devrait ressembler à ceci :

#include <Arduino.h>
#include <WiFi.h>
#include <WiFiMulti.h>
#include "esp_camera.h"
#include "secrets.h"

#define XPOWERS_CHIP_AXP2101
#include "XPowersLib.h"
#include "utilities.h"


void        startCameraServer();

XPowersPMU  PMU;
WiFiMulti   wifiMulti;
String      hostName = "LilyGo-Cam-";
String      ipAddress = "";
bool        use_ap_mode = false;

Téléverser le code sur la T-Camera S3

Nous sommes maintenant presque prêts à téléverser le code sur la T-Camera S3. Sélectionnez « ESP32S3 Dev Module » comme carte et assurez-vous qu’elle est connectée et reconnue sur un port COM :

Ensuite, dans le menu « Tools », réglez les paramètres suivants :

Les plus importants sont Flash Size, Partition Scheme et PSRAM. Les autres paramètres doivent être ceux par défaut, mais vérifiez-les quand même. Pour afficher dans le Moniteur Série, la configuration USB_CDC_ON_BOOT doit être activée.

Vous pouvez maintenant téléverser le code sur votre T-Camera S3 et, espérons-le, voir les informations suivantes dans le Moniteur Série :

Cela indique que la carte a pu se connecter au WiFi et à quelle adresse IP le serveur web de la caméra fonctionne. Les messages d’erreur concernant le partitionnement ne semblent pas poser de problème et peuvent être ignorés.

Ouvrez votre navigateur web, saisissez l’adresse IP, par exemple « 192.168.1.111 » dans la barre d’adresse, et une barre latérale avec un menu pour le serveur web devrait apparaître :

Cliquez sur « Start Stream » en bas de ce menu (juste au-dessus des Paramètres avancés) :

et vous devriez pouvoir profiter d’un flux vidéo dans votre navigateur :

Si tout cela a fonctionné, félicitations ; )

Impossible de téléverser le code sur la T-Camera S3

J’ai constaté que le téléversement du code pour MinimalCameraExample sur la T-Camera S3 ne fonctionne souvent pas. Maintenir le bouton Boot/Reset, réinitialiser la carte, redémarrer l’ordinateur – rien n’a marché.

Le flash a démarré avec succès mais a échoué avant d’atteindre 100 % avec le message d’erreur :

Une erreur d’exception série s’est produite : Impossible de configurer le port, quelque chose a mal tourné. Message original : PermissionError(13, ‘The device does not recognize the command.’, None, 22)
Note : Cette erreur provient de pySerial. Il est probable que ce ne soit pas un problème avec esptool, mais avec la connexion matérielle ou les pilotes.

La bonne nouvelle, c’est que j’ai trouvé une solution pour contourner ce problème. Il suffit de créer un autre projet Arduino avec un code minimal et de flasher ce code si vous rencontrez l’erreur ci-dessus :

void setup() {
  Serial.begin(115200);
}

void loop() {
  delay(1000);
  Serial.println("loop");
}

Pour une raison quelconque, cela fonctionne toujours, et après cela, vous pouvez flasher à nouveau le code plus volumineux (MinimalCameraExample) et cela fonctionne aussi.

Conclusion

Dans ce tutoriel, vous avez appris à démarrer avec la carte T-Camera S3 de LILYGO. Nous avons seulement flashé et exécuté le Minimal Camera Example mais le dépôt GitHub contient plus de examples qui valent le détour.

Notez que nous avons aussi un tutoriel pour le nouveau modèle T-Camera-Plus S3 Getting Started with T-Camera-Plus S3. Et si vous êtes intéressé par d’autres caméras et applications, jetez un œil aux tutoriels suivants :

Si vous avez des questions, n’hésitez pas à les laisser dans la section des commentaires.

Bon bricolage 😉