Instructions for Nuimo controller component based on SDK (#865)

This commit is contained in:
gross1989 2016-09-21 18:28:01 +02:00 committed by Fabian Affolter
parent 8a6b6519a4
commit c283ad6819
2 changed files with 71 additions and 0 deletions

View File

@ -0,0 +1,71 @@
---
layout: page
title: "Nuimo controller"
description: "Instructions how to setup and use a Nuimo device in Home Assistant."
date: 2016-08-30 12:00
sidebar: true
comments: false
sharing: true
footer: true
logo: nuimo.png
ha_category: Hub
ha_release: 0.28
ha_iot_class: "Local Poll"
---
The `nuimo_controller` component allows you to connect to a [Nuimo](http://www.senic.com/) device for receiving input events and displaying on the led matrix via the [Nuimo SDK for Python on Linux](https://github.com/getSenic/nuimo-linux-python).
To connect to a Nuimo device add the following section to your `configuration.yaml` file:
```yaml
nuimo_controller:
mac: 'CE:B5:12:25:21:89'
```
Configuration variables:
- **mac** (*Optional*): skip discovery and connect to this device address
- **name** (*Optional*): handle more than one device by names
Example for testing rotation value and sending to led matrix:
```yaml
automation Nuimo_rotate_right:
trigger:
platform: event
event_type: nuimo_input
event_data:
type: ROTATE
condition:
condition: template
value_template: {% raw %}'{{ trigger.event.data.value > 100 }}'{% endraw %}
action:
service: nuimo_controller.led_matrix
data:
matrix:
'........
0000000.
.000000.
..00000.
.0.0000.
.00.000.
.000000.
.000000.
........ '
interval: 0.5
```
Troubleshooting:
- use `hcitool lescan` to see the mac address of your device
- allow non-root user access to Bluetooth LE with `sudo setcap cap_net_raw+eip $(eval readlink -f $(which python))`
- install the newest version of [pygattlib](https://bitbucket.org/OscarAcena/pygattlib) from
the repository, either because there is no binary package for your system or the pip version
contains errors, with `pip install hg+https://bitbucket.org/OscarAcena/pygattlib --target $HOME/.homeassistant/deps`.
( dependencies of pygattlib: `sudo apt-get install pkg-config libboost-python-dev
libboost-thread-dev libbluetooth-dev libglib2.0-dev python-dev` )
Then invoke home-assistant with `hass --skip-pip`.

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB