FreeCalypso > hg > freecalypso-tools

view README @ 497:74610c4f10f7

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
target-utils: added 10 ms delay at the end of abb_power_off() The deosmification of the ABB access code (replacement of osmo_delay_ms() bogus delays with correctly-timed ones, which are significantly shorter) had one annoying side effect: when executing the poweroff command from any of the programs, one last '=' prompt character was being sent (and received by the x86 host) as the Calypso board powers off. With delays being shorter now, the abb_power_off() function was returning and the standalone program's main loop was printing its prompt before the Iota chip fully executed the switch-off sequence! I thought about inserting an endless tight loop at the end of the abb_power_off() function, but the implemented solution of a 10 ms delay is a little nicer IMO because if the DEVOFF operation doesn't happen for some reason in a manual hacking scenario, there won't be an artificial blocker in the form of a tight loop keeping us from further poking around.
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 25 May 2019 20:44:05 +0000
parents 3ec8ef8b2d37
children dddcd55883fe
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://bitbucket.org/falconian/freecalypso-docs