Formation Arduino (ESP32-S3)

Support de formation en 13 modules (00 à 12) plus une synthèse du matériel. Les sources sont en Markdown Quarto (modules/*.qmd) et produisent des PDF.

Fichier	Sujet
00-installation	Installation de l'environnement
01-architecture	Découverte du microcontrôleur ESP32-S3
02-gpio-neopixel	Entrées/sorties numériques et LED NeoPixel
03-pwm-adc	Signaux analogiques : PWM et ADC
04-serie-debug	Communication série et débogage
05-i2c-spi	Bus I2C et SPI
06-interruptions-timers	Interruptions matérielles et timers
07-wifi	Wi-Fi : station, point d'accès, client HTTP
08-serveurweb	Serveur web embarqué
09-ble	Bluetooth Low Energy
10-energie	Gestion de l'énergie
11-mqtt	IoT et MQTT
12-projetfinal	Projet final
synthese-materiel	Synthèse et liste de matériel

Organisation

modules/      sources des supports (.qmd)
modele/       gabarit PDF (Typst) et thème de coloration du code
schemas/      schémas décrits en Python (schemdraw + matplotlib), rendus en svg/ et png/
_quarto.yml   configuration du projet
_output/      PDF générés (non versionnés)

Produire les PDF

Prérequis : Quarto (inclut Pandoc et Typst).

quarto render                              # tous les supports
quarto render modules/03-pwm-adc.qmd       # un seul support

Les PDF sont créés dans _output/modules/. Pour obtenir aussi du Word ou de l'ODT, ajouter docx: ou odt: sous format: dans _quarto.yml.

Modifier ou ajouter un schéma

Les images de schemas/svg/ sont versionnées : il n'est nécessaire de les régénérer que si l'on modifie un schéma.

python -m venv .venv
.venv\Scripts\python -m pip install -r schemas/requirements.txt
.venv\Scripts\python schemas\generer.py          # ou : generer.py m03

Un schéma est une fonction Python déclarée dans schemas/mXX_*.py (liste FIGURES), puis appelée dans le .qmd :

![Légende de la figure](../schemas/svg/m03-servo-50hz.svg){#fig-m03-servo-50hz}

Historique

Les supports étaient à l'origine au format .odt ; ils restent récupérables via le tag avant-quarto.