comparison README @ 1034:405b5469abc4 default tip

top README: repository change notice
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 12 Jun 2016 19:06:34 +0000
parents 36e3f6bf0156
children
comparison
equal deleted inserted replaced
1033:5ab737ac3ad7 1034:405b5469abc4
1 This source repository is a top-level container for all of the main software 1 This source repository has been retired and will not receive any further
2 and firmware components developed in the FreeCalypso project. 2 development; it is kept around only to preserve history. Further development
3 The subtrees of this source tree are as follows: 3 of software components contained in this repository has been moved to two new
4 repositories:
4 5
5 compal-flash-boot-for-fc 6 gcc-built experimental GSM firmware (gsm-fw):
6 A patched version of Compal's flash boot code for Mot C11x/12x
7 and C139/140 families, modified to work with main fw images from
8 FreeCalypso subprojects. It is compatible with our own gsm-fw
9 and with tcs211-c139.
10 7
11 ffstools Here you will find tools for "in vitro" examination of FFS 8 Now called FreeCalypso Citrine and maintained in the
12 (flash file system) images read out of TI-based GSM devices. 9 freecalypso-citrine repository.
13 See doc/TIFFS-Overview for more information.
14 10
15 gsm-fw Our Calypso GSM firmware reconstruction and reintegration 11 FreeCalypso host tools and target-utils:
16 attempt lives here; see doc/Firmware_Architecture and
17 doc/Firmware_Status for more information.
18 12
19 loadtools These tools allow you to load your own code into Calypso GSM 13 Moved to freecalypso-tools repository.
20 devices. Using these tools, you can load code into target
21 device IRAM or XRAM and run it there, as well as dump and load
22 flash. The operation of these tools is based on gaining
23 control of the target device either through the Calypso on-chip
24 boot ROM (on freedom-enabled devices), or through the
25 flash-resident boot code on the crippled Compal phones.
26
27 lcdemu fc-lcdemu is built here.
28
29 miscutil fc-rgbconv, fc-serterm and imei-luhn are built here.
30
31 rvinterf In common with TI's original fw, FreeCalypso GSM fw implements
32 the so-called RiViera serial MUX, which is a binary packet
33 protocol for multiplexing many kinds of debug and development
34 traffic over just one available physical serial port. This
35 rvinterf directory contains our suite of tools for connecting
36 to this RV serial interface, supporting both our own gsm-fw as
37 well as some existing proprietary firmwares to the extent to
38 which they are compatible.
39
40 target-utils This tree contains code that runs on Calypso targets, but is
41 not regular firmware (gsm-fw) or a part thereof. The two key
42 components built in this tree are loadagent (needed for all
43 targets) and compalstage (for Compal phones only), which need
44 to be installed on the user's host system in order for
45 loadtools (see above) to do their job.
46
47 toolchain Scripts and patches for building the gcc+binutils toolchain
48 targeting ARM7, the CPU core of the Calypso GSM/GPRS baseband
49 processor. You'll need to build and install this toolchain
50 first before you can build gsm-fw or target-utils.
51
52 Website and mailing list
53 ========================
54
55 Please see our website at www.freecalypso.org for information on:
56
57 * The overall FreeCalypso libre phone project, beyond this specific sw/fw
58 subproject;
59
60 * Our community mailing list and how you can subscribe to it;
61
62 * How you can help the human family behind the project with donations and how
63 you can accelerate the progress of our project by funding it.