Nuimo Python script for Raspberry Pi

Python script demonstrating the communication with Nuimo on a Raspberry Pi

Installation

1. Install bluez library

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)

Manually connect to Nuimo with bluez (optional, skip this step if you are not interested)

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

2. Install bluepy library

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. sudo pip install -U pip (Upgrade Pip to latest version)
3. sudo pip install https://github.com/IanHarvey/bluepy/archive/master.zip#bluepy

3. Download the Nuimo Python script

From your home folder do:

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

Run the Nuimo Python script

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

Troubleshooting

• 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

Support

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