138 lines
6.0 KiB
Plaintext
138 lines
6.0 KiB
Plaintext
; This file keeps the configuration of cards using the zaptel driver
|
|
; Each section except for 'general' configures a group (span) of zaptel channels
|
|
; For now on in this file's terminology a span means a group of circuits mapped
|
|
; to zaptel channels that may belong to different zaptel spans
|
|
;
|
|
; NOTES:
|
|
; - It is not mandatory to match a group of circuits to a zaptel span
|
|
; - The circuits are not created on load: they are created on demand
|
|
; - It is not possible to mix FXS/FXO circuits in the same group
|
|
; - All circuits belonging to the same group share its settings
|
|
|
|
|
|
[general]
|
|
; This section keeps general settings for zaptel module and groups
|
|
|
|
; format: string: Default data format for analog (FXS/FXO) circuits
|
|
; Allowed values are alaw (G711 a-law) or mulaw (G711 mu-law). Defaults to mulaw
|
|
; This option can be overriden in span sections
|
|
; NOTE: The data format for digital circuits defaults to alaw for E1 and mulaw
|
|
; for T1 and it's negociated by other protocols
|
|
;format=mulaw
|
|
|
|
; idlevalue: integer: The value to fill whenever voice data is missing
|
|
; E.g. on incomplete read (less the buffer length) the circuit will fill the rest
|
|
; of the buffer with the value given by this parameter before forwarding it
|
|
; Interval: 0..255. Defaults to 255
|
|
; This option can be overriden in span sections
|
|
;idlevalue=255
|
|
|
|
; buflen: integer: The length of the buffers used by the data source and consumer
|
|
; created by the circuits
|
|
; For data sources this is the length of the buffer used to read data from devices
|
|
; Data consumers will use this value multiplied by 4 as a limit of send buffer. Any
|
|
; data exceeding the buffer length will be dropped. The purpose is to avoid driver
|
|
; buffer overrun
|
|
; This value can't be 0. Defaults to 160
|
|
; This option can be overriden in span sections
|
|
;buflen=160
|
|
|
|
; errormask: integer: Value to AND with the received error byte on E1/T1 interface
|
|
; The errors controlled by this mask are 1: RX buffer overrun 2: HDLC Align error
|
|
; Maximum value 255
|
|
; Defaults to 255 if missing or invalid
|
|
; Ignored if type is not E1, T1 or BRI
|
|
; This option can be overriden in span sections
|
|
;errormask=255
|
|
|
|
; priority: keyword: Default priority of the data service threads (read data and
|
|
; events from Zaptel devices)
|
|
; Allowed values: lowest, low, normal, high, highest
|
|
; NOTE:
|
|
; - It is a bad idea to set a low priority for anything but testing
|
|
; - Interface (D-channel) circuits' threads are created when the interface is
|
|
; enabled and stopped when disabled/destroyed
|
|
; - Digital voice (E1/T1) circuits' threads are created when the circuit is
|
|
; connected (prepared to be used in an active call) and destroyed when
|
|
; disconnected/destroyed
|
|
; - Analog (FXS/FXO) circuits' threads are created when the circuit is reserved
|
|
; (used) and destroyed when idle(unused)/destroyed
|
|
; Defaults to normal
|
|
;priority=normal
|
|
|
|
|
|
;[zaptel1]
|
|
;This section configures a span (group of circuits) named zaptel1
|
|
|
|
; type: string: Specify the span signalling type (required)
|
|
; Allowed values:
|
|
; E1, T1: E1/T1 signalling. Circuits belonging to this span can be
|
|
; configured as voice circuits or signalling only (SS7, ISDN etc) circuits
|
|
; BRI: ISDN BRI signalling. Circuits are voice and signaling
|
|
; FXO: This group's circuits are telephone sets linked to telephone exchanges
|
|
; FXS: This group's circuits are telephone exchanges linked to telephone sets
|
|
; Defaults to E1 if missing or invalid
|
|
; NOTE: Unlike Zaptel terminology, in this file FXO/FXS indicates the signalling of the
|
|
; local end of the line, not the remote's one
|
|
;type=E1
|
|
|
|
; offset: integer: Value to add to each circuit (voice or signalling) number (required)
|
|
; This is the offset in the zaptel circuits set of the circuits belonging to this span
|
|
; For example, if the span have 2 logical circuits: 1 and 3 and offset is 24 the
|
|
; circuit 1 will use the zaptel channel 25 and circuit 3 will use zaptel channel 27
|
|
; There is no default value for this option: circuit/interface creation will be denied
|
|
; if this value is invalid (not an integer or less then 0)
|
|
;offset=
|
|
|
|
; start: integer: Absolute start of circuits numbers, ignore group's start
|
|
; Default is group's current start
|
|
;start=
|
|
|
|
; sigchan: integer: The circuit used for signalling (D-channel)
|
|
; Numbers greater then circuit count (circuit count defaults to 31 for E1 and
|
|
; to 24 for T1) are not allowed
|
|
; Defaults to 16 for E1, 24 for T1 and 3 for BRI
|
|
; Ignored if type is FXS/FXO
|
|
;sigchan=16
|
|
|
|
; voicechans: string: The range of circuits used for voice (data) transfer or
|
|
; voice and signalling if the type is FXS/FXO
|
|
; Circuit intervals may be specified by separating the margins using the '-' character
|
|
; Individual circuits or circuit intervals may be separated by '.'
|
|
; Duplicate, not strict positive circuit numbers, or circuit numbers greater
|
|
; then circuit count are not allowed. Circuit count defaults to 31 for E1
|
|
; and to 24 for T1. For FXS/FXO spans the channel count is detected from the list)
|
|
; E.g. 1-15.17-31 or 1-23 or 1.2.3-15.17.18-30.31
|
|
; If missing, will be computed from type (E1: 1-15.17-31, T1: 1-23, BRI: 1-2, FXO/FXS: 1)
|
|
;voicechans=1-15.17-31
|
|
|
|
; increment: integer: How much will increment this span the circuit number in
|
|
; the group it belongs to
|
|
; Defaults to 32 for E1, 24 for T1, 3 for BRI
|
|
;increment=
|
|
|
|
; dtmfdetect: boolean: Set/reset DTMF detection on each zaptel channel used by
|
|
; a circuit belonging to this span
|
|
; If enabled and DTMF detection is not supported by the zaptel driver it will be disabled
|
|
; Defaults to enable
|
|
;dtmfdetect=enable
|
|
|
|
; echotaps: integer: The number of taps in the echo canceller used by the circuits
|
|
; belonging to this span
|
|
; Set to 0 to disable the echo canceller
|
|
; Defaults to 0 if missing or invalid
|
|
;echotaps=0
|
|
|
|
; echotrain: integer: The amount of time (in miliseconds) used to train the echo canceller
|
|
; Ignored if echo canceller is disabled
|
|
; Defaults to 400
|
|
;echotrain=400
|
|
|
|
; readonly: boolean: Specifies if this is a read only span (signalling and audio data)
|
|
; Defaults to no
|
|
;readonly=no
|
|
|
|
; trackhook: boolean: Poll the hook status (only in FXO mode) for devices in parallel
|
|
; Defaults to no
|
|
;trackhook=no
|