annotate README @ 48:616f63f3e501 default tip

fixed bug in etm_pkt_send() dealing with max-sized packets: this fix is needed for fc-fsio cpout command to work like it does with Pirelli's firmware (they must have made the same fix)
author Mychaela Falconia <falcon@ivan.Harhan.ORG>
date Fri, 13 Nov 2015 19:11:07 +0000
parents 52325cb524a8
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
29
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
1 This semi-source tree contains a hacked version of TI's TCS211 firmware that
43
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
2 has been made to run on the Motorola C139. Once the remaining bugs get shaken
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
3 out (there are still some crippling ones, so don't break out the champagne yet),
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
4 one will be able to replace Motorola's firmware in flash with this one and
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
5 *still be able to use the phone as an end user* - but now running firmware that
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
6 we build from source ourselves, one whose internals we know and understand and
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
7 which we can use a baseline for further functional improvements.
29
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
8
43
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
9 Compiling
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
10 =========
29
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
11
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
12 Building the present firmware from semi-source requires using a Wine environment
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
13 to run TI's proprietary compiler toolchain and other build tools which exist
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
14 only as M$ Windows binaries. The necessary environment can be downloaded here:
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
15
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
16 ftp://ftp.freecalypso.org/pub/GSM/TI_src/wine/
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
17
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
18 You will also need the mokosrec2bin utility, which is needed for one of the
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
19 finishing steps in generating an image that can be usefully flashed into a C139:
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
20
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
21 ftp://ftp.freecalypso.org/pub/GSM/GTA02/gsm-fw/mokosrec2bin.c
12
da79bf85bd73 README added
Space Falcon <falcon@ivan.Harhan.ORG>
parents:
diff changeset
22
29
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
23 Once you have the necessary build tools installed, you should be able to
43
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
24 compile the present fw as follows:
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
25
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
26 cd g23m
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
27 ./winebuild.sh
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
28 ./copyout.sh
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
29
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
30 The build products will be in the g23m/mfw-build directory. mfw-build.progbin
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
31 is the flashable image, and the other files should be saved as documentation:
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
32 you should retain the COFF, map and str2ind.tab files that correspond exactly
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
33 to what you have flashed, so you can debug it later.
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
34
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
35 Flashing: what goes where
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
36 =========================
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
37
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
38 WARNING: C139 phones are brickable! If you type the wrong command in
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
39 fc-loadtool, you can brick your phone *unrecoverably*! Flash sector 0 MUST at
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
40 all times contain working boot code that can successfully perform the following
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
41 functions:
29
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
42
43
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
43 1. Check the headset jack UART for a possible serial download - if an external
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
44 host is requesting a serial code download, accept the serially loaded code
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
45 and jump to it.
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
46
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
47 2. If no serial download is taking place, jump to the main fw image in the rest
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
48 of the flash for normal boot.
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
49
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
50 Function (2) may differ depending on what main fw is to be used, but function
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
51 (1) is absolutely essential: if flash sector 0 is erased and not immediately
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
52 reprogrammed with working boot code, or if it gets programmed with some code
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
53 version that does not perform function (1), then all ability to take control of
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
54 the phone will be lost, and it will be forever stuck in one of two states:
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
55
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
56 (a) If the boot code still performs function (2) and there happens to be a
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
57 working main fw image in the flash, the phone will be stuck with that fw
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
58 version forever, with no ability to reflash it or to load and execute any
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
59 code in RAM.
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
60
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
61 (b) If the conditions of (a) above aren't met, the phone will be reduced to a
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
62 paperweight. There is no JTAG access on these phones, and the flash chip
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
63 is not only a micro-BGA, but also combined with SRAM in the same package.
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
64 Desoldering the flash+SRAM chip and replacing it with an externally
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
65 programmed one is not likely to be feasible, hence bricked really means
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
66 bricked. You've been warned!
29
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
67
43
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
68 For FreeCalypso we've adopted our own version of the bootloader that performs
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
69 function (1) exactly like Mot/Compal's original (actually slightly better, as
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
70 we've removed the "1003" check, thus the inefficient -c 1003 fc-loadtool option
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
71 becomes unnecessary), but we've modified function (2): in Compal's original
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
72 design the main fw image starts at 0x2000 with the entry point at 0x20F8,
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
73 whereas in our arrangement the main fw image starts at 0x10000 with the entry
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
74 point at 0x10058.
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
75
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
76 We've changed the starting address for the main fw image to coincide with the
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
77 physical flash erase block boundary and thereby reduce the bricking risk. If
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
78 we put our main fw image starting at 0x2000 like Mot/Compal did, we would have
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
79 to erase and reprogram flash sector 0 every time we would like to change the
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
80 main fw, incurring the risk of bricking the phone. But with our modified boot
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
81 code we only have to do it once, when a given phone is first transitioned from
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
82 Mot/Compal's original fw to one of ours. With subsequent reflashings from one
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
83 FreeCalypso fw version to another, we only need to reflash the main fw starting
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
84 at 0x10000, and leave flash sector 0 alone.
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
85
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
86 Besides the main fw and the critical boot code, the flash houses two more
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
87 entities: the factory data block and the flash file system (FFS).
29
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
88
43
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
89 Factory data block
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
90 ==================
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
91
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
92 The 8 KiB flash sector at 0x3FC000 contains per-unit factory programming from
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
93 Motorola/Compal: RF calibration values, the unit's official IMEI and Cthulhu
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
94 knows what else. Unfortunately we haven't been able to parse this info beyond
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
95 a superficial level, hence we have no way to make use of any of this data.
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
96 But of course we should not erase or overwrite it, so we just leave this flash
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
97 sector alone.
29
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
98
43
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
99 Flash file system
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
100 =================
29
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
101
43
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
102 Because Mot/Compal had moved their IMEI and RF calibration values into their
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
103 own proprietary format, these juicy items are NOT found in the FFS maintained
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
104 by the original firmware. Instead the original fw's FFS contains only dynamic
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
105 state and user data, hence it is of no use to us. We have adopted a different
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
106 flash location for our FFS from that used by Mot/Compal's fw in order to prevent
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
107 any possible cross-contamination, and you will need to manually initialize this
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
108 aftermarket FFS the first time you install FreeCalypso firmware on your C139.
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
109
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
110 Flashing procedure
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
111 ==================
29
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
112
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
113 If you are not scared off by all of the above and you still wish to try this
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
114 experimental fw on your C139, you can install it as follows:
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
115
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
116 1. Connect to the phone with fc-loadtool, preceded by tfc139 if necessary -
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
117 see loadtools documentation.
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
118
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
119 2. If the C139 in question does not already have some other FreeCalypso fw
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
120 version in its flash, replace the bootloader:
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
121
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
122 loadtool> flash erase-program-boot compal-flash-boot-for-fc.bin
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
123
43
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
124 (compal-flash-boot-for-fc.bin is our modified bootloader version, and it is
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
125 built from one of Compal's versions via binary patching in the freecalypso-sw
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
126 source tree.)
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
127
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
128 Optional step: If your serial cable setup supports the special GSM high baud
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
129 rates, you can speed the process up by issuing a baud 406250 or baud 812500
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
130 command at this point.
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
131
29
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
132 3. Flash the main fw image:
12
da79bf85bd73 README added
Space Falcon <falcon@ivan.Harhan.ORG>
parents:
diff changeset
133
43
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
134 loadtool> flash erase 10000 290000
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
135 loadtool> flash program-bin 10000 mfw-build.progbin
29
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
136
43
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
137 Or you can use the supplied nifty loadtool command script:
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
138
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
139 loadtool> exec ./flash-mfw
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
140
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
141 The current directory must be g23m for the script method to work.
29
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
142
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
143 4. Erase the sectors where our firmware's non-volatile flash file system
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
144 (aftermarket FFS configuration) will reside:
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
145
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
146 loadtool> flash erase 3C0000 30000
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
147
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
148 5. Cleanly end your fc-loadtool session, which will power the phone off:
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
149
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
150 loadtool> exit
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
151
43
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
152 FFS initialization
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
153 ==================
29
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
154
43
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
155 The first time you boot your C139 after the above flashing procedure, the phone
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
156 should have no SIM in it. Firmwares built with UI enabled (like the present)
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
157 automatically fire up GSM functionality and try to connect to a network
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
158 immediately upon boot if a SIM is present, and you don't want to do that on
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
159 your first boot: at this point your phone has *no* IMEI and no working FFS at
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
160 all. When the fw boots up without a SIM, it still enables the part of the GSM
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
161 radio protocol stack that looks for usable cells, in anticipation of the
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
162 possibility that the user may need to make an emergency call, but it never
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
163 transmits anything in this state (Tx fully off) unless you do dial that
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
164 emergency call.
29
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
165
43
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
166 So take the SIM out before you start the reflashing procedure, and then boot
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
167 the SIM-less phone afterward. You should see a message on the LCD that reads
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
168 "Insert SIM". But instead of inserting a SIM, you should run the fc-fsio
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
169 utility from FreeCalypso host tools at this point. Plug the serial cable back
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
170 in if you unplugged it, and run fc-fsio:
13
3e89489a43b3 using patched version of frame_na7_db_ir.lib:
Space Falcon <falcon@ivan.Harhan.ORG>
parents: 12
diff changeset
171
43
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
172 fc-fsio -p /dev/ttyXXX
29
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
173
43
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
174 (Omit the -p argument if you already have rvinterf running for fc-fsio to
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
175 connect to.)
29
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
176
43
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
177 Then issue the following commands:
29
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
178
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
179 fsio> format /
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
180 fsio> mk-std-dirs
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
181 fsio> set-imeisv fc XXXXXXXX-YYYYYY-ZZ (punctuation optional, place anywhere)
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
182 fsio> set-rfcap dual-eu (if you have 900+1800 MHz hardware)
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
183 or
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
184 fsio> set-rfcap dual-us (if you have 850+1900 MHz hardware)
132b3e230631 README written for tcs211-c139
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 13
diff changeset
185
43
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
186 Yes, you need to set your own IMEISV. The official one is stored in the factory
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
187 data block, but we don't know how to parse it, so it effectively does not exist
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
188 for us. It is entirely up to you whether you set the same IMEI as the official
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
189 one or a different one: our fw has no psychic powers to compare. Unless you
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
190 have reason to do otherwise though, the default should be to keep the original
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
191 IMEI. It is not clear what Mot/Compal's fw puts in the SV digits, so just put
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
192 00 in there if you don't feel like inventing version numbers.
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
193
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
194 The set-rfcap command is necessary because our fw does not know otherwise
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
195 whether your C139 is the 900+1800 MHz version or 1900+850 MHz. If you don't
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
196 write a /gsm/com/rfcap file with this command, the fw defaults to quadband
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
197 (the part of the fw where this default is effected is a binary blob in the
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
198 present version) and will waste time scanning frequencies which it can't
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
199 receive because the corresponding RF transceiver input is unconnected
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
200 (unsupported high band) or because they are blocked by a SAW filter
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
201 (unsupported low band).
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
202
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
203 After you have initialized your new aftermarket FFS with fc-fsio per the above,
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
204 exit fc-fsio and power your phone off: hold the power button down until a TI
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
205 logo appears on the LCD, then release the button; the phone will power off
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
206 shortly, and you'll know it's off when the LCD turns off. Now you can insert
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
207 a SIM and boot again - this time the phone should be live!
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
208
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
209 Limitations
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
210 ===========
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
211
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
212 * The present fw has been built from a semi-src (half source, half binary
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
213 objects) TI firmware release which was made for some manufacturer that made
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
214 GSM/GPRS modems, rather than voice handsets, hence the present configuration
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
215 is unfortunately highly suboptimal for our use case. The entire mass of code
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
216 supporting CSD, fax and GPRS data services is included and cannot be removed
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
217 because that part of the fw is in binary blobs, but all this code is pure dead
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
218 weight in the present configuration: the phone UI layer won't make any use of
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
219 data functionality (nowhere near enough resources on this hw to implement a
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
220 WAP browser or MMS), and because we had to give up the standard AT command
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
221 channel (see next point), the option of having the phone dual-function as a
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
222 laptop-tethered modem is not available either.
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
223
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
224 * TI's full-featured phone firmwares allow the phone to dual-function as a
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
225 modem, so one could connect the phone to a laptop and make a CSD call or use
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
226 GPRS. But they were designed to make use of two UARTs, one for the classic
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
227 AT command interface and the other for their RVTMUX debug/calibration/etc
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
228 interface. Unfortunately though, our present target hw has only one UART
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
229 practically accessible (Calypso's MODEM UART brought out on the headset jack),
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
230 and we absolutely need the debug interface, thus the classic AT command
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
231 interface had to be sacrificed. One can still issue AT commands over RVTMUX
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
232 with FreeCalypso host utility fc-shell, but this mechanism works only for
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
233 voice and SMS commands, not CSD or GPRS. Hence the data functions of the fw
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
234 remain unusable dead weight. :(
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
235
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
236 * The headset functionality of the headset jack is also unavailable: because we
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
237 need to be able to use the debug interface at all times, we always keep the
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
238 electrically-controlled switch in the state that connects the headset jack to
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
239 the UART (presenting RVTMUX) instead of the audio circuits.
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
240
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
241 * Because we don't know how to grok Mot/Compal's factory data block, our fw
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
242 currently runs UNCALIBRATED. It may have difficulty connecting to networks
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
243 if it can't acquire the frequency burst lacking VCXO calibration, and the Tx
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
244 power levels are almost certainly wrong (out of spec) - BEWARE!
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
245
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
246 * The only 3 display configurations for which TI produced demo/prototype UI in
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
247 their chipset reference firmware are 84x48 pix monochrome, 176x220 pix
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
248 monochrome and 176x220 pix full color. We have a 96x64 pix LCD on the C139,
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
249 hence we are using TI's 84x48 UI design until we can create one that makes
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
250 use of the slightly larger 96x64 screen. However, TI had that 84x48 LCD on
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
251 their C-Sample and earlier platforms (*very* old), and as we discovered
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
252 empirically, the support for this 84x48 display config is already bitrotten
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
253 in the source tree we got, which officially targets TI's D-Sample and Leonardo
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
254 boards.
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
255
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
256 At first the C-Sample UI configuration did not even compile. We got it to
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
257 compile by fixing it in a way that *seemed* right, but when we run this
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
258 resurrected C-Sample UI on our C139 hardware, one can plainly see that the UI
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
259 is still defective, as the expected output on the LCD is mixed with garbage.
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
260 We will need to delve into the UI code in more depth in order to really fix it
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
261 to where the display will be readable without garbage.
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
262
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
263 * Battery charging has not been tried yet. It most likely won't work without
52325cb524a8 new README written for the UI-enabled configuration
Mychaela Falconia <falcon@ivan.Harhan.ORG>
parents: 29
diff changeset
264 additional fixes.