Konnected connects wired sensors and switches to SmartThings, Home Assistant, Hubitat and OpenHAB
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
devicetypes/konnected-io remove duplicate method Sep 25, 2018
firmware bump fw version number and build date Jan 17, 2019
hubitat fix duplicate method def Nov 1, 2018
scripts build firmware/fs 2.2.5 Jan 14, 2019
smartapps/konnected-io fix issue with low-level trigger on boot Jul 28, 2018
spec release 2.2.5 Jan 16, 2019
src release 2.2.5 Jan 16, 2019
.gitignore update .gitignore Feb 1, 2018
LICENSE Initial commit Jun 24, 2017
README.md update flashing instructions in README Apr 3, 2018



GitHub release

Konnected Security

Konnected Security integrates wired alarm system sensors and sirens to SmartThings using a NodeMCU based ESP8266 development board and (optional) relay. This project consists of a few components:

  1. NodeMCU firmware for an ESP8266 development board in firmware
  2. Lua and HTML source code for the NodeMCU in src. All these files should be uploaded to the NodeMCU's internal file system
  3. SmartThings platform code in smartapps and devicetypes

Skip this Installation!

Buy a Konnected Security NodeMCU kit from us and you can skip the installation! We pre-load the Konnected Security software on every NodeMCU device before sending it to you. When you get it, just plug it in connect to WiFi, and it's ready to set up. Buying from us is great way to support the developers who have worked hard on this project.

Installation Overview

  1. Install device drivers for your NodeMCU device.
  2. Flash the device with the included firmware firmware/konnected-firmware-2-0-5.bin
  3. Upload all the code in src to the device and reboot the device.
  4. Connect to the WiFi network konnected-security_XXXXXX to set up WiFi
  5. Follow wiring instructions and SmartThings application setup instructions in the Konnected Security Documentation

Device Drivers

Windows and Mac users will need to download drivers so your computer can talk to the ESP8266 chip over USB. Depending on which board you have, there are different drivers:

WeMos CH340 drivers for boards that:

  • have the name LoLin on the back or front
  • the small rectangular component on the board near the USB port is engraved with CH340G
  • Mac OS X Sierra users: use this driver

Silicon LabsUSB to UART drivers for boards that:

  • have the name Amica on the back
  • the small component on the board near the USB port is engraved with SiLABS CP2102

Mac & Linux Users

  1. You must have Python installed with pip or pip3.

    • Mac users: I recommend using Homebrew and brew install python
  2. Open up a terminal and install esptool packages:

    pip3 install esptool
  3. Run the script in scripts/flash to flash the firmware and software to the device. You may need to edit the variables at the top of the script as your serial port may be different depending on your operating system and the type of NodeMCU development board you have. You may also need to make the script executable by running chmod 755 scripts/flash.

Windows Users

  1. Download and install the NodeMCU PyFlasher tool

  2. Using PyFlasher, flash the latest firmware in the firmware directory of this repo at 115200 baud using flash mode dio.

  3. Now you need to upload all the files in the src directory of this repo on to the device. If you're comfortable using Python, I recommend nodemcu-uploader. The command would look something like this:

    C:\Python27\python.exe nodemcu-uploader --port=COM3 upload * --verify=raw

    If you prefer a GUI tool, download and run ESPlorer and connect to your device at baud 115200. Then use the Upload button to upload the files to the device.


We work hard on this project because we're passionate about making home automation accessible to everybody. Millions of homes in North America and worldwide are already wired with sensors and have the potential to become smart homes. We want to make this a reality.

If you've used Konnected Security and it's improved your life and your home security, please consider donating to help us achieve that goal.

Thank you for your support,

Nate Clark @heythisisnate

Donate Here with Paypal or Bitcoin

For more information, click here for Konnected Documentation, Help and Community support