🛠 Premier sketch sur le cœur M4 : le blink qui se flash par ADB

Objetivos

Programar el lado Arduino de la X8: es el Cortex-M4 del STM32H747XI (hasta 240 MHz) el que programas desde el IDE de Arduino, mientras que el Cortex-M7 del mismo SoC ejecuta el firmware bridge «normalmente invisible» que expone los periféricos del MCU a Linux. La gran diferencia con una placa clásica: el sketch se sube mediante ADB (upload.tool=adb, VID 0x2341 / PID 0x0061, slot de aplicación 0x08100000–0x08200000), no por serie clásica. Vas a instalar el core, flashear un blink y entender quién hace qué de los tres sistemas embebidos en la placa.

Material

• 1 × Arduino Portenta X8 + cable USB-C de datos (puerto USB 3.0 preferiblemente)
• Arduino IDE 1.8.10+, Arduino IDE 2.x o arduino-cli
• Gestor de placas: core «Arduino Mbed OS Portenta Boards», y luego la placa «Arduino Portenta X8» (arduino:mbed_portenta:portenta_x8)
• La placa debe ser visible por adb devices antes de cualquier subida (ver el tutorial de primeros pasos)

Código completo

// blink_m4.ino — coeur Cortex-M4 du STM32H747XI de la Portenta X8
// Carte : "Arduino Portenta X8" (arduino:mbed_portenta:portenta_x8)
// L'upload passe par ADB, pas par un port serie classique.

#include "SerialRPC.h"   // optionnel : monitor serie proxyfie vers Linux

int compteur = 0;

void setup {
  Serial.begin(115200);      // visible cote Linux via le service m4-proxy
  while (!Serial) {}
  pinMode(LED_BUILTIN, OUTPUT);
  Serial.println("Portenta X8 - sketch M4 en vie");
}

void loop {
  digitalWrite(LED_BUILTIN, HIGH);
  delay(500);
  digitalWrite(LED_BUILTIN, LOW);
  delay(500);
  Serial.print("tick ");
  Serial.println(compteur++);
}

Verificación esperada

En el IDE, la subida muestra una progresión mediante adb y luego el sketch arranca: el LED parpadea a 1 Hz. El Serial de este sketch no es un puerto serie USB clásico — está proxyfiado hacia Linux por el servicio m4-proxy (el tutorial RPC te enseñará a leerlo desde un contenedor). Mantén la placa a la vista: si la subida falla, adb devices debe responder ya antes de tocar el código.

Errores frecuentes

• Subida que falla aunque el código compile: la subida ADB exige que la placa sea vista por adb — bajo Linux, permisos udev para el VID 0x2341; históricamente, adb también se ha roto en hosts arm64 (issue ArduinoCore-mbed #492, cerrada).
• Seleccionar «Portenta H7» en lugar de «Portenta X8»: misma familia de core, pero no el mismo target — el X8 tiene un bootloader/herramienta de subida diferente (adb).
• Esperar el monitor serie clásico del IDE: en la X8, la consola del M4 pasa por el SerialRPC/m4-proxy del lado de Linux; el monitor serie USB estándar no es la ruta documentada.
• Confundir los núcleos: el M4 es TU núcleo Arduino; el M7 del mismo SoC ejecuta el firmware bridge de Arduino (no flashear sobre él con el IDE — se actualiza mediante un procedimiento dedicado, ver el tutorial de firmware).
• Errores de compilación en ejemplos de internet tipo QSPIFBlockDevice not found o WiFiAccessPoint does not name a type: podredumbre conocida de ejemplos antiguos (issues ArduinoCore-mbed #529 abierta / #884 cerrada) — parte de los ejemplos del core instalado, no de blogs de 2022.
• > SIN VERIFICAR: pin exacto de LED_BUILTIN en la X8 y número de LEDs embebidas — la base documental no lo especifica; prueba y confirma en tu placa antes de cablear alrededor.