1.\" $OpenBSD: zs.4,v 1.17 2011/01/30 07:53:57 jmc Exp $ 2.\" 3.\" Copyright (c) 1998, 2002 The OpenBSD Project 4.\" All rights reserved. 5.\" 6.\" 7.Dd $Mdocdate: January 30 2011 $ 8.Dt ZS 4 sparc64 9.Os 10.Sh NAME 11.Nm zs 12.Nd Zilog 8530 (ZSCC) serial communications driver 13.Sh SYNOPSIS 14.Cd "zs* at fhc?" 15.Cd "zs* at sbus?" 16.Cd "zstty* at zs?" 17.Cd "zskbd* at zs?" 18.Cd "wskbd* at zskbd?" 19.Cd "zsms* at zs?" 20.Cd "wsmouse* at zsms?" 21.Cd "option SUNKBD_LAYOUT=XXX" 22.Cd "option SUNKBD5_LAYOUT=XXX" 23.Sh DESCRIPTION 24The 25.Nm 26is a Zilog 8530 serial interface chip used in SBus-based UltraSPARC 27.Tn Sun 28workstations. 29The Zilog 8530 provides two input/output channels per instance. 30Most 31.Tn Sun 32workstations include two of these interfaces. 33One of the interfaces is usually hardwired for use by the keyboard and mouse 34attached to the workstation console. 35The 36.Nm zskbd 37devices connect keyboard devices to the generic keyboard driver 38.Nm wskbd . 39The 40.Nm zsms 41devices connect mice to the generic mouse driver 42.Xr wsmouse 4 . 43The remaining additional 44.Nm zs 45interfaces provide RS-423 46and RS-232 serial ports for general purpose use. 47.Pp 48The 49.Nm 50driver supports all of the standard 51.Xr tty 4 52ioctl calls. 53The status of the DTR, RTS, CTS, and DCD signals can be queried with 54TIOCMGET command, but, due to limitations in the hardware, 55only the DTR and RTS signals can be modified with TIOCMSET, TIOCMBIC, 56and TIOCMBIS 57.Xr ioctl 2 58commands. 59.Pp 60The 61.Nm zskbd 62driver supports a number of different key mappings. 63By default, the layout corresponding to the keyboard model 64as probed by the 65.Nm zskbd 66driver will be used. 67A different layout can be chosen either with the kernel options 68.Dq SUNKBD_LAYOUT 69(for type 4 keyboards) 70and 71.Dq SUNKBD5_LAYOUT 72(for type 5 keyboards) 73at compile time or with the utility 74.Xr wsconsctl 8 75(variable: 76.Dq keyboard.encoding ) 77at runtime. 78.Pp 79Other mappings can be used if the whole keymap is replaced by means of 80.Xr wsconsctl 8 . 81The built-in mappings are at this time: 82.Pp 83.Bl -tag -width Ds -offset indent -compact 84.It KB_BE 85.Pq be 86Belgium French (type 4 only). 87.It KB_DE 88.Pq de 89German. 90.It KB_DK 91.Pq dk 92Danish. 93.It KB_ES 94.Pq es 95Spanish. 96.It KB_FR 97.Pq fr 98French (type 5 only). 99.It KB_IT 100.Pq it 101Italian. 102.It KB_JP 103.Pq jp 104Japanese (type 5 only). 105.It KB_NL 106.Pq \&nl 107Dutch. 108.It KB_NO 109.Pq no 110Norwegian. 111.It KB_PT 112.Pq pt 113Portuguese. 114.It KB_SF 115.Pq sf 116Swiss French. 117.It KB_SG 118.Pq sg 119Swiss German. 120.It KB_SV 121.Pq sv 122Swedish with 123.Dq dead accents . 124.It KB_UK 125.Pq uk 126British. 127.It KB_US 128.Pq us 129English/US keyboard mapping. 130.El 131.Pp 132The KB_SV mapping can be used in 133the KB_NODEAD 134.Pq .nodead 135variant. 136This switches off the 137.Dq dead accents . 138.Sh EXAMPLES 139To set a German keyboard layout, use 140.Ic wsconsctl keyboard.encoding=de . 141To set it at kernel build time, add 142the following to the kernel configuration file for a type 4 keyboard: 143.Bd -literal -offset indent 144option SUNKBD_LAYOUT="KB_DE" 145.Ed 146.Pp 147For a type 5 keyboard: 148.Bd -literal -offset indent 149option SUNKBD5_LAYOUT="KB_DE" 150.Ed 151.Sh SEE ALSO 152.Xr ioctl 2 , 153.Xr fhc 4 , 154.Xr intro 4 , 155.Xr sbus 4 , 156.Xr tty 4 , 157.Xr wskbd 4 , 158.Xr wsmouse 4 , 159.Xr wsconsctl 8 160.Sh HISTORY 161The 162.Nm 163driver first appeared in 164.Bx 4.4 . 165Support for the TIOCM* 166.Xr ioctl 2 Ns s 167appeared in 168.Ox 2.3 . 169.Sh BUGS 170The 171.Nm 172driver now supports cua minor devices, but with this known deficiency 173in the simultaneous outgoing/incoming aspect of the driver: 174The first outgoing connection succeeds, but second and subsequent 175connections fail, apparently due to a getty hang. 176The hung getty apparently prevents the cua device from being re-opened. 177.Pp 178The kernel does not provide a keyboard layout for all manufactured 179.Tn Sun 180keyboard models. 181