Skip to content

GBRL commands

Miguel Tomas Silva edited this page Nov 15, 2023 · 36 revisions

Home >> Setup and Configure the Smart DAQ >> GBRL Commands

Change Language
Last update: 15-11-2023

Communication with the smart device can be done using any open-source BLE terminal App. It utilizes Garble commands (GBRL) to do setup, configuration, and data measurements visualization in a text format.


Device GBRL Commands

                - $help $?                           - View available GBRL commands
                - $ver                               - Device Firmware Version
                - $did                               - This Smart Device Unique Serial Number
                - $sleep [on/off]                    - Enable/disable device sleep (save battery power)
                - $sleep status                      - View current device sleep status 

                - $firmware update                   - Update the Device with a newer Firmware
                - $firmware cfg [on/auto/manual]     - Configure Firmware updates
                - $dt                                - Device Time
                - $settings reset                    - reset Settings to Default values
                - $set pwd [password]                - Set device access password

                - $dt                                - Device Time
                - $debug [on/off] [ble/ uart / all]  - Output Debug
                - $debug status                      - View Debug cfg
                - debug repository [on/off]          - Save Debug data in the data repository
                - $debug verbose  [on/off]           - Output all debug messages
                - $debug errors  [on/off]            - Output only Error messages

                - $lang dw [country code]            - Download a language pack to the smart device (requires internet conn.)
                - $lang set [country code]           - Change the smart device language

Device Connectivity Commands

                - $wifi status                       - View WIFI status
                - $wifi nearby                       - View WIFI networks nearby
                - $wifi networks                     - View configured WIFI networks
                - $wifi ssid [network name]          - Add WIFI Network
                - $wifi clear                        - Clear WIFI credentials
                - $wifi default                      - Enable "SCC WIFI" default SSID Network (pass: "1234567890" )

                - $set dn [name]                     - Set device BLE name (max 20 chars)
                - $view dn                           - View device BLE name

                - $geo info                          - View Geo-location data information (requires a WIFI connection)

Onboard Sensors Commands

                - sensor port [on/off]          - Enable/ Disable Power on External Ports
                - $ms view                      - View motion detection sensitivity
                - $ms set [0;1]                 - Set motion detection sensitivity
                - $ot                           - View Onboard Temperature data (°C/°F)
                - $oh                           - View Onboard Humidity data ( % )
                - $oa                           - View onboard acceleration data ( g )
                - $og                           - View Onboard Gyroscope data ( dps ) 
                - $om                           - View Microcontroller Temperature (°C/°F)

Dataverse Commands

                - $dv server                                      - View Dataverse Server Address
                - $dv set server [access password] [server url]   - Set a new Dataverse Server Address
                - $dv port                                        - View Dataverse Server Port
                - $dv set port [access password] [port]           - Set a new Dataverse Server Port
                - $dv doi                                         - View Dataset Persistent ID
                - $dv set doi [access password] [persistant ID]   - Set a new Dataset Persistent ID
                - $dv id                                          - View Dataset ID
                - $dv set ui [access password] [time in min]      - Set a new upload Interval in min
                - $dv UI                                          - View Dataset Upload Interval
                - $dv set id [access password] [id]               - Set a new Dataset ID
                - $dv token [access password]                     - View Dataverse API TOKEN
                - $dv set token [access password]                 - Set a new Dataverse API TOKEN

Sensor Measurements Commands

                - $history                           - Measurements History

Wireless Connectivity

On the first boot, the smart device has configured a default WIFI SSID and password. The credentials are SSID "SCC WIFI" and password "1234567890". This default wifi network can be deleted with the command $wifi clear. This device allows up to 5 WIFI networks connected simultaneously. To add and configure a WIFI network type the command $wifi ssid on the Serial Terminal app (BLE/ USB). See Device GBRL commands above for more.

Factory Reset

Is possible to do a factory reset on the smart device. On the Serial Terminal app (BLE/USB) use the command $settings reset. This will restore all factory settings values including the default WIFI Network"SCC WIFI".See Device GBRL commands above for more.


BLE configuration


GBRL command: $BLE


Setup ALWAYS ON

GBRL command: $BLE


Setup BLE Connectivity Interval

GBRL command: $BLE



WIFI configuration


GBRL command: $BLE


Setup Network SSID

GBRL command: $BLE


View current WIFI Network

GBRL command: $BLE


Setup WIFI Password

GBRL command: $BLE


View WIFI Password

GBRL command: $BLE



Synchronize Internet Time

GBRL command: $BLE


Upload measurements to a Data Repository


GBRL command: $BLE



Concrete Specifications Configuration


GBRL command: $BLE


Maturity Model Selection

GBRL command: $BLE



Onboard Sensors


view list of available sensors

GBRL command: $BLE


Motion Detection

enable GBRL command: $BLE

disable GBRL command: $BLE

view most recent acceleration value (X,Y,Z) GBRL command: $BLE

view most recent Tilt value (X,Y,Z) GBRL command: $BLE

view temperature value GBRL command: $BLE


Onboard AHT20/ SHT31 Temperature

enable GBRL command: $BLE

disable GBRL command: $BLE

view current Temperature GBRL command: $BLE


Onboard AHT20/ SHT31 Humidity

enable GBRL command: $BLE

disable GBRL command: $BLE

view current Humidity GBRL command: $BLE


Battery Level

GBRL command: $BLE


Clone this wiki locally