14.1.1.1. Configurar el entorno de desarrollo

Necesitas tres cosas en el host antes de poder compilar: un editor (se recomienda VS Code porque el depurador se integra con él), un shell de tipo Linux (WSL en Windows, nativo en Linux/macOS) y el repositorio de OpenMV con el SDK fijado extraído.

14.1.1.1.1. VS Code

Cualquier editor sirve para el desarrollo de firmware: la compilación es simplemente make, y el depurador en hardware también se ejecuta desde la línea de comandos. Visual Studio Code es sencillamente el camino más fácil: la configuración de Depuración del firmware se integra con su extensión Cortex-Debug, así que con VS Code instalado el resto de estas páginas funcionan sin más configuración, tanto para compilar como para depurar.

14.1.1.1.1.1. Instalar VS Code

  • Windows: descarga el instalador desde code.visualstudio.com y ejecútalo. Instala VS Code en Windows, no dentro de WSL; se integra con WSL a través de la extensión WSL, ejecutando su interfaz en Windows mientras el compilador, los archivos y el depurador residen en Linux.

  • macOS: descarga el .zip desde code.visualstudio.com, descomprímelo y arrastra Visual Studio Code.app a /Applications. O bien brew install --cask visual-studio-code.

  • Linux: instala el .deb / .rpm desde code.visualstudio.com (p. ej. sudo apt install ./code_*.deb), o usa el Snap/Flatpak de tu distribución.

Extensiones que debes instalar (desde el panel de Extensiones, Ctrl+Shift+X):

  • C/C++ (ms-vscode.cpptools): navegación por código fuente C e IntelliSense.

  • Cortex-Debug (marus25.cortex-debug): depuración en el chip mediante GDB y un servidor J-Link / OpenOCD. Necesaria para Depuración del firmware.

  • WSL (ms-vscode-remote.remote-wsl): solo Windows. Permite que VS Code abra una carpeta dentro de tu distribución de WSL para que el editor, la terminal, IntelliSense y Cortex-Debug operen todos en Linux. Instala las extensiones C/C++ y Cortex-Debug en el host WSL una vez conectado (VS Code te lo solicita).

14.1.1.1.2. Shell del host

Necesitas un entorno Linux (x86-64) o macOS (arm64) con git y unas pocas herramientas básicas. Elige la sección correspondiente a tu sistema operativo.

14.1.1.1.2.1. Windows: instalar WSL

WSL ejecuta un userland Ubuntu genuino en Windows. Una vez instalado, todas las instrucciones posteriores de esta guía son idénticas a las de Linux nativo.

  1. Abre PowerShell como Administrador (clic derecho en Inicio -> Terminal (Admin)).

  2. Instala WSL con la distribución Ubuntu predeterminada:

    wsl --install

    Esto habilita las características necesarias de Windows, instala el kernel de WSL 2 e instala Ubuntu. Reinicia si se te solicita.

  3. Tras el reinicio, Ubuntu se inicia y te pide crear un nombre de usuario y una contraseña de UNIX. Esta cuenta es independiente de tu cuenta de Windows.

  4. Actualiza la distribución:

    sudo apt update && sudo apt upgrade -y

  5. Confirma que estás en WSL 2 (obligatorio: WSL 1 no es compatible con este flujo de trabajo). En PowerShell:

    wsl --list --verbose

    La columna VERSION debe indicar 2. Si indica 1, conviértela:

    wsl --set-version Ubuntu 2

Truco

Trabaja dentro del sistema de archivos de Linux (~/ en WSL), no bajo /mnt/c/. Compilar en la unidad montada de Windows es drásticamente más lento y puede causar problemas de permisos de archivos y de fin de línea. Clona el repositorio en tu directorio de inicio de WSL.

Para abrir el proyecto más adelante: inicia Ubuntu desde el menú Inicio para obtener un shell, o desde VS Code en Windows pulsa Ctrl+Shift+P -> WSL: Connect to WSL, luego File -> Open Folder y elige el repositorio clonado en el sistema de archivos de Linux.

14.1.1.1.2.2. Requisitos previos de Linux / WSL

El SDK proporciona el compilador, por lo que solo se necesitan unos pocos paquetes del host:

sudo apt-get update
sudo apt-get install git build-essential

14.1.1.1.2.3. Requisitos previos de macOS

La compilación nativa solo es compatible con macOS de Apple Silicon (arm64). Usando Homebrew:

brew install bash make coreutils

(Los Mac con Intel no son un host de compilación nativa compatible; usa la compilación con Docker de Compilar el firmware o una máquina virtual con Linux.)

14.1.1.1.3. Obtener el código fuente

Clona el repositorio con todos los submódulos (MicroPython, CMSIS, controladores de proveedores, etc.):

git clone --recursive https://github.com/openmv/openmv.git
cd openmv

Una clonación recursiva completa es grande. Para una clonación más rápida y superficial (shallow):

git clone --depth=1 https://github.com/openmv/openmv.git
cd openmv
git submodule update --init --depth=1 --no-single-branch
git -C lib/micropython/ submodule update --init --depth=1

Nota

Al compilar una placa específica, puedes en su lugar dejar que make descargue solo los submódulos de esa placa:

make TARGET=<board> submodules

El git submodule update explícito mostrado anteriormente ya cubre todo, por lo que este paso es opcional.

14.1.1.1.4. Instalar el OpenMV SDK

Desde la raíz del repositorio, ejecuta la instalación única del SDK:

make sdk

Esto descarga openmv-sdk-<version>-<os>-<arch>.tar.xz desde download.openmv.io, verifica su suma de comprobación SHA-256 y lo extrae en ~/openmv-sdk-<version>/ (la versión está fijada por el archivo SDK_VERSION del repositorio). Es idempotente: volver a ejecutarlo no hace nada si la versión correcta ya está instalada, y la compilación normal se aborta con «OpenMV SDK not found. Run “make sdk” to install it.» si falta o es la versión incorrecta.

El SDK incluye todo lo que necesitan la compilación y el depurador, todo añadido al PATH automáticamente por el Makefile:

Componente

Propósito

Cadena de herramientas ARM GNU (arm-none-eabi-gcc 14.3)

Compilador, enlazador, arm-none-eabi-gdb para depuración

LLVM/clang

Se usa para ciertos objetos en algunos ports

CMake, GNU Make

Orquestación de la compilación de las bibliotecas de proveedores

Python (reubicable)

Scripts de compilación, utilidades mpy-cross, firma, herramientas de modelos

STM32CubeProgrammer (STM32_Programmer_CLI)

Flasheo SWD y el flujo de recuperación del STM32N6

ST Edge AI

Compilador de redes neuronales para la NPU del STM32N6

dfu-util

Flasheo USB DFU

gdbrunner

El lanzador del servidor GDB del objetivo make debug (el software Segger J-Link que controla es una instalación aparte)

Advertencia

El OpenMV N6 y el OpenMV AE3 usan núcleos Cortex-M55 y requieren GCC 14.3 o más reciente. La compilación lo exige para esos objetivos y se aborta con un error «Upgrade to GCC 14.3+ for proper CM55 support» si se encuentra un arm-none-eabi-gcc más antiguo antes que el del SDK en el PATH. La cadena de herramientas del SDK incluida ya cumple este requisito; el error significa que una cadena de herramientas diferente y más antigua lo está eclipsando.