1*c2932742Sjmc.\" $OpenBSD: zs.4,v 1.13 2006/11/07 16:01:36 jmc Exp $ 2c22d9515Smiod.\" 3a16123a8Smiod.\" Copyright (c) 1998, 2002 The OpenBSD Project 4c22d9515Smiod.\" All rights reserved. 5c22d9515Smiod.\" 6c22d9515Smiod.\" 7a16123a8Smiod.Dd December 3, 2002 8c22d9515Smiod.Dt ZS 4 sparc64 9c22d9515Smiod.Os 10c22d9515Smiod.Sh NAME 11c22d9515Smiod.Nm zs 12c22d9515Smiod.Nd Zilog 8530 (ZSCC) serial communications driver 13c22d9515Smiod.Sh SYNOPSIS 1437168bdeSjason.Cd "zs* at fhc?" 15afb7f3acSmickey.Cd "zs* at sbus?" 16afb7f3acSmickey.Cd "zstty* at zs?" 17afb7f3acSmickey.Cd "zskbd* at zs?" 18afb7f3acSmickey.Cd "wskbd* at zskbd?" 19a16123a8Smiod.Cd "option SUNKBD_LAYOUT=XXX" 20a16123a8Smiod.Cd "option SUNKBD5_LAYOUT=XXX" 21c22d9515Smiod.Sh DESCRIPTION 22c22d9515SmiodThe 23c22d9515Smiod.Nm 2440f85256Sjmcis a Zilog 8530 serial interface chip used in SBus-based UltraSPARC 25c22d9515Smiod.Tn Sun 26c22d9515Smiodworkstations. 27c22d9515SmiodThe Zilog 8530 provides two input/output channels per instance. 28c22d9515SmiodMost 29c22d9515Smiod.Tn Sun 30c22d9515Smiodworkstations include two of these interfaces. 31c22d9515SmiodOne of the interfaces is usually hardwired for use by the keyboard and mouse 32c22d9515Smiodattached to the workstation console. 335fb62df1SjasonThe 345fb62df1Sjason.Nm zskbd 355fb62df1Sjasondevices connect keyboard devices to the generic keyboard driver 365fb62df1Sjason.Nm wskbd . 37c22d9515SmiodThe remaining additional 385fb62df1Sjason.Nm zs 39c22d9515Smiodinterfaces provide RS-423 40c22d9515Smiodand RS-232 serial ports for general purpose use. 41c22d9515Smiod.Pp 42c22d9515SmiodThe 43c22d9515Smiod.Nm 44c22d9515Smioddriver supports all of the standard 45c22d9515Smiod.Xr tty 4 46c22d9515Smiodioctl calls. 47c22d9515SmiodThe status of the DTR, RTS, CTS, and DCD signals can be queried with 48c22d9515SmiodTIOCMGET command, but, due to limitations in the hardware, 49c22d9515Smiodonly the DTR and RTS signals can be modified with TIOCMSET, TIOCMBIC, 50c22d9515Smiodand TIOCMBIS 51c22d9515Smiod.Xr ioctl 2 52c22d9515Smiodcommands. 53a16123a8Smiod.Pp 54c22d9515SmiodThe 55a16123a8Smiod.Nm zskbd 56a16123a8Smioddriver supports a number of different key mappings. 57a16123a8SmiodBy default, the layout corresponding to the keyboard model 58a16123a8Smiodas probed by the 59a16123a8Smiod.Nm zskbd 60a16123a8Smioddriver will be used. 61a16123a8SmiodA different layout can be chosen either with the kernel options 62a16123a8Smiod.Dq SUNKBD_LAYOUT 63a16123a8Smiod(for type 4 keyboards) 64a16123a8Smiodand 65a16123a8Smiod.Dq SUNKBD5_LAYOUT 66a16123a8Smiod(for type 5 keyboards) 67a16123a8Smiodat compile time or with the utility 68a16123a8Smiod.Xr wsconsctl 8 69a16123a8Smiod(variable: 70*c2932742Sjmc.Dq keyboard.encoding ) 71*c2932742Sjmcat runtime. 72a16123a8Smiod.Pp 73a16123a8SmiodOther mappings can be used if the whole keymap is replaced by means of 74a16123a8Smiod.Xr wsconsctl 8 . 75a16123a8SmiodThe built-in mappings are at this time: 76*c2932742Sjmc.Pp 77*c2932742Sjmc.Bl -tag -width Ds -offset indent -compact 78a16123a8Smiod.It KB_BE 79*c2932742Sjmc.Pq be 80*c2932742SjmcBelgium French (type 4 only). 81a16123a8Smiod.It KB_DE 82*c2932742Sjmc.Pq de 83*c2932742SjmcGerman. 84a16123a8Smiod.It KB_DK 85*c2932742Sjmc.Pq dk 86*c2932742SjmcDanish. 87a16123a8Smiod.It KB_ES 88*c2932742Sjmc.Pq es 89*c2932742SjmcSpanish. 90a16123a8Smiod.It KB_FR 91*c2932742Sjmc.Pq fr 92*c2932742SjmcFrench (type 5 only). 93a16123a8Smiod.It KB_IT 94*c2932742Sjmc.Pq it 95*c2932742SjmcItalian. 965d293618Smiod.It KB_JP 97*c2932742Sjmc.Pq jp 98*c2932742SjmcJapanese (type 5 only). 99a16123a8Smiod.It KB_NL 100*c2932742Sjmc.Pq \&nl 101*c2932742SjmcDutch. 102a16123a8Smiod.It KB_NO 103*c2932742Sjmc.Pq no 104*c2932742SjmcNorwegian. 105a16123a8Smiod.It KB_PT 106*c2932742Sjmc.Pq pt 107*c2932742SjmcPortuguese. 108a16123a8Smiod.It KB_SF 109*c2932742Sjmc.Pq sf 110*c2932742SjmcSwiss French. 111a16123a8Smiod.It KB_SG 112*c2932742Sjmc.Pq sg 113*c2932742SjmcSwiss German. 114a16123a8Smiod.It KB_SV 115*c2932742Sjmc.Pq sv 116*c2932742SjmcSwedish with 117a16123a8Smiod.Dq dead accents . 118a16123a8Smiod.It KB_UK 119*c2932742Sjmc.Pq uk 120*c2932742SjmcBritish. 121a16123a8Smiod.It KB_US 122*c2932742Sjmc.Pq us 123*c2932742SjmcEnglish/US keyboard mapping. 124a16123a8Smiod.El 125a16123a8Smiod.Pp 126a16123a8SmiodThe KB_SV mapping can be used in 127*c2932742Sjmcthe KB_NODEAD 128*c2932742Sjmc.Pq .nodead 129*c2932742Sjmcvariant. 130a16123a8SmiodThis switches off the 131a16123a8Smiod.Dq dead accents . 132a16123a8Smiod.Sh EXAMPLES 133273bf991SjmcTo set a German keyboard layout, use 134a16123a8Smiod.Ic wsconsctl -w keyboard.encoding=de . 135a16123a8SmiodTo set it at kernel build time, add 13677d166aeSjmcthe following to the kernel configuration file for a type 4 keyboard: 13777d166aeSjmc.Bd -literal -offset indent 13877d166aeSjmcoption SUNKBD_LAYOUT="KB_DE" 13977d166aeSjmc.Ed 14077d166aeSjmc.Pp 14177d166aeSjmcFor a type 5 keyboard: 14277d166aeSjmc.Bd -literal -offset indent 14377d166aeSjmcoption SUNKBD5_LAYOUT="KB_DE" 14477d166aeSjmc.Ed 145c22d9515Smiod.Sh SEE ALSO 146c22d9515Smiod.Xr ioctl 2 , 14737168bdeSjason.Xr fhc 4 , 1489cf9dc59Smiod.Xr intro 4 , 14917ab3eb8Sjason.Xr sbus 4 , 150a35b76abSjason.Xr tty 4 , 151a16123a8Smiod.Xr wskbd 4 , 152a16123a8Smiod.Xr wsconsctl 8 153c22d9515Smiod.Sh HISTORY 154c22d9515SmiodThe 155c22d9515Smiod.Nm 156c22d9515Smioddriver first appeared in 157c22d9515Smiod.Bx 4.4 . 158c22d9515SmiodSupport for the TIOCM* 159c22d9515Smiod.Xr ioctl 2 Ns s 160c22d9515Smiodappeared in 161c22d9515Smiod.Ox 2.3 . 162a16123a8Smiod.Sh BUGS 163a16123a8SmiodThe 164a16123a8Smiod.Nm 165a16123a8Smioddriver now supports cua minor devices, but with this known deficiency 166a16123a8Smiodin the simultaneous outgoing/incoming aspect of the driver: 167a16123a8SmiodThe first outgoing connection succeeds, but second and subsequent 168a16123a8Smiodconnections fail, apparently due to a getty hang. 169a16123a8SmiodThe hung getty apparently prevents the cua device from being re-opened. 170a16123a8Smiod.Pp 1715d293618SmiodThe kernel does not provide a keyboard layout for all manufactured 1725d293618Smiod.Tn Sun 173a16123a8Smiodkeyboard models. 174