v1.10.0: intégration capteur CCS811 (TVOC/eCO2, I2C)

Nouveau capteur de qualité d'air CCS811 sur le bus I2C, calqué sur le
pattern S88 (local-only, pas encore dans le payload de transmission).

- CCS811/get_data.py (lecture live) + write_data.py (timer 10s, self-heal table)
- table data_CCS811 (timestamp, eCO2, TVOC) dans create_db.py
- config CCS811 (bool) + CCS811_address (0x5A/0x5B, défaut 0x5A) dans set_config.py
- service+timer systemd nebuleair-ccs811-data (10s) + ajout boucle d'activation
- admin.html: case d'activation + dropdown adresse I2C
- sensors.html: carte Get Data (TVOC + eCO2)
- database.html + launcher.php: consultation/export/stats data_CCS811
- lib adafruit-circuitpython-ccs811 dans installation_part1.sh
- CCS811/README.md: câblage, adresses, warning clock-stretching I2C sur Pi
- CLAUDE.md + changelog mis à jour

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

CCS811/README.md

@@ -0,0 +1,83 @@
+# CCS811 — Capteur qualité d'air (eCO2 / TVOC)
+
+Capteur de gaz **MOX** (oxyde métallique) AMS CCS811. Connecté en **I2C**.
+
+## ⚠ À lire avant de câbler
+
+Le CCS811 **n'est pas** un capteur CO2 NDIR comme le Senseair S88. C'est un capteur
+de COV (composés organiques volatils) qui mesure :
+
+- **TVOC** (Total Volatile Organic Compounds) — en **ppb**. C'est la mesure réellement
+  utile / fiable du capteur, et celle qui nous intéresse ici.
+- **eCO2** (CO2 *équivalent*) — en **ppm**, plage 400–8192. Valeur *calculée* à partir
+  du TVOC par un algorithme interne, ce **n'est pas** une mesure directe du CO2. Pour
+  un vrai CO2, utiliser le S88. On stocke quand même l'eCO2 (gratuit, vient de la même
+  lecture) mais ne pas le confondre avec une mesure NDIR.
+
+## ⚠ Clock-stretching I2C sur Raspberry Pi
+
+Le CCS811 utilise massivement le **clock-stretching** I2C. Le contrôleur I2C matériel
+du Raspberry Pi (BSC) gère **mal** le clock-stretching (bug matériel documenté). Sans
+mitigation, les lectures échouent typiquement en `OSError` / `Remote I/O error`.
+
+**Mitigation** : ralentir le bus I2C dans `/boot/firmware/config.txt` :
+
+```
+dtparam=i2c_arm_baudrate=10000
+```
+
+(10 kHz au lieu de 100 kHz par défaut.) Reboot ensuite. À valider au bench — sur
+certains modules/CM4 ça passe à 100 kHz, sur d'autres non.
+
+Vérifier la présence du capteur :
+
+```bash
+sudo i2cdetect -y 1   # doit montrer 5a (ou 5b selon la broche ADDR)
+```
+
+## Adresse I2C
+
+- **0x5A** : ADDR à GND — défaut des breakouts **Adafruit**. Valeur par défaut du firmware.
+- **0x5B** : ADDR à VDD — défaut des breakouts **SparkFun** / modules génériques.
+
+Configurable dans `admin.html` (clé config `CCS811_address`, dropdown 0x5A / 0x5B).
+
+## Câblage I2C
+
+| CCS811 | Raspberry Pi |
+|---|---|
+| VCC / VIN | 3.3V |
+| GND | GND |
+| SDA | SDA (GPIO2) |
+| SCL | SCL (GPIO3) |
+| WAK / nWAKE | GND (réveil permanent ; sinon laisser le module gérer) |
+| ADDR | GND → 0x5A, VDD → 0x5B |
+
+⚠ La plupart des breakouts CCS811 sont en **3.3V** logique. Ne pas alimenter en 5V
+sans level-shifter sauf si le module embarque son propre régulateur + shifter.
+
+## Burn-in / conditionnement
+
+- **Burn-in initial** : ~48 h de fonctionnement continu avant des valeurs stables (1ère mise en service).
+- **Warm-up** à chaque démarrage : ~20 min pour des valeurs fiables. Au démarrage le
+  capteur renvoie souvent eCO2=400 ppm / TVOC=0 ppb (valeurs de repos).
+
+## Implémentation NebuleAir
+
+- `CCS811/get_data.py` — lecture live (bouton "Get Data" du web). Affiche
+  `{"eCO2": <ppm>, "TVOC": <ppb>}` ou `{"error": "..."}`.
+- `CCS811/write_data.py` — lecture périodique (timer systemd, toutes les 10 s),
+  écrit dans la table `data_CCS811 (timestamp, eCO2, TVOC)`.
+
+Librairie Python : `adafruit-circuitpython-ccs811` (installée par
+`installation_part1.sh`). La table est créée par `sqlite/create_db.py` et
+self-healée par `write_data.py` (CREATE TABLE IF NOT EXISTS) — garder les deux
+schémas synchro.
+
+Activation : `admin.html` → case "Send VOC sensor data (CCS811)".
+
+### Pistes d'amélioration (non implémentées)
+
+Le CCS811 supporte une compensation température/humidité (`SET_ENV_DATA`). Comme le
+boîtier embarque déjà un BME280, on pourrait lui pousser temp/hum à chaque lecture
+pour améliorer la précision. Non fait en v1 pour garder le script simple et autonome.