comparison doc/Blob-status @ 50:a62e5bf88434

first round of documentation
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 18 Oct 2020 18:08:15 +0000
parents
children
comparison
equal deleted inserted replaced
49:4e178a0e90f6 50:a62e5bf88434
1 State of blobs in FreeCalypso firmware
2 ======================================
3
4 FC Tourmaline is almost completely deblobbed. Only the following very small
5 components exist in the form of blobs (prebuilt binary objects for which we
6 have no exact corresponding source) in the standard Tourmaline build:
7
8 * OSL and OSX glue components of GPF: 14992 bytes of code
9 * TMS470 compiler's RTS library (libc/libgcc equivalent): 13152 bytes of code
10
11 For OSL and OSX we do have reconstructed C code written based on disassembly of
12 the blobs, but I (Mother Mychaela) do not consider the current state of this C
13 reconstruction to be fit for production use - hence standard Tourmaline fw
14 builds use blob versions of these components. However, our configuration and
15 build system gives you the freedom to select which version of each component
16 you would rather use; the selection is made with Bourne shell config variables
17 on the configure.sh invokation line:
18
19 OSL=0 use the blob version of OSL
20 OSL=1 use the reconstructed C version of OSL
21 OSX=0 use the blob version of OSX
22 OSX=1 use the reconstructed C version of OSX
23
24 The current default is OSL=0 and OSX=0.
25
26 RTS library
27 ===========
28
29 We do have source code for some versions of the TMS470 compiler's RTS library,
30 but they may not be exactly corresponding to the blob version from TCS211 which
31 we are using. This area is deemed to be such a low priority that no real
32 investigation has been done yet.