Saltar al contenido principal

Programación del MAG-BOARD

El MAG-BOARD se entrega con un firmware de gradiometría precargado.

Si utiliza el firmware estándar de FG Sensors y no necesita modificar el código, puede omitir esta sección. Si desea personalizar el software, puede programar el MAG-BOARD usando Arduino IDE y el código de código abierto proporcionado por FG Sensors.

nota

El programa de gradiometría de código abierto disponible en el sitio web no admite la conexión con la aplicación Android FG Sensors App.

Requisitos​

Antes de programar el MAG-BOARD, prepare lo siguiente:

  • Cable MicroUSB
  • Arduino IDE
  • Paquete de soporte de placas ESP32
  • Bibliotecas de Arduino requeridas

Paso 1 — Instalar Arduino IDE​

Descargue e instale Arduino IDE desde el sitio web oficial de Arduino.

Tras la instalación, abra Arduino IDE y prepárelo para el soporte de ESP32.

Paso 2 — Agregar la URL del Administrador de Placas ESP32​

El MAG-BOARD utiliza un controlador basado en ESP32, por lo que debe instalar el soporte de placas ESP32 en Arduino IDE.

  1. Abra Archivo → Preferencias
  2. Localice el campo URLs adicionales del Administrador de Placas
  3. Añada la siguiente URL:
https://dl.espressif.com/dl/package_esp32_index.json

Esto permite a Arduino IDE descargar e instalar las definiciones de placas ESP32.

Arduino IDE ESP32 Board Manager URL

Paso 3 — Instalar el Paquete de Placas ESP32​

  1. Abra Herramientas → Placa → Administrador de Placas
  2. Busque: esp32
  3. Instale el paquete de placas ESP32

Tras la instalación, los objetivos ESP32 requeridos estarán disponibles en Arduino IDE.

Instalación del paquete de placas ESP32 en Arduino IDE
Instalación del paquete de placas ESP32 en Arduino IDE - Paso 2

Paso 4 — Seleccionar la Placa​

  1. Abra Herramientas → Placa
  2. Seleccione: ESP32 Dev Module
Selección de ESP32 Dev Module en Arduino IDE

Paso 5 — Seleccionar el Puerto Serie​

Conecte el MAG-BOARD a su computadora usando el cable MicroUSB y luego:

  1. Abra Herramientas → Puerto
  2. Seleccione el puerto COM correspondiente al MAG-BOARD conectado

El nombre del puerto puede variar según el sistema operativo (p. ej., COM4 en Windows, /dev/ttyUSB0 en Linux).

Selección del puerto serie en Arduino IDE

Paso 6 — Instalar las Bibliotecas Requeridas​

Abra Programa → Incluir Biblioteca → Administrar Bibliotecas e instale lo siguiente:

Administrador de Bibliotecas en Arduino IDE

Biblioteca LCD​

Busque: liquidcrystal_pcf8574 e instálela.

Instalación de la biblioteca LiquidCrystal PCF8574 en Arduino IDE

Biblioteca del Zumbador​

Busque: easybuzzer e instálela.

Instalación de la biblioteca EasyBuzzer en Arduino IDE

Paso 7 — Cargar el Firmware​

  1. Abra el código fuente del gradiometro de FG Sensors en Arduino IDE
  2. Verifique que el proyecto se compila correctamente
  3. Haga clic en el botón Cargar

Arduino IDE compilará el firmware y lo transferirá al MAG-BOARD.

Flujo de Trabajo de Programación Típico​

Instalar Arduino IDE
→ Agregar URL de placas ESP32
→ Instalar paquete ESP32
→ Seleccionar ESP32 Dev Module
→ Seleccionar puerto COM
→ Instalar bibliotecas requeridas
→ Abrir código fuente
→ Cargar firmware

Notas​

  • El MAG-BOARD ya incluye un programa de gradiometría precargado
  • La programación solo es necesaria si desea modificar o reemplazar el firmware
  • La versión de código abierto no admite la aplicación Android de FG Sensors

Solución de Problemas​

Placa no detectada

  • compruebe el cable MicroUSB
  • reconecte la placa
  • verifique que el puerto COM correcto esté seleccionado

La carga falla

  • confirme que ESP32 Dev Module esté seleccionado
  • verifique que el paquete ESP32 esté instalado correctamente
  • compruebe que el puerto serie correcto esté elegido

Las funciones de LCD o zumbador no funcionan

  • confirme que ambas bibliotecas estén instaladas:
    • liquidcrystal_pcf8574
    • easybuzzer

Siguiente Paso​

Si no desea compilar el firmware desde el código fuente, continúe con:

Instalación del Firmware

Este método utiliza la imagen de firmware precompilada y una herramienta de flasheo en lugar de Arduino IDE.