## Ncam-Info V1.1
## by Marouan

This plugin shows several information about a running Ncam-server. If the server runs
on the local box ( the box this plugin is installed on ), it is possible to get the
username and password for accessing the ncam-webinterface directly from the file ncam.conf.
If this behaviour is not wanted, or there is no ncam running on this box, you can enter
the required data manually to access external servers.

Requirements:
	
The Plugin should be working on any box running Enigma2, though it is made and tested by
me only on Dreamboxes with an original image.
As the plugin accesses the XML-API of ncam, which is still in development, I recommend to
use one of the latest versions, because with older versions the plugin may not get all,
or even no information from ncam.
This version of NcamInfo (V 1.1) has been tested starting with Ncam V1.6.


When you start the plugin, the main menu looks as follows:
	
[red]	Show /tmp/ecm.info
	-> says exactly what it does ;)
[green]	Show Clients
[yellow] Show Readers/Proxies
[blue]	Show log
	-> shows the latest entries in the log
[1]	Card infos (CCcam Reader)
	-> shows a overview about received cards of a CCcam-server
[2]	ECM Statistics
	-> gives the ecm statistics of a selected server
[3]	Setup
[4]	Show Readme
	-> This text...
	
When "Show Clients" or "Show Readers/Proxies" is selected, the results are shown
in different colours. Clients with status "OK" and Readers/Proxies with status
"CONNECTED" or "CARDOK" are shown in green, readers with status "NEEDINIT" are shown
in yellow and clients or readers with status "OFF" or "ERROR" are shown in red.

When displaying the log, nothing changed compared to earlier versions of this plugin,
except for sorting the result. In this version the lines are shown as they are
read out from the webinterface and no longer in reverse order.

When in client-, server or log view the displayed source can be changed using the
colour buttons ( green -> clients, yellow -> servers, blue -> log ).

The card-info screen for CCcam-readers gives an overview about the received cards.
If just one cccam-server is configured, its data will be shown directly. If there
is more than one server, a choicebox asks for which server should be shown.
Available information is CAID, cryptsystem, number of cards on hop 1,2,3,4,5,
total number of cards and the reshare value. Additionally a summary of providers
which can be decrypted by this card.

The ecm-statistics give a summary about ecm request to available servers. When this
item is selected, the desired server can be selected in a choicebox.
Available information is the name of the server, CAID, channel name, average ecm-time,
last ecm time, status (found/not found), time of last request and total sum of ecms.

In the setup screen you can choose, if username and password should be read from
ncam.conf or not. If set to yes, there is only one more configurable item, which is
"automatically update client/server view?". If this is set to "Yes", the interval can
be set between 10 and 600 seconds. This means, that the data in client, server or log
view is updated every x seconds, depending on this setting.
If "read userdata from ncam.conf" is set to "No", you can enter username, password,
ip address and port manually.

All views (client, server, log, cardinfos or ecm statistics) can be updated manually by
pressing OK on the remote control, no matter if automatic update is on or off in the
setup.

Have fun

Marouan
