Wireless M-BUS Adeunis RF products Décodage de trame / Frame decoding Note d’application / Application note Version V1.1 ADEUNIS RF 283 rue Louis Néel - Parc Technologique Pré Roux 38920 CROLLES - France Tel. : +33 (0)4 76 92 07 77 - Fax : +33 (0)4 76 04 80 87 www.adeunis-rf.com arf@adeunis-rf.com Application note - Décodage de trame WMBUS V1.1 Table des matières / Table of content Historique2 Information 2 Trame des index de consommation 1. Exemple de trame standard WMBUS (compteur d’eau) 1.1.Description 1.2. Exemple de trame d’historique WMBUS standard 1.2.1Description 1.3. Code erreur trame WMBUS standard (Status) 3 3 3 4 4 4 2. Exemple de trame standard WMBUS sonde de température d’ambiance, conforme OMS 2.1.Description 2.2. Exemple de trame d’historique WMBUS sonde de température d’ambiance 2.2.1Description 2.3. Code erreur trame WMBUS Ambient sensor 5 5 6 6 7 Consumption index frame 1. Standard WMBUS frame example (water meter) 1.1.Description 1.2. Example of WMBUS standard history frame 1.2.1Description 1.3. WMBUS standard frame Error code (Status) 8 8 8 9 9 9 2. Standard frame from Ambient sensor, OMS compliant 2.1.Description 2.2. Exemple de trame d’historique WMBUS sonde de température d’ambiance 2.2.1Description 2.3. WMBUS Ambient sensor frame error code 10 10 11 11 12 Historique Revision Date Modification 1.1 24/06/2014 Code erreur + historique / Error code + history 1.0 10/06/2014 Creation Information Information document Titre Application note - Décodage de trame WMBUS V1.0 Sous-titre Version 1.1 Type de document Mise en oeuvre / Implementation Ce document s’applique aux produits suivants : this document applies to the following products : Nom Référence WMBUS TRANSMITTER AMR ARF7904xx / ARF7906xx WMBUS AMR TEMP ARF7904AA / ARF7906AA WMBUS AMBIENT SENSOR ARF8054 / ARF8055 Version firmware Page 2 of 12 Application note - Décodage de trame WMBUS V1.1 Trame des index de consommation 1.Exemple de trame standard WMBUS (compteur d’eau) L-Field C-Field M-Field RSSI 12 Value information Field D6 47 00 00 Data 04 Data information Field Status Access number 00 00 Signature 46 06 01 07 26 00 Device Type Manufacturer ID 07 00 00 10 Version Control 72 Manufacturer ID Taille de trame 07 SN Number Start data from Transmitter 07 00 00 10 01 Data-Field Code de trame 46 06 CI-Field Device type 44 Version 1D SN Number FF A-Field 1.1. Description Type Description Valeur Control Invariable 0x44 : SEND/NO REPLY Manufacturer ID Numéro du fabricant 0x4606 : ARF (Adeunis RF) SN Number Numéro de série du produit Version Version de produit 0x01 : version 1 0x03 : Gaz 0x07 : Eau Device type Type de produit Code de trame Identifie le type de trame SN Number Numéro de série du compteur Manufacturer ID Numéro du fabricant 0x4606 : ARF (Adeunis RF) Version Version de produit 0x01 : version 1 0x02 : Electricité 0x1B : Température (room sensor) 0x72 : Trame d’index 0x03 : Gaz Device type Type de produit 0x07 : Eau 0x02 : Electricité 0x1B : Température (room sensor) Access number Nombre d’accès Status Status 0x00 : NO ERROR Signature Invariable 0x00 : pas de cryptage DIF Format des données 0x04 : Format de données sur 32 bits 0x12 : 0.1L ou 1dm3 (eau ou gaz) VIF Valeur des données 0x03 : 1Wh (Electricité) 0x66 : 0.01°C Data Données de comptage RSSI Niveau de réception du signal D6 47 00 00 : données en héxadécimal inversé. Lire : 00 00 47 D6 en héxadécimal, soit 18390 en décimal = 1839 litres RSSI de la trame reçue : valeur RSSI = -125 + (x * 0.5), soit dans cet exemple 5A = 90, RSSI = -125 + (90*0.5) = -80dBm Page 3 of 12 5A Application note - Décodage de trame WMBUS V1.1 1.2. Exemple de trame d’historique WMBUS standard • • • Profondeur d’historique = 1440 min / 45 = 32 enregistrements Emission d’un trame toutes les 12 heures 64 octets : 2 octets représentent la valeur CIField ............. Data-Field RSSI 00 00 00 04 0A 00 4E C0 Code de trame SN Number Manufacturer ID Version Device Type Access number Status Signature Type d’historique Poids de valeur Période 03 1A 01 00 00 00 00 ..... FF FF Dernière valeur 71 Deuxième valeur 07 Première valeur 01 Access number 46 06 Nombre de valeur 07 00 00 10 Longeur de codage valeur AD 1.2.1 Description Type Description Valeur Code de trame Identifie le type de trame 0xAD : trame d’historique SN Number Numéro de série du compteur Manufacturer ID Numéro du fabricant Version Version produit 0x01 : Version 1 Device type Type de produit 0x07 : Eau Access number Nombre d’accès Status Status 0x00 : NO ERROR Signature 00 --> 0 : Nombre de bloc de 16 octets, 0 : invariable 00 : pas de cryptage, 05 : cryptée AES128 mode 5 Historique Type d’historique (1 octet) 01 : historique 24h 02 : historique 7 jours 03 : historique 31 jours 04 : historique 1 an 05 : historique 3 ans Poids de la valeur en L, dm3 Période historique (3 octets) en mn. 00 4E C0 : en hexadécimal. En décimal 20160mm = 14jours Valeur type 1 = type 4 bits 2 = type 8 bits 3 = type 16 bits Nombre de valeur N valeurs de 8 bits ou N valeurs de 16 bits selon «valeur type» Historique compteur (access number) Incrémenté à chaque modification de l’historique Première valeur données en héxadécimal inversé 0.1L ou 0.1dm3 Valeurs suivantes....... Appliquer conversion comme ci-dessus Dernière valeur FF FF 1.3. Code erreur trame WMBUS standard (Status) Bit de statut b8 b7 b6 b5 b4 b3 b2 b1 1 1 1 Not used Not used Not used Not used 1 Alarme Détail Batterie Batterie faible <2.2 volts Permanent error Temporary error Erreur config Erreur de configuration du produit Page 4 of 12 5A Application note - Décodage de trame WMBUS V1.1 2.Exemple de trame standard WMBUS sonde de température d’ambiance, conforme OMS 46 06 05 1B 8B 00 10 00 2F 2F 02 65 7A 0A 42 65 8F 0A Signature Vérification d’encryption Data information Field Value information Field Data Data information Field Value information Field Data 02 FD 17 10 63 Code erreur 19 19 19 19 Status 72 Access number Control 1B Device Type Taille de trame 05 Version Start data from Transmitter 19 19 19 19 RSSI Manufacturer ID 46 06 Data-Field SN Number 44 Code de trame 1B Device type FF CIField A-Field Version MField SN Number CField Manufacturer ID LField 2.1. Description Type Description Valeur Control CI-Field 0x44 : SEND/NO REPLY Manufacturer ID Numéro du fabricant 0x4606 SN Number Numéro de série du produit Version Version produit 0x05 : Version 5 0x03 : Gaz 0x07 : Eau Device type Type de produit Code de trame Identifie le type de trame SN Number Numéro de série du compteur Manufacturer ID Numéro du fabricant Version Version produit 0x05 : Version 5 Device type Type de produit 0x1B : Température (room sensor) Access number Nombre d’accès Status Status 0x02 : Electricité 0x1B : Température (room sensor) Signature 0x72 : Trame d’index 0x00 : NO ERROR 10 --> 1 : Nombre de bloc de 16 octets, 0 : invariable 00 : pas de cryptage, 05 : cryptée AES128 mode 5 Vérification d’encryption Capteur interne Capteur externe Marqueur fixe 2F 2F : non cryptée DIF Format des données Capteur interne : 02 VIF Valeur des données Capteur interne : 65 (100eme de dégré) Data Données de comptage 2F 2F 02 65 7A 0A 42 65 8F 0A 02 FD 17 10 63 6E • DIF Format des données Capteur externe : 42 VIF Valeur des données Capteur externe : 65 (100eme de dégré) Data 2F 2F 02 65 7A 0A 42 65 8F 0A 02 FD 17 10 63 6E • • • 7A 0A : valeur de la température d’ambiance à 1/100°C en héxadécimal inversé. Lire 0A 7A soit 2682 en décimal = 26.82°C 8F 0A : valeur de la température d’ambiance à 1/100°C en héxadécimal inversé. Lire 0A 8F soit 2703 en décimal = 27.03°C Code erreur 02 FD 17 10 63 02 FD 17 : DIF / VIF 10 63 --> 0x6310 --> fatal error (10h) --> mesure remote sensor (63h) RSSI Niveau de réception du signal RSSI (en héxadécimal) de la trame reçue : valeur RSSI = -125 + (x * 0.5), soit dans cet exemple 6E = 110 RSSI = -125 + (110*0.5) = -70dBm Page 5 of 12 6E Application note - Décodage de trame WMBUS V1.1 2.2. Exemple de trame d’historique WMBUS sonde de température d’ambiance • • • Profondeur historique = 1440 min / 60 = 24 enregistrements Emission d’un trame toutes les 12 heures (garantie des périodes de recouvrement) Enregistrement d’une valeur sur 16 bits signés, précision 1/10 °C (-32767,+32768) 1B 18 00 40 00 01 01 Code de trame SN Number Manufacturer ID Version Device Type Access number Status Signature Historique 24h Multiplicatuer 3C 00 00 03 18 01 64 00 5A00 ....... Valeurs suivantes 05 Deuxième valeur 46 06 Première valeur 19 19 19 19 Compteur d’historique AD Nombre de valeur 1B Valeur type 05 Période d’une valeur en mn 19 19 19 19 Device type 46 06 Data-Field Version 44 CIField A-Field SN Number 44 Manufacturer ID MField Control Start data from Transmitter CField Taille de trame FF LField 2.2.1 Description Type Description Valeur Code de trame Identifie le type de trame 0xAD : trame d’historique SN Number Numéro de série du compteur Manufacturer ID Numéro du fabricant Version Version produit 0x05 : Version 5 Device type Type de produit 0x1B : Température (room sensor) Access number Nombre d’accès Status Status Signature 0x00 : NO ERROR 40 --> 4 : Nombre de bloc de 16 octets, 0 : invariable 00 : pas de cryptage, 05 : cryptée AES128 mode 5 Historique Historique 24h 01 Multiplicateur (valeur en 1/10°C) 01 Période d’une valeur en minute 0x3C 00 00 en hexadécimal inversé. Lire 00 00 3C = 60minutes Valeur type 3 = type 16 bits signés (en compléments à 2) Nombre de valeur 0x18 : 24 valeurs 16 bits Compteur incrémenté à chaque modification historique 01 Première valeur 64 00 : valeur de la température d’ambiance à 1/10°C en héxadécimal inversé. Lire 00 64 soit 100 en décimal = 10.0°C Deuxième valeur 5A 00 : Lire 00 5A soit 90 en décimal = 9.0°C Valeurs suivantes....... Appliquer conversion comme ci-dessus Page 6 of 12 Application note - Décodage de trame WMBUS V1.1 2.3. Code erreur trame WMBUS Ambient sensor Contexte 1 Bit de statut b7 b6 b5 b4 b3 b2 b1 b0 Alarme Détail not used not used 1 41h Bouton poussoir relâché (produit mal clipsé) 1 Batterie > 10 ans de fonctionnement 1 Batterie Batterie faible <2.2 volts Radio Erreur d’émission de trame Capteur Erreur de mesure de capteur de référence 1 1 Not used Not used 61h Not used Note 1 Not used 40h BP 62h 1 Capteur Erreur de mesure capteur intégré 63h 1 Capteur Erreur de mesure capteur déporté 67h 1 Batterie Batterie déchargée <2 volts Contexte1 : l’octet « contexte » est partagé entre les différentes alarmes. Si 1 seule alarme est armée, sa valeur est associée à cette alarme. Si plusieurs alarmes sont armées, sa valeur correspond à la dernière alarme armée. Note1 : code interne détecté lors de l’erreur Radio Page 7 of 12 Application note - Décodage de trame WMBUS V1.1 Consumption index frame 1.Standard WMBUS frame example (water meter) L-Field C-Field M-Field RSSI 12 Value information Field D6 47 00 00 Data 04 Data information Field Status Access number 00 00 Signature 46 06 01 07 26 00 Device Type Manufacturer ID 07 00 00 10 Version Control 72 Manufacturer ID Taille de trame 07 SN Number Start data from Transmitter 07 00 00 10 01 Data-Field Frame code 46 06 CI-Field Device type 44 Version 1D SN Number FF A-Field 1.1. Description Type Description Value Control Invariable 0x44 : SEND/NO REPLY Manufacturer ID Manufacturer Identification 0x4606 : ARF (Adeunis RF) SN Number Serial number Version Product version 0x01 : version 1 0x03 : Gas Device type Type of device 0x07 : Water 0x02 : Electricity 0x1B : Temperature (room sensor) CI-Field Identify the type of frame SN Number Meter serial number Manufacturer ID Manufacturer Identification 0x4606 : ARF (Adeunis RF) Version Product version 0x01 : version 1 0x72 : Index frame 0x03 : Gas 0x07 : Water Device type Type of device Access number Access number (increment at each access) Status Status 0x00 : NO ERROR Signature Invariable 0x00 : no encryption DIF Data format 0x04 : data format on 32 bits 0x02 : Electricity 0x1B : Temperature (room sensor) 0x12 : 0.1L or 1dm3 (water or gas) VIF Data value 0x03 : 1Wh (Electricity) 0x66 : 0.01°C Data Consumption data RSSI Level of signal reception D6 47 00 00 : inverted hexadecial data. Read : 00 00 47 D6 in hexadécimal, ie 18390 in decimal = 1839 liters RSSI of the frame : RSSI value = -125 + (x * 0.5), ie in this example 5A = 90, RSSI = -125 + (90*0.5) = -80dBm Page 8 of 12 5A Application note - Décodage de trame WMBUS V1.1 1.2. Example of WMBUS standard history frame • • • History deepness = 1440 min / 45 = 32 records One history frame transmitted every 12 hours 64 bytes : 2 bytes represent the value CIField ............. Data-Field RSSI 00 00 00 04 0A 00 4E C0 Frame type SN Number Manufacturer ID Version Device Type Access number Status Signature History type Data value Period 03 1A 01 00 00 00 00 ..... FF FF Last value 71 Second value 07 First value 01 Access number 46 06 Number of value 07 00 00 10 Value type AD 1.2.1 Description Type Description Value CI-Field Identify the type of frame 0xAD : history frame SN Number Product serial number Manufacturer ID Manufacturer identification Version Product version 0x01 : Version 1 Device type Product type 0x07 : Water Access number Number of access Status Status 0x00 : NO ERROR Signature 00 --> 0 : number of 16 bytes blocks, 0 : invariable 00 : no encryption, 05 : AES128 mode 5 encryption History History type (1 byte) 01 : 24h history 02 : 7 days history 03 : 31 days history 04 : 1 year history 05 : 3 years history Data value (weight) in L, dm3 History period in minutes (3 bytes). 00 4E C0 : in hexadecimal. In decimal 20160mm = 14 days Value type 1 = 4 bits type 2 = 8 bits type 3 = 16 bits type Number of value N value of 8 bytes or N value of 16 bytes according to «value type» Meter history (access number) Incremented at each modification First value data in inverted hexadecimal 0.1L or 0.1dm3 following values....... Apply conversion as above Last value FF FF 1.3. WMBUS standard frame Error code (Status) Status byte b8 b7 b6 b5 b4 b3 b2 b1 1 1 1 Not used Not used Not used Not used 1 Alarm Detail Battery Low battery <2.2 volts Permanent error Temporary error Configuration error Error of product configuration Page 9 of 12 5A Application note - Décodage de trame WMBUS V1.1 2.Standard frame from Ambient sensor, OMS compliant 46 06 05 1B 8B 00 10 00 2F 2F 02 65 7A 0A 42 65 8F 0A Signature Encryption verification Data information Field Value information Field Data Data information Field Value information Field Data 02 FD 17 10 63 Error code 19 19 19 19 Status 72 Access number Control 1B Device Type Taille de trame 05 Version Start data from Transmitter 19 19 19 19 RSSI Manufacturer ID 46 06 Data-Field SN Number 44 Code de trame 1B Device type FF CIField A-Field Version MField SN Number CField Manufacturer ID LField 2.1. Description Type Description Value Control CI-Field 0x44 : SEND/NO REPLY Manufacturer ID Manufacturer identification 0x4606 : ARF (Adeunis RF) SN Number Product serial number Version Product version 0x05 : Version 5 0x03 : Gas 0x07 : Water Device type Type of device CI-Field Frame type identification SN Number Product serial number Manufacturer ID Manufacturer identification Version Version 0x05 : Version 5 Device type Type of device 0x1B : Temperature (room sensor) Access number Access number Status Status 0x02 : Electricity 0x1B : Temperature (room sensor) Signature 0x72 : index frame 0x00 : NO ERROR 10 --> 1 : Number of 16 bytes block, 0 : invariable 00 : no encryption, 05 : AES128 encryption mode 5 Encryption verification Internal sensor External sensor Fixed marker 2F 2F : no encryption DIF Data format Internal sensor : 02 VIF Data value Internal sensor : 65 (0.01°C) Data Consumption data 2F 2F 02 65 7A 0A 42 65 8F 0A 02 FD 17 10 63 6E • DIF Format des données External sensor : 42 VIF Valeur des données External sesnor : 65 (0.01°C) Data 2F 2F 02 65 7A 0A 42 65 8F 0A 02 FD 17 10 63 6E • • • 7A 0A : value of ambient sensor temperature 1/100°C in inverted hexadecimal. Read 0A 7A, ie 2682 in decimal = 26.82°C 8F 0A value of ambient sensor temperature 1/100°C in inverted hexadecimal. Read 0A 8F, ie 2703 in decimal = 27.03°C Error code (cf Ambient sensor user guide) 02 FD 17 10 63 02 FD 17 : DIF / VIF 10 63 --> 0x6310 --> fatal error (10h) --> remote sensor measure (63h) RSSI Level of signal reception RSSI of the frame : RSSI value = -125 + (x * 0.5), ie in this example 6E = 110, RSSI = -125 + (110*0.5) = -70dBm Page 10 of 12 6E Application note - Décodage de trame WMBUS V1.1 2.2. Exemple de trame d’historique WMBUS sonde de température d’ambiance • • • Profondeur historique = 1440 min / 60 = 24 enregistrements Emission d’un trame toutes les 12 heures (garantie des périodes de recouvrement) Enregistrement d’une valeur sur 16 bits signés, précision 1/10 °C (-32767,+32768) 1B 18 00 40 00 01 01 Frame type SN Number Manufacturer ID Version Device Type Access number Status Signature 24h history Multiplier 3C 00 00 03 18 01 64 00 5A00 ....... Following values 05 Second value 46 06 First value 19 19 19 19 History counter AD Number of value 1B Value type 05 Value period in minute 19 19 19 19 Device type 46 06 Data-Field Version 44 CIField A-Field SN Number 44 Manufacturer ID MField Control Start data from Transmitter CField Frame size FF LField 2.2.1 Description Type Description Value CI-Field Frame type identification 0xAD : history frame SN Number Product serial number Manufacturer ID Manufacturer identification Version Version 0x05 : Version 5 Device type Type of device 0x1B : Temperature (room sensor) Access number Access number Status Status Signature 0x00 : NO ERROR 40 --> 4 : Number of 16 bytes blocks, 0 : invariable 00 : no encryption, 05 : AES128 encryption mode 5 History 24h history 01 Multiplier (value in 1/10°C) 01 Value period in minute 0x3C 00 00 in inverted hexadecimal. read 00 00 3C = 60minutes Type of value 3 = type 16 bits signed Number of value 0x18 : 24 values of 16 bits counter incremented at each modification 01 First value 64 00 : value of ambient sensor at 1/10°C in inverted hexadecimal. read 00 64 ie 100 in decimal = 10.0°C Second value 5A 00 : Read 00 5A ie 90 in decimal = 9.0°C Following values.... Apply conversion as above Page 11 of 12 Application note - Décodage de trame WMBUS V1.1 2.3. WMBUS Ambient sensor frame error code Context 1 Status byte b7 b6 b5 b4 b3 b2 b1 b0 Alarm Detail Not used not used 1 41h Push button is released (produced poorly clipped) Battery > 10 years of operation 1 Battery Low battery <2.2 volts Radio Frame error Sensor Measurement error of the reference sensor 1 1 Not used Not used 61h Not used Note 1 Not used 40h BP 1 62h 1 Sensor Measurement error integrated sensor 63h 1 Sensor Measurement error remote sensor 67h 1 Battery Discharged battery <2 volts Context1 : the byte «context» is shared between the various alarms. If only one alarm is armed, its value is associated with this alarm. If several alarms are armed, its value corresponds to the last armed alarm. Note1 : internal code detected during Radio error. Page 12 of 12 ">
Public link updated
The public link to your chat has been updated.