 *** Plugin Feeds Hunter versione 0.1.0.beta - by Pro. Com. Service s.a.s.***
 
 - PERCHE' QUESTO PLUGIN
	Perch la programmazione, prima di essere il nostro mestiere,  la nostra 
passione che unita a quella per la ricezione satellitare (soprattutto per i 
feed) da luogo ad una incontenibile voglia di divertirsi. Se a tutto ci si 
aggiunge un pizzico di Linux....la cosa diventa maniacale ;-)

- COS'E' QUESTO PLUGIN
	FeedsHunter permette di impostare un range di frequenze da esplorare, uno step 
per esplorare il range, una polarit, un symbol rate e .... si avvia la 
scansione e si aspettano fiduciosi i risultati. Appena FH aggancia un segnale 
valido procede con step 1 per trovare la frequenza migliore e poi sintonizza 
automaticamente i canali presenti su quel transponder. Fatto ci riprende ad 
esplorare il range con lo step prescelto alla ricerca di un nuovo transponder 
valido. FH mentre esplora le frequenze produce un grafico dei valori di SNR 
(bianco) e AGC (verde) per ogni valore di frequenza esplorata. Nella parte 
superiore del grafico  presente una barra di avanzamento per indicare la 
percentuale del range esplorato e una seconda barra per poter scorrere il 
grafico con i tasti 'destra' e 'sinistra' del telecomando. Terminata la 
scansione viene mostrato un messaggio che comunica la fine dell'esplorazione;
a questo punto  possibile esplorare il grafico per vedere 'zone' di frequenza 
particolarmente interessanti o chiudere la finestra con il tasto 'annulla'.

- COME E' SCRITTO QUESTO PLUGIN
	FH  scritto in C++ appoggiandosi alle classi sviluppate per Enigma e funziona 
con tutte le immagini da noi provate. Se qualcuno avesse problemi con qualche 
particolare immagine pu comunicarcelo e cercheremo di risolvere il problema (se 
possibile). Nello scrivere il plugin abbiamo cercato il pi possibile di usare 
una programmazione C particolarmente semplice (chi conosce il C sa bene quanto 
possa essere criptico questo linguaggio se lo si vuole o se si mira 
all'ottimizzazione del codice). Questa 'filosofia' di scrittura ha portato 
ovviamente ad un codice non particolarmente elegante e ottimizzato ma in questo 
caso ci  sembrato pi importante che il codice fosse di facile comprensione 
piuttosto che veloce o elegante (per capire il perch...continua a leggere)

- CHE TIPO DI LICENZA HA QUESTO PLUGIN
	FH viene rilasciato sotto i termini della licenza GPL quindi  assolutamente 
gratuito, modificabile e ridistribuibile a patto di ridistribuire tutti i file 
di cui  costituito compreso questo.

- MA I SORGENTI NON CI SONO, COME LO MODIFICO?
	In questa prima versione i sorgenti non ci sono per 2 motivi:
	
1) Per la fretta di scriverlo e per il poco tempo che il lavoro ci lascia 
(ricorda che questa  una nostra passione...ma con le passioni si fa la fame) il 
codice necessita di una revisione e dell'aggiunta di abbondanti commenti per 
aiutare chi  alle prime armi a capire come programmare il DreamBox;

2) Le operazioni di cui al punto 1 necessitano di tempo per cui se FH dovesse 
avere successo ;-) allora saremo lieti di dedicare tempo al sorgente e renderlo 
pubblico in maniera degna. Pertanto se le richieste dei sorgenti saranno in 
numero sufficiente pubblicheremo i sorgenti.

- CHE COSA NON E' QUESTO PLUGIN
	Non  un prodotto commerciale della nostra azienda per cui (purtroppo) occupa 
un posto non di priorit nelle cose da fare dell'azienda e dei suoi soci. Questo 
vuol dire che ci prodigheremo per migliorarlo ma subordinatamente agli impegni 
di lavoro.

- RESPONSABILITA'
	La Pro. Com. Service s.a.s. non si assume alcuna responsabilit diretta o 
indiretta circa l'uso proprio o improprio del plugin e circa eventuali danni 
diretti o indiretti a persone o cose derivanti dall'uso del plugin stesso. 
L'utilizzatore  l'unico responsabile e, nel caso in cui voglia manifestare il 
suo dissenso circa le suddette responsabilit, pu semplicemente non utilizzare 
il plugin.

- FILES
	Il file compresso contiene i seguenti file:
		feedshunter.cfg (file di configurazione del plugin)
		feedshunter.esml (skin per il plugin...al momento utilizzato solo in parte)
		feedshunter.so (il plugin)
		readme.txt (ci che stai leggendo)
		readme_eng.txt (readme in inglese...se lo si pu chiamare inglese)
	
- INSTALLAZIONE
	Decomprimere in una cartella il file compresso
	Copiare mediante un programma di FTP i file
		feedshunter.cfg
		feedshunter.esml
		feedshunter.so
	nella cartella dei plugin (di solito /var/tuxbox/plugins) del DreamBox
	Fatto!
	
- BUGS CONOSCIUTI
------------------Sintomo
	Uscendo dal plugin (se FH ha trovato dei canali) non viene ripristinato il 
canale su cui ci si trovava quando si  avviato FH; di solito appare una scritta 
tipo 'service not found'
------------------Rimedio
	E' sufficiente andare al canale successivo e poi tornare indietro

- DIFFICOLTA'
	Le difficolt incontrate nella realizzazione di FH sono derivate principalmente 
dalla assoluta mancanza di documentazione sulle funzioni del DreamBox 
desumibili, pertanto, solo dallo studio del codice sorgente di Enigma. Questo 
studio, per quanto educativo e appassionante, allunga notevolmente i tempi di 
sviluppo e le incertezze su alcune operazioni. Da queste considerazioni nasce il 
desiderio di rendere pubblico il codice commentato in modo da scambiare opinioni 
con altri appassionati e rendere un p pi facile la vita a chi si avvicina per 
la prima volta alla programmazione del DreamBox. L'esortazione  quindi a 
scambiarsi il maggior numero possibile di informazione sui forum dedicati 
all'argomento.


- RINGRAZIAMENTI	
Desidero ringraziare personalmente le persone della Pro. Com. Service s.a.s. che 
mi hanno supportato e sopportato per la realizzazione di FH, mia moglie per la 
sua pazienza, Spallared per la pazienza e la disponibilit dimostrata nei miei 
confronti quando mi imbattevo nelle prime difficolt relative al setup del CDK 
per lo sviluppo e Robb per i suggerimenti sul debug dei plugin.

- COSE DA FARE
	Le idee sono tante e l'unico impedimento  il tempo...
Aspettiamo comunque suggerimenti (e anche critiche) da tutti coloro che 
utilizzando FH vorranno segnalarci bug e miglioramenti apportabili.

A nome di tutto lo staff......ciao Router