view target-utils/README @ 995:74024eb17e04

fc-loadtool help: improve language regarding 16 MiB flash chips In FC project history, 16 MiB flash originally meant Pirelli DP-L10. Then we got FCDEV3B with the same flash (our own design), but now we are discovering more Calypso devices that used such large flash, both late Calypso era (Sony Ericsson K2x0) as well as much earlier ones (FIC FLUID devices.txt file with 2004 dates, Leonardo+ rev 5). Hence we need to migrate to more generic or neutral language in associated documentation, without giving elevated status to specific examples that drove our early project history.
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 03 Dec 2023 21:11:12 +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.