FreeCalypso > hg > freecalypso-tools
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.