--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/target-utils/README	Sat Jun 11 00:13:35 2016 +0000
@@ -0,0 +1,34 @@
+The following target utilities or code components are currently buildable in
+this target-utils tree:
+
+compalstage	For Compal phones only: a little piece of code that is fed to
+		the original fw's bootloader via the serial download protocol
+		provided by the latter; it re-enables the Calypso chip boot ROM
+		and jumps to it, allowing our loadagent to be loaded in the
+		same way as on freedom-enabled devices.
+
+helloapp	Template/skeleton for building programs like loadagent and
+		pirexplore.
+
+loadagent	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	For Pirelli DP-L10 target only: this program 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.
+
+tf-breakin	Here we build the payload for the tfc139 hack-utility; see
+		../rvinterf/lowlevel/tfc139.c for the ugly details.