FreeCalypso > hg > freecalypso-sw
annotate README @ 907:7a189b7bbd67
lcdemu: input processing implemented, compiles
| author | Space Falcon <falcon@ivan.Harhan.ORG> | 
|---|---|
| date | Mon, 07 Sep 2015 10:35:20 +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: 
625diff
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: 
625diff
changeset | 2 ========================== | 
| 
2913c4fdd34a
top level README: describe the project at a higher level
 Michael Spacefalcon <msokolov@ivan.Harhan.ORG> parents: 
625diff
changeset | 3 | 
| 863 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
changeset | 10 two ways: | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
changeset | 11 | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
701diff
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: 
701diff
changeset | 14 libre phones; | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
changeset | 15 | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
701diff
changeset | 17 build ourselves, using the same Calypso chipset. | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
changeset | 18 | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
changeset | 19 Origin of the source | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
changeset | 20 ==================== | 
| 700 
2913c4fdd34a
top level README: describe the project at a higher level
 Michael Spacefalcon <msokolov@ivan.Harhan.ORG> parents: 
625diff
changeset | 21 | 
| 863 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
changeset | 31 devices of interest. | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
changeset | 32 | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
changeset | 33 Where we came from | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
changeset | 34 ================== | 
| 700 
2913c4fdd34a
top level README: describe the project at a higher level
 Michael Spacefalcon <msokolov@ivan.Harhan.ORG> parents: 
625diff
changeset | 35 | 
| 863 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
625diff
changeset | 41 | 
| 863 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
changeset | 48 | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
625diff
changeset | 55 | 
| 863 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
changeset | 59 | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
changeset | 64 project that took a year and a half. | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
changeset | 65 | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
changeset | 66 What we've done | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
changeset | 67 =============== | 
| 700 
2913c4fdd34a
top level README: describe the project at a higher level
 Michael Spacefalcon <msokolov@ivan.Harhan.ORG> parents: 
625diff
changeset | 68 | 
| 863 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
863diff
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: 
863diff
changeset | 71 RAM-loadable image and has the following essential features/qualities/ | 
| 
e8bdd3d0c4c2
top README: status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
863diff
changeset | 72 attributes: | 
| 863 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
changeset | 73 | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
changeset | 80 tools for LoCosto. | 
| 700 
2913c4fdd34a
top level README: describe the project at a higher level
 Michael Spacefalcon <msokolov@ivan.Harhan.ORG> parents: 
625diff
changeset | 81 | 
| 863 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
changeset | 86 has real source, we have used that TCS211 source. | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
changeset | 87 | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
701diff
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: 
701diff
changeset | 90 completely untested. | 
| 700 
2913c4fdd34a
top level README: describe the project at a higher level
 Michael Spacefalcon <msokolov@ivan.Harhan.ORG> parents: 
625diff
changeset | 91 | 
| 863 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
625diff
changeset | 96 | 
| 863 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
701diff
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: 
701diff
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: 
701diff
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: 
625diff
changeset | 101 | 
| 863 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
701diff
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: 
701diff
changeset | 104 | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
701diff
changeset | 106 | 
| 897 
e8bdd3d0c4c2
top README: status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
863diff
changeset | 107 Current status (2015-06-30) | 
| 
e8bdd3d0c4c2
top README: status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
863diff
changeset | 108 =========================== | 
| 700 
2913c4fdd34a
top level README: describe the project at a higher level
 Michael Spacefalcon <msokolov@ivan.Harhan.ORG> parents: 
625diff
changeset | 109 | 
| 897 
e8bdd3d0c4c2
top README: status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
863diff
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: 
863diff
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: 
863diff
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: 
863diff
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: 
863diff
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: 
863diff
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: 
863diff
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: 
863diff
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: 
863diff
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: 
625diff
changeset | 119 | 
| 
2913c4fdd34a
top level README: describe the project at a higher level
 Michael Spacefalcon <msokolov@ivan.Harhan.ORG> parents: 
625diff
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: 
625diff
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: 
625diff
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: 
625diff
changeset | 123 details. | 
| 
2913c4fdd34a
top level README: describe the project at a higher level
 Michael Spacefalcon <msokolov@ivan.Harhan.ORG> parents: 
625diff
changeset | 124 | 
| 
2913c4fdd34a
top level README: describe the project at a higher level
 Michael Spacefalcon <msokolov@ivan.Harhan.ORG> parents: 
625diff
changeset | 125 Source tree | 
| 
2913c4fdd34a
top level README: describe the project at a higher level
 Michael Spacefalcon <msokolov@ivan.Harhan.ORG> parents: 
625diff
changeset | 126 =========== | 
| 387 
4391890bacd9
documentation update: top level README and target-utils/README
 Michael Spacefalcon <msokolov@ivan.Harhan.ORG> parents: 
250diff
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: 
625diff
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: 
250diff
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: 
250diff
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: 
250diff
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: 
250diff
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: 
250diff
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: 
250diff
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: 
250diff
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: 
250diff
changeset | 140 loadtools for the details. | 
| 
4391890bacd9
documentation update: top level README and target-utils/README
 Michael Spacefalcon <msokolov@ivan.Harhan.ORG> parents: 
250diff
changeset | 141 miscutil | 
| 
4391890bacd9
documentation update: top level README and target-utils/README
 Michael Spacefalcon <msokolov@ivan.Harhan.ORG> parents: 
250diff
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: 
97diff
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: 
387diff
changeset | 148 | 
| 863 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
changeset | 149 Website and mailing list | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
changeset | 150 ======================== | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
changeset | 151 | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
387diff
changeset | 153 | 
| 863 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
701diff
changeset | 155 subproject; | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
changeset | 156 | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
701diff
changeset | 158 | 
| 
78c894c7c471
top README: project status update
 Space Falcon <falcon@ivan.Harhan.ORG> parents: 
701diff
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: 
701diff
changeset | 160 you can accelerate the progress of our project by funding it. | 
