diff --git a/source/_components/nuimo_controller.markdown b/source/_components/nuimo_controller.markdown new file mode 100644 index 00000000000..6e28f092ac0 --- /dev/null +++ b/source/_components/nuimo_controller.markdown @@ -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`. diff --git a/source/images/supported_brands/nuimo.png b/source/images/supported_brands/nuimo.png new file mode 100644 index 00000000000..1bc4549b424 Binary files /dev/null and b/source/images/supported_brands/nuimo.png differ