--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README	Mon Jul 16 20:36:34 2018 +0000
@@ -0,0 +1,24 @@
+FreeCalypso Selenite is a side branch off the mainline FC Magnetite firmware.
+The principal changes from Magnetite are:
+
+* Only modem functionality is supported.  FC Magnetite includes TI's C-Sample
+  and D-Sample demo/prototype UI code and work in progress toward our own
+  FreeCalypso Libre Dumbphone; this code is not included and this functionality
+  is explicitly unsupported in Selenite.
+
+* Only the hybrid modem configuration is supported, using the new G23M PS and
+  ACI code from TCS3.2/LoCosto, not any of the legacy configurations that used
+  the blob-laden version from TCS211-20070608.
+
+* The old version of Nucleus used in TI's TCS211 program (binary sans source)
+  is being replaced with FreeNucleus by XVilka.  OSL (GPF to Nucleus glue layer)
+  is the source-reconstructed version.
+
+* The tree layout and the build system are structured in a such way that it
+  will be possible to build either with TI's original TMS470 compiler or with
+  gcc.
+
+FC Selenite is currently a work in progress.  The configuration in which the
+new version of Nucleus is built with the old TMS470 compiler needs to be put
+together as a transitional step, and only after that step we'll be in the right
+state to begin the work of porting to gcc.