Konnected for ESPHome

This repository houses the officially supported ESPHome firmware configuration files and recipes for Konnected products. Konnected is a U.S. based maker of IoT hardware and software that integrates traditional wired alarm systems and garage door openers into your smart home.

Quick Start

1. Get started quickly by flashing your Konnected device with ESPHome firmware using Konnected's web-based tool.
2. Power on the device.
3. On your computer or mobile device, connect to the device's captive portal WiFi setup network named "konnected-XXXXXX" where XXXXXX is a unique hexadecimal number. For ethernet devices, plug in the Ethernet cable and skip to step 5.
4. Select your home WiFi network and enter your WiFi password in the captive portal.
5. Discover the Konnected device in Home Assistant > Settings > Devices & Services
6. (Optional) Discover the device and customize the firmware in ESPHome Dashboard (see ESPHome add-on).

Changes and Release Notes

See releases for release notes and downloadable pre-built flashable images.

Made for ESPHome

Konnected's products are made with ESP32 and ESP8266 microcontrollers with integrated USB interfaces, and are completely open to end-user servicing and customization, making them ideal products for ESPHome firmware. Since 2023, Konnected maintains and distributes ESPHome configuration recipies for all products. These firmwares are for Home Assistant users who want a plug-and-play solution. More advanced users can import Konnected's ESPHome configurations into their ESPHome Dashboard and easily customize, build, and update their device(s) with a few simple edits of the well-commented configuration files and packages provided by Konnected.

Works with Home Assistant

Use these ESPHome firmware configurations for easy and plug-and-play setup in Home Assistant that's local, fast, and completely customizable.

In This Repository

This repository houses several complete firmware configuration YAML templates for various Konnected devices at the top level. These are the main firmware templates imported by the dashboard_import feature when used with ESPHome Dashboard.

alarm-panel-pro-esp32-ethernet.yaml

alarm-panel-pro-esp32-wifi.yaml

Konnected's flagship Alarm Panel Pro is an ESP32 powered wired alarm panel with Wifi, Ethernet and PoE.

Setup Required:

1. Ethernet type. If the ethernet build is used, Under GENERAL SETTING > ETHERNET CONFIG uncomment one of the ethernet_type: substitution variables. Choose LAN8720 for the Alarm Panel Pro up to v1.7. Choose RTL8201 for the Alarm Panel Pro v1.8 and above. The hardware version is displayed on the front of the device underneath the logo.

alarm-panel-esp8266.yaml

Konnected's original 6-zone Alarm Panel and Alarm Panel Add-on is a compact WiFi-only modular wired alarm panel, infinitely expandable for any size system.

This firmware config will also run on a NodeMCU module and Konnected's v1 (2018-2020) Alarm Panel product.

garage-door-GDOv1-S.yaml

A smart garage door opener based on the ESP8266 (model: GDOv1-S).

garage-door-GDOv2-S.yaml

An improved smart garage door opener retrofit based on the ESP32-S3-Mini (GDOv2-S).

garage-door-GDOv2-Q.yaml

Firmware for Konnected's GDO blaQ -- a smart garage door opener retrofit for Security+ and Security+ 2.0 openers with direct serial connection to the garage door opener unit (GDOv2-Q).

ESPHome Components

Components are found in the components directory of this repo.

Secplus GDO

Secplus GDO is an ESPHome component for controlling Security+ and Security+ 2.0 garage openers made by Chamberlain Group, including garage door openers sold since 1997 under the Chamberlain, LiftMaster, Craftsman and Merlin brands.

This component is maintained by Konnected and powers the Konnected GDO blaQ Konnected's smart garage door opener accessory for Security+ garage door openers.

Documentation

See README

Adapted from ratgdo

This component was adapted from and inspired by ratgdo, however it's not a copy and not feature-equivalent. We initially set out to fork ratgdo and contribute back some improvements, however it ultimately became a complete rewrite. Konnected is publishing this derivative work under the GPLv3 license.

Project Goals

The ratgdo and secplus developers found a way to communicate with Security+ garage door openers over a reverse-engineered serial wireline protocol. This novel development enabled owners of Security+ garage openers to read and send commands directly to the garage unit. Konnected set out to incorporate this technology into a finished consumer product. To do that, we wanted to adapt the code to:

• Remove dependency on Arduino
• Run on the ESP-IDF platform
• Utilize the ESP32's hardware UART (instead relying on the SoftwareSerial arduino library)
• Decouple the Security+ wireline protocol from the ESPHome component

Other Differences from ratgdo

1. Event-driven instead of polling. This library uses an event-driven architecture to receive data from the garage door unit, instead of polling for updates. This results in a measurably faster response time to state changes.
2. Two wires instead of three. The obstruction sensor state can now be read via the serial protocol, therefore it doesn't need to be wired separately to a GPIO. This makes installation simpler, only requiring the red and white wire to the wall button inputs on the garage door opener.
3. Supports a pre-closing warning. To comply with U.S. 16 CFR 1211.14(f)
4. Automatic detection of Security+ vs Security+ 2.0. Less for the end-user to think about.
5. Removes dry contact trigger support. We feel that this is better handled with a template cover in ESPHome, and this library should focus on the Security+ interaction only.
6. Removes relay outputs. Again, simplifying the library to do Security+ only.

Noted Dependencies

1. gdolib
2. secplus

Customization

Customize your ESPHome based firmware to your own needs by making simple edits to the firmware configuration file in the ESPHome Dashboard.

Substitution Variables

name

A unique name for this device. If you have multiple Konnected panels, choose a different name for each. The name can only include lowercase letters, numbers, and hyphens.

friendly_name

A human-readable name, for example "Alarm Panel", used to identify the device in Home Assistant front-end. If you have multiple Konnected devices, it's recommended to set a different friendly name for each.

sensor_debounce_time

Sensors use a debouncing filter to prevent transient sensor state changes or flickers from triggering a false sensor event. Default: 200ms

warning_beep_pulse_time

Duration of a warning beep pulse.

warning_beep_pause_time

Quiet pause time between warning beeps.

warning_beep_internal_only

Whether the warning beep entity should be only used internally, or should also be exposed to the API / Home Assistant.

warning_beep_pin

The zone that the piezo buzzer is wired to for warning beep.

Possible values (ESP8266): $zone1 thru $zone5 or $out

Possible values (ESP32): $zone1 thru $zone8 or $alarm1, alarm2, $out1, $out2

Packages

The firmware configuration is organized into packages of functionality for different device features. These are defined in the packages folder of this repository.

Commment-out or remove package lines from this file that you don't want or need. For example, if you do not want a warning beep entity created, comment-out the warning_beep package by putting a # at the front of the line. See Konnected's support pages for more information:

• Customizing ESPHome firmware on Konnected Alarm Panel 6-zone models (ESP8266)
• Customizing ESPHome firmware on Konnected Alarm Panel Pro (ESP32)
• Customizing ESPHome firmware on Konnected Garage Door Opener

To customize functionality from packages, copy and paste the package contents (from Github) into your device configuration file and comment-out or remove the package import line. Then you can customize the functionality that came from this package for your device.

Get Help

Konnected customers are welcome to contact Konnected Support at help.konnected.io or by email: help@konnected.io for help with your ESPHome firmware on a genuine Konnected device.