FreeCalypso > hg > freecalypso-sw
annotate README @ 948:c73516dd50bb
c139explore: delay before greeting printf to work around defect in fc-compalram
author | Mychaela Falconia <falcon@ivan.Harhan.ORG> |
---|---|
date | Mon, 02 Nov 2015 22:11:06 +0000 |
parents | e8bdd3d0c4c2 |
children | 36e3f6bf0156 |
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. |