annotate README @ 960:120148429b9f

Makefile.hosttools: lcdemu added
author Mychaela Falconia <falcon@ivan.Harhan.ORG>
date Fri, 06 Nov 2015 17:42:00 +0000
parents e8bdd3d0c4c2
children 36e3f6bf0156
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
700
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
1 What this project is about
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
2 ==========================
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
3
863
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
4 You are looking at the software/firmware subproject of FreeCalypso. The goal
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
5 of this subproject is to produce a fully functional firmware version for the
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
6 Calypso GSM baseband chipset from Texas Instruments that is fully controlled
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
7 by We the People (recompilation with a free compiler from full source code
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
8 which is freely published and maintained by us, as opposed to a frozen
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
9 impenetrable binary blob from some long-defunct vendor) and which we can use in
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
10 two ways:
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
11
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
12 a) replace the original proprietary firmware of certain pre-existing phone
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
13 models based on this chipset, thereby turning these historical devices into
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
14 libre phones;
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
15
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
16 b) use as the official firmware for new phones and modems which we design and
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
17 build ourselves, using the same Calypso chipset.
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
18
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
19 Origin of the source
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
20 ====================
700
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
21
863
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
22 We are *not* attempting to reimplement a fully functional and practically
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
23 usable GSM protocol stack from scratch in this project - such a task would be
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
24 far beyond the capabilities of our very small and woefully underfunded team,
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
25 and in the opinion of project leader Space Falcon, such a from-scratch
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
26 reimplementation would be an egregious and morally impermissible waste of human
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
27 talent. Instead, we are using the L1 and G23M protocol stack code for TI's
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
28 LoCosto chipset that was included in the chipset.zip public release made by the
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
29 CEO of Peek, Inc. (the Peek mobile email device company) as that company went
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
30 under, and porting it from the LoCosto-based Peek platform to our Calypso target
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
31 devices of interest.
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
32
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
33 Where we came from
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
34 ==================
700
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
35
863
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
36 Just because we are reusing most components from TI's original firmware releases
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
37 does not mean that our project is trivial or devoid of our own original work.
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
38 When we started the GSM firmware subproject in the fall of 2013 (that was when
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
39 we obtained the last missing piece of required starting source material), the
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
40 available TI firmware sources consisted of:
700
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
41
863
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
42 * A TCS211 semi-src deliverable that could be compiled into a working fw image
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
43 for the GSM modem in the Neo Freerunner. While this version includes
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
44 recompilable source for most of the supporting components, the actual GSM
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
45 protocol stack is 100% linkable binary libraries sans source. These binary
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
46 object components necessitate the use of TI's proprietary compiler tools to
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
47 rebuild the fw. The build environment is set up for Windows only.
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
48
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
49 * The source from Peek (TCS3.2_N5.24_M18_V1.11_M23BTH_PSL1_src.zip) for TI's
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
50 I-Sample board with the LoCosto chipset. Mostly real source (about 95%), but
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
51 still has a few required components which exist only as linkable binary
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
52 libraries sans source. The use of TI's proprietary compiler tools is still
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
53 required for the same reason, and the build environment is set up to use a
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
54 bunch of other Windows-only tools.
700
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
55
863
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
56 * The Peek Linux project (svn.peeklinux.com) replaced the Windows-based build
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
57 system with a Linux-based one, but the binary-only libraries are still there,
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
58 hence the compiler toolchain is still the same proprietary one from TI.
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
59
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
60 The above sorry state of affairs (absolute dependency on binary object code
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
61 sans source, on proprietary compiler toolchains and on Windows) was very far
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
62 from what we sought to accomplish (compilation from full source with gcc under
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
63 GNU/Linux or other free Unix), hence we set out on a firmware reintegration
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
64 project that took a year and a half.
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
65
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
66 What we've done
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
67 ===============
700
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
68
863
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
69 By a process of painstaking reintegration piece by piece, we have put together
897
e8bdd3d0c4c2 top README: status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 863
diff changeset
70 our own firmware suite for the Calypso that builds into a flashable or
e8bdd3d0c4c2 top README: status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 863
diff changeset
71 RAM-loadable image and has the following essential features/qualities/
e8bdd3d0c4c2 top README: status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 863
diff changeset
72 attributes:
863
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
73
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
74 * Targets Calypso rather than LoCosto. This decision is somewhat controversial,
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
75 i.e., one could make a valid argument that we should have gone with LoCosto
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
76 instead. But in our defense, we already have several pre-existing devices
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
77 with the Calypso chipset on which we would like to run libre firmware; as for
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
78 LoCosto, we don't have a hardware platform to use as a bring-up vehicle, and
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
79 when we started the project, we were missing a copy of some of TI's Windows
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
80 tools for LoCosto.
700
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
81
863
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
82 * The overall architecture of our firmware (what components are included) mimics
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
83 that of TCS211 (TI's official fw for Calypso platforms for which we only have
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
84 a semi-src): e.g., we use real RiViera rather than RV emulation atop GPF.
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
85 In the case of RiViera, FFS and other components for which our copy of TCS211
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
86 has real source, we have used that TCS211 source.
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
87
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
88 * L1 and all of G23M (including ACI, CCD and AIM/SAP definitions) are the
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
89 version from the LoCosto source - which has an unfortunate quality of being
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
90 completely untested.
700
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
91
863
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
92 * Configured for a feature set matching TCS211, i.e., most of the newer features
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
93 appearing in TCS3.2 are *not* enabled. The GSM protocol stack is also
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
94 configured for the minimal voice+SMS feature set, i.e., CSD, fax and GPRS
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
95 haven't been integrated or enabled yet.
700
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
96
863
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
97 * Everything builds from full source with gcc, i.e., *nothing* is used in the
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
98 form of a precompiled binary object or library. Some parts of GPF, L1 and
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
99 system initialization code had to be reconstructed from disassembly of TCS211
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
100 binary objects, as no original or suitable substitute source could be found.
700
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
101
863
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
102 * The version of Nucleus we use comes from a non-TI source; all TI GSM fw
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
103 sources we found have their Nucleus in binary-only libs.
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
104
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
105 * To reiterate: our compiler is gcc, *not* TI's proprietary TMS470!
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
106
897
e8bdd3d0c4c2 top README: status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 863
diff changeset
107 Current status (2015-06-30)
e8bdd3d0c4c2 top README: status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 863
diff changeset
108 ===========================
700
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
109
897
e8bdd3d0c4c2 top README: status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 863
diff changeset
110 Our current firmware can be built for two targets: Openmoko's Calypso modem
e8bdd3d0c4c2 top README: status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 863
diff changeset
111 built into their GTA01 and GTA02 smartphones (target gtamodem) and the Pirelli
e8bdd3d0c4c2 top README: status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 863
diff changeset
112 DP-L10 feature phone. The functionality is the same on both targets: a modem
e8bdd3d0c4c2 top README: status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 863
diff changeset
113 or pseudo-modem controlled by AT commands (no local UI on the Pirelli), and
e8bdd3d0c4c2 top README: status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 863
diff changeset
114 only the voice+SMS subset, i.e., no CSD, fax or GPRS yet. The firmware is able
e8bdd3d0c4c2 top README: status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 863
diff changeset
115 to register successfully to a live commercial GSM network (using a legitimate
e8bdd3d0c4c2 top README: status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 863
diff changeset
116 SIM of course), and SMS sending and receiving both work; all SIM interface
e8bdd3d0c4c2 top README: status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 863
diff changeset
117 functions also work as far as we've tested them. But voice calls don't work
e8bdd3d0c4c2 top README: status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 863
diff changeset
118 yet; making them work is our next task.
700
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
119
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
120 We have also produced some host tools for loading firmware into Calypso GSM
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
121 devices, for communicating with running firmwares over the RVTMUX interface,
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
122 and for manipulating TI's flash file system. See README.hosttools for the
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
123 details.
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
124
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
125 Source tree
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
126 ===========
387
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
127
97
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
128 The subtrees of this source tree are as follows:
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
129
700
2913c4fdd34a top level README: describe the project at a higher level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 625
diff changeset
130 gsm-fw The main FreeCalypso GSM firmware work, see above.
97
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
131
387
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
132 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
133 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
134 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
135 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
136 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
137 loadtools (see README.hosttools) to do their job.
97
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
138
387
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
139 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
140 loadtools for the details.
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
141 miscutil
4391890bacd9 documentation update: top level README and target-utils/README
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 250
diff changeset
142 rvinterf
97
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
143
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
144 toolchain Scripts and patches for building the gcc+binutils toolchain
a2e793f6b8c4 some README files added
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
145 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
146 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
147 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
148
863
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
149 Website and mailing list
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
150 ========================
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
151
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
152 Please see our website at www.freecalypso.org for information on:
484
c617a6adcb69 top level README: status update
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 387
diff changeset
153
863
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
154 * The overall FreeCalypso libre phone project, beyond this specific sw/fw
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
155 subproject;
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
156
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
157 * Our community mailing list and how you can subscribe to it;
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
158
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
159 * How you can help the human family behind the project with donations and how
78c894c7c471 top README: project status update
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 701
diff changeset
160 you can accelerate the progress of our project by funding it.