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