I. INTRODUCTION

UPnP Metering Graph Tool is a graphical application(script) which allows a user to monitor the power consumption of his/her home electrical infrastructure directly on his TV-set, Digital Media Player or other DLNA-enabled media renderer device. The application is based on dSS Metering API and implemented using UPnP protocol. The whole system comprises a dSS server, a UPnP
server(MediaTomb) and a Digital Media Player or simply a TV-set with DLNA support. The application allows a user to select the required time interval and see the power consumption data in a graphical form.

UPnP Metering Graph Tool exploits the ActiveItem feature provided by MediaTomb server and based on Python interpreter. This gives a possibility of easy customization including filtering, statistical calculations and other post-processing of the metering data. The tool also uses well-known free software to prepare the graphical representation of the metering data:
GNUPlot utility and PIL python library to draw the diagrams - both provide a wide set of functions from changing colors to adding a company logo and changing a look according to the needs of a customer.

II. PREREQUISITES:

you may need to install:
python-mysqldb
gnuplot
mediatomb



III. MANUAL SETUP

1. Go to MediaTomb web page and add a folder for dSS Metering items (e.g. [dSS Metering])
2. From within the [dSS Metering] folder create a folder for each time-range you need. e.g.:

    |
    -[dSS Metering]
        |
	- [last 5 minutes]
        |
	- [last hour]
        |
	- [last week]
        |
	- [last month]
        |
	- [last year]

3. From within of each folders create an active item for the corresponding time-range. You'll have the following structure:
    
    |
    -[dSS Metering]
        |
	- [last 5 minutes]
	    |
	    - last 5 minutes of metering data
        |
	- [last hour]
	    |
	    - last hour of metering data
        |
	- [last week]
	    |
	    - last week of metering data
        |
	- [last month]
	    |
	    - last month of metering data
        |
	- [last year]
	    |
	    - last year of metering data

Note: that's important to have exactly one active item within the corresponding folder because the UPnP media-renderers usually do the slideshow of a particular folder. This usually has a side efect that the plot is updated each several seconds giving an impression of real-time animated plot.

4. The following rules are applied to each of tha active items:
active items - usually each one for the related time interval: 5 minutes, hour, day, week, month and a year. 
	4.1 Location: You must link each of the items to some physically existing media file. You can use any file you like for the corresponding item: e.g. dSSError.jpg from the package or any other. The exact item will be substituted once the script is triggered.
	4.2 Class: object.item.activeItem
	4.3 Mimetype: 'image/jpeg'
	4.4 ActionScript should point to 'dss_script.py' from the attached package 
	4.5 State: used for passing the argumets to the script. It has the following format: 
		t:<TIME_INTERVAL>;dSS_ip:<DSS-SERVER-IP>;dSS_port:<DSS-SERVER-PORT>, where
		1) TIME_INTERVAL can be on of the following: 5minutes, hour, day, week, month, year
		2) DSS-SERVER-IP is an IP address of the dSS server
		3) DSS-SERVER-PORT is a dSS server port
	
		For Example:
		t:5minutes;dSS_ip:192.168.0.146;dSS_port:8080
		t:day;dSS_ip:192.168.0.16;dSS_port:8080



IV. SUPPORT CONTACTS

The script is developed by EPSCom AG. (www.epscom.net)
If you have any questions using the script or need to customize it or modify some parts of it, please contact:
Sasha Oplatckin sasha.oplatchkine@epscom.ru
Vasiliy Shmyrev vasiliy.shmyrev@epscom.ru