annotate README @ 660:a0014ba30d71

gsm-fw/cdg/makecdg.sh: added some comments
author Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
date Fri, 26 Sep 2014 00:34:44 +0000
parents 29dae53ad969
children 2913c4fdd34a
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
625
29dae53ad969 top level README: status update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 529
diff changeset
17 Integrated and working so far:
29dae53ad969 top level README: status update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 529
diff changeset
18 * Layer 1 (gtamodem target only): builds and runs, lightly
29dae53ad969 top level README: status update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 529
diff changeset
19 tested, need the rest of the GSM protocol stack for real
29dae53ad969 top level README: status update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 529
diff changeset
20 testing.
29dae53ad969 top level README: status update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 529
diff changeset
21 * RTOS foundation (all targets): one can exercise RVT, ETM, FFS
29dae53ad969 top level README: status update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 529
diff changeset
22 and GPF; all work beautifully.
29dae53ad969 top level README: status update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 529
diff changeset
23
29dae53ad969 top level README: status update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 529
diff changeset
24 Next steps:
29dae53ad969 top level README: status update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 529
diff changeset
25 * Integrate Layers 2&3 (Condat G23);
29dae53ad969 top level README: status update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 529
diff changeset
26 * Rework the tpudrv part of L1 to work on targets other than
29dae53ad969 top level README: status update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 529
diff changeset
27 gtamodem, i.e., Pirelli DP-L10 and Mot C1xx.
97
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
28
387
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
29 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
30 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
31 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
32 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
33 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
34 loadtools (see README.hosttools) to do their job.
97
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
35
387
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
36 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
37 loadtools for the details.
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
38 miscutil
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
39 rvinterf
97
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
40
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
41 toolchain Scripts and patches for building the gcc+binutils toolchain
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
42 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
43 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
44 first before you can build gsm-fw or target-utils.
484
c617a6adcb69 top level README: status update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 387
diff changeset
45
c617a6adcb69 top level README: status update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 387
diff changeset
46 If you like this project and would like to see it continue to fruition, please
c617a6adcb69 top level README: status update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 387
diff changeset
47 consider making a Bitcoin donation to the human family behind it:
c617a6adcb69 top level README: status update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 387
diff changeset
48
c617a6adcb69 top level README: status update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 387
diff changeset
49 https://blockchain.info/address/159Yx6JRJ4oMLPTYrh1jW7fQ5D5tPHdnoM