Neste artigo:

Este guia fornece instruções abrangentes sobre como configurar, configurar e se comunicar com o Modem de Comando AT. Cobre conexão de hardware, configurações de comunicação serial, o protocolo de comando AT e etapas comuns de solução de problemas.

Conexão de Hardware

Para conectar ao seu HyperPulse DK, você precisará conectá-lo a um computador com um cabo USB-C. Não é necessário ter a bateria conectada.

Para se comunicar com o satélite, é necessária uma linha de visão clara, sem obstruções, conforme descrito no Guia Rápido do Kit de Desenvolvimento.

Para acessar a porta USB-C do seu HyperPulse DK, será necessário abrir sua carcaça. Recomenda-se uma chave Phillips #1 (os tamanhos #0-#2 também são adequados) para abrir a carcaça.

Um laptop ou computador desktop rodando Windows, Linux ou macOS, com uma porta USB-C capaz de fornecer pelo menos 500 mA de corrente (recomenda-se USB 3.0 ou superior).

Um cabo USB-C está incluído para interface com o HyperPulse DK para configuração, depuração e programação do dispositivo.

Depois de acessar a porta USB-C do seu HyperPulse DK, conecte-a ao seu computador e continue para as próximas etapas.

Carregando o Exemplo do Modem AT

O exemplo do Modem AT e os arquivos de Informação de Rede podem ser baixados na seção Download Binaries no Myriota Device Manager.

Você pode programar o firmware de exemplo usando probe-rs, que é uma ferramenta de programação e depuração baseada em Rust.

Instalando o probe-rs

Instale o probe-rs se ainda não estiver instalado.

Para Windows, execute o seguinte comando no PowerShell:

irm https://github.com/probe-rs/probe-rs/releases/latest/download/probe-rs-tools-installer.ps1 | iex

Para Linux ou macOS, execute o seguinte comando em um terminal:

curl -LsSf https://github.com/probe-rs/probe-rs/releases/latest/download/probe-rs-tools-installer.sh | sh

Após a instalação, confirme que o Kit de Desenvolvimento foi detectado:

probe-rs list

Nota: No Linux, regras udev podem ser necessárias antes que o dispositivo possa ser acessado sem sudo.

Programando a Aplicação do Modem AT

Programe a aplicação do Modem AT com o seguinte comando:

probe-rs download --chip nRF9151_xxAA --binary-format hex at_modem_myriota_hyperpulse_dk-[VERSION].hex

Nota: Substitua at_modem_myriota_hyperpulse_dk-[VERSION].hex pelo nome real do arquivo.

Programando a Informação de Rede

Programe o arquivo de Informação de Rede, que contém a configuração de agendamento do satélite:

probe-rs download --chip nRF9151_xxAA --binary-format hex HyperPulseNetworkConfig.hex

Nota: Substitua HyperPulseNetworkConfig.hex pelo caminho e nome reais do arquivo.

Resetando o Dispositivo

Após a programação, reinicie o dispositivo pressionando o botão de reset na placa, ou execute o seguinte comando para iniciar com os novos arquivos:

probe-rs reset --chip nRF9151_xxAA

Configuração das Portas Seriais

Importante: Existem 2 portas seriais envolvidas neste exemplo:

• A criada pela conexão USB-C: interface AT para envio/recebimento de comandos/mensagens e respostas.
• A disponível no conector fêmea da placa: envia logs no pino TX. Os níveis são TTL, portanto você precisará de um adaptador para isso.

Ambas as portas possuem a seguinte configuração:

• Taxa de transmissão (Baudrate): 115200
• Bits de dados: 8
• Bits de parada: 1
• Paridade: Nenhuma
• Controle de fluxo: Nenhum

Você precisará de um aplicativo de terminal serial (por exemplo, PuTTY, minicom, Tera Term) tanto para enviar/receber dados/comandos quanto para observar os logs.

Para melhorar a visualização dos comandos enviados e recebidos do dispositivo, habilite a opção "eco local" e configure a recepção de nova linha para "auto". Por exemplo, no Tera Term, você pode encontrar as configurações no menu Setup - Terminal:

Nova linha e eco local:

Taxa de transmissão (Baudrate):

Sequência para envio e recebimento de uma mensagem

Após conectar ambos os cabos USB-C, a unidade começará imediatamente a transmitir logs no pino TX do conector. Para capturar os logs desde a inicialização, certifique-se de que seu terminal serial esteja aberto e pronto antes de conectar os cabos USB-C.

No terminal serial conectado ao pino TX do conector via adaptador, você deverá ver uma saída semelhante ao exemplo abaixo. Espere até que a fixação GNSS esteja completa antes de prosseguir.

Agora, voltando ao terminal AT (não o de logs), envie o seguinte comando para habilitar a recepção de downlinks:

AT#MRECV=1

Para agendar uma mensagem uplink para iniciar a conexão/sessão, use este comando, passando como argumento uma string codificada em hexadecimal. Aqui um exemplo enviando 5 bytes:

AT#MSEND=5,"0102030405"

Espere até que esta mensagem uplink seja recebida no Device Manager. Se você agendar um downlink antes da 1ª conexão do dispositivo após o reset, ele será perdido.

Agora agende um downlink no Device Manager:

Até o momento, as mensagens downlink só serão enviadas se o dispositivo agendar uma mensagem uplink. Não será necessário agendar mensagens uplink para receber downlinks nas próximas versões da biblioteca e do firmware de exemplo.

Agora agende outra mensagem uplink no dispositivo:

AT#MSEND=5,"0102030405"

Agora aguarde o próximo tempo de revisita (máximo de 1 hora), então o pacote será enviado, e o agendado no Device Manager será recebido.

Aqui está um exemplo da sequência completa:

Você pode agora ver a mensagem no Device Manager:

Resumo básico dos comandos AT

Para um guia de uso abrangente e lista de comandos AT, consulte o Manual de Referência de Comandos AT HyperPulse™.

Verificação de comunicação

• Enviado: AT\r
• Recebido: OK\r

Agendar uma mensagem uplink

• Enviado: AT#MSEND=20,"0102030405060708091011121314151617181920"\r
• Recebido: OK\r

Habilitar notificação de downlinks

• Enviado: AT#MRECV=1
• Recebido: OK\r