annotate doc/C139-Howto @ 185:6bb7fff75901

cci_ir.lib compiles
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 13 Oct 2016 04:56:06 +0000
parents 48792a467305
children e2dce971aec9
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
95
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
1 Running FreeCalypso firmware on the Motorola C139
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
2 =================================================
94
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 Mot C139 phones are brickable - because the Calypso boot ROM is disabled by PCB
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 wiring, the ability to reflash a phone with new firmware critically depends on
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 there being a particular kind of boot code in flash sector 0 at all times - a
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7 particular kind of boot code that allows the boot process to be interrupted and
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 diverted to external code loaded via the headset jack serial port.
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 The FreeCalypso project has adopted one specific version of the flash sector 0
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 boot code (produced by applying a binary patch to one of Compal/Motorola's
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 original versions) for use with all of our firmwares for this target. No matter
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 which FreeCalypso firmware you are running - Citrine, Magnetite or tcs211-c139 -
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14 you flash your FC fw image at offset 0x10000 while keeping this boilerplate boot
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15 code at the beginning of the flash:
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 ftp://ftp.freecalypso.org/pub/GSM/FreeCalypso/compal-flash-boot-for-fc.bin
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19 Because neither FC Citrine nor FC Magnetite implements any phone UI or puts
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20 anything at all on the LCD, when a C139 phone is flashed with one of our
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 firmwares, it will behave very oddly:
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 * Whenever the phone is off but the battery is inserted, even a momentary
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24 accidental press of the power button will launch a full power-on and firmware
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 boot - without any visible indication whatsoever as the LCD stays dark!
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27 * Once the firmware has booted from a press of the power button - even a
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28 momentary accidental press - there is no way to make it shut down and power
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29 off except by sending a power-off command via the headset jack serial port.
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30 So it will just keep running until the battery runs down, once again with the
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31 LCD dark and no visible indication of any kind that it's on.
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33 Additional considerations are:
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
35 * Flashing a given phone back and forth between FreeCalypso and Mot/Compal's
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
36 official firmware is a royal pita, so if you are going to play with
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
37 FreeCalypso on a C139, it would be the easiest to dedicate a phone
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
38 specifically for FC experiments;
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
39
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
40 * We haven't got firmware-controlled battery charging working yet, so you will
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
41 need another phone running one of the official fw versions to charge
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
42 batteries.
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
43
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
44 Converting a phone to FreeCalypso
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
45 =================================
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
46
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
47 Start by installing FreeCalypso host tools on your PC/laptop or whatever host
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
48 you will use to talk to C139 phones, if you haven't already. If you are
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
49 starting with an unhacked C139 phone running one of the official firmware
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
50 versions, the procedure for flashing and bringing up FreeCalypso for the first
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
51 time is as follows:
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 * Note down your phone's factory IMEI. After you get FreeCalypso firmware
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
54 flashed and running, you will need to set your own IMEISV, as our fw doesn't
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
55 know how to grok Mot/Compal's flash data structures where they store theirs.
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
56 You can set whatever IMEISV you like, but if you would like to keep the
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
57 factory one, it would be the easiest to have it noted down on a piece of
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
58 paper. If you have a labelmaker, you can print a sticky label with the IMEI
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
59 and stick it on the side of the phone where you can easily see it later while
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
60 playing with FreeCalypso.
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
61
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
62 * Get in with fc-loadtool, preceded with tfc139 if necessary - see FC host tools
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
63 documentation.
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
64
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
65 * Once you are in with fc-loadtool, i.e., at the loadtool> prompt, reflash the
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
66 boot sector with the FreeCalypso version:
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
67
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
68 loadtool> flash erase-program-boot compal-flash-boot-for-fc.bin
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
69
95
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
70 * Flash whichever FreeCalypso firmware image you would like to play with, e.g.:
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
71
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
72 loadtool> flash erase 0x10000 0x230000
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
73 loadtool> flash program-bin 0x10000 fwimage.bin
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
74
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
75 * Erase the flash sectors to be used for the FFS (flash file system) by
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
76 FreeCalypso firmwares:
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
77
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
78 loadtool> flash erase 0x3C0000 0x30000
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
79
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
80 * Exiting fc-loadtool cleanly will cause it to power off the phone:
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
81
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
82 loadtool> exit
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
83
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
84 Reflashing between different FreeCalypso firmwares
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
85 ==================================================
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
86
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
87 By the conventions established in the FreeCalypso project, all of our firmwares
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
88 for the C139 target have the following in common:
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
89
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
90 * They all stay out of the boot sector and expect to receive control from the
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
91 boot code in the same manner (boot entry point at 0x10058, exception vectors
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
92 at 0x10000), thus there is no need to reflash the dangerous boot sector when
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
93 going from one FC firmware to another.
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
95 * They all use the same aftermarket FFS configuration of 3 sectors of 64 KiB
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
96 each (64x3) at 0x3C0000. This FFS location is deliberately different from
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
97 the one used by Mot/Compal's firmwares, eliminating the possibility of one fw
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
98 trying to use the FFS created by the other, and by putting our FFS toward the
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
99 end of the flash we maximize the amount of flash space available for our
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
100 firmware code images. But even though we don't share our FFS with
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
101 Mot/Compal's official firmwares, we do share the same FFS between all of
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
102 FreeCalypso firmware projects - thus once you have initialized your FFS (see
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
103 below) with one FC firmware version, it will work with the others as well.
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
104
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
105 If you need to reflash your C139 from one FC firmware version to another,
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
106 simply get in with fc-loadtool -h compal (no more need for the inefficient
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
107 -c 1003 or -c 1004 options or for tfc139) and reflash just the fw image part:
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
108
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
109 loadtool> flash erase 0x10000 0x230000
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
110 loadtool> flash program-bin 0x10000 fwimage.bin
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 First boot of the firmware
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
113 ==========================
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
114
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
115 Connect the serial cable, but instead of running fc-loadtool, run rvinterf.
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
116 Press the red power button on the phone briefly just like you would for
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
117 fc-loadtool entry. Because there is no fc-loadtool running on the host end of
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
118 the serial cable, the boot path will *not* be diverted in the bootloader, and
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
119 the main fw image will run - and this time it will be the FreeCalypso firmware
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
120 you have compiled and flashed. The phone's LCD will remain dark as there is no
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
121 LCD driver code in this firmware, but you will see trace output in the rvinterf
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
122 window, telling you that the fw is running.
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
123
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
124 Before you do anything else, you will need to run fc-fsio and initialize the
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
125 aftermarket FFS for our firmware:
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
126
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
127 fsio> format /
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
128 fsio> mk-std-dirs
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
129 fsio> set-imeisv fc XXXXXXXX-YYYYYY-ZZ (punctuation optional, place anywhere)
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
130 fsio> set-rfcap dual-eu (if you have 900+1800 MHz hardware)
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
131 or
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
132 fsio> set-rfcap dual-us (if you have 850+1900 MHz hardware)
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
133
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
134 After you've initialized your FFS as above, you can exit fc-fsio, run fc-shell
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
135 and try some AT commands:
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 AT+CMEE=2 -- enable verbose error responses
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
138 AT+CFUN=1 -- enable radio and SIM interfaces
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
139 AT+COPS=0 -- register to the default GSM network
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
140
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
141 When you are done, you can power the phone off by sending a 'poweroff' command
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
142 through fc-shell. The only other way is to yank the battery, and doing the
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
143 latter is recommended anyway: when a phone with the present hack-firmware
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
144 flashed into it is powered off but still has the battery inserted, even a
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
145 momentary accidental press of the power button will cause it to power on and
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
146 boot, but there will be absolutely no visual indication, as the LCD stays dark.
95
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
147
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
148 Magnetite-specific notes
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
149 ========================
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
150
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
151 Just like FC Citrine, FC Magnetite currently supports only AT command operation
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
152 via fc-shell; the C-Sample UI hack we have built earlier in tcs211-c139 has NOT
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
153 been incorporated into Magnetite - at least not yet.
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
154
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
155 When compiling our Magnetite firmware for the C139 target, you will need to
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
156 select the l1reconst configuration - it is the only currently available
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
157 configuration that works on this target. Therefore, you configure.sh command
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
158 should be:
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
159
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
160 ./configure.sh c139 l1reconst
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
161
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
162 See the Compiling write-up for more details.
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
163
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
164 Because we have not deblobbed the G23M firmware component yet (the l1reconst
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
165 configuration uses G23M binary blobs from TCS211/Sotovik), your Magnetite fw
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
166 build will include FAX_AND_DATA and GPRS functionality. In the FreeCalypso
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
167 environment where we are not doing WAP or MMS this functionality can only be
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
168 exercised on targets that bring out a classic modem UART with the classic AT
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
169 command interface to the external host, but Mot C139 is not one of those
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
170 targets - hence on the C139 all FAX_AND_DATA and GPRS code is nothing but dead
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
171 weight. We will only be able to remove this dead weight when and if we fully
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
172 deblob all of L1 and G23M, so it will be a while before we get there, and we'll
48792a467305 doc/C139-Howto improved a bit
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
173 have to carry the dead weight until then.