Saltar al contenido principal

Tutorial de desarrollo de MeshCore

Requisitos previos​

Herramienta necesaria​

Antes de comenzar, prepara las siguientes herramientas:

  1. Git
  2. Python 3
  3. VS Code

Instalar PlatformIO​

Busca PlatformIO en el marketplace de Extensiones de VS Code e instálalo.

img

Después de la instalación, normalmente aparece un icono con forma de hormiga en la barra de herramientas izquierda.

img

Preparación del proyecto​

Abre una carpeta en la que quieras tener tu proyecto. Abre la carpeta en la terminal. Haz clic aquí para clonar el proyecto con git.

Abre VSCode, luego haz clic en el icono de PlatformIO y elige select a folder. Elige la carpeta en la que clonaste el proyecto.

img

PlatformIO instalará automáticamente las dependencias necesarias. Después de que la instalación se complete correctamente, podrás ver Project has been successfully updated

Desarrollo de firmware​

Tutorial de desarrollo​

Encuentra el entorno para tu placa de destino. Toma como ejemplo el T1000-E Bluetooth Companion:

Entonces PlatformIO preparará las dependencias necesarias para la placa.

Modifica tu código. Se recomienda modificar el archivo variant.h correspondiente a tu placa.

Después de completar la codificación, ejecuta el siguiente comando para compilar el código y convertirlo en un archivo UF2.

pio run -e t1000e_companion_radio_ble
pio run -e t1000e_companion_radio_ble -t create_uf2

Mantén presionado el botón del dispositivo y, a continuación, conecta rápidamente el cable de carga dos veces; el LED verde quedará encendido de forma fija. Arrastra el archivo UF2 al disco que aparece. El archivo UF2 se puede encontrar en .pio\build\t1000e_companion_radio_ble

Ejemplo​

Control de la luz de usuario​

Este ejemplo muestra cómo controlar la luz de usuario para que permanezca encendida constantemente. En /examples/companion_radio/ui-orig/UITask.cpp, añade las siguientes líneas al comienzo de userLedHandler():

#ifdef T1000_E
  // T1000-E: keep status LED continuously on.
  digitalWrite(PIN_STATUS_LED, LED_STATE_ON);
  return;
#endif

Compílalo y flashea el archivo UF2 en tu T1000-E.

(Avanzado) Envío de PR​

Gracias por considerar contribuir al proyecto MeshCore. ¿Cómo puedes contribuir? 1. Informar errores (bugs)

  • Usa el rastreador de Issues
  • Usa un título claro (por ejemplo, "Crash when calling begin() with invalid pin")
  • Describe los pasos exactos para reproducirlo
  • Incluye tu placa, versión del IDE, versión de la librería y el fragmento de código relevante
  • Adjunta un sketch de ejemplo mínimo y completo si es posible

2. Sugerir mejoras / nuevas funciones

  • Abre un issue con el prefijo [Feature request]
  • Explica el caso de uso → ¿qué problema resolvería esto?
  • Describe tu API / comportamiento ideal (los ejemplos de código son de gran ayuda) 3. Enviar cambios de código (Pull Requests)

Pequeñas correcciones​

(errores tipográficos, comentarios, ejemplos, pequeñas correcciones de bugs) → Simplemente abre un pull request — no es necesario un issue previo

Cambios mayores / nuevas funciones​

  1. Abre primero un issue para debatir la idea
  2. Obtén un visto bueno general (👍) de los mantenedores
  3. Haz un fork del repositorio desde la rama 'dev' y crea tu rama (fix/xxx, feature/yyy, docs/whatever)
  4. Realiza tus cambios
  5. Actualiza o añade ejemplos cuando sea apropiado
  6. Añade/actualiza comentarios en el código
  7. Envía el pull request

Directrices para Pull Requests​

  • Una función / corrección = un pull request (los PR pequeños son más fáciles y rápidos de revisar)
  • Usa mensajes de commit descriptivos Bueno: Fix I2C timeout handling on ESP32 Malo: update
  • Haz referencia a cualquier issue relacionado (Fixes #123, Closes #89, etc.)
  • Si cambias la API pública, actualiza README.md y library.properties
  • Las nuevas funciones deben incluir un sketch de ejemplo en examples/

Estilo de código​

Sigue el estilo C++ existente (según .clang-format)

  • Sangría de 2 espacios (sin tabs)
  • camelCase para funciones y variables
  • UpperCamelCase / PascalCase para nombres de clases
  • Constantes #define en MAYÚSCULAS
  • Mantén las líneas por debajo de ~100 caracteres cuando sea razonable (pero la coherencia con el código existente es más importante que las reglas estrictas)

Soporte técnico y debate sobre el producto​

Loading Comments...