:pserver:cvs@pserver.samba.org:/cvsroot - gnokii - Sun Nov 25 22:56 CET 2001
[gnokii.git] / xgnokii / docs / help / en_US / config.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>Configuration</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">Configuration</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">How to install it from the source ?</font><br>
17 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
18
19 <p>gnokii makes use of autoconf/automake which allows you to configure
20 the source tree for your system by typing 
21
22 <p><i>./configure</i>
23
24 <p>You can also run configure with the --help flag to get a list of 
25 available options.  There are about a dozen or so that are specific
26 to gnokii.
27
28 <p>Once you've run ./configure successfully, you should be able to
29 simply do a make and make install to compile and install your 
30 binaries respectively.
31
32 <p><i>make</i>
33
34 <p><i>make install</i>
35
36 <p>With this done you've built and installed your binaries, and
37 should proceed to the configuration section below.
38
39 <p><font color="#1F409F" size=+2 class="dzial">How to install it from binaries ?</font><br>
40 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
41
42 <p>If you downloaded gnokii as a pre-built binary you should install
43 it in the conventional manner for the package type in question.
44 For example if you downloaded a .rpm file you can install it by
45 running the following as root.
46
47 <p>rpm -i gnokii-0.3.2-i386.rpm
48
49 <p>If you are using a Debian based system, you can use dpackage
50 to do the installation (FIXME - is this correct ?)
51
52 <p><font color="#1F409F" size=+2 class="dzial">How to make connection with phone ?</font><br>
53 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
54
55 <p>There are three ways to make it:
56
57 <ul>
58 <li>connecting phone with computer using cable. All phones allow to make it
59 (even 3210 - connector is inside). If you want to know more
60 about creating your own cable, read <a href=cables/cables.html>cables faq</a>.</li>
61 <li>using IrDa port in phone and computer. Notice, that your computer
62 and phone must have it (only some series of Nokia phones has it - for example,
63 6110, 6150)</li>
64 <li>connecting to phone special device called "dongle" (it has IrDa port)
65 and making IrDa connection between it and phone. Current gnokii cas use
66 Tekram IRmate 210 - see patches</li>
67 </ul>
68
69 <p><font color="#1F409F" size=+2 class="dzial">How to configure gnokii ?</font><br>
70 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
71
72 <p>You could copy the <a href=sample/gnokiirc>sample/gnokiirc</a>
73 file from the Docs/en_US/samples directory to your
74 home directory and name it .gnokiirc or copy it into /etc directory
75 and name .gnokiirc.
76
77 <p>Using your favorite
78 editor ensure that the settings are correct for your system,
79 the sample file has details of the various options available. The most
80 difficult problem could be discovering model of your phone - go into
81 our <a href=firmware/firmware.html>firmware page</a>
82 and try to use codes written in column
83 <b>Firmware version code</b>. If your phone will display something,
84 see model number on the third line, look on the
85 <a href=firmware/firmware.htm>firmware page</a>
86 again (for it) and read phone model then.
87
88 <p>Note that you will need read/write permissions on whatever
89 serial port you specify in .gnokiirc.  You can now use gnokii
90 and xgnokii.
91
92 <p><font color="#1F409F" size=+2 class="dzial">How to configure infrared connection ?</font><br>
93 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
94
95 <p>
96 <ul>
97
98 <li>Go into configuration of your IrDa port (the most often it's made in
99 BIOS, sometimes using program provided by computer's producer):
100
101 <p>
102 <ul>
103 <li>Enable it</li>
104 <li>Setup the COM-Port on which it should work.
105 Here are addresses:
106 <br>ttyS0 (COM1): 3F8, IRQ: 4
107 <br>ttyS1 (COM2): 2F8, IRQ: 3
108 <br>ttyS2 (COM3): 3E8, IRQ: 4
109 <br>ttyS3 (COM4): 2E8, IRQ: 3
110 <br>&nbsp;
111 </li>
112 </ul>
113 </li>
114
115 <li>Configure gnokii (see previous question)
116 setting type of connection to
117 infrared.</li>
118
119 <li>If you are using linux, put linux-irda off (you can't use gnokii over infrared and
120 linux-irda at the same time - it means too, if you want use
121 linux-irda you must close all gnokii-applications what
122 use the infrared-port in moment).
123 </li>
124 </ul>
125
126 <p><font color="#1F409F" size=+2 class="dzial">How to configure gnokii driver for data connection ?</font><br>
127 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>
128
129 <p>After installing and configuring gnokii you should make another group
130 and allow mgnokiidev to use it. For example (if you have installed gnokii
131 into /usr/local):
132
133 <p>
134 <i>groupadd gnokii<br>
135 chown root:gnokii /usr/local/sbin/mgnokiidev<br>
136 chmod 4750 /usr/local/sbin/mgnokiidev</i>
137
138 <p>Then connect your phone to your PC and then run gnokiid:
139
140 <p><i># gnokiid</i>
141
142 <p>If successful, you should see a message saying that mgnokiidev has been
143 run to create /dev/gnokii.  If you're using a 5110/6110 series phone
144 you should hear a beep and see an "accessory connected" message on
145 the phone.  If you're using a 3810 series phone you won't see anything
146 on the phones LCD.
147
148 <p>[I run gnokiid as root; it will probably work for another user who is
149 in group gnokii, as long as the serial port is accessible to that
150 user as well.  It's not recommended that you run gnokiid as root
151 permanently however!]
152
153 <p>Use /dev/gnokii as a modem:
154
155 <p><i>e.g. ppp session<br>
156 --------------- /etc/ppp/peers/demon-gnokii ---------------------<br>
157 /dev/gnokii 115200<br>
158 modem crtscts defaultroute<br>
159 connect 'chat -v ABORT BUSY ABORT ERROR ABORT "NO CARRIER" "" AT OK-AT-OK ATD02083389666 CONNECT'<br>
160 user XXXX.demon.co.uk<br>
161 noauth<br>
162 mtu 296<br>
163 debug<br>
164 ----------------------------------------------------------------<br>
165 --------------- /etc/ppp/pap-secrets ---------------------------<br>
166 XXXX.demon.co.uk        demon-gnokii    <yourpassword><br>
167 ----------------------------------------------------------------<br>
168 </i>
169
170 <p>Then "pppd call demon-gnokii" should connect
171 <br>('tail -f /var/log/messages' to see what is happening)
172
173 <p>If a call terminates you should get 'NO CARRIER' and gnokiid should
174 continue to work, but this is early code and you may find you have to
175 Ctrl-C and restart gnokiid (especially if the phone says the terminal
176 connection has been lost)
177
178 </div>
179 </body>
180 </html>