annotate doc/Toolchain-setup-470 @ 192:4f40ae165be4

abb.c & init.c: sync with Magnetite for Luna additions These Luna target-specific additions are conditionalized on CONFIG_TARGET_LUNA, a C preprocessor symbol that will never be defined in Selenite, hence this change has exactly zero impact on FC Selenite. However, they are being pulled in as a sync in order to keep the diff between Magnetite and Selenite to a minimum; keeping this diff to a minimum increases our opportunities for possible evolution of future FC firmwares.
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 23 May 2020 07:03:46 +0000
parents e32860d28518
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
109
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 Preparing the build environment for TMS470
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 ==========================================
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 In order to compile FC Selenite with TI's original TMS470 compiler, you will
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 need a Unix/Linux system. Even though the compiler itself exists in the form
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 of Windows .exe binaries and thus has to be run under Wine (see below),
125
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
7 everything that we have built on top of it is Unix-based. The Mother currently
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
8 uses Slackware Linux release 14.2 (32-bit) and previously used Slackware 13.37,
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
9 also 32-bit.
109
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10
125
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
11 You will need to install the following 3 pieces of software on whatever
109
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 machine you will use to run the FC Selenite build process:
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13
125
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
14 1. Wine: self-explanatory. The Mother uses the following Slackware package:
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
15
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
16 https://www.freecalypso.org/members/falcon/slackware/wine-1.5.23-i486-1sg.txz
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
17
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
18 I originally used it with Slackware 13.37 and I am still able to use it
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
19 with 14.2 without any issues.
109
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 2. FreeCalypso Wine environment:
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 ftp://ftp.freecalypso.org/pub/GSM/TI_src/wine/installed-env.tar.xz
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 Extract the content of the above tarball into your ~/.wine/drive_c
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26 directory - that's all there is to it!
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28 3. nowhine wrapper around Wine:
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30 ftp://ftp.freecalypso.org/pub/GSM/TI_src/wine/nowhine.c
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31
125
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
32 The purpose of this wrapper is to suppress the following obnoxious whine
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
33 which wine emits on my system:
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
34
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
35 preloader: Warning: failed to reserve range 00010000-00110000
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
36
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
37 Wine will also emits a bunch of other whines if you have to run it
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
38 in an environment without an X11 display (e.g., on a machine that you
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
39 ssh into), and our nowhine wrapper suppresses those as well.
109
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
40
125
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
41 If wine does not emit those preloader whines on your system and you
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
42 never find yourself in a situation of having to run without an X11
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
43 display and thus you find our nowhine wrapper to be unnecessary,
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
44 you can skip the wrapper and create a nowhine symlink pointing directly
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
45 to wine.
109
a68c6c7942d7 doc: basic build documentation written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
46
125
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
47 The mokosrec2bin flash image file format conversion utility is now included
e32860d28518 doc/Toolchain-setup-470: same updates as in Magnetite
Mychaela Falconia <falcon@freecalypso.org>
parents: 109
diff changeset
48 locally and no longer needs to be provided externally.