Update tradfri docs

This commit is contained in:
Paulus Schoutsen 2017-04-21 23:44:50 -07:00 committed by Fabian Affolter
parent cdede48f77
commit 99e8f3066f
No known key found for this signature in database
GPG Key ID: DDF3D6F44AAB1336
5 changed files with 306 additions and 29 deletions

View File

@ -7,7 +7,6 @@ sidebar: true
comments: false
sharing: true
footer: true
featured: true
ha_category: Hub
ha_release: "0.30"
logo: digital_ocean.png

View File

@ -1,39 +1,18 @@
---
layout: page
title: "Tradfri (Trådfri) Gateway"
description: "Access and control your ZigBee-based IKEA Tradfri (Trådfri) Lights."
title: "IKEA Trådfri lights"
description: "Access and control your ZigBee-based IKEA Trådfri (Tradfri) Lights."
date: 2017-04-12 22.04
sidebar: true
comments: false
sharing: true
footer: true
logo: ikea.svg
ha_category: Light
ha_iot_class: "Local Polling"
ha_release: 0.43
---
Support for the IKEA Tradfri (Trådfri) gateway. The gateway can control lights connected to it.
For installation instructions, see [the tradfri component][tradfri].
NB: for this to work, you need to install the lib-coap library:
```
$ apt-get install libtool
$ git clone --recursive https://github.com/obgm/libcoap.git
$ cd libcoap
$ git checkout dtls
$ git submodule update --init --recursive
$ ./autogen.sh
$ ./configure --disable-documentation --disable-shared
$ make
$ sudo make install
```
To enable these lights, add the following lines to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
light:
- platform: tradfri
host: 192.168.0.129
api_key: <on back of gateway>
```
[tradfri]: /components/tradfri/

View File

@ -0,0 +1,39 @@
---
layout: page
title: "IKEA Trådfri (Tradfri)"
description: "Access and control your ZigBee-based IKEA Trådfri (Tradfri) devices."
date: 2017-04-12 22.04
sidebar: true
featured: true
comments: false
sharing: true
footer: true
logo: ikea.svg
ha_category: Light
ha_iot_class: "Local Polling"
ha_release: 0.43
---
Support for the IKEA Trådfri (Tradfri) gateway. The gateway can control lights connected to it.
NB: for this to work, you need to install a modified lib-coap library:
```bash
apt-get install libtool
git clone --depth 1 --recursive -b dtls https://github.com/home-assistant/libcoap.git
cd libcoap
./autogen.sh
./configure --disable-documentation --disable-shared --without-debug CFLAGS="-D COAP_DEBUG_FD=stderr"
make
make install
```
To enable these lights, add the following lines to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
tradfri:
host: 192.168.0.129
api_key: <on back of gateway>
```

View File

@ -29,8 +29,8 @@
<a href='/components/media_player.plex/'>
<img src='/images/supported_brands/plex.png' />
</a>
<a href='/components/device_tracker.netgear/'>
<img src='/images/supported_brands/netgear.png' />
<a href='/components/tradfri/'>
<img src='/images/supported_brands/ikea.svg' width='165' />
</a>
<a href='/components/vera/'>
<img src='/images/supported_brands/vera.png' />

View File

@ -0,0 +1,260 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!-- Generator: Adobe Illustrator 16.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0) -->
<svg
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:cc="http://creativecommons.org/ns#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns="http://www.w3.org/2000/svg"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
version="1.1"
id="Layer_1"
x="0px"
y="0px"
width="353.99997"
height="126.99999"
viewBox="10 10.132 353.99997 127"
enable-background="new 10 10.132 380 129.736"
xml:space="preserve"
inkscape:version="0.48.2 r9819"
sodipodi:docname="AJAX1.svg"><metadata
id="metadata79"><rdf:RDF><cc:Work
rdf:about=""><dc:format>image/svg+xml</dc:format><dc:type
rdf:resource="http://purl.org/dc/dcmitype/StillImage" /></cc:Work></rdf:RDF></metadata><defs
id="defs77" /><sodipodi:namedview
pagecolor="#ffffff"
bordercolor="#666666"
borderopacity="1"
objecttolerance="10"
gridtolerance="10"
guidetolerance="10"
inkscape:pageopacity="0"
inkscape:pageshadow="2"
inkscape:window-width="1280"
inkscape:window-height="1004"
id="namedview75"
showgrid="false"
fit-margin-top="0"
fit-margin-left="0"
fit-margin-right="0"
fit-margin-bottom="0"
inkscape:zoom="2.3967198"
inkscape:cx="163.35055"
inkscape:cy="33.454287"
inkscape:window-x="-8"
inkscape:window-y="-8"
inkscape:window-maximized="1"
inkscape:current-layer="Layer_1" />
<g
id="g3"
transform="translate(-0.50001037,-2.368)">
<g
id="g5">
<defs
id="defs7">
<rect
id="SVGID_1_"
x="9.5"
y="10.5"
width="380"
height="129" />
</defs>
<clipPath
id="SVGID_2_">
<use
xlink:href="#SVGID_1_"
overflow="visible"
id="use11"
style="overflow:visible"
x="0"
y="0"
width="380"
height="129.73599" />
</clipPath>
</g>
<g
id="g15">
<defs
id="defs17">
<rect
id="SVGID_3_"
x="9.5"
y="10.5"
width="380"
height="129" />
</defs>
<clipPath
id="SVGID_4_">
<use
xlink:href="#SVGID_3_"
overflow="visible"
id="use21"
style="overflow:visible"
x="0"
y="0"
width="380"
height="129.73599" />
</clipPath>
<rect
x="10.5"
y="12.5"
clip-path="url(#SVGID_4_)"
width="354"
height="127"
id="rect23"
style="fill:#ffcc00;stroke:none" />
</g>
<g
id="g25">
<defs
id="defs27">
<rect
id="SVGID_5_"
x="9.5"
y="10.5"
width="380"
height="129" />
</defs>
<clipPath
id="SVGID_6_">
<use
xlink:href="#SVGID_5_"
overflow="visible"
id="use31"
style="overflow:visible"
x="0"
y="0"
width="380"
height="129.73599" />
</clipPath>
<path
clip-path="url(#SVGID_6_)"
d="m 10.5,12.5 h 354 v 127 h -354 v -127 z m 176.988,121.768 c 95.437,0 172.821,-25.941 172.821,-57.918 0,-31.979 -77.385,-57.902 -172.821,-57.902 -95.433,0 -172.809,25.924 -172.809,57.902 0,31.975 77.376,57.918 172.809,57.918"
id="path33"
style="fill:#003399;stroke:none"
inkscape:connector-curvature="0" />
</g>
<g
id="g35">
<defs
id="defs37">
<rect
id="SVGID_7_"
x="9.5"
y="10.5"
width="380"
height="129" />
</defs>
<clipPath
id="SVGID_8_">
<use
xlink:href="#SVGID_7_"
overflow="visible"
id="use41"
style="overflow:visible"
x="0"
y="0"
width="380"
height="129.73599" />
</clipPath>
<path
clip-path="url(#SVGID_8_)"
d="m 146.5,95.857 c 0,0 0.612,-0.53 0.694,-0.858 0.229,-1.067 -0.154,-2.103 -0.154,-2.103 L 137.5,77.857 V 77.76 l 0.042,15.807 0.272,1.254 0.518,0.68 H 108.17 l 0.497,-0.68 0.26,-1.344 -0.012,-41.164 -0.263,-1.192 -0.493,-0.621 h 30.174 l -0.506,0.662 -0.26,1.317 -0.018,14.752 10.929,-14.3 c 0,0 0.226,-0.56 0.226,-1.367 0,-0.508 -0.497,-1.336 -0.497,-1.336 l 30.03,0.034 -13.067,18.582 15.748,25.166 1.179,0.904 1.341,0.586 H 146.5 v 0.357 z"
id="path43"
inkscape:connector-curvature="0"
style="fill:#003399;stroke:none;fill-opacity:1" />
</g>
<g
id="g45">
<defs
id="defs47">
<rect
id="SVGID_9_"
x="9.5"
y="10.5"
width="380"
height="129" />
</defs>
<clipPath
id="SVGID_10_">
<use
xlink:href="#SVGID_9_"
overflow="visible"
id="use51"
style="overflow:visible"
x="0"
y="0"
width="380"
height="129.73599" />
</clipPath>
<path
style="fill:#003399;stroke:none;fill-opacity:1"
clip-path="url(#SVGID_10_)"
d="m 91.426,93.688 0.267,1.406 0.49,0.844 -30.146,-0.081 0.355,-0.858 0.108,-1.433 0,-41.209 -0.122,-1.213 -0.353,-0.644 30.17,0 -0.502,0.662 -0.255,1.317 z"
id="polygon53" />
</g>
<g
id="g55">
<defs
id="defs57">
<rect
id="SVGID_11_"
x="9.5"
y="10.5"
width="380"
height="129" />
</defs>
<clipPath
id="SVGID_12_">
<use
xlink:href="#SVGID_11_"
overflow="visible"
id="use61"
style="overflow:visible"
x="0"
y="0"
width="380"
height="129.73599" />
</clipPath>
<path
style="fill:#003399;stroke:none;fill-opacity:1"
clip-path="url(#SVGID_12_)"
d="m 235.211,67.105 1.371,-0.25 0.84,-0.492 -0.024,12.721 -0.882,-0.516 -1.305,-0.257 -16.711,0.019 0,4.17 21.819,0 1.537,-0.306 0.756,-0.583 0.05,14.355 -52.857,-0.103 0.484,-0.858 0.211,-1.437 0,-41.211 -0.223,-1.431 -0.51,-0.87 52.682,0.099 0.041,13.81 -0.857,-0.364 -1.434,-0.101 -21.699,0 0,3.669 z"
id="polygon63" />
</g>
<g
id="g65">
<defs
id="defs67">
<rect
id="SVGID_13_"
x="9.5"
y="10.5"
width="380"
height="129" />
</defs>
<clipPath
id="SVGID_14_">
<use
xlink:href="#SVGID_13_"
overflow="visible"
id="use71"
style="overflow:visible"
x="0"
y="0"
width="380"
height="129.73599" />
</clipPath>
<path
clip-path="url(#SVGID_14_)"
d="m 285.449,69.522 -3.547,7.978 h 7.105 l -3.558,-7.978 z M 267.298,52.421 c 0,0 0.224,-0.806 0.128,-1.448 -0.087,-0.628 -0.505,-0.868 -0.505,-0.868 l 40.885,0.012 c 0,0 -0.421,0.228 -0.509,0.871 -0.092,0.627 0.131,1.444 0.131,1.444 l 17.85,41.817 0.568,0.89 0.786,0.719 -32.288,0.056 c 0,0 0.495,-1.044 0.444,-1.479 -0.051,-0.463 -0.211,-1.06 -0.211,-1.06 L 292.48,87.5 h -14.054 l -2.298,5.874 c 0,0 -0.218,0.051 -0.218,0.503 0,0.88 0.529,1.623 0.529,1.623 h -26.037 c 0,0 0.896,-0.354 1.391,-1.437 0.404,-0.856 0.326,-0.806 0.326,-0.806 l 15.179,-40.836 z"
id="path73"
inkscape:connector-curvature="0"
style="fill:#003399;stroke:none;fill-opacity:1" />
</g>
</g>
</svg>

After

Width:  |  Height:  |  Size: 6.5 KiB