1*3fe1c122Sjmc.\" $OpenBSD: zs.4,v 1.18 2015/11/21 08:04:21 jmc Exp $ 2c22d9515Smiod.\" 3a16123a8Smiod.\" Copyright (c) 1998, 2002 The OpenBSD Project 4c22d9515Smiod.\" All rights reserved. 5c22d9515Smiod.\" 6c22d9515Smiod.\" 7*3fe1c122Sjmc.Dd $Mdocdate: November 21 2015 $ 8c22d9515Smiod.Dt ZS 4 sparc64 9c22d9515Smiod.Os 10c22d9515Smiod.Sh NAME 11*3fe1c122Sjmc.Nm zs , 12*3fe1c122Sjmc.Nm zstty , 13*3fe1c122Sjmc.Nm zskbd , 14*3fe1c122Sjmc.Nm zsms 15c22d9515Smiod.Nd Zilog 8530 (ZSCC) serial communications driver 16c22d9515Smiod.Sh SYNOPSIS 1737168bdeSjason.Cd "zs* at fhc?" 18afb7f3acSmickey.Cd "zs* at sbus?" 19afb7f3acSmickey.Cd "zstty* at zs?" 20afb7f3acSmickey.Cd "zskbd* at zs?" 21afb7f3acSmickey.Cd "wskbd* at zskbd?" 2219cddadbSmiod.Cd "zsms* at zs?" 2319cddadbSmiod.Cd "wsmouse* at zsms?" 24a16123a8Smiod.Cd "option SUNKBD_LAYOUT=XXX" 25a16123a8Smiod.Cd "option SUNKBD5_LAYOUT=XXX" 26c22d9515Smiod.Sh DESCRIPTION 27c22d9515SmiodThe 28c22d9515Smiod.Nm 2940f85256Sjmcis a Zilog 8530 serial interface chip used in SBus-based UltraSPARC 30c22d9515Smiod.Tn Sun 31c22d9515Smiodworkstations. 32c22d9515SmiodThe Zilog 8530 provides two input/output channels per instance. 33c22d9515SmiodMost 34c22d9515Smiod.Tn Sun 35c22d9515Smiodworkstations include two of these interfaces. 36c22d9515SmiodOne of the interfaces is usually hardwired for use by the keyboard and mouse 37c22d9515Smiodattached to the workstation console. 385fb62df1SjasonThe 395fb62df1Sjason.Nm zskbd 405fb62df1Sjasondevices connect keyboard devices to the generic keyboard driver 415fb62df1Sjason.Nm wskbd . 4219cddadbSmiodThe 4319cddadbSmiod.Nm zsms 4419cddadbSmioddevices connect mice to the generic mouse driver 45f46a76bfSjmc.Xr wsmouse 4 . 46c22d9515SmiodThe remaining additional 475fb62df1Sjason.Nm zs 48c22d9515Smiodinterfaces provide RS-423 49c22d9515Smiodand RS-232 serial ports for general purpose use. 50c22d9515Smiod.Pp 51c22d9515SmiodThe 52c22d9515Smiod.Nm 53c22d9515Smioddriver supports all of the standard 54c22d9515Smiod.Xr tty 4 55c22d9515Smiodioctl calls. 56c22d9515SmiodThe status of the DTR, RTS, CTS, and DCD signals can be queried with 57c22d9515SmiodTIOCMGET command, but, due to limitations in the hardware, 58c22d9515Smiodonly the DTR and RTS signals can be modified with TIOCMSET, TIOCMBIC, 59c22d9515Smiodand TIOCMBIS 60c22d9515Smiod.Xr ioctl 2 61c22d9515Smiodcommands. 62a16123a8Smiod.Pp 63c22d9515SmiodThe 64a16123a8Smiod.Nm zskbd 65a16123a8Smioddriver supports a number of different key mappings. 66a16123a8SmiodBy default, the layout corresponding to the keyboard model 67a16123a8Smiodas probed by the 68a16123a8Smiod.Nm zskbd 69a16123a8Smioddriver will be used. 70a16123a8SmiodA different layout can be chosen either with the kernel options 71a16123a8Smiod.Dq SUNKBD_LAYOUT 72a16123a8Smiod(for type 4 keyboards) 73a16123a8Smiodand 74a16123a8Smiod.Dq SUNKBD5_LAYOUT 75a16123a8Smiod(for type 5 keyboards) 76a16123a8Smiodat compile time or with the utility 77a16123a8Smiod.Xr wsconsctl 8 78a16123a8Smiod(variable: 79c2932742Sjmc.Dq keyboard.encoding ) 80c2932742Sjmcat runtime. 81a16123a8Smiod.Pp 82a16123a8SmiodOther mappings can be used if the whole keymap is replaced by means of 83a16123a8Smiod.Xr wsconsctl 8 . 84a16123a8SmiodThe built-in mappings are at this time: 85c2932742Sjmc.Pp 86c2932742Sjmc.Bl -tag -width Ds -offset indent -compact 87a16123a8Smiod.It KB_BE 88c2932742Sjmc.Pq be 89c2932742SjmcBelgium French (type 4 only). 90a16123a8Smiod.It KB_DE 91c2932742Sjmc.Pq de 92c2932742SjmcGerman. 93a16123a8Smiod.It KB_DK 94c2932742Sjmc.Pq dk 95c2932742SjmcDanish. 96a16123a8Smiod.It KB_ES 97c2932742Sjmc.Pq es 98c2932742SjmcSpanish. 99a16123a8Smiod.It KB_FR 100c2932742Sjmc.Pq fr 101c2932742SjmcFrench (type 5 only). 102a16123a8Smiod.It KB_IT 103c2932742Sjmc.Pq it 104c2932742SjmcItalian. 1055d293618Smiod.It KB_JP 106c2932742Sjmc.Pq jp 107c2932742SjmcJapanese (type 5 only). 108a16123a8Smiod.It KB_NL 109c2932742Sjmc.Pq \&nl 110c2932742SjmcDutch. 111a16123a8Smiod.It KB_NO 112c2932742Sjmc.Pq no 113c2932742SjmcNorwegian. 114a16123a8Smiod.It KB_PT 115c2932742Sjmc.Pq pt 116c2932742SjmcPortuguese. 117a16123a8Smiod.It KB_SF 118c2932742Sjmc.Pq sf 119c2932742SjmcSwiss French. 120a16123a8Smiod.It KB_SG 121c2932742Sjmc.Pq sg 122c2932742SjmcSwiss German. 123a16123a8Smiod.It KB_SV 124c2932742Sjmc.Pq sv 125c2932742SjmcSwedish with 126a16123a8Smiod.Dq dead accents . 127a16123a8Smiod.It KB_UK 128c2932742Sjmc.Pq uk 129c2932742SjmcBritish. 130a16123a8Smiod.It KB_US 131c2932742Sjmc.Pq us 132c2932742SjmcEnglish/US keyboard mapping. 133a16123a8Smiod.El 134a16123a8Smiod.Pp 135a16123a8SmiodThe KB_SV mapping can be used in 136c2932742Sjmcthe KB_NODEAD 137c2932742Sjmc.Pq .nodead 138c2932742Sjmcvariant. 139a16123a8SmiodThis switches off the 140a16123a8Smiod.Dq dead accents . 141a16123a8Smiod.Sh EXAMPLES 142273bf991SjmcTo set a German keyboard layout, use 14349f728abSjmc.Ic wsconsctl keyboard.encoding=de . 144a16123a8SmiodTo set it at kernel build time, add 14577d166aeSjmcthe following to the kernel configuration file for a type 4 keyboard: 14677d166aeSjmc.Bd -literal -offset indent 14777d166aeSjmcoption SUNKBD_LAYOUT="KB_DE" 14877d166aeSjmc.Ed 14977d166aeSjmc.Pp 15077d166aeSjmcFor a type 5 keyboard: 15177d166aeSjmc.Bd -literal -offset indent 15277d166aeSjmcoption SUNKBD5_LAYOUT="KB_DE" 15377d166aeSjmc.Ed 154c22d9515Smiod.Sh SEE ALSO 155c22d9515Smiod.Xr ioctl 2 , 15637168bdeSjason.Xr fhc 4 , 1579cf9dc59Smiod.Xr intro 4 , 15817ab3eb8Sjason.Xr sbus 4 , 159a35b76abSjason.Xr tty 4 , 160a16123a8Smiod.Xr wskbd 4 , 16119cddadbSmiod.Xr wsmouse 4 , 162a16123a8Smiod.Xr wsconsctl 8 163c22d9515Smiod.Sh HISTORY 164c22d9515SmiodThe 165c22d9515Smiod.Nm 166c22d9515Smioddriver first appeared in 167c22d9515Smiod.Bx 4.4 . 168c22d9515SmiodSupport for the TIOCM* 169c22d9515Smiod.Xr ioctl 2 Ns s 170c22d9515Smiodappeared in 171c22d9515Smiod.Ox 2.3 . 172a16123a8Smiod.Sh BUGS 173a16123a8SmiodThe 174a16123a8Smiod.Nm 175a16123a8Smioddriver now supports cua minor devices, but with this known deficiency 176a16123a8Smiodin the simultaneous outgoing/incoming aspect of the driver: 177a16123a8SmiodThe first outgoing connection succeeds, but second and subsequent 178a16123a8Smiodconnections fail, apparently due to a getty hang. 179a16123a8SmiodThe hung getty apparently prevents the cua device from being re-opened. 180a16123a8Smiod.Pp 1815d293618SmiodThe kernel does not provide a keyboard layout for all manufactured 1825d293618Smiod.Tn Sun 183a16123a8Smiodkeyboard models. 184