91 lines
2.7 KiB
Markdown
91 lines
2.7 KiB
Markdown
# <Nom du capteur>
|
|
|
|
Remplace ce bloc par une ligne de résumé : fabricant, grandeurs mesurées, interface principale.
|
|
|
|
> Exemple : « Tera Sensor NextPM — capteur de particules PM1/PM2.5/PM10, interface UART. »
|
|
|
|
## Caractéristiques
|
|
|
|
| Paramètre | Valeur |
|
|
|--------------------------|-------------------------------|
|
|
| Fabricant / modèle | |
|
|
| Grandeurs mesurées | PM1, PM2.5, PM10 / T / HR / … |
|
|
| Plage | |
|
|
| Précision | |
|
|
| Alimentation | 3V3 / 5V, mA typique |
|
|
| Interface | UART / I2C / SPI / analogique |
|
|
| Datasheet | URL |
|
|
|
|
## Câblage
|
|
|
|
Lister **chaque fil** avec sa couleur, le pin côté capteur et le pin côté MCU de référence.
|
|
|
|
| Fil capteur | Pin capteur | Fonction | Pin MCU (exemple nRF9151) |
|
|
|-------------|-------------|----------|---------------------------|
|
|
| Rouge | 1 | VCC | 3V3 |
|
|
| Noir | 2 | GND | GND |
|
|
| … | | | |
|
|
|
|
## Protocole
|
|
|
|
- Transport : UART 115200 8N1 / I2C 100 kHz / …
|
|
- Adresse (si I2C) :
|
|
- Polarité, endianness :
|
|
|
|
### Format de trame
|
|
|
|
Décrire exactement la structure : header, champs, checksum, taille.
|
|
|
|
```
|
|
+------+-----+------+------+-----+
|
|
| HDR | CMD | LEN | DATA | CS |
|
|
+------+-----+------+------+-----+
|
|
1B 1B 1B Nb 1B
|
|
```
|
|
|
|
Checksum : algorithme exact (`256 - sum(prev) mod 256`, CRC8, CRC16 poly…).
|
|
|
|
### Commandes
|
|
|
|
| Commande | Code | Requête | Réponse (taille, champs) |
|
|
|----------|------|------------------------|-----------------------------------|
|
|
| Read X | 0x11 | `81 11 …` | `81 11 state <data> cs` |
|
|
| Sleep | 0x15 | | |
|
|
|
|
### Décodage des champs
|
|
|
|
Pour chaque donnée retournée, précise :
|
|
- Position, taille, endianness.
|
|
- Facteur d'échelle (ex. `val / 10.0` pour obtenir des µg/m³).
|
|
- Unité finale.
|
|
|
|
## Exemple de code
|
|
|
|
### Lecture (pseudo-C)
|
|
|
|
```c
|
|
// TODO
|
|
```
|
|
|
|
### Lecture (Python)
|
|
|
|
```python
|
|
# TODO
|
|
```
|
|
|
|
## Spécificités connues / pièges
|
|
|
|
- …
|
|
|
|
## Références
|
|
|
|
- Datasheet : URL
|
|
- Code de référence utilisé en prod : `<repo>/src/drivers/<fichier>`
|
|
- Note d'application constructeur : URL
|
|
|
|
## Historique
|
|
|
|
| Date | Révision | Changement |
|
|
|------------|----------|-----------------------------------------------|
|
|
| YYYY-MM-DD | v1 | Création de la doc. |
|