From 7d22d0bcef72e40446ae9707ea91cd710a87f742 Mon Sep 17 00:00:00 2001
From: Nick Whyte <nick@canva.com>
Date: Thu, 10 Jan 2019 10:38:13 +1100
Subject: [PATCH] Add ness alarm control panel (#7630)

* Add ness alarm control panel

* .

* Device class
---
 .../alarm_control_panel.ness_alarm.markdown   |  19 +++++
 .../binary_sensor.ness_alarm.markdown         |  18 +++++
 source/_components/ness_alarm.markdown        |  75 ++++++++++++++++++
 source/images/supported_brands/ness.png       | Bin 0 -> 10011 bytes
 4 files changed, 112 insertions(+)
 create mode 100644 source/_components/alarm_control_panel.ness_alarm.markdown
 create mode 100644 source/_components/binary_sensor.ness_alarm.markdown
 create mode 100644 source/_components/ness_alarm.markdown
 create mode 100644 source/images/supported_brands/ness.png

diff --git a/source/_components/alarm_control_panel.ness_alarm.markdown b/source/_components/alarm_control_panel.ness_alarm.markdown
new file mode 100644
index 00000000000..d8fd5082d52
--- /dev/null
+++ b/source/_components/alarm_control_panel.ness_alarm.markdown
@@ -0,0 +1,19 @@
+---
+layout: page
+title: "Ness Alarm Control Panel"
+description: "Instructions on how to setup the Ness alarm control panel within Home Assistant."
+date: 2018-11-25 18:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: ness.jpg
+ha_category: Alarm
+ha_release: 0.84
+ha_iot_class: "Local Push"
+---
+
+
+The `ness_alarm` alarm control panel platform allows you to control your [Ness](http://nesscorporation.com/) D8x and D16x alarms.
+
+The alarm control panel is automatically added by configuring the [Ness alarm](/components/ness_alarm/) component.
diff --git a/source/_components/binary_sensor.ness_alarm.markdown b/source/_components/binary_sensor.ness_alarm.markdown
new file mode 100644
index 00000000000..dafef92b0f7
--- /dev/null
+++ b/source/_components/binary_sensor.ness_alarm.markdown
@@ -0,0 +1,18 @@
+---
+layout: page
+title: "Ness Alarm Binary Sensor"
+description: "Instructions on how to setup the Ness alarm zones within Home Assistant."
+date: 2018-11-25 18:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: ness.jpg
+ha_category: Binary Sensor
+ha_release: 0.84
+ha_iot_class: "Local Push"
+---
+
+The `ness_alarm` binary sensor allows you to monitor your [Ness](http://nesscorporation.com/) D8x and D16x alarm zones.
+
+Zone binary sensors are automatically added by configuring the [Ness alarm](/components/ness_alarm/) component.
diff --git a/source/_components/ness_alarm.markdown b/source/_components/ness_alarm.markdown
new file mode 100644
index 00000000000..99e726f2a30
--- /dev/null
+++ b/source/_components/ness_alarm.markdown
@@ -0,0 +1,75 @@
+---
+layout: page
+title: "Ness Alarm"
+description: "Instructions on how to integrate a Ness D8x/D16x alarm system with Home Assistant."
+date: 2018-11-25 18:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: ness.jpg
+ha_category: Alarm
+ha_release: 0.84
+ha_iot_class: "Local Push"
+---
+
+The `ness_alarm` component will allow Home Assistant users who own a Ness D8x/D16x alarm system to leverage their alarm system and its sensors to provide Home Assistant with information about their homes. Connectivity between Home Assistant and the alarm is accomplished through a IP232 module that must be connected to the alarm.
+
+There is currently support for the following device types within Home Assistant:
+
+- [Binary Sensor](/components/binary_sensor.ness_alarm/): Reports on zone statuses
+- [Alarm Control Panel](/components/alarm_control_panel.ness_alarm/): Reports on alarm status, and can be used to arm/disarm the system
+
+The module communicates via the [Ness D8x/D16x ASCII protocol](http://www.nesscorporation.com/Software/Ness_D8-D16_ASCII_protocol.pdf).
+
+## {% linkable_title Configuration %}
+
+A `ness_alarm` section must be present in the `configuration.yaml` file and contain the following options as required:
+
+```yaml
+# Example configuration.yaml entry
+ness_alarm:
+  host: alarm.local
+  port: 2401
+  zones:
+    - name: Garage
+      id: 1
+    - name: Storeroom
+      id: 2
+    - name: Kitchen
+      id: 3
+    - name: Front Entrance
+      id: 4
+    - name: Front Door
+      id: 5
+      type: door
+```
+
+{% configuration %}
+host:
+  description: The hostname of the IP232 module on your home network.
+  required: true
+  type: string
+port:
+  description: The port on which the IP232 module listens for clients.
+  required: true
+  type: integer
+zones:
+  description: List of zones to add 
+  required: false
+  type: [integer, list]
+  keys:
+    zone_id:
+      description: ID of the zone on the alarm system (i.e Zone 1 -> Zone 16).
+      required: true
+      type: integer
+    name:
+      description: Name of the zone.
+      required: true
+      type: string
+    type:
+      description: The zone type. Can be any [binary_sensor device class](/components/binary_sensor/#device-class).
+      required: false
+      default: motion
+      type: string
+{% endconfiguration %}  
diff --git a/source/images/supported_brands/ness.png b/source/images/supported_brands/ness.png
new file mode 100644
index 0000000000000000000000000000000000000000..fb150b7068f401d7c4c47a1da4714bfde42e11f4
GIT binary patch
literal 10011
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

literal 0
HcmV?d00001