Como fazer download do código MicroPython no XBee 3: 18 etapas (com imagens)

2024 Autor: John Day | [email protected]. Última modificação: 2024-01-30 11:37

MicroPython é uma linguagem de programação inspirada em Python 3.0 que funciona em microcontroladores, como o XBee 3. MicroPython pode ajudar a diminuir a quantidade de suprimentos e o volume geral de seu projeto, e tornar as coisas muito mais fáceis. No entanto, descobri que, quando estava usando o MicroPython, o processo de upload e download do código para o dispositivo era confuso. Portanto, este instrutível visa explicar o processo "simples" de como fazer o download do código de e para o seu XBee.

Se ainda não o fez, dê uma olhada no Digi MicroPython Programming Guide. É útil para obter um amplo conhecimento de como o MicroPython funciona no XBees e também para solucionar problemas.

Este tutorial não presume que você esteja familiarizado com o XCTU, mas se estiver, pode ler os cabeçalhos de cada seção para obter mais etapas básicas sobre como instalar e desinstalar o código MicroPython. Ele pressupõe que você já escreveu seu código e o salvou como um arquivo.py ou.mpy.

O XBee que uso está usando o protocolo 802.15.4, portanto, quaisquer diferenças que você encontrar entre o tutorial e sua própria versão do XCTU podem ser devido a isso.

Algumas regras gerais a serem seguidas ao usar MicroPython no XBees:

- Mantenha a taxa de transmissão em 115200 ou superior. Isso ajuda a evitar a perda de dados.

- Faça seu código rodar rapidamente nos pacotes de entrada. Ao usar o MicroPython, o XBee pode conter apenas uma fila de 4 pacotes de dados - uma vez que a fila está cheia, ele lança novos dados entrando.

- Verifique se o seu XBee é um XBee3. MicroPython não funciona em nenhum outro modelo do XBee.

Suprimentos

• XBee3 (quantos você precisar)
• Um XBee Explorer ou dongle semelhante que permite que você conecte seu XBee ao computador
• Um computador com XCTU instalado
• Um arquivo.py ou.mpy contendo o código que você deseja instalar no XBee

Etapa 1: Conecte seu XBee

Conecte o XBee que deseja programar e abra o XCTU. Clique em Adicionar dispositivos (o ícone que se parece com um XBee com um +) no canto superior esquerdo e selecione a porta COM correta. Certifique-se de que a taxa de transmissão esteja correta (deixamos o XBees definido como 9600) e clique em Concluir para conectar o XBee.

O XCTU leva muito tempo para carregar muitas coisas. Quando você vir a barra de carregamento verde, o que você verá com frequência, apenas seja paciente.

Etapa 2: verifique se o PS está definido como 0 e o AP está definido como 4

Clique no ícone do XBee no lado esquerdo da tela para exibir suas configurações no lado direito. No lado direito da tela, role para baixo até a seção chamada Comandos MicroPython e certifique-se de que PS esteja definido como Disabled [0]. Se não estiver, altere a configuração e clique no ícone de lápis ao lado da configuração na extrema direita para escrever a alteração no XBee. Faça o mesmo na seção chamada Interface UART para o parâmetro AP e certifique-se de que esteja definido como MicroPython REPL [4].

O parâmetro PS determina se o código é executado automaticamente ou não quando o XBee é ligado, e o parâmetro AP é basicamente o "modo operacional" em que o XBee está. Para fazer o MicroPython funcionar, ele precisa estar em seu próprio "modo MicroPython. " Se PS estiver definido como Enabled [1], ele pode causar problemas com algumas dessas etapas, então acho melhor desligá-lo até terminar de atualizar o código no XBee.

Etapa 3: Abra o Gerenciador do Sistema de Arquivos

Navegue até a seção “Ferramentas” na barra na parte superior da tela e selecione Gerenciador do sistema de arquivos. Ele abre uma janela semelhante à mostrada acima - os arquivos no seu computador são mostrados à esquerda e uma janela vazia é mostrada à direita.

Etapa 4: configurar a porta COM correta

Clique em Configurar. Selecione a porta COM correta, certifique-se de que a taxa de transmissão esteja correta e clique em OK. Você deve ver o nome da porta COM selecionada no local onde dizia anteriormente “Configure a porta antes de trabalhar com o sistema de arquivos”.

Etapa 5: Abra a conexão com o XBee

Clique em Abrir. Se você receber um erro, desconectar e conectar o XBee novamente e, em seguida, clicar em Abrir geralmente funciona. Agora você deve ver os arquivos carregados no XBee no lado direito da janela. Se o seu XBee for novo, você provavelmente verá apenas duas pastas, mas se o seu XBee tiver sido usado antes, você poderá ver outros arquivos no diretório (no meu, há um chamado "main.py").

Etapa 6: exclua o código antigo no gerenciador de sistema de arquivos

Se o seu XBee não tiver um código antigo, você pode pular esta etapa.

Se você estiver atualizando um arquivo de código antigo no XBee, deverá excluir o antigo primeiro. O XBee não exclui automaticamente as versões antigas do código e tem armazenamento muito limitado, então você deve excluir manualmente os arquivos do código antigo.

O código MicroPython no XBee deve estar em um arquivo denominado “main.py” para que o XBee execute o código automaticamente. Você pode ter vários arquivos carregados no XBee, mas o único que será executado na inicialização é “main.py”, então você pode usar vários módulos, desde que importe-os para “main.py.” Se estiver usando vários módulos, você só precisa excluir aquele que está reenviando para o XBee.

Primeiro, clique com o botão direito no arquivo que deseja excluir e selecione Excluir. Após alguns instantes, ele desaparecerá do Gerenciador de sistema de arquivos. O arquivo agora foi excluído do armazenamento principal do XBee. Porém, o XBee também possui uma memória de trabalho, onde armazena o último código para o qual foi direcionado a execução, e este também deve ser apagado. Clique em Fechar no canto inferior direito para sair do Gerenciador de Sistema de Arquivos.

Etapa 7: Mude AP para 1

Nas configurações do XBee no lado direito da tela, vá até a seção que diz Interface UART. Altere o parâmetro AP para API Mode Without Escapes [1] e clique no ícone de lápis para gravá-lo no XBee. Isso nos permite enviar comandos AT para o XBee, o que teremos que fazer para apagar a memória de trabalho do XBee. Se você estiver usando o XBee do novo, provavelmente não terá que seguir este passo na primeira vez que fizer o download do código nele, mas não custa nada confirmar que a memória de trabalho foi apagada.

Etapa 8: Mude para o modo de trabalho dos consoles e abra a conexão

Mude para o modo de trabalho dos consoles pressionando Alt-C ou clicando no botão no canto superior direito que se parece com um monitor de TV e pressione Abrir para abrir a linha de comunicação com o seu XBee. Usamos este modo para falar com nossos XBees.

Etapa 9: Abra o Gerador de Quadros

No lado direito da tela, abaixo de onde diz Enviar um único pacote, clique no ícone + e, em seguida, clique em Criar quadro usando a ferramenta ‘Gerador de quadros’ na janela pop-up. Isso abre o Gerador de quadros, mostrado acima. Usamos isso para gerar a mensagem que enviaremos ao XBee.

Etapa 10: Configurar o Gerador de Quadros para Gerar um Comando AT

Onde diz Tipo de quadro, clique na caixa para abrir um menu suspenso e selecione 0x08 - Comando AT. A tela mudará para o formato mostrado acima.

Etapa 11: Digite o comando AT para apagar a memória de trabalho

Na caixa destacada em vermelho rotulada Comando AT, digite PY. Esta é a primeira parte do comando AT, essencialmente dizendo ao XBee que queremos fazer algo com MicroPython. Na caixa chamada Valor do parâmetro, digite E. Este é o comando específico do MicroPython que queremos que o XBee execute, que está apagando a memória de trabalho do XBee (tento me lembrar de “E para apagar”). Conforme você digita, os números aparecem na caixa na parte inferior da tela.

Etapa 12: adicionar o quadro

Clique em OK. Agora você está de volta à janela em que estava antes de entrar no Gerador de Quadros. O nome do frame não é particularmente importante para nossos propósitos, então ignore-o. Você deve ver os números da última janela na caixa desta janela. Em caso afirmativo, selecione Adicionar quadro.

Etapa 13: enviar o comando AT

O novo quadro “frame_0” aparece na caixa com o rótulo Send frames. Agora podemos enviar o comando AT para o XBee. Certifique-se de que o quadro que acabamos de criar esteja destacado e clique no botão com a seta verde que diz Enviar quadro selecionado. Texto em azul e vermelho aparecerá no registro de quadros acima.

Etapa 14: interpretar a resposta

O texto em azul é o comando que você acabou de enviar e o texto em vermelho é a resposta do XBee. Clique no texto vermelho para lê-lo. Você pode ver uma linha hexadecimal semelhante à que enviamos para o XBee na janela à direita. Você pode copiar e colar isso na ferramenta Frames Interpreter (acessada clicando na seta ao lado do ícone da ferramenta acima), mas se o penúltimo par de dígitos for um zero duplo, isso significa que conseguiu apagar a memória de trabalho.

Etapa 15: Mude AP para 4

Clique em Fechar no canto superior esquerdo para sair da comunicação com o XBee.

Clique no ícone de engrenagem para voltar às configurações do XBee e role de volta para a interface UART e altere o parâmetro AP de volta para MicroPython REPL [4]. Grave a nova configuração no XBee clicando no ícone de lápis.

Etapa 16: arraste seu código para o gerenciador de sistema de arquivos

Volte para Ferramentas> Gerenciador de sistema de arquivos, configure para a porta correta e clique em Abrir. No lado esquerdo da janela (arquivos do seu computador), navegue até o código que deseja enviar para o XBee e clique e arraste-o para o lado direito (os arquivos do XBee). Você deve ver o arquivo aparecer no lado direito. O novo código agora foi baixado para o XBee.

Etapa 17: Abra o Terminal MicroPython

Clique em Fechar. É hora de verificar se o código está funcionando. Navegue até Ferramentas> Terminal MicroPython. Selecione Configurar, escolha a porta COM correta e clique em Abrir. Deve haver um cursor preto piscando na janela. Pressione Enter e você verá o prompt MicroPython: >>>

Etapa 18: Teste seu código

Pressione Ctrl-R e o código no arquivo “main.py” será executado. Se tudo estiver funcionando corretamente, pronto! Se você quiser que o código seja executado automaticamente quando o XBee for ligado, feche o Terminal MicroPython e, nas configurações do XBee, role para baixo até Comandos MicroPython e altere o parâmetro PS para Ativado [1] e clique no ícone de lápis para escrever para o XBee.