FreeCalypso > hg > fc-magnetite

comparison doc/Compiling @ 381:c6823ed06f9c

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc/Compiling: update for C11x and for the speed-up trick
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 13 Jan 2018 21:10:08 +0000
parents 9399a83cb394
children 48ae9825662c
comparison
equal deleted inserted replaced
380:36c3c910f709 381:c6823ed06f9c
63 63
64 The first argument to the configure.sh script selects the target, and the second 64 The first argument to the configure.sh script selects the target, and the second
65 argument selects the configuration. As of this writing, the following targets 65 argument selects the configuration. As of this writing, the following targets
66 are supported: 66 are supported:
67 67
68 c139 Motorola C139 68 c11x Motorola C11x/12x
69 c139 Motorola C139/140
69 fcdev3b FreeCalypso FCDEV3B 70 fcdev3b FreeCalypso FCDEV3B
70 gtamodem The Calypso GSM/GPRS modem in Openmoko GTA01/02 smartphones 71 gtamodem The Calypso GSM/GPRS modem in Openmoko GTA01/02 smartphones
71 pirelli Pirelli DP-L10 72 pirelli Pirelli DP-L10
72 73
73 For the available configurations (the second required argument to the configure 74 For the available configurations (the second required argument to the configure
79 the name of this directory by appending a BUILD_DIR=dir argument to the 80 the name of this directory by appending a BUILD_DIR=dir argument to the
80 ./configure.sh line after the two required arguments. 81 ./configure.sh line after the two required arguments.
81 82
82 To actually compile the firmware, cd into the created build directory and run 83 To actually compile the firmware, cd into the created build directory and run
83 make there. Unfortunately the use of TI's proprietary compiler via Wine makes 84 make there. Unfortunately the use of TI's proprietary compiler via Wine makes
84 the build very slow - it takes about 42 minutes on my machine for the l1reconst 85 the build quite slow, but there is a trick to speed it up: if you run some
85 configuration, or almost 90 minutes for hybrid. When it's all done, the 86 other Wine program that stays open and does not exit on its own (e.g., wine cmd)
86 flashable firmware image will be in fwimage.bin. This image is to be flashed 87 in another window and leave it open while you run your FC Magnetite fw build,
87 with fc-loadtool at address 0x10000 on the C139 and at address 0 on all other 88 the build will proceed much faster - the presence of another Wine process using
88 targets. 89 the wineserver environment will keep Wine from shutting this environment down
90 and restarting it for every individual cl470 run, i.e., for each individual C
91 source file.
92
93 When the build is done, the flashable firmware image will be in fwimage.bin.
94 This image is to be flashed with fc-loadtool at address 0x10000 on Mot C11x and
95 C139 targets, and at address 0 on the more sensible targets that have the
96 Calypso boot ROM enabled. The build system also produces a short text file
97 named flash-script which is a flashing command script for fc-loadtool that
98 erases the correct range of flash sectors and then programs fwimage.bin at the
99 right address.
89 100
90 When building firmware for the FCDEV3B or for the Pirelli, one can build either 101 When building firmware for the FCDEV3B or for the Pirelli, one can build either
91 a flashable image or a RAM-loadable one - or both. Because this part of the 102 a flashable image or a RAM-loadable one - or both. Because this part of the
92 build system is common with other targets for which only flash images can be 103 build system is common with other targets for which only flash images can be
93 produced, the Makefile always builds the flashable image by default - 104 produced, the Makefile always builds the flashable image by default -