94
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
1 Preparing the development and build environment
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
2 ===============================================
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
3
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
4 In order to compile our FreeCalypso Magnetite firmware, you will need a
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
5 Unix/Linux system. Even though we are using a compiler which we got in the
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
6 form of Windows .exe binaries and thus have to use Wine (see below), everything
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
7 that we have built on top of it is Unix-based. This author uses Slackware Linux
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
8 version 13.37, 32-bit.
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
9
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
10 You will need to install the following four pieces of software on whatever
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
11 machine you will use to run the FC Magnetite build process:
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
12
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
13 1. Wine: self-explanatory.
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
14
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
15 2. FreeCalypso Wine environment:
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
16
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
17 ftp://ftp.freecalypso.org/pub/GSM/TI_src/wine/installed-env.tar.xz
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
18
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
19 Extract the content of the above tarball into your ~/.wine/drive_c
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
20 directory - that's all there is to it!
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
21
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
22 3. nowhine wrapper around Wine:
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
23
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
24 ftp://ftp.freecalypso.org/pub/GSM/TI_src/wine/nowhine.c
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
25
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
26 Note that Wine may produce different whines on your system than it
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
27 does on mine, in which case if you wish to be relieved of those
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
28 whines, you'll need to edit my nowhine.c hack for your situation.
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
29
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
30 4. mokosrec2bin flash image file format conversion utility:
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
31
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
32 ftp://ftp.freecalypso.org/pub/GSM/GTA02/gsm-fw/mokosrec2bin.c
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
33
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
34 Note that the four host software pieces above are exactly the same as what has
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
35 been needed to build our previous TCS211-based fw works such as leo2moko-debug
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
36 and tcs211-c139 - thus if you have built those previously, you should already
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
37 have all of the necessary host tools.
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
38
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
39 Compiling the local helper utilities
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
40 ====================================
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
41
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
42 (cd helpers; make)
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
43
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
44 Do the above. Most of the build helper scripts used in the FC Magnetite build
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
45 system are written in Bourne shell, but a few were easier to implement in C.
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
46 You need to compile these C helper utilities before you can run an actual FC
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
47 Magnetite firmware build, but these utilities are totally ad hoc and specific
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
48 to the needs of our fw build system, hence they are not meant to be installed
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
49 globally on your system - instead they stay within the fc-magnetite tree. You
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
50 just need to run make in the helpers directory once before any actual firmware
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
51 builds.
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
52
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
53 Actually building the firmware
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
54 ==============================
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
55
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
56 In order to build our FreeCalypso Magnetite firmware for a particular target in
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
57 a particular configuration, run a command like this from the top level of the
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
58 fc-magnetite tree:
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
59
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
60 ./configure.sh gtamodem l1reconst
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
61
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
62 The first argument to the configure.sh script selects the target, and the second
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
63 argument selects the configuration. As of this writing, the following targets
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
64 are supported:
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
65
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
66 c139 Motorola C139
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
67 fcdev3b FreeCalypso FCDEV3B (hardware designed but not built yet)
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
68 gtamodem The Calypso GSM/GPRS modem in Openmoko GTA01/02 smartphones
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
69 pirelli Pirelli DP-L10
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
70
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
71 For the available configurations (the second required argument to the configure
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
72 script), look in the configs directory. As of this writing, the most
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
73 interesting configuration is l1reconst - it was named so because it rebuilds L1
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
74 from the reconstructed source.
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
75
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
76 Each configuration is built in its own directory; by default the build directory
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
77 is named build-$TARGET-$CONFIG, i.e., for the example configure.sh line above,
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
78 the resulting build directory will be build-gtamodem-l1reconst. You can change
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
79 the name of this directory by appending a BUILD_DIR=dir argument to the
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
80 ./configure.sh line after the two required arguments.
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
81
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
82 To actually compile the firmware, cd into the created build directory and run
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
83 make there. Unfortunately the use of TI's proprietary compiler via Wine makes
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
84 the build very slow - it takes about 42 minutes on my machine. When it's all
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
85 done, the flashable firmware image will be in fwimage.bin. This image is to be
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
86 flashed with fc-loadtool at address 0x10000 on the C139 and at address 0 on all
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
87 other targets.
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
88
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
89 When building firmware for the Pirelli or for future FreeCalypso hardware that
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
90 will use the same high capacity flash+pSRAM chip, one can build either a
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
91 flashable image or a RAM-loadable one - or both. Because this part of the
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
92 build system is common with other targets for which only flash images can be
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
93 produced, the Makefile always builds the flashable image by default -
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
94 fwimage.bin is always meant for flash and never for RAM. To build a RAM-
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
95 loadable image when the target allows it, run 'make ram' - the image will be in
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
96 ramimage.srec, which you can then load and run on the target with FreeCalypso
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
97 host tool fc-xram.
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
98
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
99 Running on the hardware
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
100 =======================
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
101
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
102 In order to run the firmware you have built on your Calypso phone or modem
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
103 (flash or run in RAM as appropriate), you will need to use FreeCalypso host
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
104 tools. As of this writing, the latest packaged release is this one:
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
105
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
106 ftp://ftp.freecalypso.org/pub/GSM/FreeCalypso/fc-host-tools-r4.tar.bz2
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
107
|
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
108 Please see target-specific notes for more details.
|