/
Accessory Scanner Troubleshooting

Accessory Scanner Troubleshooting

1. Using the Debugging Functionality

If the device has a serial connection, debug messages can be enabled to provide the user with initialisation and runtime logging. It is also a great way to test new sensors before adding them to the configuration.

Serial connection parameters:

  • Default peripheral: RS232

  • Baud rate: 115200

  • Word length: 8

  • Stop bits: 1

  • Parity: None

  • Handshaking: None

1.1 How To Set Up and Use

Firstly, open Script window in XDM and find the Accessory scanner script. Open it and press duplicate to create a modifiable personal copy.

image-20250609-051204.png
image-20250609-050840.png

Then find and populate the filter_settings structure according to the examples. Use the same fields and definitions as in script settings in the device configuration. No more configuration is required in the script.

Example filter_settings structure with ELA temperature filter:

image-20250519-072441.png

Connect RS232 to the device (Refer to the Devices documentation for the pinouts of the units) and open the serial terminal application of choice. Set the correct serial terminal parameters and open the connection.

Then, connect the module to power and take note of the debug messages. Example startup excerpt :

image-20250520-110249.png

2. Common Issues

2.1 No Bluetooth data is being received in the script

  1. Check if the accessory is advertising.

  2. Filter parameters can be invalid - check the debug messages.

  3. Filter parameters can be incorrect - confirm they are correct.

  4. Confirm that the device firmware and the Bluetooth firmware are compatible.

2.2 No data is being received in the telemetry

  1. Make sure the script works using device events and/or script debug messages.

  2. Make sure the device is connected to the internet.

2.3 Incorrect data is being sent to telemetry

  1. Check if the filter type and the filter parameters are entered correctly to ensure the data is from the correct device.

  2. Check if the start byte and end byte parameters are correct.

  3. If the active scanning and the address filter is used, check whether the device is advertising two packets (advertising indication and scan response). To fix this, it is recommended to add pattern filtering in the filter settings. Alternatively, passive scanning could be used if all required data is in the advertising data packet.

2.4 No data from the serial terminal

  1. Check if the device is working.

  2. Check if the RS232 is connected properly.

  3. Check if the serial connection parameters are correct.