Manual de Comandos UBEE

Transcrição

1 Manual de Comandos UBEE Versão de firmware 2.0 REV 02 Fractum Indústria e Comércio de Equipamentos Eletrônicos LTDA - Av. Antônio Américo Junqueira 335 Pôr do Sol - Santa Rita do Sapucaí-MG - CEP TEL: Site: suporte@fractumrf.com - 1 -

2 Índice 1. ATWR ATRF-restore de fábrica ATRE ATCH ATID identification ATDA destination adress ATSA source adress ATREN Router Enable ATTR tempo de retransmissão ATNR número de retransmissões ATAE ack enable ATBD baud rate ATRO ATDOI ATCTx ATMLP ATPLP ATRLI ATWLO ATRLA ATNS nível do sinal recebido ATIND indication ATBAT bateria, leitura ATMSE ATTN ATCN ATMS ATTS

3 Entrando no modo de comando Para entrar no modo de comando AT, deve-se enviar 3 caracteres sequenciais ( + padrão) e depois aperte. Para enviar comandos AT, deve-se enviar a sintaxe como mostra a figura abaixo: Lista de comandos Comando Descrição Faixa de Valores Valor Padrão 1 ATWR Grava as configurações na - - EEPROM 2 ATRF Restaura as configurações de - - fábrica(padrão) 3 ATRE Reinicia o módulo ATCH Canal de operação do módulo 11 a ATID Endereço da rede ID. Lê/Configura o ID da rede. 6 ATDA Endereço de Destino. Lê/Configura o endereço de destino da mensagem. 7 ATSA Endereço de Fonte. Lê/Configura o endereço de fonte. 8 ATREN Habilita/Desabilita o modo roteamento. Todas as mensagens recebidas serão retransmitidas caso não seja este módulo o destino. 9 ATTR Timeout necessário para uma retransmissão. Se o módulo não receber um ACK em TR*10ms e caso esteja habilitado a retransmissão(attr diferente de 0 a a = broadcast a = desabilita 1 = habilita 0 10 a

4 0) o módulo envia novamente o mesmo pacote. 10 ATNR Número de retransmissões de 0 a 20 5 uma mensagem com ACK e não broadcast(atda diferente de 255), o módulo retransmite a mensagem após um tempo (ATTR) até que o módulo de destino envie um ACK. 11 ATAE Habilita ou desabilita as 0 = desabilita 1 = habilita 1 confirmações de mensagem (ACK) 12 ATBD Taxa da USART do módulo 0 a 6 0 = 2400bps 1 = 4800 bps 2 = 9600 bps 3 = bps 4 = bps 5 = bps 6 = bps 3 13 ATRO Timeout para empacotamento dos dados. Lê/Configura o tempo de silêncio antes do envio dos dados armazenados no buffer de entrada. Configurando RO = 0 os dados que chegam pela serial são enviados imediatamente. Os dados que estiverem no buffer de entrada serial (para RO>0) serão enviados após um time out de RO*10ms quando não receber mais dados. 14 ATDOI Configura o estado inicial dos terminais de saída. 15 ATCTx y Configuração da funcionalidade do terminal. x indica o terminal (0 a 9) y indica a funcionalidade do terminal 0 - Saída local 1- Entrada local 2- Saída I/O Line Passing 3- Entrada I/O Line Passing 4- Entrada Analógica 0 a a x = 0 a 9 y = 0 a 4 I/O 0 = 4 I/O 1 = 4 I/O 2 = 4 I/O 3 = 4 I/O 4 = 4 I/O 5 = 4 I/O 6 = 0 I/O 7 = 0 I/O 8 = 0 I/O 9 = 0-4 -

5 16 ATMLP Habilita/desabilita o modo de mudança de estado do modo io line passing 17 ATPLP Habilita/desabilita o modo periódico de mudança de estado do modo io line passing com valor múltiplo de 10ms 18 ATRLIx Leitura local dos I/Os. Caso não seja enviado o parâmetro x, será lido todas as entradas. Se x for um parâmetro (entrada) válida, será lido somente esta entrada. 19 ATWLOx y Escreve na saída local ou em todas as saídas. x indica o I/O y indica o estado do I/O 1 = habilita o envio das informações do modo io linepassing por mudança de estado 0 = desabilita 0 a = desabilitado a 9 - x = 0 a 9 y = 0-1 ou y=0 a ATRLAx Lê entrada analógica local. Caso não seja enviado o parâmetro x, será lido todas as entradas analógicas. Se x for um parâmetro (entrada) válida, será lido somente esta entrada. x = 0 a 5 0 a ATNS Lê o RSSI(nível de sinal recebido) do ultimo pacote recebido ATIND Habilita/desabilita o modo de indicação por pinos 0 = desabilita 1 = habilita 1 23 ATBAT Lê o nível de tensão de alimentação do módulo 24 ATMSE Habilita a impressão de mensagens de status no modo modem(transparente), somente quando o ACK está habilitado. 25 ATTN Tempo de notificação da rede(é importante que os módulos da rede possuam o mesmo tempo configurado). O valor configurado será multiplicado por 10ms = desabilita 1 = habilita 1 50 a

6 26 ATCN Finaliza o modo de comando ATMS Modo Sleep. Este comando seleciona se o módulo estará habilitado para operar no modo sleep e de que forma. 0 = desabilitado 1 = habilitado 2 = habilitado e periódico 0 28 ATTS Tempo de Sleep. Quando selecionado MS = 2, é habilitado o envio do relatório no modo sleep periódico, sendo o valor múltiplo de 8,45s. 0 a

7 1. ATWR Comando Tipo Valor Padrão ATWR Escrita - Comando que salva na memória eeprom do módulo as configurações realizadas. Qualquer configuração realizada no módulo deve ser salva, a fim de evitar a perda dessa configuração. Assim que enviado este comando, o módulo salva todas as configurações realizadas na memória eeprom. Exemplo: Comando ATWR Convertendo para ASCII em hexadecimal fica: A T W R 0x41 0x54 0x57 0x52 0x0D Espaço LF LF Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATWR - 7 -

8 2. ATRF-RESTORE DE FÁBRICA Comando Tipo Faixa de Valores Valor Padrão ATRF Escrita - - Este comando retorna todas as configurações de fábrica do módulo salvando na memória EEPROM as configurações originais. Ao enviar este comando todas as configurações realizadas serão perdidas e o módulo será reinicializado. As configurações padrões estão descritas abaixo: Comando Valor Padrão ATCH 11 ATID 1 ATDA 255 ATSA 0 ATREN 0 ATTR 100 ATNR 5 ATAE 1 ATBD 3 ATRO 10 ATDOI 0 ATCTx y x=0 y=4-8 -

9 x=1 y=4 x=2 y=4 x=3 y=4 x=4 y=4 x=5 y=4 x=6 y=0 x=7 y=0 x=8 y=0 x=9 y=0 ATMLP 0 ATPLP ATMSE 1 ATTN 100 ATMS 2 ATTS 1 Exemplo: Comando ATRF Convertendo para ASCII em hexadecimal fica: A T R F 0x41 0X54 0x52 0x46 0x0D - 9 -

10 Espaço LF LF Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATRF executa o comando e reinicializa New Ubee versao

11 3. ATRE Comando Tipo Faixa de Valores Valor Padrão ATRE Escrita - - Este comando reinicializa o módulo. Caso este comando for enviado antes do comando ATWR as configurações feitas serão perdidas. Exemplo: Comando ATRE Convertendo para ASCII em hexadecimal fica: A T R E 0x41 0X54 0x52 0x45 0x0D Espaço LF LF Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D

12 ATRE executa o comando e reinicializa New Ubee versao

13 4. ATCH Comando Tipo Faixa de Valores Valor Padrão ATCH Escrita/Leitura 11 a Comando de configuração do canal de operação. Os módulos baseados no padrão IEEE possuem 16 canais de operação e são eles: Este canal deve ser escolhido para operar de acordo com o local onde serão instalados os módulos. Redes de Wi-Fi (IEEE802.11) afetam diretamente a eficiência de transmissão do módulo diminuindo a distância de operação. As redes IEEE utilizam o mesmo espectro das redes IEEE , por exemplo caso tenha os canais 1,6 e 11 de uma rede IEEE ativos, o espectro será:

14 Portanto, é evidente nesse caso escolher os canais 15 ou 20 para evitar coexistência com as rede IEEE802.11, caso seja necessário configurar outro canal de operação, deve-se identificar se existe uma rede IEEE operando neste mesmo canal. Exemplos: a. Exemplo de envio do canal 15 : Comando Espaço Canal ATCH 15 Espaço LF LF A T C H Espaço 15 0x41 0x54 0x43 0x48 0x20 0x31 0x35 0x0D Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATCH

15 b. Exemplo de leitura do canal (considerando que o módulo esteja no canal 15): Comando ATCH Espaço Canal Espaço LF 15 LF A T C H 0x41 0X54 0x43 0x48 0x0D Espaço 15 Espaço O K LF 0x20 0x31 0x35 0x20 0x4F 0x4B 0x0A 0x0D ATCH

16 5. ATID IDENTIFICATION Comando Tipo Faixa de Valores Valor Padrão ATID Escrita/Leitura 1 a Este comando configura o endereço da rede que se deseja fazer uma comunicação. Quando se deseja fazer a comunicação entre dois ou mais módulos, é necessário configurar os seguintes parâmetros mínimos: Endereço do módulo Endereço de destino Canal de comunicação ID da rede Pode-se ter duas redes operando no mesmo canal com endereços (ATSA) iguais, porém com o ID da rede diferente, neste caso somente os módulos que possuam o mesmo ID irão se comunicar. Como exemplificado na figura abaixo: ID = 2 ID =1-16 -

17 Exemplos: a. Exemplo de envio do ID 1 : Comando Espaço ID ATID 1 Espaço LF LF A T I D Espaço 1 0x41 0x54 0x49 0x44 0x20 0x31 Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATID

18 b. Exemplo de leitura do ID (considerando que o módulo esteja com o ID 10): Comando ATID Espaço ID Espaço LF 10 LF A T I D 0x41 0x54 0x49 0x44 0x0D Espaço 10 Espaço O K LF 0x20 0x31 0x30 0x20 0x4F 0x4B 0x0A 0x0D ATID

19 6. ATDA DESTINATION ADDRESS Comando Tipo Faixa de Valores Valor Padrão ATDA Escrita/Leitura 0 a 254 = modo unicast =modo broadcast Este comando configura o endereço de destino da mensagem. Este endereço deve ser o valor do endereço de fonte (ATSA) do módulo que se deseja enviar uma mensagem. Caso este endereço de destino seja igual a 255, todos os módulos irão receber esta mensagem, desta forma, chama-se a mensagem de BROADCAST. Qualquer módulo de RF dentro do alcance da rede irá aceitar um pacote contendo um endereço Broadcast. Quando configurado para operar neste modo, os módulos receptores não enviam o reconhecimento de mensagem recebida (ACK) e os módulos transmissores não reenviam pacotes de dados como no modo Unicast. Para enviar um pacote Broadcast para todos os módulos independentemente do endereço de destino, configure o endereço de destino de todos os módulos como: ATDA 255. Exemplos: a. Exemplo de envio do DA 1 : Comando Espaço DA ATDA 1 Espaço LF LF

20 A T D A Espaço 1 0x41 0x54 0x44 0x41 0x20 0x31 0x0D Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATDA

21 b. Exemplo de leitura do DA (considerando que o módulo esteja com o DA 255): Comando ATDA Espaço DA Espaço LF 255 LF A T D A 0x41 0x54 0x44 0x41 0x0D Espaço 255 LF 0x20 0x32 0x35 0x35 0x0A 0x0D ATDA

22 7. ATSA SOURCE ADDRESS Comando Tipo Faixa de Valores Valor Padrão ATSA Escrita/Leitura 0 a Este comando configura o endereço do próprio módulo. Cada módulo possui um endereço na rede, e todas as mensagens enviadas são identificadas por este endereço. É recomendado que cada módulo possua um endereço diferente. Exemplos: a. Exemplo de envio do SA 1 : Comando Espaço SA ATSA 1 Espaço LF LF A T S A Espaço 1 0x41 0x54 0x53 0x41 0x20 0x31 0x0D

23 Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATSA

24 b. Exemplo de leitura do SA (considerando que o módulo esteja com o SA 0): Comando ATSA Espaço SA Espaço LF 0 LF A T S A 0x41 0x54 0x53 0x41 0x0D Espaço 0 LF 0x20 0x30 0x0A 0x0D ATSA

25 8. ATREN ROUTER ENABLE Comando Tipo Faixa de Valores Valor Padrão ATRE Escrita/Leitura 0 = desabilita 0 1=habilita Este comando habilita(1) ou desabilita (0) o modo roteamento. Quando este modo está habilitado, o módulo reenvia toda mensagem recebida caso o endereço de destino não seja este módulo. Desta forma, com o modo roteamento habilitado é possível aumentar o alcance da rede e formar redes complexas como Cluster Tree e Mesh. Exemplos: a. Habilitando o modo Roteador: Comando Espaço REN ATREN 1 Espaço LF LF

26 A T R E N Espaço 1 0x41 0x54 0x52 0x45 0x4E 0x20 0x31 0x0D Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATREN 1 b. Desabilitando o modo Roteador: Comando Espaço REN ATREN 0 Espaço LF LF

27 A T R E N Espaço 0 0x41 0x54 0x52 0x45 0x4E 0x20 0x30 0x0D Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATREN 0 c. Ler o status do modo Roteador (supondo que esteja habilitado): Comando ATREN Espaço REN Espaço LF 1 LF

28 A T R E N 0x41 0x54 0x52 0x45 0x4E 0x0D Espaço 1 Espaço O K LF 0x20 0x31 0x20 0x4F 0x4B 0x0A 0x0D ATREN

29 9. ATTR TEMPO DE RETRANSMISSÃO Comando Tipo Faixa de Valores Valor Padrão ATTR Escrita/Leitura 10 a Assim que uma mensagem é enviada o módulo dispara um contador que é configurado com o valor deste comando x10ms. Se o contador estourar, é habilitado o envio de outra mensagem. Este comando só é utilizado se o modo ACK estiver habilitado (ATAE 1), o modo de retransmissão for maior do que 0(ATTR > 0) e a mensagem não for broadcast (ATDA 255). Exemplos: a. Ler o valor do tempo de retransmissão (supondo que TR seja igual a 100): Comando ATTR Espaço TR Espaço LF 100 LF A T T R 0x41 0x54 0x54 0x52 0x0D

30 Espaço 100 Espaço O K LF 0x20 0x31 0x30 0x30 0x20 0x4F 0x4B 0x0A 0x0D ATTR 100 b. Configurando o tempo de retransmissão como 2 segundos: Sabemos que o valor a ser configurado em TR será multiplicado por 10ms, portanto, para termos um tempo de retransmissão de 2 segundos, é necessário configurar TR com 200, pois 200x10ms = 2000ms = 2 segundos. Comando Espaço TR ATTR 200 Espaço LF LF

31 A T T R Espaço 200 0x41 0x54 0x54 0x52 0x20 0x32 0x30 0x30 0x0D Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATTR

32 10. ATNR NÚMERO DE RETRANSMISSÕES Comando Tipo Faixa de Valores Valor Padrão ATNR Escrita/Leitura 0 a 20 5 Este comando configura o número de retransmissões após ter estourado o timeout configurado em ATTR e o módulo não ter recebido o ACK. É requisito para funcionar que o ACK esteja habilitado (ATAE 1). Após ser retransmitido o número de vezes configurado e o módulo não receber a confirmação da mensagem (ACK) é considerado um FAIL e enviado para o pino de TX (se o modo de impressão de mensagens de status estiver habilitado, ATMSE 1) a seguinte mensagem: FAIL NR: 5 neste caso ocorreu uma falha e número de retransmissão configurado é igual a 5. Exemplos: a. Ler o valor do número de retransmissão (supondo que NR seja igual a 5): Comando ATNR Espaço NR Espaço LF 5 LF

33 A T N R 0x41 0x54 0x4E 0x52 0x0D Espaço 5 Espaço O K LF 0x20 0x35 0x20 0x4F 0x4B 0x0A 0x0D ATNR 5 b. Configurando o número de retransmissões para 10: Comando Espaço NR ATNR 10 Espaço LF LF

34 A T N R Espaço 10 0x41 0x54 0x4E 0x52 0x20 0x31 0x30 0x0D Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATNR

35 11. ATAE ACK ENABLE Comando Tipo Faixa de Valores Valor Padrão ATAE Escrita/Leitura 0 = desabilita 0 1=habilita Este comando habilita ou desabilita o envio de ACK. O ACK é utilizado para aumentar a confiabilidade da informação, informando que a mensagem chegou ou não ao destino. Este comando só é valido se a mensagem for do tipo Unicast, ou seja, o destino diferente de 255 (ATDA 255). Caso o endereço de destino esteja configurado como broadcast e esteja habilitado o ACK (ATAE 1), o módulo não enviará o ACK, pois por definição, toda mensagem broadcast não possui ACK. Exemplos: a. Habilitando o envio de ACK: Comando Espaço AE ATAE 1 Espaço LF LF A T A E Espaço 1 0x41 0x54 0x41 0x45 0x20 0x31 0x0D

36 Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATAE 1 b. Desabilitando o ACK: Comando Espaço AE ATAE 0 Espaço LF LF A T A E Espaço 0 0x41 0x54 0x41 0x45 0x20 0x30 0x0D

37 Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATAE 0 c. Ler o status do ACK (supondo que esteja habilitado): Comando ATAE Espaço AE Espaço LF 1 LF A T A E 0x41 0x54 0x41 0x45 0x0D

38 Espaço 1 Espaço O K LF 0x20 0x31 0x20 0x4F 0x4B 0x0A 0x0D ATAE

39 12. ATBD BAUD RATE Comando Tipo Faixa de Valores Valor Padrão ATBD Escrita/Leitura 0 =2400bps 3 1 = 4800bps 2 = 9600bps 3 = 19200bps 4 = 38400bps 5 = 57600bps 6 = bps Este comando configura a taxa de comunicação da USART(serial) do módulo, sendo que as configurações abaixo são fixas: Bits de dados: 8 Paridade: Nenhum Bit de parada: 1 Controle de Fluxo: nenhum Os valores possíveis de taxa são: ATBD 0 a taxa será de 2400bps ATBD 1 a taxa será de 4800bps ATBD 2 a taxa será de 9600bps ATBD 3 a taxa será de 19200bps ATBD 4 a taxa será de 38400bps

40 Exemplos: ATBD 5 a taxa será de 57600bps ATBD 6 a taxa será de bps Obs.: o módulo irá alterar a taxa somente se for enviado o comando ATWR e for reinicializado o módulo. a. Exemplo de configuração para uma taxa de 9600bps: Comando Espaço BD ATBD 2 Espaço LF LF A T B D Espaço 2 0x41 0x54 0x42 0x44 0x20 0x32 Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATDB 2 O módulo não altera a taxa nesse ponto, somente se for enviado ATWR e reiniciado o módulo

41 b. Exemplo de leitura da taxa (considerando que o módulo esteja na taxa 19200bps): Comando ATBD Espaço BD Espaço LF 3 LF A T B D LF 0x41 0x54 0x42 0x44 0x0A 0x0D Espaço 2 LF 0x20 0x32 0x0A 0x0D ATBD

42 13. ATRO Comando Tipo Faixa de Valores Valor Padrão ATR0 Escrita/Leitura 0 a = 0x10ms = 0ms 1 = 1x10ms = 10ms 2 = 2x10ms = 20ms = 100x10ms = 1000ms Comando de configuração do tempo de empacotamento dos dados. Configura o tempo de silêncio antes do envio dos dados armazenados no buffer de entrada. Se nenhum dado for recebido no pino de RX do módulo durante x*10ms, o pacote é transmitido. Se configurado como 0 (0x10ms =0ms) cada byte recebido é transmitido. O valor deste parâmetro deve ser configurado de acordo com cada aplicação, pois ele afeta diretamente na velocidade de transmissão efetiva do rádio. Por exemplo, se configurado como 0 este parâmetro, a cada byte recebido será transmitido. A transmissão irá ocorrer, porém com muito overhead, ou seja, muita informação de cabeçalho e pouca informação útil. Portanto este parâmetro deve ser configurado de uma forma que não afete a velocidade de transmissão e para isso a forma mais fácil é conhecer o que será transmitido

43 Exemplos: a. Ler o valor do tempo de silêncio (supondo que RO seja igual a 10): Comando ATRO Espaço RO Espaço LF 10 LF A T R 0 0x41 0x54 0x52 0x4F 0x0D Espaço 10 Espaço O K LF 0x20 0x31 0x30 0x20 0x4F 0x4B 0x0A 0x0D ATRO

44 b. Configurando o tempo de silêncio para 50ms: Sabemos que o valor a ser configurado em RO será multiplicado por 10ms, portanto, para termos um tempo de silêncio de 50ms, é necessário configurar RO com 5, pois 5x10ms = 50ms. Comando Espaço RO ATRO 5 Espaço LF LF A T R 0 Espaço 5 0x41 0x54 0x52 0x4F 0x20 0x35 0x0D Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATRO

45 14. ATDOI Comando Tipo Faixa de Valores Valor Padrão ATDOI Escrita/Leitura 0 a Este comando configura o status inicial dos pinos configurados como saída. Sendo que o valor configurado é uma máscara do estado inicial dos pinos. Cada pino tem um bit correspondente na palavra de configuração de 10 bits. MSB LSB DIO9 DIO8 DIO7 DIO6 DIO5 DIO4 DIO3 DIO2 DIO1 DIO0 Por exemplo, caso os pinos DIO1, DIO2 e DIO3 devam iniciar em nível lógico alto e os outros em nível lógico baixo, o valor do parâmetro do ATDOI em binário é: DIO9 DIO8 DIO7 DIO6 DIO5 DIO4 DIO3 DIO2 DIO1 DIO Convertendo para decimal, fica: 14, portanto, basta enviar: ATDOI 14 Exemplos: a. Ler o valor do estado inicial (supondo que todos estejam configuradas como 0): Comando ATDOI

46 Espaço DOI Espaço LF 0 LF A T D 0 I 0x41 0x54 0x52 0x4F 0x49 0x0D Espaço 0 Espaço O K LF 0x20 0x30 0x20 0x4F 0x4B 0x0A 0x0D ATDOI 0 b. Configurando o estado inicial para 1 em todos os pinos: Sabemos que o valor a ser configurado deve ser enviado em decimal, portanto, para termos todos os pinos em 1 devemos ter: DIO9 DIO8 DIO7 DIO6 DIO5 DIO4 DIO3 DIO2 DIO1 DIO

47 Convertendo para decimal, fica: Comando Espaço DOI ATDOI 1023 Espaço LF LF A T R 0 Espaço x41 0x54 0x52 0x4F 0x20 0x31 0x30 0x32 0x33 0x0D Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATDOI

48 15. ATCTX Y Comando Tipo Faixa de Valores Valor Padrão ATCTx y Escrita/Leitura x = 0 a 9 y = 0 a 4 x=0 y=4 x=1 y=4 x=2 y=4 x=3 y=4 x=4 y=4 x=5 y=4 x=6 y=0 x=7 y=0 x=8 y=0 x=9 y=0 Obs.: x = pino DIO e y = funcionalidade do pino Este comando configura o modo que o pino vai assumir e também o tipo de pino. A letra x identifica o pino DIO, sendo: x=0 DIO0 x=1 DIO1 x=2 DIO2... x=9 DIO9 O parâmetro a ser enviado (y) identifica o que será este pino, podendo ser: 0- Saída

49 1- Entrada 2- Saída linepassing 3- Entrada linepassing 4- Entrada Analógica Por exemplo: ATCT0 0 o pino DIO0 será saída ATCT1 0 o pino DIO1 será entrada ATCT5 3 o pino DIO5 será entrada linepassing Exemplos: a. Ler o modo de operação do DIO 0(supondo que este pino seja uma entrada analógica): Comando ATCT0 Espaço CT0 Espaço LF 4 LF A T C T 0 0x41 0x54 0x43 0x54 0x30 0x0D

50 Espaço 4 Espaço O K LF 0x20 0x34 0x20 0x4F 0x4B 0x0A 0x0D ATCT0 4 b. Configurando o DIO9 para ser uma saída: Comando Espaço Y ATCT9 0 Espaço LF LF

51 A T C T 9 Espaço 0 0x41 0x54 0x43 0x54 0x39 0x20 0x30 0x0D Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATCT

52 16. ATMLP Comando Tipo Faixa de Valores Valor Padrão ATMLP Escrita/Leitura 0 = desabilita 0 1=habilita Este comando habilita ou desabilita o envio dos estados lógicos dos pinos configurados como linepassing, sendo que assim que ocorre uma mudança de estado em algum dos pinos o módulo envia essa informação. Colocando em 0 desativa o envio por mudança de estado, colocando em 1 ativa o envio por mudança de estado no pino. Para habilitar o modo I/O line passing é essencial que habilite o ATMLP 1. O modo linepassing é um modo de operação onde um módulo irá acionar uma saída de outro módulo conforme o status de sua entrada. No exemplo abaixo, temos uma chave ligada no DIO0 do módulo1, e um circuito driver com um relé ligado no DIO0 do módulo 2. A chave quando não está acionada, mantém um nível lógico alto no DIO0 do módulo 1. Logo, o DIO0 do módulo 2 estará também em nível lógico alto, atracando o relé. Caso a chave seja pressionada, o nível lógico no DIO0 do módulo 1 será 0, colocando o mesmo nível no DIO0 do módulo 2, desatracando o relé. Para isso é necessário as seguintes configurações AT: 1 ATDA 2 - configura o endereço de destino igual a 2 ATSA 1 configura o endereço de fonte igual a 1 ATCT0 3 configura o DIO0 com entrada linepassing ATMLP 1 habilita o envio por mudança de estado ATWR salva na memória as configurações atuais

53 2 ATDA 1 - configura o endereço de destino igual a 1 ATSA 2 configura o endereço de fonte igual a 2 ATCT0 2 configura o DIO0 com saída linepassing ATMLP 1 habilita o envio por mudança de estado ATWR salva na memória as configurações atuais Exemplos: a. Habilitando o modo LinePassing: Comando Espaço MLP ATMLP 1 Espaço LF LF

54 A T M L P Espaço 1 0x41 0x54 0x4D 0x4C 0x50 0x20 0x31 0x0D Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATMLP 1 b. Desabilitando o modo LinePassing: Comando Espaço MLP ATMLP 0 Espaço LF LF

55 A T M L P Espaço 0 0x41 0x54 0x4D 0x4C 0x50 0x20 0x30 0x0D Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATMLP

56 c. Ler o status do modo LinePassing (supondo que esteja habilitado): Comando ATMLP Espaço MLP Espaço LF 1 LF A T M L P 0x41 0x54 0x4D 0x4C 0x50 0x0D Espaço 1 Espaço O K LF 0x20 0x31 0x20 0x4F 0x4B 0x0A 0x0D ATMLP

57 17. ATPLP Comando Tipo Faixa de Valores Valor Padrão ATPLP Escrita/Leitura 0 a Este comando habilita o envio de mensagens periódicas do modo io linepassing. Sendo que o valor configurado é múltiplo de 10ms. Neste modo o módulo envia periodicamente o estado lógico dos pinos que são configurados como entrada/saída linepassing. Por exemplo: ATPLP 10 o módulo enviará uma mensagem contendo o estado lógico dos pinos a cada 10x10ms = 100ms. Exemplos: a. Ler o valor do PLP(supondo que PLP seja igual a 10): Comando ATPLP Espaço PLP Espaço LF 10 LF A T P L P 0x41 0x54 0x50 0x4C 0x50 0x0D

58 Espaço 10 Espaço O K LF 0x20 0x31 0x30 0x20 0x4F 0x4B 0x0A 0x0D ATPLP 10 b. Configurando o tempo de envio do modo linepassing para 1segundo: Sabemos que o valor a ser configurado em PLP será multiplicado por 10ms, portanto, para termos um tempo de envio a cada 1 segundo, é necessário configurar PLP com 100, pois 100x10ms = 1000ms = 1s. Comando Espaço PLP ATPLP 100 Espaço LF LF A T P L P Espaço 100 0x41 0x54 0x50 0x4C 0x50 0x20 0x31 0x30 0x30 0x0D

59 Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATPLP

60 18. ATRLIX Comando Tipo Faixa de Valores Valor Padrão ATRLIx Leitura x = 0 a 9 - x = 0 DIO0 x = 1 DIO1 x = 2 DIO2... x = 9 DIO9 Caso não seja enviado x, será lido todos os DIO s Obs.: x = pino DIO e y = nível lógico do pino ou de todos os pinos Este comando realiza a leitura local das entradas. Exemplo de uso: ATRLI todas as entradas em nível lógico alto ATRLI DIO0 a DIO8 em nível lógico alto, DIO9 em nível 0 ATRLI DIO0 a DIO8 em nível lógico alto, DIO9 em nível 0 ATRLI0 1 DIO0 em nível lógico baixo Caso seja solicitado uma leitura de um pino que não é uma entrada local é enviado o caractere -. Exemplo: ATRLI nenhum DIO está configurado como entrada local ATRLI0 - o DIO0 não está configurado como entrada local Quando realiza a leitura de todos os DIO é enviado a leitura do menos significativo até o mais significativo, conforme a figura abaixo:

61 LSB MSB DIO0 DIO1 DIO2 DIO3 DIO4 DIO5 DIO6 DIO7 DIO8 DIO9 Exemplos: a. Ler todas as entradas locais (supondo que estejam todas em 0): Comando ATRLI Espaço RLI Espaço LF LF A T R L I 0x41 0x54 0x52 0x4C 0x49 0x0D Espaço Espaço O K LF 0x20 0x31 0x31 0x31 0x31 0x31 0x31 0x31 0x31 0x31 0x31 0x20 0x4F 0x4B 0x0A 0x0D

62 ATRLI b. Lendo o DIO9 (considerando que esteja em nível lógico alto) Comando ATRLI9 Espaço RLI9 Espaço LF 1 LF A T R L I 9 0x41 0x54 0x52 0x4C 0x49 0x39 0x0D

63 Espaço 1 O K LF 0x20 0x31 0x4F 0x4B 0x0A 0x0D ATRLI

64 19. ATWLOX Y Comando Tipo Faixa de Valores Valor Padrão ATWL0x y Escrita x = 0 a 9 e y = 0 a 1023 ou y=0/1 - x = 0 DIO0 x = 1 DIO1 x = 2 DIO2... x = 9 DIO9 Caso não seja enviado x, será escrito todos os DIO o valor de y Obs.: x = pino DIO e y = nível lógico a ser escrito no pino ou em todos os pinos Este comando realiza a escrita local das saídas. Exemplo de uso: ATWLO 0 todas as saídas em nível lógico baixo ATWLO 1023 todas as saídas em nível lógico alto, pois 1023 convertido para binário é ATWLO0 0 escreve no DIO0 nível lógico 0 ATWLO0 1 escreve no DIO0 nível lógico 1 Quando se realiza a escrita em todos os DIO s é enviado da seguinte forma: ATWLO convertido para binário fica , onde: DIO9 DIO8 DIO7 DIO6 DIO5 DIO4 DIO3 DIO2 DIO1 DIO

65 Exemplos: a. Configurando todas as saídas para nível lógico alto: Sabemos que o valor a ser configurado deve ser enviado em decimal, portanto, para termos todos os pinos em 1 devemos ter: DIO9 DIO8 DIO7 DIO6 DIO5 DIO4 DIO3 DIO2 DIO1 DIO Convertendo para decimal, fica: Comando Espaço y ATWLO 1023 Espaço LF LF A T W L 0 Espaço x41 0X54 0x57 0x4C 0x4F 0x20 0x31 0x30 0x32 0x33 0x0D

66 Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATWLO 1023 A partir desse momento todos os pinos que estão configurados como saída local vão para 1 b. Configurando a saída 8 para nível lógico baixo: Comando x Espaço y ATWLO 8 0 Espaço LF LF

67 A T W L 0 8 Espaço 0 0x41 0X54 0x57 0x4C 0x4F 0x38 0x20 0x30 0x0D Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATWLO8 0 A partir desse momento o DIO8 vai para nível lógico baixo

68 20. ATRLAX Comando Tipo Faixa de Valores Valor Padrão ATRLAx Leitura x = 0 a 5 - x = 0 AD0 x = 1 AD1 x = 2 AD2... x = 5 AD5 Caso não seja enviado x, será lido todos os AD s Obs.: x = pino AD Este comando lê entrada analógica local. Caso não seja enviado o parâmetro x, será lido todas as entradas analógicas. Se x for um parâmetro (entrada) válida, será lido somente esta entrada. Exemplos: ATRLA0 547 Faz a leitura do AD0, o módulo retorna o valor convertido em decimal. Caso o AD0 não seja entrada analógica, a resposta será: ATRLA0 É possível ainda ler todas as entradas, basta enviar somente ATRLA. ATRLA ADC0: 612 ADC1: 1023 ADC2:

69 ADC3: 10 ADC4: 55 ADC5: 20 Exemplos: a. Ler todas as entradas locais analógicas (supondo que estejam todas em 0): Comando ATRLA LF ADC0 Espaço Valor do ADC0 LF ADC0: 0 LF ADC1 Espaço Valor do ADC1 LF ADC1: 0 LF ADC2 Espaço Valor do ADC2 LF ADC2: 0 LF ADC3 Espaço Valor do ADC3 LF ADC3: 0 LF ADC4 Espaço Valor do ADC4 LF ADC4:

70 LF ADC5 Espaço Valor do ADC5 Espaço LF LF ADC5: 0 LF A T R L A 0x41 0x54 0x52 0x4C 0x41 0x0D LF A D C 0 : Espaço 0 0x0A 0x0D 0x41 0x44 0x43 0x30 0x3A 0x20 0x30 LF A D C 1 : Espaço 0 0x0A 0x0D 0x41 0x44 0x43 0x31 0x3A 0x20 0x30 LF A D C 2 : Espaço 0 0x0A 0x0D 0x41 0x44 0x43 0x32 0x3A 0x20 0x30 LF A D C 3 : Espaço 0 0x0A 0x0D 0x41 0x44 0x43 0x33 0x3A 0x20 0x30 LF A D C 4 : Espaço 0 0x0A 0x0D 0x41 0x44 0x43 0x34 0x3A 0x20 0x

71 LF 0x0A 0x0D A D C 5 : Espaço 0 Espaço O K LF 0x41 0x44 0x43 0x35 0x3A 0x20 0x30 0x20 0x4F 0x4B 0x0A 0x0D ATRLA ADC0: 0 ADC1: 0 ADC2: 0 ADC3: 0 ADC4: 0 ADC5: 0 b. Lendo o ADC5 (considerando que o ADC5 esteja com uma tensão de 1volt): Como o ADC do módulo é de 10bits, e considerando uma tensão de alimentação de 3,3volts, temos que o valor do ADC será: ADC =((2 10-1)/VCC)x1,65 = (1023/3,3)x1 = 310 Comando ATRLA5-71 -

72 Espaço ADC5 Espaço LF 310 LF A T R L A 5 0x41 0x54 0x52 0x4C 0x41 0x35 0x0D Espaço Espaço O K LF 0x20 0x30 0x31 0x30 0x20 0x4F 0x4B 0x0A 0x0D ATRLA

73 21. ATNS NÍVEL DO SINAL RECEBIDO Comando Tipo Faixa de Valores Valor Padrão ATNS Leitura 0 a 100% - Este comando retorna o nível de sinal recebido da média das últimas 4 mensagens. Este valor é mostrado de 0 a 100%. Este valor de nível de sinal recebido é calculado seguindo a seguinte tabela: Received Power (dbm) RSSI Value (hex) RSSI Value (dec) x x x x x x x x x x x x x x x x0D x x x1B x x x2B x x x3A x3F x x x4E x x x5F x x6B x6F x x x7D

74 -62 0x x x8A x8F x x x9F xA xAA xB xB xBC xC xC xCB xCF xD xD xDD xE xE xE xEF xF xFA xFD xFE xFF xFF xFF xFF xFF xFF xFF xFF xFF xFF xFF xFF xFF xFF xFF xFF 255 Sendo que o valor mostrado em % é calculado da seguinte forma: NS = RSSI(dec)/2.55 Caso deseja-se converter o valor em % para um valor em dbm, basta aplicar a seguinte fórmula: RSSI(dec) = NSx

75 Com o valor calculado do RSSI (dec), procure na tabela o valor mais próximo de Received Power (dbm). Exemplos: Lendo o nível de sinal recebido, considerando que este seja 50%: Comando ATNS Espaço NS Espaço LF 50% LF A T N S 0x41 0x54 0x4E 0x53 0x0D Espaço 5 0 % Espaço O K LF 0x20 0x35 0x30 0x25 0x20 0x4F 0x4B 0x0A 0x0D

76 ATNS 50%

77 22. ATIND INDICATION Comando Tipo Faixa de Valores Valor Padrão ATIND Escrita/Leitura 0 = desabilita 1 1=habilita Este comando habilita os pinos de indicação do módulo. São eles: Pino Nome Direção Descrição 6 IFALHA Saída Indicação de Falha na Comunicação 7 IRX Saída Indicação de dado recebido 20 REDE Saída Indicação de REDE O pino 6 (IFALHA) é colocado em nível lógico alto assim que acontece uma falha (FAIL). Por exemplo, caso o módulo envie uma mensagem com ACK habilitado e não receba a confirmação, este pino é colocado em nível lógico alto até que seja recebido um ACK ou o módulo seja reiniciado. O pino 7 (IRX) indica o recebimento de um pacote. Assim que um pacote é recebido este pino recebe um pulso. O pino 20 (REDE) indica que o módulo reconheceu outro módulo da mesma rede(id e do mesmo canal de operação). Sendo que este pino pode assumir os seguintes estados: Sinal Forte nível lógico alto Sinal Médio pulso de 300 ms Sinal Fraco pulso 800 ms Sem Sinal nível lógico baixo

78 Exemplos: a. Habilitando o modo indicação: Comando Espaço IND ATIND 1 Espaço LF LF A T I N D Espaço 1 0x41 0x54 0x49 0x4E 0x44 0x20 0x31 0x0D Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATIND

79 b. Desabilitando o modo de Indicação: Comando Espaço IND ATIND 0 Espaço LF LF A T I N D Espaço 0 0x41 0x54 0x49 0x4E 0x44 0x20 0x30 0x0D Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATIND

80 c. Ler o status do modo de indicação (supondo que esteja habilitado): Comando ATIND Espaço IND Espaço LF 1 LF A T I N D 0x41 0x54 0x49 0x4E 0x44 0x0D Espaço 1 Espaço O K LF 0x20 0x31 0x20 0x4F 0x4B 0x0A 0x0D ATIND

81 23. ATBAT BATERIA, LEITURA Comando Tipo Faixa de Valores Valor Padrão ATBAT Leitura 2,00 a 3,60 - Este comando retorna o valor em volts da tensão de alimentação do módulo. O módulo possui um conversor interno de 10bits que lê o nível de tensão de alimentação do módulo. Exemplos: Lendo o nível da bateria, considerando que esteja em 3,20volts: Comando ATBAT Espaço BAT Espaço LF 3,20[V] LF A T B A T 0x41 0x54 0x42 0x41 0x54 0x0D

82 Espaço 3, 2 0 [ V ] Espaço O K LF 0x20 0x33 0x2C 0x32 0x30 0x5B 0x56 0x5D 0x20 0x4F 0x4B 0x0A 0x0D ATBAT 3,20[V]

83 24. ATMSE Comando Tipo Faixa de Valores Valor Padrão ATMSE Escrita/Leitura 0 = desabilita 1 1=habilita Habilita a impressão de mensagens de status no modo modem(transparente), somente quando o ACK está habilitado e o módulo está configurado para enviar as mensagens para um módulo específico(não broadcast, ATDA 255). Quando o ACK está habilitado (ATAE 1) o módulo envia o pacote e aguarda o recebimento do ACK. Caso ocorra alguma falha na transmissão, ocorre o reenvio de acordo com os valores configurados em ATTR e ATNR. O módulo exibe localmente o número de tentativas de transmissão e o recebimento do ACK. A transmissão do pacote segue a seguinte lógica: A mensagem será enviada e aguardará confirmação de recebimento (ACK) Caso não chegue a confirmação de recebimento, a mensagem será reenviada por um número de vezes setado no comando ATNR. A mensagem é considerada perdida quando um timeout desta mensagem estoura, este timeout pode ser setado nos comandos ATTR. Caso a mensagem seja repetida o número de vezes setado via comando ATNR e não receba nenhuma confirmação está será considerada como Fail. Assim que o módulo recebe o ACK ou a acontece um FAIL, o módulo envia a mensagem de status para o pino de TX (se o parâmetro do ATMSE for 1): FAIL NR: 5 neste caso ocorreu uma falha. NR: 0 neste caso correu uma transmissão com sucesso sem nenhum retransmissão

84 Exemplos: a. Habilitando as mensagens de status: Comando Espaço MSE ATMSE 1 Espaço LF LF A T M S E Espaço 1 0x41 0x54 0x4D 0x53 0x45 0x20 0x31 0x0D Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATMSE

85 25. ATTN Comando Tipo Faixa de Valores Valor Padrão ATTN Escrita/Leitura 50 a = 50x10ms = 500ms 100 = 100x10ms = 1000ms 51 = 51x10ms = 510ms = 1000x10ms = 10000ms Este comando configura o tempo de envio dos pacotes de notificação utilizados para atualizar as saídas de indicação. Estes pacotes são utilizados para gerenciar a rede. O valor deste parâmetro deve ser o mesmo para todos os módulos de uma rede. Este pacote é somente enviado caso não haja nenhum fluxo de dados na rede. Quando o módulo está em modo sleep, estes pacotes não são enviados. Exemplos: a. Ler o valor do tempo de notificação (supondo que TN seja igual a 100): Comando ATTN Espaço TN Espaço LF 100 LF

86 A T T N 0x41 0x54 0x54 0x4E 0x0D Espaço 100 Espaço O K LF 0x20 0x31 0x30 0x30 0x20 0x4F 0x4B 0x0A 0x0D ATTN 100 b. Configurando o tempo de notificação para 10s: Sabemos que o valor a ser configurado em TN será multiplicado por 10ms, portanto, para termos um tempo de notificação de 10s, é necessário configurar TN com 1000, pois 1000x10ms = 10000ms = 10s. Comando Espaço TN ATTN 1000 Espaço LF LF

87 A T T N Espaço x41 0x54 0x54 0x4E 0x20 0x31 0x30 0x30 0x30 0x0D Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATTN

88 26. ATCN Comando Tipo Faixa de Valores Valor Padrão ATCN Escrita - - Este comando é enviado quando se deseja sair do modo de comando. Exemplo: Comando ATCN Espaço LF MODO DE COMANDO FINALIZADO LF LF MODO DE COMANDO FINALIZADO LF A T C N 0x41 0x54 0x43 0x4E 0x0D Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D

89 M O D O ESPAÇO 0x4D 0x4F 0x44 0x4F 0x20 D E ESPAÇO C O M A N D O 0x44 0x45 0x20 0x43 0x43 0x4E 0x41 0x4E 0x44 0x4F ESPAÇO F I N A L I Z A D O LF 0x20 0x46 0x49 0x4E 0x41 0x4C 0x49 0x5A 0x41 0x44 0x4F 0x0A 0x0D ATCN A partir desse ponto, todos os dados recebidos no pino DIN serão transmitidos pelo módulo MODO DE COMANDO FINALIZADO

90 27. ATMS Comando Tipo Faixa de Valores Valor Padrão ATMS Escrita/Leitura 0 = desabilita 2 1=habilita sleep sem modo periódico (somente por pino) 2=habilita sleep com modo periódico e envio de relatório Este comando seleciona as formas de operação do módulo em modo sleep. As formas de operação são: ATMS 0 Modo Sleep desabilitado ATMS 1 Modo Sleep habilitado sem modo periódico ATMS 2 Modo Sleep habilitado com modo periódico habilitado No modo ATMS 1(sleep habilitado sem modo periódico) o módulo irá entrar em sleep somente se o nível de tensão no pino ON/SLEEP (pino13) for baixo (0Volts) e irá sair do modo sleep somente se o nível de tensão no pino ON/SLEEP(pino 13) for alto(3,3volts). No modo ATMS 2(sleep habilitado com modo periódico) o módulo irá entrar em sleep somente se o nível de tensão no pino ON/SLEEP (pino13) for baixo (0Volts) e irá sair do modo sleep somente se o nível de tensão no pino ON/SLEEP(pino 13) for alto(3,3volts). Neste modo, o módulo envia periodicamente (valor configurado em ATTS) um relatório de suas entradas, bateria, endereço, etc. Exemplos: a. Ler o valor a configuração do sleep (supondo que o ATMS seja 2):

91 Comando ATMS Espaço MS Espaço LF 2 LF A T M S 0x41 0x54 0x4D 0x53 0x0D Espaço 2 Espaço O K LF 0x20 0x32 0x20 0x4F 0x4B 0x0A 0x0D ATMS

92 b. Desabilitando o sleep: Comando Espaço MS ATMS 0 Espaço LF LF A T M S Espaço 0 0x41 0x54 0x4D 0x53 0x20 0x30 0x0D Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATMS

93 28. ATTS Comando Tipo Faixa de Valores Valor Padrão ATTS Escrita/Leitura 0 a = 0x8,45s = 0s 1 = 1x8,45s = 8,45s 2 = 2x8,45s = 16,9s = 65535x8,45s = ,75s Este comando configura o tempo de Sleep caso esteja configurado como sleep com modo periódico e envio de relatório. Este tempo configurado será o valor do parâmetro multiplicado por 8,45s. A cada estouro deste tempo é enviado um relatório para o destino com as seguintes mensagens: Relatorio SADDR: 2 SINAL: 47% BAT: 3,26[V] ADC0: - ADC1: - ADC2: - ADC3: - ADC4:

94 ADC5: - DIO: Exemplos: a. Ler o valor do tempo de sleep (supondo que TS seja igual a 1): Comando ATTS Espaço TS Espaço LF 1 LF A T T S 0x41 0x54 0x54 0x53 0x0D Espaço 1 Espaço O K LF 0x20 0x31 0x20 0x4F 0x4B 0x0A 0x0D ATTS

95 b. Configurando o tempo de sleep para o mais próximo de 1 minuto: Sabemos que o valor a ser configurado em TS será multiplicado por 8,45s, portanto, para termos um tempo de 1minuto é necessário configurar TS com 7, pois 7x8,45ms = 59,15s 1 minuto. Comando Espaço TS ATTS 7 Espaço LF LF A T T S Espaço 7 0x41 0x54 0x54 0x53 0x20 0x37 0x0D Espaço O K LF 0x20 0x4F 0x4B 0x0A 0x0D ATTS

96 Fractum Indústria e Comércio de Equipamentos Eletrônicos LTDA - Av. Antônio Américo Junqueira 335 Pôr do Sol - Santa Rita do Sapucaí-MG - CEP TEL: Site: suporte@fractumrf.com