Artemia76/formation-arduino
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Retire les .odt et l'insertion XML, désormais remplacés par Quarto

Browse Source 
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>
This commit is contained in:
Artemia
2026-10-18 15:04:25 +02:00
co-authored by Claude Opus 5.5
parent 85852fcc2f
commit d933e348c0
23 changed files with 255 additions and 394 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+59 -16
View File
@@ -1,20 +1,63 @@
# Formation Arduino (ESP32)
# Formation Arduino (ESP32-S3)
Support de formation en 13 modules (00 à 12) plus une synthèse du matériel, au format OpenDocument (.odt).
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 |
|---|---|
| Module_00_Installation | Installation de l'environnement |
| Module_01_Architecture | Architecture |
| Module_02_GPIO_NeoPixel | GPIO et NeoPixel |
| Module_03_PWM_ADC | PWM et ADC |
| Module_04_Serie_Debug | Liaison série et débogage |
| Module_05_I2C_SPI | I2C et SPI |
| Module_06_Interruptions_Timers | Interruptions et timers |
| Module_07_WiFi | WiFi |
| Module_08_ServeurWeb | Serveur web |
| Module_09_BLE | Bluetooth Low Energy |
| Module_10_Energie | Gestion de l'énergie |
| Module_11_MQTT | MQTT |
| Module_12_ProjetFinal | Projet final |
| Synthese_Formation_Materiel | Synthèse du matériel |
| `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
![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`.