fc-magnetite: doc/Compiling annotate

annotate doc/Compiling @ 671:5f00e9afd5d9

removing clutter: INIT_blob provision The lost init.c source was reconstructed from init.obj in 2017; prior to that reconstruction we were compiling main.lib from partial source: using the init module in blob form with various binary patches, but recompiling create_RVtasks.c from source so we could change RiViera SWE configuration. We've been using the fully reconstructed version of init.c since 2017, and now the old INIT_blob provision (which is not used by any config) is just extra noise in our targets/*.conf files. This commit removes all bits related to this provision, reducing clutter and making it easier to add new targets.

author	Mychaela Falconia <falcon@freecalypso.org>
date	Fri, 29 May 2020 02:36:39 +0000
parents	4c07bb438030
children	5806383e2788

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.

FreeCalypso > hg > fc-magnetite

annotate doc/Compiling @ 671:5f00e9afd5d9