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 hacer git clone del proyecto.

Abre VSCode, luego haz clic en el icono de PlatformIO, 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 objetivo. Toma como ejemplo el T1000-E Bluetooth Companion:

Entonces PlatformIO preparará las dependencias necesarias para la placa.

Cambia tu código. Se recomienda cambiar el archivo variant.h para 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 luego 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 luz de usuario​

Este ejemplo muestra cómo controlar la luz de usuario para que permanezca encendida constantemente. Copia el siguiente código en /examples/companion_radio/ui-new/ui-orig/UITask.cpp

void UITask::userLedHandler() {
#ifdef PIN_STATUS_LED
#ifdef T1000_E
  // T1000-E: keep status LED continuously on.
  digitalWrite(PIN_STATUS_LED, LED_STATE_ON);
  return;
#endif
  static int state = 0;
  static int next_change = 0;
  static int last_increment = 0;

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 muy útiles) 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 más grandes / nuevas funciones​

  1. Abre primero un issue para discutir la idea
  2. Obtén un visto bueno general del/de los mantenedor(es)
  3. Haz 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

Guías 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​

Por favor, sigue el estilo C++ existente (según el .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 < ~100 caracteres cuando sea razonable (pero la consistencia con el código existente es más importante que las reglas estrictas)

Soporte técnico y discusión de producto​

Loading Comments...