Skip to main content

Bluetooth

Here is the complete list of Bluetooth commands and parameters for your GEOSNAKE device:

πŸ“‹ Bluetooth commands for STATOTEST GEOSNAKE​

πŸ”§ WiFi management​

wifi_on          - Turns WiFi on and restarts the device
wifi_off - Turns WiFi off

🌐 Network address settings​

set_address:XX   - Sets the Modbus address (1-255)
Example: set_address:5
get_address - Shows the current address

⚑ Communication speed settings​

set_baudrate:YYYY - Sets the RS485 communication speed
Supported: 9600, 19200, 38400, 57600, 115200
Example: set_baudrate:115200
get_baudrate - Shows the current baudrate

πŸ”„ System management​

restart          - Restarts the device

πŸ“Š ADXL355 measurement (accelerometer)​

measure_adxl     - Starts an accelerometer measurement

🧲 MLX90393 measurement (magnetometer)​

measure_mlx      - Starts a magnetometer measurement

βš™οΈ ADXL355 configuration​

set_adxl_points:N - Sets the number of samples (24-2048)
get_adxl_points - Shows the current number of samples

set_adxl_range:X - Sets the measurement range (0=Β±2g, 1=Β±4g, 2=Β±8g) (from FW>=6)
get_adxl_range - Shows the current range (from FW>=6)

set_adxl_odr:X - Sets the output data rate (0-10) (from FW>=6)
get_adxl_odr - Shows the current ODR (from FW>=6)

βš™οΈ MLX90393 configuration​

CommandDescriptionRangeResponse
set_mlx_gain:XSet gain0-7"MLX gain set to X"
get_mlx_gainRead gain-"MLX gain: X"
set_mlx_osr:XSet oversampling0-3"MLX OSR set to X"
get_mlx_osrRead OSR-"MLX OSR: X"
set_mlx_filter:XSet filter0-7"MLX filter set to X"
get_mlx_filterRead filter-"MLX filter: X"
set_mlx_points:XMLX sample count1-1024"MLX points set to X"
get_mlx_pointsRead sample count-"MLX points: X"
show_mlx_settingsAll MLX settings-Complete MLX overview
measure_mlxStart an MLX measurement-Starts a measurement

HTTP configuration​

CommandDescriptionResponse
http_onEnables HTTP data sending"HTTP data sending enabled"
http_offDisables HTTP sending"HTTP data sending disabled"
http_statusHTTP sending status"HTTP: ENABLED/DISABLED"
send_dataSends data to the server"Data sent" or an error
test_internetConnection test"Internet connection: OK/FAILED"

πŸ”„ Settings management (from FW>=6)​

reset_defaults   - Resets all settings to default values
show_settings - Shows the current settings
clear_flash - Erases the flash memory and restarts
factory_reset - Complete factory reset + restart

πŸ“ Usage examples​

Basic device setup:​

get_address           β†’ "Address: 1"
set_address:10 β†’ "Address set OK"
get_baudrate β†’ "Baudrate: 19200"
set_baudrate:115200 β†’ "Baudrate set OK"

Measurement configuration:​

get_adxl_points       β†’ "ADXL355 points: 10"
set_adxl_points:500 β†’ "ADXL355 points set OK"
get_adxl_range β†’ "ADXL355 range: 0"
get_adxl_odr β†’ "ADXL355 ODR: 7"

Setting the range:​

set_adxl_range:0  β†’ "ADXL355 range set to Β±2g (value: 0)"
set_adxl_range:1 β†’ "ADXL355 range set to Β±4g (value: 1)"
set_adxl_range:2 β†’ "ADXL355 range set to Β±8g (value: 2)"
set_adxl_range:5 β†’ "Invalid range (0=Β±2g, 1=Β±4g, 2=Β±8g)"

Setting the ODR:​

set_adxl_odr:0    β†’ "ADXL355 ODR set to 4000Hz (value: 0)"
set_adxl_odr:2 β†’ "ADXL355 ODR set to 1000Hz (value: 2)"
set_adxl_odr:7 β†’ "ADXL355 ODR set to 31.25Hz (value: 7)"
set_adxl_odr:15 β†’ "Invalid ODR (0-10, see documentation)"

Displaying the settings:​

show_settings     β†’ "Current Settings:
Address: 1
Baudrate: 19200
WiFi: OFF
Bluetooth: ON
ADXL355 points: 500
ADXL355 range: Β±4g (1)
ADXL355 ODR: 1000Hz (2)
MLX90393 points: 100"

ODR values reference table:​

ValueFrequencyDescription
04000HzHighest frequency
12000HzHigh frequency
21000HzDefault
3500HzMedium
4250HzMedium
5125HzLow
662.5HzVery low
731.25HzUltra low
815.625HzVery slow
97.813HzExtremely slow
103.906HzSlowest

Starting a measurement:​

measure_adxl          β†’ Starts a measurement and returns:
"ADXL355:
Sample count: 500
Aggregation X: min=-0.123456g max=0.234567g avg=0.012345g
Aggregation Y: min=-0.098765g max=0.187654g avg=-0.003456g
Aggregation Z: min=0.876543g max=1.123456g avg=0.987654g
Temperature: 23.45Β°C
angle X: 1.23Β° Y: -0.45Β° Z: 12.34Β°"

measure_mlx β†’ Starts a magnetometer measurement

WiFi management:​

wifi_on              β†’ "WiFi enabled" + device restart
wifi_off β†’ "WiFi disabled"

System restart:​

restart              β†’ Immediate device restart

πŸ“± Connecting to the device​

BLE device name: STATOTEST_GEOSNAKE-[address]

  • Example: STATOTEST_GEOSNAKE-1 (for address 1)
  • Example: STATOTEST_GEOSNAKE-10 (for address 10)

Security details:

  • PIN code: 123456
  • Encryption: Yes

πŸ” Return values​

The ADXL355 measurement contains:​

  • Sample count - how many values were measured
  • XYZ aggregation - minimum, maximum, average for each axis in g
  • Temperature - the current sensor temperature in Β°C
  • Angles - angle X, Y, Z calculated from the acceleration

Error messages:​

"Invalid address"     - Invalid address (out of the 1-255 range)
"Invalid baudrate" - Unsupported speed
"Invalid points" - Invalid sample count (out of 24-1024)
"Address set OK" - Address set successfully
"Baudrate set OK" - Speed set successfully
"ADXL355 points set OK" - Sample count set successfully

⚠️ Important notes​

  1. The wifi_on command causes a restart of the device
  2. A measurement can take several seconds depending on the number of samples
  3. Addresses 1-255 are valid for Modbus communication
  4. Setting changes are saved to the flash memory and survive a restart
  5. Only one task can run at a time (ADXL355 or MLX90393)