33c4472350
Parsers and formats are tightly linked (a parser produces a format) and the split made cross-links heavy for a single parser file. Also removed the confusing "Enveloppe JSON" block in udp-miotiq.md that mixed the raw webhook wrapper with what the backend actually consumes — the decoded payload schema lives in json-payload.md and is now referenced directly. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
3.2 KiB
3.2 KiB
Codes polluants ISO — convention AirCarto
Les descripteurs Miotiq (voir udp-miotiq.md) et le JSON canonique (voir json-payload.md) utilisent des codes ISO_XX pour désigner les polluants et grandeurs physiques. Ces codes suivent la nomenclature du LCSQA (Laboratoire Central de Surveillance de la Qualité de l'Air), basée sur la norme ISO 7168.
Les codes vont théoriquement de ISO_01 à ISO_99. Seuls ceux effectivement mesurés par au moins un capteur AirCarto sont documentés ici.
Mapping
| Code | Grandeur / polluant | Unité de référence | Equation descripteur Miotiq | Remarques |
|---|---|---|---|---|
ISO_03 |
NO₂ — dioxyde d'azote | ppb | ||
ISO_04 |
CO — monoxyde de carbone | ppb | ||
ISO_05 |
H₂S — sulfure d'hydrogène | ppb | ||
ISO_08 |
O₃ — ozone | ppb | ||
ISO_21 |
NH₃ — ammoniac | ppb | ||
ISO_24 |
PM10 | µg/m³ | x/10 |
Particules ≤ 10 µm |
ISO_39 |
PM2.5 | µg/m³ | x/10 |
Particules fines ≤ 2.5 µm |
ISO_53 |
Pression | hPa | Pression atmosphérique | |
ISO_54 |
Température | °C | x/100 |
|
ISO_55 |
Humidité relative | % | x/100 |
|
ISO_68 |
PM1 | µg/m³ | x/10 |
Particules ultrafines ≤ 1 µm |
Règles
- Un code ISO est unique au sein de l'écosystème AirCarto : pas de redéfinition par capteur.
- Pour ajouter un polluant :
- Chercher son code dans la nomenclature LCSQA / ISO 7168.
- S'il existe, ajouter la ligne ici avec l'unité de référence et l'équation standard.
- S'il n'existe pas, allouer le prochain code libre > 70 et documenter la décision en « À faire » ci-dessous.
- Unité de référence = unité stockée en base (après application de l'équation du descripteur). Les firmwares peuvent encoder à une précision différente, l'équation ramène à l'unité finale.
- Les grandeurs non-polluantes propres aux capteurs AirCarto (bruit, vent, batterie, solaire…) ne reçoivent pas de code ISO : elles gardent leur nom
snake_case(wind_speed,battery_voltage, etc.). Seuls les polluants atmosphériques et paramètres ambiants standard utilisentISO_XX.
Sources
- LCSQA — nomenclature polluants : https://www.lcsqa.org/
- ISO 7168-2:1999 — Air quality — Exchange of data, Part 2: Condensed data format.
- Directive 2008/50/CE — codes polluants européens.