BlueShell

BlueShell / Help and Support

Current Version: V0.9.z0403

BlueShell and BlxDashboard are 'living products'. Questions and requests are always welcome.

Bluetooth LE Adapter
An adapter with support for Bluetooth LE 4.2 or later is required. We recommend using adapters with BLE 5.0 or later.
Tested adapters
On board adapters Realtek: (on some Leneovo PCs) with BLE 4.2 caused somtimes problems. Replace with external adapter!
Intel: seems to run fine in any version.
TP-Link UB500 Very small (hence range is not too high), but runs excellent! (https://www.tp-link.com/de/home-networking/adapter/ub500)
Other USB adapters Almost all other available low cost USB BLE 5.x adapters work fine on Windows 10 / 11 and without any driver installation. For long range adapters with external antenna, please ask us!

BlueShell Terminal
The terminal can run service commands or send commands to the device via BLE connection.
Commands
zSDICMD Send a SDI12 command SDICMD to the device. If power is off, default PowerUp-Wait is 1000 msec. If preceeded by '*TIME', TIME is the PowerUp-Wait in msec.
E.g 'z?I!' will issure a '?I!' (Identify) command to the device's sensor. '*2000 z3A4!' waits 2 sec, then changes SDI-address of sensor '3' to '4'.
z+ and z- Powers SDI12 bus. Will be on until next (automatic) measure or until user sends 'z-'.
ZSDIMEAS Runs 'SDIMEAS'. Exactly the same as the command in the 'Extra Command/Bytes' of a channel.
E.g. 'Z*1800 3MC' start a measure on a sensor '3', using CRC and displays the values.
v Display the contents of the FlashDisk of the device.
V Runs a Verify on the device's FlashDisk.
n1 FlashDisc clean and start new measure (same als command 'n', but also removes all files, except the parameter settings, may need up to 240 sec).
i Manual start of an Internet Transfer. Modem will be on for another 5 min (in low power mode).
'i1' for Verbose Mode, 'i3' for new SIM card (waits up to 4 minutes for network), 'i131' for Verbose and Diagnostic Mode
m Only register to the Mobile Net, but no Internet Transfer. Modem will be on for another 5 min (in low power mode).
'm1' for Verbose Mode, 'm3' for new SIM card (waits up to 4 minutes for network), 'm129' for Verbose and Diagnostic Mode
M Unregister from Mobile Net and shut down modem.
? Infos about Mobile Net signal, SIM, connection, ... Modem will be on for another 5 min (in low power mode).
% Scan all available Mobile Nets (command may need up to 3 min).
W Access the non-volatile Memory (NVM) that holds Factory-Reset versions for the Logger's files'iparam.lxp' and 'sys_param.lxp'. Used if FlashDisk is empty after System Resets.
'W FactoryWrite' writes the current setup files to NVM
'W FactoryRestore' overwrites the current setup from (if available) NVM
'W FactoryDelete' deletes the NVM setup
'W FactoryReset' FlashDisk clean and resets to the parameter files to the defaults
*todo* ...

Firmware
(Secure) Firmware updates are possible via BlueShell, BLX-Web Bluetooth API (Project) or (if device has Mobile Internet) via Server ('FOTA').
Repository is here.