Registre des PortNum Meshtastic : ports d’application et types de paquets

Le registre des applications sur les ondes de Meshtastic, transcrit mot à mot depuis meshtastic/protobufs → portnums.proto (en date du 2026-07-21). Les noms de ports restent en anglais parce que ce sont des identifiants littéraux du protocole. Les comportements absents du .proto (sémantique des accusés par port, règles de pont MQTT) sont volontairement laissés à la documentation du micrologiciel plutôt que devinés ici; la pertinence MQTT n’est notée que là où le .proto l’affirme.

Déc	Hex	PortNum	Plage	Charge utile / usage
0	0x0	UNKNOWN_APP	Sentinelle	Un paquet provenant de l'extérieur du mesh, dans une forme que le mesh ne comprend pas.
1	0x1	TEXT_MESSAGE_APP	Cœur (intégré, 0-63)	Messagerie texte UTF-8 brute — la charge utile de clavardage par défaut.
2	0x2	REMOTE_HARDWARE_APP	Cœur (intégré, 0-63)	App exemple intégrée de contrôle GPIO / matériel à distance.
3	0x3	POSITION_APP	Cœur (intégré, 0-63)	Mises à jour de position via le protobuf Position.
4	0x4	NODEINFO_APP	Cœur (intégré, 0-63)	Identité du nœud/utilisateur via le protobuf User.
5	0x5	ROUTING_APP	Cœur (intégré, 0-63)	Contrôle du protocole (accusés de réception, erreurs de routage) via le protobuf Routing.
6	0x6	ADMIN_APP	Cœur (intégré, 0-63)	Administration à distance via le protobuf AdminMessage.
7	0x7	TEXT_MESSAGE_COMPRESSED_APP	Cœur (intégré, 0-63)	Charges TEXT_MESSAGE compressées avec Unishox2.
8	0x8	WAYPOINT_APP	Cœur (intégré, 0-63)	Points de repère cartographiques partagés via le protobuf Waypoint.
9	0x9	AUDIO_APP	Cœur (intégré, 0-63)	Paquets voix Codec2 encapsulés (bande passante de classe 2.4 GHz).
10	0xA	DETECTION_SENSOR_APP	Cœur (intégré, 0-63)	Messages texte émis par les modules de capteurs de détection.
11	0xB	ALERT_APP	Cœur (intégré, 0-63)	Format texte pour les alertes critiques (contourne la mise en sourdine normale des notifications).
12	0xC	KEY_VERIFICATION_APP	Cœur (intégré, 0-63)	Gère les demandes de vérification de clés publiques entre nœuds.
13	0xD	REMOTE_SHELL_APP	Cœur (intégré, 0-63)	Accès rudimentaire à un interpréteur de commandes à distance.
32	0x20	REPLY_APP	Cœur (intégré, 0-63)	Un service « ping » qui renvoie en écho tout paquet reçu.
33	0x21	IP_TUNNEL_APP	Cœur (intégré, 0-63)	Tunnel IP-sur-mesh expérimental (Python).
34	0x22	PAXCOUNTER_APP	Cœur (intégré, 0-63)	Charges Paxcounter (comptage de personnes).
35	0x23	STORE_FORWARD_PLUSPLUS_APP	Cœur (intégré, 0-63)	Store-forward en chaîne de messages de type Git pour les nœuds Linux natifs.
36	0x24	NODE_STATUS_APP	Cœur (intégré, 0-63)	Courte chaîne d'état diffusée périodiquement par un nœud.
37	0x25	MESH_BEACON_APP	Cœur (intégré, 0-63)	Diffusion en mode balise annonçant du texte + des offres de canal/préréglage.
64	0x40	SERIAL_APP	Module (enregistré, 64-127)	Relie une interface série matérielle (RX/TX) au mesh.
65	0x41	STORE_FORWARD_APP	Module (enregistré, 64-127)	Persistance des messages en mode store-and-forward.
66	0x42	RANGE_TEST_APP	Module (enregistré, 64-127)	Module de test de portée (mesure distance/perte de paquets).
67	0x43	TELEMETRY_APP	Module (enregistré, 64-127)	Cadre de télémétrie appareil / environnement / alimentation.
68	0x44	ZPS_APP	Module (enregistré, 64-127)	Estimation de position expérimentale sans GPS.
69	0x45	SIMULATOR_APP	Module (enregistré, 64-127)	Application de simulateur LoRa sous Linux.
70	0x46	TRACEROUTE_APP	Module (enregistré, 64-127)	Traceroute — révèle le chemin de sauts qu'emprunte un paquet.
71	0x47	NEIGHBORINFO_APP	Module (enregistré, 64-127)	Infos agrégées sur les voisins directs d'un nœud (arêtes du réseau).
72	0x48	ATAK_PLUGIN	Module (enregistré, 64-127)	Greffon officiel Meshtastic pour ATAK (Android Team Awareness Kit).
73	0x49	MAP_REPORT_APP	Module (enregistré, 64-127)	Infos de nœud non chiffrées pour les applications de cartes publiques — envoyées via MQTT.
74	0x4A	POWERSTRESS_APP	Module (enregistré, 64-127)	Module automatisé de tests de puissance / stress.
75	0x4B	LORAWAN_BRIDGE	Module (enregistré, 64-127)	Transporte des charges LoRaWAN avec leurs métadonnées RF.
76	0x4C	RETICULUM_TUNNEL_APP	Module (enregistré, 64-127)	Interface tunnel pour la pile réseau Reticulum.
77	0x4D	CAYENNE_APP	Module (enregistré, 64-127)	Transport de télémétrie Cayenne Low Power Payload (LPP).
78	0x4E	ATAK_PLUGIN_V2	Module (enregistré, 64-127)	Greffon ATAK v2 (TAKPacketV2 + compression zstd).
79	0x4F	LORA_OTA_APP	Module (enregistré, 64-127)	Mises à jour signées du micrologiciel via LoRa (OTA).
112	0x70	GROUPALARM_APP	Module (enregistré, 64-127)	Transport d'intégration des messages d'alerte GroupAlarm.
256	0x100	PRIVATE_APP	Privé / personnalisé (256-511)	Réservé au développement d'apps privées sans recompiler les protobufs.
257	0x101	ATAK_FORWARDER	Privé / personnalisé (256-511)	Module de relais ATAK (libcotshrink).
511	0x1FF	MAX	Limite de plage	Borne supérieure de l'espace d'allocation des PortNum (pas une app).

Comment fonctionnent les plages

• 0-63 — cœur : intégrées à chaque micrologiciel Meshtastic (texte, position, nodeinfo, routage, admin; la télémétrie vit juste au-dessus, à 67).
• 64-127 — modules : modules enregistrés optionnels (série, store-and-forward, test de portée, traceroute, ATAK, rapport de carte, pont LoRaWAN, OTA).
• 256-511 — privé/personnalisé : utilisez PRIVATE_APP (256) et au-dessus pour vos propres applications; elles n’entreront jamais en conflit avec un port officiel.

Pages reliées (en anglais)

Référence MeshPacket & champ Data (l’enveloppe de paquet qui transporte ce portnum) · Chiffrement Meshtastic & modèle PSK · comparaison d’appareils · réglages régionaux LoRa · référence des kinds d’événements Nostr (l’analogue Nostr de cette page) · calculateur de portée · Pôle mesh souverain (en français).

Crédit : l’énumération PortNum est définie et maintenue par le projet Meshtastic dans meshtastic/protobufs (GPL-3.0). Cette page est un index daté, lisible par les humains, de ce fichier.