FreeCalypso > hg > freecalypso-sw

comparison README @ 387:4391890bacd9

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
documentation update: top level README and target-utils/README
author Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
date Tue, 10 Jun 2014 20:07:13 +0000
parents 3d88461d8284
children c617a6adcb69
comparison
equal deleted inserted replaced
386:90af6744d256 387:4391890bacd9
1 You are looking at the top level of the freecalypso-sw source code tree. 1 You are looking at the top level of the freecalypso-sw source code tree. The
2 primary aim of this project is to produce our own full-source GSM firmware that
3 would fully operate the TI Calypso-based GSM phones and modems of interest to
4 us; this primary subproject is being worked on in the gsm-fw subtree. While
5 that project is progressing very slowly, the associated side projects have
6 already produced some useful tools for operating on these GSM devices; see
7 README.hosttools for the details.
8
2 The subtrees of this source tree are as follows: 9 The subtrees of this source tree are as follows:
3 10
4 gsm-fw This tree contains the early beginnings of my (Michael 11 gsm-fw This tree contains the early beginnings of my (Michael
5 Spacefalcon's) attempt to recreate TI's GSM firmware suite for 12 Spacefalcon's) attempt to recreate TI's GSM firmware suite for
6 modems and basic phones, consisting of Nucleus RTOS, RiViera 13 modems and basic phones, consisting of Nucleus RTOS, RiViera
8 GSM/GPRS protocol stack, AT command interpreter and UI layers. 15 GSM/GPRS protocol stack, AT command interpreter and UI layers.
9 16
10 At the present, none of the actual GSM code (L1 or G23) has 17 At the present, none of the actual GSM code (L1 or G23) has
11 been integrated yet, but most of the underlying RTOS environment 18 been integrated yet, but most of the underlying RTOS environment
12 is present and working: one can exercise RVT, ETM and FFS. 19 is present and working: one can exercise RVT, ETM and FFS.
13 L1 integration will begin soon. 20 The OSL component of GPF is currently being worked on; L1 will
21 follow afterward.
14 22
15 ffstools Here you will find tools for "in vitro" examination of FFS 23 target-utils This tree contains code that runs on Calypso targets, but is
16 (flash file system) images read out of TI-based GSM devices. 24 not regular firmware (gsm-fw) or a part thereof. The two key
17 See doc/TIFFS-Overview for more information. 25 components built in this tree are loadagent (needed for all
26 targets) and compalstage (for Compal phones only), which need
27 to be installed on the user's host system in order for
28 loadtools (see README.hosttools) to do their job.
18 29
19 loadtools The suite of tools which run on a development host machine 30 ffstools Tools that run on a Unix or GNU/Linux host; see README.hosttools
20 (normally PC/Linux desktop or laptop) and communicate with 31 loadtools for the details.
21 Calypso targets. Starting from the Calypso ROM bootloader, 32 miscutil
22 these tools allow you to peek and poke registers, read and 33 rvinterf
23 program flash, and load and execute experimental code in IRAM
24 or XRAM.
25
26 rvinterf In common with TI's original fw, FreeCalypso GSM fw implements
27 the so-called RiViera serial MUX, which is a binary packet
28 protocol for multiplexing many kinds of debug and development
29 traffic over just one available physical serial port. This
30 rvinterf directory contains the early beginnings of our suite
31 of tools for connecting to this RV serial interface, supporting
32 both our own gsm-fw as well as some existing proprietary
33 firmwares to the extent to which they are compatible.
34
35 target-utils These are utilities which run on Calypso targets, but which are
36 independent of Nucleus, of any other RTOS, and of any larger
37 firmware suite, i.e., totally standalone. The two current
38 utilities are loadagent, which is common for all currently
39 supported Calypso targets and is required in order to use
40 fc-loadtool or fc-xram (see loadtools), and pirexplore - the
41 latter is a hardware exploration utility specific to the
42 Pirelli DP-L10 target.
43 34
44 toolchain Scripts and patches for building the gcc+binutils toolchain 35 toolchain Scripts and patches for building the gcc+binutils toolchain
45 targeting ARM7, the CPU core of the Calypso GSM/GPRS baseband 36 targeting ARM7, the CPU core of the Calypso GSM/GPRS baseband
46 processor. You'll need to build and install this toolchain 37 processor. You'll need to build and install this toolchain
47 first before you can build gsm-fw or target-utils. 38 first before you can build gsm-fw or target-utils.