added Write Register Masked operation
authoreb <eb@221aa14e-8319-0410-a670-987f0aec2ac5>
Mon, 26 Feb 2007 21:32:48 +0000 (21:32 +0000)
committereb <eb@221aa14e-8319-0410-a670-987f0aec2ac5>
Mon, 26 Feb 2007 21:32:48 +0000 (21:32 +0000)
git-svn-id: http://gnuradio.org/svn/gnuradio/trunk@4647 221aa14e-8319-0410-a670-987f0aec2ac5

usrp/doc/inband-signaling-usb

index 337dc799d3711aa500e9d5f267b7e71da675f477..14f83479a69f5020ea6b589a21ccf2bc6873fe32 100644 (file)
@@ -91,6 +91,9 @@ format across the USB.
        packet is discarded.  As a special case, the timestamp
        0xffffffff is interpreted as "Now".
 
+       The time base is a free running 32-bit counter that is
+       incremented by the A/D sample-clock.
+
   Payload: Variable length field.  Length is specified by the
         Payload Len field.
 
@@ -100,12 +103,21 @@ format across the USB.
 
 
 
+"Data Channel" payload format:
+-------------------------------
+
+If Chan != 0x1f, the packet is a "data packet" and the payload is a
+sequence of homogeneous samples.  The format of the samples is
+determined by the configuration associated with the given channel.  
+It is often the case that the payload field contains 32-bit complex
+samples, each containing 16-bit real and imaginary components.
+
 
 "Control Channel" payload format:
 ---------------------------------
 
-The control channel payload consists of a sequence of 0 or more
-sub-packets.
+If Chan == 0x1f, the packet is a "control packet".  The control channel
+payload consists of a sequence of 0 or more sub-packets.
 
 Each sub-packet starts on a 32-bit boundary, and consists of an 8-bit
 Opcode field, an 8-bit Length field, Length bytes of arguments, and 0,
@@ -163,6 +175,25 @@ Write Register:
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
 
 
+Write Register Masked:
+
+    Opcode:    OP_WRITE_REG_MASKED
+
+    REG[Num] = (REG[Num] & ~Mask) | (Value & Mask)
+
+    That is, only the register bits that correspond to 1's in the
+    mask are written with the new value.
+
+
+   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+   |     Opcode    |      10       |    mbz    |     Reg Number    |
+   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+   |                         Register Value                        |
+   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+   |                           Mask Value                          |
+   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+
 Read Register:
 
     Opcode:    OP_READ_REG
@@ -229,7 +260,7 @@ SPI Write:
     Enables:         Which SPI enables to assert (mask)
     Format:          Specifies format of SPI data and Opt Header Bytes
     Opt Header Bytes: 2-byte field containing optional Tx bytes; see Format
-    Data:            The bytes to write to the I2C bus
+    Data:            The bytes to write to the SPI bus
     Length:          Length of Data + 6
 
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+