From 0db3aa2f301268f36c1f1286bd1a5d9dcbc7f602 Mon Sep 17 00:00:00 2001 From: "Craig J. Ward" Date: Tue, 4 Apr 2017 06:19:50 -0500 Subject: [PATCH] TotalConnect documentation (#2372) * TotalConnect documentation # Conflicts: # source/_components/insteon_local.markdown # source/developers/credits.markdown * add Honeywell TC logo * version * update documentation * remove name from example --- .../alarm_control_panel.totalconnect.markdown | 31 ++++++++++++++++++ .../images/supported_brands/honeywell-tc.png | Bin 0 -> 25440 bytes 2 files changed, 31 insertions(+) create mode 100644 source/_components/alarm_control_panel.totalconnect.markdown create mode 100644 source/images/supported_brands/honeywell-tc.png diff --git a/source/_components/alarm_control_panel.totalconnect.markdown b/source/_components/alarm_control_panel.totalconnect.markdown new file mode 100644 index 00000000000..923416b929a --- /dev/null +++ b/source/_components/alarm_control_panel.totalconnect.markdown @@ -0,0 +1,31 @@ +--- +layout: page +title: "Honeywell TotalConnect Alarm Control Panel" +description: "Instructions how to integrate TotalConnect alarms into Home Assistant." +date: 2017-04-02 22:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: honeywell-tc.png +ha_category: Alarm +ha_release: 0.42 +--- + +The `totalconnect` platform provides connectivity with the Honeywell TotalConnect alarm systems used by many alarm companies + +To enable this, add the following lines to your `configuration.yaml`: + +```yaml +# Example configuration.yaml entry +alarm_control_panel: + platform: totalconnect + username: YOUR_USERNAME + password: YOUR_PASSWORD +``` + +Configuration variables: +- **name** (*Optional*): Name of device in HomeAssistant +- **username** (*Required*): Username used to sign into the TotalConnect app/web client. +- **password** (*Required*): Password used to sign into the TotalConnect app/web client. + diff --git a/source/images/supported_brands/honeywell-tc.png b/source/images/supported_brands/honeywell-tc.png new file mode 100644 index 0000000000000000000000000000000000000000..f6776e66d01079fef77f74bd8b9a293072e8b94e GIT binary patch literal 25440 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 literal 0 HcmV?d00001