PREREQUISITES:
you may need to install 
python-mysqldb
gnuplot
mediatomb



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



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