Analyse approfondie du module UWB650 (Partie 5) : Commandes de configuration

UWBRFAT

D'ACCORD

UWBRFAT+VERSION ?

V1.2

UWBRFAT+DEFAULT

D'ACCORD

UWBRFAT+RESET

D'ACCORD

UWBRFAT+FLASH

D'ACCORD

Requête

UWBRFAT+DÉBIT ?

+DÉBIT EN BAUD=

Ensemble

*UWBRFAT+DÉBIT =

D'ACCORD

Description

Type entier. Chaque valeur représente le numéro de série correspondant.
débit de bauds du port :

0:230400bps

1:115200bps ( Par défaut )

2:57600bps

3,38400 bps

4,19200 bps

5,9600 bps

Remarque : Les autres configurations du port série du module sont fixes : 8 bits de données, 1 bit d’arrêt, pas de bit de parité, pas de contrôle de flux.

Exemple

Interroger le débit en bauds actuel du port série du module :

Envoyer : UWBRFAT+BAUDRATE ?

Réponse : +BAUDRATE=0

Configurez le débit en bauds du port série du module à 9 600 : Envoyer : UWBRFAT+BAUDRATE=5

Réponse : OK

Exemple d'erreur :

Envoyer : UWBRFAT+BAUDRATE=6

Réponse : Erreur

Requête

UWBRFAT+DATARATE ?

+DATARATE=

Ensemble

*UWBRFAT+DATARATE=

D'ACCORD

Description

Type entier. Différentes valeurs représentent différents débits de données radio.

0:850Kbps

1:6,8 Mbps ( par défaut )

Exemple

Interroger le débit de données radio : Envoyer : UWBRFAT+DATARATE ?

Réponse : +DATARATE=1

Définir le débit de données radio : Envoyer : UWBRFAT+DATARATE=0

Réponse : OK

Exemple d'erreur :

Envoyer : UWBRFAT+DATARATE=2

Réponse : Erreur

Requête

UWBRFAT+ID DE L'APPAREIL ?

+ID_DEVICE=,

Ensemble

*UWBRFAT+DEVICEID=,

D'ACCORD

Description

Type de caractère hexadécimal sur 4 octets. Plage : 0000-FFFE (Valeur par défaut : 0000)

Type de caractère hexadécimal sur 4 octets. Plage : 0000-FFFE (Valeur par défaut : 0000)

Exemple

Demande d'identifiant PAN et d'adresse : 

Envoyer : UWBRFAT+DEVICEID ?

Réponse : +DEVICEID=1234,5678

Configurer l'identifiant PAN et l'adresse : 

Envoyer : UWBRFAT+DEVICEID=ABCD,1234

Réponse : OK

Exemple d'erreur :

Envoyer : UWBRFAT+DEVICEID=FFFF,FFFF

Réponse : Erreur

Requête

UWBRFAT+POWER ?

+PUISSANCE=

Ensemble

*UWBRFAT+POWER=

D'ACCORD

Description

Type entier. Plage : 0-10. Différentes valeurs représentent différentes puissances.Niveaux :

Exemple

Interroger la puissance d'émission du module : Envoyer : UWBRFAT+POWER ?

Réponse : +PUISSANCE=0

Régler la puissance d'émission : Envoyer : UWBRFAT+POWER=10

Réponse : OK

Exemple d'erreur :

Envoyer : UWBRFAT+POWER=11

Réponse : Erreur

Requête

UWBRFAT+PREAMBLECODE ?

+PREAMBLECODE=

Ensemble

*UWBRFAT+PREAMBLECODE=

D'ACCORD

Description

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

Exemple

Interroger le paramètre de code de préambule : Envoyer : UWBRFAT+ PREAMBLECODE ?

Réponse : +PREAMBLECODE=9

Définir le paramètre de code de préambule : Envoyer : UWBRFAT+PREAMBLECODE=12

Réponse : OK

Exemple d'erreur :

Envoyer : UWBRFAT+PREAMBLECODE=3

Réponse : Erreur

Requête

UWBRFAT+CCAENABLE ?

+CCAENABLE=

Ensemble

*UWBRFAT+CCAENABLE=

D'ACCORD

Description

: Type entier.

0 : Désactiver la fonction CCA (par défaut)

1 : Activer la fonction CCA

Cette fonction est utilisée uniquement en mode de transmission de données. Après l'activation de CCA, si le module détecte une transmission de données en cours avant l'envoi de données normales, il interrompt la transmission. Le port série répond alors comme suit :

ÉCHEC DU CCA

Exemple

Vérifier si la fonction CCA est activée :

Envoyer : UWBRFAT+ CCAENABLE ?

Réponse : +CCAENABLE=0

Activer la fonction CCA :

Envoyer : UWBRFAT+CCAENABLE=1

Réponse : OK

Exemple d'erreur :

Envoyer : UWBRFAT+CCAENABLE=2

Réponse : Erreur

Requête

UWBRFAT+ACKENABLE ?

+ACKENABLE=

Ensemble

*UWBRFAT+ACKENABLE=

D'ACCORD

Description

: Type entier.
0 : Désactiver l’envoi de la requête ACK (par défaut)

1. Activation de la requête d'accusé de réception (ACK) : Une fois la requête d'accusé de réception activée, toutes les données transmises par le module en mode de transmission incluront une requête ACK. Si aucune réponse ACK n'est reçue, le port série répondra comme suit :

ACK ATTENTE DÉLAI D'ATTENTE EXCLU

Si une réponse ACK est reçue, le port série répondra comme suit :

ACK DÉTECTÉ

Exemple

Vérifier si la fonction ACK est activée :

Envoyer : UWBRFAT+ACKENABLE ?

Réponse : +ACKENABLE=0

Activer la fonction ACK : Envoyer : UWBRFAT+ACKENABLE=1

Réponse : OK

Exemple d'erreur :

Envoyer : UWBRFAT+ACKENABLE=2

Réponse : Erreur

Requête

UWBRFAT+SÉCURITÉ ?

+SÉCURITÉ=,

Ensemble

*UWBRFAT+SÉCURITÉ=,

D'ACCORD

Description

: Type entier.

0 : Désactiver le chiffrement AES (par défaut)

1 : Activer le chiffrement AES Après avoir activé le chiffrement AES, le contenu de la charge utile de la trame envoyée par le module en mode de transmission de données sera chiffré pour une transmission de données plus fiable.

Type de caractère hexadécimal. Longueur : 32 octets.

Valeur par défaut : 000102030405060708090A0B0C0D0E0F

Exemple

Interrogez l'état de la fonction de chiffrement AES et de la clé :

Envoyer : UWBRFAT+SÉCURITÉ ?

Réponse : +SÉCURITÉ=0,00112233445566778899AABBCCDDEEFF

Activez le chiffrement AES et définissez la clé :

Envoyer : UWBRFAT+SECURITY=1,112233445566778899AABBCCDDEEFF00

Réponse : OK

Exemple d'erreur :

Envoyer : UWBRFAT+SECURITY=112233445566778899AABBCCDDEEFF00

Réponse : Erreur

Requête

UWBRFAT+TXTARGET ?

+TXTARGET=

Ensemble

*UWBRFAT+TXTARGET=

D'ACCORD

Description

Exemple

Interroger la cible de transmission actuelle :

Envoyer : UWBRFAT+TXTARGET ?

Réponse : +TXTARGET=AB12

Modifier la cible de transmission actuelle :

Envoyer : UWBRFAT+TXTARGET=1234

Réponse : OK

Exemple d'erreur :

Envoyer : UWBRFAT+TXTARGET=123

Réponse : Erreur

Requête

UWBRFAT+MESHENABLE ?

+MESHENABLE=

Ensemble

*UWBRFAT+MESHENABLE=

D'ACCORD

Description

: Type entier.
0 : Désactiver la fonction Mesh (par défaut)

1 : Activer la fonction Mesh, le module agit uniquement comme un relais. 2 : Activer la fonction Mesh, le module agit uniquement comme un nœud.

3 : Activez la fonction Mesh. Le module peut alors servir à la fois de relais et de nœud. Remarque : en mode Mesh, la taille maximale d’un paquet est de 1 004 octets. Les modules dont la fonction Mesh est activée ne peuvent pas envoyer ni recevoir de données ordinaires avec les modules dont la fonction Mesh n’est pas activée (les fonctions de télémétrie et de géolocalisation sont exclues).

Exemple

Interroger l'état de la fonction Mesh : Envoyer : UWBRFAT+MESHENABLE ?

Réponse : +MESHENABLE=0

Activer la fonction Mesh, le module agit comme un nœud : Envoyer : UWBRFAT+MESHENABLE=2

Réponse : OK

Exemple d'erreur : UWBRFAT+MESHENABLE=4

Réponse : Erreur

Requête

UWBRFAT+RXSHOWSRC ?

+RXSHOWSRC=

Ensemble

*UWBRFAT+RXSHOWSRC=

D'ACCORD

Description

: Type entier.

0 : Ne pas afficher les informations d’adresse source 1 : Afficher les informations d’adresse source (Par défaut)

Remarque : Une fois activé, lorsque le module reçoit des données normales, il affiche l'adresse source et la puissance du signal.

Par exemple, réception de données (123456789) provenant d'un autre module (adresse 1234) avec une puissance de signal de -45,60 dBm :

Adresse source : 1234 ; RSSI : -45,60 dBm ; Données : 123456789

Si le module a le mode Mesh activé et est configuré comme nœud, il recevra les données au format suivant :

Adresse source du maillage : 1234 ; Données : 123456789

Exemple

Indiquez s'il faut afficher les informations relatives à l'adresse source :

Envoyer : UWBRFAT+RXSHOWSRC ?

Réponse : +RXSHOWSRC=0

Activer l'affichage des informations d'adresse source :

Envoyer : UWBRFAT+RXSHOWSRC=1

Réponse : OK

Exemple d'erreur :

Envoyer : UWBRFAT+RXSHOWSRC=2

Réponse : Erreur

Requête

UWBRFAT+LEDSTATUS ?

+LEDSTATUS=

Ensemble

*UWBRFAT+LEDSTATUS=

D'ACCORD

Description

: Type entier.

0 : Désactiver le voyant d’état LED

1 : Activer le voyant d'état LED (Par défaut)

Remarque : En fonctionnement, un voyant rouge clignotant indique que le module transmet des données ; un voyant bleu clignotant indique que le module est en mode réception, mais cela ne signifie pas nécessairement que des données sont reçues.

Exemple

Vérifier si le voyant LED est activé :

Envoyer : UWBRFAT+LEDSTATUS ?

Réponse : +LEDSTATUS=1

Désactiver le voyant d'état LED : Envoyer : UWBRFAT+LEDSTATUS=0

Réponse : OK

Exemple d'erreur :

Envoyer : UWBRFAT+LEDSTATUS=2

Réponse : Erreur

Requête

UWBRFAT+RXENABLE ?

+RXENABLE=

Ensemble

*UWBRFAT+RXENABLE=

D'ACCORD

Description

: Type entier.

0 : Désactiver l’état de réception 1 : Activer l’état de réception (Par défaut)

Après la désactivation de la réception, le module passe en mode veille. Il peut toujours transmettre des données, mais ne peut plus en recevoir. La consommation d'énergie est alors réduite.

Exemple

Vérifier si l'état de réception est activé :

Envoyer : UWBRFAT+RXENABLE ?

Réponse : +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

Obtenez la distance au module d'adresse 0001 : Envoyez : UWBRFAT+RANGING=1,0001

Réponse : +RANGEMENT=(12,34),(-56,78)

Informations de distance fournies par le module d'adresse 0001 : Obtenir simultanément les distances aux modules d'adresses 0002 et 0003 :

Envoyer : UWBRFAT+RANGING=200020003

Réponse : +RANGEMENT=(34,12 ; 26,17), (-53,23 ; -49,15)

Obtenez la distance jusqu'au module d'adresse 0004, mais la mesure de distance échoue :

Envoyer : UWBRFAT+RANGING=1,0004

Réponse : +RANGEMENT=(-1),(0,00)

Exemple d'erreur :

Envoyer : UWBRFAT+RANGING=123 456

Réponse : Erreur

Ensemble

UWBRFAT+LOCATION=

+LOCATION=(,,),(),()

Description

: Type hexadécimal 4 octets. Adresses d'ancrage cibles pour le positionnement lorsque le module fonctionne comme une étiquette. Plage : 0000-FFFE. Au moins 3 adresses sont requises, jusqu'à 8 peuvent être saisies (séparées par des virgules).
Le module lancera le processus de positionnement avec les points d'ancrage cibles et affichera le résultat du positionnement une fois le processus terminé.

Coordonnée x actuelle calculée après le positionnement. Arrondie à deux décimales, en mètres (m).

Coordonnée y actuelle calculée après le positionnement. Arrondie à deux décimales, en mètres (m).

Coordonnée z actuelle calculée après le positionnement. Arrondie à deux décimales, en mètres (m).

Type de chaîne de caractères à virgule flottante. Informations de distance affichées une fois le positionnement terminé. Jusqu'à 2 décimales. En cas d'échec de l'acquisition, cette valeur sera -1.

Type de chaîne de caractères à virgule flottante. Intensité du signal émis par l'autre extrémité après la mesure de distance. Jusqu'à deux décimales. En cas d'échec de la mesure, cette valeur est égale à 0.

Exemple

Avec 3 ancres à proximité (0001, 0002, 0003), obtenez la position relative par rapport à ces ancres : Envoyer : UWBRFAT+LOCATION=0001,0002,0003

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

Exemple d'erreur (Nombre insuffisant d'adresses d'ancrage) : Envoyer : UWBRFAT+RANGING=0001,0002

Réponse : Erreur

Requête

UWBRFAT+COORDONNÉ ?

+COORDONNÉE=,,

Ensemble

*UWBRFAT+COORDONNÉE=,,

D'ACCORD

Description

Type entier. Coordonnée x du point d'ancrage, en cm. Plage : 0-100 000 (valeur par défaut : 0).
Type entier. Coordonnée y du point d'ancrage, en cm. Plage : 0-100 000 (valeur par défaut : 0).
Type entier. Coordonnée z du point d'ancrage, en cm. Plage : 0-100 000 (par défaut : 0)

Exemple

Interroger les propres coordonnées du module lorsqu'il agit comme ancre : Envoyer : UWBRFAT+COORDINATE ?

Réponse : +COORDONNÉE=12345,0,54321

Définir les coordonnées du module : Envoyer : UWBRFAT+COORDINATE=12345,54321,100

Réponse : OK

Requête

UWBRFAT+DISTOFFSET ?

+DISTOFFSET=

Ensemble

*UWBRFAT+DISTOFFSET=

D'ACCORD

Description

Type entier. Plage : -500 à 500. Valeur par défaut : 0. Définit la valeur de décalage pour les résultats de mesure de distance lors de l’utilisation de fonctions de mesure de distance ou de positionnement. Unité : cm.
Lorsque la valeur de décalage définie est positive, le module ajoutera ce décalage au résultat de la mesure de distance ; lorsque la valeur est négative, il soustraira le décalage.

Exemple

Interroger la valeur de décalage de portée : Envoyer : UWBRFAT+DISTOFFSET ?

Réponse : +DISTOFFSET=34

Définir la valeur de décalage de portée : Envoyer : UWBRFAT+DISTOFFSET=100

Réponse : OK