view target-utils/README @ 964:a96cb97b66a2

ringtools/imy: fix duplicate definition of tdma_durations[] The bug was reported by Vadim Yanitskiy <fixeria@osmocom.org>, although the present fix is slightly different from the contributed patch: because main.c doesn't need this tdma_durations[] array at all, let's simply remove the reference to this array from main.c rather than turn it into an extern. I no longer remember my original thought flow that resulted (by mistake) in tdma_durations[] being multiply defined in main.c and durations.c. My intent might have been to define all globals in main.c and have the reference in durations.c be an extern - and I missed that extern - but without clear memory, I have no certainty. In any case, having this data array defined in the same module that fills it (durations.c) is sensible, so let's make it the new way.
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 31 Aug 2023 19:38:18 +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.