ArtemiaandClaude Opus 5.5
d933e348c0
Les supports .odt restent récupérables via le tag avant-quarto. Les figures ne déclarent plus que leur identifiant et leur fonction de dessin (légende et emplacement dans le .qmd). Génération SVG reproductible (sans date, identifiants stables) pour des diffs git propres. README : mode d'emploi Quarto et schémas. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2.3 KiB
2.3 KiB
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 :
{#fig-m03-servo-50hz}
Historique
Les supports étaient à l'origine au format .odt ; ils restent récupérables via le tag avant-quarto.