NB-IOT is a LPWAN technology for bi-directional data traffic between devices and centralized cloud platforms. To configure such a device, a whole slew of AT commands is needed. Senbiot tries to simplify that to a standard set of settings and a simple senbiot "message" command
To get started please get the Golang toolchains from the Golang website. When you have a working go toolchain you can do:
go get github.com/johanhenselmans/senbiotpkg
And you are ready to go!
The tools made with senbiotpkg are located in the cmd folder of the root of the project. You just do a go build in the specific folder and run the resulting commands.
Commandline tool to send a message to an NB-``IOT network. Currently the device supported is the SODAQ NBIOT device, at https://shop.sodaq.com/en/nb-iot-shield-deluxe-dual-band-8-20.html. The network that are supported are the Vodafone and T-Mobile networks in the Netherlands. The device requires to have a 'through' connection to the serial port of the ublox device, which can be accomplished by using the Arduino sketch from http://support.sodaq.com/sodaq-one/at/. I have included the Arduino sketch in the folder SerialThrough, You should upload this to your Arduino board. That will make the connection transparant from you linux/windows/macos machine, and you can shoot messages to the board.
Install via go install github.com/johanhenselmans/cmd/senbiot
CommandLine tool to check the configuration of your NB-IOT device. Configuration can be given via the commandline or via a config.yml file. See the example config.yml file included
Install via go install github.com/johanhenselmans/cmd/checkconfiga
CommandLine tool to send a message via your preconfigured NB-IOT device. Configuration can be given via the commandline or via a config.yml file. See the example config.yml file included
Install via go install github.com/johanhenselmans/cmd/sendmsg
Commandline tool to scan serialports on the machine so as to determine which device to use.
Install via go install github.com/johanhenselmans/cmd/getserialports
CommandLine tool to encode a message in the way it will be sent via your NB-IOT device. This encoding does not count the lenght of the message, as specified in the NB-IOT message format.
Install via go install github.com/johanhenselmans/cmd/encodemessage
CommandLine tool to encode a decode the hex content of the message that could have been sent from your NB-IOT device to the gateway
Install via go install github.com/johanhenselmans/cmd/decodemessage
CommandLine tool to decode the base64 message that is sent via the OceanConnect gateway of T-Mobile.
Install via go install github.com/johanhenselmans/cmd/decodebase64message
I have plans to get the board to work via Firmata, that should make it possible to retrieve the GPS coordinates from the board.
Please read the Contribution Guidelines. Furthermore: Fork -> Patch -> Push -> Pull Request
This project is licensed under the MIT License. See the LICENSE file for the full license text.