Docs/en_US/gnokii/faq.htm

   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.htm">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
  73 <p>
  74 gnokiid is still under development, it's ultimate aim being to
  75 act as a "master" daemon that interfaces with your phone on one
  76 side and gnokii or xgnokii on the other.  This "side" code is still
  77 under discussion, particularly with respect to the most appropriate
  78 choice of communication method (IPC, TCP/IP etc.)
  79 <br>&nbsp;
  80 </li>
  81
  82 <li>
  83 The last application provided with the suite is mgnokiidev which is
  84 used by gnokiid to create on demand a symbolic link between
  85 /dev/gnokii and the pseudo tty used by gnokiid for the virtual
  86 modem interface.  It's operation is transparent under normal
  87 usage as gnokiid takes care of calling it when required.
  88 </li>
  89
  90 </ul>
  91
  92 <p>This project also inspired some people to write other software for Nokia.
  93 For example:
  94
  95 <p>
  96 <ul>
  97 <li>
  98 There is a perlmodule available for gnokii. It gives access to all
  99 the routines that are defined in gsm-common.h from a perl-program. It
 100 is intended for application developers who want to use their favorite
 101 language in interfacing the phone data with databases, ldap-directories
 102 and (in the future) different calendar applications. It is written by
 103 <a href="mailto:konstantin@agouros.de">Konstantin Agouros</a>
 104 and support starts with revision 0.2.6-pre3 of gnokii.
 105
 106 <p>The homepage of this module is
 107 <a href="http://www.agouros.de/gnokii">http://www.agouros.de/gnokii</a>
 108 <br>&nbsp;
 109 </li>
 110
 111 <li>
 112 <a href="http://anders.fix.no/software/gnokline-1.0.tgz">http://anders.fix.no/software/gnokline-1.0.tgz</a>
 113 and <a href="http://alamin.sourceforge.net">http://alamin.sourceforge.net</a> -
 114 software, which interprets received by connected Nokia phone SMSes and makes some things
 115 </li>
 116
 117 </ul>
 118 <p><font color="#1F409F" size=+2 class="dzial">Which phones are supported ?</font><br>
 119 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
 120
 121 <p>You can also ask, what phones are supported ? All, you want :-) Really !
 122
 123 <p>At first, we were making in gnokii project modules
 124 for Nokia 3810/8110 and 51x0/61x0 phones. Later users started to
 125 write parts for other Nokia phones. And we hope to extend it to another
 126 models: 7110, etc. Remember: it's even possible to write modules
 127 for other than Nokia phones
 128 too (just imagine: support for the most popular phones in one software !)...
 129
 130 <p><a href=phones.htm>Here</a> is more detailed table with supported phones info...
 131
 132 <p>You can also look into
 133 <a href="http://gnokii.org/users">registered gnokii users database</a>
 134 too see used by them phones...
 135
 136 <p><font color="#1F409F" size=+2 class="dzial">What is compatibility with hardware ?</font><br>
 137 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
 138
 139 <p>Generally, gnokii can work with all computers, which have serial port
 140 (over cable).
 141
 142 <p>If you want to use infrared, sometimes are small problems, because some
 143 IrDa connectors are not compatible with some standards...
 144
 145 <p><font color="#1F409F" size=+2 class="dzial">How can I get support for it ?</font><br>
 146 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
 147
 148 <p>We our only people and we sometimes make mistakes. But don't worry:
 149 support for gnokii is really great. At first, you can tell your problem
 150 to all gnokii users (in May 2000 on the list there were subscribed about
 151 1000 people).
 152
 153 <p>The most often it's enough. If not, contact with authors:
 154
 155 <p>When problem is connected with module for concrete phone, write to people
 156 listed in answer for question <b>Which phones are supported ?</b>.
 157 For other parts: <a href=mailto:ja@mail.upjs.sk>Jan Derfinak</a>
 158 is responsible for xgnokii.
 159
 160 <p><font color="#1F409F" size=+2 class="dzial">How to contact with gnokii users ?</font><br>
 161 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
 162
 163 <p>Thanks to the efforts of
 164 <a href="http://www.net.lut.ac.uk/~martin/">Martin Hamilton</a> we have a Majordomo based mailing
 165 list gnokii@net.lut.ac.uk.
 166
 167 <p>You can subscribe by sending email to
 168 gnokii-request@net.lut.ac.uk with the word <i>subscribe</i> in the body of the text.
 169
 170 <p><b><font color=red>
 171 Note that the list is not a forum for discussion on how to obtain copies of
 172 Nokia's proprietary software.</font></b>
 173 It is the primary discussion forum for the project.
 174
 175 <p><a href="">Archive of the list</a>
 176
 177 <p><font color="#1F409F" size=+2 class="dzial">Does Nokia sponsors/supports this work ?</font><br>
 178 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
 179
 180 <p>In the early stages of the project there were indications that
 181 Nokia would provide some support for the project.  Regrettably, these
 182 negotiations stalled over the issue of binary versus open source
 183 releases and the project has proceeded without official or unofficial
 184 assistance.
 185
 186 <p><font color="#1F409F" size=+2 class="dzial">How can I help with creating it ?</font><br>
 187 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
 188
 189 <p>There are some things, you can do you gnokii:
 190
 191 <p>
 192 <ul>
 193 <li>Tell us that you're interested, or that you would use the resulting
 194 software or that you would be happy to test it out.
 195
 196 <p>The best method to make it is to adding yourself to the user database
 197 at <a href="http://gnokii.org/users">http://gnokii.org/users</a>.
 198 <br>&nbsp;
 199 </li>
 200
 201 <li>
 202 Give your input in discussions about the design and development of the suite
 203 now that we are at that stage. In particular the best model of driver
 204 interface will need to be discussed broadly to get the best result.
 205 We've only had limited driver writing experience so if you've more, let us know!
 206 <br>&nbsp;
 207 </li>
 208
 209 <li>
 210 Help examining the protocol and its differences between phone models.
 211 <br>&nbsp;
 212 </li>
 213
 214 <li>
 215 Port the software to a new platform. Please tell us before you do so to ensure
 216 that the port will integrate nicely into the source code tree.
 217 <br>&nbsp;
 218 </li>
 219
 220 <li>
 221 Help us in writing our software or preparing help into it.
 222 </li>
 223 </ul>
 224
 225 <p><font color="#1F409F" size=+2 class="dzial">Where to get latest versions ?</font><br>
 226 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
 227
 228 <p>The source of gnokii aplications is in the CSV server.
 229
 230 <p>We want to thank to Andrew Tridgell, Samba team for it...
 231 and Czech Linux Users Group for hosting the original
 232 CVS repository at cvs.linux.cz.
 233
 234 <p>The server's address is pserver.samba.org. If you
 235 are already familiar with CVS, set the CVSROOT to
 236
 237 <p><i>:pserver:cvs@pserver.samba.org:/cvsroot</i>
 238
 239 <p>and use the password <i>cvs</i> for checking out the repository with the name
 240 <i>gnokii</i>.
 241
 242 <p>If you are not familiar with cvs, don't worry. It's very simple.
 243 First, you need some of older gnokii releases (sources) - see for example
 244 links in the end of this question. Unpack them to some directory. Then:
 245
 246 <p>
 247 <ul>
 248
 249 <li>
 250 For Unix/Linux
 251 just install the cvs package for your distribution and follow these steps:
 252
 253 <p>
 254 <ul>
 255 <li>set your environmental variable CVSROOT. If you have bash (Bourne
 256 Again Shell):
 257
 258 <p><i>export CVSROOT=:pserver:cvs@pserver.samba.org:/cvsroot</i>
 259
 260 <p>If you have different shell, use different command (e.g. setenv).
 261
 262 <p>&nbsp;
 263 </li>
 264
 265 <li>Log in to the CVS server as anonymous reader by typing
 266
 267 <p><i>cvs login</i>
 268
 269 <p>Use <i>cvs</i> as your password.
 270
 271 <p>&nbsp;
 272 </li>
 273
 274 <li>If you are logged in you are ready to checkout the latest sources:
 275
 276 <p><i>cvs co gnokii</i>
 277 <p>
 278 </li>
 279 </ul>
 280
 281 </li>
 282
 283 <li>
 284 for win32 and (<a href=http://www.wincvs.org>WinCVS</a>):
 285
 286 <p>
 287 <ul>
 288
 289 <li>
 290 Go to the Admin/Preferences window
 291 </li>
 292
 293 <li>
 294 In the "general" tab set CVSROOT to the <i>cvs@pserver.samba.org:/cvsroot</i>
 295 and <i>local mounted directory</i> to the <i>"passwd" file on the server</i>
 296 <p>
 297 </li>
 298
 299 <li>Go to the Admin/Login window</li>
 300
 301 <li>Enter <i>cvs</i> as the password<p></li>
 302
 303 <li>Go to the Admin/Create/Checkout module</li>
 304
 305 <li>Enter <i>gnokii</i> as module name and directory where have gnokii source
 306 (WinCVS will
 307  create a directory called gnokii under the one you specify)</li>
 308 </ul>
 309
 310 <p>
 311 </li>
 312 </ul>
 313
 314 <p>If you prefer, there is a WWW interface to the CVS server at
 315 <a href="http://samba.org/cgi-bin/cvsweb/gnokii/">http://samba.org/cgi-bin/cvsweb/gnokii/</a>.
 316
 317 <p>Now you are on your own - you have the current sources on your disk
 318 in the directory gnokii. If you are going to make substantial changes
 319 and feel that they should be included into gnokii please mention it
 320 on the list first to avoid duplicated effort.
 321
 322 <p>If you would like to receive email when updates are made to the CVS
 323 repository, just send email to
 324 <a href=mailto:hugh.blemings@vsb.com.au>Hugh Blemings</a> email to that effect
 325 and you'll be added to the recipients list.
 326
 327 <p>Another way to get almost latest (x)gnokii tools is to download it from
 328 pages of authors:
 329
 330 <p>
 331 <ul>
 332 <li>
 333 <a href="ftp://ftp.upjs.sk/pub/users/ja/xgnokii/">ftp://ftp.upjs.sk/pub/users/ja/xgnokii/</a>
 334 - here are really latest versions of xgnokii (site of
 335 <a href=mailto:ja@mail.upjs.sk>Jan Derfinak</a> - main author of XGNOKII).</li>
 336
 337 <li>
 338 <a href="ftp://ftp.linux.cz/pub/linux/people/pavel_janik/Gnokii/">
 339 ftp://ftp.linux.cz/pub/linux/people/pavel_janik/Gnokii/</a>
 340 (site of <a href=Pavel.Janik@linux.cz>Pavel Janik</a>).
 341 </li>
 342
 343 <li>
 344 <a href="http://linuxcare.com.au/download/gnokii/pre/">
 345 http://linuxcare.com.au/download/gnokii/pre/</a> (site of
 346 <a href="mailto:hugh.blemings@vsb.com.au">Hugh Blemings</a>).
 347 </li>
 348 </ul>
 349
 350 <p>Remember: it's still work in progress. It means, that we very often change it,
 351 add new functions and correct our bugs (sometimes once a day :-))... So,
 352 it's good to check it often...
 353
 354 </div>
 355 </body>
 356 </html>