1.TH Cronyx-Sigma 1
2.rm ES
3.rm EE
4.de ES
5.PP
6.nf
7.in +0.5i
8..
9.de EE
10.in -0.5i
11.fi
12..
13.na
14.SH NAME
15.B cx
16\- asynchronous Cronyx-Sigma adapter driver
17.br
18.B if_cx
19\- synchronous Cronyx-Sigma adapter driver
20.SH CONFIGURATION
21.B
22device cx0 at isa? port 0x240 irq 15 drq 7
23.br
24.B
25device cx1 at isa? port 0x260 irq 12 drq 6
26.br
27.B
28pseudo-device sppp
29.P
30The base i/o port address should be set by jumpers on the board.
31The DMA i/o channel and interrupt request numbers are configured
32by software at adapter initialization. Legal values are:
33.IP Port
340x240, 0x260, 0x280, 0x300, 0x320, 0x380
35.IP IRQ
363, 5, 7, 10, 11, 12, 15
37.IP DMA
385, 6, 7
39.SH DESCRIPTION
40.PP
41The Cronyx-Sigma driver supports the adapters of models 100,
42400, 500, 401, 404, 410, 440, 703, 801, 810, 840. Different models have
43different set of channels:
44.ES
45 Model Channels
46----------------------------------------------
47 Cronyx-Sigma-100 0
48 Cronyx-Sigma-400 4, 5, 6, 7
49 Cronyx-Sigma-500 0, 4, 5, 6, 7
50 Cronyx-Sigma-401 0, 1, 2, 3
51 Cronyx-Sigma-404 0, 1, 2, 3
52 Cronyx-Sigma-410 0, 1, 2, 3
53 Cronyx-Sigma-440 0, 1, 2, 3
54 Cronyx-Sigma-703 0, 1, 2, 4, 5, 6, 7
55 Cronyx-Sigma-801 0, 1, 2, 3, 4, 5, 6, 7
56 Cronyx-Sigma-810 0, 1, 2, 3, 4, 5, 6, 7
57 Cronyx-Sigma-840 0, 1, 2, 3, 4, 5, 6, 7
58.EE
59.PP
60A pair of two adapters can be united together by the special
61short inter-board cable. Two united adapters use the same
62IRQ and DMA channels and from the point of driver works
63as the single 16-channel multiplexer. One of the united
64boards is ``master'' and the other is ``slave''.
65.PP
66The channels of the slave united board are numbered by the driver
67beginning with 8, for example, the united adapter of the model 100/500
68has channels 0, 8, 12, 13, 14, 15.
69.PP
70The channels which have the RS-232 interface can be used
71both in synchronous and asynchronous modes (software selectable
72by cxconfig utility) and hence are called ``universal'' channels.
73.PP
74The special device files (/dev/*) for the adapter Cronyx-Sigma
75are created by the command file ``/dev/MAKEDEV.cx''.
76An example:
77.ES
78cd /dev
79sh MAKEDEV.cx cronyx ttyx0 ttyx1 ttyy0
80.EE
81.SH "Asynchronous driver"
82.PP
83The asynchronous channel device files have the names:
84/dev/ttyx# - for adapter cx0, /dev/ttyy# - for adapter cx1,
85/dev/ttyz# - for cx2.
86Here\ # is the channel number in hexadecimal form, 0-9-a-f.
87.PP
88The driver fulfills the following standard ioctl requests (see ioctl(2)):
89.IP TIOCSBRK
90Start sending BREAK.
91.IP TIOCCBRK
92Stop sending BREAK.
93.IP TIOCSDTR
94Set DTR signal (DTR := 1). The DTR signal is always set
95on the first open(2) and could be changed by
96TIOCCDTR, TIOCSDTR, TIOCMSET, TIOCMBIS, TIOCMBIC ioctl calls.
97.IP TIOCCDTR
98Clear DTR signal (DTR := 0).
99.IP TIOCMSET
100Set the given values of DTR and RTS signals (<DTR:RTS> := data).
101The signals DTR and RTS are controlled by TIOCM_DTR and TIOCM_RTS
102bits of the data argument of the ioctl system call.
103.IP TIOCMBIS
104Set DTR and RTS signals (<DTR:RTS> |= data).
105The signals DTR and RTS are controlled by TIOCM_DTR and TIOCM_RTS
106bits of the data argument of the ioctl system call.
107.IP TIOCMBIC
108Clear DTR and RTS signals (<DTR:RTS> &= ~data).
109The signals DTR and RTS are controlled by TIOCM_DTR and TIOCM_RTS
110bits of the data argument of the ioctl system call.
111.IP TIOCMGET
112Determine the state of the modem signals of the line.
113After the call the data argument contains the following bits:
114.ES
115TIOCM_LE - always set (Line Enabled)
116TIOCM_DSR - Data Set Ready signal received
117TIOCM_CTS - Clear To Send signal received
118TIOCM_CD - Data Carrier Detect signal received
119TIOCM_DTR - Data Terminal Ready signal transmitted
120TIOCM_RTS - Request To Send signal transmitted
121.EE
122.SH "Synchronous driver"
123.PP
124The synchronous channels and universal channels, turned to the synchronous
125mode by the cxconfig(8) utility, are accessible as network
126interfaces named ``cx#'' where\ # is the channel number, 0..47.
127All standard network interface parameters could be set by ifconfig(8) utility.
128The cxconfig(8) command is used to change some extended channel
129options, and also for setting the high-level software protocol
130(e.g. PPP or Cisco HDLC).
131.PP
132The universal channels could be used both in asynchronous and synchronous modes.
133By default the asynchronous mode is set.
134The mode could be changed by cxconfig(8) utility.
135The mode is blocked while the channel is busy (an asynchronous channel
136in open state or the network interface is up).
137.SH "Synchronous Point-to-Point protocol"
138.PP
139The Cronyx-Sigma driver uses the built-in implementation of the synchronous
140Point-to-Point protocol (sppp). It includes the support for such
141protocols as PPP/HDLC and Cisco/HDLC, and also the automatic
142connection loss test (via keepalive packets).
143The sppp protocol set is implemented as an independent module
144and could be used by other drivers of synchronous serial channels.
145The version of the driver for BSD/386 (BSDI) operating system
146also supports the usage of the general set of synchronous
147protocols, implemented inside the OS.
148The external protocol set could be selected by ``cxconfig ext'' command
149(see cxconfig(8)).
150.SH "Channel Options Management"
151.PP
152The cxconfig(8) utility is used for setting the channels options.
153The channel options are generally set at the start of the operating
154system (for example, from the file /etc/rc).
155Note, that not all options have a sense for every particular
156case, and an attempt to set some of them can hang up the channel or
157the whole adapter.
158.PP
159The actual channel options control functions are implemented via
160the ioctl-s on the special device file /dev/cronyx.
161There are the following ioctl-s available:
162.IP CXIOCGETMODE
163Get the channel option values.
164.IP CXIOCSETMODE
165Set the channel option values.
166.PP
167The data argument of the ioctl call has an address of the options structure:
168.ES
169typedef struct {
170 unsigned char board; /* adapter number, 0..2 */
171 unsigned char channel; /* channel number, 0..15 */
172 unsigned char type; /* channel type (read only) */
173 unsigned char iftype; /* chan0 interface */
174 unsigned long rxbaud; /* receiver speed */
175 unsigned long txbaud; /* transmitter speed */
176 cx_chan_mode_t mode; /* channel mode */
177 cx_chan_opt_t opt; /* common channel options */
178 cx_opt_async_t aopt; /* async mode options */
179 cx_opt_hdlc_t hopt; /* hdlc mode options */
180 cx_opt_bisync_t bopt; /* bisync mode options */
181 cx_opt_x21_t xopt; /* x.21 mode options */
182 cx_soft_opt_t sopt; /* software options and state flags */
183} cx_options_t; /* user settable options */
184.EE
185.IP board
186The adapter number, 0..2.
187.IP channel
188The channel number, 0..15.
189.IP type
190The type of the channel (read-only argument).
191.IP iftype
192The interface type of the zero (and also the eight) channel: 0 - RS-232,
1931 - RS-449/V.35.
194.IP rxbaud
195The receiver data baud rate.
196.IP txbaud
197The transmitter data baud rate.
198.IP mode
199The channel mode: asynchronous/HDLC/Bisync/X.21.
200.IP opt
201The general channel options.
202.IP aopt
203The asynchronous mode options.
204.IP hopt
205The HDLC mode options.
206.IP bopt
207The Bisync mode options.
208.IP xopt
209The X.21 mode options.
210.IP sopt
211The software protocol options.
212.SH FILES
213.PP
214/dev/cx??
215.IP
216Asynchronous channels.
217.PP
218/dev/cronyx
219.IP
220The special device file for the channel options management.
221.PP
222/sys/i386/isa/cronyx.c
223.br
224/sys/i386/isa/cx.c
225.br
226/sys/i386/isa/if_cx.c
227.br
228/sys/i386/isa/cronyx.h
229.br
230/sys/i386/isa/cxreg.h
231.br
232/sys/net/if_spppsubr.c
233.br
234/sys/net/if_sppp.h
235.IP
236The sources of the driver.
237.SH SEE ALSO
238.PP
239cxconfig(8)
2.rm ES
3.rm EE
4.de ES
5.PP
6.nf
7.in +0.5i
8..
9.de EE
10.in -0.5i
11.fi
12..
13.na
14.SH NAME
15.B cx
16\- asynchronous Cronyx-Sigma adapter driver
17.br
18.B if_cx
19\- synchronous Cronyx-Sigma adapter driver
20.SH CONFIGURATION
21.B
22device cx0 at isa? port 0x240 irq 15 drq 7
23.br
24.B
25device cx1 at isa? port 0x260 irq 12 drq 6
26.br
27.B
28pseudo-device sppp
29.P
30The base i/o port address should be set by jumpers on the board.
31The DMA i/o channel and interrupt request numbers are configured
32by software at adapter initialization. Legal values are:
33.IP Port
340x240, 0x260, 0x280, 0x300, 0x320, 0x380
35.IP IRQ
363, 5, 7, 10, 11, 12, 15
37.IP DMA
385, 6, 7
39.SH DESCRIPTION
40.PP
41The Cronyx-Sigma driver supports the adapters of models 100,
42400, 500, 401, 404, 410, 440, 703, 801, 810, 840. Different models have
43different set of channels:
44.ES
45 Model Channels
46----------------------------------------------
47 Cronyx-Sigma-100 0
48 Cronyx-Sigma-400 4, 5, 6, 7
49 Cronyx-Sigma-500 0, 4, 5, 6, 7
50 Cronyx-Sigma-401 0, 1, 2, 3
51 Cronyx-Sigma-404 0, 1, 2, 3
52 Cronyx-Sigma-410 0, 1, 2, 3
53 Cronyx-Sigma-440 0, 1, 2, 3
54 Cronyx-Sigma-703 0, 1, 2, 4, 5, 6, 7
55 Cronyx-Sigma-801 0, 1, 2, 3, 4, 5, 6, 7
56 Cronyx-Sigma-810 0, 1, 2, 3, 4, 5, 6, 7
57 Cronyx-Sigma-840 0, 1, 2, 3, 4, 5, 6, 7
58.EE
59.PP
60A pair of two adapters can be united together by the special
61short inter-board cable. Two united adapters use the same
62IRQ and DMA channels and from the point of driver works
63as the single 16-channel multiplexer. One of the united
64boards is ``master'' and the other is ``slave''.
65.PP
66The channels of the slave united board are numbered by the driver
67beginning with 8, for example, the united adapter of the model 100/500
68has channels 0, 8, 12, 13, 14, 15.
69.PP
70The channels which have the RS-232 interface can be used
71both in synchronous and asynchronous modes (software selectable
72by cxconfig utility) and hence are called ``universal'' channels.
73.PP
74The special device files (/dev/*) for the adapter Cronyx-Sigma
75are created by the command file ``/dev/MAKEDEV.cx''.
76An example:
77.ES
78cd /dev
79sh MAKEDEV.cx cronyx ttyx0 ttyx1 ttyy0
80.EE
81.SH "Asynchronous driver"
82.PP
83The asynchronous channel device files have the names:
84/dev/ttyx# - for adapter cx0, /dev/ttyy# - for adapter cx1,
85/dev/ttyz# - for cx2.
86Here\ # is the channel number in hexadecimal form, 0-9-a-f.
87.PP
88The driver fulfills the following standard ioctl requests (see ioctl(2)):
89.IP TIOCSBRK
90Start sending BREAK.
91.IP TIOCCBRK
92Stop sending BREAK.
93.IP TIOCSDTR
94Set DTR signal (DTR := 1). The DTR signal is always set
95on the first open(2) and could be changed by
96TIOCCDTR, TIOCSDTR, TIOCMSET, TIOCMBIS, TIOCMBIC ioctl calls.
97.IP TIOCCDTR
98Clear DTR signal (DTR := 0).
99.IP TIOCMSET
100Set the given values of DTR and RTS signals (<DTR:RTS> := data).
101The signals DTR and RTS are controlled by TIOCM_DTR and TIOCM_RTS
102bits of the data argument of the ioctl system call.
103.IP TIOCMBIS
104Set DTR and RTS signals (<DTR:RTS> |= data).
105The signals DTR and RTS are controlled by TIOCM_DTR and TIOCM_RTS
106bits of the data argument of the ioctl system call.
107.IP TIOCMBIC
108Clear DTR and RTS signals (<DTR:RTS> &= ~data).
109The signals DTR and RTS are controlled by TIOCM_DTR and TIOCM_RTS
110bits of the data argument of the ioctl system call.
111.IP TIOCMGET
112Determine the state of the modem signals of the line.
113After the call the data argument contains the following bits:
114.ES
115TIOCM_LE - always set (Line Enabled)
116TIOCM_DSR - Data Set Ready signal received
117TIOCM_CTS - Clear To Send signal received
118TIOCM_CD - Data Carrier Detect signal received
119TIOCM_DTR - Data Terminal Ready signal transmitted
120TIOCM_RTS - Request To Send signal transmitted
121.EE
122.SH "Synchronous driver"
123.PP
124The synchronous channels and universal channels, turned to the synchronous
125mode by the cxconfig(8) utility, are accessible as network
126interfaces named ``cx#'' where\ # is the channel number, 0..47.
127All standard network interface parameters could be set by ifconfig(8) utility.
128The cxconfig(8) command is used to change some extended channel
129options, and also for setting the high-level software protocol
130(e.g. PPP or Cisco HDLC).
131.PP
132The universal channels could be used both in asynchronous and synchronous modes.
133By default the asynchronous mode is set.
134The mode could be changed by cxconfig(8) utility.
135The mode is blocked while the channel is busy (an asynchronous channel
136in open state or the network interface is up).
137.SH "Synchronous Point-to-Point protocol"
138.PP
139The Cronyx-Sigma driver uses the built-in implementation of the synchronous
140Point-to-Point protocol (sppp). It includes the support for such
141protocols as PPP/HDLC and Cisco/HDLC, and also the automatic
142connection loss test (via keepalive packets).
143The sppp protocol set is implemented as an independent module
144and could be used by other drivers of synchronous serial channels.
145The version of the driver for BSD/386 (BSDI) operating system
146also supports the usage of the general set of synchronous
147protocols, implemented inside the OS.
148The external protocol set could be selected by ``cxconfig ext'' command
149(see cxconfig(8)).
150.SH "Channel Options Management"
151.PP
152The cxconfig(8) utility is used for setting the channels options.
153The channel options are generally set at the start of the operating
154system (for example, from the file /etc/rc).
155Note, that not all options have a sense for every particular
156case, and an attempt to set some of them can hang up the channel or
157the whole adapter.
158.PP
159The actual channel options control functions are implemented via
160the ioctl-s on the special device file /dev/cronyx.
161There are the following ioctl-s available:
162.IP CXIOCGETMODE
163Get the channel option values.
164.IP CXIOCSETMODE
165Set the channel option values.
166.PP
167The data argument of the ioctl call has an address of the options structure:
168.ES
169typedef struct {
170 unsigned char board; /* adapter number, 0..2 */
171 unsigned char channel; /* channel number, 0..15 */
172 unsigned char type; /* channel type (read only) */
173 unsigned char iftype; /* chan0 interface */
174 unsigned long rxbaud; /* receiver speed */
175 unsigned long txbaud; /* transmitter speed */
176 cx_chan_mode_t mode; /* channel mode */
177 cx_chan_opt_t opt; /* common channel options */
178 cx_opt_async_t aopt; /* async mode options */
179 cx_opt_hdlc_t hopt; /* hdlc mode options */
180 cx_opt_bisync_t bopt; /* bisync mode options */
181 cx_opt_x21_t xopt; /* x.21 mode options */
182 cx_soft_opt_t sopt; /* software options and state flags */
183} cx_options_t; /* user settable options */
184.EE
185.IP board
186The adapter number, 0..2.
187.IP channel
188The channel number, 0..15.
189.IP type
190The type of the channel (read-only argument).
191.IP iftype
192The interface type of the zero (and also the eight) channel: 0 - RS-232,
1931 - RS-449/V.35.
194.IP rxbaud
195The receiver data baud rate.
196.IP txbaud
197The transmitter data baud rate.
198.IP mode
199The channel mode: asynchronous/HDLC/Bisync/X.21.
200.IP opt
201The general channel options.
202.IP aopt
203The asynchronous mode options.
204.IP hopt
205The HDLC mode options.
206.IP bopt
207The Bisync mode options.
208.IP xopt
209The X.21 mode options.
210.IP sopt
211The software protocol options.
212.SH FILES
213.PP
214/dev/cx??
215.IP
216Asynchronous channels.
217.PP
218/dev/cronyx
219.IP
220The special device file for the channel options management.
221.PP
222/sys/i386/isa/cronyx.c
223.br
224/sys/i386/isa/cx.c
225.br
226/sys/i386/isa/if_cx.c
227.br
228/sys/i386/isa/cronyx.h
229.br
230/sys/i386/isa/cxreg.h
231.br
232/sys/net/if_spppsubr.c
233.br
234/sys/net/if_sppp.h
235.IP
236The sources of the driver.
237.SH SEE ALSO
238.PP
239cxconfig(8)