Análise detalhada do módulo UWB650 (Parte 5): Comandos de configuração

UWBRFAT

OK

UWBRFAT+VERSÃO?

V1.2

UWBRFAT+PADRÃO

OK

UWBRFAT+RESET

OK

UWBRFAT+FLASH

OK

Consulta

UWBRFAT+BAUDRATE?

+TAXA DE TRANSMISSÃO=

Definir

*UWBRFAT+BAUDRATE=

OK

Descrição

Tipo inteiro. Cada valor representa o número de série correspondente.
Taxa de transmissão da porta:

0:230400bps

1:115200bps ( Padrão )

2:57600bps

3,38400 bps

4,19200 bps

5,9600 bps

Nota: As demais configurações da porta serial do módulo são fixas: 8 bits de dados, 1 bit de parada, sem bit de paridade e sem controle de fluxo.

Exemplo

Consultar a taxa de transmissão (baud rate) atual da porta serial do módulo:

Enviar : UWBRFAT+BAUDRATE?

Resposta: +BAUDRATE=0

Defina a taxa de transmissão da porta serial do módulo para 9600: Enviar : UWBRFAT+BAUDRATE=5

Resposta: OK

Exemplo de erro :

Enviar : UWBRFAT+BAUDRATE=6

Resposta: Erro

Consulta

UWBRFAT+DATARATE?

+DATA=

Definir

*UWBRFAT+DATARATE=

OK

Descrição

Tipo inteiro. Valores diferentes representam taxas de dados aéreos diferentes.

0,850 Kbps

1: 6,8 Mbps ( Padrão )

Exemplo

Consultar a taxa de dados aéreos: Enviar : UWBRFAT+DATARATE?

Resposta: +DATATARATE=1

Defina a taxa de dados aéreos: Enviar : UWBRFAT+DATARATE=0

Resposta: OK

Exemplo de erro :

Enviar : UWBRFAT+DATARATE=2

Resposta: Erro

Consulta

UWBRFAT+DEVICEID?

+DEVICEID=,

Definir

*UWBRFAT+DEVICEID=,

OK

Descrição

: Tipo de caractere hexadecimal de 4 bytes. Intervalo: 0000-FFFE (Padrão: 0000)

: Tipo de caractere hexadecimal de 4 bytes. Intervalo: 0000-FFFE (Padrão: 0000)

Exemplo

Consulta de PAN ID e endereço: 

Enviar : UWBRFAT+DEVICEID?

Resposta: +DEVICEID=1234,5678

Defina o número PAN e o endereço: 

Enviar : UWBRFAT+DEVICEID=ABCD,1234

Resposta: OK

Exemplo de erro :

Enviar : UWBRFAT+DEVICEID=FFFF,FFFF

Resposta: Erro

Consulta

UWBRFAT+POWER?

+POTÊNCIA=

Definir

*UWBRFAT+POWER=

OK

Descrição

: Tipo inteiro. Intervalo: 0-10. Valores diferentes representam potências diferentes.Níveis :

Exemplo

Consultar a potência de transmissão do módulo: Enviar : UWBRFAT+POWER?

Resposta: +POWER=0

Defina a potência de transmissão: Enviar : UWBRFAT+POWER=10

Resposta: OK

Exemplo de erro :

Enviar : UWBRFAT+POWER=11

Resposta: Erro

Consulta

UWBRFAT+CÓDIGO DE PREÂMBULO?

+PREÂMBULO=

Definir

*UWBRFAT+PREAMBLECODE=

OK

Descrição

: Integer type. Range: 9-24 (Default: 9). UWB650 modules with different preamble code parameters cannot communicate.

Exemplo

Consultar o parâmetro do código de preâmbulo: Enviar : UWBRFAT+ PREAMBLECODE?

Resposta: +PREAMBLECODE=9

Defina o parâmetro do código de preâmbulo: Enviar : UWBRFAT+PREAMBLECODE=12

Resposta: OK

Exemplo de erro :

Enviar : UWBRFAT+PREAMBLECODE=3

Resposta: Erro

Consulta

UWBRFAT+CCAENABLE?

+CCAENABLE=

Definir

*UWBRFAT+CCAENABLE=

OK

Descrição

Tipo inteiro.

0: Desativar a função CCA (Padrão)

1: Ativar a função CCA

Esta função só é utilizada no modo de transmissão de dados. Após ativar o CCA, se o módulo detectar uma transmissão de dados em andamento no ar antes de enviar os dados normais, ele interromperá o envio. A porta serial responderá com a seguinte mensagem:

FALHA DA CCA

Exemplo

Verificar se a função CCA está ativada:

Enviar : UWBRFAT+ CCAENABLE?

Resposta: +CCAENABLE=0

Ativar a função CCA :

Enviar : UWBRFAT+CCAENABLE=1

Resposta: OK

Exemplo de erro :

Enviar : UWBRFAT+CCAENABLE=2

Resposta: Erro

Consulta

UWBRFAT+ACKENABLE?

+ACKENABLE=

Definir

*UWBRFAT+ACKENABLE=

OK

Descrição

Tipo inteiro.
0: Desativar solicitação de envio de ACK (Padrão)

1: Habilitar o envio de ACK Após habilitar o envio de ACK, todos os dados enviados pelo módulo no modo de transmissão de dados incluirão uma solicitação de ACK. Se nenhuma resposta de ACK for recebida, a porta serial responderá com o seguinte:

ACK TEMPO DE ESPERA

Se uma resposta ACK for recebida, a porta serial responderá com o seguinte:

ACK DETECTADO

Exemplo

Verificar se a função ACK está habilitada :

Enviar : UWBRFAT+ACKENABLE?

Resposta: +ACKENABLE=0

Ativar função ACK: Enviar : UWBRFAT+ACKENABLE=1

Resposta: OK

Exemplo de erro :

Enviar : UWBRFAT+ACKENABLE=2

Resposta: Erro

Consulta

UWBRFAT+SEGURANÇA?

+SEGURANÇA=,

Definir

*UWBRFAT+SEGURANÇA=,

OK

Descrição

Tipo inteiro.

0: Desativar a criptografia AES (Padrão)

1: Habilitar criptografia AES Após habilitar a criptografia AES, o conteúdo da carga útil do quadro enviado pelo módulo no modo de transmissão de dados será criptografado para uma transmissão de dados mais confiável.

Tipo de caractere hexadecimal. Comprimento: 32 bytes.

Padrão : 000102030405060708090A0B0C0D0E0F

Exemplo

Consulte o estado da função de criptografia AES e a chave:

Enviar : UWBRFAT+SEGURANÇA?

Resposta: +SEGURANÇA=0,00112233445566778899AABBCCDDEEFF

Ative a criptografia AES e defina a chave:

Enviar : UWBRFAT+SECURITY=1,112233445566778899AABBCCDDEEFF00

Resposta: OK

Exemplo de erro :

Enviar : UWBRFAT+SECURITY=112233445566778899AABBCCDDEEFF00

Resposta: Erro

Consulta

UWBRFAT+TXTARGET?

+TXTARGET=

Definir

*UWBRFAT+TXTARGET=

OK

Descrição

Exemplo

Consultar o destino de transmissão atual:

Enviar : UWBRFAT+TXTARGET?

Resposta: +TXTARGET=AB12

Modifique o alvo de transmissão atual:

Enviar : UWBRFAT+TXTARGET=1234

Resposta: OK

Exemplo de erro :

Enviar : UWBRFAT+TXTARGET=123

Resposta: Erro

Consulta

UWBRFAT+MESHENABLE?

+MESHENABLE=

Definir

*UWBRFAT+MESHENABLE=

OK

Descrição

Tipo inteiro.
0: Desativar função Mesh (Padrão)

1: Ativar a função Mesh; o módulo atuará apenas como um repetidor. 2: Ativar a função Mesh; o módulo atuará apenas como um nó.

3: Ative a função Mesh; o módulo pode atuar como repetidor e como nó. Observação: no modo Mesh, o tamanho máximo de um único pacote é de 1004 bytes. Módulos com a função Mesh ativada não podem enviar/receber dados comuns de módulos que não possuem a função Mesh ativada (exceto funções de localização/alcance).

Exemplo

Consultar o estado da função Mesh: Enviar : UWBRFAT+MESHENABLE?

Resposta: +MESHENABLE=0

Ative a função Mesh; o módulo atua como um nó: Enviar : UWBRFAT+MESHENABLE=2

Resposta: OK

Exemplo de erro : UWBRFAT+MESHENABLE=4

Resposta: Erro

Consulta

UWBRFAT+RXSHOWSRC?

+RXSHOWSRC=

Definir

*UWBRFAT+RXSHOWSRC=

OK

Descrição

Tipo inteiro.

0: Não exibir informações de endereço de origem 1: Exibir informações de endereço de origem (Padrão)

Nota: Após a ativação, quando o módulo receber dados normais, ele exibirá o endereço de origem e a intensidade do sinal.

Por exemplo, receber dados (123456789) de outro módulo (endereço 1234) com uma intensidade de sinal de -45,60dBm:

Endereço de origem: 1234; RSSI: -45,60 dBm; Dados: 123456789

Se o módulo tiver a funcionalidade Mesh ativada e estiver configurado como um nó, ele receberá dados no seguinte formato:

Endereço de origem da malha: 1234; Dados: 123456789

Exemplo

Consultar se deseja exibir as informações de endereço de origem:

Enviar : UWBRFAT+RXSHOWSRC?

Resposta: +RXSHOWSRC=0

Ativar a exibição das informações de endereço de origem:

Enviar : UWBRFAT+RXSHOWSRC=1

Resposta: OK

Exemplo de erro :

Enviar : UWBRFAT+RXSHOWSRC=2

Resposta: Erro

Consulta

UWBRFAT+LEDSTATUS?

+LEDSTATUS=

Definir

*UWBRFAT+LEDSTATUS=

OK

Descrição

Tipo inteiro.

0: Desativar indicador LED de status

1: Ativar indicador LED de status (Padrão)

Nota: Durante o funcionamento, uma luz vermelha intermitente indica que o módulo está transmitindo dados; uma luz azul intermitente indica que o módulo está recebendo dados, mas isso não significa necessariamente que dados estejam sendo recebidos.

Exemplo

Verifique se o indicador LED de status está ativado:

Enviar : UWBRFAT+LEDSTATUS?

Resposta: +LEDSTATUS=1

Desativar o indicador de status LED: Enviar : UWBRFAT+LEDSTATUS=0

Resposta: OK

Exemplo de erro :

Enviar : UWBRFAT+LEDSTATUS=2

Resposta: Erro

Consulta

UWBRFAT+RXENABLE?

+RXENABLE=

Definir

*UWBRFAT+RXENABLE=

OK

Descrição

Tipo inteiro.

0: Desativar o estado de recebimento 1: Ativar o estado de recebimento (Padrão)

Após desativar a recepção, o módulo entra no estado IDLE (inativo). Ele ainda pode enviar dados no modo de transmissão, mas não pode recebê-los. O consumo de energia será reduzido nesse estado.

Exemplo

Consultar se o estado de recebimento está habilitado:

Enviar : UWBRFAT+RXENABLE?

Resposta: +RXENABLE=1

Disable reception:
Send：UWBRFAT+RXENABLE=0

Response：OK

Error Example：

Send：UWBRFAT+RXENABLE=2

Response：Error

Query

UWBRFAT+SNIFFEN?

+SNIFFEN=

Set

*UWBRFAT+SNIFFEN=

OK

Description

: Integer type.

0: Disable Sniff Receive (Default)

1: Enable Sniff Receive

After the user enables Sniff Receive, the module will temporarily disable it when starting ranging/location functions. It will re-enable Sniff Receive after the function is closed.

Example

Query if Sniff Receive is enabled:

Send：UWBRFAT+SNIFFEN?

Response：+SNIFFEN=0

Disable reception:

Send：UWBRFAT+SNIFFEN=1

Response：OK

Error Example：

Send：UWBRFAT+SNIFFEN=2

Response：Error

Query

UWBRFAT+ANTDELAY?

+ANTDELAY=

Set

*UWBRFAT+ANTDELAY=

OK

Description

: Integer type. Range: 0-65535. Default: 16400. The module's antenna delay parameter.
The antenna delay parameter directly affects the error of ranging results in ranging and positioning functions. Calibrating the antenna delay makes the ranging result as close as possible to the actual distance.
When using our company's UWB antennas, the corresponding antenna delay parameters can be used for different models:

Please consult our company for specific parameters of each antenna model.
If you are not using our company's UWB antennas, you need to manually calibrate the antenna delay. Please refer to "How to Calibrate Antenna Delay for UWB650 Module.pdf" for how to calibrate.

Example

Query the antenna delay parameter:
Send：UWBRFAT+ANTDELAY?

Response：+ANTDELAY=16400

Set the antenna delay parameter:
Send：UWBRFAT+ANTDELAY=12345

Response：OK

Error Example：

Send：UWBRFAT+LEDSTATUS=123456

Response：Error

Set

UWBRFAT+RANGING=,

+RANGING=(),()

Description

: 4-byte hex type. The target address for ranging when the module acts as initiator. Range: 0000-FFFE. Multiple addresses can be entered, separated by commas. The number of addresses must match the value of theparameter.
The module will perform the ranging process with the target modules in the order of the addresses in the command and output the ranging information together upon completion.
: Floating-point string type. Distance information output after ranging completes. Up to 2 decimal places. If ranging fails, this value will be -1.

: Floating-point string type. Signal strength information of the other end output after ranging completes. Up to 2 decimal places.
Note: After receiving the ranging signal from the host, the other end will output the ranging information once the ranging is completed.

Example

Obtenha a distância até o módulo com endereço 0001: Enviar : UWBRFAT+RANGING=1,0001

Resposta: +RANGING=(12,34),(-56,78)

Obtenção das informações de alcance fornecidas pelo módulo com endereço 0001: Obtenção simultânea das distâncias para os módulos com endereços 0002 e 0003:

Enviar : UWBRFAT+RANGING=2,0002,0003

Resposta: +RANGING=(34.12,26.17),(-53.23,-49.15)

Obtenho a distância até o módulo com endereço 0004, mas a medição de distância falha:

Enviar : UWBRFAT+RANGING=1,0004

Resposta: +RANGING=(-1),(0.00)

Exemplo de erro :

Enviar : UWBRFAT+RANGING=123,456

Resposta: Erro

Definir

UWBRFAT+LOCATION=

+LOCALIZAÇÃO=(,,),(),()

Descrição

: Tipo hexadecimal de 4 bytes. Os endereços de ancoragem de destino para posicionamento quando o módulo atua como uma Tag. Intervalo: 0000-FFFE. São necessários no mínimo 3 endereços, podendo ser inseridos até 8 (separados por vírgulas).
O módulo iniciará o processo de posicionamento com as âncoras alvo e exibirá o resultado do posicionamento após a conclusão do processo.

: A coordenada x atual calculada do próprio objeto após a conclusão do posicionamento. Até 2 casas decimais, unidade em metros (m).

: A coordenada y atual calculada do próprio objeto após a conclusão do posicionamento. Até 2 casas decimais, unidade em metros (m).

: A coordenada z atual calculada do próprio objeto após a conclusão do posicionamento. Até 2 casas decimais, unidade em metros (m).

Tipo de string de ponto flutuante. Informações de distância exibidas após a conclusão do posicionamento. Até 2 casas decimais. Se a aquisição falhar, esse valor será -1.

: Tipo de string de ponto flutuante. Informação da intensidade do sinal da outra extremidade após a conclusão da medição de distância. Até 2 casas decimais. Se a aquisição de distância falhar, este valor será 0.

Exemplo

Com 3 âncoras próximas (0001, 0002, 0003), obtenha a posição relativa a essas âncoras: Enviar : UWBRFAT+LOCATION=0001,0002,0003

Resposta: +LOCATION=(12.34,34.56,56.78),(11.22,33.44,55.66),(-45.45,-56.56,-67.67)

Exemplo de erro (Número insuficiente de endereços de âncora inseridos): Enviar : UWBRFAT+RANGING=0001,0002

Resposta: Erro

Consulta

UWBRFAT+COORDENAR?

+COORDENADAS=,,

Definir

*UWBRFAT+COORDENADAS=,,

OK

Descrição

: Tipo inteiro. Coordenada x da âncora, em centímetros. Intervalo: 0-100000 (Padrão: 0)
: Tipo inteiro. Coordenada y da âncora, em centímetros. Intervalo: 0-100000 (Padrão: 0)
: Tipo inteiro. Coordenada z da âncora, unidade em cm. Intervalo: 0-100000 (Padrão: 0)

Exemplo

Consultar as coordenadas do próprio módulo quando este atua como âncora: Enviar : UWBRFAT+COORDINAÇÃO?

Resposta: +COORDENADA=12345,0,54321

Defina as coordenadas do módulo: Enviar : UWBRFAT+COORDINATE=12345,54321,100

Resposta: OK

Consulta

UWBRFAT+DISTOFFSET?

+DISTOFFSET=

Definir

*UWBRFAT+DISTOFFSET=

OK

Descrição

: Tipo inteiro. Intervalo: -500~500. Valor padrão: 0. Define o valor de deslocamento para os resultados de alcance ao usar funções de alcance ou posicionamento. Unidade: cm.
Quando o valor de deslocamento definido for positivo, o módulo adicionará esse deslocamento ao resultado do intervalo; quando o valor for negativo, ele subtrairá o deslocamento.

Exemplo

Consultar o valor de deslocamento de alcance: Enviar : UWBRFAT+DISTOFFSET?

Resposta: +DISTOFFSET=34

Defina o valor de deslocamento de alcance: Enviar : UWBRFAT+DISTOFFSET=100

Resposta: OK