annotate doc/Loadtools-usage @ 619:f82551c77e58

libserial-newlnx: ASYNC_LOW_LATENCY patch reverted Reports from Das Signal indicate that loadtools performance on Debian is about the same as on Slackware, and that including or omitting the ASYNC_LOW_LATENCY patch from Serg makes no difference. Because the patch in question does not appear to be necessary, it is being reverted until and unless someone other than Serg reports an actual real-world system on which loadtools operation times are slowed compared to the Mother's Slackware reference and on which Slackware-like performance can be restored by setting the ASYNC_LOW_LATENCY flag.
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 27 Feb 2020 01:09:48 +0000
parents f3af56eac3f4
children 7674abe34c25
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
209
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 The loadtools subset of FreeCalypso host tools consists of:
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3 fc-loadtool The tool for operating on Calypso GSM devices at a low
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 level. After "breaking" into the target GSM device in
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 its boot process and getting FreeCalypso loadagent
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 running on the target (out of Calypso internal RAM, aka
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7 IRAM), loadtool presents an interactive command prompt
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 with commands for peeking and poking registers and most
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 importantly, reading and writing any part of the
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 device's non-volatile flash memory.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 fc-iram & fc-xram These utilities are intended for FreeCalypso developers
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 only. They load an S-record code image into IRAM or
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14 XRAM, respectively, induce a transfer of control to the
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15 loaded code, and then drop into a serial line pass-thru
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 mode for the operator to interact with the thus loaded
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 target code.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18
556
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
19 The currently supported target devices are:
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
20
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
21 1) All Calypso devices (preferably with Iota ABB so we can cleanly power off
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
22 after we are done) that have Calypso boot ROM (version 0200 or 0300) enabled
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
23 by nIBOOT strapping on the board. This category includes TI and FreeCalypso
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
24 development boards, several modems (Openmoko GTA01/02, Huawei GTM900, Tango)
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
25 and other devices.
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
26
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
27 2) Motorola C1xx and Sony Ericsson J100 phones made by Compal: these phones do
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
28 NOT have Calypso boot ROM enabled, but they provide a different way of
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
29 gaining serial code download access which is supported by our tools.
209
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31 All tools in the FreeCalypso loadtools suite work by feeding pieces of code to
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32 the target device as it boots, preventing the booting of its regular firmware
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33 and diverting control to these externally-loaded code pieces. These pieces of
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34 ARM7 target code need to be installed on the host system running loadtools,
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
35 normally in /opt/freecalypso/target-bin:
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
36
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
37 loadagent This is the "agent" code that runs on the target device when
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
38 fc-loadtool is operating on it: loadtool carries out its
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
39 operations by sending commands to loadagent. There is only one
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
40 version of loadagent for all currently supported Calypso
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
41 targets: loadagent does not access any resources outside of the
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
42 Calypso chip itself unless commanded to do so, and loadtool
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
43 supports different target devices with different hardware
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
44 configurations by sending different commands to loadagent as
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
45 appropriate.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
46
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
47 compalstage For Compal phones only: a little piece of code that is fed to
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
48 the original fw's bootloader via the serial download protocol
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
49 provided by the latter; it re-enables the Calypso chip boot ROM
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
50 and jumps to it, allowing our loadagent to be loaded in the
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
51 same way as on freedom-enabled devices.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
52
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
53 If you are working with a development snapshot of the freecalypso-tools source
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
54 tree, you will need to compile and install a GNU cross-compiler toolchain
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
55 targeting ARM7 (see ../toolchain) and then use that toolchain to compile
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
56 loadagent and compalstage (see ../target-utils) before you can successfully use
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
57 loadtools to operate on a target device. End-user oriented releases of
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
58 FreeCalypso host tools include prebuilt loadagent and compalstage binaries.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
59
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
60 Basic usage
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
61 ===========
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
62
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
63 The steps for bringing up fc-loadtool to operate on a target Calypso device are
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
64 as follows:
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
65
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
66 1. If you are using a USB serial adapter, or operating on a Pirelli phone that
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
67 has one built in, connect the USB side first so that the necessary
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
68 /dev/ttyUSB* device node appears. If you are working with a target such as
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
69 FCDEV3B or D-Sample on which both Calypso UARTs are equally accessible with
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
70 equal convenience, you can arbitrarily pick either one for fc-loadtool - it
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
71 will work exactly the same through either port.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
72
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
73 2. Run fc-loadtool like this:
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
74
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
75 fc-loadtool $TARGETOPT /dev/ttyXXX
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
76
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
77 Change /dev/ttyXXX to the actual serial port you are using, and change
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
78 $TARGETOPT to:
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
79
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
80 Device Needed options
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
81 -----------------------------------
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
82 FreeCalypso FCDEV3B -h fcfam
562
e9d3fd3389e6 doc/Loadtools-usage: updated for -h gen8 (GTM900 & Tango)
Mychaela Falconia <falcon@freecalypso.org>
parents: 556
diff changeset
83 Huawei GTM900 -h gen8
209
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
84 Mot C11x/123 -h compal
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
85 Mot C139/140 -h compal -c 1004
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
86 Mot C155/156 -h c155
514
5f66dd6e676b doc/Loadtools-usage: Mot W220 support added
Mychaela Falconia <falcon@freecalypso.org>
parents: 480
diff changeset
87 Mot W220 -h w220
568
a97d96e0fc5c doc: new Loadtool-targets article
Mychaela Falconia <falcon@freecalypso.org>
parents: 562
diff changeset
88 Openmoko GTA01/02 -h fic
209
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
89 Pirelli DP-L10 -h pirelli
480
09b47223ee1b doc/Loadtools-usage: SE J100 documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 463
diff changeset
90 Sony Ericsson J100 -h compal -c 1004
209
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
91 TI D-Sample -h dsample
556
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
92 TI Leonardo -h leonardo
562
e9d3fd3389e6 doc/Loadtools-usage: updated for -h gen8 (GTM900 & Tango)
Mychaela Falconia <falcon@freecalypso.org>
parents: 556
diff changeset
93 Tango modem -h gen8
209
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
94
568
a97d96e0fc5c doc: new Loadtool-targets article
Mychaela Falconia <falcon@freecalypso.org>
parents: 562
diff changeset
95 Please refer to the Loadtool-targets article for more information about -h
a97d96e0fc5c doc: new Loadtool-targets article
Mychaela Falconia <falcon@freecalypso.org>
parents: 562
diff changeset
96 targets.
a97d96e0fc5c doc: new Loadtool-targets article
Mychaela Falconia <falcon@freecalypso.org>
parents: 562
diff changeset
97
209
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
98 3. Cause the target device to execute its boot path. TI/Openmoko/FreeCalypso
556
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
99 and other sensible targets have the Calypso boot ROM enabled, and will
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
100 interrupt and divert their normal boot path when they "hear" the beacons
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
101 which fc-loadtool will be sending down the serial line. Compal phones have
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
102 this boot ROM disabled at the board level, but their standard firmware
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
103 includes a flash-resident bootloader that offers a different way of
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
104 interrupting the boot path and loading code over the serial line;
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
105 fc-loadtool will be set up to speak the latter protocol when run with the
9a53f62c9990 doc/Loadtools-usage: updated for Leonardo and Tango support
Mychaela Falconia <falcon@freecalypso.org>
parents: 537
diff changeset
106 corresponding options from the table above.
209
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
107
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
108 You will see messages showing fc-loadtool's progress with feeding first
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
109 compalstage (if needed), then loadagent (always needed) to the target device,
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
110 followed by some target-specific initialization done via loadagent commands.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
111 If all of the above succeeds, you will land at a loadtool> prompt. Type
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
112 'help', and it will guide you from there. Alternatively, you can familiarize
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
113 yourself with loadtool commands and operations without actually running it by
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
114 reading the loadtool.help text file.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
115
236
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
116 fc-loadtool batch mode
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
117 ======================
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
118
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
119 In addition to the interactive mode described above, fc-loadtool can be used in
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
120 a scripted or batch mode where it makes contact with the target device as it
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
121 boots, interrupts and diverts the boot process to loadagent, executes a given
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
122 command script, cleans up the target state as appropriate (usually powers off)
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
123 and exits. This mode is used by the FreeCalypso factory for initial flash
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
124 programming on the device production line, but it can also be used by end users
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
125 to install firmware updates in a more automated manner.
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
126
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
127 The batch mode is entered when there is a command script given on the
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
128 fc-loadtool invokation command line.
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
129
209
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
130 Command line options
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
131 ====================
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
132
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
133 The fc-loadtool command lines shown above will usually be sufficient. However,
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
134 here is the complete command line description for all 3 tools:
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
135
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
136 fc-iram [options] ttyport iramimage.srec [2ndprog]
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
137 fc-xram [options] ttyport xramimage.srec [2ndprog]
236
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
138 fc-loadtool [options] ttyport [batch-script]
209
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
139
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
140 The available options are common for all 3 utilities, with a few noted
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
141 exceptions:
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
142
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
143 -a /path/to/loadagent
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
144
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
145 This option applies only to fc-loadtool and fc-xram. It specifies the
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
146 pathname at which the required loadagent.srec image should be sought,
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
147 overriding the compiled-in default.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
148
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
149 -b baud
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
150
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
151 This option is common for all 3 utilities. It selects the baud rate
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
152 to be used when pushing the IRAM image to the Calypso boot ROM. In the
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
153 case of fc-iram, the selected baud rate will be in effect when the
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
154 loaded IRAM image is jumped to and fc-iram drops into the serial tty
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
155 pass-thru mode; in the case of fc-loadtool, it will be the initial baud
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
156 rate for communicating with loadagent, which can be switched later with
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
157 the baud command. The default is 115200 baud.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
158
236
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
159 -B baud (fc-loadtool)
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
160
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
161 This option is specific to the batch mode of fc-loadtool, and has no
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
162 effect when no batch mode command script is specified on the command
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
163 line. In the batch mode this option commands a baud rate switch to be
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
164 performed before the command script is executed.
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
165
b5f2ccfdafec doc/Loadtools-usage: fc-loadtool batch mode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 215
diff changeset
166 -B baud (fc-xram)
209
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
167
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
168 This option is specific to fc-xram. It selects the baud rate to be
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
169 used when pushing the XRAM image to loadagent. If no -B option is
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
170 specified, fc-xram will communicate with loadagent at the same baud
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
171 rate that was used to load loadagent itself via the Calypso boot ROM
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
172 download protocol, i.e., the rate selected with -b, defaulting to
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
173 115200 baud if no -b option was given either. Neither -b nor -B
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
174 affects the baud rate that will be in effect when the loaded XRAM image
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
175 is jumped to and fc-xram drops into the serial tty pass-thru mode: that
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
176 baud rate independently defaults to 115200 baud and can only be changed
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
177 with the -r option.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
178
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
179 -c <compalstage flavor>
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
180
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
181 This option is common for all 3 utilities. It directs the tools to
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
182 perform the Compal loading stage before proceeding with the Calypso
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
183 boot ROM serial protocol, and selects the "flavor" of compalstage to
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
184 use. As you can see in the source, compalstage is built in 3 different
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
185 versions, for different C1xx models which exhibit different quirks.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
186
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
187 This option overrides the compal-stage setting given in the hardware
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
188 parameter file selected with -h or -H; the -c or -C option must be given
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
189 after -h or -H in order to take effect. -c none disables the Compal
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
190 stage and causes the tools to proceed directly to the Calypso boot ROM
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
191 phase, even on targets for which the hardware parameter file specifies
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
192 compal-stage.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
193
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
194 -C /path/to/compalstage-binary
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
195
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
196 This option is just like -c, except that the given argument is used
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
197 directly as the compalstage binary file pathname (absolute or relative)
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
198 without checking or alteration.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
199
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
200 -h hwtype
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
201
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
202 This option is common for all 3 utilities. It selects the specific
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
203 target device configuration to be used. More precisely, it constructs
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
204 a pathname of the form /opt/freecalypso/loadtools/%s.config, where %s
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
205 is the argument given to this option, and uses that file as the hardware
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
206 parameter file.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
207
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
208 The hardware configurations known to the present release of FreeCalypso
568
a97d96e0fc5c doc: new Loadtool-targets article
Mychaela Falconia <falcon@freecalypso.org>
parents: 562
diff changeset
209 loadtools are listed in the Loadtool-targets article.
209
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
210
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
211 -H /path/to/hwparam-file
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
212
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
213 This option is just like -h, except that the given argument is used
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
214 directly as the hardware parameter file pathname (absolute or relative)
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
215 without alteration.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
216
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
217 -i num
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
218
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
219 This option is common for all 3 utilities. It specifies the interval
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
220 in milliseconds at which the tool will send "please interrupt the boot
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
221 process" beacons out the serial port, hoping to catch the Calypso
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
222 internal boot ROM. The default is 13 ms.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
223
537
018488f6343b doc/Loadtools-usage: new fc-xram -j option documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 524
diff changeset
224 -j
018488f6343b doc/Loadtools-usage: new fc-xram -j option documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 524
diff changeset
225
018488f6343b doc/Loadtools-usage: new fc-xram -j option documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 524
diff changeset
226 This option is specific to fc-xram; it selects the special JTAG mode.
018488f6343b doc/Loadtools-usage: new fc-xram -j option documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 524
diff changeset
227 In this mode the jump command to start executing the loaded image is
018488f6343b doc/Loadtools-usage: new fc-xram -j option documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 524
diff changeset
228 skipped and the target is left in loadagent, allowing the developer to
018488f6343b doc/Loadtools-usage: new fc-xram -j option documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 524
diff changeset
229 connect via JTAG, halt the ARM7 core, set whatever breakpoints or
018488f6343b doc/Loadtools-usage: new fc-xram -j option documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 524
diff changeset
230 watchpoints are needed and resume at the image start address.
018488f6343b doc/Loadtools-usage: new fc-xram -j option documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 524
diff changeset
231
586
f3af56eac3f4 doc/Loadtools-usage: -P option instead of -n
Mychaela Falconia <falcon@freecalypso.org>
parents: 568
diff changeset
232 -P <boot control name>
209
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
233
586
f3af56eac3f4 doc/Loadtools-usage: -P option instead of -n
Mychaela Falconia <falcon@freecalypso.org>
parents: 568
diff changeset
234 This option is common for all utilities in the loadtools suite; it
f3af56eac3f4 doc/Loadtools-usage: -P option instead of -n
Mychaela Falconia <falcon@freecalypso.org>
parents: 568
diff changeset
235 tells the tools to perform target boot control as described in the
f3af56eac3f4 doc/Loadtools-usage: -P option instead of -n
Mychaela Falconia <falcon@freecalypso.org>
parents: 568
diff changeset
236 Target-boot-control article.
209
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
237
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
238 -r baud (fc-loadtool)
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
239
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
240 This option is specific to fc-loadtool. It causes the tool to skip its
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
241 normal steps of feeding loadagent and possibly compalstage to the target
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
242 via special serial protocols, and instead assume that the target is
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
243 already running loadagent, communicating at the specified baud rate.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
244 In other words, reattach to an already running loadagent. Use this
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
245 option if your fc-loadtool session has been terminated ungracefully and
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
246 you would like to reattach and resume, rather than forcibly reset the
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
247 target by yanking and reinserting the battery and restart from the
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
248 beginning.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
249
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
250 -r baud (fc-xram)
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
251
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
252 This option is specific to fc-xram. It selects the serial line baud
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
253 rate which should be set just before the loaded XRAM image is jumped
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
254 to; the default is 115200 baud.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
255
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
256 fc-iram & fc-xram 2nd program invokation
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
257 ========================================
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
258
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
259 Our fc-iram and fc-xram utilities can take two possible actions after they have
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
260 loaded the specified S-record image into RAM:
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
261
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
262 * The default action, in the absence of additional command line arguments, is
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
263 to drop into a serial tty pass-thru mode.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
264
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
265 * The alternative action is to invoke a 2nd program and pass the serial
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
266 communication channel to it. This 2nd program invokation facility is intended
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
267 primarily for passing the serial communication channel to rvinterf or rvtdump
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
268 from the FreeCalypso host tools suite, not for launching any arbitrary
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
269 3rd-party programs from fc-xram or fc-iram.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
270
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
271 This feature was originally implemented in fc-xram only, and the intended usage
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
272 scenario is that one builds a version of one of our FreeCalypso GSM firmwares
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
273 (or some subset thereof, such as an "in vivo" FFS editing agent) in the ramImage
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
274 configuration, fc-xram is used to load that ramImage into the target device,
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
275 and then the serial communication channel (RVTMUX) is immediately taken over by
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
276 rvinterf or rvtdump.
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
277
5433349a6e2c doc/Loadtools-usage: replacing loadtools/README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
278 This second program invokation capability was later extended to fc-iram for no
416
30f6d1c32c6f doc/Flash-boot-defect article removed (no longer relevant)
Mychaela Falconia <falcon@freecalypso.org>
parents: 236
diff changeset
279 purpose other than to facilitate a boot hack that was only needed on one (1)
463
131eefcbe4d7 doc/Loadtools-usage: refer to Flash-boot-wa article when explaining
Mychaela Falconia <falcon@freecalypso.org>
parents: 416
diff changeset
280 defective FCDEV3B board - see the Flash-boot-wa article.