FreeCalypso > hg > ffs-editor
annotate README @ 23:3ca9a198c6ee
support new FC Tourmaline C139 aftermarket FFS config
| author | Mychaela Falconia <falcon@freecalypso.org> |
|---|---|
| date | Sun, 18 Oct 2020 02:34:21 +0000 |
| parents | 5dd2fa1d3da1 |
| children | d7740787396c |
| rev | line source |
|---|---|
| 20 | 1 FFS editor operated via fc-xram |
| 2 =============================== | |
| 3 | |
| 4 The software article presented in this repository is a tool for operating on | |
| 5 the flash file system (FFS) of Calypso devices running FreeCalypso firmware. | |
| 6 Before explaining the tool itself, I need to explain why it is needed. | |
| 7 | |
| 8 Every FC firmware version includes our TI-based FFS implementation and maintains | |
| 9 an FFS instance in device flash memory; the standard way to operate on this FFS | |
| 10 is by way of our fc-fsio utility communicating with the running firmware over | |
| 11 its RVT/ETM interface. With our AT-command-controlled modem firmwares, most of | |
| 12 the time the modem fw itself is the only agent that actually operates on the | |
| 13 FFS: if you need to perform low-level FFS operations such as formatting, simply | |
| 14 boot the firmware normally, but don't give it any AT commands, and instead poke | |
| 15 at it with fc-fsio. But when we start building firmware versions with handset | |
| 16 UI layers included, relying on the firmware itself as the sole FFS operating | |
| 17 agent becomes problematic: these UI-enabled firmwares launch into complex | |
| 18 high-level operations immediately upon boot, and it can be very desirable to be | |
| 19 able to get the FFS into a certain shape *before* the main firmware is allowed | |
| 20 to boot with it. | |
| 21 | |
| 22 The tool presented in this repository is intended to be a solution to this | |
| 23 problem. The present FFS editor is a very heavily stripped-down derivative of | |
| 24 our FC Selenite firmware, stripped heavily enough to fit entirely into RAM on | |
| 25 all of our targets, even the smallest Mot C11x. This FFS editor "firmware" | |
| 26 does not include any GSM functionality - no L1, no G23M PS and no ACI - and GPF | |
| 27 has been removed as well. The only fw components left are Nucleus, Riviera | |
| 28 (which is totally indepedent of GPF in our TCS211-based architecture), RVT (the | |
| 29 component which manages the RVTMUX UART interface to which we interface via | |
| 30 rvinterf), ETM (the component to which fc-tmsh and fc-fsio talk) and FFS, the | |
| 31 primary component of interest to us here. This FFS editor "firmware" is | |
| 32 compiled with gcc (Selenite-based), and is built only into a RAM-loadable image | |
| 33 to be run via fc-xram, no flashable images. | |
| 34 | |
| 35 The intended usage model is that you run this FFS editor like this: | |
| 36 | |
| 37 fc-xram -h mytarget /dev/ttyXXX ffsagent-XXX.srec rvinterf | |
| 38 | |
| 39 Cause the Calypso device to execute its boot path, fc-xram will load and run | |
| 40 the ffsagent image, and pass the serial channel to rvinterf - then you will | |
| 41 have rvinterf running on your host, talking to ffsagent running on the Calypso. | |
| 42 The FFS editor "firmware" does nothing other than emit a few RV traces and | |
| 43 listen for ETM command packets, and at this point you run fc-fsio to talk to | |
| 44 this FFS agent and perform whatever FFS manipulations are needed. fc-tmsh can | |
| 45 also be used to read and write both Calypso and ABB registers. | |
| 46 | |
| 47 When you are done with the needed fc-fsio manipulations, you can command a Iota | |
| 48 power-off on the target with fc-shell poweroff (sends an ETM ABB register write | |
| 49 command hitting VRPCDEV), or you can kill rvinterf or unplug the serial cable | |
| 50 and let ffsagent on the target power off in 15 to 20 s upon keepalive timeout. | |
| 51 Or you can press the RESET button on the board (FCDEV3B or Caramel) and cause | |
| 52 the flashed firmware to boot. (Powering off by pressing and holding PWON won't | |
| 53 work because the heavily stripped FFS editor "firmware" does not include the | |
| 54 regular firmware's ABB interrupt handling code path.) In any case, when the | |
| 55 flashed fw does boot, it will boot with the FFS content in whatever state you | |
| 56 brought it to with ffsagent and fc-fsio, which is the whole point of the | |
| 57 exercise. | |
| 58 | |
| 59 Supported targets | |
| 60 ================= | |
| 61 | |
| 62 The present FFS editor is intended to run only on those Calypso targets which | |
| 63 run one of our full FreeCalypso GSM firmwares of the Magnetite/Selenite family. | |
| 64 More specifically, it is intended to operate on FFS instances that are "owned" | |
| 65 by flashed FreeCalypso firmwares, *not* on FFS instances that are owned by | |
| 66 someone else's firmware. There is no mechanism for explicitly specifying FFS | |
| 67 location and geometry at a user level, as would be needed for operating on | |
| 68 arbitrary alien FFS instances, instead the FFS editor includes exactly the same | |
| 69 dev.c table of FFS configurations as our production firmwares. The few | |
| 70 different ffsagent build variants that are provided (run ./make-all.sh to | |
| 71 compile all of them) differ in which dev.c table is included, exactly the same | |
| 72 as in our production firmwares: | |
| 73 | |
| 74 * ffsagent-fcfam-{irda,modem}.srec version is built with the CONFIG_TARGET_FCFAM | |
| 75 version of the dev.c table, appropriate for FCDEV3B. | |
| 76 | |
|
21
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
77 * ffsagent-ti26-{irda,modem}.srec version is built with TI's original version |
|
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
78 of the dev.c table with minor additions by OM and FC, appropriate for |
|
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
79 Tango/Caramel/Luna, for Openmoko GTA0x and for GTM900 modems converted to FC. |
|
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
80 |
|
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
81 Target name ti26 refers to 26 MHz CLKTCXO input to Calypso, i.e., *not* |
|
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
82 D-Sample - see below. If we ever get our hands on a D-Sample C035 board or |
|
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
83 some other platform with similar needs, it will be easy to create a ti13 |
|
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
84 counterpart. |
| 20 | 85 |
| 86 * compal and pirelli versions correspond to FreeCalypso aftermarket FFS configs | |
| 87 on those targets, *NOT* Compal's or Pirelli's original FFS! | |
| 88 | |
| 89 compal-new vs. compal-old configs | |
| 90 ================================= | |
| 91 | |
| 92 Back in 2015 I (Mother Mychaela) made the decision to define FC aftermarket FFS | |
| 93 on Mot C139 phones as 64x3 (meaning 3 sectors of 64 KiB each), located at | |
| 94 0x3C0000. Right now I am thinking that we should change to a larger FFS config, | |
|
21
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
95 but I have not yet committed to any specific new config. When and if I make |
| 20 | 96 the big switch, compal-new will be the new config, while compal-old will remain |
| 97 the original 2015 config. At the present moment the two ffsagent-compal-* | |
| 98 images are identical. | |
|
21
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
99 |
|
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
100 No Calypso C05 target support |
|
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
101 ============================= |
|
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
102 |
|
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
103 The present FFS editor application is a stripped-down derivative of FC Selenite |
|
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
104 firmware, still containing Nucleus RTOS, thus it uses interrupts. Having a |
|
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
105 run-from-RAM (or more precisely, independent of flashed fw) application use |
|
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
106 interrupts requires having Calypso boot ROM version 0300, which is present only |
|
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
107 in Calypso C035 silicon. (We can still use this ROM for our purpose of |
|
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
108 interrupt redirection even if it is disabled on boot like on Compal phones.) |
|
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
109 Because of this interrupt handling issue, this FFS editor application is not |
|
5dd2fa1d3da1
README: minor fixes
Mychaela Falconia <falcon@freecalypso.org>
parents:
20
diff
changeset
|
110 available on the Mother's D-Sample C05 board, or any other Calypso C05 target. |