isdnCIPmask(D4isdn)

isdnCIPmask -- ISDN compatibility information profile mask parameters

Synopsis

   #include <sys/types.h>
   #include <sys/scoisdn.h>
   
   typedef isdnDword_t isdnCIPmask_t;

Description

The isdnCIPmask parameter is used to select basic classes of incoming calls; the bit position within this mask identifies the related CIP (Compatibility Information Profile) value; see isdnCIPvalue(D4isdn). When an incoming call is received, the ISDN driver tries to match this incoming call to the defined CIP values (more than one value may match). An ISDN_CONNECT.ISDN_IND(D7isdn) message is sent to the application when the bit position within the CIP mask of any matching CIP value is set to 1. The CIP value in this ISDN_CONNECT.ISDN_IND message is set to the highest matching CIP value.

These rules are defined to find matching CIPs:

CIP values defining a Bearer Capability only generate a match with any incoming call that includes a Bearer Capability with the same information. Additional information included in the Bearer Capability information element is ignored. The match is generated regardless of any Low Layer Compatibility or High Layer Compatibility received.
CIP values defining a Bearer Capability and a High Layer Compatibility generate a match with any incoming call that includes a Bearer Capability and a High Layer Compatibility with the same information. The match is generated regardless of any Low Layer Compatibility received.

Bit 0 in the isdnCIPmask has a special meaning. When no other matching bit is set, a ISDN_LISTEN.ISDN_REQ(D7isdn) message is sent to the application with a CIP value of 0. In this case, the application has to evaluate the parameter's Bearer Capability, Low Layer Compatibility, and igh Layer Compatibility to decide if it is compatible to the call.

The isdnCIPmask parameter is used by:

ISDN_LISTEN.ISDN_REQ(D7isdn)

Bit mask values

Valid values are:

ISDN_CIPMSK_NONE: 0x00000000: no connection indication
ISDN_CIPMSK_ANY: 0x00000001: any match
ISDN_CIPMSK_SPEECH: 0x00000002: speech
ISDN_CIPMSK_UNRESTRICTED: 0x00000004: unrestricted digital info
ISDN_CIPMSK_RESTRICTED: 0x00000008: restricted digital info
ISDN_CIPMSK_3KHZAUDIO: 0x00000010: 3.1 kHz audio
ISDN_CIPMSK_7KHZAUDIO: 0x00000020: 7.0 kHz audio
ISDN_CIPMSK_VIDEO: 0x00000040: video
ISDN_CIPMSK_PACKET: 0x00000080: packet mode
ISDN_CIPMSK_56KRATEADAPT: 0x00000100: 56Kbps rate adaptation
ISDN_CIPMSK_UNRESWANN: 0x00000200: unrestricted digital w/ann
ISDN_CIPMSK_TELEPHONY: 0x00010000: telephony
ISDN_CIPMSK_FAXGROUP23: 0x00020000: fax group 2/3
ISDN_CIPMSK_FAXGROUP4: 0x00040000: fax group 4 class 1
ISDN_CIPMSK_TELTXMIXED: 0x00080000: Teletex (basic & mixed)
ISDN_CIPMSK_TELTXPROC: 0x00100000: Teletex (basic & proc)
ISDN_CIPMSK_TELTXBASIC: 0x00200000: Teletex (basic)
ISDN_CIPMSK_VIDEOTEX: 0x00400000: Videotex
ISDN_CIPMSK_TELEX: 0x00800000: Telex
ISDN_CIPMSK_X400: 0x01000000: X.400 message handling
ISDN_CIPMSK_X200: 0x02000000: X.200 OSI applications
ISDN_CIPMSK_7KTELEPHONY: 0x04000000: 7 kHz Telephony
ISDN_CIPMSK_VIDTELFIRST: 0x08000000: Video Tel F.721, first
ISDN_CIPMSK_VIDTELSEC: 0x10000000: Video Tel F.721, second

Examples

For each service, set the one of the indicated bits in the CIP mask:

telephony application

ISDN_CIPMSK_SPEECH: for calls within ISDN from equipment that does not send High Layer Compatibility information
ISDN_CIPMSK_3KHZAUDIO: for calls from the analog network
ISDN_CIPMSK_TELEPHONY: for calls within ISDN from equipment that sends High Layer Compatibility information

fax group 2/3 application

ISDN_CIPMSK_3KHZAUDIO: for calls from the analog network
ISDN_CIPMSK_FAXGROUP23: for calls within ISDN

non-standard 64 Kbps data application

ISDN_CIPMSK_UNRESTRICTED: no checking of High Layer Compatibility information is provided. The application must verify that no High Layer Compatibility information is received.

non-standard 56 Kbps data application

ISDN_CIPMSK_56KRATEADAPT: no checking of High Layer Compatibility information is provided. The application must verify that no High Layer Compatibility information is received.

fax group 4 application

ISDN_CIPMSK_UNRESTRICTED: no checking of High Layer Compatibility information is provided. The application must verify that no High Layer Compatibility information is received.
ISDN_CIPMSK_FAXGROUP4: for calls within ISDN from equipment that sends High Layer Compatibility information

References

Intro(D4isdn), Intro(D7isdn), isdnCIPvalue(D4isdn)

``SCO ISDN adapter drivers'' in Developing MDI network adapter drivers.