view 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 dddcd55883fe
children
line wrap: on
line source

You are looking at the top level of the FreeCalypso host tools package.  All
tools in this package have been written to run on a Unix-based or Unix-like
host system, such as a GNU/Linux PC or laptop, with the expectation that the
user will compile them from the source using her regular system C compiler.
See INSTALL for installation instructions.  Most of these tools interface to
and operate on Calypso-based GSM devices, while a few perform some ancillary
functions.  Please see doc/Host-tools-overview for the listing of what tools
are available and what they do.

The most commonly needed tool for flashing firmware images (fc-loadtool) and
some of the more rarely needed tools (fc-xram, fc-iram when used with Mot C1xx
phones, and fc-buzplay) have target-side components, i.e., a part of their
functionality is implemented in Calypso ARM7 code pieces which these tools feed
to the Calypso chip's boot ROM or to Mot/Compal's bootloader on Mot C1xx phones.
The most important of these ARM7 code pieces is loadagent (implements flash
reading and writing, hardware peeks and pokes, and the chain loading function
for fc-xram) which is needed for all of our supported Calypso targets (it is
also common to all of them, no variants), and the second most important piece
is compalstage, which is needed for Compal (Mot C1xx) phones only.

If you are working with a packaged release of FC host tools, as opposed to a
random snapshot of the source tree, precompiled binaries for loadagent and
compalstage will be included in the target-bin directory, otherwise you will
need to build them from source: the source for loadagent and compalstage (plus
a few extra target utilities that are of interest only to developers) resides
in target-utils, and you will first need to build and install a special ARM7
gcc toolchain as explained in the INSTALL document.

There is a good amount of documentation included in the doc directory, and
there is more documentation in our dedicated freecalypso-docs repository:

https://www.freecalypso.org/hg/freecalypso-docs/