467 lines
22 KiB
Plaintext
467 lines
22 KiB
Plaintext
-- ****************************************************************************
|
|
-- ****************************************************************************
|
|
--
|
|
-- Copyright(c) 2004-2005 Mediatrix Telecom, Inc.
|
|
-- Copyright(c) 2008 Media5 Corporation. ("Media5")
|
|
--
|
|
-- NOTICE:
|
|
-- This document contains information that is confidential and proprietary
|
|
-- to Media5.
|
|
--
|
|
-- Media5 reserves all rights to this document as well as to the Intellectual
|
|
-- Property of the document and the technology and know-how that it includes
|
|
-- and represents.
|
|
--
|
|
-- This publication cannot be reproduced, neither in whole nor in part, in
|
|
-- any form whatsoever without written prior approval by Media5.
|
|
--
|
|
-- Media5 reserves the right to revise this publication and make changes at
|
|
-- any time and without the obligation to notify any person and/or entity of
|
|
-- such revisions and/or changes.
|
|
--
|
|
-- ****************************************************************************
|
|
-- ****************************************************************************
|
|
|
|
MX-MGCPNCS-EXPERIMENTAL-MIB
|
|
DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY,
|
|
OBJECT-IDENTITY,
|
|
OBJECT-TYPE,
|
|
Unsigned32
|
|
FROM SNMPv2-SMI
|
|
OBJECT-GROUP,
|
|
MODULE-COMPLIANCE
|
|
FROM SNMPv2-CONF
|
|
ifIndex
|
|
FROM RFC1213-MIB
|
|
MxEnableState
|
|
FROM MX-TC
|
|
mediatrixExperimental
|
|
FROM MX-SMI;
|
|
|
|
mgcpncsExperimentalMIB MODULE-IDENTITY
|
|
LAST-UPDATED "201008180000Z"
|
|
ORGANIZATION "Media5 Corporation"
|
|
CONTACT-INFO "Media5 Corporation
|
|
4229, Garlock Street
|
|
Sherbrooke (Quebec)
|
|
Canada
|
|
Phone: (819) 829-8749
|
|
"
|
|
DESCRIPTION "This MIB contains MGCP/NCS experimental and interoperability
|
|
configuration objects."
|
|
|
|
-- ************************************************************************
|
|
-- Revision history
|
|
-- ************************************************************************
|
|
REVISION "201008180000Z"
|
|
DESCRIPTION "Added the mgcpncsPolarityReversalOnCallingCardServiceToneEnable variable."
|
|
REVISION "200903170000Z"
|
|
DESCRIPTION "Added the mgcpncsBracketsAroundIpAddressInDomainNameEnable variable."
|
|
REVISION "200806130000Z"
|
|
DESCRIPTION "Added the mgcpncsUseItuT38Format variable."
|
|
REVISION "200606090000Z"
|
|
DESCRIPTION "Added the mgcpncsImmediateModemToneReporting, mgcpncsMakeOsiSignalBrief
|
|
and mgcpncsFakeRfc3407Recognition variables."
|
|
REVISION "200605040000Z"
|
|
DESCRIPTION "Added the mgcpncsRtpUdpChecksumEnable variable."
|
|
REVISION "200510170000Z"
|
|
DESCRIPTION "Addition of mgcpncsT38NegociationWithAudioCodec98"
|
|
REVISION "200504180000Z"
|
|
DESCRIPTION "Addition of mgcpncsMultipleFaxToneDetection and
|
|
mgcpncsConnectRtpSockets"
|
|
REVISION "200503070000Z"
|
|
DESCRIPTION "Addition of the mgcpncsValidateOfferAnswerModel variable"
|
|
REVISION "200411080000Z"
|
|
DESCRIPTION "Creation"
|
|
::= { mediatrixExperimental 100 }
|
|
|
|
mgcpncsExperimentalMIBObjects OBJECT IDENTIFIER ::= { mgcpncsExperimentalMIB 1 }
|
|
mgcpncsExperimentalConformance OBJECT IDENTIFIER ::= { mgcpncsExperimentalMIB 2 }
|
|
|
|
-- ************************************************************************
|
|
-- Interopability Group
|
|
-- ************************************************************************
|
|
mgcpncsInterop OBJECT IDENTIFIER ::= { mgcpncsExperimentalMIBObjects 5 }
|
|
|
|
mgcpncsAnswerStreamFormat OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
zeroAnswerStream(1),
|
|
removeAnswerStream(10)
|
|
}
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "The answer to an offered session description is based on
|
|
the offered session description.
|
|
|
|
RFC 3264 stipulates that to reject an offered stream,
|
|
the port number in the corresponding stream in the
|
|
answer MUST be set to zero.
|
|
|
|
However, some gateways prefer to remove the unwanted
|
|
stream from the answer.
|
|
|
|
zeroAnswerStream:
|
|
The port number is set to zero if the corresponding
|
|
stream in the answer is unwanted. This behaviour
|
|
follows the RFC 3264 best practice.
|
|
|
|
removeAnswerStream:
|
|
The unwanted stream is removed from the answer and
|
|
returned to the offerer. This behaviour is kept
|
|
for backward compatibility issue."
|
|
DEFVAL { zeroAnswerStream }
|
|
::= { mgcpncsInterop 5 }
|
|
|
|
mgcpncsOriginLineSessionIDAndVersionMaxLength OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
none(1),
|
|
max-32bits(10),
|
|
max-64bits(20)
|
|
}
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "The maximum length of the session ID and the session
|
|
version number in the origin line (o=) of the SDP.
|
|
|
|
none:
|
|
The session ID and the session version number are
|
|
represented by the 0 value.
|
|
|
|
max-32bits:
|
|
The session ID and the session version number are
|
|
represented with a 32-bit integer. They have a
|
|
maximum length of 10 digits.
|
|
|
|
max-64bits:
|
|
The session ID and the session version number are
|
|
represented with a 64-bit integer. They have a
|
|
maximum length of 20 digits."
|
|
DEFVAL { none }
|
|
::= { mgcpncsInterop 10 }
|
|
|
|
mgcpncsG729AnnexBNegotiation OBJECT-TYPE
|
|
SYNTAX MxEnableState
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "Indicates if the G.729 Annex B is negotiated through
|
|
the session description protocol.
|
|
|
|
RFC 3555 (MIME Type Registration of RTP Payload
|
|
Formats), July 2003 explains how the Annex B can be
|
|
negotiated by using the session description protocol.
|
|
|
|
The Annex B indicates that Annex B, voice activity
|
|
detection, is used or preferred. Permissible values
|
|
are 'yes' and 'no' (without the quotes); 'yes' is
|
|
implied if this parameter is omitted.
|
|
|
|
m=audio 5004 RTP/AVP 0 18 13
|
|
a=fmtp:18 annexb=yes
|
|
|
|
disable:
|
|
The G.729 Annex B is NOT negotiated through the
|
|
session description protocol.
|
|
|
|
In that case, the G.729 Annex B is based on the
|
|
MIB variable voiceIfG729VoiceActivityDetectionEnable.
|
|
When this variable is set to 'enable', the G.729
|
|
codec negotiated as payload number 18 (G729)
|
|
supports the Annex B implicitly.
|
|
|
|
However, when the voiceIfG729VoiceActivityDetectionEnable
|
|
variable is set to 'disable', the G.729 codec
|
|
negotiated as payload number 18 (G729) does NOT
|
|
support the Annex B implicitly.
|
|
|
|
enable:
|
|
The G.729 Annex B is negotiated through the
|
|
session description protocol.
|
|
|
|
In that case, the G.729 Annex B is advertised in
|
|
the offer. The value depends on the MIB variable
|
|
voiceIfG729VoiceActivityDetectionEnable. If this
|
|
variable is set to 'enable', then the Annex B is
|
|
set to 'yes'; otherwise, the value 'no' is
|
|
advertised.
|
|
|
|
The answerer MAY not be able to support the Annex B.
|
|
In that case, the answer to the Annex B can be set
|
|
to 'no'. This forces the offerer not to use the
|
|
Annex B in G.729. However, the opposite is not
|
|
possible. The answerer can NOT force the offerer to
|
|
use the Annex B if this one does not bear such
|
|
capability."
|
|
DEFVAL { disable }
|
|
::= { mgcpncsInterop 15 }
|
|
|
|
mgcpncsValidateOfferAnswerModel OBJECT-TYPE
|
|
SYNTAX MxEnableState
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "Determines whether the unit requires strict adherence to RFC 3264
|
|
from the peer when negotiating capabilities for the establishment
|
|
of a media session.
|
|
|
|
When enabled, the following guidelines from the Offer-Answer Model
|
|
must be strictly followed. An answer must:
|
|
- Include at least one codec from the list that the unit sent in the offer;
|
|
- Avoid adding extra codecs that were not present in the offer;
|
|
- Contain the same number of media lines that the unit put in its offer.
|
|
Otherwise, the answer is rejected and the unit ends the call.
|
|
|
|
When disabled, then the peer can freely:
|
|
- Send back a brand new list of codecs or add new ones to the offered list;
|
|
- Add media lines AFTER the ones found in the offer.
|
|
As long as at least one codec sent back is supported by the unit, the call
|
|
is allowed to go on. Any media lines added by the peer
|
|
is simply ignored."
|
|
DEFVAL { enable }
|
|
::= { mgcpncsInterop 20 }
|
|
|
|
mgcpncsMultipleFaxToneDetection OBJECT-TYPE
|
|
SYNTAX MxEnableState
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "Controls whether the unit reports more than one occurrence
|
|
of the fax tone during the negotiation phase. This when
|
|
event notification requests can be received after the fax
|
|
tone.
|
|
|
|
disable : when establishing a fax call, the unit only
|
|
reports the first occurrence of the fax tone
|
|
event.
|
|
|
|
enable : the unit will report every occurrence of the fax
|
|
tone event."
|
|
DEFVAL { disable }
|
|
::= { mgcpncsInterop 100 }
|
|
|
|
mgcpncsConnectRtpSockets OBJECT-TYPE
|
|
SYNTAX MxEnableState
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "Determines whether the endpoints will listen to RTP sources
|
|
other than the one to which they are sending packets.
|
|
|
|
disable : use unconnected sockets. Endpoints will play any
|
|
RTP packets addressed to them.
|
|
|
|
enable : use connected sockets. Endpoints will only play
|
|
packets coming from the address to which they are
|
|
sending."
|
|
DEFVAL { disable }
|
|
::= { mgcpncsInterop 150 }
|
|
|
|
mgcpncsRtpUdpChecksumEnable OBJECT-TYPE
|
|
SYNTAX MxEnableState
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "Enables/disables the UDP checksum for RTP packets. UDP
|
|
checksum is disabled by default to gain performance.
|
|
|
|
Enable: UDP checksum will be calculated for each RTP
|
|
packet. This may affect performance.
|
|
|
|
Disable: UDP checksum will not be calculated. The value
|
|
0 will be written in the checksum field of each
|
|
RTP packet header."
|
|
DEFVAL { disable }
|
|
::= { mgcpncsInterop 200 }
|
|
|
|
mgcpncsT38CapabilitiesUsingAudioCodec98 OBJECT-TYPE
|
|
SYNTAX MxEnableState
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "Enables or disables parsing of remote SDP in order to
|
|
extract remote T.38 capabilities from an audio stream.
|
|
|
|
This variable is useful when a call-agent is re-using
|
|
the audio stream to advertise the remote T.38
|
|
capabilities instead of creating a new image stream.
|
|
|
|
Enable: Verifies the remote SDP audio stream for the
|
|
T.38 port number. The remote SDP must meet the
|
|
following conditions in order to detect T.38
|
|
capabilities from the audio stream:
|
|
- Single audio stream
|
|
- Single media format 98
|
|
- No rtpmaps
|
|
|
|
Disable: The call-agent never uses the audio stream
|
|
to advertise the remote T.38 port number."
|
|
DEFVAL { disable }
|
|
::= { mgcpncsInterop 250 }
|
|
|
|
mgcpncsImmediateModemToneReporting OBJECT-TYPE
|
|
SYNTAX MxEnableState
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "Controls whether the early detection of a modem tone by the
|
|
the unit is immediately reported to the call agent (when requested)
|
|
or delayed until the exact nature of the transmission has been
|
|
determined.
|
|
Some fax transmissions begin by exchanging modem tones in their
|
|
setup stage; therefore, a little time is needed before the unit
|
|
is able to discriminate between a fax or a modem transmission.
|
|
|
|
enable: The unit will report a modem tone to the call agent
|
|
(assuming the call agent has requested it) as soon as
|
|
it detects one.
|
|
|
|
disable: The unit will wait until it has determined the exact
|
|
nature of a data transmission and then report either
|
|
a fax or a modem tone to the call agent (always assuming
|
|
the call agent has requested it)."
|
|
DEFVAL { disable }
|
|
::= { mgcpncsInterop 300 }
|
|
|
|
mgcpncsMakeOsiSignalBrief OBJECT-TYPE
|
|
SYNTAX MxEnableState
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "For legacy reasons, this variable makes it possible to change the
|
|
behaviour of the Network Disconnect signal (L/osi) by changing its
|
|
type from time-out to brief (see RFC 3435 for a description
|
|
of the various signal types).
|
|
|
|
enable: The L/osi signal will behave like a brief signal.
|
|
|
|
disable: The L/osi signal will conform to its standard definition
|
|
and behave like a time-out signal."
|
|
DEFVAL { disable }
|
|
::= { mgcpncsInterop 350 }
|
|
|
|
mgcpncsFakeRfc3407Recognition OBJECT-TYPE
|
|
SYNTAX MxEnableState
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "Allows recognition of a remote endpoint's T.38 capabilities
|
|
when they are advertised using the notation recommended
|
|
in RFC 3407. More precisely, when enabled, the unit will
|
|
recognize the line 'a=cdsc: 1 image udptl t38' in the following
|
|
SDP:
|
|
|
|
v=0
|
|
c=IN IP4 47.47.47.47
|
|
a=sqn: 0
|
|
a=cdsc: 1 image udptl t38
|
|
m=audio 1234 RTP/AVP 18
|
|
a=ptime:20
|
|
|
|
as valid T.38 support advertisement.
|
|
|
|
No other part of the RFC is supported and the unit itself
|
|
never uses this syntax.
|
|
|
|
enable: T.38 advertisement as described above will be recognized.
|
|
|
|
disable: RFC 3407 syntax will be ignored."
|
|
DEFVAL { disable }
|
|
::= { mgcpncsInterop 400 }
|
|
|
|
mgcpncsUseItuT38Format OBJECT-TYPE
|
|
SYNTAX MxEnableState
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "Determines the format used, in the SDP portion of packets, to advertise
|
|
the unit's T.38 capabilities.
|
|
|
|
disable :
|
|
Support for the boolean T.38 parameters T38FaxFillBitRemoval,
|
|
T38FaxTranscodingMMR and T38FaxTranscodingJBIG
|
|
is advertised by associating a value of 0 (unsupported)
|
|
or 1 (supported) with the parameter in the following manner:
|
|
|
|
a=T38FaxFillBitRemoval:0
|
|
a=T38FaxTranscodingMMR:0
|
|
a=T38FaxTranscodingJBIG:0
|
|
|
|
enable :
|
|
Support for the above T.38 parameters is advertised in conformance with ITU-T
|
|
Recommendation T.38, section D.2.3. The presence of the parameter in the SDP
|
|
indicates support for it (without the need for an associated value), while its
|
|
absence means that it is not supported."
|
|
DEFVAL { disable }
|
|
::= { mgcpncsInterop 450 }
|
|
|
|
mgcpncsBracketsAroundIpAddressInDomainNameEnable OBJECT-TYPE
|
|
SYNTAX MxEnableState
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "Defines when brackets are added around the endpoint's domain name only
|
|
when the configured domain name is an IP address.
|
|
|
|
disable :
|
|
Brackets are not added around the IP address.
|
|
e.g.: aaln/1@192.168.0.1
|
|
|
|
enable :
|
|
Brackets are added around the IP address.
|
|
e.g.: aaln/1@[192.168.0.1]"
|
|
DEFVAL { enable }
|
|
::= { mgcpncsInterop 500 }
|
|
|
|
mgcpncsPolarityReversalOnCallingCardServiceToneEnable OBJECT-TYPE
|
|
SYNTAX MxEnableState
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "Defines if a polarity reversal must be performed before
|
|
playing the calling card service tone when receiving the
|
|
S:L/z signal request.
|
|
|
|
disable :
|
|
Calling card service tone signal request is handled
|
|
normally.
|
|
|
|
enable :
|
|
A polarity reversal is performed before handling the
|
|
calling card service tone signal request."
|
|
DEFVAL { disable }
|
|
::= { mgcpncsInterop 550 }
|
|
|
|
-- ************************************************************************
|
|
-- Conformance information
|
|
-- ************************************************************************
|
|
mgcpncsExperimentalCompliances OBJECT IDENTIFIER ::= { mgcpncsExperimentalConformance 1 }
|
|
|
|
mgcpncsExperimentalBasicComplVer1 MODULE-COMPLIANCE
|
|
STATUS current
|
|
DESCRIPTION "Minimal definitions for the MGCP/NCS experimental group."
|
|
MODULE -- This Module
|
|
MANDATORY-GROUPS {
|
|
mgcpncsExperimentalGroupVer1
|
|
}
|
|
::= { mgcpncsExperimentalCompliances 5 }
|
|
|
|
-- ************************************************************************
|
|
-- MIB variable grouping
|
|
-- ************************************************************************
|
|
mgcpncsExperimentalGroups OBJECT IDENTIFIER ::= { mgcpncsExperimentalConformance 2 }
|
|
|
|
mgcpncsExperimentalGroupVer1 OBJECT-GROUP
|
|
OBJECTS {
|
|
mgcpncsAnswerStreamFormat,
|
|
mgcpncsOriginLineSessionIDAndVersionMaxLength,
|
|
mgcpncsG729AnnexBNegotiation,
|
|
mgcpncsValidateOfferAnswerModel,
|
|
mgcpncsMultipleFaxToneDetection,
|
|
mgcpncsConnectRtpSockets,
|
|
mgcpncsRtpUdpChecksumEnable,
|
|
mgcpncsT38CapabilitiesUsingAudioCodec98,
|
|
mgcpncsImmediateModemToneReporting,
|
|
mgcpncsMakeOsiSignalBrief,
|
|
mgcpncsFakeRfc3407Recognition,
|
|
mgcpncsUseItuT38Format,
|
|
mgcpncsBracketsAroundIpAddressInDomainNameEnable,
|
|
mgcpncsPolarityReversalOnCallingCardServiceToneEnable
|
|
}
|
|
STATUS current
|
|
DESCRIPTION "This group holds the objects that define the MGCP/NCS
|
|
experimental group."
|
|
::= { mgcpncsExperimentalGroups 5 }
|
|
|
|
END
|