BOOSTXL-AOA: How to send commands to rtls_master through Tera Term

Clément

Part Number: BOOSTXL-AOA

1- How to find the data to send over the UART?

The raw content of the UART messages is stated inside the log files stored in tools\ble5stack\rtls_agent\rtls_ui\logs. This folder is created after you execute the RTLS_UI.

[2020-12-14 14:54:48,853] serialnode -    DEBUG - >>> UNPIMessage(originator=Ap type=SyncReq, subsystem=25, command=RTLS_CMD_IDENTIFY, data=)
[2020-12-14 14:54:48,853] serialnode -    DEBUG - >>> FE:00:00:39:00:39
[2020-12-14 14:54:48,904] serialnode -    DEBUG - <<< FE:0C:00:79:00:84:00:02:00:05:B4:3D:1E:B0:6F:80:08:36

So, in order to send the command RTLS_CMD_IDENTIFY, we have to write on the UART "FE:00:00:39:00:39".

2- Setup the Serial port

Open a serial port and set it up with the proper UART settings:

3- Send Hex values with Tera Term

Tera Term like many other terminals interprets the data received and sent into UTF-8 characters. As a result, if you connect a logic analyzer on the UART, you won't see the expected data.

One solution is to use a macro that will disable the interpretation of the characters and that directly sends the raw data we want.

Here is the content of the macro I used:

setdebug 2

send  254 0 0 57 00 57

Write this code in a file named command.ttl

Last step is to force Tera Term to send all the data. Without this step, Tera Term does not send properly the values over 127. To do so, in Tera Term, click on Setup > General... Change the parameter "language" to "English":

4- Execute the macro and watch the results

The macro we stored in the command.ttl file can be executed through Tera Term. To do so, in Tera Term click on Control > Macro and select the command.ttl file. The execution will be automatic.

The result should be as following: