FreeCalypso > hg > ffs-editor

comparison README @ 27:cb3f6fe694e1 default tip

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
README: document SE K2x0 addition
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 21 Dec 2023 21:44:43 +0000
parents d7740787396c
children
comparison
equal deleted inserted replaced
26:680f6fdb5e62 27:cb3f6fe694e1
54 regular firmware's ABB interrupt handling code path.) In any case, when 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 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 56 brought it to with ffsagent and fc-fsio, which is the whole point of the
57 exercise. 57 exercise.
58 58
59 Supported targets 59 Supported targets (original intent)
60 ================= 60 ===================================
61 61
62 The present FFS editor is intended to run only on those Calypso targets which 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. 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" 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 65 by flashed FreeCalypso firmwares, *not* on FFS instances that are owned by
84 counterpart. 84 counterpart.
85 85
86 * compal and pirelli versions correspond to FreeCalypso aftermarket FFS configs 86 * compal and pirelli versions correspond to FreeCalypso aftermarket FFS configs
87 on those targets, *NOT* Compal's or Pirelli's original FFS! 87 on those targets, *NOT* Compal's or Pirelli's original FFS!
88 88
89 Supported targets (more recent additions)
90 =========================================
91
92 The discovery of Sony Ericsson K200/220 phones in late 2022 has created a novel,
93 not previously envisioned use case for the present FFS editor. As of this
94 writing (2023 Winter Solstice), there are no active plans to run FreeCalypso
95 firmware on these SE K2x0 phones - hence by the principles of the previous
96 section, this target would not qualify to be supported by the present tool.
97 However, the FFS used by original/official fw on these phones is a variant of
98 TIFFS, and there are some corner use cases where it may be desirable to make
99 some surgical modifications to their FFS outside of the constraints imposed by
100 the official fw. This type of use case is an area where the present FFS editor
101 is the best tool for the job, hence we decided to expand our scope a little
102 (beyond the original intent) and support a configuration where our ffs-editor
103 tool operates on an FFS instance that is not owned by FC.
104
105 The SE K2x0 version of our FFS editor (ffsagent-se_k2x0.srec) operates on the
106 original-manuf-defined FFS location on this SE K2x0 hardware target. If anyone
107 ever decides to port full FC firmware (beyond the present ffs-editor tool) to
108 this se_k2x0 target, the Mother's recommendation would be to reuse the same FFS
109 location. Unlike the situation on Pirelli DP-L10, the flash structure on SE
110 K2x0 (the layout of which flash area is used for what in the original/official
111 design) does not leave an obvious unused place where an aftermarket FFS can be
112 placed (not conflicting with any aspect of the official fw, FFS or otherwise),
113 and the different hw design (computer connection does not apply charger-plug
114 condition to Iota VRPC) eliminates the very peculiar set of issues we have to
115 deal with on the Pirelli target that led to our design decisions there.
116
89 compal-new vs. compal-old configs 117 compal-new vs. compal-old configs
90 ================================= 118 =================================
91 119
92 Back in 2015 I (Mother Mychaela) made the decision to define FC aftermarket FFS 120 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 121 on Mot C139 phones as 64x3 (meaning 3 sectors of 64 KiB each), located at