# HG changeset patch
# User Mychaela Falconia <falcon@freecalypso.org>
# Date 1532286647 0
# Node ID f9125919bbe4435c77806eba48544ca2460f0b13
# Parent  ea4daae6e1ced40556afa3d7f8092f4529a323e3
README: update for Selenite

diff -r ea4daae6e1ce -r f9125919bbe4 README
--- a/README	Sun Jul 22 17:11:50 2018 +0000
+++ b/README	Sun Jul 22 19:10:47 2018 +0000
@@ -160,19 +160,38 @@
 these components are so stable and configuration-independent that they were
 used mostly in prebuilt library form even inside TI.  In the case of GPF we've
 got the corresponding source for most of the modules within those libs; for the
-few modules for which the original source has been lost, we've already done a
-rough first-draft reconstruction as part of our previous gcc-built GSM fw
-efforts, and we only need to polish this reconstruction in order to have
-deblobbed GPF in our mainline production fw.  In the case of Nucleus we likewise
-have another version of it in full source form which has been proven good in
-other FreeCalypso firmware projects.
+few modules for which the original source has been lost (OSL and OSX), we have
+a reconstructed source and one can build a Magnetite config (hybrid-gpf) that
+uses these reconstructed versions of OSL and OSX instead of the blobs, but we
+are not 100% confident in the quality of this reconstruction, hence this
+hybrid-gpf config is currently considered experimental, not production.  In the
+case of Nucleus we likewise have another version of it in full source form
+which has been proven good in other FreeCalypso firmware projects, but it is
+not used in Magnetite.
+
+Blob-free, gcc-built version
+============================
+
+For those who require or desire a firmware version that is completely free of
+any blobs and builds with a FLOSS compiler, we now have a new experimental
+firmware project called FreeCalypso Selenite:
 
-The planned successor to FC Magnetite (tentative planned name Selenite) will
-use the hybrid config for the G23M PS, deblobbed GPF and the source-enabled
-version of Nucleus, resulting in blob-free firmware except for the proprietary
-TMS470 compiler and its equivalent of libc/libgcc.  Transition to building with
-gcc (like in FreeCalypso Citrine) will follow afterward, completely exiting the
-land of blobs and proprietary build tools.
+https://bitbucket.org/falconian/fc-selenite
+
+FC Selenite is based on FC Magnetite (just the modem functionality, no work-in-
+progress phone UI, and only the hybrid code version), but it uses the new
+full-source version of Nucleus and our reconstructed versions of OSL and OSX,
+and it offers the option of building either with the original TMS470 compiler
+or with gcc.  The gcc-built version also uses entirely new implementations of
+all assembly components and linker script magic, as the two toolchain
+environments are entirely different in this regard.
+
+This new Selenite firmware is expected to fully supplant our earlier and now
+completely unmaintained Citrine fw (our first attempt at gcc-built fw), but it
+is still highly experimental: as of this writing, GPRS does not work at all in
+Selenite-gcc (Citrine does not have any GPRS support either), and even the
+GSM-only config with GPRS disabled exhibits some intermittent glitches.  Thus
+the stable production fw is still TMS470-built FC Magnetite for the time being.
 
 Further reading
 ===============