Gammu README versione 02.agosto.

2002 -----------------------------------DESCRIZIONE Gammu e' un programma che permette di effettuare numerose operazioni con telefon i cellulari Nokia e di altre marche, collegati al PC tramite cavo o porta a infrar ossi: invio/ricezione suonerie, loghi accensione, loghi operatore, messaggi con disegn i ecc; gestione SMS (backup, modifica, invio tramite computer); attivazione NetMonitor su telefoni DC3 (vedere sito http://marcin-wiacek.topnet.pl per maggiori informazio ni su NetMonitor); backup e ripristino dei dati sul telefono, ecc. Il programma e' distribuito con licensa GNU GPL (vedere file "copying"). VERSIONI DISPONIBILI Gammu e' disponibile per vari sistemi operativi, tra cui anche Windows nelle sue varie versioni, ed e' disponibile anche in formato sorgente, in modo da poter es sere compilato su qualunque sistema operativo. L'AUTORE Il programma e' stato creato inizialmente da Martin Wiacek, basato in parte sul programma "Gnokii" (www.gnokii.org), ma ha ricevuto molti contribti da molte altre persone , essendo un programma di tipo "open source", ossia modificabile, dietro autorizzazione de ll'autore, da chiunque sia in grado di apportarvi migliorie di qualunque genere. CONTRIBUTI Chiunque puo' fornire il suo contributo al progetto Gammu, volto a supportare il maggior numero di telefoni e di funzioni possibile, per soddisfare le esigenze di tutti. E' possibile aiutare in molti modi: 1. Scrivendo codice che supporti altri modelli, o aggiustando il codice esistente, ove ce ne sia bisogno. Il formato e il metodo da usare per le aggiunte e ' descritto nei documenti riservati agli sviluppatori (developers). A questo proposi to, l'autore e' in possesso di specifiche per molti modelli (Motorola, Sagen, Siemens xx45), e basta implementare poche funzioni per avere il supporto di questi telefo ni... 2. Riferendo di malfunzionamenti del programma (vedere la sezione BUG RE PORT di questo documento). 3. Aiuto nella traduzione della documentazione. 4. Aiuto per scoprire i protocolli dei telefoni. 5. Suggerimenti per migliorare le cose :-) DOVE TROVARE L'ULTIMA VERSIONE L'ultima versione di Gammu puo' essere scaricata da http://marcin-wiacek.topnet. pl . Ci sono due versioni: stabile e in fase di sviluppo. La seconda e' possibile che venga aggiornata anche quotidianamente.

IN CASO DI PROBLEMI In caso di problemi col programma, ci si puo' rivolgere all'autore (marcin-wiace k@topnet.pl), oppure abbonarsi alla mailing list e cercare aiuto li'... --------------------Note tecniche Domanda. Come compilare il programma? Risposta. * cambiare i parametri nel file "config.h" * compilare: * utilizzando MS Visual C++ 6.0 per Windows: portarsi nella directory "/gnokii" e avviare "gnokii.dsw" * sotto Unix o Linux: selezionare il compilatore in "makefile.glo" (se necessario) e usare "make" * utilizzando Borland C++ 3.1 per MS-DOS: ho provato senza successo :-( ; E' RICHIESTO AIUTO. * sotto DJGPP per MS-DOS: usare semplicemente "make" :-) (si e' compilato senza problemi in MS-DOS puro sotto Windows 98 SE; us ando una finestra DOS sotto Windows XP, ho riscontrato problemi di memoria). NOTA: in queste prime versioni non e' possibile utilizzare Gammu compila to usando DJGPP - il driver per la porta seriale non e' ancora pron to! * sotto CygWin per Windows: Non l'ho provato, ma dovrebbe funzionare. * sotto Borland C++ Builder 5 trial: portarsi nella directory "gammu/bcc" e controllare se e' presente la d irectory "output" (semmai crearla), e poi avviare "gammu.bpr". CONSIGLIO: "gammu.bpr" e' stato creato usando "Tools/Visual C++ Projec t Conve..", e leggermente modificato. * sotto Borland C++ a linea di comando: portarsi nella directory "gammu/bcc" e controllare se e' presente la d irectory "output" (semmai crearla), poi digitare "make -fgammu.mak" dal prompt dei comandi. CONSIGLIO: "gammu.mak" e' stato creato usando Borland C++ Builder usan do l'opzione "Project/Export makefiles" dal menu principale. ------------------------------------------------------------------------------D. Dove trovare i compilatori per compilare Gammu? R. * MS Visual C++ 6.0: andate in un negozio di computer ;-) . E' un programma commerciale. * compilatori per Unix (Linux) come gcc o kgcc (gratis): disponibili su Internet e nelle distribuzioni Linux che si possono tr ovare su molte riviste di informatica. L'installazione dipende dalla distribuzi one.

* DJGPP (gratis): vedere http://www.midpec.com/djgpp/ (potete trovarci molte informazion i) oppure 1. Andate direttamente su http://www.simtel.net 2. cercate la sezione DJGPP 3. scaricate i pacchetti: v2/readme.1st - Istruzioni per l'installazione di DJGPP v2/faq230b.zip - Le Domande Frequenti (FAQ,in inglese) su DJ GPP v2/djdev203.zip - Il kit di sviluppo DJGPP v2misc/csdpmi4b.zip - Il server DPMI v2gnu/bnu210b.zip - Le utility binarie GNU v2gnu/gcc2952b.zip - Il compilatore GNU C v2gnu/mak279b.zip - L'utility GNU Make o piu' recenti. 4. decomprimere tutti i pacchetti nella stessa directory (ad esempio C:\DJGPP) 5. aggiungere all'autoexec.bat queste linee: PATH C:\DJGPP\BIN;%PATH% SET DJGPP=C:\DJGPP\DJGPP.ENV * Borland C++ Builder: Vedere www.borland.com (e' un programma commerciale). Versioni dimostra tive vengono talvolta allegate a CD in riviste di informatica. * Borland C++ compiler (gratis): Vedere www.borland.com. Talvolta si trova su CD in edicola. ------------------------------------------------------------------------------D. Quali sono i problemi conosciuti? A 1. Nokia 3310 (3315): * i nomi della rubrica risultano vuoti. Per evitarlo, bisogna avere un firmware successivo al 4.06 sul telefon o. Per notizie sull'aggiornamento del firmware del telefono, vedi in fond o a questo file. * Non si possono salvare gli appuntamenti agenda, ma solo i Promemoria ( dopo aver aggiornato il firmware). Le versioni 5.11 e successive non sembra no essere in grado di salare altro che i promemoria (addirittura, nelle vecchie versioni questo fatto non era nemmeno ufficiale). 2. Nokia 6210 (forse anche 6250/7110): * Salvando alcuni SMS come loghi o suonerie sul teelfono e poi rinviando li dal menu del telefono, essi vengono danneggiati. Non e' un problema di Gammu. Un semplice test lo dimostra: salvate un messaggio di questo tipo sulla SIM inserita in un vecchio Nokia, co me un 6150. Inviatelo tramite il menu del 6150. E' a posto. Ora mettete la SIM in un 6210, e inviate il messaggio del menu: ora e' rovinato!

* Il telefono non avvisa di tutti gli SMS in arrivo. Purtroppo, conosciamo solo il frame (*) che abilita l'avviso solo di c erti SMS. E ci sono problemi anche con quelli. Per questo motivo quest'opzione e ' in genere disabilitata in Gammu, occorre abilitarla in fase di compilazione del programma modificando il file "config.h". * Salvando SMS sul telefono come non letti, non compare il simbolo di "n uovo messaggio". Spiacente. Chiedete alla Nokia se e' possibile averlo. * Dopo aver cancellato il logo operatore, esso resta visibile finche' no n si riavvia il telefono. Ringraziate la Nokia per questo. 3. Nokia 7110: impossibile leggere suonerie in formato binario dal telefono. Aggiornate il firmware (*). Il piu' recente e' il 5.01 e funziona. 4. Tutti i telefoni Noia con gruppi chiamanti: inviando a un modello di tel efono il backup fatto su un altro modello, le suonerie non risultano selezionabil i dal menu, o risultano differenti. Ogni modello Nokia puo avere un IDentificatore diverso per le stesse suo nerie. Gli ID non vengono salvati da Gammu per ogni modello, perche' ora (per i telefoni DCT3) e' terribilmente facile cambiarli e una simile lis ta non sarebbe mai aggiornata. Per questo motivo, bisogna fare il backup de i gruppi chiamanti in formato testo, e rimuovere le righe con gli ID. Cosi ', dopo il ripristino sul telefono sara' possibile selezionare le suonerie dal m enu. 5. Il telefono (o forse Gammu) non da' informazioni sul Cell Broadcasting. Per default questa caratteristica e' disabilitata su Gammu (vedere opzio ni di compilazione nel file "config.h"), poiche' alcune persone hanno riscontr ato problemi: i loro telefoni non rispondevano subito a questo comando, o rispondevano con molto ritardo. Personalmente, io non ho avuto questo problema. Se volete, sper imentate il comando (Ma dovrete ricompilare Gammu con le opportune opzioni nel fi le "config.h"). Sel funziona, tanto meglio! 6. La seconda suoneria del 3210, che non puo' essere impostata . Ebbene, non so che farci. Usate --nokiacomposer per inserire manualmente la suoneria! --------CONSIGLIO: Per saperne di piu' sugli errori dei firmware Nokia, visitate il s

ito: http://marcin-wiacek.topnet.pl ------------------------------------------------------------------------------D. Come riferire ai programmatori gli errori del programma? R. Se il programma non funziona affato o comunque da' problemi, usare il paramet ro "logfile" nel file "gnokiirc" (un esempio di file "gnokiirc" e' nella ca rtella /docs/examples), in modo da creare un cosiddetto "file di log". Impostare ad esempio tale parametro su "rapporto", e avviare il programm a con l'opzione che non funziona. Verra' creato un file "rapporto". Esamin atelo. Se ci sono delle righe che iniziano con "[ERROR:", leggete qui sotto cos a fare col file. Se invece non ci sono queste righe, impostare "logfile" a "binary" (esat tamente questo nome), e avviate di nuovo l'opzione che da' problemi. Verra' crea to un log "binary". Vedi sotto cosa fare con questo file. COSA FARE COI FILE DI LOG: Occorre inviarli alla mailing list di Gammu, o direttamente all'autore (marcin-wiacek@topnet.pl) (se volete evitare di inviare questi dati a tutti i membri della mailing list). Se i file sono troppo grandi, comprimeteli. A questi file potrete aggiungere: 1. (Se usate Linux o Unix): Il nome della distribuzione, la versione del kernel. 2. Almeno una breve descrizione del problema. Non serve accludere il file gnokiirc, le impostazioni vengono salvate nel fil e di log. Grazie per il feedback! CONSIGLIO: ), il file di log conterra' solo gli errori. Dopo aver usat o per un po' Gammu, esaminate questo file per vedere se ci sono stati problemi. ------------------------------------------------------------------------------D. Chi ha aiutato a scriverlo? R. Qui ci sono alcune persone che hanno contribuito allo sviluppo del progetto. Probabilmente non sono menzionati tutti (specialmente nella versione tradotta di questo file...). Se credi che il tuo nome debba comparire nell'elenco, fac celo sapere. * tutte le persone che hanno sviluppato "gnokii" (alcune idee sono prese da li') come Pawel Kot, Manfred Jonsson,... (vedere i CREDITS di "gnokii"). * tutti i responsabili del progetto "MyGnokii", come Gabriele Zappi, Ral f Thelen, ... (vedere CREDITS di "MyGnokii"). * Marcin Wiacek - l'autore di tutta 'sta roba! * Markus Plail & Tibor Harsszegi - per l'aiuto sul DCT4 impostando "logfile" a "errors" (esattamente questo nome

* Frederick Ros - aiuto per il 5210 * Jan Ktatochvil - comandi AT * Walek - aggiustamenti vari ------------------------------------------------------------------------------D. Che modelli sono supportati? R. 1. 3210|3310|3330|3390|3410|5110|5110i|5130|5190|5210|5510|6110|6130|6150| 8210|8250|8290|8850|8855|8890: Questi dovrebbero funzionare tutti (apparte forse alcuni dettagli), ora o in futuro. Ho testato personalmente 3210, 3310, 5110 e 6150. 2. 3510|6310|6310i|6510|8310|8910: Molto ben testati (specie il 6310i). Dovrebbe funzionare tutto, ora o prossimamente. DA FARE: * lettura sveglia * supporto completo di messaggi grafici e loghi * impostazione suonerie binarie * netmon, ALS * reset per tutte le connessioni 3. 6210|6250|7110: Molto ben testati (specie il 6210). Dovrebbe funzionare tutto, ora o prossimamente. DA FARE: lettura nomi dei messaggi 4. 9110|9210: Netmonitor attivato sul 9210, probabilmente funziona anche qualcos'altro. 5. Telefoni AT: Testati vari telefoni Nokia. Molte cose funzionano al 100%, come il support o SMS (sia in modalita' testo che PDU), rubrica... DA FARE: Supporto per Siemens.

6. Altre cose da fare: Profili Deviazione chiamate Conversione di tutti i tipi di suonerie Decodifica completa del Cell Broadcasting Driver seriale per DJGPP ------------------------------------------------------------------------------D. Che formati sono supportati? R. loghi : xpm (solo salvataggio), bmp, nlm, nsl, ngg, no l suonerie : rttl, binary format created for Gammu, mid (salvataggio), re (lettura), ott, formato Nokia Communicator trovato su fkn.pl . backup/ripristino : formato testo creato da Gammu, lmb (avvio, rubrica, gruppi chiamanti) backup/ripristino SMS: formato testo creato da Gammu. -------------------------------------------------------------------------------

* FRAME: E' una sequenza di dati inviati da Gammu al telefono per fargli c ompiere le operazioni desiderate. Gli autori di Gammu hanno ricavato il formato dei FRAME utilizzati dai Nokia non da documentazione ufficiale, ma tramite analisi dei dati trasmessi attraverso la porta seriale (vedere la cartella "develop" per dettagli). ** Che cos'e' il FIRMWARE del telefono? Il FIRMWARE e' il sistema operativo del telefono, ossia il programma che permette al telefono di funzionare. Un cellulare, infatti, non e' un altro che un co mputer in grado di gestire la comunicazione a voce tra due (o piu') utenti, e c ome tutti i computer ha bisogno di programmi, per funzionare: il FIRMWARE, a ppunti ; esso sta a meta' tra l'HARDWARE, che e' l'insieme dei circuiti che compongono un co mputer, e non puo' essere modificato, e il SOFTWARE, ossia i programmi che utili zzano l'hardware per funzionare; infatti, il FIRMWARE e' software memorizzato "stabilmente" sull'hardware. Tra virgolette, perche' per un utente comun e il firmware di un cellulare resta quello finche' il cellulare non viene but tao, perso, venduto o quant'altro. Gli utenti piu' evoluti, pero', possono riuscire a modificare il firmware, mediante un'operazione detta FLASHING, effettu ata mediante particolari programmi detti FLASHER. In teoria, solo le case produttrici possiedono questi programmi, per cui per aggiornare il firmware del vostro cellulare dovreste portarlo in un cent ro assistenza autorizzato... da dove verrebbe spedito alla sede centrale de lla ditta, magari a 500 km dalla vostra citta', e lo rivedreste solo dopo 1 o 2 mes i, e dopo un esborso di 20-30 euro o piu'. IN PRATICA, su internet e' possibile trovare tutti gli ingredienti per " flashare" da soli il proprio cellulare; il problema e' che occorre una cosa fondam entale, il cavetto adatto per effettuare il flashing, che puo' costare anche mol to di piu' dell'operazione effettuata secondo i canali ufficiali! Oltre a questo, o ccorre, come detto, il software flasher, e poi ovviamente il firmware aggiornato ; questo, pero', si da' il caso che sia protetto da copyright da parte della casa che produce il telefono, e distribuirlo sulla rete e' illegale... Sul sito di Gammu (http://marcin-wiacek.topnet.pl) potete trovare dettag li su pregi e difetti delle varie versioni di firmware, ma non il materiale su ddetto, per trovare il quale dovrete fare delle ricerche su internet usando appu

nto parole come "firmware", "flashing", "mobile phone" eccetera.