diff doc/Toolchain-setup-470 @ 109:a68c6c7942d7

doc: basic build documentation written
author Mychaela Falconia <falcon@freecalypso.org>
date Tue, 24 Jul 2018 23:55:24 +0000
parents
children e32860d28518
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/Toolchain-setup-470	Tue Jul 24 23:55:24 2018 +0000
@@ -0,0 +1,39 @@
+Preparing the build environment for TMS470
+==========================================
+
+In order to compile FC Selenite with TI's original TMS470 compiler, you will
+need a Unix/Linux system.  Even though the compiler itself exists in the form
+of Windows .exe binaries and thus has to be run under Wine (see below),
+everything that we have built on top of it is Unix-based.  The Mother uses
+Slackware Linux version 13.37, 32-bit.
+
+You will need to install the following four pieces of software on whatever
+machine you will use to run the FC Selenite build process:
+
+1. Wine: self-explanatory.
+
+2. FreeCalypso Wine environment:
+
+   ftp://ftp.freecalypso.org/pub/GSM/TI_src/wine/installed-env.tar.xz
+
+   Extract the content of the above tarball into your ~/.wine/drive_c
+   directory - that's all there is to it!
+
+3. nowhine wrapper around Wine:
+
+   ftp://ftp.freecalypso.org/pub/GSM/TI_src/wine/nowhine.c
+
+   Note that Wine may produce different whines on your system than it
+   does on mine, in which case if you wish to be relieved of those
+   whines, you'll need to edit my nowhine.c hack for your situation.
+   And if wine does not whine at all on your system, you can skip the
+   wrapper and create a nowhine symlink pointing directly to wine.
+
+4. mokosrec2bin flash image file format conversion utility:
+
+   ftp://ftp.freecalypso.org/pub/GSM/GTA02/gsm-fw/mokosrec2bin.c
+
+Note that the four host software pieces above are exactly the same as what has
+been needed to build our previous TCS211-based fw works such as leo2moko-debug
+and tcs211-c139 - thus if you have built those previously, you should already
+have all of the necessary host tools.