annotate README @ 387:4391890bacd9

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
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
387
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
1 You are looking at the top level of the freecalypso-sw source code tree. The
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
2 primary aim of this project is to produce our own full-source GSM firmware that
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
3 would fully operate the TI Calypso-based GSM phones and modems of interest to
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
4 us; this primary subproject is being worked on in the gsm-fw subtree. While
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
5 that project is progressing very slowly, the associated side projects have
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
6 already produced some useful tools for operating on these GSM devices; see
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
7 README.hosttools for the details.
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
8
97
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
9 The subtrees of this source tree are as follows:
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
10
143
afceeeb2cba1 Our nuc-fw is destined to become gsm-fw, so I went ahead and did the big hg mv
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 97
diff changeset
11 gsm-fw This tree contains the early beginnings of my (Michael
afceeeb2cba1 Our nuc-fw is destined to become gsm-fw, so I went ahead and did the big hg mv
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 97
diff changeset
12 Spacefalcon's) attempt to recreate TI's GSM firmware suite for
afceeeb2cba1 Our nuc-fw is destined to become gsm-fw, so I went ahead and did the big hg mv
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 97
diff changeset
13 modems and basic phones, consisting of Nucleus RTOS, RiViera
afceeeb2cba1 Our nuc-fw is destined to become gsm-fw, so I went ahead and did the big hg mv
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 97
diff changeset
14 and GPF frameworks, TI's BSP/driver and L1 code, Condat G23
afceeeb2cba1 Our nuc-fw is destined to become gsm-fw, so I went ahead and did the big hg mv
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 97
diff changeset
15 GSM/GPRS protocol stack, AT command interpreter and UI layers.
250
3d88461d8284 beginning of TIFFS IVA documentation
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 143
diff changeset
16
3d88461d8284 beginning of TIFFS IVA documentation
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 143
diff changeset
17 At the present, none of the actual GSM code (L1 or G23) has
3d88461d8284 beginning of TIFFS IVA documentation
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 143
diff changeset
18 been integrated yet, but most of the underlying RTOS environment
3d88461d8284 beginning of TIFFS IVA documentation
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 143
diff changeset
19 is present and working: one can exercise RVT, ETM and FFS.
387
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
20 The OSL component of GPF is currently being worked on; L1 will
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
21 follow afterward.
97
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
22
387
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
23 target-utils This tree contains code that runs on Calypso targets, but is
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
24 not regular firmware (gsm-fw) or a part thereof. The two key
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
25 components built in this tree are loadagent (needed for all
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
26 targets) and compalstage (for Compal phones only), which need
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
27 to be installed on the user's host system in order for
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
28 loadtools (see README.hosttools) to do their job.
97
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
29
387
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
30 ffstools Tools that run on a Unix or GNU/Linux host; see README.hosttools
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
31 loadtools for the details.
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
32 miscutil
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
33 rvinterf
97
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
34
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
35 toolchain Scripts and patches for building the gcc+binutils toolchain
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
36 targeting ARM7, the CPU core of the Calypso GSM/GPRS baseband
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
37 processor. You'll need to build and install this toolchain
143
afceeeb2cba1 Our nuc-fw is destined to become gsm-fw, so I went ahead and did the big hg mv
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 97
diff changeset
38 first before you can build gsm-fw or target-utils.