# HG changeset patch
# User Mychaela Falconia <falcon@freecalypso.org>
# Date 1541696935 0
# Node ID 24a161f415f55f8af73700616cd55e442aefab72
# Parent  ee67197fd2e583a39f48c1fea84d8c54e63f0297
doc/Running-on-hw written

diff -r ee67197fd2e5 -r 24a161f415f5 doc/Compiling
--- a/doc/Compiling	Wed Nov 07 09:52:06 2018 +0000
+++ b/doc/Compiling	Thu Nov 08 17:08:55 2018 +0000
@@ -228,3 +228,5 @@
 host tools.  As of this writing, the latest packaged release is this one:
 
 ftp://ftp.freecalypso.org/pub/GSM/FreeCalypso/fc-host-tools-r9a.tar.bz2
+
+Please see the Running-on-hw article for further instructions.
diff -r ee67197fd2e5 -r 24a161f415f5 doc/Running-on-hw
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/Running-on-hw	Thu Nov 08 17:08:55 2018 +0000
@@ -0,0 +1,42 @@
+Running FC Selenite on FCDEV3B hardware
+=======================================
+
+You can build a flashable image and flash it with fc-loadtool, or you can build
+a RAM-loadable image (make ram) and run it via fc-xram.
+
+Running FC Selenite on Motorola C1xx hardware
+=============================================
+
+FC Selenite can only function as a voice pseudo-modem (VPM) on Mot C1xx
+hardware - please read the Voice-pseudo-modem article in the fc-magnetite Hg
+repository for the explanation.
+
+If your C1xx phone is one of the lower subfamilies (C11x/12x or C139/140), then
+flashing is the only way to run any FreeCalypso firmware on it - these phones
+only have enough RAM to satisfy the firmware's data space requirements, but not
+enough to run the firmware itself out of RAM.
+
+If you are working with a C155/156 phone, the primary way to run FC Magnetite
+or FC Selenite on it is to flash your fw image just like on the lower
+subfamilies.  It is also possible to build the gcc version of Selenite (but not
+the TMS470 version) as a RAM-loadable image (make ram) and run it via fc-xram,
+but it will still require having a FreeCalypso FFS in the flash, which is not
+compatible with Mot's original fw on this model - thus you still need to flash
+some FC firmware version first (either Magnetite or Selenite), use it to
+initialize the FFS for FreeCalypso, and then you can run Selenite-gcc via
+fc-xram if desired.
+
+The procedure for flashing an FC Selenite fw image into a Mot C1xx phone is the
+same as for Magnetite - please read the C1xx-Howto article in the fc-magnetite
+source repository.
+
+Running FC Selenite on Pirelli DP-L10 hardware
+==============================================
+
+Both Magnetite and Selenite can only function as a voice pseudo-modem on the
+Pirelli DP-L10 hw; it is highly unlikely that there will ever be a practically
+usable FreeCalypso phone based on this hw platform.  Both TMS470 and gcc
+versions of Selenite can be built as a RAM-loadable image for this target, and
+are to be exercised in the same way as Magnetite, including the requirement of
+FreeCalypso FFS initialization - please read the Pirelli-Howto article in the
+fc-magnetite Hg repository.