Fichiers
2026-10-11 01:55:11 +02:00

Spécification Technique & Décodage du Protocole Radio Davis Vantage Pro2 ISS (868 MHz Europe)

1. Synthèse du Protocole Radio Terrestre (DavisTalk RF)

L'Integrated Sensor Suite (ISS) de la Davis Vantage Pro2 (VP2) transmet ses relevés météorologiques par paquets radio autonomes sur la bande ISM 868 MHz en Europe (et 902–928 MHz aux USA).

Le protocole radio direct (souvent désigné sous le nom communautaire DavisTalk) est un protocole propriétaire non documenté officiellement par Davis Instruments, mais intégralement rétro-ingénieré et validé par plusieurs projets ouverts de référence (DavisRFM69 par DeKay/Mad Scientist Labs, CC1101-Weather-Receiver par cmatteri, rtldavis par Douglas Hall / bcl, et les drivers WeeWX).

Caution

Distinction Fondamentale des Protocoles Davis :

  1. Protocole Radio Brut (DavisTalk RF) : Paquets de 14 octets dans l'air (8 octets utiles), modulation 2-FSK @ 19.2 kbps, FHSS toutes les ~2.5 s. C'est l'unique protocole émis par l'ISS sans fil.
  2. Protocole Console / Datalogger (Serial LOOP / LOOP2) : Trames de 99 octets transmises en UART série 19200 bauds (8N1) par la console ou le module WeatherLink série/USB.
  3. Protocole Réseau WeatherLinkIP / Live : Données transmises en TCP/UDP/HTTP JSON sur réseau IP.
  4. Protocole APRS : Chaînes de caractères ASCII formatées pour le réseau radioamateur.

Pour une station autonome en montagne sans console, seul le protocole radio brut (DavisTalk RF) est utilisé.


2. Couche Physique Radio (Bande 868 MHz Europe)

2.1. Modulation et Paramètres RF

Paramètre Valeur Exacte Tolérance / Remarques
Modulation 2-FSK (Frequency Shift Keying) Déviation de fréquence : \pm 9.6\text{ kHz} (\Delta f \approx 9.6\text{ kHz})
Débit Binaire (Air Data Rate) 19 200 bps (19.2 kbps) Durée d'un bit : 52.083\text{ }\mu\text{s}
Préambule Physique 4 à 8 octets 0xAA (10101010...) Permet le calage AGC et de phase du récepteur
Mot de Synchronisation (Sync Word) 2 octets : 0xCB89 (MSB first) Binaire : 1100 1011 1000 1001
Largeur de Canal / Filtre RX ~100 à 150 kHz Réglage optimal CC1101 MDMCFG4.CHANBW \approx 100\text{ kHz}
Endianness Transmission MSB First (Bit le plus significatif émis en premier) Octet le plus significatif en premier pour le CRC

2.2. Canaux Fréquentiels Européens (Plan 5 Canaux)

Contrairement à la version nord-américaine (qui utilise 51 canaux entre 902 et 928 MHz), la version européenne (modèles finissant par EU ou OV) opère sur 5 canaux spécifiques dans la bande 868.0 – 868.6 MHz :

Index Canal (Logiciel) Fréquence Exacte (Hz) Fréquence Nominale (MHz) Espacement
Canal 0 868 066 711 Hz 868.067 MHz Base
Canal 1 868 181 885 Hz 868.182 MHz +115.174 kHz
Canal 2 868 297 119 Hz 868.297 MHz +115.234 kHz
Canal 3 868 412 292 Hz 868.412 MHz +115.173 kHz
Canal 4 868 527 466 Hz 868.527 MHz +115.174 kHz

Warning

Correction d'une erreur fréquente : L'espacement des canaux Davis Europe n'est PAS de 125.0 kHz (comme souvent supposé dans les notes initiales : 868.0, 868.125, 868.250...), mais précisément de ~115.17 kHz dérivé du pas de synthèse fractionnaire du transceiver Davis.

2.3. Séquence de Saut de Fréquence (FHSS)

Pour la bande européenne à 5 canaux, l'ISS cycle à travers les canaux selon la séquence pseudo-aléatoire fixe :

\text{Séquence d'index canaux} : [0, 2, 4, 1, 3]

À chaque tir d'émission, l'ISS passe au canal suivant de la séquence.


3. Synchronisation Temporelle & Périodicité

3.1. Formule de l'Intervalle d'Émission

L'intervalle de temps nominal T entre deux tirs successifs de l'ISS dépend exclusivement de l'identifiant de la station (Station ID / Transmitter ID, configuré par 3 DIP-switches sur le boîtier de l'ISS, de 1 à 8) :

T_{\text{tir}} = \frac{41 + \text{ID}_{\text{raw}}}{16} \text{ secondes}

où \text{ID}_{\text{raw}} \in [0..7] correspond aux stations 1 à 8 :

DIP Switches ISS Identifiant Station Valeur Binaire (\text{ID}_{\text{raw}}) Intervalle Exact T (s) Intervalle en Millisecondes
1-OFF, 2-OFF, 3-OFF Station 1 (Défaut) 0 41 / 16 = 2.5625\text{ s} 2 562.5 ms
1-ON, 2-OFF, 3-OFF Station 2 1 42 / 16 = 2.6250\text{ s} 2 625.0 ms
1-OFF, 2-ON, 3-OFF Station 3 2 43 / 16 = 2.6875\text{ s} 2 687.5 ms
1-ON, 2-ON, 3-OFF Station 4 3 44 / 16 = 2.7500\text{ s} 2 750.0 ms
1-OFF, 2-OFF, 3-ON Station 5 4 45 / 16 = 2.8125\text{ s} 2 812.5 ms
1-ON, 2-OFF, 3-ON Station 6 5 46 / 16 = 2.8750\text{ s} 2 875.0 ms
1-OFF, 2-ON, 3-ON Station 7 6 47 / 16 = 2.9375\text{ s} 2 937.5 ms
1-ON, 2-ON, 3-ON Station 8 7 48 / 16 = 3.0000\text{ s} 3 000.0 ms

3.2. Durée du Paquet dans l'Air & Budget Temporel

Un paquet radio Davis complet est constitué de :

  • Préambule : 4 octets (32 bits)
  • Sync Word : 2 octets (16 bits)
  • Payload utile : 6 octets (48 bits)
  • CRC-16 : 2 octets (16 bits)
  • Total dans l'air : 14 octets = 112 bits
\text{Durée dans l'air} = \frac{112\text{ bits}}{19\text{ }200\text{ bps}} = 5.8333\text{ ms}

3.3. Dimensionnement de la Fenêtre de Réception du Relais

En conditions de haute montagne (température -20^\circ\text{C} à +30^\circ\text{C}), les dérives cumulées du quartz de l'ISS et du quartz LSE 32.768 kHz du récepteur (\pm 20\text{ ppm}) entraînent une dérive relative maximale de :

\Delta t_{\text{dérive}} = 40\text{ ppm} \times 2.5625\text{ s} \approx \pm 102.5\text{ }\mu\text{s par tir}
  • Fenêtre nominale de poursuite (Tracking Window) :
    • Réveil CC1101 : 3.0 ms avant l'instant estimé.
    • Durée de capture du paquet : 5.83 ms.
    • Marge de garde après tir : 5.0 ms.
    • Durée totale d'écoute active RX : 14.0 à 18.0 ms (parfaitement alignée avec DEC-022).
  • Recalage de phase à chaque paquet reçu : L'instant d'interruption EXTI GDO0 (Sync Word détecté) sert de référence absolue pour recaler le timer RTC du tir suivant, annulant toute accumulation d'erreur de quartz.

4. Structure Binaire des Trames (8 octets utiles)

Une fois le préambule et le mot de synchronisation validés et retirés par le transceiver matériel (CC1101 ou RFM69), le microcontrôleur reçoit un buffer exact de 8 octets (raw[0..7]) :

┌──────────────┬──────────────┬──────────────┬──────────────┬──────────────┬──────────────┬──────────────┬──────────────┐
│    Byte 0    │    Byte 1    │    Byte 2    │    Byte 3    │    Byte 4    │    Byte 5    │    Byte 6    │    Byte 7    │
├──────────────┼──────────────┼──────────────┼──────────────┼──────────────┼──────────────┼──────────────┼──────────────┤
│ Type & ID    │ Vitesse Vent │ Direction V. │ Donnée Cap 1 │ Donnée Cap 2 │ Donnée Cap 3 │ CRC-16 (MSB) │ CRC-16 (LSB) │
└──────────────┴──────────────┴──────────────┴──────────────┴──────────────┴──────────────┴──────────────┴──────────────┘

4.1. Octet 0 : En-tête de Trame (raw[0])

 Bit 7     Bit 6     Bit 5     Bit 4      Bit 3     Bit 2     Bit 1     Bit 0
┌───────────────────────────────────┬──────────┬────────────────────────────┐
│      Packet Type (4 bits)         │ Batt_Low │   Station ID (3 bits)      │
└───────────────────────────────────┴──────────┴────────────────────────────┘
  • Bits 7..4 : Type de Paquet / Capteur :
    • 0x8 : Température Extérieure (VP2P_TEMP)
    • 0x9 : Rafale de Vent 10 min (VP2P_WINDGUST)
    • 0xA : Humidité Relative Extérieure (VP2P_HUMIDITY)
    • 0xE : Pluviosité / Augets (VP2P_RAIN)
    • 0x6 / 0x7 : Rayonnement Solaire (VP2P_SOLAR)
    • 0x4 : Indice UV (VP2P_UV)
    • 0x5 : Pluviosité instantanée / secondes entre basculements (VP2P_RAINSECS)
  • Bit 3 : Indicateur Batterie Faible (Transmitter Battery Low) :
    • 0 : Tension batterie/condensateur de l'ISS nominale.
    • 1 : Batterie de l'ISS faible (pile CR123A à remplacer).
  • Bits 2..0 : Identifiant Station (\text{ID}_{\text{raw}} \in [0..7]) :
    • Correspond au numéro de station configuré (1 \text{ à } 8).

4.2. Octet 1 : Vitesse du Vent Instantanée (raw[1])

  • Transmise dans chaque paquet, quel que soit le type de capteur du paquet.
  • Format : Entier non signé sur 8 bits (0 \text{ à } 255).
  • Unité native : Miles per hour (mph).
  • Conversion en km/h : v_{\text{km/h}} = v_{\text{mph}} \times 1.609344
  • Valeur spéciale : 0x00 = Calme (0 mph).

4.3. Octet 2 : Direction du Vent (raw[2])

  • Transmise dans chaque paquet.
  • Format : Entier non signé sur 8 bits (0 \text{ à } 255).
  • Conversion en degrés (0^\circ \text{ à } 359^\circ) : \text{Direction (degrés)} = \frac{\text{raw}[2] \times 360}{256} = \text{raw}[2] \times 1.40625^\circ

5. Décodage Détaillé par Type de Paquet (Octets 3, 4, 5)

5.1. Type 0x8 : Température Extérieure (VP2P_TEMP)

  • Encodage physique : Valeur sur 12 bits signée en dixièmes de degré Fahrenheit (1/10^\circ\text{F}).
  • Extraction des bits : \text{raw\_temp\_tenths} = ((\text{raw}[3] \text{ as } \text{i16}) \ll 8 \mid \text{raw}[4] \text{ as } \text{i16}) \gg 4
  • Conversion exacte en centièmes de °C (virgule fixe) : T_{\text{centi\_C}} = \frac{(\text{raw\_temp\_tenths} - 320) \times 50}{9}

5.2. Type 0xA : Humidité Relative (VP2P_HUMIDITY)

  • Extraction des bits : \text{raw\_hum} = \frac{((\text{raw}[4] \gg 4) \ll 8) \mid \text{raw}[3]}{10}
  • Plage valide : 0\% \text{ à } 100\%.

5.3. Type 0x9 : Rafale de Vent (VP2P_WINDGUST)

  • Octet 3 (raw[3]) : Vitesse maximale de la rafale mesurée sur les 10 dernières minutes en mph.

5.4. Type 0xE : Pluviosité (VP2P_RAIN)

  • Extraction des bits : \text{tips} = (\text{raw}[3] \ \& \ \text{0x7F}) \mid ((\text{raw}[4] \ \& \ \text{0x0F}) \ll 7)
  • Résolution cône européen métrique : 0.2 mm par basculement.

6. Algorithme de Contrôle d'Intégrité CRC-16 Davis

Le protocole DavisTalk utilise un CRC-16 CCITT direct calculé sur les 6 premiers octets de la trame (raw[0..5]).

6.1. Paramètres Formels du CRC

Paramètre Valeur
Polynôme Générateur 0x1021 (x^{16} + x^{12} + x^5 + 1)
Valeur Initiale (Init) 0x0000
RefIn (Réflexion entrée) false (MSB-first direct)
RefOut (Réflexion sortie) false
XorOut (Inversion finale) 0x0000
Position dans le paquet raw[6] = CRC MSB, raw[7] = CRC LSB

6.2. Propriété de Vérification Globale

Si l'on calcule le CRC-16 sur l'intégralité des 8 octets (payload 6 octets + les 2 octets de CRC reçus), le résultat mathématique exact doit être strictement égal à 0x0000 :

pub fn is_davis_crc_valid(packet_8_bytes: &[u8; 8]) -> bool {
    crc16_davis(packet_8_bytes) == 0x0000
}

7. Jeu de Données de Test & Vecteurs de Validation Réels (Mathématiquement Vérifiés)

Vecteur 1 : Trame Température Extérieure + Vent

  • Octets Bruts (Hex) : [ 0x80, 0x0A, 0x40, 0x3E, 0x90, 0x00, 0x3A, 0x5D ]
  • Décodage :
    • raw[0] = 0x80 : Type = 0x8 (Température), Battery OK, Station ID = 0 (Station 1).
    • raw[1] = 0x0A = 10 : Vent = 10\text{ mph} \approx 16.1\text{ km/h}.
    • raw[2] = 0x40 = 64 : Direction vent = \frac{64 \times 360}{256} = 90^\circ (Est).
    • raw[3..4] = 0x3E, 0x90 : (0x3E90) >> 4 = 0x3E9 = 1001 (100.1^\circ\text{F} \approx 37.83^\circ\text{C}).
    • CRC calculé sur raw[0..5] = 0x3A5D \rightarrow raw[6]=0x3A, raw[7]=0x5D \rightarrow CRC VALIDE == 0x0000.

Vecteur 2 : Trame Pluie (Augets) + Vent

  • Octets Bruts (Hex) : [ 0xE0, 0x00, 0x00, 0x15, 0x00, 0x00, 0x23, 0xAB ]
  • Décodage :
    • raw[0] = 0xE0 : Type = 0xE (Pluie), Station ID = 0.
    • raw[1] = 0x00 : Vent calme (0 km/h).
    • raw[3..4] : Compteur augets = 21 basculements (21 \times 0.2\text{ mm} = 4.2\text{ mm}).
    • CRC calculé sur raw[0..5] = 0x23AB \rightarrow raw[6]=0x23, raw[7]=0xAB \rightarrow CRC VALIDE == 0x0000.

Vecteur 3 : Trame Humidité Extérieure

  • Octets Bruts (Hex) : [ 0xA0, 0x05, 0x80, 0x4C, 0x20, 0x00, 0x71, 0x6D ]
  • Décodage :
    • raw[0] = 0xA0 : Type = 0xA (Humidité), Station ID = 0.
    • raw[1] = 0x05 : Vent = 5\text{ mph} \approx 8.0\text{ km/h}.
    • raw[2] = 0x80 = 128 : Direction vent = 180^\circ (Sud).
    • raw[3..4] : Humidité = 58.8\% \rightarrow 58\%.
    • CRC calculé sur raw[0..5] = 0x716D \rightarrow raw[6]=0x71, raw[7]=0x6D \rightarrow CRC VALIDE == 0x0000.