MeshCore

Acerca de MeshCore

MeshCore es una biblioteca C++ ligera y portátil que permite el enrutamiento de paquetes multisalto para proyectos embebidos que utilizan LoRa y otras radios de paquetes. Está diseñada para desarrolladores que desean crear redes de comunicación resilientes y descentralizadas que funcionen sin internet.

🔍 ¿Qué es MeshCore?

MeshCore ahora es compatible con una variedad de dispositivos LoRa, lo que permite flashearlos fácilmente sin necesidad de compilar el firmware manualmente. Los usuarios pueden flashear un binario precompilado usando herramientas como Adafruit ESPTool e interactuar con la red a través de una consola serie. MeshCore ofrece la capacidad de crear redes de malla inalámbricas, similares a Meshtastic y Reticulum, pero con un enfoque en el enrutamiento de paquetes multisalto ligero para proyectos embebidos. A diferencia de Meshtastic, que está orientado a la comunicación LoRa casual, o Reticulum, que ofrece redes avanzadas, MeshCore equilibra la simplicidad con la escalabilidad, lo que lo hace ideal para soluciones embebidas personalizadas, donde los dispositivos (nodos) pueden comunicarse a largas distancias retransmitiendo mensajes a través de nodos intermedios. Esto es especialmente útil en situaciones fuera de la red, de emergencia o tácticas donde la infraestructura de comunicación tradicional no está disponible.

⚡ Características clave

• Enrutamiento de paquetes multisalto
  • Los dispositivos pueden reenviar mensajes a través de múltiples nodos, extendiendo el alcance más allá del de una sola radio.
  • Admite hasta un número configurable de saltos para equilibrar la eficiencia de la red y evitar tráfico excesivo.
  • Los nodos utilizan roles fijos, donde los nodos "Companion" no repiten mensajes en absoluto para evitar que se utilicen rutas de enrutamiento adversas.
• Compatible con radios LoRa – Funciona con Heltec, RAK Wireless y otro hardware basado en LoRa.
• Descentralizado y resiliente – No requiere servidor central ni internet; la red se autorrepara.
• Bajo consumo de energía – Ideal para dispositivos alimentados por batería o energía solar.
• Fácil de desplegar – Las aplicaciones de ejemplo precompiladas facilitan el inicio.

🎯 ¿Para qué puedes usar MeshCore?

• Comunicación fuera de la red: Mantente conectado incluso en áreas remotas.
• Respuesta a emergencias y recuperación ante desastres: Configura redes instantáneas donde la infraestructura está caída.
• Actividades al aire libre: Comunicación para senderismo, camping y carreras de aventura.
• Aplicaciones tácticas y de seguridad: Casos de uso militar, policial y de seguridad privada.
• IoT y redes de sensores: Recopila datos de sensores remotos y retransmítelos a una ubicación central.

🚀 Cómo empezar

• Mira la lista de reproducción MeshCore QuickStart de The Comms Channel
• Mira la presentación técnica de MeshCore de Liam Cottle.
• Lee nuestras Preguntas frecuentes y la Documentación.
• Flashea el firmware de MeshCore en un dispositivo compatible.
• Conéctate con un cliente compatible.

Para desarrolladores:

• Instala PlatformIO en Visual Studio Code.
• Clona y abre el repositorio de MeshCore en Visual Studio Code.
• Consulta las aplicaciones de ejemplo que puedes modificar y ejecutar:
  • Companion Radio - Para usar con una aplicación de chat externa, por BLE, USB o Wi-Fi.
  • KISS Modem - Puente de protocolo KISS serie para aplicaciones host. (documentación del protocolo)
  • Simple Repeater - Amplía la cobertura de la red retransmitiendo mensajes.
  • Simple Room Server - Un servidor BBS simple para Posts compartidos.
  • Simple Secure Chat - Comunicación de texto segura basada en terminal entre dispositivos.
  • Simple Sensor - Nodo de sensor remoto con telemetría y alertas.

Se puede interactuar con el ejemplo Simple Secure Chat a través del Monitor Serie en Visual Studio Code, o con un Serial USB Terminal en Android.

⚡️ MeshCore Flasher

Tenemos firmware precompilado listo para flashear en dispositivos compatibles.

• Abre https://meshcore.io/flasher
• Selecciona un dispositivo compatible
• Flashea uno de los tipos de firmware:
  • Companion, Repeater o Room Server
• Una vez completado el flasheo, puedes conectarte con uno de los clientes de MeshCore que se indican a continuación.

📱 Clientes de MeshCore

Firmware Companion

Se puede conectar al firmware companion por BLE, USB o Wi-Fi según el tipo de firmware que hayas flasheado.

• Web: https://app.meshcore.nz
• Android: https://play.google.com/store/apps/details?id=com.liamcottle.meshcore.android
• iOS: https://apps.apple.com/us/app/meshcore/id6742354151?platform=iphone
• NodeJS: https://github.com/liamcottle/meshcore.js
• Python: https://github.com/fdlamotte/meshcore-cli

Firmware Repeater y Room Server

El firmware repeater y room server se puede configurar por USB en la herramienta de configuración web.

• https://config.meshcore.io

También se pueden gestionar por LoRa en la aplicación móvil usando la función Remote Management.

🛠 Compatibilidad de hardware

MeshCore está diseñado para los dispositivos listados en el MeshCore Flasher

📜 Licencia

MeshCore es software de código abierto publicado bajo la Licencia MIT. Eres libre de usarlo, modificarlo y distribuirlo para proyectos personales y comerciales.

Contribuir

¡Envía tus PR usando 'dev' como rama base! Para cambios menores, simplemente envía tu PR y trataremos de revisarlo, pero para cualquier cosa más "impactante", abre primero un Issue e inicia una discusión. Es mejor tantear lo que quieres lograr primero e intentar llegar a un consenso sobre cuál es el mejor enfoque, especialmente cuando impacta la estructura o arquitectura de este código base.

Aquí hay algunos principios generales que deberías intentar seguir:

• Mantenlo simple. Por favor, no pienses como un programador de lenguajes de alto nivel. Piensa en embebido y mantén el código conciso, sin capas innecesarias.
• Sin asignación dinámica de memoria, excepto durante las funciones de setup/begin.
• Usa el mismo estilo de llaves e indentación que hay en los módulos fuente principales. (Probablemente se añadirá un .clang-format pronto, pero por favor NO reformatees retroactivamente el código existente. Esto solo crea diffs innecesarios que dificultan encontrar problemas)

¡Ayúdanos a priorizar! Por favor, reacciona con pulgar hacia arriba a los issues/PRs que más te importen. Revisamos los recuentos de reacciones al planificar el trabajo.

Ejecutar pruebas unitarias

Para ejecutar las pruebas unitarias, ejecuta el siguiente comando:

pio test --environment native --verbose

Hoja de ruta / Pendientes