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