Углубленный анализ модуля UWB650 (часть 5): команды настройки

UWBRFAT

ХОРОШО

UWBRFAT+ВЕРСИЯ?

В1.2

UWBRFAT+DEFAULT

ХОРОШО

UWBRFAT+RESET

ХОРОШО

UWBRFAT+FLASH

ХОРОШО

Запрос

UWBRFAT+BAUDRATE?

+СКОРОСТЬ ПЕРЕДАЧИ ДАННЫХ=

Набор

*UWBRFAT+СКОРОСТЬ ПЕРЕДАЧИ ДАННЫХ=

ХОРОШО

Описание

: Целочисленный тип. Каждое значение представляет собой соответствующий серийный номер.
Скорость передачи данных порта:

0:230400бит/с

1:115200 бит/с ( по умолчанию )

2:57600 бит/с

3,38400 бит/с

4,19200 бит/с

5,9600 бит/с

Примечание: Другие конфигурации последовательного порта модуля фиксированы: 8 бит данных, 1 стоповый бит, без бита четности, без управления потоком.

Пример

Запросить текущую скорость передачи данных последовательного порта модуля:

Отправить ：UWBRFAT+BAUDRATE?

Ответ: +СКОРОСТЬ ПЕРЕДАЧИ ДАННЫХ=0

Установите скорость передачи данных последовательного порта модуля на 9600: Отправьте ：UWBRFAT+BAUDRATE=5

Ответ：ОК

Пример ошибки ：

Отправить ：UWBRFAT+BAUDRATE=6

Ответ：Ошибка

Запрос

UWBRFAT+DATARATE?

+ДАТА=

Набор

*UWBRFAT+DATARATE=

ХОРОШО

Описание

: Целочисленный тип. Различные значения соответствуют разным скоростям передачи данных по воздуху.

0:850Кбит/с

1:6,8 Мбит/с ( по умолчанию )

Пример

Запросить скорость передачи данных по воздуху: Отправить ：UWBRFAT+DATARATE?

Ответ: +DATARATE=1

Установите скорость передачи данных по воздуху: Отправить ：UWBRFAT+DATARATE=0

Ответ：ОК

Пример ошибки ：

Отправить ：UWBRFAT+DATARATE=2

Ответ：Ошибка

Запрос

UWBRFAT+DEVICEID?

+DEVICEID=,

Набор

*UWBRFAT+DEVICEID=,

ХОРОШО

Описание

: 4-байтовый шестнадцатеричный символ. Диапазон: 0000-FFFE (по умолчанию: 0000).

: 4-байтовый шестнадцатеричный символ. Диапазон: 0000-FFFE (по умолчанию: 0000).

Пример

Запрос PAN ID и адреса： 

Отправить ：UWBRFAT+DEVICEID?

Ответ: +DEVICEID=1234,5678

Установить PAN ID и адрес： 

Отправить ：UWBRFAT+DEVICEID=ABCD,1234

Ответ：ОК

Пример ошибки ：

Отправить ：UWBRFAT+DEVICEID=FFFF,FFFF

Ответ：Ошибка

Запрос

UWBRFAT+POWER?

+СИЛА=

Набор

*UWBRFAT+POWER=

ХОРОШО

Описание

: Целое число. Диапазон: от 0 до 10. Разные значения соответствуют разной мощности.Уровни :

Пример

Запросить мощность передачи модуля: Отправить ：UWBRFAT+POWER?

Ответ: +МОЩНОСТЬ=0

Установите мощность передачи: Отправить ：UWBRFAT+POWER=10

Ответ：ОК

Пример ошибки ：

Отправить ：UWBRFAT+POWER=11

Ответ：Ошибка

Запрос

UWBRFAT+ПРЕАМБЛЕКОД?

+ПРЕАМБЛЕКОД=

Набор

*UWBRFAT+ПРЕАМБЛЕКОД=

ХОРОШО

Описание

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

Пример

Запрос параметра кода преамбулы: Отправить ：UWBRFAT+ PREABLECODE？

Ответ: +ПРЕАМБЛЕКОД=9

Установите параметр кода преамбулы: Отправить ：UWBRFAT+PREAMBLECODE=12

Ответ：ОК

Пример ошибки ：

Отправить ：UWBRFAT+PREABLECODE=3

Ответ：Ошибка

Запрос

UWBRFAT+CCAENABLE?

+CCAENABLE=

Набор

*UWBRFAT+CCAENABLE=

ХОРОШО

Описание

: Целочисленный тип.

0: Отключить функцию CCA (по умолчанию)

1: Включить функцию CCA

Эта функция используется только в режиме передачи данных. После включения CCA, если модуль обнаруживает передачу данных в эфире до отправки обычных данных, он прекращает передачу. Последовательный порт ответит следующим образом:

ОТКАЗ CCA

Пример

Запросить, включена ли функция CCA:

Отправить ：UWBRFAT+ CCAENABLE?

Ответ: +CCAENABLE=0

Включить функцию CCA :

Отправить ：UWBRFAT+CCAENABLE=1

Ответ：ОК

Пример ошибки ：

Отправить ：UWBRFAT+CCAENABLE=2

Ответ：Ошибка

Запрос

UWBRFAT+ACKENABLE?

+ПОДТВЕРЖДАЕМЫЙ=

Набор

*UWBRFAT+ACKENABLE=

ХОРОШО

Описание

: Целочисленный тип.
0: Отключить запрос на отправку ACK (по умолчанию)

1: Включить запрос ACK-отправки. После включения запроса ACK-отправки все данные, отправляемые модулем в режиме передачи данных, будут включать запрос ACK. Если ответ ACK не получен, последовательный порт выдаст следующее сообщение:

ТАЙМ-АУТ ОЖИДАНИЯ ПОДТВЕРЖДЕНИЯ

Если получен ответ ACK, последовательный порт ответит следующим образом:

ACK ОБНАРУЖЕН

Пример

Запросить, включена ли функция ACK :

Отправить ：UWBRFAT+ACKENABLE?

Ответ: +ACKENABLE=0

Включить функцию ACK: Отправить ：UWBRFAT+ACKENABLE=1

Ответ：ОК

Пример ошибки ：

Отправить ：UWBRFAT+ACKENABLE=2

Ответ：Ошибка

Запрос

UWBRFAT+БЕЗОПАСНОСТЬ?

+БЕЗОПАСНОСТЬ=,

Набор

*UWBRFAT+БЕЗОПАСНОСТЬ=,

ХОРОШО

Описание

: Целочисленный тип.

0: Отключить шифрование AES (по умолчанию)

1: Включить шифрование AES После включения шифрования AES содержимое полезной нагрузки кадра, отправляемое модулем в режиме передачи данных, будет зашифровано для более надежной передачи данных.

: Шестнадцатеричный тип символов. Длина — 32 байта.

По умолчанию : 000102030405060708090A0B0C0D0E0F

Пример

Запросить статус функции шифрования AES и ключа:

Отправить ：UWBRFAT+SECURITY?

Ответ: +БЕЗОПАСНОСТЬ=0,00112233445566778899AABBCCDDEEFF

Включите шифрование AES и задайте ключ:

Отправить ：UWBRFAT+SECURITY=1,112233445566778899AABBCCDDEEFF00

Ответ：ОК

Пример ошибки ：

Отправить ：UWBRFAT+SECURITY=112233445566778899AABBCCDDEEFF00

Ответ：Ошибка

Запрос

UWBRFAT+TXTARGET?

+TXTARGET=

Набор

*UWBRFAT+TXTARGET=

ХОРОШО

Описание

Пример

Запросить текущую цель передачи:

Отправить ：UWBRFAT+TXTARGET?

Ответ: +TXTARGET=AB12

Изменить текущую цель передачи:

Отправить ：UWBRFAT+TXTARGET=1234

Ответ：ОК

Пример ошибки ：

Отправить ：UWBRFAT+TXTARGET=123

Ответ：Ошибка

Запрос

UWBRFAT+СЕТЧАТЫЙ?

+СЕТЧАТЫЙ=

Набор

*UWBRFAT+СЕТЧАТЫЙ=

ХОРОШО

Описание

: Целочисленный тип.
0: Отключить функцию сетки (по умолчанию)

1: Включить функцию Mesh, модуль действует только как реле 2: Включить функцию Mesh, модуль действует только как узел

3: Включить функцию Mesh, модуль может работать как ретранслятор и как узел. Примечание: В режиме Mesh максимальный размер одного пакета составляет 1004 байта. Модули с включённой функцией Mesh не могут отправлять/получать обычные данные с модулями, у которых функция Mesh не включена (функции определения дальности/локации исключены).

Пример

Запросить статус функции сетки: Отправить ：UWBRFAT+MESHENABLE?

Ответ: +MESHENABLE=0

Включить функцию сетки, модуль действует как узел: Отправить ：UWBRFAT+MESHENABLE=2

Ответ：ОК

Пример ошибки : UWBRFAT+MESHENABLE=4

Ответ：Ошибка

Запрос

UWBRFAT+RXSHOWSRC?

+RXSHOWSRC=

Набор

*UWBRFAT+RXSHOWSRC=

ХОРОШО

Описание

: Целочисленный тип.

0: Не отображать информацию об адресе источника 1: Отображать информацию об адресе источника (по умолчанию)

Примечание: После включения, когда модуль получает нормальные данные, он отображает адрес источника и уровень сигнала.

Например, получение данных (123456789) от другого модуля (адрес 1234) с уровнем сигнала -45,60 дБм:

SrcAddr:1234;Rssi:-45.60dBm;Data:123456789

Если в модуле включена функция Mesh и он настроен как узел, он будет получать данные в следующем формате:

Mesh SrcAddr:1234;Data:123456789

Пример

Запросить, отображать ли информацию об адресе источника:

Отправить ：UWBRFAT+RXSHOWSRC?

Ответ: +RXSHOWSRC=0

Включить отображение информации об адресе источника:

Отправить ：UWBRFAT+RXSHOWSRC=1

Ответ：ОК

Пример ошибки ：

Отправить ：UWBRFAT+RXSHOWSRC=2

Ответ：Ошибка

Запрос

UWBRFAT+LEDSTATUS?

+LEDSTATUS=

Набор

*UWBRFAT+LEDSTATUS=

ХОРОШО

Описание

: Целочисленный тип.

0: Отключить светодиодный индикатор состояния

1: Включить светодиодный индикатор состояния (по умолчанию)

Примечание: Во время работы мигающий красный индикатор указывает на то, что модуль передает данные; мигающий синий индикатор указывает на то, что модуль находится в состоянии приема, но не обязательно означает, что данные принимаются.

Пример

Запросить, включен ли светодиодный индикатор состояния:

Отправить ：UWBRFAT+LEDSTATUS?

Ответ: +LEDSTATUS=1

Отключить светодиодный индикатор состояния: Отправить ：UWBRFAT+LEDSTATUS=0

Ответ：ОК

Пример ошибки ：

Отправить ：UWBRFAT+LEDSTATUS=2

Ответ：Ошибка

Запрос

UWBRFAT+RXENABLE?

+RXENABLE=

Набор

*UWBRFAT+RXENABLE=

ХОРОШО

Описание

: Целочисленный тип.

0: Отключить состояние приема 1: Включить состояние приема (по умолчанию)

После отключения приёма модуль переходит в состояние IDLE. Он по-прежнему может отправлять данные в режиме передачи данных, но не может принимать их. Потребление энергии в этом состоянии снижается.

Пример

Запросить, включено ли состояние приема:

Отправить ：UWBRFAT+RXENABLE?

Ответ: +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

Получить расстояние до модуля с адресом 0001: Отправить ：UWBRFAT+RANGING=1,0001

Ответ: +ДИАПАЗОН=(12.34),(-56.78)

Вывод информации о дальности модулем с адресом 0001: Одновременно получить расстояния до модулей с адресами 0002 и 0003:

Отправить ：UWBRFAT+RANGING=2,0002,0003

Ответ: +ДИАПАЗОН=(34.12;26.17),(-53.23;-49.15)

Получите расстояние до модуля с адресом 0004, но определение дальности не удалось:

Отправить ：UWBRFAT+RANGING=1,0004

Ответ: +ДИАПАЗОН=(-1),(0.00)

Пример ошибки ：

Отправить ：UWBRFAT+RANGING=123,456

Ответ：Ошибка

Набор

UWBRFAT+РАСПОЛОЖЕНИЕ=

+МЕСТОПОЛОЖЕНИЕ=(,,),(),()

Описание

: 4-байтовый шестнадцатеричный тип. Целевые якорные адреса для позиционирования, когда модуль действует как тег. Диапазон: 0000-FFFE. Требуется не менее 3 адресов, можно ввести до 8 (через запятую).
Модуль инициирует процесс позиционирования с целевыми якорями и выводит результат позиционирования после завершения процесса.

: Текущая вычисленная координата X после завершения позиционирования. До двух знаков после запятой, единица измерения — метры (м).

: Текущая вычисленная координата Y после завершения позиционирования. До двух знаков после запятой, единица измерения — метры (м).

: Текущая вычисленная Z-координата объекта после завершения позиционирования. До двух знаков после запятой, единица измерения — метры (м).

: Строка с плавающей точкой. Информация о расстоянии выводится после завершения позиционирования. До 2 знаков после запятой. В случае сбоя получения это значение будет равно -1.

: Строка с плавающей точкой. Информация об уровне сигнала на другом конце выводится после завершения измерения. До 2 знаков после запятой. Если расстояние определить не удалось, это значение будет равно 0.

Пример

Имея 3 якоря поблизости (0001, 0002, 0003), получите относительное положение этих якорей: Отправить ：UWBRFAT+LOCATION=0001,0002,0003

Ответ: +МЕСТОПОЛОЖЕНИЕ=(12.34,34.56,56.78),(11.22,33.44,55.66),(-45.45,-56.56,-67.67)

Пример ошибки (недостаточное количество введенных адресов якорей): Отправить ：UWBRFAT+RANGING=0001,0002

Ответ：Ошибка

Запрос

UWBRFAT+КООРДИНАТЫ?

+КООРДИНАТА=,,

Набор

*UWBRFAT+КООРДИНАТЫ=,,

ХОРОШО

Описание

: Целое число. Координата X точки привязки, единица измерения — см. Диапазон: 0–100000 (по умолчанию: 0).
: Целое число. Координата Y точки привязки, единица измерения — см. Диапазон: 0–100000 (по умолчанию: 0).
: Целое число. Z-координата якоря, единица измерения — см. Диапазон: 0–100000 (по умолчанию: 0).

Пример

Запросить собственные координаты модуля, выступающего в роли якоря: Отправить ：UWBRFAT+COORDINATE?

Ответ: +КООРДИНАТА=12345,0,54321

Установите собственные координаты модуля: Отправить ：UWBRFAT+COORDINATE=12345,54321,100

Ответ：ОК

Запрос

UWBRFAT+DISTOFFSET?

+DISTOFFSET=

Набор

*UWBRFAT+DISTOFFSET=

ХОРОШО

Описание

: Целое число. Диапазон: от -500 до 500. Значение по умолчанию: 0. Задаёт значение смещения для результатов ранжирования при использовании функций ранжирования или позиционирования. Единица измерения: см.
Если заданное значение смещения положительное, модуль добавит это смещение к результату ранжирования; если значение отрицательное, он вычтет смещение.

Пример

Запрос значения смещения диапазона: Отправить ：UWBRFAT+DISTOFFSET?

Ответ: +DISTOFFSET=34

Установите значение смещения диапазона: Отправить ：UWBRFAT+DISTOFFSET=100

Ответ：ОК