NAME    [Toc]    [Back]

     zs - Zilog 8530 (ZSCC) serial communications driver

SYNOPSIS    [Toc]    [Back]

     zs* at sbus? slot ? offset ?
     zstty* at zs? channel ?
     zskbd* at zs? channel ?
     wskbd* at zskbd? console ?
     option SUNKBD_LAYOUT=XXX
     option SUNKBD5_LAYOUT=XXX

DESCRIPTION    [Toc]    [Back]

     The zs is a Zilog 8530 serial interface chip used  in  SBusbased UltraSPARC
  Sun  workstations.   The  Zilog 8530 provides two input/output channels
 per instance.  Most Sun  workstations  include  two  of
these interfaces.
   One  of the interfaces is usually hardwired for use
by the keyboard
 and mouse attached to the  workstation  console.   The
zskbd devices
     connect  keyboard  devices  to  the  generic keyboard driver
wskbd.  The remaining
 additional zs interfaces provide RS-423  and  RS-232
serial ports
     for general purpose use.

     The  zs  driver  supports  all  of the standard tty(4) ioctl
calls.  The status
 of the DTR, RTS, CTS, and DCD  signals  can  be  queried
with TIOCMGET
     command,  but,  due to limitations in the hardware, only the
DTR and RTS
     signals can be modified with TIOCMSET, TIOCMBIC, and  TIOCMBIS ioctl(2)
     commands.

     The  zskbd  driver  supports  a number of different key mappings.  By default,
 the layout corresponding to  the  keyboard  model  as
probed by the
     zskbd driver will be used.  A different layout can be chosen
either with
     the kernel options ``SUNKBD_LAYOUT'' (for type 4  keyboards)
and
     ``SUNKBD5_LAYOUT'' (for type 5 keyboards) at compile time or
with the
     utility wsconsctl(8) (variable: ``keyboard.encoding''  )  at
runtime.

     Other  mappings  can be used if the whole keymap is replaced
by means of
     wsconsctl(8).  The built-in mappings are at this time:

     KB_BE   ( ``be'' ) Belgium French (type 4 only).

     KB_DE   ( ``de'' ) German.

     KB_DK   ( ``dk'' ) Danish.

     KB_ES   ( ``es'' ) Spanish.

     KB_FR   ( ``fr'' ) French (type 5 only).

     KB_IT   ( ``it'' ) Italian.

     KB_JP   ( ``jp'' ) Japanese (type 5 only).

     KB_NL   ( ``nl'' ) Dutch.

     KB_NO   ( ``no'' ) Norwegian.

     KB_PT   ( ``pt'' ) Portuguese.

     KB_SF   ( ``sf'' ) Swiss French.

     KB_SG   ( ``sg'' ) Swiss German.

     KB_SV   ( ``sv'' ) Swedish with ``dead accents''.

     KB_UK   ( ``uk'' ) British.

     KB_US   ( ``us'' ) English / US keyboard mapping.

     The KB_SV mapping can be used in the KB_NODEAD ( ``.nodead''
) variant.
     This switches off the ``dead accents''.

EXAMPLES    [Toc]    [Back]

     To   set   a   German  keyboard  layout,  use  wsconsctl  -w
keyboard.encoding=de.
     To   set   it   at   kernel   build   time,    add    option
SUNKBD_LAYOUT="KB_DE" to the
     kernel configuration file for a type 4 keyboard, or option
     SUNKBD5_LAYOUT="KB_DE" for a type 5 keyboard.

SEE ALSO    [Toc]    [Back]

     ioctl(2), intro(4), sbus(4), tty(4), wskbd(4), wsconsctl(8)

HISTORY    [Toc]    [Back]

     The zs driver first appeared in 4.4BSD.  Support for the TIOCM* ioctl(2)s
     appeared in OpenBSD 2.3.

BUGS    [Toc]    [Back]

     The zs driver now supports cua minor devices, but with  this
known deficiency
  in  the simultaneous outgoing/incoming aspect of the
driver: The
     first outgoing connection succeeds, but  second  and  subsequent connections
     fail, apparently due to a getty hang.  The hung getty apparently prevents
     the cua device from being re-opened.

     The kernel does not provide a keyboard layout for all  manufactured Sun
     keyboard models.

OpenBSD      3.6                         December     3,     2002