FreeCalypso > hg > freecalypso-sw

annotate loadtools/README @ 992:a7b0b426f9ca

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
target-utils: boot ROM UART autodetection revamped The new implementation should work with both the familiar Calypso C035 boot ROM version found in our regular targets as well as the older Calypso F741979B version found on the vintage D-Sample board.
author Mychaela Falconia <falcon@ivan.Harhan.ORG>
date Wed, 30 Dec 2015 21:28:41 +0000
parents e61eacecd319
children 5e73df562a7d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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.