FreeCalypso > hg > freecalypso-tools
view README @ 766:78101799417c
doc/DUART28-boot-control: update for current patch situation
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Tue, 02 Feb 2021 05:16:01 +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/