xgnokii/docs/help/en_US/faq.html

   1 <html>
   2 <head>
   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">
   7 </head>
   8 <body>
   9
  10 <a NAME="Top"></a>
  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>
  13
  14 <p><hr size="2" noshade width="60%" align="center" style="color: #004080">
  15
  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>
  18
  19 <p>Generally, what is gnokii (G from GNU, NOKII from Nokia) ?
  20
  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...
  30
  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>
  33
  34 <ul>
  35
  36 <li>
  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.
  40
  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.
  47 <br>&nbsp;
  48 </li>
  49
  50 <li>
  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.
  56
  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.
  59
  60 <p>The main author of it is <a href=mailto:ja@mail.upjs.sk>Jan Derfinak</a>
  61 <br>&nbsp;
  62 </li>
  63
  64 <li>
  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
  71 minicom.
  72 <br>&nbsp;
  73 </li>
  74
  75 <li>
  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.)
  81 <br>&nbsp;
  82 </li>
  83
  84 <li>
  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.
  90 </li>
  91
  92 </ul>
  93
  94 <p>This project also inspired some people to write other software for Nokia.
  95 For example:
  96
  97 <ul>
  98 <li>
  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.
 106
 107 <p>The homepage of this module is
 108 <a href="http://www.agouros.de/gnokii">http://www.agouros.de/gnokii</a>
 109
 110 </li>
 111 </ul>
 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>
 114
 115 <p>You can also ask, what phones are supported ? All, you want :-) Really !
 116
 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 !)...
 123
 124 <p>In this moment we have modules for:
 125
 126 <table cols=3>
 127
 128 <tr align=center>
 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>
 132 </tr>
 133
 134 <tr align=center>
 135 <td>Nokia 6110</td>
 136 <td>Nokia 6110, 6130, 6150, 6190, 5110, 5130, 5190, 3310, 3210</td>
 137 <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)
 140 </td>
 141 </tr>
 142
 143 <tr align=center>
 144 <td>Nokia 3810</td>
 145 <td>Nokia 3110, 3810, 8110, 8110i</td>
 146 <td>
 147 <a href=mailto:hugh@blemings.org>Hugh Blemings</a>
 148 </td>
 149 </tr>
 150
 151 <tr align=center>
 152 <td>Nokia 640</td>
 153 <td>Nokia 640</td>
 154 <td>
 155 <a href=mailto:stanson@chat.ru>Andrew Kozin</a>
 156 </td>
 157 </tr>
 158
 159 <tr align=center>
 160 <td>Nokia 6160</td>
 161 <td>Nokia 5160, 6160</td>
 162 <td>
 163 </td>
 164 </tr>
 165
 166 <tr align=center>
 167 <td>Nokia 2110</td>
 168 <td>Nokia 2110, 6080</td>
 169 <td>
 170 <a href=mailto:pavel@ucw.cz>Pavel Machek</a>
 171 </td>
 172 </tr>
 173
 174 <tr align=center>
 175 <td>Nokia 7110</td>
 176 <td>Nokia 7110, 6210</td>
 177 <td>
 178 <a href=mailto:ck231@cam.ac.uk>Chris Kemp</a>
 179 </td>
 180 </tr>
 181
 182 </table>
 183
 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.
 186
 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...
 190
 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>
 193
 194 <p>Generally, gnokii can work with all computers, which have serial port
 195 (over cable).
 196
 197 <p>If you want to use infrared, sometimes are small problems, because some
 198 IrDa connectors are not compatible with some standards...
 199
 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>
 202
 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
 206 1000 people).
 207
 208 <p>The most often it's enough. If not, contact with authors:
 209
 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.
 214
 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>
 217
 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.
 221
 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.
 224
 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.
 229
 230 <p><a href="">Archive of the list</a>
 231
 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>
 234
 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
 239 assistance.
 240
 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>
 243
 244 <p>There are some things, you can do you gnokii:
 245
 246 <ul>
 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.
 249
 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>.
 252 <br>&nbsp;
 253 </li>
 254
 255 <li>
 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!
 260 <br>&nbsp;
 261 </li>
 262
 263 <li>
 264 Help examining the protocol and its differences between phone models.
 265 <br>&nbsp;
 266 </li>
 267
 268 <li>
 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.
 271 <br>&nbsp;
 272 </li>
 273
 274 <li>
 275 Help us in writing our software or preparing help into it.
 276 </li>
 277 </ul>
 278
 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>
 281
 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
 286
 287 <p><i>:pserver:cvs@pserver.samba.org:/cvsroot</i>
 288
 289 <p>and use the password cvs for checking out the repository with the name
 290 gnokii.
 291
 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:
 294
 295 <ul>
 296 <li>set your environmental variable CVSROOT. If you have bash (Bourne
 297 Again Shell):
 298
 299 <p><i>export CVSROOT=:pserver:cvs@pserver.samba.org:/cvsroot</i>
 300
 301 <p>If you have different shell, use different command (e.g. setenv).
 302
 303 <p>&nbsp;
 304 </li>
 305
 306 <li>Log in to the CVS server as anonymous reader by typing
 307
 308 <p><i>cvs login</i>
 309
 310 <p>Use 'cvs' as your password.
 311
 312 <p>&nbsp;
 313 </li>
 314
 315 <li>If you are logged in you are ready to checkout the latest sources:
 316
 317 <p><i>cvs co gnokii</i>
 318 </li>
 319 </ul>
 320
 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>.
 323
 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.
 328
 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.
 333
 334 <p>Our thanks go to the Czech Linux Users Group for hosting the original
 335 CVS repository at cvs.linux.cz.
 336
 337 <p>Another way to get almost latest (x)gnokii tools is to download it from
 338 pages of authors:
 339
 340 <ul>
 341 <li>
 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>
 345
 346 <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>).
 350 </li>
 351
 352 <li>
 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>).
 356 </li>
 357
 358 <li>
 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>).
 362 </li>
 363 </ul>
 364
 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...
 368
 369 </div>
 370 </body>
 371 </html>