:pserver:cvs@pserver.samba.org:/cvsroot - gnokii - Tue Nov 27 05:17 CET 2001
[gnokii.git] / Docs / DataCalls-QuickStart
1
2            QUICK-START GUIDE TO RLP DATA CALLS USING GNOKII
3
4 (1) Compile and install gnokii as per instructions in the INSTALL file.
5
6 e.g.
7
8    cd /usr/src
9    tar xvfz /tmp/gnokii-0.3.3pre10.tar.gz
10    cd gnokii-0.3.3pre10
11    ./configure --enable-nls --with-x
12    make
13    groupadd gnokii
14    make install
15
16 (2) Create /etc/gnokiirc or ~/.gnokiirc
17
18    cp Docs/sample/gnokiirc /etc/gnokiirc
19    
20    or
21    
22    cp Docs/sample/gnokiirc ~/.gnokiirc
23
24    Edit to suit; in my case:
25
26    [global]
27    port = /dev/ttyS2
28    model = 6150
29    initlength = default
30    connection = serial
31    bindir = /usr/local/sbin/
32
33 (3) Connect your phone to your PC and then run gnokiid:
34
35    # gnokiid
36
37    If successful, you should see a message saying that mgnokiidev has been
38    run to create /dev/gnokii.  If you're using a 5110/6110 series phone
39    you should hear a beep and see an "accessory connected" message on
40    the phone.  If you're using a 3810 series phone you won't see anything
41    on the phones LCD.
42
43    I run gnokiid as root; it will also work for another user who is
44    in group gnokii, as long as the serial port is accessible to that
45    user as well.  It's not recommended that you run gnokiid as root
46    permanently however - it is better to put yourself in group gnokii
47
48
49 (4) Use /dev/gnokii as a modem:
50
51 e.g. ppp session
52 --------------- /etc/ppp/peers/demon-gnokii ---------------------
53 /dev/gnokii 115200
54 modem crtscts defaultroute
55 connect 'chat -v ABORT BUSY ABORT ERROR ABORT "NO CARRIER" "" AT OK-AT-OK ATD02083389666 CONNECT'
56 user XXXX.demon.co.uk
57 noauth
58 mtu 296
59 debug
60 ----------------------------------------------------------------
61 --------------- /etc/ppp/pap-secrets ---------------------------
62 XXXX.demon.co.uk        demon-gnokii    <yourpassword>
63 ----------------------------------------------------------------
64
65     Then "pppd call demon-gnokii" should connect
66     ('tail -f /var/log/messages' to see what is happening)
67
68 (5) If a call terminates you should get 'NO CARRIER' and gnokiid should
69     continue to work, but this is early code and you may find you have to
70     Ctrl-C and restart gnokiid (especially if the phone says the terminal
71     connection has been lost)
72     
73 (6) As gnokiid is still under development, ensure your data call has
74     hung up by checking your phone display at the end of the call.
75
76 (7) See also example files in Docs/sample directory.