Idenity Graphic
About
Store
Downloads
Information
Contact
How to Setup a PPP connection to a handheld computer.

NB: This howto was originally written for the iPAQ, but the information is pretty general and should be useful for any handheld computer. Feel free to edit this to make it more general.

Note : see the WindowsPPPHowto for instructions on how getting this to work with a Windows PC.

Setting things up on Since all of these changes are in /etc and /etc is in a writable partition, you can simply make these changes after your iPAQ has booted. However, these changes will be lost when the iPAQ is shutdown. To make these changes permanent, apply them to the /etc directory in the cramfs image on the host and then flash the new cramfs image to your iPAQ, (see the "Working with File Systems HOWTO" at http://www.handhelds.org/minihowto/filesystems.html for more details).

1.

Add a user ppp with /sbin/pppd as its shell::


echo "ppp::101:101:PPP User:/home/ppp:/sbin/pppd" >> /etc/passwd



2.

Create an /etc/ppp/options file as follows::


mkdir /etc/ppp
echo "-detach
defaultroute
noauth
nocrtscts
lock
lcp-echo-interval 5
lcp-echo-failure 3
/dev/ttySA0
115200" > /etc/ppp/options



3.

Add the ppp modules to /etc/modules so they will be loaded at boot time::


echo "slhc
ppp_generic
ppp_async" >> /etc/modules




If you are making these changes on a running iPAQ you will want to load these modules now since they were not in /etc/modules at boot time:


insmod slhc
insmod ppp_generic
insmod ppp_async



You might want to turn off DNS lookups in /etc/host.conf; also note that as of v0.19 at least in.ftpd and in.telnetd are not shipped, and so for remote logins and file transfers, the guest user is a handy (sic) route for things like rlogin -l guest ipaq and rcp xyz.tar.gz guest@ipaq:.

special note for Familiar v0.3 (as of 03/14/2001)

All the pppd stuff as mentioned above is correctly set up on the iPAQ, however, some lines are missing from /etc/modules.conf that prevent the kernel from dynamically loading the modules when pppd requests them. You will need to add the following lines to /etc/modules.conf:


alias char-major-108 ppp_generic
alias /dev/ppp ppp_generic
alias tty-ldisc-3 ppp_async



special note for Intimate (as of 2001-04-01)

There are 2 changes to the handheld files:


replace the the command in /etc/passwd with /usr/sbin/pppd
replace the device in /etc/ppp/options with /dev/tts/0



Setting things up on the host

1.

Create a file /etc/ppp/peers/ipaq with the following contents, (this requires root access)::


-detach
noauth
nocrtscts
lock
user ppp
connect '/usr/sbin/chat -v -t3 ogin--ogin: ppp'
/dev/ttyS0
115200
192.168.1.100:192.168.1.101




Note: you may need to adjust the /dev/ttyS0 line to whatever tty you actually have the serial cable plugged into. It's likely either /dev/ttyS0 or /dev/ttyS1, (corresponding to DOS COM1 and COM2 respectively).

Note: if your console is full of LCP EchoRep messages, your pppd is in debug mode. Check the /etc/ppp/options file on your desktop computer to remove the debug line.

Making the connection

1.

Connect the serial cable between the host and the iPAQ

2.

Make sure that you are not logged in at the serial console, (you should see the login: prompt in minicom)

3.

Close minicom or any other terminal program that may have a connection to your serial port

4.

Finally, execute pppd on the host, (as root)::


pppd call ipaq

or, on a Debian box, you can run (as any user)::

pon ipaq




A successful connection will report local and remote IP Addresses.

What can I do with it?

Now that you have a PPP connection, you have full TCP/IP networking between the host and the iPAQ. You can access either one from the other using the IP addresses reported when the PPP connection was established, (I like to add the IP addresses to my /etc/hosts file so I can simply type ipaq rather than 192.168.1.101).

Some fun things you can do with this connection include:

*

Using FTP to transfer files back and forth

*

Using the hosts keyboard/mouse on the iPAQ with x2x

*

Running X programs on the iPAQ with display set to the host: xterm -display 192.168.1.100:0

*

Running X programs on the host with display set to the iPAQ: gimp -display 192.168.1.101:0

*

Using IP masquerading, (see IPMasqHowto), to let the iPAQ have network connectivity to the rest of the internet.

Screenshots | About | Store | Downloads | Information | Contact | Home | Mailing List | People | Message Boards | Online Chat