FreeCalypso > hg > freecalypso-sw

comparison target-utils/README @ 387:4391890bacd9

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
documentation update: top level README and target-utils/README
author Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
date Tue, 10 Jun 2014 20:07:13 +0000
parents a2e793f6b8c4
children
comparison
equal deleted inserted replaced
386:90af6744d256 387:4391890bacd9
1 Two programs are currently buildable in this target-utils tree: loadagent and 1 The following target utilities or code components are currently buildable in
2 pirexplore. Loadagent is built to be loaded and run out of the Calypso internal 2 this target-utils tree:
3 (on-chip) RAM, and does not depend on any hardware outside of the Calypso chip
4 itself - thus it should run unchanged on all Calypso targets. It expects to be
5 loaded by the Calypso ROM bootloader in the UART download mode, and it reads a
6 RAM variable left behind by the ROM code that indicates which UART has been used
7 to perform that download - it then uses that same UART to communicate with the
8 host, presenting an interactive command prompt. You can run loadagent "raw" by
9 loading loadagent.srec with fc-iram, but normally it is used "behind the scenes"
10 by fc-loadtool and fc-xram.
11 3
12 Pirexplore is built in the same manner as loadagent (also runs out of IRAM, 4 compalstage For Compal phones only: a little piece of code that is fed to
13 expects to be loaded with fc-iram, and presents an interactive command prompt 5 the original fw's bootloader via the serial download protocol
14 on the autodetected UART), but it automatically performs some hardware (board 6 provided by the latter; it re-enables the Calypso chip boot ROM
15 level) initialization specific to the Pirelli, and offers additional commands 7 and jumps to it, allowing our loadagent to be loaded in the
16 for exploring the hardware features of this device. 8 same way as on freedom-enabled devices.
9
10 helloapp Template/skeleton for building programs like loadagent and
11 pirexplore.
12
13 loadagent Loadagent is built to be loaded and run out of the Calypso
14 internal (on-chip) RAM, and does not depend on any hardware
15 outside of the Calypso chip itself - thus it should run
16 unchanged on all Calypso targets. It expects to be loaded by
17 the Calypso ROM bootloader in the UART download mode, and it
18 reads a RAM variable left behind by the ROM code that indicates
19 which UART has been used to perform that download - it then
20 uses that same UART to communicate with the host, presenting an
21 interactive command prompt. You can run loadagent "raw" by
22 loading loadagent.srec with fc-iram, but normally it is used
23 "behind the scenes" by fc-loadtool and fc-xram.
24
25 pirexplore For Pirelli DP-L10 target only: this program is built in the
26 same manner as loadagent (also runs out of IRAM, expects to be
27 loaded with fc-iram, and presents an interactive command prompt
28 on the autodetected UART), but it automatically performs some
29 hardware (board level) initialization specific to the Pirelli,
30 and offers additional commands for exploring the hardware
31 features of this device.
32
33 tf-breakin Here we build the payload for the tfc139 hack-utility; see
34 ../rvinterf/lowlevel/tfc139.c for the ugly details.