Page 26 of 42
ble_auto [ --debug ] [ --connection_retry <number_of_connection_attempts> ] [ --connection_timeout
<timeout> ] [ --scan_timeout <timeout> ] [ --black_list <name_of_black_list_file> ] [ --white_list
<name_of_white_list_file> ] [ --firmware_update_main <new_fw_file> ] [ --firmware_update_ble
<new_fw_file> ] [ --log_erase ] [ --log_create ] [ --log_skip_download ] [ --config <new_config_file>
] [ --gps_config <name_of_config_file> ] [ --gps_almanac <name_of_almanac_file> ] [ --datetime ] [
--reset ]
--debug: set the logging level to DEBUG. Default will be INFO.
--connection_retry: set the number of connection retries. Default is 3 attempts.
--connection_timeout: set the timeout in seconds for establishing a connection with a device. Default
is 10.
--scan_timeout: set the scan timeout in seconds for finding new devices. Default is 15.
--black_list: the file shall contain a newline separated list of device IDs of the form
XX:XX:XX:XX:XX:XX. Device IDs listed in this file shall not be serviced by the tool.
--white_list: the file shall contain a newline separated list of device IDs of the form
XX:XX:XX:XX:XX:XX. Only Device IDs listed in this file shall be serviced by the tool.
--log_skip_download: each serviced device shall not have its log file downloaded
--log_erase: each serviced device shall have its log file erased, but only if it was successfully
downloaded or --log_skip_download was specified
--log_create: each serviced device shall have a new log file created (should be used in combination
with --log_erase)
--config: each serviced device shall be programmed with a new JSON configuration file
--datetime: synchronize the tracker's RTC to the local time on the PC
--reset: the processor shall be hard reset upon completion of all other batch processing tasks
Each command-line option effectively represents a different task to be carried out during the servicing of discovered tracker devices. Multiple
tasks can be run sequentially when servicing each device. The following command-line example will:
Output all information logging messages to the log file called
log_file
Obtain status information, such as battery level, log file size, last known GPS position (always done by default and can not be disabled)
Download the log file of each device discovered (if one exists) and convert it to JSON (always done by default)
Apply a new JSON configuration file called
config_new.json
Resynchronize the date and time to the local PC
$ sudo ble_auto --config config_new.json --gps_almanac mgaoffline.ubx --datetime 2>&1 | tee log_file
For each device found, its log file shall be downloaded unless the
option is specified. The log file(s) create shall be of
--log_skip_download
the form
and
where
i
ble_auto_ddmmyyyy_hhmmss_xxxxxxxxxxxx.bin
ble_auto_ddmmyyyy_hhmmss_xxxxxxxxxxxx.json
ddmmyyyy
s the current date,
is the current time and
is the bluetooth device address in hexadecimal digits.
hhmmss
xxxxxxxxxxxx
7.3.1. Example output
Arribada Horizon ARTIC R2 Developer’s Kit | User Manual