Automate interactions with a Crownstone device.
There are two way to interact with the Crownstones: 1) through connections, 2) through reading advertisements. Both the connections as well as the advertisements are normally encrypted.
The file bleAutomator2.py contains some functions to write and read data to a Crownstone and some general BLE devices.
Currently you first have to use encryption by filling in your keys.
To get your keys, you will now have to go through a couple of steps.
- Log in to the cloud. You will get a authentication token.
- Fill in the token at the top of the API explorer.
- Get your user id at the
usersection (at the bottom), with a GET on /user/me. - Get your keys with a GET on /users/{id}/keys. < 88B6 /ol>
-t 0for command type 0 (see the protocol).-d 100for value 100.-ninterpret value as a number.-s 1size of the value is 1 byte.-emeans that encryption is enabled-ais the BLE address to connect to- bluez
- python 2.7
- bluepy - Currently you have to get an older version:
sudo apt-get install git build-essential libglib2.0-dev libdbus-1-dev python-devgit clone https://github.com/IanHarvey/bluepy.gitcd bluepygit checkout v/0.9.11python setup.py buildsudo python setup.py install
- intelhex
- matplotlib
Copy the default file config.public.json to config.json (the latter is the default used by the scripts):
cp config.public.json config.json
Then fill in the address and keys:
{
"addresses":[
"XX:XX:XX:XX:XX:XX"
],
"sphereId": "1234abcd1234abcd1234abcd",
"keys": {
"admin": "1234abcd1234abcd1234abcd1234abcd",
"member": "1234abcd1234abcd1234abcd1234abcd",
"guest": "1234abcd1234abcd1234abcd1234abcd"
}
}
There is an issue to automate this process partly. However, if you really want to authorize properly for your users, we recommend to use oauth. Subsequently your application needs to have some structure to be able to have a user select the proper device they want to control.
The send command script is most versatile. For example, to turn on a crownstone:
./sendCommand.py -i hci0 -a "00:11:22:33:44:55" -v -e -t 0 -d 100 -n -s 1
Some explanation:
To get data from advertisements:
./getAdvertisements.py -i hci0 -a "00:11:22:33:44:55" -v -e
To get the correct data, you need the correct key, or else the data will be scrambled!
Also note that a message like Failed to execute mgmt cmd 'le on' means that you need superuser rights to scan for
BLE devices. Run the above with sudo.
It might also help to add the address through hcitool
sudo hcitool lewladd "00:11:22:33:44:55"
Prior to running, install:
On Ubuntu this can be installed through:
sudo apt-get install bluez python-pip python-matplotlib
sudo pip install pexpect
sudo pip install intelhex --allow-unverified intelhex
sudo pip install pycrypto
To create .zip file for the Nordic app to upload new firmware, we will have to wrap a crownstone.hex file.
The following will create a .zip file with a .bin binary, a Manifest file and a .dat file.
python dfGenPkg.py -a crownstone.hex
This used to create a .zip file with a .hex file, but that doesn't play well with DFU version 0.8.