Introduction

The beroNet Gateway is a modular SIP Gateway, which translates the SIP Protocol according to RFC3261 [1] into the protocols of the following technologies:

• ISDN PRI and BRI, according to the EuroISDN Standards ITU/T Q.931 [2]
• FXO, FXS
• GSM, via a GSM Module according to the ETSI GSM AT commandset [3]

Each technology of these technologies has at least 1 Information Element which contains the caller-id. Since SIP is a rather loosely defined standard. It has several protocol standard, there are different recommendations and drafts which define where in which Header element the caller-ids can or must be present. The following table shows which kind of Information elements or Header Elements are popular and often used in which technology:

Besides the amount of different fields which contain "the" caller-id, there are also additional sub elements or degrees of freedom, which are discussed in the following chapters. 

Caller-Id Formats

SIP

Each SIP Header which may contain "the" caller-id has follows the same structure:

• From: "FROM_DISPLAYNAME" <FROM_USER@SERVER> 
• P-Asserted-Identity: "PAI_DISPLAYNAME" <PAI_USER@SERVER> 
• P-Preferred-Identity: "PPI_DISPLAYNAME" <PPI_USER@SERVER> 

In a pure SIP Environment, the DISPLAYNAME part contains the users name as text, the USER part contains either the username, but also often the extensions or caller-id. Most SIP providers use the following mapping:

The caller-id itself has also varying possibilities of formatting. The caller-id has typically the following structure:

(international-prefix) (international code) (national code) (base number) (extension) 

the most varying element can be the "international-prefix", which is often just a plus "+" sometimes it may also be a double zero "00".  The following examples show the varying options for the caller-id "+492593890" 

Most providers do only accept one of the above variants, in order to display the correct caller-id or even to forward the call at all. 

ISDN

In ISDN the OAD and OAD2 fields represent the caller-id. They are comparable to the P-Asserted-Id and P-Preferred-Id Headers in SIP. The OAD Information elements carry additional information about the type of the caller-id. There are the following so called type-of-numbers:

• unknown
• local
• national
• international

Depending on the type of number, the caller-id itself must be in the right format, otherwise the PBX / Carrier displays the wrong caller-id or even doesn't forward the call at all. The following table shows for the caller-id "0049302593890" how the type-of-number affects notation of the caller-id:

Gateway Conversion

The beroNet Gateway has also the ability to match dialplan rules against the caller id. It uses the Source in the dialplan for matching and the NewSource to generate the caller id for the outbound technology.

This document describes how to configure the caller id matching and output behaviour of the beroNet Gateway.

...

• 1.1 Destination
• 1.2 Source
  • 1.2.1 Source (from SIP)
  • 1.2.2 Source (to SIP)
  • 1.2.3 Source (from PSTN)
  • 1.2.4 Callerid Restriction/ Anonymity and Privacy
  • 1.2.5 X-BF Headers and IE on SIP

...

New Dialplan

The the beroNet Gateway Dialplan allows to match the dialed Number (Destination) and the Callerid (Source) against Patterns. It also allows to modify the Destination and Callerid, for example to put a prefix (like 0) before a Number. Each Dialplan Rule can carry additional Configuration options that are only valid for this rule. With these tools it is possible to modify the call handling behavior of the beroNet Gateway per Destination Number or per CallerID. One usage example is to enable or disable CLIR per Destination prefix.

...