annotate target-utils/README @ 196:3daa8ebbe74d

pirexplore: a bit of refactoring
author Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
date Sat, 14 Dec 2013 07:55:22 +0000
parents a2e793f6b8c4
children 4391890bacd9
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
97
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
1 Two programs are currently buildable in this target-utils tree: loadagent and
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
2 pirexplore. Loadagent is built to be loaded and run out of the Calypso internal
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
3 (on-chip) RAM, and does not depend on any hardware outside of the Calypso chip
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
4 itself - thus it should run unchanged on all Calypso targets. It expects to be
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
5 loaded by the Calypso ROM bootloader in the UART download mode, and it reads a
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
6 RAM variable left behind by the ROM code that indicates which UART has been used
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
7 to perform that download - it then uses that same UART to communicate with the
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
8 host, presenting an interactive command prompt. You can run loadagent "raw" by
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
9 loading loadagent.srec with fc-iram, but normally it is used "behind the scenes"
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
10 by fc-loadtool and fc-xram.
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 Pirexplore is built in the same manner as loadagent (also runs out of IRAM,
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
13 expects to be loaded with fc-iram, and presents an interactive command prompt
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
14 on the autodetected UART), but it automatically performs some hardware (board
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
15 level) initialization specific to the Pirelli, and offers additional commands
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
16 for exploring the hardware features of this device.