annotate target-utils/README @ 1034:405b5469abc4 default tip

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