Skip to content

A CGI script that provides a simple web interface and RESTful JSON API for the Kankun Small K wifi switch.

License

Notifications You must be signed in to change notification settings

weichenw/kankun-json

 
 

Repository files navigation

kankun-json

A CGI script that provides a simple web interface and RESTful JSON API for the Kankun Small K wifi switch.

This project is a fork of Konstantin Dondoshanskiy's relay.cgi script.

Features

  • Get current status of switch
  • Set switch to on
  • Set switch to off

Getting Setup

  1. Copy the contents of this repository into the /www/ directory on your Kankun switch.
  2. Be sure permissions are set appropriately on the new directories and files (the device requires 0755 on cgi-bin files for the API to function correctly).
  3. Edit the switches.json file to use the IP addresses and labels appropriate for your switches.

Usage

Visit the IP address of your switch in your web browser:

http://10.0.0.10/

This should show you information about the switches, and allow you to control them.

e.g. You can see how to turn the switch on / off, or set delayed on / off.

Screenshots

Main web interface

Individual switch slide down

Example API Output

Output from the base end-point, http://10.0.0.10/cgi-bin/json.cgi. (Shown pretty-printed for legibility.)

{
    "info": {
        "name": "kankun-json",
        "version": "0.0.3",
        "ipAddress": "10.0.0.10",
        "macaddr": "00:15:61:f2:83:57",
        "ssid": "ireadyourmail",
        "channel": "11",
        "signal": "-83",
        "timezone": "EST-10EST,M10.1.0,M4.1.0/3",
        "uptime": "2:41"
    },
    "links": {
        "meta": {
            "state": "http://10.0.0.10/cgi-bin/json.cgi?get=state",
            "timing": "http://10.0.0.10/cgi-bin/json.cgi?get=timing"
        },
        "actions": {
            "on": "http://10.0.0.10/cgi-bin/json.cgi?set=on",
            "off": "http://10.0.0.10/cgi-bin/json.cgi?set=off"
        }
    }
}

Contributing

If you'd like to contribute to the development of kankun-json, please review the guidelines for contributing.

About

A CGI script that provides a simple web interface and RESTful JSON API for the Kankun Small K wifi switch.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 57.2%
  • Shell 34.7%
  • HTML 8.1%