jeena/home-assistant.github.io
1
0
Fork 0
Code Issues Pull requests Projects Packages Wiki Activity Actions

Site updated at 2017-04-22 09:05:48 UTC

Browse source
This commit is contained in:
Travis CI 2017-04-22 09:05:49 +00:00
parent 7b41a7430c
commit 0c3d0b2d0f
27 changed files with 82 additions and 66 deletions
Download patch file Download diff file Expand all files Collapse all files

2
components/index.html
View file

@ -521,7 +521,7 @@ var allComponents = [
{url:"/components/light.osramlightify/", title:"Osram Lightify", cat:"light", featured: false, v: 21, logo: "osramlightify.png"},
{url:"/components/device_tracker.owntracks/", title:"Owntracks", cat:"presence-detection", featured: true, v: 7, logo: "owntracks.png"},
{url:"/components/sensor.pvoutput/", title:"PVOutput Sensor", cat:"energy", featured: false, v: 33, logo: "pvoutput.png"},
{url:"/components/light.rpi_gpio_pwm/", title:"PWM LED", cat:"light", featured: false, v: 43, logo: ""},
{url:"/components/light.rpi_gpio_pwm/", title:"PWM LED", cat:"light", featured: false, v: 43, logo: "raspberry-pi.png"},
{url:"/components/media_player.panasonic_viera/", title:"Panasonic Viera TV", cat:"media-player", featured: false, v: 17, logo: "panasonic.png"},
{url:"/components/media_player.pandora/", title:"Pandora", cat:"media-player", featured: false, v: 22, logo: "pandora.png"},
{url:"/components/panel_custom/", title:"Panel Custom", cat:"front-end", featured: false, v: 26, logo: "home-assistant.png"},

70
components/light.rpi_gpio_pwm/index.html
View file

@ -8,7 +8,7 @@
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<title>PWM LED - Home Assistant</title>
<meta name="author" content="Home Assistant">
<meta name="description" content="Instructions on how to setup pwm leds within Home Assistant.">
<meta name="description" content="Instructions on how to setup PWM LEDs within Home Assistant.">
<meta name="viewport" content="width=device-width">
<link rel="canonical" href="https://home-assistant.io/components/light.rpi_gpio_pwm/">
<meta property="fb:app_id" content="338291289691179">
@ -16,12 +16,12 @@
<meta property="og:site_name" content="Home Assistant">
<meta property="og:url" content="https://home-assistant.io/components/light.rpi_gpio_pwm/">
<meta property="og:type" content="article">
<meta property="og:description" content="Instructions on how to setup pwm leds within Home Assistant.">
<meta property="og:description" content="Instructions on how to setup PWM LEDs within Home Assistant.">
<meta property="og:image" content="https://home-assistant.io/images/default-social.png">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:site" content="@home_assistant">
<meta name="twitter:title" content="PWM LED">
<meta name="twitter:description" content="Instructions on how to setup pwm leds within Home Assistant.">
<meta name="twitter:description" content="Instructions on how to setup PWM LEDs within Home Assistant.">
<meta name="twitter:image" content="https://home-assistant.io/images/default-social.png">
<link href="/stylesheets/screen.css" media="screen, projection" rel="stylesheet">
<link href="/atom.xml" rel="alternate" title="Home Assistant" type="application/atom+xml">
@ -66,42 +66,57 @@
</h1>
</header>
<hr class="divider">
<p>The <code class="highlighter-rouge">rpi_gpio_pwm</code> platform allows to control multiple lights using pulse-width modulation, for example led strips. It supports one-color, RGB and RGBW leds driven by GPIOs of an Raspberry Pi or a PCA9685 controller.</p>
<h3><a class="title-link" name="configuration" href="#configuration"></a> Configuration</h3>
<p>The <code class="highlighter-rouge">rpi_gpio_pwm</code> platform allows to control multiple lights using pulse-width modulation, for example led strips. It supports one-color, RGB and RGBW LEDs driven by GPIOs of a Raspberry Pi or a PCA9685 controller.</p>
<p>To enable this platform, add the following lines to your <code class="highlighter-rouge">configuration.yaml</code>:</p>
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="c1"># Example configuration.yaml entry</span>
<span class="s">light</span><span class="pi">:</span>
<span class="s">platform</span><span class="pi">:</span> <span class="s">rpi_gpio_pwm</span>
<span class="s">leds</span><span class="pi">:</span>
<span class="c1"># One-color led directly connected to GPIO</span>
<span class="pi">-</span> <span class="s">name</span><span class="pi">:</span> <span class="s">Lightstrip Cupboard</span>
<span class="s">driver</span><span class="pi">:</span> <span class="s">gpio</span>
<span class="s">pins</span><span class="pi">:</span> <span class="pi">[</span><span class="nv">17</span><span class="pi">]</span>
<span class="s">type</span><span class="pi">:</span> <span class="s">simple</span>
<span class="c1"># RGB led connected to PCA9685 controller</span>
<span class="pi">-</span> <span class="s">name</span><span class="pi">:</span> <span class="s">TV Backlight</span>
<span class="s">driver</span><span class="pi">:</span> <span class="s">pca9685</span>
<span class="s">pins</span><span class="pi">:</span> <span class="pi">[</span><span class="nv">0</span><span class="pi">,</span> <span class="nv">1</span><span class="pi">,</span> <span class="nv">2</span><span class="pi">]</span> <span class="c1"># [R, G, B]</span>
<span class="s">type</span><span class="pi">:</span> <span class="s">rgb</span>
<span class="c1"># RGBW led connected to PCA9685 controller</span>
<span class="pi">-</span> <span class="s">name</span><span class="pi">:</span> <span class="s">Lightstrip Desk</span>
<span class="s">driver</span><span class="pi">:</span> <span class="s">pca9685</span>
<span class="s">pins</span><span class="pi">:</span> <span class="pi">[</span><span class="nv">3</span><span class="pi">,</span> <span class="nv">4</span><span class="pi">,</span> <span class="nv">5</span><span class="pi">,</span> <span class="nv">6</span><span class="pi">]</span> <span class="c1"># [R, G, B, W]</span>
<span class="s">type</span><span class="pi">:</span> <span class="s">rgbw</span>
<span class="pi">-</span> <span class="s">platform</span><span class="pi">:</span> <span class="s">rpi_gpio_pwm</span>
<span class="s">leds</span><span class="pi">:</span>
<span class="pi">-</span> <span class="s">name</span><span class="pi">:</span> <span class="s">Lightstrip Cupboard</span>
<span class="s">driver</span><span class="pi">:</span> <span class="s">gpio</span>
<span class="s">pins</span><span class="pi">:</span> <span class="pi">[</span><span class="nv">17</span><span class="pi">]</span>
<span class="s">type</span><span class="pi">:</span> <span class="s">simple</span>
</code></pre>
</div>
<p>Configuration variables:</p>
<ul>
<li><strong>leds</strong> array (<em>Required</em>):
<li><strong>leds</strong> array (<em>Required</em>): Can contain multiple LEDs.
<ul>
<li><strong>name</strong> (<em>Required</em>): The name of the led.</li>
<li><strong>driver</strong> (<em>Required</em>): The driver, which controls the led. Choose either <code class="highlighter-rouge">gpio</code> or <code class="highlighter-rouge">pca9685</code>.</li>
<li><strong>pins</strong> (<em>Required</em>): The pins connected to the led. The order of pins is determined by the specified type.</li>
<li><strong>type</strong> (<em>Required</em>): The type of led. Choose either <code class="highlighter-rouge">rgb</code>, <code class="highlighter-rouge">rgbw</code> or <code class="highlighter-rouge">simple</code>.</li>
<li><strong>name</strong> (<em>Required</em>): The name of the LED.</li>
<li><strong>driver</strong> (<em>Required</em>): The driver which controls the LED. Choose either <code class="highlighter-rouge">gpio</code> or <code class="highlighter-rouge">pca9685</code>.</li>
<li><strong>pins</strong> (<em>Required</em>): The pins connected to the LED as a list.. The order of pins is determined by the specified type.</li>
<li><strong>type</strong> (<em>Required</em>): The type of LED. Choose either <code class="highlighter-rouge">rgb</code>, <code class="highlighter-rouge">rgbw</code> or <code class="highlighter-rouge">simple</code>.</li>
<li><strong>freq</strong> (<em>Optional</em>): The PWM frequency. (Default: <code class="highlighter-rouge">200</code>)</li>
<li><strong>address</strong> (<em>Optional</em>): The address of the PCA9685 driver. (Default: <code class="highlighter-rouge">0x40</code>)</li>
</ul>
</li>
</ul>
<h2><a class="title-link" name="examples" href="#examples"></a> Examples</h2>
<p>In this section you find some real life examples of how to use this sensor.</p>
<h3><a class="title-link" name="rgb-led-connected-to-pca9685-controller" href="#rgb-led-connected-to-pca9685-controller"></a> RGB LED connected to PCA9685 controller</h3>
<p>This example uses a <a href="http://www.nxp.com/products/interfaces/ic-bus-portfolio/ic-led-display-control/16-channel-12-bit-pwm-fm-plus-ic-bus-led-controller:PCA9685">PCA9685 controller</a> to control a RGB LED.</p>
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="c1"># Example configuration.yaml entry</span>
<span class="s">light</span><span class="pi">:</span>
<span class="pi">-</span> <span class="s">platform</span><span class="pi">:</span> <span class="s">rpi_gpio_pwm</span>
<span class="s">leds</span><span class="pi">:</span>
<span class="pi">-</span> <span class="s">name</span><span class="pi">:</span> <span class="s">TV Backlight</span>
<span class="s">driver</span><span class="pi">:</span> <span class="s">pca9685</span>
<span class="s">pins</span><span class="pi">:</span> <span class="pi">[</span><span class="nv">0</span><span class="pi">,</span> <span class="nv">1</span><span class="pi">,</span> <span class="nv">2</span><span class="pi">]</span> <span class="c1"># [R, G, B]</span>
<span class="s">type</span><span class="pi">:</span> <span class="s">rgb</span>
</code></pre>
</div>
<h3><a class="title-link" name="rgbw-led-connected-to-pca9685-controller" href="#rgbw-led-connected-to-pca9685-controller"></a> RGBW LED connected to PCA9685 controller</h3>
<p>This example uses a <a href="http://www.nxp.com/products/interfaces/ic-bus-portfolio/ic-led-display-control/16-channel-12-bit-pwm-fm-plus-ic-bus-led-controller:PCA9685">PCA9685 controller</a> to interact with a RGBW LED.</p>
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="c1"># Example configuration.yaml entry</span>
<span class="s">light</span><span class="pi">:</span>
<span class="pi">-</span> <span class="s">platform</span><span class="pi">:</span> <span class="s">rpi_gpio_pwm</span>
<span class="s">leds</span><span class="pi">:</span>
<span class="pi">-</span> <span class="s">name</span><span class="pi">:</span> <span class="s">Lightstrip Desk</span>
<span class="s">driver</span><span class="pi">:</span> <span class="s">pca9685</span>
<span class="s">pins</span><span class="pi">:</span> <span class="pi">[</span><span class="nv">3</span><span class="pi">,</span> <span class="nv">4</span><span class="pi">,</span> <span class="nv">5</span><span class="pi">,</span> <span class="nv">6</span><span class="pi">]</span> <span class="c1"># [R, G, B, W]</span>
<span class="s">type</span><span class="pi">:</span> <span class="s">rgbw</span>
</code></pre>
</div>
</article>
</div>
<aside id="sidebar" class="grid__item one-third lap-one-whole palm-one-whole">
@ -109,6 +124,7 @@
<section class="aside-module grid__item one-whole lap-one-half">
<div class='edit-github'><a href='https://github.com/home-assistant/home-assistant.github.io/tree/current/source/_components/light.rpi_gpio_pwm.markdown'>Edit this page on GitHub</a></div>
<div class='brand-logo-container section'>
<img src='/images/supported_brands/raspberry-pi.png' />
</div>
<div class='section'>
IoT class<sup><a href='/blog/2016/02/12/classifying-the-internet-of-things/#classifiers'><i class="icon-info-sign"></i></a></sup>: Local Push