Gentoo Archives: gentoo-doc-cvs

From: Shyam Mani <fox2mike@×××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: pocketpc-guide.xml
Date: Tue, 30 Aug 2005 09:04:49
Message-Id: 200508300902.j7U92Wpq021727@robin.gentoo.org
1 fox2mike 05/08/30 09:04:28
2
3 Added: xml/htdocs/doc/en/draft pocketpc-guide.xml
4 Log:
5 Easier to work here when you're working on the same thing from different places.
6
7 Revision Changes Path
8 1.1 xml/htdocs/doc/en/draft/pocketpc-guide.xml
9
10 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
11 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
12
13 Index: pocketpc-guide.xml
14 ===================================================================
15 <?xml version="1.0" encoding="UTF-8"?>
16 <!DOCTYPE guide SYSTEM "http://www.gentoo.org/dtd/guide.dtd">
17 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/draft/pocketpc-guide.xml,v 1.1 2005/08/30 09:04:28 fox2mike Exp $ -->
18
19 <guide link="/doc/en/pocketpc-guide.xml">
20 <title>Working with Pocket PCs using libsynCE</title>
21
22 <author title="Author">
23 <mail link="chriswhite@g.o">Chris White</mail>
24 </author>
25 <author title="Editor">
26 <mail link="fox2mike@g.o">Shyam Mani</mail>
27 </author>
28
29 <abstract>
30 This guide will show how you how to work with a Pocket PC (in this case an HP
31 IPAQ 1945) using libsynCE.
32 </abstract>
33
34 <!-- The content of this document is licensed under the CC-BY-SA license -->
35 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
36 <license/>
37
38 <version>1.0</version>
39 <date>2005-08-30</date>
40
41 <chapter>
42 <title>Setting up your Pocket PC</title>
43 <section>
44 <title>Kernel Setup</title>
45 <body>
46
47 <p>
48 This guide uses the HP iPAQ 1945 as an example. Other Pocket PCs also use
49 similar procedures to work. You <e>must</e> make sure you have the right kernel
50 settings for your Pocket PC.
51 </p>
52
53 <p>
54 The first thing we need to do is get the kernel to recognize our device. In
55 this case, we have an HP iPAQ 1945. It is usb based and the module needed is
56 called <c>ipaq</c>.
57 </p>
58
59 <pre caption="iPAQ Kernel Config">
60 [ ] USB Serial Console device support (EXPERIMENTAL)
61 [ ] USB Generic Serial Driver
62 &lt; &gt; USB Belkin and Peracom Single Port Serial Driver
63 &lt; &gt; USB ConnectTech WhiteHEAT Serial Driver
64 &lt; &gt; USB Digi International AccelePort USB Serial Driver
65 &lt; &gt; USB Cypress M8 USB Serial Driver
66 &lt; &gt; USB Empeg empeg-car Mark I/II Driver
67 &lt; &gt; USB FTDI Single Port Serial Driver (EXPERIMENTAL)
68 &lt; &gt; USB Handspring Visor / Palm m50x / Sony Clie Driver
69 &lt;M&gt; USB PocketPC PDA Driver
70 </pre>
71
72 <p>
73 Now we reboot.
74 </p>
75
76 </body>
77 </section>
78 <section>
79 <title>Post-Kernel Setup</title>
80 <body>
81
82 <p>
83 Ok, now that we have the kernel module setup, let's go ahead and get some
84 information. Before we begin though, allow me to explain something. While it
85 states USB Serial Converter, it's basically taking your PDA and communicating
86 using serial over USB. That means this device is a USB based IPAQ. In fact,
87 we even use ppp later on to create the connection. First though, let's plugin
88 our device and take a look at our modules list (note this is a udev system):
89 </p>
90
91 <pre caption="Information about our PocketPC">
92 # <i>lsmod</i>
93 Module Size Used by
94 ipaq 30736 0
95 nvidia 3914428 12
96 vmnet 27428 2
97 vmmon 167564 0
98
99 # <i>dmesg | grep Pocket</i>
100 drivers/usb/serial/usb-serial.c: USB Serial support registered for PocketPC PDA
101 drivers/usb/serial/ipaq.c: USB PocketPC PDA driver v0.5
102 ipaq 1-1.1:1.0: PocketPC PDA converter detected
103 usb 1-1.1: PocketPC PDA converter now attached to ttyUSB0
104
105 # <i>ls -la /dev/tts/USB0</i>
106 crw------- 1 root tty 188/ 0 6/ 1 10:41 /dev/tts/USB0
107 secures chris #
108 </pre>
109
110 <p>
111 In the first code segment, we see that as soon as the ipaq is plugged in, the
112 ipaq module is loaded (this is with coldplug of course). Not only that, but a
113 quick scan of dmesg shows that our setup works, and that the device is now
114 located at /dev/tts/USB0. Remember this, as we'll need it for configuration
115 later on. Now that we have our device setup, let's get ahold of some packages
116 that will help us communicate with it.
117 </p>
118
119 </body>
120 </section>
121 </chapter>
122
123 <chapter>
124 <title>Working with SynCE</title>
125 <section>
126 <title>Getting ahold of the tools</title>
127 <body>
128
129 <p>
130 Alright, the first thing we need to do is get ahold of the tools that will
131 allow us to communicate with the PocketPC. So, we'll need to get ahold of the
132 following packages:
133 </p>
134
135 <ul>
136 <li>app-pda/synce - core for synce</li>
137 <li>app-pda/synce-dccm - manages connections for synce devices</li>
138 <li>app-pda/synce-librapi2 - rapi protocol communication</li>
139 <li>app-pda/synce-libsynce - core library</li>
140 <li>app-pda/synce-serial - needed to configure device</li>
141 <li>net-dialup/ppp - needed for point to point connection with the device</li>
142 </ul>
143
144 <p>
145 Once we these programs, we can begin the setup.
146 </p>
147
148 </body>
149 </section>
150 <section>
151 <title>Setting up the IPAQ</title>
152 <body>
153
154 <p>
155 Alright, remember that device node I told you we'd need. Here's where it comes
156 into play. Now, as part of the synce-serial package, we have something called
157 synce-serial-config. This is what we'll use to configure the device. To do
158 so, simply give it the device node from earlier:
159 </p>
160
161 <pre caption="Configuring the device">
162 # <i>synce-serial-config tts/USB0</i>
163
164 You can now run synce-serial-start to start a serial connection.
165 </pre>
166
167 <p>
168 Please note that when you feed synce-serial-config the device node, do it
169 without the /dev. Now that we have it up and running, we can begin to use the
170 device.
171 </p>
172
173 </body>
174 </section>
175 </chapter>
176
177 <chapter>
178 <title>Using the IPAQ</title>
179 <section>
180 <title>Getting the IPAQ ready for connections</title>
181 <body>
182
183 <p>
184 In order to use the IPAQ, we need to run a couple of commands. The first is
185 dccm. This is our connection manager for the ipaq, and without it programs
186 won't be able to connect. To use this run it <e>AS THE USER WHO WILL ACCESS
187 SYNCE APPS</e>. So we do as so:
188 </p>
189
190 <pre caption="Initiating dccm">
191 # <i>exit</i>
192 exit
193 $ <i>dccm</i>
194 </pre>
195
196 <p>
197 Now one more quick bit of user switching again, and we will now initiate the
198 connection with the device:
199 </p>
200
201 <pre caption="Device connection">
202 # <i>synce-serial-start</i>
203
204 synce-serial-start is now waiting for your device to connect
205 </pre>
206
207 <p>
208 Your device should now respond to the connection. Mine does by displaying the
209 sync icon and beeping to announce the connection. Now let's start by working
210 with files.
211 </p>
212
213 </body>
214
215
216
217 --
218 gentoo-doc-cvs@g.o mailing list