3 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
4 <meta name="Author" content="Marcin Wiacek">
5 <title>GNOKII FAQ</title>
6 <link REL=stylesheet HREF="styl.css" TYPE="text/css">
11 <p align="RIGHT"><a class="autoremail" href="index.html">Main page</a></p>
12 <center><font color="#1F409F" size=+2 class="tytul">GNOKII FAQ</font></center>
14 <p><hr size="2" noshade width="60%" align="center" style="color: #004080">
16 <p><font color="#1F409F" size=+2 class="dzial">What is gnokii ?</font><br>
17 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
19 <p>Generally, what is gnokii (G from GNU, NOKII from Nokia) ?
21 <p>It is a name of project. The aim of it is to develop tools and drivers
22 for Nokia mobile phones. Of course, I think in this moment about really
23 different tools - for example, modem drivers, console tools, etc.
24 All created here software is released under the GNU
25 General Public License. Please see <a href="COPYING">COPYING</a>
26 for more details on license/copying issues,
27 the lack of warranty and where to send a postcard if you like gnokii :).
28 Anyway, our software works on many software (Linux, Free BSD, etc.)
29 and hardware (Intel, etc.) platforms...
31 <p><font color="#1F409F" size=+2 class="dzial">What software applications are created in gnokii project ?</font><br>
32 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
37 The first application, gnokii, is a command line utility that was
38 originally provided to assist developers and interested users in
39 working with the low level API functions that were being developed.
41 <p>From these rather humble beginnings, it has evolved into a the main
42 command line tool of the suite. Many people now use it for
43 reading/writing phone book entries, sending and receiving SMS messages
44 etc. Ultimately it is intended that it will become a utility that
45 communicates with gnokiid to provide a command line interface to
46 the functionality provided by the gnokiid daemon.
51 The second application provided is xgnokii which as the name suggests
52 is a X-windows based application that provides a graphical interface
53 to your phone. Amongst other things, xgnokii allows you to read and
54 write phone book entries, read, write and send SMS messages, monitor
55 battery and received signal strength.
57 <p>At present xgnokii works directly with the phone, however in the
58 future it will more likely use the "side" interface of gnokiid.
60 <p>The main author of it is <a href=mailto:ja@mail.upjs.sk>Jan Derfinak</a>
65 The third part of the suite is gnokiid. gnokiid provides a
66 virtual modem interface, /dev/gnokii that looks like a regular
67 Hayes-AT compatible modem with the ETSI defined extensions for
68 GSM phones. What this means in practical terms is that you can
69 treat the /dev/gnokii device like an ordinary modem and use it
70 to make data calls from pppd or a terminal application like
76 gnokiid is still under development, it's ultimate aim being to
77 act as a "master" daemon that interfaces with your phone on one
78 side and gnokii or xgnokii on the other. This "side" code is still
79 under discussion, particularly with respect to the most appropriate
80 choice of communication method (IPC, TCP/IP etc.)
85 The last application provided with the suite is mgnokiidev which is
86 used by gnokiid to create on demand a symbolic link between
87 /dev/gnokii and the pseudo tty used by gnokiid for the virtual
88 modem interface. It's operation is transparent under normal
89 usage as gnokiid takes care of calling it when required.
94 <p>This project also inspired some people to write other software for Nokia.
99 There is a perlmodule available for gnokii. It gives access to all
100 the routines that are defined in gsm-common.h from a perl-program. It
101 is intended for application developers who want to use their favorite
102 language in interfacing the phone data with databases, ldap-directories
103 and (in the future) different calendar applications. It is written by
104 <a href="mailto:konstantin@agouros.de">Konstantin Agouros</a>
105 and support starts with revision 0.2.6-pre3 of gnokii.
107 <p>The homepage of this module is
108 <a href="http://www.agouros.de/gnokii">http://www.agouros.de/gnokii</a>
112 <p><font color="#1F409F" size=+2 class="dzial">Which phones are supported ?</font><br>
113 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
115 <p>You can also ask, what phones are supported ? All, you want :-) Really !
117 <p>At first, we were making in gnokii project modules
118 for Nokia 3810/8110 and 51x0/61x0 phones. Later users started to
119 write parts for other Nokia phones. And we hope to extend it to another
120 models: 7110, etc. Remember: it's even possible to write modules
121 for other than Nokia phones
122 too (just imagine: support for the most popular phones in one software !)...
124 <p>In this moment we have modules for:
129 <td nowrap><b>Designed for</b></td>
130 <td><b>Works with</b></td>
131 <td><b>People, who are responsible ;-) for it (you can ask them, send update, report bug)</b></td>
136 <td>Nokia 6110, 6130, 6150, 6190, 5110, 5130, 5190, 3310, 3210</td>
138 <a href=mailto:Pavel.Janik@suse.cz>Pavel Janik</a>,
139 <a href=mailto:ck231@cam.ac.uk>Chris Kemp</a> (logos support)
145 <td>Nokia 3110, 3810, 8110, 8110i</td>
147 <a href=mailto:hugh@blemings.org>Hugh Blemings</a>
155 <a href=mailto:stanson@chat.ru>Andrew Kozin</a>
161 <td>Nokia 5160, 6160</td>
168 <td>Nokia 2110, 6080</td>
170 <a href=mailto:pavel@ucw.cz>Pavel Machek</a>
176 <td>Nokia 7110, 6210</td>
178 <a href=mailto:ck231@cam.ac.uk>Chris Kemp</a>
184 <p>If you want <em>really</em> uptodate information, look at
185 common/misc.c. You can find which phone supports what in source.
187 <p>You can also look into
188 <a href="http://gnokii.org/users">registered gnokii users database</a>
189 too see used by them phones...
191 <p><font color="#1F409F" size=+2 class="dzial">What is compatibility with hardware ?</font><br>
192 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
194 <p>Generally, gnokii can work with all computers, which have serial port
197 <p>If you want to use infrared, sometimes are small problems, because some
198 IrDa connectors are not compatible with some standards...
200 <p><font color="#1F409F" size=+2 class="dzial">How can I get support for it ?</font><br>
201 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
203 <p>We our only people and we sometimes make mistakes. But don't worry:
204 support for gnokii is really great. At first, you can tell your problem
205 to all gnokii users (in May 2000 on the list there were subscribed about
208 <p>The most often it's enough. If not, contact with authors:
210 <p>When problem is connected with module for concrete phone, write to people
211 listed in answer for question <b>Which phones are supported ?</b>.
212 For other parts: <a href=mailto:ja@mail.upjs.sk>Jan Derfinak</a>
213 is responsible for xgnokii.
215 <p><font color="#1F409F" size=+2 class="dzial">How to contact with gnokii users ?</font><br>
216 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
218 <p>Thanks to the efforts of
219 <a href="http://www.net.lut.ac.uk/~martin/">Martin Hamilton</a> we have a Majordomo based mailing
220 list gnokii@net.lut.ac.uk.
222 <p>You can subscribe by sending email to
223 gnokii-request@net.lut.ac.uk with the word <i>subscribe</i> in the body of the text.
225 <p><b><font color=red>
226 Note that the list is not a forum for discussion on how to obtain copies of
227 Nokia's proprietary software.</font></b>
228 It is the primary discussion forum for the project.
230 <p><a href="">Archive of the list</a>
232 <p><font color="#1F409F" size=+2 class="dzial">Does Nokia sponsors/supports this work ?</font><br>
233 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
235 <p>In the early stages of the project there were indications that
236 Nokia would provide some support for the project. Regrettably, these
237 negotiations stalled over the issue of binary versus open source
238 releases and the project has proceeded without official or unofficial
241 <p><font color="#1F409F" size=+2 class="dzial">How can I help with creating it ?</font><br>
242 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
244 <p>There are some things, you can do you gnokii:
247 <li>Tell us that you're interested, or that you would use the resulting
248 software or that you would be happy to test it out.
250 <p>The best method to make it is to adding yourself to the user database
251 at <a href="http://gnokii.org/users">http://gnokii.org/users</a>.
256 Give your input in discussions about the design and development of the suite
257 now that we are at that stage. In particular the best model of driver
258 interface will need to be discussed broadly to get the best result.
259 We've only had limited driver writing experience so if you've more, let us know!
264 Help examining the protocol and its differences between phone models.
269 Port the software to a new platform. Please tell us before you do so to ensure
270 that the port will integrate nicely into the source code tree.
275 Help us in writing our software or preparing help into it.
279 <p><font color="#1F409F" size=+2 class="dzial">Where to get latest versions ?</font><br>
280 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
282 <p>The source of gnokii aplications is in the CVS server. We want
283 to thank to Andrew Tridgell and the Samba team for it.
284 The server's address is pserver.samba.org. If you
285 are already familiar with CVS, set the CVSROOT to
287 <p><i>:pserver:cvs@pserver.samba.org:/cvsroot</i>
289 <p>and use the password cvs for checking out the repository with the name
292 <p>If you are not familiar with cvs, don't worry. It's very simple.
293 Just install the cvs package for your distribution and follow these steps:
296 <li>set your environmental variable CVSROOT. If you have bash (Bourne
299 <p><i>export CVSROOT=:pserver:cvs@pserver.samba.org:/cvsroot</i>
301 <p>If you have different shell, use different command (e.g. setenv).
306 <li>Log in to the CVS server as anonymous reader by typing
310 <p>Use 'cvs' as your password.
315 <li>If you are logged in you are ready to checkout the latest sources:
317 <p><i>cvs co gnokii</i>
321 <p>If you prefer, there is a WWW interface to the CVS server at
322 <a href="http://samba.org/cgi-bin/cvsweb/gnokii/">http://samba.org/cgi-bin/cvsweb/gnokii/</a>.
324 <p>Now you are on your own - you have the current sources on your disk
325 in the directory gnokii. If you are going to make substantial changes
326 and feel that they should be included into gnokii please mention it
327 on the list first to avoid duplicated effort.
329 <p>If you would like to receive email when updates are made to the CVS
330 repository, just send email to
331 <a href=mailto:hugh@blemings.org>Hugh Blemings</a> email to that effect
332 and you'll be added to the recipients list.
334 <p>Our thanks go to the Czech Linux Users Group for hosting the original
335 CVS repository at cvs.linux.cz.
337 <p>Another way to get almost latest (x)gnokii tools is to download it from
342 <a href="ftp://ftp.upjs.sk/pub/users/ja/xgnokii/">ftp://ftp.upjs.sk/pub/users/ja/xgnokii/</a>
343 - here are really latest versions of xgnokii (site of
344 <a href=mailto:ja@mail.upjs.sk>Jan Derfinak</a> - main author of XGNOKII).</li>
347 <a href="ftp://ftp.linux.cz/pub/linux/people/pavel_janik/Gnokii/">
348 ftp://ftp.linux.cz/pub/linux/people/pavel_janik/Gnokii/</a>
349 (site of <a href=Pavel.Janik@suse.cz>Pavel Janik</a>).
353 <a href="http://linuxcare.com.au/download/gnokii/pre/">
354 http://linuxcare.com.au/download/gnokii/pre/</a> (site of
355 <a href="mailto:hugh@blemings.org">Hugh Blemings</a>).
359 <a href="ftp://urtica.linuxnews.pl/pub/people/pkot/gnokii/">
360 ftp://urtica.linuxnews.pl/pub/people/pkot/gnokii/</a> (site of
361 <a href="mailto:pkot@linuxnews.pl">Pawel Kot</a>).
365 <p>Remember: it's still work in progress. It means, that we very often change it,
366 add new functions and correct our bugs (sometimes once a day :-))... So,
367 it's good to check it often...