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