Configuracion de MeshCore CLI
Administra tus nodos MeshCore con la herramienta oficial MeshCore-cli. Control preciso para usuarios avanzados y automatizacion.
Que es el MeshCore CLI?
La interfaz de linea de comandos de MeshCore (MeshCore-cli) es una herramienta basada en Python que permite comunicacion por terminal con tu radio companion MeshCore. El CLI soporta conexiones por Bluetooth Low Energy (BLE), TCP/IP o serial.
Ademas, repetidores y room servers tienen su propio CLI integrado accesible por USB serial o de forma remota. Esto permite configurar directamente en el dispositivo la frecuencia, potencia de transmision, nombre y otros ajustes.
Esta guia cubre ambos enfoques: la herramienta Python MeshCore-cli para radios companion y el CLI serial para repetidores y room servers. Lectura esencial para administradores de sistemas, power users y cualquiera interesado en scripting o automatizacion.
Por que usar el CLI?
Velocidad y Eficiencia
Configura nodos en segundos con unos pocos comandos, mucho mas rapido que navegar interfaces graficas.
Automatizacion con Scripts
Escribe scripts en bash o Python para ejecutar operaciones en lote en multiples nodos al mismo tiempo.
Control Completo
Accede a todos los ajustes, incluyendo parametros avanzados de radio y configuracion de repetidor.
Multiples Conexiones
Conecta por Bluetooth, WiFi/TCP o serial. Elige lo que mejor se adapte a tu setup.
Administracion Remota
Administra repetidores de forma remota usando la funcion de admin remoto desde el CLI o la app movil.
Modo Chat Interactivo
El CLI incluye un modo interactivo con autocompletado con Tab, historial de comandos y mensajeria en tiempo real.
Instalacion de MeshCore CLI
La herramienta MeshCore-cli se instala como un paquete de Python via pip o pipx. Funciona en Windows, macOS, Linux y Raspberry Pi. Requiere Python 3.10 o mas reciente.
Paso 1: Verifica la Version de Python
Se requiere Python 3.10 o mas reciente. Revisa tu version:
python3 --version
Si no tienes Python, descargalo desde python.org
Paso 2: Instala MeshCore-cli
Instala la herramienta oficial MeshCore CLI via pipx (recomendado) o pip:
# Via pipx (recommended)pipx install meshcore-cli# Or via pippip3 install meshcore-cliPaso 3: Verifica la Instalacion
Confirma que se instalo correctamente abriendo la ayuda:
meshcli -h
Comandos Basicos del CLI
MeshCore-cli soporta parametros de linea de comandos y un modo chat interactivo. Ejecuta sin argumentos para entrar al modo interactivo.
Seleccionar Dispositivo (BLE)
Escanea y selecciona tu dispositivo MeshCore por Bluetooth. El CLI recuerda tu seleccion para sesiones posteriores.
meshcli -S
Conectar por TCP/IP
Conecta a un nodo MeshCore por WiFi/red si el servidor TCP esta activo.
meshcli -t 192.168.1.100
Conectar por Serial
Conecta por puerto USB serial para comunicacion directa con tu nodo.
meshcli -s /dev/ttyUSB0
Enviar Mensaje
Envia un mensaje de texto a un contacto especifico o haz broadcast para todos.
meshcli send "Hello MeshCore network!"
Ver Contactos
Ve todos los nodos conocidos en tu red con su estado y potencia de senal.
meshcli contacts
Modo Interactivo
Inicia sin comandos para el modo chat interactivo con autocompletado con Tab e historial.
meshcli
CLI de Repeater y Room Server
Los repeaters y room servers tienen un CLI integrado accesible por USB serial (terminal/PuTTY) o via el T-Deck CLI. Despues de flashear, los ajustes basicos se configuran aqui.
Configurar Frecuencia (Requerido)
En EE.UU.: compra equipos 915 MHz y configura 915 MHz. En la UE: compra equipos 868 MHz y configura 868 MHz.
set freq 869.4rebootNombre y Ubicacion
Asigna a tu repeater un nombre reconocible y, si quieres, coordenadas GPS para mostrarlo en el mapa.
set name MijnRepeaterset lat 52.3676set lon 4.9041Configurar Potencia de Transmision
Ajusta la potencia de transmision en dBm. Respeta limites del hardware y la normativa local. Empieza con valores moderados y sube solo si de verdad hay huecos de cobertura.
set tx 22
Ajustes del Repeater
Configura opciones especificas del repeater como hop limits e intervalos de anuncio.
set flood.max 3set advert.interval 30set flood.advert.interval 3Configuracion Basada en Web
Ademas del CLI, los repeaters y room servers tambien pueden configurarse con herramientas web. Esto suele ser mas simple para principiantes.
MeshCore webflasher
Flashea firmware y configura directamente en el navegador en meshcore.io/flasher. Haz click en "Console" despues de flashear para acceder al CLI.
meshcore.io/flasher →MeshCore Config Tool
Configura repeaters existentes via config.MeshCore.dev - conecta por USB y ajusta opciones en el navegador.
config.meshcore.dev →Configuracion Minima Despues de Flashear
Despues de flashear el firmware MeshCore, estos pasos son lo minimo requerido:
# 1. Configura la frecuencia
# En EE.UU.: compra equipos 915 MHz y configura 915 MHz. En la UE: compra equipos 868 MHz y configura 868 MHz.
set freq {MHz}
# 2. Reinicia para aplicar cambios
reboot
# 3. Opcional: asigna un nombre a tu repeater
set name Colorado-Repeater
# 4. Opcional: configura ubicacion para el mapa
set lat 39.7392
set lon -104.9903Preguntas Frecuentes sobre el CLI
Que diferencia a MeshCore-cli del CLI serial?
El MeshCore-cli (meshcli) es una herramienta Python que se comunica con tu radio companion por BLE, TCP o serial. El CLI serial esta integrado en repeaters y room servers, y se accede directamente por USB/terminal. Cada uno tiene comandos y casos de uso distintos.
Como me conecto por Bluetooth?
En Linux, primero empareja tu dispositivo con bluetoothctl. Luego usa meshcli -S para seleccionar tu dispositivo. El CLI recuerda tu eleccion en ~/.config/MeshCore.
Puedo configurar repeaters de forma remota?
Si! Con la funcion Remote Admin puedes administrar repeaters y room servers por LoRa. Esto funciona desde MeshCore-cli con comandos repeater, o desde la app movil con Remote Management.
Que frecuencia debo usar en America?
En EE.UU.: compra equipos 915 MHz y configura 915 MHz. En la UE: compra equipos 868 MHz y configura 868 MHz.
Como restablezco mi repeater a valores de fabrica?
En el CLI serial puedes usar erase para borrar el sistema de archivos. Esto elimina todos los ajustes. Luego tendras que configurar la frecuencia de nuevo.
Donde encuentro todos los comandos disponibles?
Para MeshCore-cli: meshcli -h muestra todas las opciones. Para el CLI de repeater/room server: help en la consola serial. La referencia completa esta disponible en el wiki de MeshCore en GitHub.
Domina la Linea de Comandos
Con el MeshCore CLI obtienes control profesional sobre tu red mallada. Ideal para administracion de repeaters, scripting y configuracion avanzada.