Nouveau : le pare-feu IA surveille toute la plateforme et explique chaque incident en termes simples. Découvrez comment ça marche

Charges utiles JSON vs binaires pour appareils IoT, et taille maximale d’un message

Les mêmes trois mesures occupent 52 octets en JSON et 5 en binaire. Quand chaque format vaut le coup, et quelles limites de taille posent problème en pratique.

Les charges utiles JSON sont lisibles, auto-descriptives et faciles à déboguer, mais plusieurs fois plus volumineuses que les mêmes mesures empaquetées en binaire, ce qui nécessite un décodeur connaissant la disposition des octets. MQTT 3.1.1 autorise des paquets allant jusqu’à 268,435,455 octets, donc les limites de taille qui posent problème en pratique viennent des tampons des clients, des paramètres du broker et des trames radio.

Je choisis le format d’abord selon la liaison et la batterie, puis selon la personne qui doit déboguer les messages. Si le transport est encore ouvert, commencez par MQTT vs HTTP pour les appareils IoT.

Quelle est la taille maximale d’un message MQTT ?

La limite du protocole est de 268,435,455 octets, soit environ 256 Mo, par paquet. La spécification MQTT 3.1.1 encode la Remaining Length d’un paquet sur quatre octets au maximum, et c’est elle qui fixe ce plafond.

Les limites que vous rencontrez sont bien plus basses. Une bibliothèque cliente sur microcontrôleur fonctionne généralement avec un tampon fixe qui doit contenir tout le paquet : en-tête, nom de topic et charge utile. Lorsqu’un message dépasse ce tampon, la publication peut échouer avec une erreur facile à manquer. Un broker peut imposer son propre maximum, et un nom de topic long consomme le même tampon.

Comment envoyer du JSON via MQTT ?

Sérialisez l’objet en chaîne UTF-8 et publiez ses octets ; l’abonné qui enregistre votre historique les relit. MQTT ne regarde pas à l’intérieur. La spécification indique : « le contenu et le format des données sont propres à l’application ».

Deux règles de la RFC 8259 gardent le JSON portable. Le JSON échangé entre systèmes hors d’un écosystème fermé doit être en UTF-8, et seuls les entiers compris entre -(2^53)+1 et 2^53-1 sont interopérables, c’est-à-dire que les implémentations s’accordent sur leur valeur exacte ; un compteur 64 bits ou un long numéro de série est donc plus sûr sous forme de chaîne. Les clés voyagent avec chaque message, donc leur longueur apparaît dans le nombre d’octets :

Charge utileOctets
{"temperature":21.37,"humidity":48.2,"battery":3.61}52
{"t":21.37,"rh":48.2,"bat":3.61}32
Binaire : température en entier signé de 16 bits en centièmes, humidité en un octet par demi-pourcent (48.2 est transmis comme 48.0), batterie en entier non signé de 16 bits en millivolts5

Un appareil IoT doit-il envoyer du JSON ou du binaire ?

Envoyez du JSON lorsque la bande passante et la batterie ne coûtent presque rien et que beaucoup de personnes lisent les messages ; envoyez du binaire lorsque chaque octet coûte du temps d’antenne ou de la batterie. Le Concise Binary Object Representation (CBOR), défini dans la RFC 8949, se situe entre les deux : compact, et décodable sans schéma, comme le JSON.

CritèreJSONBinaire empaqueté
TailleLa plus grande : les clés voyagent avec chaque messageLa plus petite : les valeurs seulement
DébogageLisible dans n’importe quel journalNécessite le décodeur
Ajout d’un champLes lecteurs qui ignorent les clés inconnues continuent de fonctionnerLes deux extrémités changent la disposition ensemble
DécodeurN’importe quel analyseur JSONCode écrit pour cette disposition

La trame radio est la limite la plus stricte. Dans la bande EU863-870, les LoRaWAN Regional Parameters (RP002-1.0.3) autorisent au maximum 51 octets de charge utile applicative aux data rates DR0 à DR2, les plus lents. Le JSON de 52 octets ci-dessus ne rentre pas, alors que le binaire de 5 octets rentre dix fois. Sur ces liaisons, le serveur utilise un décodeur par modèle de capteur, un codec de charge utile LoRaWAN. Le Constrained Application Protocol (CoAP) est plus souple : la RFC 7252 indique 1,024 octets comme bonne borne supérieure pour la charge utile lorsqu’on ne connaît rien du chemin, afin d’éviter la fragmentation IP.

Comment convertir une charge utile en octets en chaîne ?

Utilisez la longueur fournie avec le message, et non un zéro terminal. Une charge utile MQTT est une suite d’octets dont la longueur découle de l’en-tête du paquet, et rien n’ajoute de caractère nul à la fin ; un code C qui traite le tampon comme une chaîne lit donc au-delà de la charge utile.

Copiez exactement ce nombre d’octets, ajoutez vous-même le terminateur et décodez en UTF-8 avant d’analyser le JSON. Une charge utile binaire ne doit jamais devenir une chaîne : lisez chaque champ à son décalage, dans l’ordre des octets convenu par les deux extrémités. L’ordre des octets et des mots est le même piège qui touche les flottants 32 bits dans l’adressage des registres Modbus.

Questions fréquentes

Peut-on envoyer du CBOR ou un autre encodage binaire via MQTT ?

Oui. MQTT 3.1.1 traite la charge utile comme des octets dont le contenu et le format sont propres à l’application, donc tout encodage fonctionne. L’abonné doit savoir lequel attendre, généralement d’après le topic ou d’un accord par type d’appareil.

Faut-il mettre des horodatages dans la charge utile ?

Mettez un horodatage dans la charge utile lorsque l’appareil met en mémoire tampon des mesures ou les envoie en retard, afin que le récepteur enregistre chaque mesure à l’instant où elle a été effectuée. Un appareil qui n’envoie que des valeurs en direct peut s’en passer et laisser le récepteur horodater l’arrivée. En JSON, une chaîne ISO 8601 est lisible ; en binaire, un temps Unix sur 32 bits est compact.

Un même appareil peut-il mélanger des messages JSON et binaires ?

Oui, si le récepteur sait les distinguer, par exemple par le topic ou par un octet de type en tête. Je l’éviterais sur un même topic : chaque consommateur aurait alors besoin des deux analyseurs, et une charge utile qui commence par une accolade par hasard serait lue dans le mauvais format.

Partager

Voyez vos données terrain en direct dès cette semaine

Démarrez un essai dans votre région avec vos premiers appareils, ou réservez une démo et apportez votre propre cas d'usage.