annotate doc/Running-on-hw @ 163:a911ac771094

board preprocessor conditionals: prep for more FC hw in the future Please see the corresponding change in fc-magnetite for the explanation.
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 01 Apr 2019 01:20:03 +0000
parents 24a161f415f5
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
128
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 Running FC Selenite on FCDEV3B hardware
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 =======================================
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 You can build a flashable image and flash it with fc-loadtool, or you can build
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 a RAM-loadable image (make ram) and run it via fc-xram.
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7 Running FC Selenite on Motorola C1xx hardware
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 =============================================
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 FC Selenite can only function as a voice pseudo-modem (VPM) on Mot C1xx
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 hardware - please read the Voice-pseudo-modem article in the fc-magnetite Hg
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 repository for the explanation.
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14 If your C1xx phone is one of the lower subfamilies (C11x/12x or C139/140), then
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15 flashing is the only way to run any FreeCalypso firmware on it - these phones
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 only have enough RAM to satisfy the firmware's data space requirements, but not
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 enough to run the firmware itself out of RAM.
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19 If you are working with a C155/156 phone, the primary way to run FC Magnetite
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20 or FC Selenite on it is to flash your fw image just like on the lower
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 subfamilies. It is also possible to build the gcc version of Selenite (but not
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22 the TMS470 version) as a RAM-loadable image (make ram) and run it via fc-xram,
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 but it will still require having a FreeCalypso FFS in the flash, which is not
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24 compatible with Mot's original fw on this model - thus you still need to flash
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 some FC firmware version first (either Magnetite or Selenite), use it to
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26 initialize the FFS for FreeCalypso, and then you can run Selenite-gcc via
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27 fc-xram if desired.
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29 The procedure for flashing an FC Selenite fw image into a Mot C1xx phone is the
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30 same as for Magnetite - please read the C1xx-Howto article in the fc-magnetite
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31 source repository.
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33 Running FC Selenite on Pirelli DP-L10 hardware
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34 ==============================================
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
35
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
36 Both Magnetite and Selenite can only function as a voice pseudo-modem on the
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
37 Pirelli DP-L10 hw; it is highly unlikely that there will ever be a practically
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
38 usable FreeCalypso phone based on this hw platform. Both TMS470 and gcc
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
39 versions of Selenite can be built as a RAM-loadable image for this target, and
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
40 are to be exercised in the same way as Magnetite, including the requirement of
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
41 FreeCalypso FFS initialization - please read the Pirelli-Howto article in the
24a161f415f5 doc/Running-on-hw written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
42 fc-magnetite Hg repository.