Difference between revisions of "SmartPlug GUI Images"

From OpenCircuits
Jump to navigation Jump to search
Line 19: Line 19:
  
 
= SmartPlug GUI =
 
= SmartPlug GUI =
  Note that this screen shot was taken during a debugging session and has some artifacts that will soon disappear, features that will be improved, then a new screen shot should be placed here.  
+
 
 +
This application provides for live control and monitoring of smart plugs.  Some of the functions are common to both apps this will be noted here.  Note that this screen shot was taken during a debugging session and has some artifacts that will soon disappear, features that will be improved, then a new screen shot should be placed here.  
  
 
Keeping screen shots up to date is a pain, these may lag the actual application which should look and perform better as time goes by.
 
Keeping screen shots up to date is a pain, these may lag the actual application which should look and perform better as time goes by.
Line 33: Line 34:
 
*<Help>              >Open help file ( which mostly links to this wiki ?? )
 
*<Help>              >Open help file ( which mostly links to this wiki ?? )
  
== Applcation Widgets ==
+
== Application Widgets ==
  
*<Device button>
+
*<Device button>:  Displays the name of the device, when pressed the message area will display a broad collection of data about the device.
*<On>
+
*<On/Off>:  Turns the device on/off.
*<Off>
+
*<Monitor On/Off>:  When on displays power in a right hand column to right of window.  Also enables graphing of the device.  ( Plugs that do not support energy reporting may throw a nasty error )
*<Record On>
+
*<Record On/Off>:  Turns the device power, energy recording ( to the database ) on/off.
*<Record Off>
+
*<Start Timer>:  Turns device on and begins a countdown to turn it off.
*<Retrieve>
+
*<Live Graph>Start and stops live graphing ( in separate window ).
*<Start Timer>
 
  
 
== Message Area Widgets ==
 
== Message Area Widgets ==
The message area is the large white area at the bottom left of the window.  It is a scrolling text area.  It is present in both applications.
+
The message area is the large white area at the bottom left of the window.  It is a scrolling text area. It keeps a finite number of lines as set in parameters.py It is present in both applications.
  
*<Clear>
+
*<Clear:  Clears all messages.
*<Copy Sel>
+
*<Copy Sel>:  Copies selected/highlighted ( select with mouse ) into the clipboard
*<Copy All>
+
*<Copy All>:  Copies all the data.
*A Scroll checkbox
+
*<Scroll> checkbox: Turn on and off auto scrolling of the message area, turning it off can make reading and copying easier.
  
 
= SmartPlug Graph GUI =
 
= SmartPlug Graph GUI =

Revision as of 08:56, 7 November 2019

General

This is the GUI for the project Python Control of Smart Plugs: There are two applications, ( smart_plug.py and smart_plug_graph.py ) which look very similar. In the images below both are show with their graphs open ( separate windows, available on demand ).

Differences Between the Applications

  • SmartPlug runs live, turns plugs on and off, sets timers..... and graphs data as it comes in.
  • SmartPlugGraph runs primarily off the database built by SmartPlug.

Similarity Between the Applications

  • Many of the widgets and functions are similar.
  • Both have message areas taking up most of the lower part of the window. It displays messages from other actions, and it is controlled by the widgets to its left.
  • Both can produce similar graphs ( one live graphs, the other from the database ).

Smart plug graph 1.png Smart plug 1.png


We will discuss each application in the sections that follow.

SmartPlug GUI

This application provides for live control and monitoring of smart plugs. Some of the functions are common to both apps this will be noted here. Note that this screen shot was taken during a debugging session and has some artifacts that will soon disappear, features that will be improved, then a new screen shot should be placed here.

Keeping screen shots up to date is a pain, these may lag the actual application which should look and perform better as time goes by.

Smart plug gui b.png

System Widgets

These widgets are present both the SmartPlug and the SmartPlug Graph application. They are related to managing the application, not to the purpose of the application.

  • <Edit Log> >Open the application python log file using the system editor specified in parameters.py file. Note: The edit functions work only after you have configured parameters.py for your systems text editor
  • <Edit Parms> >Open the application parameters.py file using the system editor, after the file has been modified. The system can be quickly restarted using the Restart button.
  • <Restart> >Quickly restarts the system after the parameters.py file is changed or any time you want to restart the system from its current defaults
  • <Help> >Open help file ( which mostly links to this wiki ?? )

Application Widgets

  • <Device button>: Displays the name of the device, when pressed the message area will display a broad collection of data about the device.
  • <On/Off>: Turns the device on/off.
  • <Monitor On/Off>: When on displays power in a right hand column to right of window. Also enables graphing of the device. ( Plugs that do not support energy reporting may throw a nasty error )
  • <Record On/Off>: Turns the device power, energy recording ( to the database ) on/off.
  • <Start Timer>: Turns device on and begins a countdown to turn it off.
  • <Live Graph>: Start and stops live graphing ( in separate window ).

Message Area Widgets

The message area is the large white area at the bottom left of the window. It is a scrolling text area. It keeps a finite number of lines as set in parameters.py It is present in both applications.

  • <Clear: Clears all messages.
  • <Copy Sel>: Copies selected/highlighted ( select with mouse ) into the clipboard
  • <Copy All>: Copies all the data.
  • <Scroll> checkbox: Turn on and off auto scrolling of the message area, turning it off can make reading and copying easier.

SmartPlug Graph GUI

Note that this screen shot was taken during a debugging session and has some artifacts that will soon disappear, then a new screen shot should be placed here.


Smart plug graph.png

System Buttons

These buttons are also present both the SmartPlug and the SmartPlug Graph application.

  • <Edit Log> >Open the application python log file using the system editor specified in parameters.py file. Note: The edit functions work only after you have configured parameters.py for your systems text editor
  • <Edit Parms> >Open the application parameters.py file using the system editor, after the file has been modified. The system can be quickly restarted using the Restart button.
  • <Restart> >Quickly restarts the system after the parameters.py file is changed or any time you want to restart the system from its current defaults
  • <Help> >Open help file ( which mostly links to this wiki ?? )

Graph Control

  • Next to Start date and hour: set date and hour to begin the selection of data for the graph ( default at startup set in parameters.py )
  • Next to Start date and hour: set date and hour to end the selection of data ( default at startup set in parameters.py )
  • Use check box to choose devices for data selection. Each device is graphed separately but on the same graph. ( list of devices defaulted in parameters.py )
  • Database file selected in space to right of label. Use <Browse> button to select file from your file system. ( default at startup set in parameters.py )
  • <Graph> button: create graph in new window -- there are additional controls on that window, see documentation below.

CSV

  • Data selection same as for the graph ( output file name set in parameters.py )
  • <CSV > button: create csv file from selected data.

Database

  • Database file: as above ( name a new file when creating an empty database )
  • <Define 0 DB>: create an empty, new database

SmartPlug Recording Graph

Graph 1.png

Sample of a graph

Graph Control

See also Graph GUI for other graph control, this is only for the controls on this window. Icons at the top left allow you to (hover over buttons for help):

  • Zoom in on data
  • Return to original display
  • Scroll around the graph
  • Adjust graph parameters
  • Save image to a file
  • Move forward and backward through views you have modified