Python script demonstrating the communication with Nuimo on a Raspberry Pi

The bluez library will be used to enable your Bluetooth dongle. It also provides tools to manually interact with Bluetooth Low Energy (BLE) devices.

1. sudo apt-get install --no-install-recommends bluetooth (Installs bluez)
2. sudo hciconfig hci0 up (Enables your Bluetooth dongle)
3. sudo hcitool lescan (Should discover your Nuimo, press Ctrl+C to stop discovery)

1. sudo hcitool lescan | grep Nuimo (Copy your Nuimo's MAC address and press Ctrl+C to stop discovery)
2. sudo gatttool -b FA:48:12:00:CA:AC -t random -I (Replace the MAC address with the address from step 1)
3. connect (Should successfully connect to Nuimo)
4. characteristics (Displays Nuimo's GATT characteristics)
5. Look for uuid F29B1529-... (button press characteristic) and note its char value handle (2nd column). Here: 001d.
6. Add 1 to the handle. Here: 001d + 1 = 001e (Hexadecimal value representation; use a calculator if necessary)
7. char-write-req 001e 0100 (Registers for button click events; replace 001e with the handle from step 6)
8. Hold Nuimo's click button pressed and release it. gatttool should now notify all button press events.
9. exit to leave gatttool

The bluepy library is written in Python and will be used to communicate with your Bluetooth dongle in Python scripts.

From your home folder do:

1. sudo apt-get install build-essential libglib2.0-dev libdbus-1-dev python-setuptools git (Installs build dependencies and git)
2. git clone https://github.com/IanHarvey/bluepy.git
3. cd bluepy
4. python setup.py build (Compiles files to the build folder)
5. sudo python setup.py install (Installs bluepy Python scripts and bluepy-helper to /usr/local/lib/python-2.7/dist-packages/bluepy)
6. cd .. (Navigate back to your home folder)
7. rm -r bluepy (Remove bluepy source files, don't skip this step as it might otherwise lead to errornous Python imports)

From your home folder do:

1. wget https://raw.githubusercontent.com/getsenic/nuimo-raspberrypi-demo/master/nuimo.py (Downloads nuimo.py)
2. nano nuimo.py (If you want to modify the Nuimo demo script, Ctrl+X to quit nano)

From your home folder do:

1. sudo hcitool lescan | grep Nuimo (Copy your Nuimo's MAC address and press Ctrl+C to stop discovery)
2. python nuimo.py FA:48:12:00:CA:AC (Replace the MAC address with the address from step 1)
3. Perform input events on your Nuimo, they will show up on your console

• If you are having trouble to connect your Raspberry Pi to your computer or your router, refer to the Raspberry Pi ASAP Setup Guide
• If sudo hcitool lescan prints Set scan parameters failed: Input/output error., try running the following commands:

    sudo hciconfig hci0 down
    sudo hciconfig hci0 up

If you have questions or comments, please visit https://senic.com/developers or shoot us an email to developers@senic.com.