Konnected.io

The konnected integration lets you connect wired sensors and switches to a Konnected Alarm Panel, or NodeMCU ESP8226 based device running the open source Konnected software. Reuse the wired sensors and siren from an old or pre-wired alarm system installation and integrate them directly into Home Assistant.

Visit the Konnected.io website for more information about the Konnected Alarm Panel board and compatible hardware.

The integration currently supports the following device types in Home Assistant:

• Binary sensor: Wired door and window sensors, motion detectors, glass-break detectors, leak sensors, smoke & CO detectors or any open/close switch.
• Switch: Actuate a siren, strobe, buzzer or relay module.
• Sensor: Periodic measurements from DHT temperature/humidity sensors and DS18B20 temperature sensors.

This integration uses the SSDP integration, which must be enabled for device discovery to work. If you don’t want to use SSDP you’ll need to manually provide the IP and Port information for each Konnected Panel. The IP/Port info can be found using the Konnected mobile app.

Configuration

Web Interface

Starting with 0.106.0 Home Assistant requires UI based configuration of Konnected via Settings -> Devices & Services in the Home Assistant (web) frontend. If you have Konnected Alarm Panels on your LAN, or in your configuration.yaml, you will see one or more Konnected.io entries appear in the Discovered integrations list.

Selecting one of these discovered panels will guide you through connecting and configuring the panel. If your panel was discovered via SSDP, you shouldn’t need any information to complete configuration - simply confirm that the information displayed is correct. If the UI prompts you for IP/Port, you’ll need to enter it. IP/Port info can be found using the Konnected mobile app.

Once configuration is completed you’ll see a Konnected.io entry in Settings -> Devices & Services -> Configured. If you imported settings from configuration.yaml you are now done! If you are setting up a new Konnected Alarm Panel or modifying settings, you’ll need to utilize the settings UI to configure zone behavior.

Using Settings UI to Configure Zone Behavior

The settings for each panel can be accessed by selecting the entry in Settings -> Devices & Services -> Configured and then clicking on the gear icon in the upper right corner. You can reconfigure these settings at any time and once completed the settings will be immediately applied.

The settings UI starts by having you configure the general behavior of each zone. You need to specify Disabled, Binary Sensor, Digital Sensor, or Switchable Output for each zone. After that, you’ll be prompted, for each zone that is not disabled, to configure details of the zones’ behavior. All zones will allow entry of a Name. Additional fields depend on how you configured the general behavior of the zone.
Note some zones do not support all behaviors. The UI will reflect specific options available to each zone.

Binary sensor:

Binary sensor type: The type of sensor connected to the zone.

Name (optional) The friendly name for the entity associated with the zone.

Invert the open/close state: Inverts the open/closed meaning of a binary sensor circuit. Commonly needed for normally open wired smoke alarm circuits.

Digital Sensor:

Sensor Type: The type of sensor connected to the zone - either dht or ds18b20.

Name (optional) The friendly name for the entities associated with the zone.

Poll Interval (optional): How often in minutes to poll the sensor for updates.

Switchable Output:

Name: (optional) The friendly name for the entity associated with the zone.

Output when on: The state of the switch when activated.

Pulse Duration (optional): The duration in ms to pulse the switch once activated.

Pause between pulses (optional): The duration in ms to wait between pulses when activated.

Times to repeat (optional): The number of times to repeat the pulse each time the switch is activated.

Configure additional states for this zone: Selecting “No” will complete configuration for the zone and proceed to options for the next zone. Select “Yes” if you need to create additional output states for this zone.

Using Settings UI to Configure Additional Panel Behavior

Once all zones are configured you’ll be presented with the configuration for additional panel behaviors.

Blink panel LED on when sending state change: The desired LED behavior for the panel.

Override default Home Assistant API host panel URL: The Konnected Alarm Panel post sensor states back to the Home Assistant API. If this value is unchecked the panel will default postbacks using the URL configured in Home Assistant. By default, the integration will use the internal URL. However, if you check this field and set the Override API host URL to your local IP address and port (e.g., http://192.168.1.101:8123), it will be used instead of the internal URL.

Override API host URL (optional): The host info to use if you checked Override default Home Assistant API host panel URL in the step above. This is ignored if Override default Home Assistant API host panel URL is unchecked.

YAML configuration

If you prefer you can utilize a konnected section in the configuration.yaml file that specifies the Konnected devices on the network and the sensors or actuators attached to them. If using configuration.yaml the configuration will be one-time imported when going through the Configuration Flow for the panel. Note that you must still complete the UI based setup before the integration will be configured and entities created/accessible.

Details of the configuration fields and values can be found below.

# Example configuration.yaml entry
konnected:
  access_token: REPLACE_ME_WITH_A_RANDOM_STRING
  devices:
    - id: 438a388bcd53
      binary_sensors:
        - zone: 1
          type: door
      switches:
        - zone: out
    - id: 8bcd53438a38
      binary_sensors:
        - pin: 2
          type: door
      switches:
        - pin: 5

Configuration Notes

• Either pin or zone is required for each actuator or sensor. Do not use both in the same definition.
• pin represents the number corresponding to the IO index of the labeled pin on the NodeMCU dev board. See the NodeMCU GPIO documentation for more details. Valid values are 1, 2, 5, 6, 7, 8, and 9. Pin based configuration is only allowed with ESP8266 based devices.
• Pin D8 or the out zone will only work when activation is set to high (the default).
• zone represents the value corresponding to the labeled zone on the Konnected Alarm Panel boards. Valid zone values are 1, 2, 3, 4, 5, 6, and out for the Konnected Alarm Panel (out represents the dedicated ALARM/OUT terminal) and 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, out1, alarm1, and alarm2_out2 for the Konnected Alarm Panel Pro.
• The Konnected Alarm Panel Pro does not support configuration via pin.

Extended Configuration

# Example configuration.yaml entry
konnected:
  access_token: REPLACE_ME_WITH_A_RANDOM_STRING
  devices:
    - id: 6001948bcd53
      binary_sensors:
        - zone: 1
          type: door
          name: "Front Door"
        - zone: 2
          type: smoke
          name: "Bedroom Smoke Detector"
          inverse: true
        - zone: 3
          type: motion
          name: "Test Motion"
      switches:
        - zone: out
          name: siren
        - zone: 5
          name: "Beep Beep"
          momentary: 65
          pause: 55
          repeat: 4
        - zone: 5
          name: Warning
          momentary: 65
          pause: 55
          repeat: -1
    - id: 5ccf7f438a38
      binary_sensors:
        - pin: 1
          type: motion
          name: Office Motion
        - pin: 2
          type: door
          name: Office Door
      switches:
        - pin: 5
          name: Garage Door
          activation: low
          momentary: 500
        - pin: 8
          name: LED Light
      sensors:
        - pin: 6
          name: Kitchen
          type: dht

Unique IDs and the Entity Registry

Beginning in Home Assistant release 0.90, unique IDs are generated for each sensor or switch entity. This enables end users to modify the entity names and entity IDs through the Home Assistant UI at Settings -> Devices & Services -> Entities.

Unique IDs are internally generated as follows:

Binary Sensors: {mac-address}-{zone-number}

Switches: {mac-address}-{unique-hash}*

DHT Sensors: {mac-address}-{pin-number}-{temperature|humidity}

DS18B20 Sensors: {sensor-serial-number}

* Switches are identified by a unique hash including the pin number, momentary, pause, and repeat values. If these values are modified, a new entity will be created and the old entity must be removed manually from the Entity Registry.

Pin Mapping

Konnected runs on an ESP8266 board with the NodeMCU firmware. It is commonly used with the NodeMCU dev kit Wi-Fi module and optionally Konnected’s Alarm Panel hardware. The following table shows the pin mapping between the Konnected hardware labeled zones, the NodeMCU labeled pins and the ESP8266 GPIO pins.

Binary Sensor

The konnected binary sensor allows you to monitor wired door sensors, window sensors, motion sensors, smoke detectors, CO detectors, glass-break sensors, water leak sensors or any other simple wired open/close circuit attached to a NodeMCU ESP8266 Wi-Fi module running the open source Konnected software.

This integration supports all of the built-in device classes of the generic Binary Sensor integration.

Switch

The konnected switch platform allows you to actuate an alarm system siren, strobe light, buzzer or any other wired device using a Konnected Alarm Panel board or relay module and a NodeMCU ESP8266 Wi-Fi module running the open source Konnected software.