This commit was manufactured by cvs2svn to create branch 'decode'.
[gnokii.git] / Docs / en_US / gnokii / faq.htm
diff --git a/Docs/en_US/gnokii/faq.htm b/Docs/en_US/gnokii/faq.htm
new file mode 100644 (file)
index 0000000..35850bc
--- /dev/null
@@ -0,0 +1,356 @@
+<html>
+<head>
+   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+   <meta name="Author" content="Marcin Wiacek">
+   <title>GNOKII FAQ</title>
+   <link REL=stylesheet HREF="../styl.css" TYPE="text/css">
+</head>
+<body>
+
+<a NAME="Top"></a>
+<p align="RIGHT"><a class="autoremail" href="../index.htm">Main page</a></p>
+<center><font color="#1F409F" size=+2 class="tytul">GNOKII FAQ</font></center>
+
+<p><hr size="2" noshade width="60%" align="center" style="color: #004080">
+
+<p><font color="#1F409F" size=+2 class="dzial">What is gnokii ?</font><br>
+<hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
+
+<p>Generally, what is gnokii (G from GNU, NOKII from Nokia) ?
+
+<p>It is a name of project. The aim of it is to develop tools and drivers
+for Nokia mobile phones. Of course, I think in this moment about really
+different tools - for example, modem drivers, console tools, etc.
+All created here software is released under the GNU
+General Public License. Please see <a href="COPYING">COPYING</a>
+for more details on license/copying issues,
+the lack of warranty and where to send a postcard if you like gnokii :).
+Anyway, our software works on many software (Linux, Free BSD, etc.)
+and hardware (Intel, etc.) platforms...
+
+<p><font color="#1F409F" size=+2 class="dzial">What software applications are created in gnokii project ?</font><br>
+<hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
+
+<ul>
+
+<li>
+The first application, gnokii, is a command line utility that was
+originally provided to assist developers and interested users in
+working with the low level API functions that were being developed.
+
+<p>From these rather humble beginnings, it has evolved into a the main
+command line tool of the suite.  Many people now use it for
+reading/writing phone book entries, sending and receiving SMS messages
+etc.  Ultimately it is intended that it will become a utility that
+communicates with gnokiid to provide a command line interface to
+the functionality provided by the gnokiid daemon.
+<br>&nbsp;
+</li>
+
+<li>
+The second application provided is xgnokii which as the name suggests
+is a X-windows based application that provides a graphical interface
+to your phone.  Amongst other things, xgnokii allows you to read and
+write phone book entries, read, write and send SMS messages, monitor
+battery and received signal strength.
+
+<p>At present xgnokii works directly with the phone, however in the
+future it will more likely use the "side" interface of gnokiid.
+
+<p>The main author of it is <a href=mailto:ja@mail.upjs.sk>Jan Derfinak</a>
+<br>&nbsp;
+</li>
+
+<li>
+The third part of the suite is gnokiid.  gnokiid provides a
+virtual modem interface, /dev/gnokii that looks like a regular
+Hayes-AT compatible modem with the ETSI defined extensions for
+GSM phones.  What this means in practical terms is that you can
+treat the /dev/gnokii device like an ordinary modem and use it
+to make data calls from pppd or a terminal application like
+minicom.
+
+<p>
+gnokiid is still under development, it's ultimate aim being to
+act as a "master" daemon that interfaces with your phone on one
+side and gnokii or xgnokii on the other.  This "side" code is still
+under discussion, particularly with respect to the most appropriate
+choice of communication method (IPC, TCP/IP etc.)
+<br>&nbsp;
+</li>
+
+<li>
+The last application provided with the suite is mgnokiidev which is
+used by gnokiid to create on demand a symbolic link between
+/dev/gnokii and the pseudo tty used by gnokiid for the virtual
+modem interface.  It's operation is transparent under normal
+usage as gnokiid takes care of calling it when required.
+</li>
+
+</ul>
+
+<p>This project also inspired some people to write other software for Nokia.
+For example:
+
+<p>
+<ul>
+<li>
+There is a perlmodule available for gnokii. It gives access to all
+the routines that are defined in gsm-common.h from a perl-program. It
+is intended for application developers who want to use their favorite
+language in interfacing the phone data with databases, ldap-directories
+and (in the future) different calendar applications. It is written by
+<a href="mailto:konstantin@agouros.de">Konstantin Agouros</a>
+and support starts with revision 0.2.6-pre3 of gnokii.
+
+<p>The homepage of this module is
+<a href="http://www.agouros.de/gnokii">http://www.agouros.de/gnokii</a>
+<br>&nbsp;
+</li>
+
+<li>
+<a href="http://anders.fix.no/software/gnokline-1.0.tgz">http://anders.fix.no/software/gnokline-1.0.tgz</a>
+and <a href="http://alamin.sourceforge.net">http://alamin.sourceforge.net</a> -
+software, which interprets received by connected Nokia phone SMSes and makes some things 
+</li>
+
+</ul>
+<p><font color="#1F409F" size=+2 class="dzial">Which phones are supported ?</font><br>
+<hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
+
+<p>You can also ask, what phones are supported ? All, you want :-) Really !
+
+<p>At first, we were making in gnokii project modules
+for Nokia 3810/8110 and 51x0/61x0 phones. Later users started to
+write parts for other Nokia phones. And we hope to extend it to another
+models: 7110, etc. Remember: it's even possible to write modules
+for other than Nokia phones
+too (just imagine: support for the most popular phones in one software !)...
+
+<p><a href=phones.htm>Here</a> is more detailed table with supported phones info...
+
+<p>You can also look into
+<a href="http://gnokii.org/users">registered gnokii users database</a>
+too see used by them phones...
+
+<p><font color="#1F409F" size=+2 class="dzial">What is compatibility with hardware ?</font><br>
+<hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
+
+<p>Generally, gnokii can work with all computers, which have serial port
+(over cable).
+
+<p>If you want to use infrared, sometimes are small problems, because some
+IrDa connectors are not compatible with some standards...
+
+<p><font color="#1F409F" size=+2 class="dzial">How can I get support for it ?</font><br>
+<hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
+
+<p>We our only people and we sometimes make mistakes. But don't worry:
+support for gnokii is really great. At first, you can tell your problem
+to all gnokii users (in May 2000 on the list there were subscribed about
+1000 people).
+
+<p>The most often it's enough. If not, contact with authors:
+
+<p>When problem is connected with module for concrete phone, write to people
+listed in answer for question <b>Which phones are supported ?</b>.
+For other parts: <a href=mailto:ja@mail.upjs.sk>Jan Derfinak</a>
+is responsible for xgnokii.
+
+<p><font color="#1F409F" size=+2 class="dzial">How to contact with gnokii users ?</font><br>
+<hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
+
+<p>Thanks to the efforts of
+<a href="http://www.net.lut.ac.uk/~martin/">Martin Hamilton</a> we have a Majordomo based mailing
+list gnokii@net.lut.ac.uk.
+
+<p>You can subscribe by sending email to
+gnokii-request@net.lut.ac.uk with the word <i>subscribe</i> in the body of the text.
+
+<p><b><font color=red>
+Note that the list is not a forum for discussion on how to obtain copies of
+Nokia's proprietary software.</font></b>
+It is the primary discussion forum for the project.
+
+<p><a href="">Archive of the list</a>
+
+<p><font color="#1F409F" size=+2 class="dzial">Does Nokia sponsors/supports this work ?</font><br>
+<hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
+
+<p>In the early stages of the project there were indications that
+Nokia would provide some support for the project.  Regrettably, these
+negotiations stalled over the issue of binary versus open source
+releases and the project has proceeded without official or unofficial
+assistance.
+
+<p><font color="#1F409F" size=+2 class="dzial">How can I help with creating it ?</font><br>
+<hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
+
+<p>There are some things, you can do you gnokii:
+
+<p>
+<ul>
+<li>Tell us that you're interested, or that you would use the resulting
+software or that you would be happy to test it out.
+
+<p>The best method to make it is to adding yourself to the user database
+at <a href="http://gnokii.org/users">http://gnokii.org/users</a>.
+<br>&nbsp;
+</li>
+
+<li>
+Give your input in discussions about the design and development of the suite
+now that we are at that stage. In particular the best model of driver
+interface will need to be discussed broadly to get the best result.
+We've only had limited driver writing experience so if you've more, let us know!
+<br>&nbsp;
+</li>
+
+<li>
+Help examining the protocol and its differences between phone models.
+<br>&nbsp;
+</li>
+
+<li>
+Port the software to a new platform. Please tell us before you do so to ensure
+that the port will integrate nicely into the source code tree.
+<br>&nbsp;
+</li>
+
+<li>
+Help us in writing our software or preparing help into it.
+</li>
+</ul>
+
+<p><font color="#1F409F" size=+2 class="dzial">Where to get latest versions ?</font><br>
+<hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
+
+<p>The source of gnokii aplications is in the CSV server.
+
+<p>We want to thank to Andrew Tridgell, Samba team for it...
+and Czech Linux Users Group for hosting the original
+CVS repository at cvs.linux.cz.
+
+<p>The server's address is pserver.samba.org. If you
+are already familiar with CVS, set the CVSROOT to
+
+<p><i>:pserver:cvs@pserver.samba.org:/cvsroot</i>
+
+<p>and use the password <i>cvs</i> for checking out the repository with the name
+<i>gnokii</i>.
+
+<p>If you are not familiar with cvs, don't worry. It's very simple.
+First, you need some of older gnokii releases (sources) - see for example
+links in the end of this question. Unpack them to some directory. Then:
+
+<p>
+<ul>
+
+<li>
+For Unix/Linux
+just install the cvs package for your distribution and follow these steps:
+
+<p>
+<ul>
+<li>set your environmental variable CVSROOT. If you have bash (Bourne
+Again Shell):
+
+<p><i>export CVSROOT=:pserver:cvs@pserver.samba.org:/cvsroot</i>
+
+<p>If you have different shell, use different command (e.g. setenv).
+
+<p>&nbsp;
+</li>
+
+<li>Log in to the CVS server as anonymous reader by typing
+
+<p><i>cvs login</i>
+
+<p>Use <i>cvs</i> as your password.
+
+<p>&nbsp;
+</li>
+
+<li>If you are logged in you are ready to checkout the latest sources:
+
+<p><i>cvs co gnokii</i>
+<p>
+</li>
+</ul>
+
+</li>
+
+<li>
+for win32 and (<a href=http://www.wincvs.org>WinCVS</a>):
+
+<p>
+<ul>
+
+<li>
+Go to the Admin/Preferences window
+</li>
+
+<li>
+In the "general" tab set CVSROOT to the <i>cvs@pserver.samba.org:/cvsroot</i>
+and <i>local mounted directory</i> to the <i>"passwd" file on the server</i>
+<p>
+</li>
+
+<li>Go to the Admin/Login window</li>
+
+<li>Enter <i>cvs</i> as the password<p></li>
+
+<li>Go to the Admin/Create/Checkout module</li>
+
+<li>Enter <i>gnokii</i> as module name and directory where have gnokii source
+(WinCVS will
+ create a directory called gnokii under the one you specify)</li>
+</ul>
+
+<p>
+</li>
+</ul>
+
+<p>If you prefer, there is a WWW interface to the CVS server at
+<a href="http://samba.org/cgi-bin/cvsweb/gnokii/">http://samba.org/cgi-bin/cvsweb/gnokii/</a>.
+
+<p>Now you are on your own - you have the current sources on your disk
+in the directory gnokii. If you are going to make substantial changes
+and feel that they should be included into gnokii please mention it
+on the list first to avoid duplicated effort.
+       
+<p>If you would like to receive email when updates are made to the CVS
+repository, just send email to
+<a href=mailto:hugh.blemings@vsb.com.au>Hugh Blemings</a> email to that effect
+and you'll be added to the recipients list.
+
+<p>Another way to get almost latest (x)gnokii tools is to download it from
+pages of authors:
+
+<p>
+<ul>
+<li>
+<a href="ftp://ftp.upjs.sk/pub/users/ja/xgnokii/">ftp://ftp.upjs.sk/pub/users/ja/xgnokii/</a>
+- here are really latest versions of xgnokii (site of
+<a href=mailto:ja@mail.upjs.sk>Jan Derfinak</a> - main author of XGNOKII).</li>
+
+<li>
+<a href="ftp://ftp.linux.cz/pub/linux/people/pavel_janik/Gnokii/">
+ftp://ftp.linux.cz/pub/linux/people/pavel_janik/Gnokii/</a>
+(site of <a href=Pavel.Janik@linux.cz>Pavel Janik</a>).
+</li>
+
+<li>
+<a href="http://linuxcare.com.au/download/gnokii/pre/">
+http://linuxcare.com.au/download/gnokii/pre/</a> (site of
+<a href="mailto:hugh.blemings@vsb.com.au">Hugh Blemings</a>).
+</li>
+</ul>
+
+<p>Remember: it's still work in progress. It means, that we very often change it,
+add new functions and correct our bugs (sometimes once a day :-))... So,
+it's good to check it often...
+
+</div>
+</body>
+</html>