GenModule29

Zaptel-Asterisk-1.2x

Description

This module installs the zaptel drivers and configures your zaptel cards. This is the asterisk 1.2 compliant version.

Release notes

Show release notes

Version 1.17.0 - Early deployment

Feature: Added support for kernel 4.4.15 (M15765)
Limitation: PRI and FXS card are not supported any more. Sangoma Card Support 2.0 or Dahdi can be used instead (M15765)
Dependency:
- Baseline 2.x

Version 1.16.0 - General deployment

Feature: Support for baseline 2.4.0 (M7405)
Bugfix: Predefined card order mode was not working on baseline 1 (M6499)

Version 1.15.0 - General deployment

Bugfix: Potential update impact level 3 : in the event this update contains a bug, it might have critical impact. Given the complexity of the update, it is advised to contact ESCAUX support before applying this update. Adding card loading order option (M3822)

Version 1.14.0 - General deployment

Feature: Potential update impact level 2 : in the event this update contains a bug, it might have critical impact. Respect dependencies and retest your most important callflows and applicative integrations. Support baseline 2.1.0 (M0004464)
Dependency:
- SOP baseline v.1.0.8 or higher

Version 1.13.1 - General deployment

Bugfix: Zaptel driver does not come up because of conflict with netjet (M0003822)
Dependency:
- SOP baseline v.1.0.8 or higher

Version 1.13.0 - General deployment

Feature: Potential update impact level 2 : in the event this update contains a bug, it might have critical impact. Respect dependencies and retest your most important callflows and applicative integrations. Added support for Baseline 2.0 (M0003103)
Dependency:
- SOP baseline v.1.0.8 or higher

Version 1.12.1 - General deployment

Bug fix: Debian does not get installed
Dependency:
- SOP baseline v.1.0.8 or higher

Version 1.12.0 - Deprecated

Added Sangoma 2FXS card to allow dual card configuration
Dependency:
- SOP baseline v.1.0.8 or higher

Version 1.11.1 - General deployment

Bug: Debian does not get installed
Dependency:
- SOP baseline v.1.0.8 or higher

Version 1.11.0 - Deprecated

Bug: New 4PRA cards not detected (M0003398)
Dependency:
- SOP baseline v.1.0.8 or higher

Version 1.10.0 - General deployment

Feature: Added possibility to configure 2FXS (support for Sangoma cards)

Version 1.9.0 - General deployment

Added 2 interfaces

Version 1.8.0 - General deployment

4FXO added

Version 1.7.0 - General deployment

Fix ztdummy for new linux kernel
CRC4 option added
8FXS added

Version 1.6.0 - General deployment

Support new revision of FXS cards
Support single PRI with hardware echo canceller
Add a Shell plugin to make hardware detection
Fix for higher kernel version
Custom /etc/init.d/zaptel file

Version 1.5.0 - General deployment

initialize zaptel at boot time

Version 1.4.0 - General deployment

initialize zaptel at boot time

Version 1.3.0 - General deployment

Version 1.2.0 - General deployment

Version 1.1.0 - General deployment

initial version

Version 0.10.0 - Deprecated

Feature: Added support for Sangoma cards
Deprecated: Significant improvements have been done in a higher version

Module configuration interface

create_resource_form: .:/usr/share/escaux/glue/lib:/usr/share/escaux/glue/bin/gen_wiki_documentation/src/lib:/usr/share/escaux/glue/bin/gen_wiki_documentation/src/lib/

Module configuration parameters

Up to 6 zaptel 'interfaces' can be configured on a single server. A zaptel 'interface' is an E1 connector, a T1 connector, a 4 FXS card, or a 24FXS channel bank connected on a T1. The E1/T1 connector can either be configured to be the primary source of clocking (Master Clock) or to be the source of clocking when the first source of clocking is not available (Backup Clock). For some providers, it is necessary to configure CRC4 (cyclic redundancy check) on the PRI interface. If this is not activated while it should be, you will get a yellow alarm in the zaptel module

Interface [1..8]: type of 'interface':
- PRI-E1-MasterClock means an E1 interface (located on a single, dual or 4 PRI Digium/Sangoma card) which will be the primary source for the clocking
- PRI-T1-MasterClock means a T1 interface (located on a single, dual or 4 PRI Digium/Sangoma card) which will be the primary source for the clocking
- PRI-E1-BackupClock means an E1 interface (located on a single, dual or 4 PRI Digium/Sangoma card) which will be the secondary source for the clocking when the primary source is not available
- PRI-T1-BackupClock means a T1 interface (located on a single, dual or 4 PRI Digium/Sangoma card) which will be the secondary source for the clocking when the primary source is not available
- 24FXS means a T1 interface on a Digium card which is connected to a channel bank
- 8FXS means a 8FXS or 4FXS Digium PCI Express card.
- 4FXS means a 4FXS Digium PCI/PCI-E card or 2FXS Digium PCI card.
- 4FXO means a 4FXO Digium card.
- S-2FXS (previously Sangoma-2FXS) means a 2FXS Sangoma card.
- S-4FXS (previously Sangoma-4FXS) means a 4FXS Sangoma card.
- S-8FXS (previously Sangoma-8FXS) means a 8FXS Sangoma card.
- S-12FXS (previously Sangoma-12FXS) means a 12FXS Sangoma card.
- S-24FXS (previously Sangoma-24FXS) means a 24FXS Sangoma card.
Card ordering. Interfaces need to be configured in the order the corresponding cards are detected. 2 modes exists:
- Predefined is mandatory when mixing Sangoma and Digium cards (for Baseline 1, Zaptel-Asterisk-1.2x module version 1.6.0 or higher is required). If predefined is chosen the cards will be detected in that order:
  1. Sangoma cards
  2. PRI Digium cards
  3. FXO Digium cards
  4. FXS Digium card
- If set to 'auto', the order of the interfaces depends on the order the cards are detected by the system. Use the Shell module to find out the order. You first need to install the Zaptel-Asterisk-1.2x module (without any interfaces configured) to be able to use this shell feature.
  Navigate to: SOP Shell > Diagnostics > Telephony > PRI Status
- If you want to configure more than 1 Sangoma card, see the Sangoma 1 Administrator Guide.

Note that there is no mapping one to one between a card and an interface. For example:

the interface S-2FXS is used for 2BRI-2FXS cards and also 4BRI-2FXS cards
a Digium 4FXS PCI-E card with 1 module is configured using the same interface than a Digium 8FXS PCI-E card: 8FXS
a 4PRI Digium or Sangoma card needs to be configured using 4 E1 or T1 distinct interfaces.

Also the amount of channels consumed does not always equal the amount of usable channels. It is important to know in order to configure the Analog and Sangoma PRI resources. See below for more details.

Sangoma BRI-FXS / FXS

Physical card	Usable Zaptel channels	Zaptel interface name	Zaptel channels consumed
Sangoma 2BRI-2FXS (B700DE)	2	S-2FXS	24
Sangoma 4BRI-2FXS (B700DE)	2	S-2FXS	24
Sangoma 4FXS (A200)	4	S-4FXS	24
Sangoma 8FXS	8	S-8FXS	24
Sangoma 24FXS	4	S-24FXS	24

Remarks:

The Zaptel-Asterisk-1.2x module is only used for Sangoma cards configured using Sangoma 1.x module (not Sangoma 2)
BRI's channels are not Zaptel channels

PRI / Channel bank

Physical card	Mode	Zaptel interface name	Zaptel channels consumed
Digium 1TEx / Sangoma A10x	E1 Master clock	PRI-E1-MasterClock	31
Digium 1TEx / Sangoma A10x	T1 Master clock	PRI-T1-MasterClock	24
Digium 1TEx / Sangoma A10x	E1 Backup clock	PRI-E1-BackupClock	31
Digium 1TEx / Sangoma A10x	T1 Backup clock	PRI-T1-BackupClock	24
Digium 1TEx	Channel bank	24FXS	24

Remarks:

For Digium 1TE2x and 1TE4x cards, configure several E1 or T1 interfaces, only first one as Master clock.
The Zaptel-Asterisk-1.2x module is used only for Sangoma cards configured using Sangoma 1 (not Sangoma 2)

Zaptel FXS See below a correspondence table between Digium FXS hardware and Zaptel configuration.

Physical card	Usable FXS channels	Zaptel interface name	Zaptel channels consumed
Digium 2FXS PCI	2	4FXS	4
Digium 4FXS PCI	4	4FXS	4
Digium 4FXO PCI	4	4FXO	4
Digium 4FXS PCI-E 4 ports	4	4FXS	4
Digium 4FXS PCI-E 8 ports (1 module)	4	8FXS	8
Digium 8FXS PCI-E 8 ports (2 modules)	8	8FXS	8

Post-Install Actions

This module requires a reboot of the SOP.