pilot-getromtoken(1)

1pilot-getromtoken(1)              PILOT-LINK              pilot-getromtoken(1)
2
3
4

NAME

6       pilot-getromtoken - Reads a ROM token from a Palm Handheld device.
7

SECTION

9       pilot-link: Tools
10
11

SYNOPSIS

13        pilot-getromtoken [-p|--port <port>] [--version] [-?|--help] [--usage]
14       [-q|--quiet] [-t|--token  token] [-s|--sysinfo] [--ram] [--rom]  [file‐
15       name]
16
17

DESCRIPTION

19       Tokens you may currently extract are:
20
21
22       adcc: Entropy for internal A->D convertor calibration
23
24
25       irda: Present only on memory card w/IrDA support
26
27
28       snum: Device serial number (from Memory Card Flash ID)
29
30
31        pilot-getromtoken is used to fetch the ROM from your Palm handheld for
32       use in debugging Palm applications through the use of POSE, the Palm OS
33       Emulator application.
34
35
36       Note, because pilot-getrom uses the low-level RPC protocol to fetch the
37       ROM image, and the new OS5 devices do not use this protocol,  you  cur‐
38       rently  cannot  fetch an OS5 ROM image using this utility. This will be
39       updated in a future release to handle fetching OS5  ROM  images,  using
40       the debugger protocol.
41
42

OPTIONS

44   pilot-getromtoken options
45                               -t,
46                               --token token
47
48
49       A ROM token to read (i.e. snum)
50
51                               -s, --sysinfo
52
53
54       Print SysInfo
55
56                               --ram
57
58
59       Read RAM
60
61                               --rom
62
63
64       Read ROM
65
66                               <filename>
67
68
69       Write  the  ROM image to the file named by <filename>. If this is omit‐
70       ted, the filename will be written out as the rom version name  as  fol‐
71       lows:  'pilot-$VERSION.rom'  ,where an OS 3.5 image would be written as
72       the filename of 'pilot-3.5.0.rom'.
73
74
75   Conduit Options
76                               -p, --port
77                               <port>
78
79
80       Use device file <port> to communicate with the Palm handheld.  If  this
81       is not specified, pilot-getrom will look for the $PILOTPORT environment
82       variable. If neither are found or supplied,  pilot-getrom   will  print
83       the usage information.
84
85                               -q,
86                               --quiet
87
88
89       Suppress 'Hit HotSync button' message
90
91                               -v, --version
92
93
94       Display version of pilot-getrom and exit without connecting.
95
96
97   Help Options
98                               -h, --help
99
100
101       Display the help synopsis for pilot-getrom and exit without connecting.
102
103                               --usage
104
105
106       Display a brief usage message and exit without connecting.
107
108

USAGE

110       Connect  to  a target Palm handheld and fetch the ROM for use in debug‐
111       ging Palm applications through the use of POSE, the Palm OS Emulator or
112       with the CoPilot application (deprecated).
113
114

LICENSING

116        Warning:  Please completely back up your Palm this program! The devel‐
117       opers of  pilot-link  are not responsible for any data  loss  that  may
118       occur from the use of this application.
119
120
121       Use  of  this program MAY place you in violation of your license agree‐
122       ment with Palmsource, Inc. or other OEM partners. Please read your Palm
123       documentation  (specifically  the  "Software License Agreement") before
124       running this program.
125
126

AUTHOR

128        pilot-getrom was originally written by Owen Stenseth.
129
130
131       This manual page was written by Neil Williams <linux@codehelp.co.uk>
132
133

BUGS

135   Known Bugs
136        pilot-getrom does not work with OS5 devices as yet, due to changes  in
137       the  architecture and design of the Palm HotSync protocol and file type
138       changes from m68k to ARM. Other than that, pilot-getrom  has  no  known
139       bugs at this time.
140
141
142   Reporting Bugs
143       We  have  an  online  bug tracker. Using this is the only way to ensure
144       that your bugs are recorded and that we can track them until  they  are
145       resolved  or  closed. Reporting bugs via email, while easy, is not very
146       useful in  terms  of  accountability.  Please  point  your  browser  to
147       http://bugs.pilot-link.org:  http://bugs.pilot-link.org and report your
148       bugs and issues there.
149
150

COPYRIGHT

152       This program is free software; you can redistribute it and/or modify it
153       under  the  terms of the GNU General Public License as published by the
154       Free Software Foundation; either version 2 of the License, or (at  your
155       option) any later version.
156
157
158       This  program  is  distributed  in the hope that it will be useful, but
159       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
160       CHANTABILITY  or  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
161       Public License for more details.
162
163
164       You should have received a copy of the GNU General Public License along
165       with this program; if not, write to the Free Software Foundation, Inc.,
166       51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
167
168