Detaillierte Analyse des UWB650-Moduls (Teil 5): Konfigurationsbefehle

UWBRFAT

OK

UWBRFAT+VERSION?

V1.2

UWBRFAT+DEFAULT

OK

UWBRFAT+RESET

OK

UWBRFAT+FLASH

OK

Abfrage

UWBRFAT+BAUDRATE?

+BAUDRATE=

Satz

*UWBRFAT+BAUDRATE=

OK

Beschreibung

Ganzzahliger Datentyp. Jeder Wert repräsentiert die entsprechende Seriennummer.
Port-Baudrate:

0:230400 bps

1:115200 bps ( Standard )

2:57600 bps

3,38400 bps

4,19200 bps

5,9600 bps

Hinweis: Andere Konfigurationen des seriellen Ports des Moduls sind festgelegt: 8 Datenbits, 1 Stoppbit, kein Paritätsbit, keine Flusssteuerung.

Beispiel

Abfrage der aktuellen Baudrate des seriellen Ports des Moduls:

Senden : UWBRFAT+BAUDRATE?

Antwort: +BAUDRATE=0

Stellen Sie die Baudrate der seriellen Schnittstelle des Moduls auf 9600 ein: Senden : UWBRFAT+BAUDRATE=5

Antwort: OK

Fehlerbeispiel :

Senden : UWBRFAT+BAUDRATE=6

Antwort: Fehler

Abfrage

UWBRFAT+DATARATE?

+DATARATE=

Satz

*UWBRFAT+DATARATE=

OK

Beschreibung

Ganzzahliger Datentyp. Unterschiedliche Werte repräsentieren unterschiedliche Luftdatenraten.

0,850 Kbps

1:6,8 Mbit/s ( Standard )

Beispiel

Abfrage der Luftdatenrate: Senden : UWBRFAT+DATARATE?

Antwort: +DATARATE=1

Stellen Sie die Luftdatenrate ein: Senden : UWBRFAT+DATARATE=0

Antwort: OK

Fehlerbeispiel :

Senden : UWBRFAT+DATARATE=2

Antwort: Fehler

Abfrage

UWBRFAT+Geräte-ID?

+Geräte-ID=,

Satz

*UWBRFAT+DEVICEID=,

OK

Beschreibung

: 4-Byte-Hexadezimalzeichen. Bereich: 0000–FFFE (Standard: 0000)

: 4-Byte-Hexadezimalzeichen. Bereich: 0000–FFFE (Standard: 0000)

Beispiel

Abfrage von PAN-ID und Adresse: 

Senden : UWBRFAT+Geräte-ID?

Antwort: +DEVICEID=1234,5678

PAN-ID und Adresse festlegen : 

Senden : UWBRFAT+DEVICEID=ABCD,1234

Antwort: OK

Fehlerbeispiel :

Senden : UWBRFAT+DEVICEID=FFFF,FFFF

Antwort: Fehler

Abfrage

UWBRFAT+POWER?

+LEISTUNG=

Satz

*UWBRFAT+POWER=

OK

Beschreibung

Ganzzahliger Datentyp. Wertebereich: 0–10. Unterschiedliche Werte repräsentieren unterschiedliche Potenzen.Level :

Beispiel

Sendeleistung des Moduls abfragen: Senden : UWBRFAT+POWER?

Antwort: +LEISTUNG=0

Sendeleistung einstellen: Senden : UWBRFAT+POWER=10

Antwort: OK

Fehlerbeispiel :

Senden : UWBRFAT+POWER=11

Antwort: Fehler

Abfrage

UWBRFAT+PRÄAMBELCODE?

+PRÄAMBELCODE=

Satz

*UWBRFAT+PRÄAMBELCODE=

OK

Beschreibung

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

Beispiel

Präambelcode-Parameter abfragen: Senden : UWBRFAT+PRÄAMBELCODE?

Antwort: +PRÄAMBELCODE=9

Präambelcode-Parameter festlegen: Senden : UWBRFAT+PREAMBLECODE=12

Antwort: OK

Fehlerbeispiel :

Senden : UWBRFAT+PRÄAMBELCODE=3

Antwort: Fehler

Abfrage

UWBRFAT+CCAENABLE?

+CCAENABLE=

Satz

*UWBRFAT+CCAENABLE=

OK

Beschreibung

Ganzzahliger Datentyp.

0: CCA-Funktion deaktivieren (Standard)

1: CCA-Funktion aktivieren

Diese Funktion wird nur im Datenübertragungsmodus verwendet. Nach Aktivierung von CCA stoppt das Modul die Übertragung, wenn es vor dem Senden normaler Daten eine laufende Datenübertragung erkennt. Die serielle Schnittstelle antwortet mit Folgendem:

CCA-Fehler

Beispiel

Abfrage, ob die CCA-Funktion aktiviert ist:

Senden : UWBRFAT+ CCAENABLE?

Antwort: +CCAENABLE=0

CCA-Funktion aktivieren :

Senden : UWBRFAT+CCAENABLE=1

Antwort: OK

Fehlerbeispiel :

Senden : UWBRFAT+CCAENABLE=2

Antwort: Fehler

Abfrage

UWBRFAT+ACKENABLE?

+ACKENABLE=

Satz

*UWBRFAT+ACKENABLE=

OK

Beschreibung

Ganzzahliger Datentyp.
0: ACK-Sendeanforderung deaktivieren (Standard)

1: ACK-Sendeanforderung aktivieren Nach der Aktivierung der ACK-Sendeanforderung enthalten alle vom Modul im Datenübertragungsmodus gesendeten Daten eine ACK-Anforderung. Wird keine ACK-Antwort empfangen, antwortet die serielle Schnittstelle mit Folgendem:

ACK WARTEN TIMEOUT

Wird eine ACK-Antwort empfangen, antwortet die serielle Schnittstelle mit Folgendem:

Bestätigung empfangen

Beispiel

Abfrage, ob die ACK-Funktion aktiviert ist :

Senden : UWBRFAT+ACKENABLE?

Antwort: +ACKENABLE=0

ACK-Funktion aktivieren: Senden : UWBRFAT+ACKENABLE=1

Antwort: OK

Fehlerbeispiel :

Senden : UWBRFAT+ACKENABLE=2

Antwort: Fehler

Abfrage

UWBRFAT+SICHERHEIT?

+SICHERHEIT=,

Satz

*UWBRFAT+SECURITY=,

OK

Beschreibung

Ganzzahliger Datentyp.

0: AES-Verschlüsselung deaktivieren (Standard)

1: AES-Verschlüsselung aktivieren Nach der Aktivierung der AES-Verschlüsselung wird der vom Modul im Datenübertragungsmodus gesendete Frame-Payload-Inhalt verschlüsselt, um eine zuverlässigere Datenübertragung zu gewährleisten.

Hexadezimaler Zeichentyp. Länge: 32 Byte.

Standardwert : 000102030405060708090A0B0C0D0E0F

Beispiel

Abfrage des Status der AES-Verschlüsselungsfunktion und des Schlüssels:

Senden : UWBRFAT+SECURITY?

Antwort: +SECURITY=0,00112233445566778899AABBCCDDEEFF

Aktivieren Sie die AES-Verschlüsselung und legen Sie den Schlüssel fest:

Senden : UWBRFAT+SECURITY=1,112233445566778899AABBCCDDEEFF00

Antwort: OK

Fehlerbeispiel :

Senden : UWBRFAT+SECURITY=112233445566778899AABBCCDDEEFF00

Antwort: Fehler

Abfrage

UWBRFAT+TXTARGET?

+TXTARGET=

Satz

*UWBRFAT+TXTARGET=

OK

Beschreibung

Beispiel

Abfrage des aktuellen Übertragungsziels:

Senden : UWBRFAT+TXTARGET?

Antwort: +TXTARGET=AB12

Ändern Sie das aktuelle Übertragungsziel:

Senden : UWBRFAT+TXTARGET=1234

Antwort: OK

Fehlerbeispiel :

Senden : UWBRFAT+TXTARGET=123

Antwort: Fehler

Abfrage

UWBRFAT+MESHENABLE?

+MESHENBAR=

Satz

*UWBRFAT+MESHENABLE=

OK

Beschreibung

Ganzzahliger Datentyp.
0: Mesh-Funktion deaktivieren (Standard)

1: Mesh-Funktion aktivieren, Modul fungiert nur als Relais. 2: Mesh-Funktion aktivieren, Modul fungiert nur als Knoten.

3: Aktivieren Sie die Mesh-Funktion. Das Modul kann dann sowohl als Relais als auch als Knoten fungieren. Hinweis: Im Mesh-Modus beträgt die maximale Paketgröße 1004 Byte. Module mit aktiviertem Mesh können keine normalen Daten mit Modulen ohne aktiviertes Mesh senden oder empfangen (Bereichs- und Ortungsfunktionen sind ausgenommen).

Beispiel

Status der Mesh-Funktion abfragen: Senden : UWBRFAT+MESHENABLE?

Antwort: +MESHENABLE=0

Mesh-Funktion aktivieren, Modul fungiert als Knoten: Senden : UWBRFAT+MESHENABLE=2

Antwort: OK

Fehlerbeispiel : UWBRFAT+MESHENABLE=4

Antwort: Fehler

Abfrage

UWBRFAT+RXSHOWSRC?

+RXSHOWSRC=

Satz

*UWBRFAT+RXSHOWSRC=

OK

Beschreibung

Ganzzahliger Datentyp.

0: Quelladressinformationen nicht anzeigen 1: Quelladressinformationen anzeigen (Standard)

Hinweis: Nach der Aktivierung zeigt das Modul beim Empfang normaler Daten die Quelladresse und die Signalstärke an.

Zum Beispiel der Empfang von Daten (123456789) von einem anderen Modul (Adresse 1234) mit einer Signalstärke von -45,60dBm:

Quelladresse: 1234; RSSI: -45,60 dBm; Daten: 123456789

Wenn das Modul über eine aktivierte Mesh-Funktion verfügt und als Knoten konfiguriert ist, empfängt es Daten im folgenden Format:

Mesh SrcAddr:1234;Data:123456789

Beispiel

Abfrage, ob Quelladressinformationen angezeigt werden sollen:

Senden : UWBRFAT+RXSHOWSRC?

Antwort: +RXSHOWSRC=0

Anzeige der Quelladressinformationen aktivieren:

Senden : UWBRFAT+RXSHOWSRC=1

Antwort: OK

Fehlerbeispiel :

Senden : UWBRFAT+RXSHOWSRC=2

Antwort: Fehler

Abfrage

UWBRFAT+LEDSTATUS?

+LEDSTATUS=

Satz

*UWBRFAT+LEDSTATUS=

OK

Beschreibung

Ganzzahliger Datentyp.

0: LED-Statusanzeige deaktivieren

1: LED-Statusanzeige aktivieren (Standard)

Hinweis: Während des Betriebs zeigt ein blinkendes rotes Licht an, dass das Modul Daten sendet; ein blinkendes blaues Licht zeigt an, dass sich das Modul im Empfangszustand befindet, was jedoch nicht unbedingt bedeutet, dass Daten empfangen werden.

Beispiel

Abfrage, ob die LED-Statusanzeige aktiviert ist:

Senden : UWBRFAT+LEDSTATUS?

Antwort: +LEDSTATUS=1

LED-Statusanzeige deaktivieren: Senden : UWBRFAT+LEDSTATUS=0

Antwort: OK

Fehlerbeispiel :

Senden : UWBRFAT+LEDSTATUS=2

Antwort: Fehler

Abfrage

UWBRFAT+RXENABLE?

+RXENABLE=

Satz

*UWBRFAT+RXENABLE=

OK

Beschreibung

Ganzzahliger Datentyp.

0: Empfangszustand deaktivieren 1: Empfangszustand aktivieren (Standard)

Nach Deaktivierung des Empfangs wechselt das Modul in den Leerlaufzustand. Es kann weiterhin Daten im Datenübertragungsmodus senden, aber keine Daten empfangen. In diesem Zustand wird der Stromverbrauch reduziert.

Beispiel

Abfrage, ob der Empfangsstatus aktiviert ist:

Senden : UWBRFAT+RXENABLE?

Antwort: +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

Ermitteln Sie die Entfernung zum Modul mit der Adresse 0001: Senden Sie : UWBRFAT+RANGING=1,0001

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

Entfernungsinformationen des Moduls mit der Adresse 0001: Gleichzeitig die Entfernungen zu den Modulen mit den Adressen 0002 und 0003 ermitteln:

Senden : UWBRFAT+RANGING=2,0002,0003

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

Entfernung zum Modul mit der Adresse 0004 ermitteln, aber Entfernungsmessung schlägt fehl:

Senden : UWBRFAT+RANGING=1,0004

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

Fehlerbeispiel :

Senden : UWBRFAT+RANGING=123,456

Antwort: Fehler

Satz

UWBRFAT+LOCATION=

+STANDORT=(,,),(),()

Beschreibung

: 4-Byte-Hexadezimaldarstellung. Die Zieladressen für die Positionierung, wenn das Modul als Tag fungiert. Bereich: 0000–FFFE. Mindestens 3 Adressen erforderlich, maximal 8 können eingegeben werden (durch Kommas getrennt).
Das Modul initiiert den Positionierungsprozess mit den Zielankern und gibt nach Abschluss des Prozesses das Positionierungsergebnis aus.

Die berechnete aktuelle x-Koordinate des Objekts nach Abschluss der Positionierung. Auf zwei Dezimalstellen gerundet, Einheit: Meter (m).

Die berechnete aktuelle y-Koordinate des Objekts nach Abschluss der Positionierung. Auf zwei Dezimalstellen gerundet, Einheit: Meter (m).

Die berechnete aktuelle z-Koordinate des Objekts nach Abschluss der Positionierung. Auf zwei Dezimalstellen gerundet, Einheit: Meter (m).

Gleitkomma-Zeichenkette. Ausgabe der Entfernungsinformationen nach Abschluss der Positionsbestimmung. Bis zu zwei Dezimalstellen. Bei einem Erfassungsfehler ist dieser Wert -1.

Gleitkomma-Zeichenkette. Signalstärkeinformationen des Gegenübers nach Abschluss der Entfernungsmessung. Bis zu zwei Dezimalstellen. Bei einem Fehler bei der Entfernungsmessung ist dieser Wert 0.

Beispiel

Bei drei nahegelegenen Ankerpunkten (0001, 0002, 0003) ermitteln Sie die relative Position zu diesen Ankerpunkten: Senden : UWBRFAT+LOCATION=0001,0002,0003

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

Fehlerbeispiel (Unzureichende Anzahl eingegebener Ankeradressen): Senden : UWBRFAT+RANGING=0001,0002

Antwort: Fehler

Abfrage

UWBRFAT+COORDINATE?

+KOORDINATEN=,,

Satz

*UWBRFAT+COORDINATE=,,

OK

Beschreibung

Ganzzahliger Datentyp. Die x-Koordinate des Ankers, Einheit: cm. Bereich: 0–100000 (Standardwert: 0)
Ganzzahliger Datentyp. Die y-Koordinate des Ankers, Einheit: cm. Bereich: 0–100000 (Standardwert: 0)
Ganzzahliger Datentyp. Z-Koordinate des Ankers, Einheit: cm. Bereich: 0–100000 (Standardwert: 0)

Beispiel

Die eigenen Koordinaten des Moduls abfragen, wenn es als Anker fungiert: Senden : UWBRFAT+COORDINATE?

Antwort: +COORDINATE=12345,0,54321

Modulkoordinaten festlegen: Senden : UWBRFAT+COORDINATE=12345,54321,100

Antwort: OK

Abfrage

UWBRFAT+DISTOFFSET?

+DISTOFFSET=

Satz

*UWBRFAT+DISTOFFSET=

OK

Beschreibung

Ganzzahliger Datentyp. Wertebereich: -500 bis 500. Standardwert: 0. Legt den Offset-Wert für die Ergebnisse von Bereichsmessungen bei Verwendung von Bereichs- oder Positionierungsfunktionen fest. Einheit: cm.
Ist der eingestellte Offsetwert positiv, addiert das Modul diesen Offset zum Ergebnis der Entfernungsmessung; ist der Wert negativ, subtrahiert es den Offset.

Beispiel

Bereichsoffsetwert abfragen: Senden : UWBRFAT+DISTOFFSET?

Antwort: +DISTOFFSET=34

Bereichsoffsetwert festlegen: Senden : UWBRFAT+DISTOFFSET=100

Antwort: OK