FreeCalypso > hg > freecalypso-sw
annotate loadtools/README @ 568:ae24e49c41a9
L1: l1_sync.c compiles for XIP
author | Michael Spacefalcon <msokolov@ivan.Harhan.ORG> |
---|---|
date | Sun, 10 Aug 2014 17:52:59 +0000 |
parents | e61eacecd319 |
children | 5e73df562a7d |
rev | line source |
---|---|
424
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
1 The set of host tools built in this directory consists of: |
97
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
2 |
424
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
3 fc-loadtool The tool for operating on Calypso GSM devices at a low |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
4 level. After "breaking" into the target GSM device in |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
5 its boot process and getting FreeCalypso loadagent |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
6 running on the target (out of Calypso internal RAM, aka |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
7 IRAM), loadtool presents an interactive command prompt |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
8 with commands for peeking and poking registers and most |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
9 importantly, reading and writing any part of the |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
10 device's non-volatile flash memory. |
97
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
11 |
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
12 fc-iram & fc-xram These utilities are intended for FreeCalypso developers |
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
13 only. They load an S-record code image into IRAM or |
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
14 XRAM, respectively, induce a transfer of control to the |
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
15 loaded code, and then drop into a serial line pass-thru |
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
16 mode for the operator to interact with the thus loaded |
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
17 target code. |
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
18 |
424
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
19 The currently supported target devices are the Compal family of basic |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
20 dumbphones, the Openmoko GTA0x GSM modem and the Pirelli DP-L10 feature phone. |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
21 |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
22 All tools in the FreeCalypso loadtools suite work by feeding pieces of code to |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
23 the target device as it boots, preventing the booting of its regular firmware |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
24 and diverting control to these externally-loaded code pieces. These pieces of |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
25 ARM7 target code need to be installed on the host system running loadtools, |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
26 normally in /usr/local/share/freecalypso: |
97
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
27 |
424
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
28 loadagent This is the "agent" code that runs on the target device when |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
29 fc-loadtool is operating on it: loadtool carries out its |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
30 operations by sending commands to loadagent. There is only one |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
31 version of loadagent for all currently supported Calypso |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
32 targets: loadagent does not access any resources outside of the |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
33 Calypso chip itself unless commanded to do so, and loadtool |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
34 supports different target devices with different hardware |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
35 configurations by sending different commands to loadagent as |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
36 appropriate. |
97
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
37 |
424
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
38 compalstage For Compal phones only: a little piece of code that is fed to |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
39 the original fw's bootloader via the serial download protocol |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
40 provided by the latter; it re-enables the Calypso chip boot ROM |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
41 and jumps to it, allowing our loadagent to be loaded in the |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
42 same way as on freedom-enabled devices. |
97
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
43 |
424
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
44 If you are working with a development snapshot of the freecalypso-sw source |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
45 tree, you will need to compile and install a GNU cross-compiler toolchain |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
46 targeting ARM7 (see ../toolchain) and then use that toolchain to compile |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
47 loadagent and compalstage (see ../target-utils) before you can successfully use |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
48 loadtools to operate on a target device. End-user oriented releases of |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
49 FreeCalypso host tools will include prebuilt loadagent and compalstage binaries |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
50 in the target-binaries subdirectory. |
97
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
51 |
424
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
52 Installing |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
53 ========== |
97
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
54 |
424
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
55 Just run 'make' and 'make install' as usual. If the target-binaries directory |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
56 is present, your installation will be complete and ready to use. If you are |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
57 building these pieces yourself from source, do a 'make' and 'make install' in |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
58 ../target-utils, after you have the ARM7 gcc toolchain installed and working. |
97
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
59 |
424
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
60 Basic usage |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
61 =========== |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
62 |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
63 The steps for bringing up fc-loadtool to operate on a target Calypso device are |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
64 as follows: |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
65 |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
66 1. If you are using a USB serial adapter, or operating on a Pirelli phone that |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
67 has one built in, connect the USB side first so that the necessary |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
68 /dev/ttyUSB* device node appears. |
97
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
69 |
424
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
70 2. Run fc-loadtool like this: |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
71 |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
72 fc-loadtool $TARGETOPT /dev/ttyXXX |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
73 |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
74 Change /dev/ttyXXX to the actual serial port you are using, and change |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
75 $TARGETOPT to: |
97
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
76 |
424
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
77 Device Needed options |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
78 ----------------------------------- |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
79 Mot C11x/123 -h compal |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
80 Mot C139/140 -h compal -c 1003 |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
81 Mot C155/156 -h c155 |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
82 Openmoko GTA02 -h gta02 |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
83 Pirelli DP-L10 -h pirelli |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
84 |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
85 3. Cause the target device to execute its boot path. Openmoko GTA0x and |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
86 Pirelli DP-L10 targets have the Calypso boot ROM enabled, and will interrupt |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
87 and divert their normal boot path when they "hear" the beacons which |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
88 fc-loadtool will be sending down the serial line. Compal phones have this |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
89 boot ROM disabled at the board level, but their standard firmware includes a |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
90 flash-resident bootloader that offers a different way of interrupting the |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
91 boot path and loading code over the serial line; fc-loadtool will be set up |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
92 to speak the latter protocol when run with the corresponding options from |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
93 the table above. |
97
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
94 |
424
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
95 You will see messages showing fc-loadtool's progress with feeding first |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
96 compalstage (if needed), then loadagent (always needed) to the target device, |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
97 followed by some target-specific initialization done via loadagent commands. |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
98 If all of the above succeeds, you will land at a loadtool> prompt. Type |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
99 'help', and it will guide you from there. Alternatively, you can familiarize |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
100 yourself with loadtool commands and operations without actually running it by |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
101 reading the loadtool.help text file. |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
102 |
428
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
103 Command line options |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
104 ==================== |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
105 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
106 The fc-loadtool command lines shown above will usually be sufficient. However, |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
107 here is the complete command line description for all 3 tools: |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
108 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
109 fc-iram [options] ttyport iramimage.srec |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
110 fc-xram [options] ttyport xramimage.srec [2ndprog] |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
111 fc-loadtool [options] ttyport |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
112 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
113 The available options are common for all 3 utilities, with a few noted |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
114 exceptions: |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
115 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
116 -a /path/to/loadagent |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
117 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
118 This option applies only to fc-loadtool and fc-xram. It specifies the |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
119 pathname at which the required loadagent.srec image should be sought, |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
120 overriding the compiled-in default. |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
121 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
122 -b baud |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
123 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
124 This option is common for all 3 utilities. It selects the baud rate |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
125 to be used when pushing the IRAM image to the Calypso boot ROM. In the |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
126 case of fc-iram, the selected baud rate will be in effect when the |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
127 loaded IRAM image is jumped to and fc-iram drops into the serial tty |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
128 pass-thru mode; in the case of fc-loadtool, it will be the initial baud |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
129 rate for communicating with loadagent, which can be switched later with |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
130 the baud command. The default is 115200 baud. |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
131 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
132 -B baud |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
133 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
134 This option is specific to fc-xram. It selects the baud rate to be |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
135 used when pushing the XRAM image to loadagent. If no -B option is |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
136 specified, fc-xram will communicate with loadagent at the same baud |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
137 rate that was used to load loadagent itself via the Calypso boot ROM |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
138 download protocol, i.e., the rate selected with -b, defaulting to |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
139 115200 baud if no -b option was given either. Neither -b nor -B |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
140 affects the baud rate that will be in effect when the loaded XRAM image |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
141 is jumped to and fc-xram drops into the serial tty pass-thru mode: that |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
142 baud rate independently defaults to 115200 baud and can only be changed |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
143 with the -r option. |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
144 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
145 -c <compalstage flavor> |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
146 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
147 This option is common for all 3 utilities. It directs the tools to |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
148 perform the Compal loading stage before proceeding with the Calypso |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
149 boot ROM serial protocol, and selects the "flavor" of compalstage to |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
150 use. As you can see in the source, compalstage is built in 3 different |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
151 versions, for different C1xx models which exhibit different quirks. |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
152 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
153 This option overrides the compal-stage setting given in the hardware |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
154 parameter file selected with -h or -H; the -c or -C option must be given |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
155 after -h or -H in order to take effect. -c none disables the Compal |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
156 stage and causes the tools to proceed directly to the Calypso boot ROM |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
157 phase, even on targets for which the hardware parameter file specifies |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
158 compal-stage. |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
159 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
160 -C /path/to/compalstage-binary |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
161 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
162 This option is just like -c, except that the given argument is used |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
163 directly as the compalstage binary file pathname (absolute or relative) |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
164 without checking or alteration. |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
165 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
166 -h hwtype |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
167 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
168 This option is common for all 3 utilities. It selects the specific |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
169 target device configuration to be used. More precisely, it constructs |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
170 a pathname of the form /usr/local/share/freecalypso/%s.config, where %s |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
171 is the argument given to this option, and uses that file as the hardware |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
172 parameter file. |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
173 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
174 The hardware configurations known to the present release of FreeCalypso |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
175 loadtools are listed in the "Basic usage" section above. |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
176 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
177 -H /path/to/hwparam-file |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
178 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
179 This option is just like -h, except that the given argument is used |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
180 directly as the hardware parameter file pathname (absolute or relative) |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
181 without alteration. |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
182 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
183 -i num |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
184 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
185 This option is common for all 3 utilities. It specifies the interval |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
186 in milliseconds at which the tool will send "please interrupt the boot |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
187 process" beacons out the serial port, hoping to catch the Calypso |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
188 internal boot ROM. The default is 13 ms. |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
189 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
190 -n |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
191 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
192 This option does anything only when loadtools have been compiled to run |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
193 on GTA0x AP (see the corresponding section below). If you've compiled |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
194 loadtools with the -DGTA0x_AP_BUILD option, it has an effect of making |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
195 each tool automatically toggle the modem power control upon startup, |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
196 removing the need for manual sequencing of the Calypso boot process. |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
197 This -n option suppresses that action, making the AP build behave like |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
198 the standard build in this regard. |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
199 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
200 -r baud (fc-loadtool) |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
201 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
202 This optoin is specific to fc-loadtool. It causes the tool to skip its |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
203 normal steps of feeding loadagent and possibly compalstage to the target |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
204 via special serial protocols, and instead assume that the target is |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
205 already running loadagent, communicating at the specified baud rate. |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
206 In other words, reattach to an already running loadagent. Use this |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
207 option if your fc-loadtool session has been terminated ungracefully and |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
208 you would like to reattach and resume, rather than forcibly reset the |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
209 target by yanking and reinserting the battery and restart from the |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
210 beginning. |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
211 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
212 -r baud (fc-xram) |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
213 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
214 This option is specific to fc-xram. It selects the serial line baud |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
215 rate which should be set just before the loaded XRAM image is jumped |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
216 to; the default is 115200 baud. |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
217 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
218 fc-xram 2nd program invokation |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
219 ============================== |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
220 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
221 The fc-xram utility can take two possible actions after it has loaded the |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
222 specified S-record image into XRAM: |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
223 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
224 * The default action, in the absence of additional command line arguments, is |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
225 to drop into a serial tty pass-thru mode, just like fc-iram. |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
226 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
227 * The alternative action is to invoke a 2nd program and pass the serial |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
228 communication channel to it. This 2nd program invokation facility is intended |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
229 primarily for passing the serial communication channel to rvinterf or rvtdump |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
230 from the FreeCalypso software suite, not for launching any arbitrary 3rd-party |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
231 programs from fc-xram. |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
232 |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
233 The intended usage scenario is that one builds a version of the FreeCalypso GSM |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
234 firmware (or some subset thereof, such as an "in vivo" FFS editing agent) in the |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
235 ramImage configuration, fc-xram is used to load that ramImage into the target |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
236 device, and then the serial communication channel (RVTMUX) is immediately taken |
e61eacecd319
loadtools/README: command line etc description brought over and updated
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
424
diff
changeset
|
237 over by rvinterf or rvtdump. |
107
8b44e806b6e1
loadtools/README: documentation for loadtools should now be complete
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
97
diff
changeset
|
238 |
424
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
239 Openmoko GTA0x |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
240 ============== |
97
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
241 |
424
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
242 All of the above instructions assume that you are running these loadtools on a |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
243 general-purpose host system such as a GNU/Linux PC or laptop, and will |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
244 potentially use them to operate on multiple Calypso targets of different kinds. |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
245 If instead you are building loadtools to run on the application processor of a |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
246 smartphone such as Openmoko GTA0x, then it makes no sense for that special build |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
247 of loadtools to support any target other than the specific modem in that |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
248 smartphone. Loadtools can be built with compalstage support excluded and with |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
249 GTA0x-specific modem power control included instead. This build will still |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
250 include a bunch of functions of no relevance to GTA0x, but oh well.. |
97
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
251 |
424
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
252 To build loadtools for the GTA0x AP, you'll need to make the following |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
253 modifications to the Makefile: |
97
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
254 |
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
255 * Change the CC= line to point to the appropriate cross-compiler (which you'll |
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
256 need to provide yourself); |
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
257 |
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
258 * Change the CFLAGS= line: add the right options to target the ARM920T core in |
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
259 the GTA0x AP (e.g., -march=armv4t -mtune=arm920t), and add -DGTA0x_AP_BUILD |
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
260 to enable some code that makes sense only when running on the GTA0x AP. |
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
261 |
424
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
262 * Change EXTRA_OBJ= from listing compalload.o to listing compaldummy.o and |
1ec83a5fa8b3
loadtools: README update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
228
diff
changeset
|
263 gtapower.o instead. |
97
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
264 |
a2e793f6b8c4
some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff
changeset
|
265 See gta-ap-build.sed for an example. |