view target-utils/README @ 698:9ecbf1bf2e1b

fc-iram: added '+' to getopt magic string like in fc-xram Both fc-iram and fc-xram now support secondary program invokation. If the user needs to pass some options to the secondary program, we don't want fc-iram or fc-xram to claim these options as its own, thus we need to stop getopt() from reordering arguments. This fix was already implemented in fc-xram a long time ago, but the issue was overlooked when secondary program invokation ability was added to fc-iram.
author Mychaela Falconia <falcon@freecalypso.org>
date Tue, 31 Mar 2020 03:23:26 +0000
parents e7502631a0f9
children
line wrap: on
line source

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.