systemquery: Query Information
In addition to the application systemctrl, the command systemquery allows internal parameters to be queried
on the device The-Black-Box. This applies to configuration parameters as well as the versions of various software components.
This is primarily used for testing and debugging purposes.
Synopsis
- Options:
- -h, --help
Displays help on commandline options.
- --help-all
Displays help, including generic Qt options.
- -v, --version
Displays version information.
- -a, --address <host>
Host address of the gateway [localhost].
- -p, --port <port>
Port of the gateway [51955].
- -f, --frequency <period>
Frequency (period) of sending in ms [1000].
- -s, --severity <level>
Max severity (fatal|error|warning|info|debug|verbose) of log message.
- -F, --file <filename>
Logs to file.
- -C, --console <stream>
Console output stream (off|std|err) of log messages [std].
- --debug
Report additional debug info in log.
- -J, --json
Enable JSON output.
- --stop <number>
Stop after received messages.
- --error <number>
Stop after received error messages.
- -1, --once
Stop after first received message or error.
- -l, --list
Show list of all available parameters.
- Arguments:
parameters list of parameters to be queried.
Examples
Specifying the parameter -l|--list outputs a list of all supported parameters to the console. For example
./systemquery -s info -l outputs:
2025-07-23 13:01:37.557 INFO List of available parameters:
2025-07-23 13:01:37.557 INFO - adc-calibration
2025-07-23 13:01:37.557 INFO - adc-width
2025-07-23 13:01:37.557 INFO - ble-enabled
2025-07-23 13:01:37.557 INFO - can-maxsize
2025-07-23 13:01:37.557 INFO - debug-configsize
2025-07-23 13:01:37.557 INFO - error-code
2025-07-23 13:01:37.557 INFO - error-message
2025-07-23 13:01:37.557 INFO - i2c-maxsize
2025-07-23 13:01:37.557 INFO - modelrpc-builddate
2025-07-23 13:01:37.557 INFO - modelrpc-hash
2025-07-23 13:01:37.557 INFO - modelrpc-version
2025-07-23 13:01:37.557 INFO - name
2025-07-23 13:01:37.557 INFO - server-builddate
2025-07-23 13:01:37.557 INFO - server-version
2025-07-23 13:01:37.557 INFO - spi-maxsize
2025-07-23 13:01:37.557 INFO - status
2025-07-23 13:01:37.557 INFO - timeout
2025-07-23 13:01:37.557 INFO - uart-maxsize
2025-07-23 13:01:37.557 INFO - uid
2025-07-23 13:01:37.557 INFO - uptime
One or more parameters can be passed when the program is called, which are queried one after the other.
The time between two calls can be changed using the -f|--frequency parameter. If no parameter is specified, all
parameters are queried on the device.
The command ./systemquery -a blackbox0007.local -f 100 -s info --stop 20
queries all parameters and stops after 20 values are received.
2025-07-24 18:42:11.443 INFO Query in total 20 parameter(s).
2025-07-24 18:42:11.473 INFO status: 0
2025-07-24 18:42:11.563 INFO uptime: 3497717
2025-07-24 18:42:11.665 INFO adc-calibration: 0
2025-07-24 18:42:11.763 INFO adc-width: 12
2025-07-24 18:42:11.863 INFO ble-enabled: 0
2025-07-24 18:42:11.963 INFO modelrpc-version: 1.7.0
2025-07-24 18:42:12.065 INFO modelrpc-hash: 6b3e13a8b179b12a1ab77e8e60c3b9a9
2025-07-24 18:42:12.166 INFO modelrpc-builddate: 2025-07-18T15:42:00
2025-07-24 18:42:12.263 INFO i2c-maxsize: 12
2025-07-24 18:42:12.364 INFO spi-maxsize: 12
2025-07-24 18:42:12.464 INFO uart-maxsize: 96
2025-07-24 18:42:12.565 INFO can-maxsize: 8
2025-07-24 18:42:12.663 INFO uid: 59 00 35 00 0c 50 33 50 46 33 38 20 (12 bytes)
2025-07-24 18:42:12.763 INFO name: the-black-box v1.7.0
2025-07-24 18:42:12.863 INFO error-code: 0
2025-07-24 18:42:12.963 INFO error-message: no error
2025-07-24 18:42:13.063 INFO timeout: 500
2025-07-24 18:42:13.163 INFO debug-configsize: 106
2025-07-24 18:42:13.263 INFO server-version: 1.7.0
2025-07-24 18:42:13.363 INFO server-builddate: 2025-07-18T18:07:56