MeshTNC

MeshTNC

MeshTNC es una herramienta para canalizar datos LoRa hacia y desde radios de grado de consumo.

• Código - github.com/datapartyjs/MeshTNC
• Lanzamientos - github.com/datapartyjs/MeshTNC/releases
• Soporte - ko-fi/dataparty

Características

• CLI serie simple integrada en el firmware
• Transmitir bytes sin procesar (hex) sobre LoRa usando la CLI serie
• Registro de paquetes LoRa en serie (hex)
• Detección de paquetes BLE
• Modo KISS-TNC

Compilación

Usando el plugin PlatformIO para Visual Studio Code

• Instala PlatformIO en Visual Studio Code.
• Clona y abre el repositorio MeshTNC en Visual Studio Code.
• Consulta las aplicaciones de ejemplo que puedes modificar y ejecutar:
  • Simple Repeater

Usando la línea de comandos

• Instala PlatformIO Core CLI
• Clona y abre el repositorio MeshTNC en el shell de tu elección
• Encuentra el nombre del entorno del archivo 'platform.ini' en el directorio 'variants' de tu dispositivo
  • o encuentra el dispositivo en la salida de pio project config | grep '^env:'
• Compila el firmware individual: export FIRMWARE_VERSION="localbuild" ; ./build firmware <device-environment-name>
• Encuentra la imagen del firmware en el directorio 'out'

Flasheo

Descarga los lanzamientos de firmware precompilados - github.com/datapartyjs/MeshTNC/releases

Todavía no hemos creado una herramienta de flasheo. Puedes flashear compilaciones usando el flasher de meshcore, las herramientas de flasheo proporcionadas por el fabricante o siguiendo las instrucciones para desarrolladores para flashear usando VS Code.

• Flashea usando la herramienta de flasheo de tu plataforma
• Usa el flasher de meshcore - http://flasher.meshcore.co.uk/

Compatibilidad de Hardware

MeshTNC está diseñado para dispositivos compatibles con MeshCore, así que consulta su lista de soporte en MeshCore Flasher. Soporte la mayoría del mismo hardware, consulta variants.

CLI Serie

El firmware de MeshTNC se inicia inicialmente en un modo serie legible para humanos. Puedes conectarte a la consola serie usando una aplicación de terminal serie. Puede que tengas que configurar la velocidad en baudios, que por defecto es 115200. El siguiente comando usa minicom para conectarse al puerto serie, por favor reemplaza /dev/ttyACM0 con el nodo de dispositivo adecuado para tu puerto serie:

minicom -b 115200 -D /dev/ttyACM0

Puede ser útil en sistemas Linux ejecutar el siguiente comando para establecer el baud predeterminado al interactuar con el puerto serie:

stty -F /dev/ttyACM0 115200

Una vez conectado, el dispositivo MeshTNC tiene una CLI simple. La CLI es muy similar a MeshCore con algunas adiciones notables.

Adiciones a la CLI

• txraw <hex...> - Transmitir un paquete
• get syncword <word> - Leer la configuración de syncword
• set kiss port <port> - Establecer el puerto del dispositivo KISS
• set radio <freq>,<bw>,<sf>,<coding-rate>,<syncword> - Configurar la radio
• serial mode kiss - Cambiar al modo KISS
• rxlog on - habilitar el registro de paquetes LoRa
  • Formato de salida: [timestamp],[type=RXLOG],[rssi],[snr],[hex...]\n
• rxlog off - deshabilitar el registro de paquetes LoRa
• rxlog ble on - habilitar el registro de paquetes BLE
  • Formato de salida: [timestamp],[type=RXBLE],[rssi],[snr],[MAC - 6 octets][hex...]\n
• rxlog ble off - deshabilitar el registro de paquetes BLE
• get ble - volcar la configuración BLE
• set ble <active_scan>,<filter_dups>,<max_results>,<scantime>
  • active_scan - on / off - Si usar escaneo activo. Por defecto off
  • filter_dups - on / off - Si filtrar duplicados. Por defecto on
  • max_results - Número máximo de resultados por escaneo
  • scantime - Número de milisegundos para escanear
• set/get txpower - El set/get tx de MeshCore ha sido renombrado apropiadamente

Comandos existentes

• reboot
• clock sync
• start ota
• clock
• time
• tempradio
• clear stats
• get af
• get agc.reset.interval
• get name
• get lat
• get lon
• get radio
• get rxdelay
• get txdelay
• get freq
• set af
• set int.thresh
• set agc.reset.interval
• set name
• set radio
• set lat
• set lon
• set rxdelay
• set txdelay
• set freq
• erase
• ver
• log start
• log stop
• rxlog on
• rxlog off

Modo KISS

El modo KISS permite operar la radio LoRa como un módem KISS, lo que la hace compatible con muchos programas de radio existentes, incluyendo software APRS y el kernel de Linux.

Habilitar el modo KISS

• Abre una consola serie y conéctate al dispositivo MeshTNC
• serial mode kiss

Salir del modo KISS

• Para salir del modo KISS y volver al modo CLI, puedes enviar una secuencia de salida KISS así: echo -ne '\xC0\xFF\xC0' > /dev/ttyUSBx
  • Para que esto funcione, asegúrate de que la configuración de tu puerto serie y la velocidad en baudios estén configuradas correctamente con stty

APRS sobre LoRa

Puedes usar tus herramientas APRS favoritas con MeshTNC. Simplemente selecciona una frecuencia, pon la radio en modo kiss y conéctate a tus herramientas APRS como un dispositivo KISS TNC.

• minicom -D /dev/ttyACM0
  • set radio 918.25,500.0,7,5,0x16
  • serial mode kiss

Software APRS

MeshTNC debería funcionar con muchos clientes APRS, hemos probado en los siguientes:

• xastir
• APRSisce32

AX.25 sobre LoRa

Hay una gran cantidad de conocimiento y ejemplos disponibles aquí: https://linux-ax25.in-berlin.de/wiki/AX.25

Hay muchas cosas muy interesantes que se pueden hacer directamente sobre AX.25 sin involucrar IP, pero el siguiente ejemplo demostrará cómo asignar una dirección IP a la interfaz AX.25. Esto se puede hacer en dos máquinas diferentes con dos MeshTNC, y deberías poder hacer ping entre ellas por el aire, siempre que las configuraciones de radio en los MeshTNC coincidan, las direcciones IP asignadas en cada sistema estén en la misma subred y sean diferentes entre sí, y los indicativos (o al menos los SSID) difieran en cada sistema. ¡El enrutamiento IP también funcionará si se configura correctamente!

Inicio rápido de AX.25