MeshCore

Acerca de MeshCore

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

🔍 ¿Qué es MeshCore?

MeshCore ahora compatible con una variedad de dispositivos LoRa, permitiendo flasheo sencillo sin necesidad de compilar 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 proporciona la capacidad de crear redes mesh inalámbricas, similares a Meshtastic y Reticulum, pero con un enfoque en el enrutamiento de paquetes multi-salto ligero para proyectos embebidos. A diferencia de Meshtastic, que está diseñado para comunicación LoRa casual, o Reticulum, que ofrece redes avanzadas, MeshCore equilibra simplicidad con escalabilidad, lo que lo hace ideal para soluciones embebidas personalizadas, donde los dispositivos (nodos) pueden comunicarse a larga distancia 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 Multi-Salto
  • Los dispositivos pueden reenviar mensajes a través de múltiples nodos, extendiendo el alcance más allá del alcance de una sola radio.
  • Soporta 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 "Compañero" no retransmiten mensajes para evitar que se utilicen rutas adversas.
• Soporta 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 auto-repara.
• Bajo Consumo de Energía – Ideal para dispositivos alimentados por batería o energía solar.
• Sencillo de Desplegar – Aplicaciones de ejemplo preconstruidas facilitan comenzar.

🎯 ¿Para Qué Puedes Usar MeshCore?

• Comunicación Fuera de la Red: Mantente conectado incluso en áreas remotas.
• Respuesta a Emergencias y Recuperación de Desastres: Configura redes instantáneas donde la infraestructura ha fallado.
• Actividades al Aire Libre: Comunicación para senderismo, campamento y carreras de aventura.
• Aplicaciones Tácticas y de Seguridad: Casos de uso militar, policial y de seguridad privada.
• Redes IoT y de Sensores: Recopila datos de sensores remotos y transmítelos a una ubicación central.

🚀 Cómo Empezar

• Mira la Lista de Reproducción de Inicio Rápido de MeshCore de The Comms Channel
• Mira la Presentación Técnica de MeshCore de Liam Cottle.
• Lee nuestras Preguntas Frecuentes y 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.
• Ve las aplicaciones de ejemplo que puedes modificar y ejecutar:
  • Companion Radio - Para usar con una aplicación de chat externa, a través de BLE, USB o Wi-Fi.
  • KISS Modem - Puente de protocolo KISS serie para aplicaciones host. (docs del protocolo)
  • Simple Repeater - Extiende la cobertura de la red retransmitiendo mensajes.
  • Simple Room Server - Un servidor BBS simple para publicaciones compartidas.
  • Simple Secure Chat - Comunicación de texto segura basada en terminal entre dispositivos.
  • Simple Sensor - Nodo sensor remoto con telemetría y alertas.

El ejemplo de Simple Secure Chat se puede usar a través del Monitor Serie en Visual Studio Code, o con un terminal USB Serie en Android.

⚡️ Flasher de MeshCore

Tenemos firmware precompilado listo para flashear en dispositivos compatibles.

• Lanza 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 a continuación.

📱 Clientes de MeshCore

Firmware Companion

El firmware companion se puede conectar mediante 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 pueden configurar mediante USB en la herramienta de configuración web.

• https://config.meshcore.io

También se pueden gestionar mediante LoRa en la aplicación móvil usando la función de Gestión Remota.

🛠 Compatibilidad de Hardware

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

📜 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

¡Por favor, envía PRs usando 'dev' como rama base! Para cambios menores, envía tu PR e intentaremos revisarlo, pero para cualquier cosa más 'impactante', abre primero un Issue e inicia una discusión. Es mejor exponer lo que deseas lograr primero y tratar de llegar a un consenso sobre el mejor enfoque, especialmente cuando afecta la estructura o arquitectura de este código base.

Aquí hay algunos principios generales que debes tratar de seguir:

• Mantenlo simple. Por favor, no pienses como un programador de lenguaje de alto nivel. Piensa en sistemas embebidos y mantén el código conciso, sin capas innecesarias.
• Sin asignación dinámica de memoria, excepto durante las funciones setup/begin.
• Usa el mismo estilo de llaves e indentación que en los módulos fuente principales. (Probablemente se añadirá pronto un .clang-format, 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 arriba a los issues/PRs que más te importen. Miramos el recuento 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 / Tareas Pendientes

Hay varias características importantes en preparación, sin plazos concretos aún. En orden cronológico aproximado:

• Radio Companion: rediseño de la interfaz de usuario
• Repeater + Room Server: añadir ACLs (como el Nodo Sensor)
• Estandarizar el modo Bridge para repetidores
• Repeater/Bridge: Estandarizar los Códigos de Transporte para zonificación/filtrado
• Core + Repeater: descubrimiento de vecinos de cero saltos mejorado
• Core: soporte de ruta manual de ida y vuelta
• Companion + Apps: soporte para múltiples sub-mallas (y modo de repetición de cliente 'fuera de la red')
• Core + Apps: soporte para compresión de mensajes LZW
• Core: CR (Coding Rate) dinámico para saltos débiles frente a fuertes
• Core: nuevo marco para alojar múltiples nodos virtuales en un dispositivo físico
• Especificación del protocolo V2: discusión y consenso sobre el protocolo de paquetes V2, incluyendo hashes de ruta, nuevas especificaciones de cifrado, etc.

📞 Obtener Soporte

• Reporta errores y solicita funciones en la página de GitHub Issues.
• Encuentra guías y componentes adicionales en mi sitio.
• Únete al Discord de MeshCore para chatear con los desarrolladores y obtener ayuda de la comunidad.