Konnected

# 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 Variables

access_token

(string)(Required)Any random string. This is used to ensure that only those devices which you have configured can authenticate to Home Assistant to change a device state.

api_host

(url)(Optional)Override the IP address/host (and port number) of Home Assistant that the Konnected device(s) will use to communicate sensor state updates. If omitted, this is defaulted to the value of base_url in the http component. If you’ve set base_url to an external hostname, then you’ll want to set this value back to your local IP address and port (e.g., http://192.168.1.101:8123).

Default value: value of base_url

devices

(list)(Required)A list of Konnected devices that you have on your network.

id

(string)(Required)The MAC address of the NodeMCU WiFi module with colons/punctuation removed, for example 68c63a8bcd53. You can usually find the mac address in your router’s client list. Or, check the home-assistant.log for log messages from automatically discovered devices.

binary_sensors

(list)(Optional)A list of binary sensors connected to the device. See Konnected Binary Sensor for configuration variables.

pin

(Exclusive)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 and 9.

zone

(Exclusive)The number corresponding to the labeled zone on the Konnected Alarm Panel board. Valid values are 1, 2, 3, 4, 5 and 6.

type

(Required)Any binary sensor class, typically door, window, motion or smoke.

name

(Optional)The name of the device used in the front end.

Default value: automatically generated

inverse

(boolean)(Optional)Inverts the open/closed meaning of a binary sensor circuit. Commonly needed for normally open wired smoke alarm circuits.

Default value: false

switches

(list)(Optional)A list of actuators (on/off switches) connected to the device. See Konnected Switch for configuration variables.

pin

(Exclusive)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 and 8.

zone

(Exclusive)The number corresponding to the labeled zone on the Konnected Alarm Panel board or the word out to specify the dedicated ALARM/OUT terminal on the Konnected board. Valid values are 1, 2, 3, 4, 5 and out.

name

(Optional)The name of the device used in the front end.

Default value: automatically generated

activation

(Optional)Either low or high to specify the state when the switch is turned on.

Default value: high

momentary

(Optional)Duration of the momentary pulse in milliseconds. To make a half-second momentary contact using a relay for a garage door opener, set this value to 500.

pause

(Optional)Time of the pause between pulses in milliseconds when also used with momentary and repeat. To make a door chime “beep” with piezo buzzer, set this value to 55, set momentary to 65, and repeat to 3 or 4.

repeat

(Optional)Number of times to repeat a momentary pulse. Set to -1 to make an infinite repeat. This is useful as an alarm or warning when used with a piezo buzzer.

host

(string)(Optional)Optionally specify the Konnected device’s IP address or hostname to set up without discovery.

port

(integer)(Optional)Optionally specify the port number for the Konnected API on the device. Note that the port is different on every device. See help.konnected.io to learn how to determine the port number.

discovery

(boolean)(Optional)Enable or disable discovery for this device. When true, the device will respond to discovery requests on your network. When false, the device will not respond to discovery requests, so it’s important that you set reserved IP for the device and configure the host and port here.

Default value: true

blink

(boolean)(Optional)Blink the blue LED upon successful transmission of a state change.

Default value: true

# 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