Skip to content

MPParsley/plugctl

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

plugctl

Control your Smartplug from Maginon / Aldi
Based upon information from https://www.dealabs.com/bons-plans/prise-wifi-/85521?page=36 and https://github.com/netdata/loxone/tree/master/maginon_Smart-Plug

Build

Make sure you have Go properly installed, including setting up your GOPATH

Next, run

$ cd $GOPATH
$ go get github.com/42wim/plugctl

You'll have the binary 'plugctl' in $GOPATH/bin

Usage

$ plugctl
  -conf="": a valid config file (uses plugctl.conf if exists)
  -credentials="admin:admin": credentials specify as <login>:<pass>
  -csvfile="output.csv": file to write csv output to (only used with -daemon)
  -daemon=false: run as a (foreground) daemon with polling webserver
  -debug=false: show debug information
  -delay=1: polling delay of statistics in seconds (only used with -daemon)
  -disable="": disable power/cloud/ap
  -enable="": enable power/cloud/ap
  -ip="": ipv4 address of smartplug device
  -port=8080: webserver port (only used with -daemon)
  -raw="": raw command to execute on device (via telnet)
  -show="": show info/uptime/power
  -toggle="": toggle power
  • enable

    • power : enable power output of the plug
    • ap: disable AP mode on the smartplug (for security reasons). Also saved in NVRAM (survives reboot/powerfailure)
    • cloud: disable connections from smartplug to the cloud (iotc). Does not survive a reboot/powerfailure!
  • disable: opposite of enable options above

  • toggle:

    • power: toggles power output of the plug
  • show

    • info: shows current Ampere - Watt - Watt/hour - Volt usage
    • power: shows if power output is on or off
    • uptime: show uptime of the device
  • raw "command": executes a command on the plug (it's running busybox/linux)

    here you can chain commands. eg command1 && command2

  • daemon: starts a webserver and polls the device every second for information

    • port: specify listen port for the webserver (default 8080) (only needed with -daemon)
    • csvfile: specify cvsfile to write to (default "output.csv") (only needed with -daemon)

Configfile

See plugctl.conf.sample (https://github.com/42wim/plugctl/blob/master/plugctl.conf.sample)

If plugctl.conf exists in the current directory it will be used, otherwise a config file can specified using the -conf flag

E.g. The ip of your plug can be specified in plugctl.conf, so you don't need to give the -ip option with every command

Webserver

When -daemon option is used, a webserver will listen by default on port 8080

Available URL

  • /history - webpage/javascript which parses the csvfile history + current data into a chart history

  • /stream - webpage/javascript which shows a realtime chart stream

Examples

Enable plug on ip 192.168.1.50 with login admin and password test

$ plugctl -ip 192.168.1.50 -credentials "admin:test" -enable power
enabling plug.

Get usage information about plug on ip 192.168.1.50 with default password

$ plugctl -ip 192.168.1.50 -show info
0.01 Ampere - 0.07 Watt - 0.00 Watt/hour - 230.90 Volt

Disable the AP mode on the smartplug (for security reasons). This is saved on reboot!

$ plugctl -disable ap
disabling AP...success
saving state...already set

View the CPU info of the device by using the raw command

$ plugctl -raw="cat /proc/cpuinfo"
system type             : Ralink SoC
processor               : 0
cpu model               : MIPS 24K V4.12
BogoMIPS                : 239.61
wait instruction        : yes
microsecond timers      : yes
tlb_entries             : 32
extra interrupt vector  : yes
hardware watchpoint     : yes
ASEs implemented        : mips16 dsp
VCED exceptions         : not available
VCEI exceptions         : not available

Get all the usage information Watt/Ampere/Energy/Volt in one go using the rawt command

$ plugctl -raw "GetInfo W && GetInfo I && GetInfo E && GetInfo V"
$01W00 000007
$01I00 000064
$01E00 002134
$01V00 236728

Start daemon/webserver on port 8888 with debug and device on ip 192.168.1.50 and save CSVfile to plug.csv

$ plugctl -daemon -debug -port 8888 -ip 192.168.1.50 -csvfile plug.csv
starting foreground daemon ;-)
[2015/01/11 21:28:13 3.84 66.37 4.47 233.06] took 392.1955ms
[2015/01/11 21:28:14 3.82 66.37 4.47 233.12] took 366.52ms

You can now surf to http://localhost:8888/stream to see realtime chart updating. If you're running for a while or have historic data in plug.csv you can go to http://localhost:8888/history

About

Smartplug Maginon controller

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 100.0%