diff doc/Pirelli-Howto @ 511:3608ce4a585a

doc/Pirelli-Howto: update for current VPM fw status
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 25 Jun 2018 17:07:34 +0000
parents 5b6159d76b09
children 39a226a06196
line wrap: on
line diff
--- a/doc/Pirelli-Howto	Mon Jun 25 07:22:17 2018 +0000
+++ b/doc/Pirelli-Howto	Mon Jun 25 17:07:34 2018 +0000
@@ -38,28 +38,27 @@
 Compiling
 =========
 
-When compiling our Magnetite firmware for the Pirelli target, you can select
-one of two configurations: l1reconst or hybrid; see the Modem-configs article
-for the explanation.  In both cases the phone will act as an AT-command-
-controlled pseudo-modem: the LCD will stay dark and the buttons will do nothing,
-and you will need to control the GSM MS from your PC or other host system.
-
-Run './configure.sh pirelli l1reconst' or './configure.sh pirelli hybrid'
-depending on which configuration you would like to play with, then run
-'make ram' in the build directory created by the configure script - see the
-Compiling write-up for more details.
+We don't have a FreeCalypso firmware offering for the Pirelli that makes it
+work as an untethered phone, and probably never will: there is too much
+undocumented peripheral hardware in this phone.  Instead a Pirelli phone
+running our FC Magnetite firmware will act as voice pseudo-modem: the LCD will
+stay dark and the buttons will do nothing, and you will need to control the GSM
+MS from your PC or other host system via AT commands.
 
-Because we have not yet produced a configuration with FAX_AND_DATA and GPRS
-disabled, your Magnetite fw build will include those components.  In the
-FreeCalypso environment where we are not doing WAP or MMS this functionality
-can only be exercised on targets that bring out a classic modem UART with the
-classic AT command interface to the external host, but the Pirelli is not one
-of those targets - hence on this target all FAX_AND_DATA and GPRS code is
-nothing but dead weight.  Now that we have deblobbed all of L1 with the
-exception of GPRS-specific modules, we could try building a hybrid config with
-GPRS and FAX_AND_DATA excluded, specifically for the benefit of Mot C1xx and
-Pirelli targets, but these legacy hardware targets are no longer a priority for
-the FreeCalypso family of projects.
+As explained in the Voice-pseudo-modem article, the two most sensible firmware
+configurations (in the ./configure.sh sense) for VPM targets are hybrid-vpm and
+l1reconst-chg.  Because of the huge RAM, you can also compile and run our more
+traditional configurations intended for proper modems like FCDEV3B (l1reconst,
+hybrid or hybrid-gpf), but all data services functionality of those fw configs
+(CSD and GPRS) will remain inaccessible (dead weight) when running on the
+Pirelli.  Furthermore, our FreeCalypso battery charging code is only included
+in the special hybrid-vpm and l1reconst-chg configs, not in the traditional
+ones.
+
+Run './configure.sh pirelli l1reconst-chg' or
+'./configure.sh pirelli hybrid-vpm' depending on which configuration you would
+like to play with, then run 'make ram' in the build directory created by the
+configure script - see the Compiling write-up for more details.
 
 Running on the target
 =====================
@@ -154,3 +153,9 @@
 battery and kill the host side rvinterf and fc-shell processes, or you can
 issue a 'tgtreset' command at the fc-shell prompt.  The latter will cause the
 target to reset and boot back into its regular firmware.
+
+A recent addition to our VPM firmware configuration is automatic power-off: if
+you simply disconnect USB while our FC Magnetite VPM fw is running, without
+issuing any tgtreset or poweroff commands and without yanking the battery, our
+firmware should detect the disconnection of USB and power off the phone within
+10 s.