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

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`.