--- a/README	Tue Nov 12 05:00:00 2013 +0000
+++ b/README	Tue Nov 12 05:35:48 2013 +0000
@@ -1,6 +1,14 @@
 You are looking at the top level of the freecalypso-sw source code tree.
 The subtrees of this source tree are as follows:
 
+gsm-fw		This tree contains the early beginnings of my (Michael
+		Spacefalcon's) attempt to recreate TI's GSM firmware suite for
+		modems and basic phones, consisting of Nucleus RTOS, RiViera
+		and GPF frameworks, TI's BSP/driver and L1 code, Condat G23
+		GSM/GPRS protocol stack, AT command interpreter and UI layers.
+		The current code is in the earliest embryonic stages of
+		development, and does not do anything useful yet.
+
 loadtools	The suite of tools which run on a development host machine
 		(normally PC/Linux desktop or laptop) and communicate with
 		Calypso targets.  Starting from the Calypso ROM bootloader,
@@ -8,14 +16,14 @@
 		program flash, and load and execute experimental code in IRAM
 		or XRAM.
 
-nuc-fw		Nucleus-based firmware.  This tree contains the early beginnings
-		of my (Michael Spacefalcon's) attempt to recreate TI's GSM
-		firmware suite running under Nucleus RTOS.  The current code is
-		in the earliest embryonic stages of development, and does not
-		do anything useful yet.  The RTOS code is FreeNucleus, based on
-		the Nucleus PLUS sources liberated by comrade XVilka and ported
-		to build with gcc and run on the Calypso by Spacefalcon the
-		Outlaw.
+rvinterf	In common with TI's original fw, FreeCalypso GSM fw implements
+		the so-called RiViera serial MUX, which is a binary packet
+		protocol for multiplexing many kinds of debug and development
+		traffic over just one available physical serial port.  This
+		rvinterf directory contains the early beginnings of our suite
+		of tools for connecting to this RV serial interface, supporting
+		both our own gsm-fw as well as some existing proprietary
+		firmwares to the extent to which they are compatible.
 
 target-utils	These are utilities which run on Calypso targets, but which are
 		independent of Nucleus, of any other RTOS, and of any larger
@@ -29,4 +37,4 @@
 toolchain	Scripts and patches for building the gcc+binutils toolchain
 		targeting ARM7, the CPU core of the Calypso GSM/GPRS baseband
 		processor.  You'll need to build and install this toolchain
-		first before you can build nuc-fw or target-utils.
+		first before you can build gsm-fw or target-utils.