1.\" $FreeBSD: head/sbin/sconfig/sconfig.8 129378 2004-05-18 07:23:37Z ru $
2.Dd November 21, 2003
| 1.\" Copyright (c) 2002-2004 Roman Kurakin <rik@cronyx.ru>
2.\" Copyright (c) 2002-2004 Cronyx Engineering
3.\" All rights reserved.
4.\"
5.\" This software is distributed with NO WARRANTIES, not even the implied
6.\" warranties for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
7.\"
8.\" Authors grant any other persons or organisations a permission to use,
9.\" modify and redistribute this software in source and binary forms,
10.\" as long as this message is kept with the software, all derivative
11.\" works or modified versions.
12.\"
13.\" $FreeBSD: head/sbin/sconfig/sconfig.8 129500 2004-05-20 16:40:06Z ru $
14.Dd May 19, 2004
|
3.Dt SCONFIG 8 i386
4.Os
5.Sh NAME
6.Nm sconfig
| 15.Dt SCONFIG 8 i386
16.Os
17.Sh NAME
18.Nm sconfig
|
7.Nd channel configuration utility for Cronyx adapters
| 19.Nd "channel configuration utility for Cronyx adapters"
|
8.Sh SYNOPSIS
9.Nm
10.Op Fl aimsxeftuc
11.Op Ar device
| 20.Sh SYNOPSIS
21.Nm
22.Op Fl aimsxeftuc
23.Op Ar device
|
12.Op Ar data rate options
13.Op Ar protocol options ...
14.Op Ar interface options ...
| 24.Op Ar data_rate_options
25.Op Ar protocol_options ...
26.Op Ar interface_options ...
|
15.Sh DESCRIPTION
16The
17.Nm
18utility is used for configuring the channel options of the Cronyx
19adapters.
| 27.Sh DESCRIPTION
28The
29.Nm
30utility is used for configuring the channel options of the Cronyx
31adapters.
|
20In asynchronous mode all the parameters should be set by standard
| 32In asynchronous mode, all parameters should be set using the standard
|
21.Xr stty 1
| 33.Xr stty 1
|
22utility, with
23.Nm
24you could set only few of them (see below).
| 34utility.
35With
36.Nm ,
37it is only possible to set some of them (see below).
|
25.Pp
| 38.Pp
|
26Some of the options could be set only on free channels, that is the
27corresponding network interface in
28.Ar down
29state in the synchronous mode, and in the asynchronous mode the asynchronous
30terminal device
| 39Some of the options can be set only on free channels,
40that is when the corresponding network interface is in the
41.Cm down
42state in the synchronous mode,
43and the terminal device
|
31.Pa /dev/tty*
| 44.Pa /dev/tty*
|
32closed.
| 45is closed in asynchronous mode.
|
33.Pp
| 46.Pp
|
34Other channel options could be changed
| 47Other channel options can be changed
|
35.Dq "on the fly" .
36Generally, the channel options are set up during the operating system startup,
| 48.Dq "on the fly" .
49Generally, the channel options are set up during the operating system startup,
|
37for example from the
| 50for example, from the
|
38.Pa /etc/rc
| 51.Pa /etc/rc
|
39file.
| 52script.
|
40.Pp
| 53.Pp
|
41Note, that not all options have a sense for every particular
42case, and an attempt to set some of them can hang up the channel or
43the whole adapter.
| 54Note that not all options make sense in every particular case,
55and an attempt to set some of them may hung up the channel
56or the whole adapter.
|
44.\"--------------------------------------------------------------
45.Ss "Information Options"
| 57.\"--------------------------------------------------------------
58.Ss "Information Options"
|
46You can specify only one of these options.
| 59Only one of these options can be specified.
|
47If information option is specified,
48.Nm
| 60If information option is specified,
61.Nm
|
49will show corresponding information and will ignore all other options,
| 62will show the corresponding information and will ignore all other options,
|
50except
51.Ar device .
| 63except
64.Ar device .
|
52See also description of the
53.Ar device .
| 65See also the description of the
66.Ar device
67argument.
|
54.Bl -tag -width indent
55.It <none>
56This will show settings of the channel.
57.It Fl a
58Print all settings of the channel.
59.It Fl i
| 68.Bl -tag -width indent
69.It <none>
70This will show settings of the channel.
71.It Fl a
72Print all settings of the channel.
73.It Fl i
|
60Print interface settings, equal to the output of
| 74Print interface settings, equal to the output of the
|
61.Xr ifconfig 8
62utility.
63.It Fl m
64Print modem signal status.
| 75.Xr ifconfig 8
76utility.
77.It Fl m
78Print modem signal status.
|
65The description of all signals can be found in
66any document related to the modems.
| 79The description of all signals can be found in any modem documentation.
|
67Only LE signal should be described.
| 80Only LE signal should be described.
|
68If this signal is On, than some what use channel.
69If it is Off, than channel is free.
| 81If this signal is ON then the channel is busy.
82If it is OFF then the channel is free.
|
70.It Fl s
71Print brief channel statistics.
| 83.It Fl s
84Print brief channel statistics.
|
72This is general statistics.
73See also
74.Fl x , e , f , t
| 85This is the generic statistics,
86see also the
87.Fl x , e , f , t ,
|
75and
76.Fl u
77options.
| 88and
89.Fl u
90options.
|
78For the description of output, see below.
| 91For a description of the output, see below.
|
79.Pp
80This statistics is very useful if something goes wrong.
| 92.Pp
93This statistics is very useful if something goes wrong.
|
81For example, if you
82have no any interrupts, than you use interrupt that is not registered in BIOS
83for use with ISA bus.
| 94For example, if all interrupt counters are zero then the device
95was configured to use an interrupt that was not registered in the
96BIOS for use with the ISA bus.
|
84.It Fl x
85Print full channel statistics.
| 97.It Fl x
98Print full channel statistics.
|
86This options allows to see some more counters,
| 99This options prints additinal counters,
|
87but with less precision than with the
88.Fl s
89option.
90.It Fl e
91Print brief E1/G703 statistics.
| 100but with less precision than with the
101.Fl s
102option.
103.It Fl e
104Print brief E1/G703 statistics.
|
92If you select this option, you will get
93statistics accumulated for period of time equal to 15 minutes.
94For the
95description of output, see below.
| 105If this option is selected, the
106statistics accumulated over the last 15 minutes is printed.
107For a description of the output, see below.
|
96.It Fl f
97Print full E1/G703 statistics.
| 108.It Fl f
109Print full E1/G703 statistics.
|
98This option shows all E1/G703 statistics that
99shows previous option
100.Pq Fl e ,
101but also total statistics for whole period of time and statistics for 24
102hours (if available).
103For the description of output, see below.
| 110This option shows all E1/G703 statistics that the
111.Fl e
112option shows,
113plus total statistics for the whole period of time and statistics for
114last 24 hours (if available).
115For a description of the output, see below.
|
104.It Fl t
105Print brief E3/T3/STS-1 statistics.
| 116.It Fl t
117Print brief E3/T3/STS-1 statistics.
|
106If you select this option, you will
107get statistics accumulated for period of time equal to 15 minutes.
108For
109the description of output, see below.
| 118If this option is selected, the
119statistics accumulated over the last 15 minutes is printed.
120For a description of the output, see below.
|
110.It Fl u
111Print full E3/T3/STS-1 statistics.
| 121.It Fl u
122Print full E3/T3/STS-1 statistics.
|
112This option shows all E3/T3/STS-1
113statistics that shows previous option
114.Pq Fl t ,
115but also total statistics for whole period of time and statistics for 24
116hours (if available).
117For the description of output, see below.
| 123This option shows all E3/T3/STS-1 statistics that the
124.Fl t
125option shows,
126plus total statistics for the whole period of time and statistics for
127last 24 hours (if available).
128For a description of the output, see below.
|
118.It Fl c
119Cleans all kind of statistics.
120.El
121.\"--------------------------------------------------------------
122.Ss "Device Selection"
| 129.It Fl c
130Cleans all kind of statistics.
131.El
132.\"--------------------------------------------------------------
133.Ss "Device Selection"
|
123Device is equal to the name of the interface that is used for a name of
124the interface that is sees
| 134The device is selected using the name of the network interface,
135as shown by
|
125.Xr ifconfig 8 .
| 136.Xr ifconfig 8 .
|
126The channel number depends on the order of loading drivers by the system.
| 137The channel number depends on the order the drivers were loaded into the system.
|
127Sometimes people confuse channel number and adapter number because of the
128same spelling.
| 138Sometimes people confuse channel number and adapter number because of the
139same spelling.
|
129Adapter number appears in kernel context, channel number
130in configuration context.
| 140The adapter number appears in the kernel context, while the channel number
141is in the configuration context.
|
131.Bl -tag -width indent
132.It <none>
| 142.Bl -tag -width indent
143.It <none>
|
133You can omit device name only if you want to get information.
134This will cause
135printing information about all available channels of Cronyx adapters.
136In the
137case you want to make some settings you MUST specify device name.
138.It Li cx##
| 144If the device name is omitted,
145.Nm
146will print information about all channels of all Cronyx adapters
147available in the system.
148If some settings need to be made, the device name must be specified.
149.It Li cx Ns Ar ##
|
139This is the channel name for the Sigma family of Cronyx adapters.
140(ISA bus.)
| 150This is the channel name for the Sigma family of Cronyx adapters.
151(ISA bus.)
|
141.It Li ct##
| 152.It Li ct Ns Ar ##
|
142This is the channel name for the Tau family of Cronyx adapters.
143(ISA bus.)
| 153This is the channel name for the Tau family of Cronyx adapters.
154(ISA bus.)
|
144.It Li cp##
| 155.It Li cp Ns Ar ##
|
145This is the channel name for the Tau-PCI family of Cronyx adapters.
146(PCI bus.)
| 156This is the channel name for the Tau-PCI family of Cronyx adapters.
157(PCI bus.)
|
147.It Li ce##
| 158.It Li ce Ns Ar ##
|
148This is the channel name for the Tau32-PCI family of Cronyx adapters.
149(PCI bus.)
150.El
151.\"--------------------------------------------------------------
152.Ss "Data Rate Options"
153.Bl -tag -width indent
154.It Ar value
| 159This is the channel name for the Tau32-PCI family of Cronyx adapters.
160(PCI bus.)
161.El
162.\"--------------------------------------------------------------
163.Ss "Data Rate Options"
164.Bl -tag -width indent
165.It Ar value
|
155In case of nonzero value it will cause setting data rate to given value and
156setting the internal clock source of the synchronization (in synchronous mode).
157Zero value is equal to the
158.Cm extclock .
159The transmitted data (TXD) are synchronized using the internal on-board timing
| 166A non-zero value will set the data rate to a given value
167in asynchronous mode,
168and will set the date rate and internal clock source of synchronization
169in synchronous mode.
170A zero value is equivalent to specifying the
171.Cm extclock
172option.
173The transmitted data (TxD) are synchronized using the internal on-board timing
|
160generator, the internally generated timing signal is driven on the TXCOUT pin,
161and the signal on the TXCIN pin is ignored.
162This mode is used for direct
| 174generator, the internally generated timing signal is driven on the TXCOUT pin,
175and the signal on the TXCIN pin is ignored.
176This mode is used for direct
|
163terminal-to-terminal communication, e.g., for connecting two computers together
164in a synchronous mode via relatively short cable.
| 177terminal-to-terminal communication, e.g., when connecting two computers together
178in synchronous mode with a relatively short cable.
|
165This method should also be
166used for testing channels with an external loopback connector.
167.It Cm extclock
| 179This method should also be
180used for testing channels with an external loopback connector.
181.It Cm extclock
|
168Set the external timing clock source of synchronous channels.
169External clock
170mode is the most common method for connecting external modem hardware.
171In this
172mode the external timing signal is received on TXCIN pin of the connector,
173and it is used as a synchronization clock for transmitting data (TXD).
| 182Set the external timing clock source for synchronous channels.
183External clock mode is the most commonly used method for connecting
184external modem hardware.
185In this mode,
186the external timing signal is received on the TXCIN pin of the connector,
187and it is used as a synchronization clock for transmitting data (TxD).
188.Pp
189Note: in
190.Cm extclock
191mode, the device cannot determine the value of the external timing clock
192since it does not have the built-in clock gauge.
|
174.El
175.\"--------------------------------------------------------------
176.Ss "Protocol Options"
| 193.El
194.\"--------------------------------------------------------------
195.Ss "Protocol Options"
|
177Note.
178These option could be set only if channel is free and they requires
179specifying of the device name.
| 196Note: these option can only be used on a free channel, and they require
197specifying the device name.
|
180.Bl -tag -width indent
181.It Cm async
| 198.Bl -tag -width indent
199.It Cm async
|
182Set asynchronous protocol (or mode).
183In this mode Cronyx adapters behave as a
184usual serial devices and you may work with them using usual serial utilities.
185All asynchronous settings are performed via serial configuration utilities.
186With
187.Nm
188you may set only a few of them.
189See also
190.Xr stty 1 .
| |
191(Only for Sigma family.)
| 200(Only for Sigma family.)
|
| 201Select the asynchronous protocol (or mode).
202In this mode, Cronyx adapters behave as normal serial devices,
203and standard serial communications utilities can be used to
204work with them.
205All asynchronous settings should be set using the standard
206serial communications configuration utilities, e.g.,
207.Xr stty 1 .
208With
209.Nm ,
210it is only possible to set some of them.
|
192.It Cm cisco
| 211.It Cm cisco
|
193Set the Cisco HDLC synchronous protocol.
| 212Select the Cisco HDLC synchronous protocol.
|
194.It Cm fr
| 213.It Cm fr
|
195Set the Frame Relay synchronous protocol
| 214Select the Frame Relay synchronous protocol
|
196.Tn ( ANSI
197T1.617 Annex D).
198.It Cm ppp
| 215.Tn ( ANSI
216T1.617 Annex D).
217.It Cm ppp
|
199Set the PPP synchronous protocol.
200Parameters to the PPP could be set by the
201command
202.Xr spppcontrol 8 .
| 218Select the synchronous PPP protocol.
219PPP parameters can be configured using the
220.Xr spppcontrol 8
221utility.
|
203.It Sm Cm keepalive No = Bro Cm on , off Brc Sm
| 222.It Sm Cm keepalive No = Bro Cm on , off Brc Sm
|
204Turns on/off sending keepalive messages.
205This option is used only for
206synchronous PPP.
207If this option is on, than PPP will periodically send
208echo-request messages.
209If it would not receive any echo-reply messages for
210some (definite) period of time it will break connection.
211It is used for
212tracking line state.
| 223Turn on/off transmission of keepalive messages.
224This option is used only for synchronous PPP.
225If this option is
226.Cm on ,
227PPP will periodically send ECHO-REQUEST messages.
228If it will not receive any ECHO-REPLY messages for
229some (definite) period of time it will break the connection.
230It is used for tracking the line state.
|
213.It Cm idle
| 231.It Cm idle
|
214You are using Netgraph.
215Protocol depends on connected module.
| 232This mode is reported when using Netgraph.
233An actual protocol depends on the type of a connected Netgraph node,
234and it cannot be changed with
235.Nm .
|
216.El
217.\"--------------------------------------------------------------
218.Ss "Interface Options"
| 236.El
237.\"--------------------------------------------------------------
238.Ss "Interface Options"
|
219Not all of these options could be set on running channel and not all of them
220are suits to all kind of adapters/channels.
221In all dual state options off is
222default value.
223All this options is not applicable in asynchronous mode, except
| 239Not all of these options can be set on a busy channel, and not all of them
240are applicable to all kinds of adapters/channels.
241For all dual-state options,
242.Cm off
243is the default value.
244None of these options can be used in the asynchronous mode,
245except for the
|
224.Cm debug
225option.
226.Bl -tag -width indent
227.It Sm Cm port No = Bro Cm rs232 , v35 , rs449 Brc Sm
| 246.Cm debug
247option.
248.Bl -tag -width indent
249.It Sm Cm port No = Bro Cm rs232 , v35 , rs449 Brc Sm
|
228Set port type for old Sigma models.
| 250Set the port type for old Sigma models.
|
229.It Sm Cm cfg No = Bro Cm A , B , C Brc Sm
| 251.It Sm Cm cfg No = Bro Cm A , B , C Brc Sm
|
230Set configuration for the adapter.
231This option could be set only for Tau/E1
232and Tau/G703 and only if all channels are not running.
| 252Set the configuration for the adapter.
253This option can be used only with Tau/E1
254and Tau/G703 adapters, and only if all channels are free.
|
233.Bl -tag -width ".Cm cfg Ns = Ns Cm A"
234.It Cm cfg Ns = Ns Cm A
235Two independent E1/G703 channels.
| 255.Bl -tag -width ".Cm cfg Ns = Ns Cm A"
256.It Cm cfg Ns = Ns Cm A
257Two independent E1/G703 channels.
|
236This is default setting.
| 258This is the default setting.
|
237.It Cm cfg Ns = Ns Cm B
238(Only for ISA models.)
| 259.It Cm cfg Ns = Ns Cm B
260(Only for ISA models.)
|
239For Tau/G703 this mean one G703 channel and one digital channel.
240For Tau/E1 first physical channel divides on to subchannels.
241One of them
242goes to the first logical channel and another one goes to the second physical
243channel.
244Second (logical) channel is digital channel.
| 261For Tau/G703 this means one G703 channel and one digital channel.
262For Tau/E1, the first physical channel is divided into two subchannels.
263One of them goes to the first logical channel, another one goes to the
264second physical channel.
265Second (logical) channel is the digital channel.
|
245.It Cm cfg Ns = Ns Cm C
| 266.It Cm cfg Ns = Ns Cm C
|
246This configuration is used only for E1 models.
247In this case first
| 267(Only for E1 models.)
268In this mode, first
|
248physical channel consists of three data flows.
| 269physical channel consists of three data flows.
|
249Two of them go to two
250(logical) channels.
| 270Two of them go to the two (logical) channels.
|
251The last one goes to the second physical channel.
| 271The last one goes to the second physical channel.
|
252On new
253models (Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1) this configuration means single source
254of synchronization and passing all unused (in both channels) timeslots from
255one channel to other.
| 272On newer models (Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1),
273this programs the hardware to use a single source of synchronization
274and pass all unused (in both channels) timeslots from
275one channel to another.
|
256.El
257.Pp
| 276.El
277.Pp
|
258For the detailed description of the configuration see
259your documentation to the adapter.
260This option could not be set on running
261channel.
| 278For a detailed description of available configuration modes,
279see the adapter documentation.
280This option cannot be set on a busy channel.
|
262.It Sm Cm loop No = Bro Cm on , off Brc Sm
263Turn on/off internal loopback.
| 281.It Sm Cm loop No = Bro Cm on , off Brc Sm
282Turn on/off internal loopback.
|
264This mode is useful for testing.
265Switch on this
266option and try to send something.
267If you have no any interrupt, than, probably,
268you forgot to switch using IRQ for PCI to ISA bus.
269Check your BIOS settings.
| 283This mode is useful for debugging.
284When this mode is
285.Cm on ,
286some data should be sent.
287If no interrupts are generated, chances are that
288the corresponding IRQ configuration entry in the BIOS
289was not switched from
290.Dq Li "PCI/ISA PNP"
291to
292.Dq Li "Legacy ISA" .
|
270.It Sm Cm rloop No = Bro Cm on , off Brc Sm
271(Only for Tau32-PCI and Tau-PCI/E3.)
| 293.It Sm Cm rloop No = Bro Cm on , off Brc Sm
294(Only for Tau32-PCI and Tau-PCI/E3.)
|
272Turn on/off remote loopback.
273This mode is also useful for testing.
| 295Turn on/off remote loopback feature.
296This mode is also useful for debugging.
|
274.It Sm Cm dpll No = Bro Cm on , off Brc Sm
275Turn on/off digital phase locked loop mode (DPLL).
276When enabled, the receiver
277timing clock signal is derived from the received data.
| 297.It Sm Cm dpll No = Bro Cm on , off Brc Sm
298Turn on/off digital phase locked loop mode (DPLL).
299When enabled, the receiver
300timing clock signal is derived from the received data.
|
278Must be used with NRZI
279encoding, to avoid the synchronization loss.
| 301Must be used with the NRZI
302encoding to avoid the synchronization loss.
|
280.It Sm Cm nrzi No = Bro Cm on , off Brc Sm
| 303.It Sm Cm nrzi No = Bro Cm on , off Brc Sm
|
281Turn on/off nrzi encoding.
282In off state nrz encoding is used.
| 304Turn on/off NRZI encoding.
305If
306.Cm off ,
307NRZ encoding is used.
|
283.Bl -tag -width "NRZI"
284.It NRZ
| 308.Bl -tag -width "NRZI"
309.It NRZ
|
285the zero
286bit is transmitted by the zero signal level, the one bit - by the positive
287signal level.
| 310The zero bit is transmitted by the zero signal level,
311the one bit is transmitted by the positive signal level.
|
288.It NRZI
| 312.It NRZI
|
289the bit number zero is transmitted by the change of the
290signal level, the one bit - by the constant signal level.
291.El
292.Pp
293Commonly is used with
| 313The zero bit is transmitted by the change of the signal
314level, the one bit is by the constant signal level.
315Commonly used with the
|
294.Cm dpll Ns = Ns Cm on
295option.
| 316.Cm dpll Ns = Ns Cm on
317option.
|
| 318.El
|
296.It Sm Cm invclk No = Bro Cm on , off Brc Sm
| 319.It Sm Cm invclk No = Bro Cm on , off Brc Sm
|
297Invert the both transmit and receive clock signals (Tau and Tau-PCI only).
| 320(Tau and Tau-PCI only.)
321Invert both the transmit and receive clock signals.
|
298.It Sm Cm invrclk No = Bro Cm on , off Brc Sm
| 322.It Sm Cm invrclk No = Bro Cm on , off Brc Sm
|
299Invert the receive clock signals (Tau-PCI only).
| 323(Tau-PCI only.)
324Invert the receive clock signals.
|
300.It Sm Cm invtclk No = Bro Cm on , off Brc Sm
| 325.It Sm Cm invtclk No = Bro Cm on , off Brc Sm
|
301Invert the transmit clock signals (Tau-PCI only).
| 326(Tau-PCI only.)
327Invert the transmit clock signals.
|
302.It Sm Cm higain No = Bro Cm on , off Brc Sm
| 328.It Sm Cm higain No = Bro Cm on , off Brc Sm
|
303Turn on/off increasing the E1 receiver non linear sensitivity to -30 dB (E1
304only).
| 329(E1 only.)
|
305In of state the sensitivity is -12 dB.
| 330In of state the sensitivity is -12 dB.
|
306This allows increasing line
307distance.
| 331Turn on/off increasing the E1 receiver's non-linear sensitivity to -30dB.
332This allows increasing of the line distance.
|
308.It Sm Cm cablen No = Bro Cm on , off Brc Sm
| 333.It Sm Cm cablen No = Bro Cm on , off Brc Sm
|
309(Only for Tau-PCI/T3 and Tau-PCI/STS-1.)
310Turn on/off adjusting transmit signal for long cable T3/STS-1.
| 334(Tau-PCI/T3 and Tau-PCI/STS-1 only.)
335Turn on/off adjusting of the transmit signal for a long cable T3/STS-1.
|
311.It Sm Cm monitor No = Bro Cm on , off Brc Sm
| 336.It Sm Cm monitor No = Bro Cm on , off Brc Sm
|
312Turn on/off increasing the E1 receiver lines sensitivity to -30 dB.
| |
313(Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1 only.)
| 337(Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1 only.)
|
314This could be used for interception
315purposes.
| 338Turn on/off increasing of the E1 receiver's linear sensitivity to -30dB.
339This can be used for the interception purposes.
|
316.It Sm Cm phony No = Bro Cm on , off Brc Sm
| 340.It Sm Cm phony No = Bro Cm on , off Brc Sm
|
317Turn on/off the so-called phony mode.
| |
318(Tau32-PCI and Tau-PCI E1 family only.)
| 341(Tau32-PCI and Tau-PCI E1 family only.)
|
| 342Turn on/off the so-called
343.Dq phony
344mode.
|
319This mode allows
| 345This mode allows
|
320receiving raw CEPT frames from E1 line.
321Raw frames could be accessed, for
322example, via raw protocol.
323Packets would come at rate of 500 frames per second
| 346receiving raw CEPT frames from the E1 line.
347Raw frames can be accessed, for example, with the raw protocol.
348Packets would come at a rate of 500 frames per second
|
324with length
325.No 16* Ns Ar N
326(for Tau-PCI/E1 model), where
327.Ar N
328is the number of timeslots.
329For
| 349with length
350.No 16* Ns Ar N
351(for Tau-PCI/E1 model), where
352.Ar N
353is the number of timeslots.
354For
|
330Tau-PCI/2E1 and Tau-PCI/4E1 N should be equal to 32 independently from number of
| 355Tau-PCI/2E1 and Tau-PCI/4E1,
356.Ar N
357should be equal to 32 regardless of the number of
|
331used timeslots.
332.It Sm Cm unfram No = Bro Cm on , off Brc Sm
| 358used timeslots.
359.It Sm Cm unfram No = Bro Cm on , off Brc Sm
|
333Turn on/off unframed mode.
| |
334(Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1 only.)
| 360(Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1 only.)
|
| 361Turn on/off unframed mode.
|
335.Bl -tag -width ".Cm unfram Ns = Ns Cm off"
336.It Cm unfram Ns = Ns Cm on
| 362.Bl -tag -width ".Cm unfram Ns = Ns Cm off"
363.It Cm unfram Ns = Ns Cm on
|
337switches channel to unframed G.703 mode.
| 364Switch channel to the unframed G.703 mode.
|
338.It Cm unfram Ns = Ns Cm off
| 365.It Cm unfram Ns = Ns Cm off
|
339switches channel to framed E1 (G.704 mode).
| 366Switch channel to the framed E1 (G.704) mode.
|
340.El
341.It Sm Cm scrambler No = Bro Cm on , off Brc Sm
| 367.El
368.It Sm Cm scrambler No = Bro Cm on , off Brc Sm
|
342Turn on/off the scrambling of G.703 data.
343(Tau32-PCI, Tau-PCI/G.703 and Tau-PCI/2E1,
| 369(Tau32-PCI, Tau-PCI/G.703, Tau-PCI/2E1, and
|
344Tau-PCI/4E1 in unframed mode only.)
| 370Tau-PCI/4E1 in unframed mode only.)
|
| 371Turn on/off scrambling of the G.703 data.
|
345.It Sm Cm use16 No = Bro Cm on , off Brc Sm
| 372.It Sm Cm use16 No = Bro Cm on , off Brc Sm
|
346Turn on/off the usage of 16-th timeslot for data transmission.
| |
347(Tau32-PCI and Tau-PCI E1 family only.)
| 373(Tau32-PCI and Tau-PCI E1 family only.)
|
348Normally 16th timeslot is used for signaling information (multiframing CAS).
| 374Turn on/off the usage of the 16th timeslot for data transmission.
375Normally, the 16th timeslot is used for signalling information
376(multiframing CAS).
|
349.It Sm Cm crc4 No = Bro Cm on , off Brc Sm
| 377.It Sm Cm crc4 No = Bro Cm on , off Brc Sm
|
350Turn on/off CRC4 superframe mode.
| |
351(E1 only.)
| 378(E1 only.)
|
| 379Turn on/off CRC4 superframe mode.
|
352.It Sm Cm syn No = Bro Cm int , rcv , rcv0 , rcv1 , rcv2 , rcv3 Brc Sm
353.Bl -tag -width ".Cm rcv3"
354.It Cm int
| 380.It Sm Cm syn No = Bro Cm int , rcv , rcv0 , rcv1 , rcv2 , rcv3 Brc Sm
381.Bl -tag -width ".Cm rcv3"
382.It Cm int
|
355use an internal clock generator for G703 transmitter
| 383Use an internal clock generator for G703 transmitter
|
356(clock master).
357.It Cm rcv
| 384(clock master).
385.It Cm rcv
|
358use the G703 receiver data clock as the transmit clock
| 386Use the G703 receiver data clock as the transmit clock
|
359(clock slave).
360.It Cm rcv0 , rcv1 , rcv2 , rcv3
| 387(clock slave).
388.It Cm rcv0 , rcv1 , rcv2 , rcv3
|
361use the G703 receiver clock of the other channel
| 389Use the G703 receiver clock of the other channel
|
362(E1 models only).
363.El
364.It Cm dir Ns = Ns Ar number
| 390(E1 models only).
391.El
392.It Cm dir Ns = Ns Ar number
|
365Binds logical channel to the physical channel.
| |
366(Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1 only.)
| 393(Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1 only.)
|
367Using this parameter you could, for example, split E1 physical channel
368into several channels.
| 394Bind a logical channel to a physical channel.
395Using this parameter it is possible, for example, to split
396physical E1 channel into several logical channels.
|
369.It Cm ts Ns = Ns Ar interval
| 397.It Cm ts Ns = Ns Ar interval
|
370Set up the list of timeslots to use by the channel (E1 only).
371The
372timeslots are numbered from 1 to 31, and are separated by comma or minus sign,
| 398(E1 only.)
399Set up the list of timeslots for use by the channel.
400The timeslots are numbered from 1 to 31,
401and are separated by a comma or a minus sign,
|
373giving an interval.
| 402giving an interval.
|
374For example:
| 403Example:
|
375.Dq Li ts=1-3,5,17 .
376.It Cm pass Ns = Ns Ar interval
| 404.Dq Li ts=1-3,5,17 .
405.It Cm pass Ns = Ns Ar interval
|
| 406(Tau/E1 only.)
|
377Set up the list of timeslots, translated to the E1 subchannel in
378.Cm cfg Ns = Ns Cm B
379and
380.Cm cfg Ns = Ns Cm C
381configurations.
| 407Set up the list of timeslots, translated to the E1 subchannel in
408.Cm cfg Ns = Ns Cm B
409and
410.Cm cfg Ns = Ns Cm C
411configurations.
|
382(Tau/E1 only.)
| |
383.It Sm Cm debug No = Bro Cm 0 , 1 , 2 Brc Sm
384Turn on/off debug messages.
385.Bl -tag -width 2n
386.It Cm 0
| 412.It Sm Cm debug No = Bro Cm 0 , 1 , 2 Brc Sm
413Turn on/off debug messages.
414.Bl -tag -width 2n
415.It Cm 0
|
387turn off debug messages.
| 416Turn debug messages off.
|
388.It Cm 1
| 417.It Cm 1
|
389turn on debug
390messages, equal to the
| 418Turn debug messages on, equivalent to the
|
391.Cm debug
| 419.Cm debug
|
392option to the
| 420option of the
|
393.Xr ifconfig 8
394utility.
395.It Cm 2
| 421.Xr ifconfig 8
422utility.
423.It Cm 2
|
396high intensive debug message, developers only.
| 424High intensive debug messages, for developers only.
|
397.El
398.El
399.\"--------------------------------------------------------------
400.Sh EXAMPLES
| 425.El
426.El
427.\"--------------------------------------------------------------
428.Sh EXAMPLES
|
401Set up the channel 1 for use with the HDSL modem or any other
| 429Set up channel 1 for use with the HDSL modem or any other
|
402synchronous leased-line modem, and PPP/HDLC protocol (for Sigma):
403.Bd -literal -offset indent
404sconfig cx1 ppp extclock
405ifconfig cx1 158.250.244.2 158.250.244.1 up
406.Ed
407.Pp
| 430synchronous leased-line modem, and PPP/HDLC protocol (for Sigma):
431.Bd -literal -offset indent
432sconfig cx1 ppp extclock
433ifconfig cx1 158.250.244.2 158.250.244.1 up
434.Ed
435.Pp
|
408Set up the channel 0 of Tau/E1 for use with the Cisco protocol
409over E1 link, with the single virtual connection.
| 436Set up channel 0 of Tau/E1 for use with the Cisco protocol
437over the E1 link, with a single virtual connection.
|
410The DLCI number is detected automatically.
411Use timeslots 1-10:
412.Bd -literal -offset indent
413sconfig ct0 cisco ts=1-10
414ifconfig ct0 158.250.244.2 158.250.244.1 up
415.Ed
416.Pp
| 438The DLCI number is detected automatically.
439Use timeslots 1-10:
440.Bd -literal -offset indent
441sconfig ct0 cisco ts=1-10
442ifconfig ct0 158.250.244.2 158.250.244.1 up
443.Ed
444.Pp
|
417Set up the channel 0 for the synchronous null-modem link to the nearby computer,
| 445Set up channel 0 for the synchronous null-modem link to the nearby computer,
|
418internal clock source, 256000 bits/sec, protocol Cisco/HDLC (for Tau):
419.Bd -literal -offset indent
420sconfig ct0 cisco 256000
421ifconfig ct0 200.1.1.1 200.1.1.2 up
422.Ed
423.Pp
| 446internal clock source, 256000 bits/sec, protocol Cisco/HDLC (for Tau):
447.Bd -literal -offset indent
448sconfig ct0 cisco 256000
449ifconfig ct0 200.1.1.1 200.1.1.2 up
450.Ed
451.Pp
|
424Set up the channel 1 for the leased line link using data-only
| 452Set up channel 1 for the leased line link using the data-only
|
425null-modem cable (or modems like Zelax+ M115).
426Synchronous DPLL mode, 128000
427bits/sec, protocol PPP/HDLC, NRZI encoding (for Sigma):
428.Bd -literal -offset indent
429sconfig cx1 ppp 128000 nrzi=on dpll=on
430ifconfig cx1 158.250.244.2 158.250.244.1 up
431.Ed
432.\"--------------------------------------------------------------
433.Sh DIAGNOSTICS
| 453null-modem cable (or modems like Zelax+ M115).
454Synchronous DPLL mode, 128000
455bits/sec, protocol PPP/HDLC, NRZI encoding (for Sigma):
456.Bd -literal -offset indent
457sconfig cx1 ppp 128000 nrzi=on dpll=on
458ifconfig cx1 158.250.244.2 158.250.244.1 up
459.Ed
460.\"--------------------------------------------------------------
461.Sh DIAGNOSTICS
|
434This section contains description of abbreviations used by
| 462This section contains a description of abbreviations used by
|
435.Nm
436while displaying various statistics.
| 463.Nm
464while displaying various statistics.
|
437For description of options connected with
438statistics see above.
| 465For a description of options related to
466statistics, please see above.
|
439.\"--------------------------------------------------------------
440.Ss Statistics
| 467.\"--------------------------------------------------------------
468.Ss Statistics
|
441When running, the driver gathers the statistics about the channels, which
442could be accessed via the
| 469When running, the driver gathers statistics about the channels, which
470can be accessed using the
|
443.Nm
| 471.Nm
|
444utility or by
| 472utility,
473or through the
|
445.Xr ioctl 2
446call
447.Dv SERIAL_GETSTAT .
| 474.Xr ioctl 2
475call
476.Dv SERIAL_GETSTAT .
|
448.Bl -tag -width indent
| 477.Pp
478.Bl -tag -width indent -compact
|
449.It Va Rintr
| 479.It Va Rintr
|
450The total number of receive interrupts.
| 480Total number of receive interrupts.
|
451.It Va Tintr
| 481.It Va Tintr
|
452The total number of transmit interrupts.
| 482Total number of transmit interrupts.
|
453.It Va Mintr
| 483.It Va Mintr
|
454The total number of modem interrupts.
| 484Total number of modem interrupts.
|
455.It Va Ibytes
| 485.It Va Ibytes
|
456The total bytes received.
| 486Total bytes received.
|
457.It Va Ipkts
| 487.It Va Ipkts
|
458The total packets received (for HDLC mode).
| 488Total packets received (for HDLC mode).
|
459.It Va Ierrs
| 489.It Va Ierrs
|
460The number of receive errors.
| 490Number of receive errors.
|
461.It Va Obytes
| 491.It Va Obytes
|
462The total bytes transmitted.
| 492Total bytes transmitted.
|
463.It Va Opkts
| 493.It Va Opkts
|
464The total packets transmitted (for HDLC mode).
| 494Total packets transmitted (for HDLC mode).
|
465.It Va Oerrs
| 495.It Va Oerrs
|
466The number of transmit errors.
| 496Number of transmit errors.
|
467.El
468.\"--------------------------------------------------------------
469.Ss E1/G.703 Statistics
| 497.El
498.\"--------------------------------------------------------------
499.Ss E1/G.703 Statistics
|
470For E1 and G.703 channels the SNMP-compatible statistics data are gathered
| 500For E1 and G.703 channels, the SNMP-compatible statistics data are gathered
|
471(see RFC 1406).
| 501(see RFC 1406).
|
472It could be accessed via the
| 502It can be accessed using the
|
473.Nm
| 503.Nm
|
474utility or by
| 504utility,
505or through the
|
475.Xr ioctl 2
476call
477.Dv SERIAL_GETESTAT .
| 506.Xr ioctl 2
507call
508.Dv SERIAL_GETESTAT .
|
478.Bl -tag -width indent
| 509.Bl -tag -width ".Va RCRC Pq Va rcrce"
|
479.It Va Unav Pq Va uas
| 510.It Va Unav Pq Va uas
|
480Unavailable seconds - receiving all ones, or loss of carrier, or loss of
| 511Unavailable seconds: receiving all ones, loss of carrier, or loss of
|
481signal.
482.It Va Degr Pq Va dm
| 512signal.
513.It Va Degr Pq Va dm
|
483Degraded minutes - having error rate more than 10e-6, not counting unavailable
| 514Degraded minutes: having error rate more than 10E-6, not counting unavailable
|
484and severely errored seconds.
485.It Va Bpv Pq Va bpv
486HDB3 bipolar violation errors.
487.It Va Fsyn Pq Va fse
488Frame synchronization errors (E1 only).
489.It Va CRC Pq Va crce
490CRC4 errors (E1).
491.It Va RCRC Pq Va rcrce
492Remote CRC4 errors: E-bit counter (E1).
493.It Va Err Pq Va es
| 515and severely errored seconds.
516.It Va Bpv Pq Va bpv
517HDB3 bipolar violation errors.
518.It Va Fsyn Pq Va fse
519Frame synchronization errors (E1 only).
520.It Va CRC Pq Va crce
521CRC4 errors (E1).
522.It Va RCRC Pq Va rcrce
523Remote CRC4 errors: E-bit counter (E1).
524.It Va Err Pq Va es
|
494Errored seconds - any framing errors, or out of frame sync, or any slip events.
| 525Errored seconds: any framing errors, or out of frame sync, or any slip events.
|
495.It Va Lerr Pq Va les
| 526.It Va Lerr Pq Va les
|
496Line errored seconds - any BPV.
| 527Line errored seconds: any BPV.
|
497.It Va Sev Pq Va ses
| 528.It Va Sev Pq Va ses
|
498Severely errored seconds - 832 or more framing errors, or 2048 or more bipolar
| 529Severely errored seconds: 832 or more framing errors, or 2048 or more bipolar
|
499violations.
500.It Va Bur Pq Va bes
| 530violations.
531.It Va Bur Pq Va bes
|
501Bursty errored seconds - more than 1 framing error, but not severely errored.
| 532Bursty errored seconds: more than 1 framing error, but not severely errored.
|
502.It Va Oof Pq Va oofs
| 533.It Va Oof Pq Va oofs
|
503Severely errored framing seconds - out of frame sync.
| 534Severely errored framing seconds: out of frame sync.
|
504.It Va Slp Pq Va css
| 535.It Va Slp Pq Va css
|
505Controlled slip second \[em] any slip buffer overflow or underflow.
| 536Controlled slip seconds: any slip buffer overflow or underflow.
|
506.El
507.\"--------------------------------------------------------------
508.Ss E1/G.703 Status
509The
510.Nm
511utility also prints the E1/G.703 channel status.
| 537.El
538.\"--------------------------------------------------------------
539.Ss E1/G.703 Status
540The
541.Nm
542utility also prints the E1/G.703 channel status.
|
512The status could have the
513following values (nonexclusive):
514.Bl -tag -width indent
| 543The status can have the
544following values (non-exclusive):
545.Pp
546.Bl -tag -width ".Li FARLOMF" -compact
|
515.It Li Ok
| 547.It Li Ok
|
516The channel is in valid state, synchronized.
| 548The channel is in a valid state, synchronized.
|
517.It Li LOS
518Loss of sync.
519.It Li AIS
520Receiving unframed all ones (E1 only).
521.It Li LOF
522Loss of framing (E1 only).
523.It Li LOMF
524Loss of multiframing (E1 only).
525.It Li FARLOF
526Receiving remote alarm (E1 only).
527.It Li AIS16
| 549.It Li LOS
550Loss of sync.
551.It Li AIS
552Receiving unframed all ones (E1 only).
553.It Li LOF
554Loss of framing (E1 only).
555.It Li LOMF
556Loss of multiframing (E1 only).
557.It Li FARLOF
558Receiving remote alarm (E1 only).
559.It Li AIS16
|
528Receiving all ones in timeslot 16 (E1 only).
| 560Receiving all ones in the timeslot 16 (E1 only).
|
529.It Li FARLOMF
530Receiving distant multiframe alarm (E1 only).
531.It Li TSTREQ
532Receiving test request code (G.703 only).
533.It Li TSTERR
534Test error (G.703 only).
535.El
536.\"--------------------------------------------------------------
537.Sh SEE ALSO
538.Xr stty 1 ,
539.Xr ioctl 2 ,
540.Xr sppp 4 ,
541.Xr ifconfig 8 ,
542.Xr route 8 ,
543.Xr spppconrol 8
544.\"--------------------------------------------------------------
545.Sh HISTORY
| 561.It Li FARLOMF
562Receiving distant multiframe alarm (E1 only).
563.It Li TSTREQ
564Receiving test request code (G.703 only).
565.It Li TSTERR
566Test error (G.703 only).
567.El
568.\"--------------------------------------------------------------
569.Sh SEE ALSO
570.Xr stty 1 ,
571.Xr ioctl 2 ,
572.Xr sppp 4 ,
573.Xr ifconfig 8 ,
574.Xr route 8 ,
575.Xr spppconrol 8
576.\"--------------------------------------------------------------
577.Sh HISTORY
|
546This utility is a replacement of utilities
| 578This utility is a replacement for the
|
547.Nm cxconfig
548and
549.Nm ctconfig
| 579.Nm cxconfig
580and
581.Nm ctconfig
|
550that was used in past with
| 582utilities that were used in the past with
|
551.Fx
552drivers.
| 583.Fx
584drivers.
|
553Those two utilities and the present
554utility are not compatible.
555And therefore all scripts should be rewritten.
556More over,
| 585Those two utilities and
586.Nm
587are not compatible,
588and therefore all scripts using them have to be rewritten.
589Moreover,
|
557.Tn Linux
558and
559.Fx
| 590.Tn Linux
591and
592.Fx
|
560version of present utility not fully compatible.
| 593versions of the
594.Nm
595utility are not fully compatible.
|
561.\"--------------------------------------------------------------
| 596.\"--------------------------------------------------------------
|
562.Sh BUGS
563All software produced by Cronyx Engineering is thoroughly tested.
564But
565as created by the man it can contain some bugs.
566If you have caught one, try to localize it and send a letter with description
567of this bug and all operation that you have done.
568We will try to reproduce
569an error and fix it.
570.\"--------------------------------------------------------------
571.Sh CONTACT
572E-mail:
573.Aq info@cronyx.ru
| 597.Sh AUTHORS
598.An Cronyx Engineering Aq info@cronyx.ru
|
574.Pp
575.Pa http://www.cronyx.ru
| 599.Pp
600.Pa http://www.cronyx.ru
|
| 601.\"--------------------------------------------------------------
602.Sh BUGS
603All software produced by Cronyx Engineering is thoroughly tested.
604But as created by a man, it can contain some bugs.
605If you have caught one, try to localize it and send an email with the
606description of the bug, and all operations that you have done.
607We will try to reproduce the error and fix it.
|
| |