A. Valentine Internet Draft Hughes Network Systems Ltd Document: draft-ietf-ipcdn-dvbniuif-mib-00.txt February 2001 Category: Standards Track DVB NIU Interface MIB for EuroModem compliant Cable Modems Status of this Memo This document is an Internet-Draft and is in full conformance with all provisions of Section 10 of RFC2026. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet- Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet- Drafts as reference material or to cite them other than as "work in progress." The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts.txt The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. Abstract This memo defines a portion of the Management Information Base (MIB) for use with network management protocols in the Internet community. In particular, it defines a basic set of managed objects for SNMP- based management of DVB interfaces in EuroModem v1.0 compliant Cable Network Interface Units. This memo specifies a MIB module in a manner that is compliant to the SNMP SMIv2[RFC2578][RFC2579][RFC2580]. The set of objects is consistent with the SNMP framework and existing SNMP standards. This memo is a product of the DVB/DAVIC interoperability consortium which has been adopted as a work item of the IPCDN WG. Comments are solicited and should be addressed to the author. 1. The SNMP Management Framework The SNMP Management Framework presently consists of five major components: Valentine Expires August 2001 1 DVB NIU Interface MIB February 2001 o An overall architecture, described in RFC 2571 [RFC2571]. o Mechanisms for describing and naming objects and events for the purpose of management. The first version of this Structure of Management Information (SMI) is called SMIv1 and described in STD 16, RFC 1155 [RFC1155], STD 16, RFC 1212 [RFC1212] and RFC 1215 [RFC1215]. The second version, called SMIv2, is described in STD 58, RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580 [RFC2580]. o Message protocols for transferring management information. The first version of the SNMP message protocol is called SNMPv1 and described in STD 15, RFC 1157 [RFC1157]. A second version of the SNMP message protocol, which is not an Internet standards track protocol, is called SNMPv2c and described in RFC 1901 [RFC1901] and RFC 1906 [RFC1906]. The third version of the message protocol is called SNMPv3 and described in RFC 1906 [RFC1906], RFC 2572 [RFC2572] and RFC 2574 [RFC2574]. o Protocol operations for accessing management information. The first set of protocol operations and associated PDU formats is described in STD 15, RFC 1157 [RFC1157]. A second set of protocol operations and associated PDU formats is described in RFC 1905 [RFC1905]. o A set of fundamental applications described in RFC 2573 [RFC2573] and the view-based access control mechanism described in RFC 2575 [RFC2575]. A more detailed introduction to the current SNMP Management Framework can be found in RFC 2570 [RFC2570]. Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB. Objects in the MIB are defined using the mechanisms defined in the SMI. This memo specifies a MIB module that is compliant to the SMIv2. A MIB conforming to the SMIv1 can be produced through the appropriate translations. The resulting translated MIB must be semantically equivalent, except where objects or events are omitted because no translation is possible (use of Counter64). Some machine readable information in SMIv2 will be converted into textual descriptions in SMIv1 during the translation process. However, this loss of machine readable information is not considered to change the semantics of the MIB. 2. Glossary 2.1. CATV Originally "Community Antenna Television", now used to refer to any Valentine Expires August 2001 2 DVB NIU Interface MIB February 2001 cable or hybrid fiber and cable system used to deliver video signals to a community. 2.2. DAVIC Digital Audiovisual Council. International council for internetworking audio and video systems. 2.3. Downstream The direction from the head-end towards the subscriber. 2.4. DVB Digital Video Broadcasting. The DVB projects produce open and interoperable global standards for digital audio and video distribution. 2.5. EuroModem. EuroModem. A specification for an interoperable European Cable Modem [EUROM]. 2.6. Head-end The origination point in most cable systems of the subscriber video signals. Generally also the location of the INA equipment. 2.7. INA Interactive Network Adapter. This can act as a bridge or router in the cable head-end. It is responsible for controlling the bandwidth available to each NIU. 2.8. NIU Network Interface Unit. The unit is located at the subscriber premises and provides interactive services via the cable network. The NIU is under the control of the INA, but may request additional bandwidth/connections when required. The NIU can act as a bridge or router. 2.9. QPSK Quadrature Phase Shift Keying. A particular modulation scheme on an RF medium. See [19]. 2.10. QAM Quadrature Amplitude Modulation. A particular modulation scheme on on RF medium. Usually expressed with a number indicating the size of the modulation constellation (e.g. 16 QAM). 2.11. RF Valentine Expires August 2001 3 DVB NIU Interface MIB February 2001 Radio Frequency. 2.12. Upstream The direction from the subscriber towards the head-end. 3. Overview This MIB provides a set of objects required for the management of Euromodem compliant DVB interfaces. The specification is derived in part from the parameters and protocols described in the Technical Specification of a European Cable Modem for digital bi-directional communications via cable networks [EUROM]. 3.1. Structure of the MIB This MIB is structured as three main groups: o Management information pertinent to the MAC layer (dvbNiuMacObjects). This group is further subdivided into a capabilities group (dvbNiuMacCap) and statistics group (dvbNiuMacStats). o Management information pertinent to RF downstream (dvbNiuDsRfObjects). o Management information pertinent to RF upstream (dvbNiuUsRfObjects). The tables contained in each group can be considered extensions to the ifEntry. 3.1.1. dvbNiuMacObjects dvbNiuMacCapTable - This table describes which MAC capabilities are supported by the NIU. DvbNiuMacStatsTable - This table is used to monitor the status and collect statistics for the MAC layer. 3.1.2. dvbNiuDsRfObjects dvbNiuRfDsTable - This table is used to describe the RF downstream and allows configuration of downstream channel scanning. 3.1.3. dvbNiuUsRfObjects dvbNiuRfUsTable - This table is used to describe the RF upstream. 3.2. Relationship to the Interfaces MIB Valentine Expires August 2001 4 DVB NIU Interface MIB February 2001 This section clarifies the relationship of this MIB to the Interfaces MIB [RFC2863]. Several areas of correlation are addressed in the following subsections. The implementer is referred to the Interfaces MIB document in order to understand the general intent of these areas. 3.2.1. Layering Model An instance of ifEntry exists for each RF Downstream interface, for each RF Upstream interface, and for each RF MAC layer. The ifStackTable [RFC2863] MUST be implemented to identify relationships among sub-interfaces. The following example illustrates a MAC interface with one downstream and two upstream channels. | <== to network layer +-------------+--------------+ | RF MAC | +----+---------+-----------+-+ | | | +---------+---+ +---+-------+ +-+---------+ | Downstream1 | | Upstream1 | | Upstream2 | +-------------+ +-----------+ +-----------+ As can be seen from this example, the RF MAC interface is layered on top of the downstream and upstream interfaces. In this example, the assignment of index values could be as follows: ifIndex ifType Description 1 dvbRccMacLayer(146) DVB CATV MAC Layer 2 dvbRccDownstream(147) DVB CATV Downstream interface 3 dvbRccUpstream(148) DVB CATV Upstream interface 4 dvbRccUpstream(148) DVB CATV Upstream interface The corresponding ifStack entries would then be: | IfStackHigherLayer | ifStackLowerLayer | | 0 | 1 | | 1 | 2 | | 1 | 3 | | 1 | 4 | | 2 | 0 | | 3 | 0 | | 4 | 0 | 3.2.2. Virtual Circuits The DVB MAC layer supports the concept of virtual circuits, but these do not have entries in the ifTable. Valentine Expires August 2001 5 DVB NIU Interface MIB February 2001 3.2.3. ifTestTable The ifTestTable is not supported by this MIB. 3.2.4. ifRcvAddressTable The ifRcvAddressTable is supported by this MIB only for the MAC Layer interface. 3.2.5. ifEntry This section documents only the differences from the requirements specified in the Interfaces MIB. See that MIB for columns omitted from the descriptions below. 3.2.5.1. ifEntry for Downstream interfaces The ifEntry for Downstream interfaces supports the ifGeneralInformationGroup and the ifPacketGroup of the Interfaces MIB. This is an input only interface at the NIU and all output status counters - ifOut* - will return zero. 3.2.5.1.1. ifEntry for Downstream interfaces in Cable Modems ifTable Comments ============== =========================================== ifIndex Each RF Cable Downstream interface is represented by an ifEntry. ifType The IANA value of dvbRccDownstream(147). ifSpeed Return the speed of this downstream channel. The returned value the raw bandwidth in bits/s of this interface. This is the symbol rate multiplied with the number of bits per symbol. ifPhysAddress Return an empty string. ifAdminStatus The administrative status of this interface. ifOperStatus The current operational status of this interface. ifMtu The size of the largest frame which can be received from this interface, specified in octets. The value includes the length of the MAC header. ifInOctets The total number of octets received on this interface. This includes data packets as well as MAC layer packets, and includes the length of the MAC header. Valentine Expires August 2001 6 DVB NIU Interface MIB February 2001 ifInUcastPkts The number of Unicast packets received on this interface. This includes data packets as well as MAC layer packets. ifInMulticastPkts Return the number of Multicast packets received on this interface. This includes data packets as well as MAC layer packets. ifInBroadcastPkts Return the number of Broadcast packets received on this interface. This includes data packets as well as MAC layer packets. ifInDiscards The total number of received packets which have been discarded. The possible reasons are: buffer shortage. ifInErrors The number of inbound packets that contained errors preventing them from being deliverable to higher layers. Possible reasons are: MAC FCS error. ifInUnknownProtos The number of frames with an unknown packet type. These are MAC frames with an unknown packet type. ifOutOctets Return zero. ifOutUcastPkts Return zero. ifOutMulticastPkts Return zero. ifOutBroadcastPkts Return zero. ifOutDiscards Return zero. ifOutErrors Return zero. ifPromiscuousMode Refer to the Interfaces MIB. 3.2.5.2. ifEntry for Upstream interfaces The ifEntry for Upstream interfaces supports the ifGeneralInformationGroup and the ifPacketGroup of the Interfaces MIB. This is an output only interface at the NIU and all input status counters - ifIn* - will return zero. 3.2.5.2.1. ifEntry for Upstream interfaces in NIUs ifTable Comments ============== =========================================== ifIndex Each RF Cable Upstream interface is represented Valentine Expires August 2001 7 DVB NIU Interface MIB February 2001 by an ifEntry. ifType The IANA value of dvbRccUpstream(148). ifSpeed Return the speed of this upstream channel. The returned value is the raw bandwidth in bits/s of this interface, regarding the highest speed modulation profile that is defined. This is the symbol rate multiplied with the number of bits per symbol for this modulation profile. ifPhysAddress Return an empty string. ifAdminStatus The administrative status of this interface. ifOperStatus The current operational status of this interface. ifMtu The size of the largest frame which can be transmitted on this interface, specified in octets. The value includes the length of the MAC header. ifInOctets Return zero. ifInUcastPkts Return zero. ifInMulticastPkts Return zero. ifInBroadcastPkts Return zero. ifInDiscards Return zero. ifInErrors Return zero. ifInUnknownProtos Return zero. ifOutOctets The total number of octets transmitted on this interface. This includes MAC packets as well as data packets, and includes the length of the MAC header. ifOutUcastPkts The number of Unicast packets transmitted on this interface. This includes MAC packets as well as data packets. ifOutMulticastPkts Return the number of Multicast packets transmitted on this interface. This includes MAC packets as well as data packets. Valentine Expires August 2001 8 DVB NIU Interface MIB February 2001 ifOutBroadcastPkts Return the number of broadcast packets transmitted on this interface. This includes MAC packets as well as data packets. ifOutDiscards The total number of outbound packets which were discarded. Possible reasons are: buffer shortage. ifOutErrors The number of packets which could not be transmitted due to errors. ifPromiscuousMode Return false. 3.2.5.3. ifEntry for the MAC Layer The ifEntry for the MAC Layer supports the ifGeneralInformationGroup and the ifPacketGroup of the Interfaces MIB. This interface provides an aggregate view of status for the lower level Downstream and Upstream interfaces. ifTable Comments ============== =========================================== ifIndex Each RF Cable MAC layer entity is represented by an ifEntry. ifType The IANA value of dvbRccMacLayer(146). ifSpeed Return zero. ifPhysAddress Return the physical address of this interface. ifAdminStatus The administrative status of this interface. ifOperStatus The current operational status of the MAC layer interface. ifHighSpeed Return zero. ifMtu Return 1500. ifInOctets The total number of data octets received on this interface, targeted for upper protocol layers. ifInUcastPkts The number of Unicast packets received on this interface, targeted for upper protocol layers. ifInMulticastPkts Return the number of Multicast packets received on this interface, targeted for upper protocol layers. ifInBroadcastPkts Return the number of Broadcast packets received on this interface, targeted for upper protocol Valentine Expires August 2001 9 DVB NIU Interface MIB February 2001 layers. ifInDiscards The total number of received packets which have been discarded. The possible reasons are: buffer shortage. ifInErrors The number of inbound packets that contained errors preventing them from being deliverable to higher layers. Possible reasons are: data packet FCS error, invalid MAC header. ifInUnknownProtos The number of frames with an unknown packet type. This is the number of data packets targeted for upper protocol layers with an unknown packet type. ifOutOctets The total number of octets, received from upper protocol layers and transmitted on this interface. ifOutUcastPkts The number of Unicast packets, received from upper protocol layers and transmitted on this interface. ifOutMulticastPkts Return the number of Multicast packets received from upper protocol layers and transmitted on this interface. ifOutBroadcastPkts Return the number of broadcast packets received from upper protocol layers and transmitted on this interface. ifOutDiscards The total number of outbound packets which were discarded. Possible reasons are: buffer shortage. ifOutErrors The number of packets which could not be transmitted due to errors. ifPromiscuousMode Refer to the Interfaces MIB. 4. Definitions DVB-CABLE-NIU-IF-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, Counter32, Integer32, Valentine Expires August 2001 10 DVB NIU Interface MIB February 2001 Gauge32, transmission FROM SNMPv2-SMI TruthValue, FROM SNMPv2-TC SnmpAdminString FROM SNMP-FRAMEWORK-MIB OBJECT-GROUP, MODULE-COMPLIANCE FROM SNMPv2-CONF ifIndex FROM IF-MIB; dvbNiuIf MODULE-IDENTITY LAST-UPDATED "9912030000Z" ORGANIZATION "IETF IPCDN Working Group DVB/DAVIC Interoperability Consortium Technical Working Group" CONTACT-INFO " Andrew Valentine Postal: Engineering Design Centre Hughes Network Systems Ltd Saxon Street, Linford Wood, Milton Keynes. MK14 6LD ENGLAND Tel: +44 1908 221122 Fax: +44 1908 221127 E-mail: a.valentine@eu.hns.com IETF IPCDN Working Group General Discussion: ipcdn@ietf.org Subscribe: http://www.ietf.org/mailman/listinfo/ipcdn Archive: ftp://ftp.ietf.org/ietf-mail-archive/ipcdn Co-chairs: Richard Woundy, rwoundy@cisco.com Andrew Valentine, a.valentine@eu.hns.com" DESCRIPTION "The information module for the DVB interfaces found in an EuroModem." REVISION "9912030000Z" DESCRIPTION "The mib has been modified to incorporate the MAC states from dvbNiuOperStatus. These are in dvbNiuMacStatStatus. The compliance section has been fixed." REVISION "9910010000Z" DESCRIPTION "The mib has been modified to incorporate the comments made by the WGT during the 27/28 Sep 1999 meeting. The main areas Valentine Expires August 2001 11 DVB NIU Interface MIB February 2001 affected are dvbNiuMacStatsTable and dvbNiuDsRfObjects" REVISION "9907281500Z" DESCRIPTION "The initial version of the MIB" ::= {transmission xx} dvbNiuMacObjects OBJECT IDENTIFIER ::= {dvbNiuIf 1} dvbNiuDsRfObjects OBJECT IDENTIFIER ::= {dvbNiuIf 2} dvbNiuUsRfObjects OBJECT IDENTIFIER ::= {dvbNiuIf 3} dvbNiuDvbIfConform OBJECT IDENTIFIER ::= {dvbNiuIf 4} -- Define groups under dvbNiuMacObjects dvbNiuMacCap OBJECT IDENTIFIER ::= {dvbNiuMacObjects 1} dvbNiuMacStats OBJECT IDENTIFIER ::= {dvbNiuMacObjects 2} -- Define groups under dvbNiuDsRfObjects dvbNiuDsRfParam OBJECT IDENTIFIER ::= {dvbNiuDsRfObjects 1} -- Define groups under dvbNiuUsRfObjects dvbNiuUsRfParam OBJECT IDENTIFIER ::= {dvbNiuUsRfObjects 1} --Define identifiers under dvbNiuDvbIfConform dvbNiuIfCompliances OBJECT IDENTIFIER ::= {dvbNiuDvbIfConform 1} dvbNiuIfGroups OBJECT IDENTIFIER ::= {dvbNiuDvbIfConform 2} -- Definition of MIB objects -- =============================================================== -- = Mac Capabilities Group = -- =============================================================== -- MAC Capabilities table dvbNiuMacCapTable OBJECT-TYPE SYNTAX SEQUENCE OF DvbNiuMacCapEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains all available MAC capabilites specified in ETS 300 800 (8/3/1999) and identifies whether they are supported on the MAC interface." ::= { dvbNiuMacCap 1 } dvbNiuMacCapEntry OBJECT-TYPE SYNTAX DvbNiuMacCapEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A row provides the supported capabilities for a single MAC interface. An entry in this table exists for each ifEntry Valentine Expires August 2001 12 DVB NIU Interface MIB February 2001 with an ifType of dvbRccMacLayer." INDEX { ifIndex } ::= { dvbNiuMacCapTable 1 } DvbNiuMacCapEntry ::= SEQUENCE { dvbNiuMacCapVer INTEGER, dvbNiuMacCapEncap BITS, dvbNiuMacCapResReqCap TruthValue, dvbNiuMacCapFragMacMess TruthValue, dvbNiuMacCapSecSupp TruthValue, dvbNiuMacCapMinislots TruthValue, dvbNiuMacCapIbSig TruthValue, dvbNiuMacCapOobSig TruthValue, dvbNiuMacCapDsOobBr BITS, dvbNiuMacCapUsBr BITS, dvbNiuMacCapMaxConn Gauge32, dvbNiuMacCapOperation INTEGER } dvbNiuMacCapVer OBJECT-TYPE SYNTAX INTEGER { davic11(1), davic12(2), en301199(20), ets300800v2(29), ets300800v1(30) } MAX-ACCESS read-only STATUS current DESCRIPTION "The mac protocol version." ::= { dvbNiuMacCapEntry 1 } dvbNiuMacCapEncap OBJECT-TYPE SYNTAX BITS { directIp(0), ethernetMacBridge(1), ppp(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "This field is used to identify the encapsulation types supported. These can be direct IP, Ethernet MAC bridging and PPP." ::= { dvbNiuMacCapEntry 2 } dvbNiuMacCapResReqCap OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION Valentine Expires August 2001 13 DVB NIU Interface MIB February 2001 "True if the NIU is able to send MAC Resource Request Messages." ::= { dvbNiuMacCapEntry 3 } dvbNiuMacCapFragMacMess OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "True if the NIU supports fragemented MAC messages." ::= { dvbNiuMacCapEntry 4 } dvbNiuMacCapSecSupp OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "True if the NIU supports the security extensions defined in ETS 300 800." ::= { dvbNiuMacCapEntry 5 } dvbNiuMacCapMinislots OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "True if the NIU is capable of utilising minislots." ::= { dvbNiuMacCapEntry 6 } dvbNiuMacCapIbSig OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "True if the NIU is capable of utilising in band signalling." ::= { dvbNiuMacCapEntry 7 } dvbNiuMacCapOobSig OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "True if the NIU is capable of utilising out of band signalling." ::= { dvbNiuMacCapEntry 8 } dvbNiuMacCapDsOobBr OBJECT-TYPE SYNTAX BITS { d1o544Mbit(0), d3o088Mbit(1) } MAX-ACCESS read-only Valentine Expires August 2001 14 DVB NIU Interface MIB February 2001 STATUS current DESCRIPTION "This field is used to identify the downstream out of band bit rates supported. These are 1.544Mbit/s and 3.088Mbit/s. If dvbNiuMacCapOobSig is false then the value of this Object will be zero." ::= { dvbNiuMacCapEntry 9 } dvbNiuMacCapUsBr OBJECT-TYPE SYNTAX BITS { u256kbit(0), u1o544Mbit(1), u3o88Mbit(2), u6o176Mbit(3) } MAX-ACCESS read-only STATUS current DESCRIPTION "This field is used to identify the upstream bit rates supported. These are 256kbit/s, 1.544Mbit/s, 3.088Mbit/s and 6.176Mbit/s." ::= { dvbNiuMacCapEntry 10 } dvbNiuMacCapMaxConn OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS current DESCRIPTION "The maximum number of connections supported by the NIU." ::= { dvbNiuMacCapEntry 11 } dvbNiuMacCapOperation OBJECT-TYPE SYNTAX INTEGER { one-way(1), two-way(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "The operational mode of the NIU, this can be either one-way or two-way." ::= { dvbNiuMacCapEntry 12 } -- End of MAC capabilities table -- =============================================================== -- = Mac Statistics Group = -- =============================================================== -- MAC Statistics table dvbNiuMacStatsTable OBJECT-TYPE SYNTAX SEQUENCE OF DvbNiuMacStatsEntry Valentine Expires August 2001 15 DVB NIU Interface MIB February 2001 MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains statistics/status associated with the MAC interface. Reading these statistics does not cause the values to be reset. If the statistics are read via a MAC message they will be reset! Note: The error statistics are represented by only 16 bits, this is because the status message only uses 16 bits for the values." ::= { dvbNiuMacStats 1 } dvbNiuMacStatsEntry OBJECT-TYPE SYNTAX DvbNiuMacStatsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A row provides the statistics/status for a single MAC interface. An entry in this table exists for each ifEntry with an ifType of dvbRccMacLayer." INDEX { ifIndex } ::= { dvbNiuMacStatsTable 1 } DvbNiuMacStatsEntry ::= SEQUENCE { dvbNiuMacHwVer SnmpAdminString, dvbNiuMacStatStatus INTEGER, dvbNiuMacStatSlotCfgCrcErrs Gauge32, dvbNiuMacStatRsCorrErrs Gauge32, dvbNiuMacStatATMPacketLosses Gauge32, dvbNiuMacStatSlotConfigCount Gauge32, dvbNiuMacStatSlEsfCrcErrs Gauge32, dvbNiuMacStatRsErrCorrFrms Gauge32, dvbNiuMacStatRsErrNonCorrFrms Gauge32, dvbNiuMacStatSlEsfFrameCount Gauge32, dvbNiuMacStatConCount Gauge32, } dvbNiuMacHwVer OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-only STATUS current DESCRIPTION "The hardware version of the MAC interface. The is a free format text field." ::= { dvbNiuMacStatsEntry 1 } dvbNiuMacStatStatus OBJECT-TYPE SYNTAX INTEGER { scanningForCarrier(1), provisioning(2), invalidSTBNIU(3), timingRangingError(4), Valentine Expires August 2001 16 DVB NIU Interface MIB February 2001 powerRangingError(5), running(6), stopped(7), none(8), other(9) } MAX-ACCESS read-only STATUS current DESCRIPTION "The operational status of the NIU. The statuses 1-8 are from ETS 300 800. The status other(9) is used for any case that is not explicitly identified" ::= { dvbNiuMacStatsEntry 2 } dvbNiuMacStatSlotCfgCrcErrs OBJECT-TYPE SYNTAX Gauge32 (0..65535) MAX-ACCESS read-only STATUS current DESCRIPTION "Counts the number of errors in Slot_Configuration_Count R bytes, as found by the CRC decoder. This object is initialized to 0 at boot and is reset only upon reboot or by a MAC Status message." ::= { dvbNiuMacStatsEntry 3 } dvbNiuMacStatRsCorrErrs OBJECT-TYPE SYNTAX Gauge32 (0..65535) MAX-ACCESS read-only STATUS current DESCRIPTION "Counts the number of errors as corrected by the Reed Solomon decoder. This object is initialized to 0 at boot and is reset only upon reboot or by a MAC Status message." ::= { dvbNiuMacStatsEntry 4 } dvbNiuMacStatATMPacketLosses OBJECT-TYPE SYNTAX Gauge32 (0..65535) MAX-ACCESS read-only STATUS current DESCRIPTION "Counts the number of received ATM cells that were lost, either due to unrecoverable Reed Solomon errors or because of an erroneous HEC of the ATM cells header. This object is initialized to 0 at boot and is reset only upon reboot or by a MAC Status message." ::= { dvbNiuMacStatsEntry 5 } dvbNiuMacStatSlotConfigCount OBJECT-TYPE SYNTAX Gauge32 (0..65535) MAX-ACCESS read-only STATUS current DESCRIPTION "This refers to the number of R-byte sets (Rxa-Rxc) used to Valentine Expires August 2001 17 DVB NIU Interface MIB February 2001 calculate Slot_Configuration_CRC_Error_Count." ::= { dvbNiuMacStatsEntry 6 } dvbNiuMacStatSlEsfCrcErrs OBJECT-TYPE SYNTAX Gauge32 (0..65535) MAX-ACCESS read-only STATUS current DESCRIPTION "Counts the number of CRC errrors found in consecutive C1-C6. This object is initialized to 0 at boot and is reset only upon reboot or by a MAC Status message." ::= { dvbNiuMacStatsEntry 7 } dvbNiuMacStatRsErrCorrFrms OBJECT-TYPE SYNTAX Gauge32 (0..65535) MAX-ACCESS read-only STATUS current DESCRIPTION "Counts the number of MPEG frames received with correctable Reed Solomon errors (IB only). This object is initialized to 0 at boot and is reset only upon reboot or by a MAC Status message." ::= { dvbNiuMacStatsEntry 8 } dvbNiuMacStatRsErrNonCorrFrms OBJECT-TYPE SYNTAX Gauge32 (0..65535) MAX-ACCESS read-only STATUS current DESCRIPTION "Counts the number of MPEG frames received with non correctable Reed Solomon errors (IB only). This object is initialized to 0 at boot and is reset only upon reboot or by a MAC Status message." ::= { dvbNiuMacStatsEntry 9 } dvbNiuMacStatSlEsfFrameCount OBJECT-TYPE SYNTAX Gauge32 (0..65535) MAX-ACCESS read-only STATUS current DESCRIPTION "This is the number of frames the statistics in this message apply on." ::= { dvbNiuMacStatsEntry 10 } dvbNiuMacStatConCount OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of active connections." ::= { dvbNiuMacStatsEntry 11 } Valentine Expires August 2001 18 DVB NIU Interface MIB February 2001 -- End of MAC statistics table -- =============================================================== -- = Downstream RF Parameters Group = -- =============================================================== -- Downstream RF parameters table dvbNiuRfDsTable OBJECT-TYPE SYNTAX SEQUENCE OF DvbNiuRfDsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains RF characteristcs and counters for the downstream interfaces. " ::= { dvbNiuDsRfParam 1 } dvbNiuRfDsEntry OBJECT-TYPE SYNTAX DvbNiuRfDsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A row provides the RF characteristcs, counters and possible frequencies to use when locating a downstream channel for a single downstream RF interface. An entry in this table exists for each ifEntry with an ifType of dvbRccDownstream" INDEX { ifIndex } ::= { dvbNiuRfDsTable 1 } DvbNiuRfDsEntry ::= SEQUENCE { dvbNiuRfDsHwVer SnmpAdminString, dvbNiuRfDsLastGoodFreq Integer32, dvbNiuRfDsBackupFreq Integer32, dvbNiuRfDsLowScanFreq Integer32, dvbNiuRfDsHighScanFreq Integer32, dvbNiuRfDsScanStep Integer32, dvbNiuRfDsOobFreq Integer32, dvbNiuRfDsIbFreq Integer32, dvbNiuRfDsModType INTEGER, dvbNiuRfDsSnrEst Integer32, dvbNiuRfDsPwrLevelEst Integer32 } dvbNiuRfDsHwVer OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-only STATUS current DESCRIPTION "The hardware version of the downstream RF interface. The is a free format text field." ::= { dvbNiuRfDsEntry 1 } Valentine Expires August 2001 19 DVB NIU Interface MIB February 2001 dvbNiuRfDsLastGoodFreq OBJECT-TYPE SYNTAX Integer32 (47000000..1000000000) UNITS "Hz" MAX-ACCESS read-only STATUS current DESCRIPTION "This is the last known good frequency for a downstream channel and is used to locate the channel on power up or reset. If a downstream channel cannot be found at the frequency held by this object then dvbNiuRfDsBackupFreq is tried. If dvbNiuRfDsBackupFreq fails then a frequency scan is performed between dvbNiuRfDsMinScanFreq and dvbNiuRfDsMaxScanFreq with a step size of dvbNiuRfDsScanStep This object will be updated with the freguency of the channel found using the alternative frequencies." DEFVAL { 650000000 } ::= { dvbNiuRfDsEntry 2 } dvbNiuRfDsBackupFreq OBJECT-TYPE SYNTAX Integer32 (47000000..1000000000) UNITS "Hz" MAX-ACCESS read-write STATUS current DESCRIPTION "This is a backup frequency for the downstream channel. This will be used if dvbNiuRfDsLastGoodFreq fails. If this frequency is successfully used then dvbNiuRfDsLastGoodFreq is updated to contain it. If dvbNiuRfDsBackupFreq fails then a frequency scan is performed between dvbNiuRfDsMinScanFreq and dvbNiuRfDsMaxScanFreq with a step size of dvbNiuRfDsScanStep." DEFVAL { 450000000 } ::= { dvbNiuRfDsEntry 3 } dvbNiuRfDsLowScanFreq OBJECT-TYPE SYNTAX Integer32 (47000000..1000000000) UNITS "Hz" MAX-ACCESS read-write STATUS current DESCRIPTION "This is the start of the frequency range to be used for scanning to find a downstream channel. If a downstream channel is found then dvbNiuRfDsLastGoodFreq is updated to contain the new frequency and the scan is terminated. The step size used for the scan is dvbNiuRfDsScanStep." DEFVAL { 110000000 } ::= { dvbNiuRfDsEntry 4 } dvbNiuRfDsHighScanFreq OBJECT-TYPE SYNTAX Integer32 (47000000..1000000000) UNITS "Hz" MAX-ACCESS read-write Valentine Expires August 2001 20 DVB NIU Interface MIB February 2001 STATUS current DESCRIPTION "This is the end of the frequency range to be used for scanningscan to find a downstream channel. If a downstream channel is found then dvbNiuRfDsLastGoodFreq is updated to contain the new frequency and the scan is terminated. The step size used for the scan is dvbNiuRfDsScanStep." DEFVAL { 862000000 } ::= { dvbNiuRfDsEntry 5 } dvbNiuRfDsScanStep OBJECT-TYPE SYNTAX Integer32 (47000000..1000000000) UNITS "Hz" MAX-ACCESS read-write STATUS current DESCRIPTION "This is the step size to be used when scanning for a downstream channel." DEFVAL { 62500 } ::= { dvbNiuRfDsEntry 6 } dvbNiuRfDsOobFreq OBJECT-TYPE SYNTAX Integer32 (47000000..1000000000) UNITS "Hz" MAX-ACCESS read-only STATUS current DESCRIPTION "The frequency of the current downstream out of band channel." ::= { dvbNiuRfDsEntry 7 } dvbNiuRfDsIbFreq OBJECT-TYPE SYNTAX Integer32 (47000000..1000000000) UNITS "Hz" MAX-ACCESS read-only STATUS current DESCRIPTION "The frequency of the current downstream in band channel." ::= { dvbNiuRfDsEntry 8 } dvbNiuRfDsModType OBJECT-TYPE SYNTAX INTEGER { qpsk(2), qam8(3), qam16(4), qam32(5), qam64(6), qam128(7), qam256(8) } MAX-ACCESS read-only Valentine Expires August 2001 21 DVB NIU Interface MIB February 2001 STATUS current DESCRIPTION "The modulation type of the downstream channel." ::= { dvbNiuRfDsEntry 9 } dvbNiuRfDsSnrEst OBJECT-TYPE SYNTAX Integer32 (0..255) UNITS "dB*2" MAX-ACCESS read-only STATUS current DESCRIPTION "The estimated signal to noise ratio of the downstream carrying MAC messages. If the SNR cannot be estinmated it will be 0." ::= { dvbNiuRfDsEntry 10 } dvbNiuRfDsPwrLevelEst OBJECT-TYPE SYNTAX Integer32 (0..255) UNITS "dBuV*2" MAX-ACCESS read-only STATUS current DESCRIPTION "The estimated power level of the downstream carrying MAC messages. If the power level cannot be estinmated it will be 0." ::= { dvbNiuRfDsEntry 11 } -- End of downstream parameters table -- =============================================================== -- = Upstream RF Parameters Group = -- =============================================================== -- Upstream RF parameters table dvbNiuRfUsTable OBJECT-TYPE SYNTAX SEQUENCE OF DvbNiuRfUsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains RF characteristcs and counters for the upstream interfaces." ::= { dvbNiuUsRfParam 1 } dvbNiuRfUsEntry OBJECT-TYPE SYNTAX DvbNiuRfUsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A row provides the RF characteristcs and counters for a single upstream RF interface. An entry in this table exists for each ifEntry with an ifType of dvbRccUpstream" INDEX { ifIndex } Valentine Expires August 2001 22 DVB NIU Interface MIB February 2001 ::= { dvbNiuRfUsTable 1 } DvbNiuRfUsEntry ::= SEQUENCE { dvbNiuRfUsHwVer SnmpAdminString, dvbNiuRfUsFreq Integer32, dvbNiuRfUsPwrCtrlSetting Integer32, dvbNiuRfUsTimeOffsetValue Integer32 } dvbNiuRfUsHwVer OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-only STATUS current DESCRIPTION "The hardware version of the upstream RF interface. The is a free format text field." ::= { dvbNiuRfUsEntry 1 } dvbNiuRfUsFreq OBJECT-TYPE SYNTAX Integer32 (5000000..65000000) UNITS "Hz" MAX-ACCESS read-only STATUS current DESCRIPTION "The frequency of the upstream channel." ::= { dvbNiuRfUsEntry 2 } dvbNiuRfUsPwrCtrlSetting OBJECT-TYPE SYNTAX Integer32 (0..255) UNITS "dBuV*2" MAX-ACCESS read-only STATUS current DESCRIPTION "The actual power used for the upstream transmission. The unit of measure is 0.5dBuV" ::= { dvbNiuRfUsEntry 3 } dvbNiuRfUsTimeOffsetValue OBJECT-TYPE SYNTAX Integer32 (-32768..32767) UNITS "100nsec" MAX-ACCESS read-only STATUS current DESCRIPTION "This represents a relative offset of the upstream transmission timing. A negative value indicates an adjustment forward in time. A positive value indicates an adjustment back in time. The unit of measure is 100 nsec" ::= { dvbNiuRfUsEntry 4 } -- End of upstream parameters table -- Conformance statements Valentine Expires August 2001 23 DVB NIU Interface MIB February 2001 dvbNiuIfCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for EuroModem NIUs which implement the DVB-CABLE-NIU-IF-MIB MIB." MODULE -- dvbNiuIf MANDATORY-GROUPS { dvbNiuMacGroup, dvbNiuDsRfParamGroup, dvbNiuUsRfParamGroup } ::= { dvbNiuIfCompliances 1 } dvbNiuMacGroup OBJECT-GROUP OBJECTS { dvbNiuMacHwVer, dvbNiuMacStatStatus, dvbNiuMacStatSlotCfgCrcErrs, dvbNiuMacStatRsCorrErrs, dvbNiuMacStatATMPacketLosses, dvbNiuMacStatSlotConfigCount, dvbNiuMacStatSlEsfCrcErrs, dvbNiuMacStatRsErrCorrFrms, dvbNiuMacStatRsErrNonCorrFrms, dvbNiuMacStatSlEsfFrameCount, dvbNiuMacStatConCount, dvbNiuMacCapOobSig, dvbNiuMacCapVer, dvbNiuMacCapEncap, dvbNiuMacCapMaxConn, dvbNiuMacCapUsBr, dvbNiuMacCapOperation, dvbNiuMacCapDsOobBr, dvbNiuMacCapResReqCap, dvbNiuMacCapFragMacMess, dvbNiuMacCapSecSupp, dvbNiuMacCapMinislots, dvbNiuMacCapIbSig } STATUS current DESCRIPTION "A collection of objects providing capabilities and statistics for the MAC layer." ::= { dvbNiuIfGroups 1 } dvbNiuDsRfGroup OBJECT-GROUP OBJECTS { dvbNiuRfDsHwVer, dvbNiuRfDsLastGoodFreq, dvbNiuRfDsBackupFreq, dvbNiuRfDsLowScanFreq, dvbNiuRfDsHighScanFreg, dvbNiuRfDsScanStep, Valentine Expires August 2001 24 DVB NIU Interface MIB February 2001 dvbNiuRfDsOobFreq, dvbNiuRfDsIbFreq, dvbNiuRfDsModType, dvbNiuRfDsSnrEst, dvbNiuRfDsPwrLevelEst } STATUS current DESCRIPTION "A collection of objects providing capabilities and statistics for the downstream RF interface." ::= { dvbNiuIfGroups 2 } dvbNiuUsRfGroup OBJECT-GROUP OBJECTS { dvbNiuRfUsHwVer, dvbNiuRfUsFreq, dvbNiuRfUsPwrCtrlSetting, dvbNiuRfUsTimeOffsetValue } STATUS current DESCRIPTION "A collection of objects providing capabilities and statistics for the upstream RF interface." ::= { dvbNiuIfGroups 3 } END 5. Security Considerations This MIB relates to a system which will provide metropolitan public internet access. As such, improper manipulation of the objects represented by this MIB may result in denial of service to a large number of end-users. There are a number of management objects defined in this MIB that have a MAX-ACCESS clause of read-write and/or read-create. Such objects may be considered sensitive or vulnerable in some network environments. The support for SET operations in a non-secure environment without proper protection can have a negative effect on network operations. In addition to those mentioned above: o dvbNiuRfDsBackupFreq, dvbNiuRfDsHighScanFreq, dvbNiuRfDsScanStep and dvbNiuRfDsLowScanFreq can be manipulated to prevent the NIU from acquiring and locking on to the downstream channel, thus resulting in denial of service. This MIB does not affect confidentiality of services on a cable system. Valentine Expires August 2001 25 DVB NIU Interface MIB February 2001 SNMPv1 by itself is not a secure environment. Even if the network itself is secure (for example by using IPSec), even then, there is no control as to who on the secure network is allowed to access and GET/SET (read/change/create/delete) the objects in this MIB. It is recommended that the implementers consider the security features as provided by the SNMPv3 framework. Specifically, the use of the User- based Security Model RFC 2574 [RFC2574] and the View- based Access Control Model RFC 2575 [RFC2575] is recommended. It is then a customer/user responsibility to ensure that the SNMP entity giving access to an instance of this MIB, is properly configured to give access to the objects only to those principals (users) that have legitimate rights to indeed GET or SET (change/create/delete) them. 6. References [RFC2571] Harrington, D., Presuhn, R., and B. Wijnen, "An Architecture for Describing SNMP Management Frameworks", RFC 2571, April 1999. [RFC1155] Rose, M., and K. McCloghrie, "Structure and Identification of Management Information for TCP/IP-based Internets", STD 16, RFC 1155, May 1990. [RFC1212] Rose, M., and K. McCloghrie, "Concise MIB Definitions", STD 16, RFC 1212, March 1991. [RFC1215] M. Rose, "A Convention for Defining Traps for use with the SNMP", RFC 1215, March 1991. [RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case,J., Rose, M., and S. Waldbusser, "Structure of Management Information Version 2 (SMIv2)", STD 58, RFC 2578, April 1999. [RFC2579] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M., and S. Waldbusser, "Textual Conventions for SMIv2", STD 58, RFC 2579, April 1999. [RFC2580] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M., and S. Waldbusser, "Conformance Statements for SMIv2", STD 58, RFC 2580, April 1999. [RFC1157] Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple Network Management Protocol", STD 15, RFC 1157, May 1990. [RFC1901] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Introduction to Community-based SNMPv2", RFC 1901, Valentine Expires August 2001 26 DVB NIU Interface MIB February 2001 January 1996. [RFC1906] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Transport Mappings for Version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1906, January 1996. [RFC2572] Case, J., Harrington D., Presuhn R., and B. Wijnen, "Message Processing and Dispatching for the Simple Network Management Protocol (SNMP)", RFC 2572, April 1999. [RFC2574] Blumenthal, U., and B. Wijnen, "User-based Security Model (USM) for version 3 of the Simple Network Management Protocol (SNMPv3)", RFC 2574, April 1999. [RFC1905] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol Operations for Version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1905, January 1996. [RFC2573] Levi, D., Meyer, P., and B. Stewart, "SNMPv3 Applications", RFC 2573, April 1999. [RFC2575] Wijnen, B., Presuhn, R., and K. McCloghrie, "View-based Access Control Model (VACM) for the Simple Network Management Protocol (SNMP)", RFC 2575, April 1999. [RFC2570] Case, J., Mundy, R., Partain, D., and B. Stewart, "Introduction to Version 3 of the Internet-standard Network Management Framework", RFC 2570, April 1999. [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group MIB", June 2000 [EUROM] ECCA,"Technical Specification of a European Cable Modem for digital bi-directional communications via cable networks", Version 1.0, 12th May 1999 7. Acknowledgments This MIB was the result of the work undertaken by DVB/DAVIC Interoperability consortium to define a common management interface for EuroModem compliant NIU. RFC 2670 edited by Michael St Johns was used as the template for this document. 8. Author's Addresses Valentine Expires August 2001 27 DVB NIU Interface MIB February 2001 Andrew Valentine Engineering Design Centre Hughes Network Systems Ltd Saxon Street, Linford Wood, Milton Keynes. MK14 6LD ENGLAND Phone: +44 1908 221122 Email: a.valentine@eu.hns.com Valentine Expires August 2001 28 DVB NIU Interface MIB February 2001 Full Copyright Statement Copyright (C) The Internet Society (2000). All Rights Reserved. This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process must be followed, or as required to translate it into languages other than English. The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns. This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Acknowledgement Funding for the RFC Editor function is currently provided by the Internet Society. Valentine Expires August 2001 29