FreeCalypso > hg > freecalypso-citrine
comparison ccd/README @ 0:75a11d740a02
initial import of gsm-fw from freecalypso-sw rev 1033:5ab737ac3ad7
| author | Mychaela Falconia <falcon@freecalypso.org> | 
|---|---|
| date | Thu, 09 Jun 2016 00:02:41 +0000 | 
| parents | |
| children | 
   comparison
  equal
  deleted
  inserted
  replaced
| -1:000000000000 | 0:75a11d740a02 | 
|---|---|
| 1 CCD (Condat Coder and Decoder) is yet another component needed in order to | |
| 2 produce a functional GSM/GPRS MS (mobile station) firmware image based on the | |
| 3 TI/Condat architecture. We got the C source for this component from the | |
| 4 LoCosto find. | |
| 5 | |
| 6 CCD code that went into TI's firmware builds (as opposed to TI/Condat's | |
| 7 Windows-based tools etc) has two subdivisions: | |
| 8 | |
| 9 1. The main CCD library - ccd_na7_db.lib in the case of our Leonardo reference | |
| 10 firmware. The C modules compiled into this library must be very independent, | |
| 11 as it's one of the "frozen" GPF libs - it appears that GPF was maintained by | |
| 12 a separate group inside TI, and the builders of actual GSM/GPRS firmwares | |
| 13 used that group's GPF (and CCD) binary lib deliverables as untouched blobs. | |
| 14 | |
| 15 2. The ccddata component is meant to be compiled as part of the product firmware | |
| 16 build process, in both TCS211 and LoCosto versions. Our Leonardo reference | |
| 17 version has it in a binary lib too, but it's one of those "unprivileged | |
| 18 customer" libs, and one can see from the makefiles that it was meant to be | |
| 19 compiled the same way as L1 and L23 etc. The LoCosto version came with the | |
| 20 full source for all of CCD, but the build system is set up to only compile | |
| 21 ccddata, whereas the rest of CCD is used in the form of an imported GPF | |
| 22 binary lib, just like GPF proper, just like in TCS211. | |
| 23 | |
| 24 It appears, however, that the C source for both above-listed parts of CCD has | |
| 25 always been maintained in a single directory, and that is how it appears in the | |
| 26 LoCosto find. | |
| 27 | |
| 28 The true reason for the subdivision became apparent when we went through the | |
| 29 process of integrating CCD into FreeCalypso. The C modules that comprise | |
| 30 ccddata include cdginc headers (see ../cdg/README to learn what a nightmare | |
| 31 that is), require these headers to be present in order to pass compilation, and | |
| 32 depend on any changes in these headers, whereas the "base" part of CCD (the one | |
| 33 that was maintained as a GPF stable lib inside TI) has no dependency on cdginc. | |
| 34 | |
| 35 For our use in FreeCalypso we shall compile all of CCD (both subdivisions) into | |
| 36 a single library in this directory - in this project we always compile | |
| 37 everything from source anyway, so we may as well simplify the build process in | |
| 38 this regard. | 
