Fork me on GitHub

pimatic-edimax by Marcus Wittig | github | npm

pimatic-edimax

npm version Build Status Dependency Status

Pimatic Plugin for Edimax WiFi SP-1101W and SP-2101W Smart Plugs based on edimax-smartplug.

Important Notice

The recent firmware versions published for EdiSmart/Amazon Alexa Integration are currently not supported by edimax-smartplug:

  • SP2101W: v2.09 and higher
  • SP1101W: v1.05 and higher

If you have installed the new version and wish to downgrade you can use the downgrade guide provided as part of the edimax-smartplug github project.

Contributions

If you like this plugin, please consider ★ starring the project. Contributions to the project are welcome. You can simply fork the project and create a pull request with your contribution to start with.

Plugin Configuration

You can load the plugin by editing your config.json to include the following in the plugins section. The property interval specifies the time interval in seconds for polling the state information of the Smart Plugs. For debugging purposes you can also set the property debugto true. For normal operation the latter is not recommended.

{ 
   "plugin": "edimax",
   "debug": false,
   "interval": 30
}

Device Configuration

screenshot

The plugin offers two device types:

  • EdimaxSmartPlugSimple: This type of device provides basic power switching capabilities (ON/OFF).
  • EdimaxSmartPlug: This type of device additionally provides power metering suitable for Edimax SP-2101W.

You can either use the device editor to manually a Smart Plug device, or you can use the automatic device discovery function of pimatic to find smart plugs connected to your local network.

As part of the device definition you need to provide the deviceName and password which have been set using the EdiPlug app provided by Edimax. Note, the deviceName refers to the Name field of the plug settings.

{
  "id": "sp1",
  "class": "EdimaxSmartPlug",
  "name": "Schaltsteckdose",
  "deviceName": "edimax",
  "host": "192.168.178.65",
  "password": "1234"
}

Advanced Configuration

Recover State

In my opinion Edimax Smart Plugs lack an essential feature, namely they do not fully recover their last state after a power failure. Say, the switch had been turned ON and you have power outage for a few minutes (you can simulate this by pulling the smart plug and plugging it to the mains socket again). In this case, the smart plug will remain OFF. How bad is this! To deal with this issue the recoverState feature (deactivated by default) has been added to automatically recover the state after a failure or pimatic has been started. Be warned, however: Don't plug critical devices such as a freezer to the smart plug! To enable the recoverState feature you need to set the property to true as shown below:

{
  "id": "sp1",
  "class": "EdimaxSmartPlug",
  "name": "Schaltsteckdose",
  "deviceName": "edimax",
  "host": "192.168.178.65",
  "password": "1234",
  "recoverState": true
}

If you wish to hide the sparkline (the mini-graph) of the attribute display or even hide an attributed this is possible with pimatic v0.8.68 and higher using the xAttributeOptions property as shown in the following example. Using the xLink property you can also add a hyperlink to the device display.

{
    "id": "sp1",
    "class": "EdimaxSmartPlug",
    "name": "Schaltsteckdose",
    "deviceName": "edimax",
    "host": "192.168.178.65",
    "password": "1234",
    "recoverState": true
    "xLink": "http://fritz.box",
    "xAttributeOptions": [
        {
            "name": "energyToday",
            "displaySparkline": false
        },
        {
            "name": "energyWeek",
            "displaySparkline": false
        },
        {
            "name": "energyMonth",
            "hidden": true
        }
    ]
}

History

See Release History.

License

Copyright (c) 2015-2017, Marcus Wittig and contributors. All rights reserved.

AGPL-3.0

Plugin Config Options

pimatic-edimax plugin config options
OptionDescriptionDefault
interval
number
Polling interval for switch state in seconds, value range [10-86400] or 0 to use device setting
60
debug
boolean
Debug mode. Writes debug message to the pimatic log
false

Device Config Options

pimatic-edimax device config schemas

EdimaxSmartPlugSimple

Edimax Smart Plug
OptionDescriptionDefault
deviceName
string
The name of the Smart Plug as shown by the EdiPlug configuration app
host
string
Hostname or IP Address of the Smart Plug
username
string
Username for the REST API
"admin"
password
string
Password for the REST API
"1234"
interval
number
Polling interval for switch state in seconds, value range [10-86400] or 0 to use plugin setting
recoverState
boolean
If true, recover switch state from database on startup and after failure
false

EdimaxSmartPlug

Edimax Smart Plug with Power Metering
OptionDescriptionDefault
deviceName
string
The name of the Smart Plug as shown by the EdiPlug configuration app
host
string
Hostname or IP Address of the Smart Plug
username
string
Username for the REST API
"admin"
password
string
Password for the REST API
"1234"
interval
number
Polling interval for switch state in seconds, value range [10-86400] or 0 to use plugin setting
0
recoverState
boolean
If true, recover switch state from database on startup and after failure
false
pimatic-edimax is written by Marcus Wittig