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 utile | Octets |
|---|---|
{"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 millivolts | 5 |
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ère | JSON | Binaire empaqueté |
|---|---|---|
| Taille | La plus grande : les clés voyagent avec chaque message | La plus petite : les valeurs seulement |
| Débogage | Lisible dans n’importe quel journal | Nécessite le décodeur |
| Ajout d’un champ | Les lecteurs qui ignorent les clés inconnues continuent de fonctionner | Les deux extrémités changent la disposition ensemble |
| Décodeur | N’importe quel analyseur JSON | Code é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.

