Briques techniques

gtbdecode

Décodeur & Encodeur Payload LoRaWAN

Décoder et encoder un payload LoRaWAN — 900+ devices TTN, Cayenne LPP, hex/base64. Codec TTN v3 / ChirpStack v4 téléchargeable.

lorawan
ttn
chirpstack
encoder
downlink
hex
base64

Device

Payload

espaces et 0x acceptés

fPort

1 – 223

Sélectionnez un device, collez votre payload,
puis cliquez sur Décoder.

Comprendre LoRaWAN — encoder & décoder

Récupérer le codec sans décoder une trame

Sélectionnez votre device puis dépliez l'accordéon « Récupérer le codec prêt à l'emploi ». Vous obtenez le payload formatter du fabricant en deux variantes : TTN v3 (prêt pour TheThingsStack) ou ChirpStack v4 (wrappé pour le runtime TR013). Le fichier inclut decodeUplink, et encodeDownlink si le vendor le fournit.

Encoder un downlink : à quoi ça sert ?

Configurer un device LoRaWAN sans passer par la console du Network Server : envoyer une consigne (« set valve on »), changer un intervalle de reporting, déclencher une commande de test, demander une position à la demande. L'outil compose le payload binaire à partir d'un objet structuré, prêt à coller dans l'interface downlink de votre NS (TTN, ChirpStack, Loriot, Actility…).

Comment trouver le fPort ?

Le fPort (1 à 223) identifie le type de message côté applicatif. Beaucoup de fabricants n'en utilisent qu'un seul (souvent 1, 2, 10, 85 ou 100). D'autres en utilisent plusieurs pour différencier données capteur, alarmes et acquittements de configuration. Référez-vous à la datasheet du device, ou observez le champ f_port de votre trame.

Où récupérer ou envoyer le payload ?

Sur ChirpStack : champ frmPayload (base64) ou data en MQTT JSON. Sur The Things Stack : uplink_message.frm_payload. Sur Loriot ou Actility ThingPark : champ payload_hex. En Niagara : objet nFrame du driver LoRaWAN. Pour un downlink, la plupart des NS attendent le payload encodé en base64 ou hex.

Mon device n'est pas dans la liste ?

Beaucoup de devices génériques utilisent le format Cayenne LPP (sélectionnable en haut de la liste, decoder uniquement). Sinon, vous pouvez contribuer au catalogue TTN via une PR sur le guide de contribution — le repo est resynchronisé manuellement à chaque mise à jour d'OpenGTB.

Couverture encodeur

Tous les codecs TTN n'exposent pas la fonction encodeDownlink. Sur notre catalogue, environ la moitié des devices a un encodeur, et ~399 devices fournissent en plus des exemples downlink cliquables (Netvox, Milesight, Decentlab, Tektelic…). Pour les autres, l'onglet « Encoder downlink » est automatiquement désactivé.

Codecs issus de TheThingsNetwork/lorawan-devices sous licence Apache-2.0.