MeshTNC

MeshTNC

MeshTNC é uma ferramenta para transportar dados LoRa de e para rádios de consumo.

• Código - github.com/datapartyjs/MeshTNC
• Lançamentos - github.com/datapartyjs/MeshTNC/releases
• Suporte - ko-fi/dataparty

Funcionalidades

• CLI serial simples embutida no firmware
• Transmitir bytes brutos (hex) via LoRa usando CLI serial
• Registro de pacotes LoRa no serial (hex)
• Sniffing de pacotes BLE
• Modo KISS-TNC

Compilando

Usando o plugin PlatformIO para Visual Studio Code

• Instale PlatformIO no Visual Studio Code.
• Clone e abra o repositório MeshTNC no Visual Studio Code.
• Veja os exemplos de aplicações que pode modificar e executar:
  • Simple Repeater

Usando a linha de comando

• Instale PlatformIO Core CLI
• Clone e abra o repositório MeshTNC no shell de sua preferência
• Encontre o nome do ambiente a partir do arquivo 'platform.ini' no diretório 'variants' para o seu dispositivo
  • ou encontre o dispositivo na saída de pio project config | grep '^env:'
• Compile o firmware individual export FIRMWARE_VERSION="localbuild" ; ./build firmware <device-environment-name>
• Encontre a imagem do firmware no diretório 'out'

Gravando

Baixe versões pré-compiladas do firmware - github.com/datapartyjs/MeshTNC/releases

Ainda não construímos uma ferramenta de gravação. Pode gravar as compilações usando o flasher meshcore, as ferramentas de gravação fornecidas pelo fabricante ou seguindo as instruções para desenvolvedores para gravar usando VS Code.

• Grave usando a ferramenta de gravação do fabricante da sua plataforma
• Use o flasher meshcore - http://flasher.meshcore.co.uk/

Compatibilidade de Hardware

MeshTNC foi projetado para dispositivos suportados pelo MeshCore, então verifique a lista de suporte deles no MeshCore Flasher. Suportamos a maioria dos mesmos hardwares, veja variants.

CLI Serial

O firmware MeshTNC inicia inicialmente em um modo serial legível por humanos. Pode conectar-se ao console serial usando um aplicativo de terminal serial. Pode ser necessário configurar a taxa de transmissão (baud rate), que por padrão é 115200. O seguinte comando usa minicom para conectar-se à porta serial, por favor substitua /dev/ttyACM0 pelo nó de dispositivo adequado para sua porta serial:

minicom -b 115200 -D /dev/ttyACM0

Pode ser útil em sistemas Linux executar o seguinte comando para definir o baud padrão ao interagir com a porta serial:

stty -F /dev/ttyACM0 115200

Uma vez conectado, o dispositivo MeshTNC possui uma CLI simples. A CLI é em grande parte semelhante à do MeshCore, com algumas adições notáveis.

Adições à CLI

• txraw <hex...> - Transmitir um pacote
• get syncword <word> - Ler a configuração da syncword
• set kiss port <port> - Definir a porta do dispositivo KISS
• set radio <freq>,<bw>,<sf>,<coding-rate>,<syncword> - Configurar o rádio
• serial mode kiss - Mudar para modo KISS
• rxlog on - ativar registro de pacotes LoRa
  • Formato de saída: [timestamp],[type=RXLOG],[rssi],[snr],[hex...]\n
• rxlog off - desativar registro de pacotes LoRa
• rxlog ble on - ativar registro de pacotes BLE
  • Formato de saída: [timestamp],[type=RXBLE],[rssi],[snr],[MAC - 6 octetos][hex...]\n
• rxlog ble off - desativar registro de pacotes BLE

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

Modo KISS

O modo KISS permite operar o rádio LoRa como um modem KISS, o que o torna compatível com muitos softwares de rádio pré-existentes, incluindo software APRS e o kernel Linux.

Ativando o Modo KISS

• Abra um console serial e conecte-se ao dispositivo MeshTNC
• serial mode kiss

Saindo do Modo KISS

• Para sair do modo KISS e retornar ao modo CLI, pode enviar uma sequência de saída KISS como: echo -ne '\xC0\xFF\xC0' > /dev/ttyUSBx
  • Para que funcione, certifique-se de que as configurações da porta serial e a taxa de transmissão estejam corretas com stty

APRS sobre LoRa

Pode usar suas ferramentas APRS favoritas com MeshTNC. Simplesmente selecione uma frequência, coloque o rádio em modo kiss e conecte-se às suas ferramentas APRS como um dispositivo KISS TNC.

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

Software APRS

MeshTNC deve funcionar com muitos clientes APRS; testamos nos seguintes:

• xastir
• APRSisce32

AX.25 sobre LoRa

Há uma grande quantidade de conhecimento e exemplos disponíveis aqui: https://linux-ax25.in-berlin.de/wiki/AX.25

Há muitas coisas interessantes que podem ser feitas diretamente sobre AX.25 sem envolver IP, mas o exemplo a seguir demonstrará como atribuir um endereço IP à interface AX.25. Isso pode ser feito em duas máquinas diferentes com dois MeshTNCs, e você deve conseguir pingar entre elas pelo ar, desde que as configurações de rádio nos MeshTNCs coincidam, os endereços IP atribuídos em cada sistema estejam na mesma sub-rede e sejam diferentes um do outro, e os indicativos (ou pelo menos os SSIDs) difiram em cada sistema. O roteamento IP também funcionará se configurado corretamente!

Início Rápido com AX.25

• Conecte o MeshTNC a um sistema Linux.
• Atribua as configurações de rádio adequadas na CLI do MeshTNC
• Entre no modo KISS na CLI do MeshTNC
  • Após entrar no modo KISS, por favor saia do seu programa de terminal para liberar a porta serial.
• No sistema Linux conectado, edite /etc/ax25/axports:
  • Adicione a seguinte linha:
    • 0 AL1CE-1 115200 220 2 AX25 test
    • Substitua AL1CE-1 pelo seu indicativo e SSID
• Conecte o MeshTNC à porta AX.25 usando: kissattach /dev/ttyACM0 0
  • Após executar este comando, verifique qual interface ele criou: sudo dmesg | grep mkiss
    • [88447.885556] mkiss: ax0: crc mode is auto.
• Pode atribuir um endereço IP executando: ip addr add 10.10.10.10/24 dev ax0

Ethernet sobre LoRa

Execute o seguinte em dois ou mais computadores, cada um com um dispositivo MeshTNC conectado, para criar uma rede Ethernet sobre LoRa.

• Instale tncattach
  • git clone https://github.com/markqvist/tncattach.git
  • cd tncattach
  • make
  • sudo make install
• minicom -D /dev/ttyACM0
  • set radio 916.75,500.0,5,5,0x16
  • serial mode kiss

Na primeira máquina

• sudo tncattach --mtu=230 -e -noipv6 --ipv4=10.10.10.10/24 /dev/ttyACM0 115200

Na segunda máquina

• sudo tncattach --mtu=230 -e -noipv6 --ipv4=10.10.10.11/24 /dev/ttyACM0 115200