view target-utils/README @ 718:098fea21ba13

doc/Host-tools-overview: tiffs-mkfs description updated The first version of tiffs-mkfs did not include a journal file in the created FFS, expecting the firmware to create it on first boot. All historical firmwares prior to a recent FC fix (2020-05) contain a bug in that code path, thus images made with the first version of tiffs-mkfs were only acceptable to very recent FC firmwares. tiffs-mkfs has now been extended to include an empty journal in the created FFS, thus the restriction of working with recent fw only has been lifted.
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 23 Aug 2020 04:55:02 +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.