1.\" $OpenBSD: zs.4,v 1.9 2003/05/05 13:51:58 jmc Exp $ 2.\" 3.\" Copyright (c) 1998, 2002 The OpenBSD Project 4.\" All rights reserved. 5.\" 6.\" 7.Dd December 3, 2002 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 sbus? slot ? offset ?" 15.Cd "zstty* at zs? channel ?" 16.Cd "zskbd* at zs? channel ?" 17.Cd "wskbd* at zskbd? console ?" 18.Cd "option SUNKBD_LAYOUT=XXX" 19.Cd "option SUNKBD5_LAYOUT=XXX" 20.Sh DESCRIPTION 21The 22.Nm 23is a Zilog 8530 serial interface chip used in SBus-based UltraSPARC 24.Tn Sun 25workstations. 26The Zilog 8530 provides two input/output channels per instance. 27Most 28.Tn Sun 29workstations include two of these interfaces. 30One of the interfaces is usually hardwired for use by the keyboard and mouse 31attached to the workstation console. 32The 33.Nm zskbd 34devices connect keyboard devices to the generic keyboard driver 35.Nm wskbd . 36The remaining additional 37.Nm zs 38interfaces provide RS-423 39and RS-232 serial ports for general purpose use. 40.Pp 41The 42.Nm 43driver supports all of the standard 44.Xr tty 4 45ioctl calls. 46The status of the DTR, RTS, CTS, and DCD signals can be queried with 47TIOCMGET command, but, due to limitations in the hardware, 48only the DTR and RTS signals can be modified with TIOCMSET, TIOCMBIC, 49and TIOCMBIS 50.Xr ioctl 2 51commands. 52.Pp 53The 54.Nm zskbd 55driver supports a number of different key mappings. 56By default, the layout corresponding to the keyboard model 57as probed by the 58.Nm zskbd 59driver will be used. 60A different layout can be chosen either with the kernel options 61.Dq SUNKBD_LAYOUT 62(for type 4 keyboards) 63and 64.Dq SUNKBD5_LAYOUT 65(for type 5 keyboards) 66at compile time or with the utility 67.Xr wsconsctl 8 68(variable: 69.Dq keyboard.encoding 70) at runtime. 71.Pp 72Other mappings can be used if the whole keymap is replaced by means of 73.Xr wsconsctl 8 . 74The built-in mappings are at this time: 75.Bl -hang 76.It KB_BE 77( 78.Dq be 79) Belgium French (type 4 only). 80.It KB_DE 81( 82.Dq de 83) German. 84.It KB_DK 85( 86.Dq dk 87) Danish. 88.It KB_ES 89( 90.Dq es 91) Spanish. 92.It KB_FR 93( 94.Dq fr 95) French (type 5 only). 96.It KB_IT 97( 98.Dq it 99) Italian. 100.It KB_JP 101( 102.Dq jp 103) Japanese (type 5 only). 104.It KB_NL 105( 106.Dq \&nl 107) Dutch. 108.It KB_NO 109( 110.Dq no 111) Norwegian. 112.It KB_PT 113( 114.Dq pt 115) Portuguese. 116.It KB_SF 117( 118.Dq sf 119) Swiss French. 120.It KB_SG 121( 122.Dq sg 123) Swiss German. 124.It KB_SV 125( 126.Dq sv 127) Swedish with 128.Dq dead accents . 129.It KB_UK 130( 131.Dq uk 132) British. 133.It KB_US 134( 135.Dq us 136) English / US keyboard mapping. 137.El 138.Pp 139The KB_SV mapping can be used in 140the KB_NODEAD ( 141.Dq .nodead 142) variant. 143This switches off the 144.Dq dead accents . 145.Sh EXAMPLES 146To set a German keyboard layout, use 147.Ic wsconsctl -w keyboard.encoding=de . 148To set it at kernel build time, add 149.Em option SUNKBD_LAYOUT="KB_DE" 150to the kernel configuration file for a type 4 keyboard, or 151.Em option SUNKBD5_LAYOUT="KB_DE" 152for a type 5 keyboard. 153.Sh SEE ALSO 154.Xr ioctl 2 , 155.Xr intro 4 , 156.Xr sbus 4 , 157.Xr tty 4 , 158.Xr wskbd 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