FreeCalypso > hg > fc-magnetite

annotate doc/Compiling @ 661:ba45f6514fb1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
FFS: fixed bug in the case of journal_init() creating the journal on boot
author Mychaela Falconia <falcon@freecalypso.org>
date Wed, 20 May 2020 22:54:29 +0000
parents 4c07bb438030
children 5806383e2788
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 Preparing the development and build environment
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 ===============================================
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 In order to compile our FreeCalypso Magnetite firmware, you will need a
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 Unix/Linux system. Even though we are using a compiler which we got in the
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 form of Windows .exe binaries and thus have to use Wine (see below), everything
531
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
7 that we have built on top of it is Unix-based. The Mother currently uses
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
8 Slackware Linux release 14.2 (32-bit) and previously used Slackware 13.37,
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
9 also 32-bit.
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10
531
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
11 You will need to install the following 3 pieces of software on whatever
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 machine you will use to run the FC Magnetite build process:
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13
531
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
14 1. Wine: self-explanatory. The Mother uses the following Slackware package:
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
15
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
16 https://www.freecalypso.org/members/falcon/slackware/wine-1.5.23-i486-1sg.txz
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
17
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
18 I originally used it with Slackware 13.37 and I am still able to use it
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
19 with 14.2 without any issues.
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 2. FreeCalypso Wine environment:
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 ftp://ftp.freecalypso.org/pub/GSM/TI_src/wine/installed-env.tar.xz
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 Extract the content of the above tarball into your ~/.wine/drive_c
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26 directory - that's all there is to it!
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28 3. nowhine wrapper around Wine:
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30 ftp://ftp.freecalypso.org/pub/GSM/TI_src/wine/nowhine.c
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31
531
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
32 The purpose of this wrapper is to suppress the following obnoxious whine
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
33 which wine emits on my system:
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
34
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
35 preloader: Warning: failed to reserve range 00010000-00110000
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
36
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
37 Wine will also emits a bunch of other whines if you have to run it
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
38 in an environment without an X11 display (e.g., on a machine that you
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
39 ssh into), and our nowhine wrapper suppresses those as well.
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
40
531
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
41 If wine does not emit those preloader whines on your system and you
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
42 never find yourself in a situation of having to run without an X11
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
43 display and thus you find our nowhine wrapper to be unnecessary,
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
44 you can skip the wrapper and create a nowhine symlink pointing directly
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
45 to wine.
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
46
531
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
47 The mokosrec2bin flash image file format conversion utility is now included
6917ea63bffa doc/Compiling: Slackware, Wine and mokosrec2bin updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 522
diff changeset
48 locally and no longer needs to be provided externally.
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
49
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
50 Compiling the local helper utilities
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
51 ====================================
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
52
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
53 (cd helpers; make)
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
54
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
55 Do the above. Most of the build helper scripts used in the FC Magnetite build
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
56 system are written in Bourne shell, but a few were easier to implement in C.
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
57 You need to compile these C helper utilities before you can run an actual FC
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
58 Magnetite firmware build, but these utilities are totally ad hoc and specific
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
59 to the needs of our fw build system, hence they are not meant to be installed
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
60 globally on your system - instead they stay within the fc-magnetite tree. You
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
61 just need to run make in the helpers directory once before any actual firmware
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
62 builds.
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
63
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
64 Actually building the firmware
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
65 ==============================
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
66
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
67 In order to build our FreeCalypso Magnetite firmware for a particular target in
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
68 a particular configuration, run a command like this from the top level of the
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
69 fc-magnetite tree:
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
70
522
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
71 ./configure.sh fcdev3b hybrid
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
72
522
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
73 The first required argument to the configure.sh script selects the target, the
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
74 second required argument selects the build configuration recipe, and any further
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
75 arguments beyond these two (optional) allow changing various configurable
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
76 settings that aren't strictly fixed by the hardware target or by the build
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
77 configuration recipe.
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
78
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
79 As of this writing, the following hardware targets are supported:
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
80
381
c6823ed06f9c doc/Compiling: update for C11x and for the speed-up trick
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
81 c11x Motorola C11x/12x
c6823ed06f9c doc/Compiling: update for C11x and for the speed-up trick
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
82 c139 Motorola C139/140
540
f551ffdfe938 doc/Compiling: update for c155 target support and fc-host-tools-r9
Mychaela Falconia <falcon@freecalypso.org>
parents: 531
diff changeset
83 c155 Motorola C155/156
461
69da44f2909e doc/Compiling: mention that the dsample target is currently D-Sample C05
Mychaela Falconia <falcon@freecalypso.org>
parents: 458
diff changeset
84 dsample TI's D-Sample C05 board (no working radio currently)
251
6c594ce434f8 doc/Compiling: update for the FCDEV3B and for fc-host-tools-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 220
diff changeset
85 fcdev3b FreeCalypso FCDEV3B
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
86 gtamodem The Calypso GSM/GPRS modem in Openmoko GTA01/02 smartphones
644
9bc993985bdc doc/Compiling: update for gtm900mgc target
Mychaela Falconia <falcon@freecalypso.org>
parents: 641
diff changeset
87 gtm900mgc Huawei GTM900, hardware variant MGC1GSMT or MGC2GSMT
593
d25f6e216566 doc/Compiling: update for SE J100 target and fc-host-tools-r10
Mychaela Falconia <falcon@freecalypso.org>
parents: 544
diff changeset
88 j100 Sony Ericsson J100
626
41238a8e140c Leonardo target documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 615
diff changeset
89 leonardo TI Leonardo boards
659
4c07bb438030 doc/Compiling: luna target added
Mychaela Falconia <falcon@freecalypso.org>
parents: 644
diff changeset
90 luna FreeCalypso Luna (handset UI development platform)
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
91 pirelli Pirelli DP-L10
633
f760e858098b doc/Compiling: tangomdm target added
Mychaela Falconia <falcon@freecalypso.org>
parents: 626
diff changeset
92 tangomdm Tango modem with MCSI
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
93
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
94 For the available configurations (the second required argument to the configure
373
9399a83cb394 first round of documentation updates for 2018
Mychaela Falconia <falcon@freecalypso.org>
parents: 311
diff changeset
95 script), look in the configs directory and read the various write-ups under doc.
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
96
522
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
97 Each configuration is built in its own directory; the name of this build
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
98 directory takes the form of build-$TARGET-$CONFIG$SUFFIX, i.e., for the example
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
99 configure.sh line above, the resulting build directory will be named
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
100 build-fcdev3b-hybrid. The $SUFFIX part is empty by default, but can be set on
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
101 the command line in order to distinguish non-standard builds that had some
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
102 tunable settings changed to values other than the default. For example, if you
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
103 are building the hybrid configuration for the fcdev3b target as above, but you
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
104 need to disable MELODY_E2, you could run the configure script as follows:
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
105
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
106 ./configure.sh fcdev3b hybrid MELODY_E2=0 SUFFIX=-noe2
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
107
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
108 The build directory would then become build-fcdev3b-hybrid-noe2, and the
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
109 specified suffix will also be included in the firmware version ID string that
9363ea39c74c configure.sh: implemented SUFFIX= setting, replacing raw BUILD_DIR=
Mychaela Falconia <falcon@freecalypso.org>
parents: 461
diff changeset
110 gets compiled into the image.
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
111
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
112 To actually compile the firmware, cd into the created build directory and run
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
113 make there. Unfortunately the use of TI's proprietary compiler via Wine makes
381
c6823ed06f9c doc/Compiling: update for C11x and for the speed-up trick
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
114 the build quite slow, but there is a trick to speed it up: if you run some
c6823ed06f9c doc/Compiling: update for C11x and for the speed-up trick
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
115 other Wine program that stays open and does not exit on its own (e.g., wine cmd)
c6823ed06f9c doc/Compiling: update for C11x and for the speed-up trick
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
116 in another window and leave it open while you run your FC Magnetite fw build,
c6823ed06f9c doc/Compiling: update for C11x and for the speed-up trick
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
117 the build will proceed much faster - the presence of another Wine process using
c6823ed06f9c doc/Compiling: update for C11x and for the speed-up trick
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
118 the wineserver environment will keep Wine from shutting this environment down
c6823ed06f9c doc/Compiling: update for C11x and for the speed-up trick
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
119 and restarting it for every individual cl470 run, i.e., for each individual C
c6823ed06f9c doc/Compiling: update for C11x and for the speed-up trick
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
120 source file.
c6823ed06f9c doc/Compiling: update for C11x and for the speed-up trick
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
121
c6823ed06f9c doc/Compiling: update for C11x and for the speed-up trick
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
122 When the build is done, the flashable firmware image will be in fwimage.bin.
540
f551ffdfe938 doc/Compiling: update for c155 target support and fc-host-tools-r9
Mychaela Falconia <falcon@freecalypso.org>
parents: 531
diff changeset
123 This image is to be flashed with fc-loadtool at a target-dependent base address.
f551ffdfe938 doc/Compiling: update for c155 target support and fc-host-tools-r9
Mychaela Falconia <falcon@freecalypso.org>
parents: 531
diff changeset
124 The build system also produces a short text file named flash-script which is a
f551ffdfe938 doc/Compiling: update for c155 target support and fc-host-tools-r9
Mychaela Falconia <falcon@freecalypso.org>
parents: 531
diff changeset
125 flashing command script for fc-loadtool that erases the correct range of flash
f551ffdfe938 doc/Compiling: update for c155 target support and fc-host-tools-r9
Mychaela Falconia <falcon@freecalypso.org>
parents: 531
diff changeset
126 sectors and then programs fwimage.bin at the right address.
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
127
251
6c594ce434f8 doc/Compiling: update for the FCDEV3B and for fc-host-tools-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 220
diff changeset
128 When building firmware for the FCDEV3B or for the Pirelli, one can build either
6c594ce434f8 doc/Compiling: update for the FCDEV3B and for fc-host-tools-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 220
diff changeset
129 a flashable image or a RAM-loadable one - or both. Because this part of the
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
130 build system is common with other targets for which only flash images can be
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
131 produced, the Makefile always builds the flashable image by default -
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
132 fwimage.bin is always meant for flash and never for RAM. To build a RAM-
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
133 loadable image when the target allows it, run 'make ram' - the image will be in
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
134 ramimage.srec, which you can then load and run on the target with FreeCalypso
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
135 host tool fc-xram.
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
136
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
137 Running on the hardware
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
138 =======================
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
139
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
140 In order to run the firmware you have built on your Calypso phone or modem
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
141 (flash or run in RAM as appropriate), you will need to use FreeCalypso host
615
2bd7c1dcac4b doc/Compiling: fc-host-tools-latest symlink
Mychaela Falconia <falcon@freecalypso.org>
parents: 611
diff changeset
142 tools. The current version at any given moment can be found at this URL:
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
143
615
2bd7c1dcac4b doc/Compiling: fc-host-tools-latest symlink
Mychaela Falconia <falcon@freecalypso.org>
parents: 611
diff changeset
144 ftp://ftp.freecalypso.org/pub/GSM/FreeCalypso/fc-host-tools-latest.tar.bz2
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
145
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
146 Please see target-specific notes for more details.