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>
64 lines
2.3 KiB
Markdown
64 lines
2.3 KiB
Markdown
# 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](https://quarto.org) (`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](https://quarto.org/docs/get-started/) (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` :
|
|
|
|
```markdown
|
|
{#fig-m03-servo-50hz}
|
|
```
|
|
|
|
## Historique
|
|
|
|
Les supports étaient à l'origine au format `.odt` ; ils restent récupérables via le tag `avant-quarto`.
|