FreeCalypso > hg > freecalypso-sw

annotate target-utils/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 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.