Aller au contenu principal

Réseau IP — Ethernet, WiFi, UDP, MQTT

Dès que vous devez faire dialoguer plus de deux appareils, ou que vous voulez atteindre le reste d'un réseau plutôt qu'un autre microcontrôleur, vous quittez les radios brutes pour le réseau IP. NodeBlue offre deux façons d'accéder à un réseau IP, avec deux agencements de modules différents :

  • Ethernet — la carte possède sa propre pile IP (via une puce Wiznet W5500/W5100 et un module nEthernet). Les transports de plus haut niveau — UDP et MQTT — sont alors des modules distincts (nUDP, nMQTTInterface + nMQTTInput + nMQTTOutput) reliés dans la conception.
  • WiFi via ESP8266 — la pile IP réside sur le module ESP8266 lui-même. La carte ne voit qu'une UART. nESP8266 gère l'UDP / TCP à l'intérieur du module (via son réglage Mode Com.) ; vous n'ajoutez pas de nUDP séparé pour cette voie.

Ainsi, une même conception ne passe pas automatiquement d'Ethernet au WiFi — elles sont agencées différemment. Les sections ci-dessous détaillent chacune d'elles.

Rejoindre le réseau​

Ethernet (W5500, etc.)​

Pour les cartes avec un shield Ethernet (famille Wiznet W5500 / W5100), déposez un module nEthernet. C'est la pile IP embarquée.

ParamètreDescription
Port SPI + broche CSComment la puce est câblée au microcontrôleur.
Adresse MACUne adresse matérielle unique de 6 octets (utilisez-en une aléatoire si votre shield n'a pas de MAC imprimée).
Mode IPStatique (IP / masque / passerelle / DNS fixes) ou DHCP (demander au routeur).
IP statique / masque réseau / passerelle / DNSUniquement lorsque Mode IP est Statique.

Une fois initialisé, nEthernet est rarement relié directement — c'est le support sur lequel s'exécutent nUDP / nMQTTInterface. La conception Examples/04-Communication/Ethernet montre la mise en route.

WiFi via ESP8266​

Si votre projet ne dispose pas d'un LAN filaire, la voie facile est un module ESP8266 connecté sur une UART. L'ESP exécute sa propre pile WiFi et IP — nUDP et nMQTT* ne sont pas utilisés sur cette voie ; le module nESP8266 parle lui-même l'UDP ou le TCP, via son paramètre Mode Com.

ParamètreDescription
PortL'UART matérielle sur laquelle le module ESP est câblé.
Mode Op.Station (rejoindre un réseau WiFi) ou Soft-AP (la carte devient le réseau WiFi).
Mode Com.UDP ou TCP — le transport que l'ESP relaie en entrée et en sortie de la carte.
SSID / Clé / SécuritéIdentifiants WiFi (en mode Station), ou identifiants du point d'accès qu'il diffusera (mode Soft-AP).
CanalCanal WiFi (1–13) — en mode Soft-AP.
Nom Hôte / Port HôteL'adresse / le port du pair vers lequel l'ESP transfère les paquets.
Nb TuyauxCombien de connexions TCP/UDP simultanées l'ESP gère.
Taille du tamponTaille du tampon de réception en octets.

Vous reliez les données directement en entrée / sortie des entrées et sorties de nESP8266 — la liaison WiFi et le formatage UDP (ou TCP) résident tous deux à l'intérieur du module.

remarque

Les cartes à WiFi natif (ESP32, certaines variantes Arduino MKR / Nano IoT) suivent le même schéma autonome via leur propre module spécifique à la plateforme : la pile WiFi et le formatage UDP/TCP sont regroupés ensemble.

UDP (par-dessus Ethernet)​

Pour les cartes Ethernet, le module nUDP est le transport IP sans fioritures : « envoie ce paquet d'octets à cette IP et ce port ; espère qu'il arrive ». Parfait pour les boucles de contrôle rapides, le streaming de capteurs et partout où vous préférez perdre un paquet de temps en temps plutôt que d'accumuler de la latence.

ParamètreDescription
Port d'écouteLe port sur lequel le module écoute les paquets entrants.
IP Dest.L'adresse IPv4 vers laquelle les paquets sont envoyés (saisie sous forme de quatre octets).
Port Dest.Le port à destination.

Tout ce qui est relié à son entrée devient un paquet UDP vers (IP Dest., Port Dest.) ; les paquets entrants arrivent sur la sortie. La conception Examples/04-Communication/UDP montre les bases — de petits paquets texte entre deux cartes.

attention

nUDP s'exécute par-dessus nEthernet. Pour de l'UDP sur WiFi, n'ajoutez pas de nUDP — configurez plutôt le Mode Com. du module nESP8266 sur UDP, et il gère le formatage lui-même.

MQTT​

Pour les projets s'étendant sur plusieurs cartes, passerelles et un backend, le modèle publication/abonnement de MQTT est difficile à battre. Un broker central héberge des topics nommés ; chaque carte publie sur des topics et s'abonne à d'autres. NodeBlue répartit le schéma sur trois modules :

ModuleRôle
nMQTTInterfaceLa connexion au broker — hôte, port, identifiants, id client. Un par carte.
nMQTTInputS'abonne à un topic. Sa sortie émet la charge utile de chaque message entrant correspondant.
nMQTTOutputPublie sur un topic. Chaque buffer arrivant sur son entrée devient un message.

Un schéma typique : chaque carte capteur publie sur home/livingroom/temperature (etc.), et une carte tableau de bord s'abonne à home/+/temperature pour toutes les afficher. Les caractères génériques de topic (+ pour un niveau, # pour tout ce qui se trouve en dessous) permettent à un seul abonné de gérer de nombreuses sources sans les énumérer.

Les brokers MQTT tournent couramment sur un Raspberry Pi ou toute machine allumée en permanence sur votre LAN (Mosquitto est le standard). Une fois l'un d'eux en place, une carte NodeBlue qui rejoint le réseau n'a besoin que de l'IP du broker, d'un id client et des topics à publier/auxquels s'abonner.

Choisir entre eux​

ConfigurationModules
LAN filaire, paquets sans confirmationnEthernet + nUDP
LAN filaire, pub/subnEthernet + nMQTTInterface + nMQTTInput/nMQTTOutput
WiFi, UDPnESP8266 avec Mode Com. = UDP — tout dans un seul module
WiFi, TCPnESP8266 avec Mode Com. = TCP — tout dans un seul module

Deux bus de plus bas niveau — SPI et I²C — sont utilisés en interne par de nombreux modules (capteurs, afficheurs, les puces radio elles-mêmes). Commencez par SPI.