From c2b0a7007709fbb2b765918be31206a426271bae Mon Sep 17 00:00:00 2001 From: "Craig J. Ward" Date: Sat, 14 Jan 2017 09:34:13 -0600 Subject: [PATCH] Insteon local (#1623) * add documentation * insteon switch * update documentation --- source/_components/insteon_local.markdown | 54 +++++++++++++++++++ .../_components/light.insteon_local.markdown | 34 ++++++++++++ .../_components/switch.insteon_local.markdown | 33 ++++++++++++ source/developers/credits.markdown | 3 ++ 4 files changed, 124 insertions(+) create mode 100644 source/_components/insteon_local.markdown create mode 100644 source/_components/light.insteon_local.markdown create mode 100644 source/_components/switch.insteon_local.markdown diff --git a/source/_components/insteon_local.markdown b/source/_components/insteon_local.markdown new file mode 100644 index 00000000000..7a6b1fcb251 --- /dev/null +++ b/source/_components/insteon_local.markdown @@ -0,0 +1,54 @@ +--- +layout: page +title: "Insteon(local)" +description: "Instructions how to setup the Insteon Hub locally within Home Assistant." +date: 2016-12-18 08:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: insteon.png +ha_category: Hub +ha_iot_class: "Local Polling" +ha_version: 0.36 +--- + +The `insteon-local` component lets you use your [Insteon Hub](http://www.insteon.com/insteon-hub/) with Home Assistant. + +To integrate your Insteon(local) with Home Assistant, add the following section to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml platform entry +insteon_local: + host: YOUR HUB IP + username: YOUR HUB USERNAME + password: YOUR HUB PASSWORD + timeout: 10 + port: 25105 +``` + +The Insteon(local) component currently supports both lights(dimmers) and switches. A full configuration may look like so: + +```yaml +# Example configuration.yaml platform entry +insteon_local: + host: YOUR HUB IP + username: YOUR HUB USERNAME + password: YOUR HUB PASSWORD + timeout: 10 + port: 25105 + +light: + - platform: insteon_local + +switch: + - platform: insteon_local +``` + +Configuration variables: + +- **username** (*Required*): The username used to access the Insteon interface (find in your Insteon app). +- **password** (*Required*): The password used to access the Insteon interface. +- **host** (*Required*): The ip address of your hub. +- **timeout** (*Optional*): Timeout to wait for connection. (default: 10) +- **port** (*Optional*): The port your hub is configured to listen to. (default: 25105) \ No newline at end of file diff --git a/source/_components/light.insteon_local.markdown b/source/_components/light.insteon_local.markdown new file mode 100644 index 00000000000..87f8e0271aa --- /dev/null +++ b/source/_components/light.insteon_local.markdown @@ -0,0 +1,34 @@ +--- +layout: page +title: "Insteon (Local) Light" +description: "Instructions how to setup the Insteon Hub Lights locally within Home Assistant." +date: 2016-12-18 08:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: insteon.png +ha_category: Light +ha_version: 0.36 +--- + +The `insteon_local` light component lets you control your lights connected to an [Insteon Hub](http://www.insteon.com/insteon-hub/) with Home Assistant. + +To integrate add a light, configure your hub Insteon(local) with Home Assistant, add the following section to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml platform entry +insteon_local: + host: YOUR HUB IP + username: YOUR HUB USERNAME + password: YOUR HUB PASSWORD + timeout: 10 + port: 25105 +``` + +To add lights (dimmers) to your set-up, add the platform to your light configuration: +```yaml +light: + - platform: insteon_local +``` + diff --git a/source/_components/switch.insteon_local.markdown b/source/_components/switch.insteon_local.markdown new file mode 100644 index 00000000000..0200b5cd439 --- /dev/null +++ b/source/_components/switch.insteon_local.markdown @@ -0,0 +1,33 @@ +--- +layout: page +title: "Insteon (Local) Switch" +description: "Instructions how to setup the Insteon Hub switches locally within Home Assistant." +date: 2016-12-18 08:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: insteon.png +ha_category: Switch +ha_version: 0.36 +--- + +The `insteon_local` switch component lets you control your switches connected to an [Insteon Hub](http://www.insteon.com/insteon-hub/) with Home Assistant. + +To integrate add a switch, configure your hub Insteon(local) with Home Assistant, add the following section to your `configuration.yaml` file: +```yaml +# Example configuration.yaml platform entry +insteon_local: + host: YOUR HUB IP + username: YOUR HUB USERNAME + password: YOUR HUB PASSWORD + timeout: 10 + port: 25105 +``` + +To add switches to your set-up, add the platform to your light configuration: +```yaml +switch: + - platform: insteon_local +``` + diff --git a/source/developers/credits.markdown b/source/developers/credits.markdown index a521adc9304..5449a00aefe 100644 --- a/source/developers/credits.markdown +++ b/source/developers/credits.markdown @@ -50,6 +50,7 @@ This page contains a list of people who have contributed in one way or another t - [Brent](https://github.com/bah2830) - [Bruno Adele](https://github.com/badele) - [Cameron Bulock](https://github.com/cbulock) +- [Cameron Llewellyn](https://github.com/camrun91) - [Carlo Costanzo](https://github.com/CCOSTAN) - [cawilliamson](https://github.com/cawilliamson) - [Charles Spirakis](https://github.com/srcLurker) @@ -59,6 +60,7 @@ This page contains a list of people who have contributed in one way or another t - [chrom3](https://github.com/chrom3) - [Corban Mailloux](https://github.com/corbanmailloux) - [coteyr](https://github.com/coteyr/) +- [Craig Ward](https://github.com/wardcraigj) - [dainok](https://github.com/dainok) - [Dale Higgs](https://github.com/dale3h) - [Dan Cinnamon](https://github.com/Cinntax) @@ -192,6 +194,7 @@ This page contains a list of people who have contributed in one way or another t - [Michael Gilbert](https://github.com/Zyell) - [Michael KutĂ˝](https://github.com/michaelkuty) - [Micha LaQua](https://github.com/milaq) +- [Michael Long](https://github.com/phareous) - [miniconfig](https://github.com/miniconfig) - [molobrakos](https://github.com/molobrakos) - [Moon Shot](https://github.com/moonshot)