![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to hs CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [MW Coherent from dump] / coherent / a / usr / man / COHERENT|
Return to hs CVS log | Up to [MW Coherent from dump] / coherent / a / usr / man / COHERENT |
1.1 root 1:
2:
3: hs Device Driver hs
4:
5:
6:
7:
8: Device driver for polled serial ports
9:
10:
11: The COHERENT hhss driver adds support for up to eight serial lines,
12: /ddeevv/hhss0000 through /ddeevv/hhss0077.
13:
14: Serial lines controlled via the hhss driver can be opened in one of
15: two ways, as follows:
16:
17: /ddeevv/hhss??
18: Polled, local mode (no modem control).
19:
20: /ddeevv/hhss??rr
21: Polled, remote mode (modem control).
22:
23: Any port used with the hhss device driver will be polled, i.e.,
24: interrupt operation is not used. Please refer to the Lexicon
25: article ccoomm for explanations of ``local'' vs ``remote'' and
26: ``polled'' vs ``interrupt-driven''.
27:
28: To use the hhss driver, first configure it to match your equipment
29: (see below), then load the driver using the following command
30: while running as the superuser rroooott:
31:
32:
33: /etc/drvld -r /drv/hs
34:
35:
36: To unload the driver without rebooting COHERENT, first use the ppss
37: command with the -dd option to get the process identifier for the
38: hhss driver process, then unload the driver process by using the
39: kkiillll command. Note that the hhss driver process will not unload
40: until all ooppeenned ports have been closed. For example (user input
41: shown in bold):
42:
43:
44: $ ppss -dd
45: TTY PID
46: ------- 0 <idle>
47: ------- 38 <hs>
48: ...
49: $ kkiillll kkiillll 3388
50:
51:
52: The present version of COHERENT limits ``polled'' operation to
53: one device driver at a time. Therefore, if any of the ccoomm family
54: of devices is used in polled mode, hhss devices cannot be used.
55: Conversely, /ddeevv/ccoomm11ppll through /ddeevv/ccoomm44ppll and /ddeevv/ccoomm11pprr
56: through /ddeevv/ccoomm44pprr cannot be used if the hhss driver is in use.
57: Both drivers can be present at the same time, but polled devices
58: may not be ooppeenn under both drivers at the same time. Note that
59: enabling a port via /eettcc/eennaabbllee keeps it open continuously.
60:
61:
62:
63:
64: COHERENT Lexicon Page 1
65:
66:
67:
68:
69: hs Device Driver hs
70:
71:
72:
73: ***** Port Configuration *****
74:
75: The default configuration for the hhss driver is for four ports, at
76: hexadecimal addresses 0x3F8, 0x2F8, 0x3E8, and 0x2E8, at a speed
77: of 9600 baud. The driver is configured by setting the following
78: parameters:
79:
80: 11. The number of ports.
81:
82: 22. The I/O address for each port.
83:
84: 33. The default speed of each port.
85:
86: All steps in the configuration must be done as the superuser
87: rroooott. Patch the number of ports into driver variable HHSSNNUUMM_.
88: For example, if you wish to support three ports, enter:
89:
90:
91: /conf/patch /drv/hs HSNUM_=3
92:
93:
94: Address and speed information are stored sequentially starting at
95: variable HHSS_PPOORRTTSS_. The speed for each port is indicated by the
96: corresponding value found in <ssggttttyy.hh>, from one, corresponding
97: to 50 baud, to 16, corresponding to 9600 baud. If the three
98: ports in the example above are at hexadecimal adresses of 0x2A0,
99: 0x2B0, and 0x2C0, with speeds of 2400, 2400, and 9600 baud,
100: respectively, then the following three patches must be performed:
101:
102:
103: /conf/patch /drv/hs HS_PORTS_=0x2A0 HS_PORTS_+2=12
104: /conf/patch /drv/hs HS_PORTS_+4=0x2B0 HS_PORTS_+6=12
105: /conf/patch /drv/hs HS_PORTS_+8=0x2C0 HS_PORTS_+10=16
106:
107:
108: Finally, nodes must be created for each port using the mmkknnoodd
109: command. The major device number is 7; the minor number will
110: range from 0 through 7 for ports /ddeevv/hhss0000 through /ddeevv/hhss0077,
111: respectively, with 128 added to the device minor number if modem
112: control is desired. The following commands will make nodes in
113: /ddeevv for local and remote versions of the three ports in the
114: example:
115:
116:
117: /etc/mknod -f /dev/hs00 c 7 0
118: /etc/mknod -f /dev/hs01 c 7 1
119: /etc/mknod -f /dev/hs02 c 7 2
120: /etc/mknod -f /dev/hs00r c 7 128
121: /etc/mknod -f /dev/hs01r c 7 129
122: /etc/mknod -f /dev/hs02r c 7 130
123:
124:
125: ***** See Also ***** ccoomm, ddeevviiccee ddrriivveerrss, ddrrvvlldd
126:
127:
128:
129:
130: COHERENT Lexicon Page 2
131:
132:
133:
134:
135: hs Device Driver hs
136:
137:
138:
139: ***** Diagnostics *****
140:
141: An attempt to open a non-existent device will generate error
142: messages. This can occur if hardware is absent or not turned on.
143:
144: ***** Notes *****
145:
146: Note that if any ccoomm device driver is used in polling mode, the
147: hhss driver cannot be used, and vice versa.
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:
179:
180:
181:
182:
183:
184:
185:
186:
187:
188:
189:
190:
191:
192:
193:
194:
195:
196: COHERENT Lexicon Page 3
197:
198:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.