changeset 223:619a33e8425e

doc/Pirelli-Howto: update for the availability of the hybrid config
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 16 Oct 2016 00:53:45 +0000
parents 79cb194284ca
children 08543d6806b0
files doc/Pirelli-Howto
diffstat 1 files changed, 20 insertions(+), 19 deletions(-) [+]
line wrap: on
line diff
--- a/doc/Pirelli-Howto	Sun Oct 16 00:26:26 2016 +0000
+++ b/doc/Pirelli-Howto	Sun Oct 16 00:53:45 2016 +0000
@@ -33,27 +33,28 @@
 Compiling
 =========
 
-When compiling our Magnetite firmware for the Pirelli target, you will need to
-select the l1reconst configuration - it is the only currently available
-configuration that works on this target.  Therefore, you configure.sh command
-should be:
+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.
 
-./configure.sh pirelli l1reconst
-
-To build a RAM-loadable image for the Pirelli, run 'make ram' in the build
-directory created by the configure script - see the Compiling write-up for
-more details.
+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.
 
-Because we have not deblobbed the G23M firmware component yet (the l1reconst
-configuration uses G23M binary blobs from TCS211/Sotovik), your Magnetite fw
-build will include FAX_AND_DATA and GPRS functionality.  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.  We will only be able to remove this dead weight when and if we
-fully deblob all of L1 and G23M, so it will be a while before we get there,
-and we'll have to carry the dead weight until then.
+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.  We will only be able to remove this dead weight when
+we finish deblobbing L1: the few non-GPRS-specific L1 binary objects which we
+are still using have been built with IDS and L1_GPRS enabled, thus we cannot
+change these two configuration settings until those L1 modules have been
+deblobbed.  We'll get there, but not yet.
 
 Running on the target
 =====================