🛠 Serveur web embarqué : l'Ethernet natif 10/100 du Teensy 4.1 (DP83825)

Objetivos

El Teensy 4.1 integra un controlador Ethernet 10/100 Mbit con DMA y PHY TI DP83825I en la placa: solo falta el conector RJ45 con transformadores magnéticos, que se vende como kit para soldar. Este tutorial configura un servidor HTTP que expone las mediciones de la placa a la red local — sin shield, sin SPI, sin chip-select.

Material

• 1 Teensy 4.1 (la variante TEENSY41_NE NO tiene chip Ethernet: verifique su referencia)
• 1 kit de conector RJ45: https://www.pjrc.com/store/ethernet_kit.html (soldadura fina)
• Cable Ethernet, router DHCP

Puntos clave

• Dado que el PHY es interno, no se necesita Ethernet.init(cs): basta con Ethernet.begin(mac).
• La biblioteca oficial Ethernet (WebServer, ChatServer, SMTP...) funciona tal cual en el 4.1.
• Ethernet.hardwareStatus detecta la ausencia de hardware — indispensable para distinguir una variante NE de un cable desconectado.
• Ethernet.maintain renueva el arrendamiento DHCP: llámelo en el bucle principal.
• Solo 10/100, no gigabit: para telemetría y API ligera, es más que suficiente.

Código completo

#include <Ethernet.h>

byte mac[] = { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED }; // MAC unique !
EthernetServer server(80);

void setup {
  Serial.begin(9600);
  Ethernet.begin(mac);                    // DHCP ; (mac, ip) pour statique
  if (Ethernet.hardwareStatus == EthernetNoHardware) {
    Serial.println("Pas de materiel Ethernet (variant -NE ?)");
    while (true) delay(1);
  }
  server.begin;
  Serial.print("serveur a ");
  Serial.println(Ethernet.localIP);
}

void loop {
  Ethernet.maintain;
  EthernetClient client = server.available;
  if (!client) return;
  bool lineDone = false;
  while (client.connected && !lineDone) {
    if (client.available) {
      char c = client.read;
      if (c == '\n') lineDone = true;   // fin des en-tetes HTTP
    }
  }
  client.println("HTTP/1.1 200 OK");
  client.println("Content-Type: text/html");
  client.println("Connection: close");
  client.println;
  client.println("<html>A0 = ");
  client.print(analogRead(14));
  client.println("</html>");
  client.stop;
}

Verificación esperada

La IP asignada por DHCP se muestra en el puerto serie; al escribirla en un navegador, la página muestra el valor de A0, actualizado en cada recarga.

Errores frecuentes

• Olvidar soldar el kit RJ45 (o comprar por error la variante NE): hardwareStatus devuelve EthernetNoHardware.
• Clonar el ejemplo sin cambiar la dirección MAC: dos máquinas con la misma MAC crean fallos de red fantasma.
• No llamar a Ethernet.maintain: el arrendamiento DHCP expira y el servidor se vuelve inaccesible tras algunas horas.
• Alternativas si no tiene el kit: un shield W5500/Wiz820 sobre SPI funciona en todos los Teensy — menos elegante, pero sin soldadura.