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 |
< > USB Belkin and Peracom Single Port Serial Driver |
63 |
< > USB ConnectTech WhiteHEAT Serial Driver |
64 |
< > USB Digi International AccelePort USB Serial Driver |
65 |
< > USB Cypress M8 USB Serial Driver |
66 |
< > USB Empeg empeg-car Mark I/II Driver |
67 |
< > USB FTDI Single Port Serial Driver (EXPERIMENTAL) |
68 |
< > USB Handspring Visor / Palm m50x / Sony Clie Driver |
69 |
<M> 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 |