fox2mike 05/08/30 09:04:28 Added: xml/htdocs/doc/en/draft pocketpc-guide.xml Log: Easier to work here when you're working on the same thing from different places.
Revision Changes Path 1.1 xml/htdocs/doc/en/draft/pocketpc-guide.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/draft/pocketpc-guide.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/draft/pocketpc-guide.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo Index: pocketpc-guide.xml =================================================================== <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE guide SYSTEM "http://www.gentoo.org/dtd/guide.dtd";> <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/draft/pocketpc-guide.xml,v 1.1 2005/08/30 09:04:28 fox2mike Exp $ --> <guide link="/doc/en/pocketpc-guide.xml"> <title>Working with Pocket PCs using libsynCE</title> <author title="Author"> <mail link="[EMAIL PROTECTED]">Chris White</mail> </author> <author title="Editor"> <mail link="[EMAIL PROTECTED]">Shyam Mani</mail> </author> <abstract> This guide will show how you how to work with a Pocket PC (in this case an HP IPAQ 1945) using libsynCE. </abstract> <!-- The content of this document is licensed under the CC-BY-SA license --> <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> <license/> <version>1.0</version> <date>2005-08-30</date> <chapter> <title>Setting up your Pocket PC</title> <section> <title>Kernel Setup</title> <body> <p> This guide uses the HP iPAQ 1945 as an example. Other Pocket PCs also use similar procedures to work. You <e>must</e> make sure you have the right kernel settings for your Pocket PC. </p> <p> The first thing we need to do is get the kernel to recognize our device. In this case, we have an HP iPAQ 1945. It is usb based and the module needed is called <c>ipaq</c>. </p> <pre caption="iPAQ Kernel Config"> [ ] USB Serial Console device support (EXPERIMENTAL) [ ] USB Generic Serial Driver < > USB Belkin and Peracom Single Port Serial Driver < > USB ConnectTech WhiteHEAT Serial Driver < > USB Digi International AccelePort USB Serial Driver < > USB Cypress M8 USB Serial Driver < > USB Empeg empeg-car Mark I/II Driver < > USB FTDI Single Port Serial Driver (EXPERIMENTAL) < > USB Handspring Visor / Palm m50x / Sony Clie Driver <M> USB PocketPC PDA Driver </pre> <p> Now we reboot. </p> </body> </section> <section> <title>Post-Kernel Setup</title> <body> <p> Ok, now that we have the kernel module setup, let's go ahead and get some information. Before we begin though, allow me to explain something. While it states USB Serial Converter, it's basically taking your PDA and communicating using serial over USB. That means this device is a USB based IPAQ. In fact, we even use ppp later on to create the connection. First though, let's plugin our device and take a look at our modules list (note this is a udev system): </p> <pre caption="Information about our PocketPC"> # <i>lsmod</i> Module Size Used by ipaq 30736 0 nvidia 3914428 12 vmnet 27428 2 vmmon 167564 0 # <i>dmesg | grep Pocket</i> drivers/usb/serial/usb-serial.c: USB Serial support registered for PocketPC PDA drivers/usb/serial/ipaq.c: USB PocketPC PDA driver v0.5 ipaq 1-1.1:1.0: PocketPC PDA converter detected usb 1-1.1: PocketPC PDA converter now attached to ttyUSB0 # <i>ls -la /dev/tts/USB0</i> crw------- 1 root tty 188/ 0 6/ 1 10:41 /dev/tts/USB0 secures chris # </pre> <p> In the first code segment, we see that as soon as the ipaq is plugged in, the ipaq module is loaded (this is with coldplug of course). Not only that, but a quick scan of dmesg shows that our setup works, and that the device is now located at /dev/tts/USB0. Remember this, as we'll need it for configuration later on. Now that we have our device setup, let's get ahold of some packages that will help us communicate with it. </p> </body> </section> </chapter> <chapter> <title>Working with SynCE</title> <section> <title>Getting ahold of the tools</title> <body> <p> Alright, the first thing we need to do is get ahold of the tools that will allow us to communicate with the PocketPC. So, we'll need to get ahold of the following packages: </p> <ul> <li>app-pda/synce - core for synce</li> <li>app-pda/synce-dccm - manages connections for synce devices</li> <li>app-pda/synce-librapi2 - rapi protocol communication</li> <li>app-pda/synce-libsynce - core library</li> <li>app-pda/synce-serial - needed to configure device</li> <li>net-dialup/ppp - needed for point to point connection with the device</li> </ul> <p> Once we these programs, we can begin the setup. </p> </body> </section> <section> <title>Setting up the IPAQ</title> <body> <p> Alright, remember that device node I told you we'd need. Here's where it comes into play. Now, as part of the synce-serial package, we have something called synce-serial-config. This is what we'll use to configure the device. To do so, simply give it the device node from earlier: </p> <pre caption="Configuring the device"> # <i>synce-serial-config tts/USB0</i> You can now run synce-serial-start to start a serial connection. </pre> <p> Please note that when you feed synce-serial-config the device node, do it without the /dev. Now that we have it up and running, we can begin to use the device. </p> </body> </section> </chapter> <chapter> <title>Using the IPAQ</title> <section> <title>Getting the IPAQ ready for connections</title> <body> <p> In order to use the IPAQ, we need to run a couple of commands. The first is dccm. This is our connection manager for the ipaq, and without it programs won't be able to connect. To use this run it <e>AS THE USER WHO WILL ACCESS SYNCE APPS</e>. So we do as so: </p> <pre caption="Initiating dccm"> # <i>exit</i> exit $ <i>dccm</i> </pre> <p> Now one more quick bit of user switching again, and we will now initiate the connection with the device: </p> <pre caption="Device connection"> # <i>synce-serial-start</i> synce-serial-start is now waiting for your device to connect </pre> <p> Your device should now respond to the connection. Mine does by displaying the sync icon and beeping to announce the connection. Now let's start by working with files. </p> </body> -- [email protected] mailing list
