diff target-utils/README @ 97:a2e793f6b8c4

some README files added
author Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
date Sun, 01 Sep 2013 12:54:42 +0000
parents
children 4391890bacd9
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/target-utils/README	Sun Sep 01 12:54:42 2013 +0000
@@ -0,0 +1,16 @@
+Two programs are currently buildable in this target-utils tree: loadagent and
+pirexplore.  Loadagent is built to be loaded and run out of the Calypso internal
+(on-chip) RAM, and does not depend on any hardware outside of the Calypso chip
+itself - thus it should run unchanged on all Calypso targets.  It expects to be
+loaded by the Calypso ROM bootloader in the UART download mode, and it reads a
+RAM variable left behind by the ROM code that indicates which UART has been used
+to perform that download - it then uses that same UART to communicate with the
+host, presenting an interactive command prompt.  You can run loadagent "raw" by
+loading loadagent.srec with fc-iram, but normally it is used "behind the scenes"
+by fc-loadtool and fc-xram.
+
+Pirexplore is built in the same manner as loadagent (also runs out of IRAM,
+expects to be loaded with fc-iram, and presents an interactive command prompt
+on the autodetected UART), but it automatically performs some hardware (board
+level) initialization specific to the Pirelli, and offers additional commands
+for exploring the hardware features of this device.