Changeset 80b1c2f in rtems

Timestamp:

Jul 9, 1998, 6:36:19 PM (23 years ago)

Author:

Joel Sherrill <joel.sherrill@…>

Branches:

4.10, 4.11, 4.8, 4.9, 5, master

Children:

677a503

Parents:

0d1184f

Message:

Added information to README.mc68681.

Created the basic README and the README.z85c30.

Location:

c/src

Files:

• lib/libchip/serial/README (added)
• lib/libchip/serial/README.mc68681 (modified) (2 diffs)
• lib/libchip/serial/README.z85c30 (added)
• libchip/serial/README (added)
• libchip/serial/README.mc68681 (modified) (2 diffs)
• libchip/serial/README.z85c30 (added)

c/src/lib/libchip/serial/README.mc68681

@@ -6 +6 @@
 =======================
 
+sDeviceName
+
+   The name of this device.
+
+pDeviceFns
+
+   The device interface control table.  This may be:
+      + mc68681_fns for interrupt driven IO
+      + mc68681_fns_polled for polled IO
+
+deviceProbe
+
+   This is the address of the routine which probes to see if the device
+   is present.
+
 pDeviceFlow
 
    This field is ignored as hardware flow control is not currently supported.
+
+ulMargin
+
+    This is currently unused.
+
+ulHysteresis
+
+    This is currently unused.
+
+pDeviceParams
+
+    This is set to the default settings.
 
 ulCtrlPort1
@@ -21 +48 @@
 
    This field is bit mapped as follows:
-     bit 0:  0 or 1 to indicate the A or B port on the DUART.
-     bit 1:  baud rate set a or b
- 
+     bit 0:  baud rate set a or b
+     bit 1-2: BRG selection ("Select Extend bit")
 
    Note: If both ports on single DUART are not configured for the same
          baud rate set, then unexpected results will occur.
 
+   Note: On the Exar 88c681, if a standard clock of 3.6864 Mhz is used
+         and the "Select Extend bit" is 0 (disabled), then the default
+         MC68681 baud rate table is selected.
+
 getRegister
 setRegister
+
    These follow standard conventions.
 
 getData
 setData
+
    These are unused since the TX and RX data registers can be accessed
    as regular registers.
 
+ulClock
 
+   This is either NULL or a pointer to a baud rate mapping table.  If
+   NULL, then the CSR/ACR/X bit mappings shown in the 68681 and 88681
+   manuals are used.  Otherwise, the board specific baud rate mapping
+   is used.
+
+ulIntVector
+
+   This is the interrupt vector number associated with this chip.
+

c/src/libchip/serial/README.mc68681

@@ -6 +6 @@
 =======================
 
+sDeviceName
+
+   The name of this device.
+
+pDeviceFns
+
+   The device interface control table.  This may be:
+      + mc68681_fns for interrupt driven IO
+      + mc68681_fns_polled for polled IO
+
+deviceProbe
+
+   This is the address of the routine which probes to see if the device
+   is present.
+
 pDeviceFlow
 
    This field is ignored as hardware flow control is not currently supported.
+
+ulMargin
+
+    This is currently unused.
+
+ulHysteresis
+
+    This is currently unused.
+
+pDeviceParams
+
+    This is set to the default settings.
 
 ulCtrlPort1
@@ -21 +48 @@
 
    This field is bit mapped as follows:
-     bit 0:  0 or 1 to indicate the A or B port on the DUART.
-     bit 1:  baud rate set a or b
- 
+     bit 0:  baud rate set a or b
+     bit 1-2: BRG selection ("Select Extend bit")
 
    Note: If both ports on single DUART are not configured for the same
          baud rate set, then unexpected results will occur.
 
+   Note: On the Exar 88c681, if a standard clock of 3.6864 Mhz is used
+         and the "Select Extend bit" is 0 (disabled), then the default
+         MC68681 baud rate table is selected.
+
 getRegister
 setRegister
+
    These follow standard conventions.
 
 getData
 setData
+
    These are unused since the TX and RX data registers can be accessed
    as regular registers.
 
+ulClock
 
+   This is either NULL or a pointer to a baud rate mapping table.  If
+   NULL, then the CSR/ACR/X bit mappings shown in the 68681 and 88681
+   manuals are used.  Otherwise, the board specific baud rate mapping
+   is used.
+
+ulIntVector
+
+   This is the interrupt vector number associated with this chip.
+