comparison README @ 556:39a226a06196

documentation update for rebuilding the easy parts of GPF from source
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 19 Nov 2018 02:00:21 +0000
parents f9125919bbe4
children c32c887ced3a
comparison
equal deleted inserted replaced
555:6690ae453594 556:39a226a06196
152 tested by a larger number of users in real-life usage. 152 tested by a larger number of users in real-life usage.
153 153
154 Other blobs 154 Other blobs
155 =========== 155 ===========
156 156
157 The TCS2/TCS3 hybrid firmware is built almost entirely from source; the only 157 Our TCS2/TCS3 hybrid firmware is built almost entirely from source; the only
158 components which are linked in the form of prebuilt libraries are GPF, Nucleus 158 components which are linked in the form of prebuilt objects or libraries are
159 and the TMS470 compiler's equivalent of libc/libgcc. It needs to be noted that 159 certain glue components in GPF (specifically OSL and OSX), the Nucleus PLUS RTOS
160 these components are so stable and configuration-independent that they were 160 and the TMS470 compiler's equivalent of libc/libgcc. In the case of Nucleus we
161 used mostly in prebuilt library form even inside TI. In the case of GPF we've 161 have another version of it in full source form, but switching to a different
162 got the corresponding source for most of the modules within those libs; for the 162 version of Nucleus is outside the scope of FC Magnetite - see the next section.
163 few modules for which the original source has been lost (OSL and OSX), we have 163 In the case of OSL and OSX, we have a reconstructed source and one can build a
164 a reconstructed source and one can build a Magnetite config (hybrid-gpf) that 164 Magnetite config (hybrid-osl) that uses these reconstructed versions of OSL and
165 uses these reconstructed versions of OSL and OSX instead of the blobs, but we 165 OSX instead of the blobs, but we are not 100% confident in the quality of this
166 are not 100% confident in the quality of this reconstruction, hence this 166 reconstruction, hence this hybrid-osl config is currently considered
167 hybrid-gpf config is currently considered experimental, not production. In the 167 experimental, not production.
168 case of Nucleus we likewise have another version of it in full source form
169 which has been proven good in other FreeCalypso firmware projects, but it is
170 not used in Magnetite.
171 168
172 Blob-free, gcc-built version 169 Blob-free, gcc-built version
173 ============================ 170 ============================
174 171
175 For those who require or desire a firmware version that is completely free of 172 For those who require or desire a firmware version that is completely free of