Romascanu, Dan (Dan | 7 Feb 2007 16:06
Favicon

RE: Last Call: draft-ietf-hubmib-efm-mib (Definitions and Managed Objects for OAM Functions on Ethernet Like Interfaces) to Proposed Standard

1. The header of the document should include: 'Intended Status -
Proposed Standard'

2. References problems:

- Unused Reference: 'RFC2586' is defined on line 2715, but not
referenced
    '[RFC2586]   Bierman, A., McCloghrie, K., Presuhn, R., "Textual
Convent...'

  - Unused Reference: 'RFC3636' is defined on line 2738, but not
referenced
    '[RFC3636]   Flick, J., "Definitions of Managed Objects for IEEE
802.3...'

  * Downref: Informational Normative Reference: RFC 2586 - this is
actually a typo (should be 2856) combined with another unused references

Now, at least part of these unused references is caused by the fact that
the MIB module does not list (commented) the RFC where the imported TCs
originate. This should be Normative References

Also, I would suggest to replace [RFC3636] with the update draft, which
was already approved by the IESG and is in RFC Editor Queue

3. It would be good to run again the latest version of idnits. There are
more complaints about the boilerplate and about pages exceeding the
maximal allowed number of lines per page.

4. Section 3: 
(Continue reading)

Wijnen, Bert (Bert | 8 Feb 2007 08:35
Favicon

RE: Last Call: draft-ietf-hubmib-efm-mib (Definitions andManaged Objects for OAM Functions on Ethernet Like Interfaces)to Proposed Standard

Thanks Dan,

Wow... as WG chair I missed quite a few it seems.
We will work on these.

Matt, can you take a crack at it?
Or do you want me to suggest resolution first?

Bert 

> -----Original Message-----
> From: Romascanu, Dan (Dan) [mailto:dromasca <at> avaya.com] 
> Sent: woensdag 7 februari 2007 16:06
> To: ietf <at> ietf.org
> Cc: hubmib <at> ietf.org
> Subject: RE: [Hubmib] Last Call: draft-ietf-hubmib-efm-mib 
> (Definitions andManaged Objects for OAM Functions on Ethernet 
> Like Interfaces)to Proposed Standard 
> 
> 1. The header of the document should include: 'Intended 
> Status - Proposed Standard'
> 
> 2. References problems:
> 
> - Unused Reference: 'RFC2586' is defined on line 2715, but 
> not referenced
>     '[RFC2586]   Bierman, A., McCloghrie, K., Presuhn, R., "Textual
> Convent...'
> 
>   - Unused Reference: 'RFC3636' is defined on line 2738, but 
(Continue reading)

Edward Beili | 19 Feb 2007 13:10
Favicon

RE: New things for the EFM-CU-MIB

Dear Hubmib group members,

I would like to hear your opinion on the proposed additions to the EFM-CU-MIB specified in my original mail below.

Regards,
-E.

> -----Original Message-----
> From: Romascanu, Dan (Dan) [mailto:dromasca <at> avaya.com] 
> Sent: Monday, December 11, 2006 16:22
> To: Edward Beili; hubmib <at> ietf.org
> Cc: Wijnen, Bert (Bert)
> Subject: RE: [Hubmib] New things for the EFM-CU-MIB
> 
> I believe that the WG should focus on completing the current 
> charter before discussing about any new work 'stemming from 
> ... latest RFPs', otherwise it risks to run forever trying to
> catch with the permanently moving target of the Ethernet technology.  
> 
> Dan
> 
> -----Original Message-----
> From: Matt Squire [mailto:MSquire <at> HatterasNetworks.com] 
> Sent: Friday, December 08, 2006 2:53
> To: Edward Beili; hubmib <at> ietf.org
> Cc: Wijnen, Bert (Bert); Dan Romascanu (E-mail)
> Subject: RE: [Hubmib] New things for the EFM-CU-MIB
> 
> Hi Ed - 
> 
(Continue reading)

frank.van_der_putten | 19 Feb 2007 13:33
Picon

Re: New things for the EFM-CU-MIB

Edward,

On one hand, the EFM-CU-MUB seems to be a standalone MIB,  including DSL layer 1 objects and  including bonding objects.
On the other hand, as we discussed in DSL Forum, and as I already stated on this mailing list, the bonding MIB should not include duplication of DSL layer 1 objects. We should use separate DSL layer 1 MIB and bonding layer MIB.
It is not clear for me how these two exercises relate. But at least it seems we should only add to EFM-CU-MIB objects that later on can be classified as DSL layer 1 specific (regardless of pair being bonded) xor bonding layer specific (regardless of DSL type used).

As such, I would think that your proposed items:

Item 1: is redundant info in the MIB, calculating median is a job for application on the MIB, not to be part of the MIB
Item 2:  this is DSL layer 1 specific and to be specified for each line separately. Applying the same values to each line is about ease of po[pulation of the MIB object, not to be part of the MIB as separate object
Item 3:  this is also to be specified for each line. Better work with absolute PSD limiting objects than with PBO (at least that is how ADSL&VDSL work in ITU).

Regards,
Frank




Edward Beili wrote:
Dear Hubmib group members, I would like to hear your opinion on the proposed additions to the EFM-CU-MIB specified in my original mail below. Regards, -E.
-----Original Message----- From: Romascanu, Dan (Dan) [mailto:dromasca <at> avaya.com] Sent: Monday, December 11, 2006 16:22 To: Edward Beili; hubmib <at> ietf.org Cc: Wijnen, Bert (Bert) Subject: RE: [Hubmib] New things for the EFM-CU-MIB I believe that the WG should focus on completing the current charter before discussing about any new work 'stemming from ... latest RFPs', otherwise it risks to run forever trying to catch with the permanently moving target of the Ethernet technology. Dan -----Original Message----- From: Matt Squire [mailto:MSquire <at> HatterasNetworks.com] Sent: Friday, December 08, 2006 2:53 To: Edward Beili; hubmib <at> ietf.org Cc: Wijnen, Bert (Bert); Dan Romascanu (E-mail) Subject: RE: [Hubmib] New things for the EFM-CU-MIB Hi Ed - The second two seem useful. The first one doesn't seem that useful as it is easily derived from other entries. In general, I'm not a big fan of adding 2nd level data (e.g. stuff derived from other stuff). My 2 cents. - Matt
-----Original Message----- From: Edward Beili [mailto:EdwardB <at> actelis.com] Sent: Friday, December 08, 2006 12:41 AM To: hubmib <at> ietf.org Cc: Wijnen, Bert (Bert); Romascanu, Dan (Dan) Subject: [Hubmib] New things for the EFM-CU-MIB Hi, I would like to propose a few minor modifications to the EFM-CU-MIB, to provide support for some carrier requirements for the Ethernet over copper, stemming from some latest RFPs. 1. Add a new leaf to efmCuPortStatusTable, showing the equivalent length of the bonded link, which would be calculated as a median of all the efmCuPmeEquivalentLength in the link. 2. Add an optional ability to specify Min and Max noise margin (probably in efmCuPortConfEntry), which would allow one to configure the working SNR range for the lines in the bonded link, that is: - if the SNR Margin on the copper pair in the bonded link (efmCuPmeSnrMgn) goes below specified Min margin, the pair should re-train to achieve higher SNR margin than the Min (e.g. efmCuTargetSnrMgn) - if the SNR Margin on the copper pair goes above specified Max margin, the pair should/could lower its transmitted power (e.g. using Power Back-off if efmCuAdaptiveSpectra is true). 3. Add an ability to specify Min Power Back-off, to allow an operator to limit the signal transmit power to a lower level than that allowed by the spectral limitations placed by the efmCuPme2BRegion and efmCuPme2BsMode. I would appreciate your comments. Regards, -E.
_______________________________________________ Hubmib mailing list Hubmib <at> ietf.org https://www1.ietf.org/mailman/listinfo/hubmib
_______________________________________________
Hubmib mailing list
Hubmib <at> ietf.org
https://www1.ietf.org/mailman/listinfo/hubmib
Edward Beili | 19 Feb 2007 03:10
Favicon

RE: My review of: draft-ietf-hubmib-efm-cu-mib-06.txt

Bert,

I've attached the next version of the efm-cu-mib draft, together with the extracted MIB modules.
This version implements most of your comments, see below for the full list of changes.

Regards,
-E.

> From: Wijnen, Bert (Bert) 
> [mailto:bwijnen <at> alcatel-lucent.com]
> Sent: Thursday, January 18, 2007 21:45
> To: Edward Beili
> Cc: Dan Romascanu (E-mail)
> Subject: RE: [Hubmib] My review of: draft-ietf-hubmib-efm-cu-mib-06.txt

>My appology, "this week" took a bit longer than I had expected. 
>
>So here is my review as WG chair.
>
>- SMICng:
>  W: f(EFM-CU-MIB.mi2), (300,21) Item "efmCuPAFDiscoveryCode" should have SIZE specified
>  W: f(EFM-CU-MIB.mi2), (1178,21) Item "efmCuPAFRemoteDiscoveryCode"
should have SIZE specified
>  W: f(EFM-CU-MIB.mi2), (2925,23) For "efmCuPmeSubTypesSupported", syntax is identical
>
>  for the first two, I think: SIZE(6)
>  for the 3rd one I am OK to let the warning go., i.e. ignore it.

[EB] Corrected as suggested.

>  W: f(IF-CAP-STACK-MIB.mi2), (195,17) Row "ifInvCapStackEntry" does not
>     have a consistent indexing scheme - index items must be in same order
>     as used in INDEX clause for "base row" ifStackEntry
>  E: f(IF-CAP-STACK-MIB.mi2), (291,13) Item "ifInvStackGroup" should be IMPORTed

>  Warning is OK I think, but pls fix error.

[EB] Corrected as suggested.

>- You may want to add a note-to-rfcs-editor to:
>  [I-D.ietf-hubmib-efm-mib]
>             Squire, M., "Definitions and Managed Objects for OAM
>             Functions on Ethernet Like Interfaces",
>             draft-ietf-hubmib-efm-mib-04 (work in progress),
>             March 2006.
>
>  [I-D.ietf-hubmib-rfc3636bis]
>             Beili, E., "Definitions of Managed Objects for IEEE 802.3
>             Medium Attachment Units (MAUs)",
>             draft-ietf-hubmib-rfc3636bis-05 (work in progress),
>             July 2006.
>
>  in which you ask them to replace with actual RFC numbers if those
>  are available at time of publication.

[EB] Done.

>- note that if you do a revision, you must use new copyright
>  and no longer 
>   Copyright (C) The Internet Society (2006).
>  See my earlier post to the hubmib list

[EB] Done.

>- Did we resolve the use of Rowstatus for the ifCapStackTable
>  and ifInvCapStackTable? In any event, pls re-check the
>  feedback we've got on that. I do not think that what we
>  currently have in the MIB module is acceptable.

[EB] Replaced with TruthValue.

>- In order to avoid any possible future name clashed, I would
>  prefer it if we rename Textual Convnetions:
>
>     ProfileIndex ::= TEXTUAL-CONVENTION
>     ProfileIndexOrZero ::= TEXTUAL-CONVENTION
>     ProfileIndexList ::= TEXTUAL-CONVENTION
>     TruthValueOrUnknown ::= TEXTUAL-CONVENTION
>
>  such that they are prefixed with Efm, so I would name them:
>
>     EfmProfileIndex ::= TEXTUAL-CONVENTION
>     EfmProfileIndexOrZero ::= TEXTUAL-CONVENTION
>     EfmProfileIndexList ::= TEXTUAL-CONVENTION
>     EfmTruthValueOrUnknown ::= TEXTUAL-CONVENTION
>
>  this is also common practice in most (if not all) other
>  IETF MIB modules these days

[EB] Done.

>- for efmCuPAFAdminState you describe a few operations that
>  should be ignore when tried. I am not sure how to inerpret
>  that and what would happen when a SNMP SET is received.
>  I would think it is better to say the need to be rejected.
>  (that is, cause an error on an SNMP SET).

[EB] Agreed. All 'ignored' are replaced with 'rejected'

>- for 
>     efmCuPAFDiscoveryCode  OBJECT-TYPE
>       SYNTAX      PhysAddress
>       MAX-ACCESS  read-write
>       STATUS      current
>       DESCRIPTION
>         "PAF Discovery Code of the EFMCu port (PCS).
>         A unique 6 Byte long code used by the Discovery function, when
>         PAF is supported.
>         PCS ports incapable of supporting PAF SHALL return a value of
>         all zeroes. Attempts to change this object SHALL be ignored in
>         this case.
>         This object MUST be instantiated for the -O subtype PCS before
>         writing operations on the efmCuPAFRemoteDiscoveryCode
>         (Set_if_Clear and Clear_if_Same) are performed by PMEs
>         associated with the PCS.
>         The value of this object is read-only for -R port subtypes.
>         The initial value of this object for -R ports after reset
>         is 0. This value may be changed as a result of writing
>         operation on efmCuPAFRemoteDiscoveryCode variable of remote
>         PME of -O subtype, connected to one of the local PMEs
>         associated with the PCS.
>
>         Discovery MUST be performed when the link is Down.
>         Attempts to change this object MUST be rejected with the error
>         inconsistentValue if the link is Up or Initializing.
>
>         The PAF Discovery code maps to the local Discovery code
>         variable in PAF (note that it does not have a corresponding
>         Clause 45 register)"
>       REFERENCE
>         "[802.3ah] 61.2.2.8.3, 61.2.2.8.4, 45.2.6.6.1"
>       ::= { efmCuPortConfEntry 2 }
>
>  I am trying to figure out what made you choose PhysAddress as the
>  SYNTAX for the discovery code. Can you explain, or point me to
>  the 802.3ah clause that explains/justifies that?

[EB] The remote discovery code is defined by 802.3ah as a 6-octets (48-bit)
value, see 45.2.6.8. Clause 61A.2 actually suggests to use a MAC
address for the discovery operation, in order to ensure its 'local uniqueness'.
Since PhysAddress represents media- or physical-level addresses it was
a natural choice. I've added the size attribute to indicate it's length. 

>  I wonder what you mean with "the value of this object is read-only"
>  The value has to be a PhysAddress ( 6 octets) value, no?
>  If you mean that for -R port subtypes the object cannot allow write
>  access, then I would say it in terms aka:
>
>         The initial value of this object for -R port subtypes after
>         reset is all zeroes. For such -R ports, the value of this
>         object cannot be changed directly. The value may be changed
>         as a result of a writing operation on the 
>         efmCuPAFRemoteDiscoveryCode object of a remote PME of 
>         -O subtype, connected to one of the local PMEs
>         associated with the PCS.
>
>  I hope I understood the intention and reworded it properly.

[EB] Corrected as suggested.

>  These day we prefer to not hard-wire SNMP error codes in DESCRIPTION
>  clause, or if we do, then as an example (A MIB could be used by non
>  SNMP protocols). SO I suggest 
>  
>         Discovery MUST be performed when the link is Down.
>         Attempts to change this object MUST be rejected (in case of
>         SNMP with the error  inconsistentValue) if the link is Up 
>         or Initializing.

[EB] Corrected - inserted '(in case of SNMP' to all occurrences of
'with the error'.

>- For efmCuAdminProfile I read in DESCRIPTION clause:
>
>          This object is writable and readable for the -O subtype
>          (2BaseTL-O or 10PassTS-O) EFMCu ports. It is unavailable for
>          the -R  subtype (2BaseTL-R or 10PassTS-R) ports.
>
>  what does it mean that this object is "unavailable"
>  Do you not want it instatntiated in that case, or do you want
>  its value to be ignored/irrelevant? Pls be specific.
>
>  You use that at various other places as well. Pls check and fix.

[EB] Replaced 'unavailable' with 'unsupported'

>- For
>     efmCuPAFRemoteDiscoveryCode  OBJECT-TYPE
>       SYNTAX      PhysAddress
>       MAX-ACCESS  read-write
>       STATUS      current
>       DESCRIPTION
>         "PAF Remote Discovery Code of the PME port at CO.
>         A 6 Byte long Discovery Code of the peer PCS connected via
>         the PME.
>         Reading this object results in a Discovery Get operation.
>         Writing a zero to this object results in a Discovery
>         Clear_if_Same operation (the value of efmCuPAFDiscoveryCode
>         at the peer PCS SHALL be the same as efmCuPAFDiscoveryCode of
>         the local PCS associated with the PME for the operation to
>         succeed).
>         Writing a non-zero value to this object results in a
>         Discovery Set_if_Clear operation.
>         This object does not exist in CPE port subtypes. A zero length
>         octet string SHALL be returned for CPE port subtypes and also
>         when PAF aggregation is not enabled.
>
>  What is "writing a zero value" ??
>  Is that 6 octets, all zeroes?
>  Or one octet conatining zero,
>  or the zero length octet-string?
>  What means "does not exist" is it not instanctiated? I guess so.
>  pls be clear. You do get gaps in the tables if some objects are
>  not instantiated. Might be easier (on NM apps) if there was
>  a value (like all zeros, or zerolength string) that can be ignored.

[EB] Reworded as follows:
       This object is irrelevant in CPE port (-R) subtypes: in this
       case a zero length octet string SHALL be returned on an
       attempt to read this object, writing to this object SHALL
       be ignored.

>- I believe I have seen this SYNTAX
>       SYNTAX      INTEGER {
>         ieee2BaseTLO(1),
>         ieee2BaseTLR(2),
>         ieee10PassTSO(3),
>         ieee10PassTSR(4)
>       }
>  several times. Candidate for a Textual Convention?

[EB] No actually all occurences are different- there are:
efmCuPmeAdminSubType with 7 enums,
efmCuPmeSubTypesSupported with 4 bitmap positions and
efmCuPmeOperSubType with 4 enums.

>- for efmCuPme2BRegion I wonder if we ever (soon?) expect more
>  regions? If so, maybe we ought to make this a TC?
>  How will regions be added?

[EB] Regions for G.SHDSL are defined by the ITU-T in G.991.2 recommendation.
The last revision of this document was done in 2003, and this version
was used as a reference for the IEEE 802.3ah 2BASE-TL specification.
There's no reason to believe that a new region would ever be defined
(unless Japanese decide to play hard and revive this issue:), in any
case even if this happens it would require a re-issue of 802.3 as the
regions are hard-coded in a Clause 45 register. 

>- For efmCuPme2BProfileRowStatus I wonder if any (all?) of the objects
>  in a row can be changed while the row is active? Would that not
>  be disruptive? In any event, pls specify if any (which( objects
>  can be changed or stat eif none can be change in active state.

[EB] I believe that 'read-create' in MAX-ACCESS clause of all the
objects in a row (except for the 'not-accessible' index) already
indicates that in order to change an object in a particular profile,
one would have to create a new one, change the reference(s) from the
old profile to a new one and remove the old (inactive) profile if not
needed anymore.

>  Same question for efmCuPme2BsModeRowStatus, although there a change
>  is probably not disruptive.
>  Pls check all occurences of RowStatus

[EB] Same answer as above.

>- I really wonder if we are doing a smart thing by give the same labels
>  to the various enums in
>          efmCuPme10PBandplanPSDMskProfile  INTEGER,
>          efmCuPme10PUPBOReferenceProfile   INTEGER,
>          efmCuPme10PBandNotchProfiles      BITS,
>          efmCuPme10PPayloadURateProfile    INTEGER,
>          efmCuPme10PPayloadDRateProfile    INTEGER,
>  They have different meanings, don't they? So would it not be better
>  to differentiate between the labels of the neumerations?

[EB] If we take it to extreme why not turning all enums to TCs?
Personally I prefer inline enums (if they are not repeated of course
which would make they perfectly good candidates for TCs) as they
list the values and their meaning in the description for the object -
less jumps between the object and a TC when reading the MIB.

>- For OBBJECT-GROUP definitions, one is NOT supposed to state requirements
>  or optional attributes. Such things (if a group if required or
>optional)
>  are stated in the MODULE-COMPLIANCE.
>  The OBJECT0GROUP macro is ONLY intended to group objects that logically
>  fit together in order to model something.
>  Sof (for example):
>      efmCuBasicGroup OBJECT-GROUP
>        OBJECTS {
>          efmCuPAFSupported,
>          efmCuAdminProfile,
>          efmCuTargetDataRate,
>          efmCuTargetSnrMgn,
>          efmCuAdaptiveSpectra,
>          efmCuPortSide,
>          efmCuFltStatus
>        }
>        STATUS      current
>        DESCRIPTION
>          "A collection of objects required for all of EFMCu ports."
>        ::= { efmCuGroups 1 }
>
>  Sould NOT state that these objects are "required". I would phrase
>  it as:
>          "A collection of objects reperesenting management information
>           that is common for all of EFMCu ports."
>
>  The fact that is is REQUIRED for all EFMCu ports is expressed in
>      efmCuCompliance MODULE-COMPLIANCE
>        STATUS      current
>        DESCRIPTION
>           ... snip ...
>        MODULE  -- this module
>          MANDATORY-GROUPS {
>            efmCuBasicGroup,
>  That is, here it is listed in the MANDATORY-GROUPS clause and so that
>  inidicated that it is required.
>  
>  Pls try to rephrase for all OBJECT-GROUPs

[EB] Done.

>- With regard to naming, I am somewhat worried about the conventions that
>  are used (or maybe those that are not used). I always find it smarter
>  to have all columnar objects in a table prefixed with a string that
>  makes it clear to which table the object belongs. For example for
>  the efmCuPortConfTable:
>
>     EfmCuPortConfEntry ::=
>       SEQUENCE {
>         efmCuPAFAdminState               INTEGER,
>         efmCuPAFDiscoveryCode            PhysAddress,
>         efmCuAdminProfile                ProfileIndexList,
>         efmCuTargetDataRate              Unsigned32,
>         efmCuTargetSnrMgn                Unsigned32,
>         efmCuAdaptiveSpectra             TruthValue,
>         efmCuThreshLowRate               Unsigned32,
>         efmCuLowRateCrossingEnable       TruthValue
>       }
>  
>  I would personally prefer the columns to be alll prefixed with
>  efmCuPortConf, so I would have named them as follows:
>
>     EfmCuPortConfEntry ::=
>       SEQUENCE {
>         efmCuPortConfPAFAdminState               INTEGER,
>         efmCuPortConfPAFDiscoveryCode            PhysAddress,
>         efmCuPortConfAdminProfile                ProfileIndexList,
>         efmCuPortConfTargetDataRate              Unsigned32,
>         efmCuPortConfTargetSnrMgn                Unsigned32,
>         efmCuPortConfAdaptiveSpectra             TruthValue,
>         efmCuPortConfThreshLowRate               Unsigned32,
>         efmCuPortConfLowRateCrossingEnable       TruthValue
>       }
>
>  This also holds true for most (all of) the other tables.
>  My suggested naming convention above has (in my view) 2 advantages:
>  
>    - less change for conflicting names. 
>      I will admit, that this is not too big a risk, since this is
>      all within the same MIB module. Nevertheless, I think it just
>      makes it easier if any additions need to be made in the future.
>    - easier for people to see which objects belong to which tables.
>      I think this is a strong point. But I also understand it is
>      somewhat subjective.
>
>   I can accept if the WG and/or editor/author tells me that I am far
>   too late with this type of comment. It of course requires a quite 
>   massive editorial change. So, although I think it would improve
>   the human-friendlyness of the MIB module, I will not insist on
>   this change.

[EB] While I tend to agree with the advantages of the naming scheme
you proposed, I would like to ask to be forgiven and leave the names
as they are now, due to the following rasons:
- It is a big change (considering also that there are
at least 2 experimental implementations of this draft that I know of)
- Some time ago I was asked to stick with the RFC 2578/2579
recommendation of 32 char restriction - the proposed change would make
some names to be longer than 32 chars. (Yes, I just read RFC 4181 view
on that - the 32 character restriction recommendation of SMIv2 SHOULD
be set aside in favor of promoting clarity and uniqueness). However it
could be argued that it is easier to remember
efmCuLowRateCrossingEnable vs. efmCuPortConfLowRateCrossingEnable

>NITS:
>
>- the RFC editor probably wants you to expand acronyms when they are
>  used for the first time. Pls check you do it for all acronyms.
>  I found for example VDSL, DMT, SHDSL acronyms which have not
>  been expanded.
>  There may be others. Pls check.

[EB] All acronyms are expanded.

>- For:
>      ifCapStackEntry  OBJECT-TYPE
>        SYNTAX      IfCapStackEntry
>        MAX-ACCESS  not-accessible
>        STATUS      current
>        DESCRIPTION
>          "Information on a particular relationship between two
>          sub-layers, specifying that one sub-layer runs on 'top' of the
>          other sub-layer. Each sub-layer corresponds to a conceptual
>
>  I wonder if we should: s/runs on top/can run on 'top'/
>  After all, it is a capability, which not necessarily is used, right?

[EB] Right, replaced to "MAY possibly run on top".

>- for efmCuPAFDiscoveryCode you speak about a "6 Byte code"
>  If this is common 802.3 terminology, then I guess it is OK.
>  I know that some people in the IETF prefer to use 'octet' instead
>  of 'byte'.

[EB] Corrected to "octets".

>- This table
>     efmCuPmeStatusTable OBJECT-TYPE
>       SYNTAX      SEQUENCE OF EfmCuPmeStatusEntry
>       MAX-ACCESS  not-accessible
>       STATUS      current
>       DESCRIPTION
>         "This table provides common status information of EFMCu
>         2BASE-TL/10PASS-TS PME ports. Status information specific
>         to 10PASS-TS PME is represented in efmCuPme10PStatusTable.
>
>         This table contains live data from the equipment. As such,
>         it is NOT persistent."
>       ::= { efmCuPme 3 }
>
>  Is cmposed of just read-only objects. So the last sentence of the
>  DESCRIPTION clause is not needed. In general people expect (I think)
>  writable objects when they see such a ststament.

[EB] You are right. However when one is looking at the description
clause of a 'not-accessible' table, the only way to determine if it is
composed of read-only objects is to check the Max access value of
each and every object in the table. I believe that the 'NOT persistent'
sentence helps reader to understand the nature of a table quicker, so
I would leave it as is.

>- For efmCuPme2BProfileDescr I think I would change the uppercase MAY
>  to a lowercase may.
>  Same for efmCuPme10PProfileDescr.
>  There may be other places. Pls check RFC2119 to understand how/when
>  capilaized terms are needed. They are for COMPLIANCE, the two
>  objects above have no special compliance requirments for content
>  except for adhering to the SYNTAX, right?

[EB] right, changed to lowercase 'may', Also changed in
efmCuPme2BsModeDescr.

>TYPOs:
>- typo in table 1:
>  | ifIndex       | Interface index. Note that each PME and each PCS  |
>  |               | in the EFMCu PHY MUST have a unique index, as     |
>  |               | there some PCS and PME specific attributes        |
>  |               | accessible only on the PCS or PME level.          |
> 
>  s/there some/there are some/ I think

[EB] Corrected.

>- 3rd para of sect 4.3:
>   A specific configuration or administrative profile is assigned to a
>   specific PME via efmCuPmeAdminProfile object.  If
>   efmCuPmeAdminProfile is zero, then efmCuAdminProfile object of the
>   PCS port, connected to the PME, determines the configuration profile
>   (or a list of possible profiles) for that PME.  This mechanism allows
>   to specify a common profile(s) for all PMEs connected to the PCS
>   port, with an ability to change individual PME profiles by setting
>   efmCuPmeAdminProfile object, which overwrites profile set by
>   efmCuAdminProfile.
>
>  s/overwrites profile set by/overwrites the profile set by/
>  I think.

[EB] Corrected. 

> -----Original Message-----
> From: Wijnen, Bert (Bert) [mailto:bwijnen <at> lucent.com]
> Sent: Wednesday, October 18, 2006 5:45 PM
> To: Hubmib Mailing List (E-mail)
> Subject: [Hubmib] My review of: draft-ietf-hubmib-efm-cu-mib-06.txt
> 
> My WG LC review comments are here.
> For the EFM-U-MIB itself I will do a separate posting to the list.
> 
> - Abstract 3rd line
> 
>     This document proposes an extension to the Ethernet-like 
> Interfaces
> 
>   By the time we get published as RFC, we no longer "propose".
>   So how about:
> 
>     This document describes extensions to the Ethernet-like
> Interfaces

[EB] Corrected.

> - Page 7, a nit:
>            // pottentially be connected to the PCS
>   s/pottentially/potentially/
>            // for PCS[i] and there room for another PME in the
>   s/there room/there is room/ ??

[EB] Corrected

> - A nit/typo on page 10:
>    | ifIndex       | Interface index. Note that each PME and 
> each PCS  |
>    |               | in the EFMCu PHY MUST have a unique 
> index, as     |
>    |               | there some PCS and PME specific 
> attributes        |
>    |               | accessible only on the PCS or PME level. 
>          |
> 
>   s/as there some/as there are some/ ??

[EB] Corrected

> - a type in 2nd para in sect 4.2
> 
>    The PME profiles are defined in efmCuPme2BProfileTable and
>    efmCu10PProfileTable for 2BASE-TL and 10PASS-TS PMEs respectively.
> 
>   I think: s/efmCu10PProfileTable/efmCuPme10PProfileTable/
>   So insert "Pme"

[EB] Corrected.

> - SMICng IF-CAP-STACK-MIB tells me:
> 
>     W: f(IF-CAP-STACK-MIB.mi2), (195,17) Row "ifInvCapStackEntry"
>        does not have a consistent indexing scheme - index items must
>        be in same order as used in INDEX clause for "base row"
>        ifStackEntry
> 
>   The above is OK, it is an INVERTED table.
>   So we can ignore the warning.
> 
>     E: f(IF-CAP-STACK-MIB.mi2), (291,13) Item "ifInvStackGroup"
>        should be IMPORTed
> 
>   I think that error should be fixed and we shoul dimport that group.

[EB] Already done.

> - SMICNg EFM-CU-MIB tells me:
> 
>     W: f(EFM-CU-MIB.mi2), (300,21) Item "efmCuPAFDiscoveryCode" should
>        have SIZE specified
> 
>    Do we know a reasonable size for this? In the pseudo code on 
> pages 7/8
>    it speaks about a 6-byte (octet) code. And so does the DESCRIPTION
>    clause. Is it always fixed to 6 octets?
>    Now and in future? If so, I would suggest to use
> 
>         SYNTAX      PhysAddress (SIZE(6))
> 
>     W: f(EFM-CU-MIB.mi2), (1178,21) Item "efmCuPAFRemoteDiscoveryCode"
>        should have SIZE specified
> 
>    Same story for the above.

[EB] Already done.

>     W: f(EFM-CU-MIB.mi2), (2925,23) For "efmCuPmeSubTypesSupported",
>        syntax is identical
> 
>    This is probably OK, although it looks a bit weird:
>           OBJECT      efmCuPmeSubTypesSupported
>           SYNTAX      BITS {
>             ieee2BaseTLO(0),
>             ieee2BaseTLR(1),
>             ieee10PassTSO(2),
>             ieee10PassTSR(3)
>           }
>           DESCRIPTION
>             "Support for all subtypes is not required. 
> However at least
>             one value SHALL be supported"

[EB] Left as is.

> - W.r.t. the SYNTAX of objects ifCapStackStatus and 
> ifInvCapStackStatus
>   I think it would be much better to use a SYNTAX of TruthValue.
>   See my separate posting on this topic to the HubMIB WG list.

[EB] Agreed to use TruthValue. Added a note that the value of false
 (theoreticallypossible but temporary out of service), should not be
confused with a non-existent row (absolutely impossible).

> - I believe that instead of
> 
>       ifCapStackConformance OBJECT IDENTIFIER
>       ::= { ifCapStackObjects 3 }
> 
>   It would be better to adhere to the strcuture suggested by
> RFC4181 page 38
>   and so use instead:
> 
>      ifCapStackConformance  OBJECT IDENTIFIER ::= { ifCapStackMIB 2 }

[EB] Agreed, restructured according to RFC4181, Appendix D: Suggested OID Layout

> - In the Security Considerations section I see capitalized MAY
>   which I think is not what RFC2119 intended. Unless you can 
>   explain to me why this capilaized MAY makes sense, I would
>   prefer if we change it to just lowercase "may" for all
>   occurences in the Security Considerations section.

[EB] All capitalized MAY in the "Security Considerations" section are
changed to lowercase "may"

> - 2nd para on page 83 (a NIT):
>     Even if the network itself is secure (for example by using IPSec),
>   pls change "IPSec" into "IPsec", that is a lower case "s".
>   The current MIB security template has it fixed. I know that the
>   Security ADs want/prefer the proper spelling.

[EB] Done.

> - IANA Considerations.
>   Since you state that some values SHALL be defined in the
>   IANA-MAU-MIB, I think that you make rfc3636bis a normative
>   reference, while it is now listed under informative. And by making
>   that document normative, you/we automagically make sure that this
>   efmCuMIB will not get published before 3636bis.
> 
>   You must also request/ask (in IANA COnsiderations section) that 
>   IANA assigns two new OID branches for
> 
>      ifCapStackMIB ::= { mib-2 ZZZ }
> 
>      efmCuMIB  ::= { mib-2 YYY }

[EB] Corrected

> - If/wehen we do a revision, we must adhere to new boilerplate.
>   That means we must change all occurences of:
> 
>      Copyright (C) The Internet Society (2006).
> 
>   into
> 
>      Copyright (C) The IETF Trust (2006).
> 
>   If you are using xml2rfc, thsi can be achieved with:
> 
>         ipr="full3978update"
> 
>   You can/could not yet know this. I know that this starts on Nov 1st
>   (because I was asked to update the IDChecklist.html.

[EB] Corrected

[EB] Additional changes:
- Replaced Dan Romascanu with Bert Wijnen as the WG chair
- Fixed a typo in the compliance statement for efmCuPmeAdminSubType:
ieee2BaseTSR -> ieee10PassTSO

----------------------------------------------------------------------------------
The following email exchange is provided here for historical purposes

> -----Original Message-----
> From: Wijnen, Bert (Bert) [mailto:bwijnen <at> lucent.com] 
> Sent: Wednesday, October 18, 2006 17:45
> To: Edward Beili
> Cc: csikes <at> zhone.com; Keith McCloghrie; hubmib <at> ietf.org
> Subject: RE: [Hubmib] WGLC for: draft-ietf-hubmib-efm-cu-mib-06.txt
> 
> Having looked at the MIB itself now, it seems to me that the object
>       ifCapStackStatus  OBJECT-TYPE
>         SYNTAX      RowStatus
> would be much better represented by 
>       ifCapStackPossible  OBJECT-TYPE
>         SYNTAX      TruthValue
> where 'true' means it CAN be stacked this way and 'false' 
> means it cannot. That way you re-use an existing TC, and you 
> can exactly represent what you need, no?
> 
> Same for ifInvCapStackStatus
> 
> Bert
> > -----Original Message-----
> > From: Keith McCloghrie [mailto:kzm <at> cisco.com]
> > Sent: Wednesday, October 18, 2006 16:41
> > To: EdwardB <at> actelis.com
> > Cc: csikes <at> zhone.com; bwijnen <at> lucent.com; kzm <at> cisco.com; 
> > hubmib <at> ietf.org
> > Subject: Re: [Hubmib] WGLC for: draft-ietf-hubmib-efm-cu-mib-06.txt
> > 
> > 
> > > The reason I changed the syntax of ifCapStackStatus and 
> > > ifInvCapStackStatus objects from a new enum to the 
> RowStatus was to 
> > > emphasize the similarity between the
> > ifCapStackTable/ifInvCapStackTable
> > > and ifStackTable/ifInvStackTable as well as to try to reuse
> > an existing
> > > textual convention instead of inventing yet another enum.
> >  
> > The motivation is good but it's only valid if the semantics match.
> > 
> > > I don't think making the 
> ifCapStackStatus/ifInvCapStackStatus to be 
> > > read-only is illegal or problematic - the ifInvStackStatus
> > object from
> > > IF-INV-STACK-MIB with a RowStatus syntax is read-only as well.
> >  
> > The ifInvStackTable table has exactly the same structure 
> and content, 
> > and exactly the same number of rows as the ifStackTable.
> > Semantically,
> > ifInvStackStatus *could* be read-create, but if it were, a 
> SetRequest 
> > to ifStackStatus and a SetRequest to ifInvStackStatus would have 
> > exactly the same result, i.e., to make it read-create would be 
> > redundant because it would provide two means of achieving the same 
> > behaviour.  So, making it read-only is a simplification.
> > 
> > > I would also argue that overloading of NotInService value
> > is ok - this
> > > value is defined as:
> > > "- 'NotInService', which indicates that the conceptual row
> > exists in the
> > > agent, but is unavailable for use by the managed device".
> > 
> > 'notInService' is "unavailable for use by the managed 
> device" because 
> > it normally requires an SNMP operation on a RowStatus 
> object to make 
> > it available.  Normally, the necessary operation is on the same 
> > RowStatus object but in the case of ifInvStackStatus (see above 
> > comment on simplification), the operation needs to be on 
> > ifStackStatus.  In contrast,
> > 
> >              notInService(2) - the sub-layer interfaces cannot be
> >                               connected temporarily due to
> >                               unavailability of the interface(s),
> > 
> > The semantics are different here.  It is not an SNMP operation on a 
> > RowStatus object which prevents this row from being 
> "available for use 
> > by the managed device".
> > 
> > > Since these tables are static (read-only) there is no question of 
> > > resource consumption - these rows are never deleted and
> > thus can stay in
> > > NotInService state indefinitely. RFC2579 states that "It is the 
> > > responsibility of the DESCRIPTION clause of the status column to 
> > > indicate what an abnormally long period of time would be."
> > I can add a
> > > sentence in the DESCRIPTION clause saying that an 
> > > ifCapStackStatus/ifInvCapStackStatus may be in the
> > NotInService state
> > > indefinitely, formally complying with RFC2579.
> >  
> > ifInvStackStatus *could* semantically be read-create, but 
> is read-only 
> > so as to remove redundancy.  In contrast, it is the semantics of 
> > ifCapStackStatus and ifInvCapStackStatus which prevent them 
> from being 
> > read-create.
> > 
> > Keith.
> > 
> > > However I'm not bent on staying with RowStatus - I'll move
> > back to the
> > > enum if the group feels it is best.
> > > 
> > > Regards,
> > > -E.
> > > 
> > >   _____
> > > 
> > > > From: Clay Sikes [mailto:csikes <at> paradyne.com]
> > > > Sent: Tuesday, October 17, 2006 23:11
> > > > To: bwijnen <at> lucent.com
> > > > Cc: hubmib <at> ietf.org
> > > > Subject: Re: [Hubmib] WGLC for: 
> > draft-ietf-hubmib-efm-cu-mib-06.txt
> > > 
> > > 
> > > > Hi,
> > > 
> > > > I have run into an issue with the ifCapStackStatus and
> > > ifInvCapStackStatus objects.  Although the ifCapStackMIB
> > passes smilint,
> > > I have seen compilation issues with these objects.  It
> > seems that the
> > > root cause is the combination RowStatus  syntax and the read-only 
> > > max-access (A RowStatus that is read-only seems a bit
> > strange to me).  
> > > The compiler does not generate all the code that is
> > required.  Although
> > > there may or may not be an issue with the compiler, I would
> > beg that the
> > > objects be changed from a RowStatus syntax to a enumeration
> > like what
> > > was in the -05 version of the ID.  This may resolve Keith's
> > issue as
> > > well.
> > > 
> > > > Thoughts?
> > > 
> > > > Thanks,
> > > > Clay
> > > 
> > > > On 10/17/2006 12:09 PM, Keith McCloghrie wrote:
> > > 
> > > > > > This is a formal WG Last Call for
> > > > > >   
> http://www.ietf.org/internet-drafts/draft-ietf-hubmib-efm-cu-m
ib-06.txt
> > > >    
> 
> > > 
> > >       ifCapStackStatus  OBJECT-TYPE
> > >         SYNTAX      RowStatus
> > >         MAX-ACCESS  read-only
> > >         STATUS      current
> > >         DESCRIPTION
> > >           "The status of the 'cross-connect capability' relationship
> > >           between two sub-layers. The following values can be returned:
> > >             active(1)       - indicates that the sub-layer interface,
> > >                               identified by the ifStackLowerLayer MAY
> > >                               be connected to run 'below' the sub-layer
> > >                               interface, identified by the
> > >                               ifStackHigherLayer index.
> > >             notInService(2) - the sub-layer interfaces cannot be
> > >                               connected temporarily due to
> > >                               unavailability of the interface(s), e.g.
> > >                               one of the interfaces is located on a
> > >                               pluggable module which is absent.
> > 
> > > I suggest this is an ill-advised overloading of 'notInService'.
> > > RFC 2579 says:
> > 
> > >             If the management station is prevented from setting the
> > >             status column to `active' (e.g., due to management station
> > >             or network failure) the conceptual row will be left in the
> > >             `notInService' or `notReady' state, consuming resources
> > >             indefinitely.  The agent must detect conceptual rows that
> > >             have been in either state for an abnormally long period of
> > >             time and remove them.  It is the responsibility of the
> > >             DESCRIPTION clause of the status column to indicate what an
> > >             abnormally long period of time would be.  This period of
> > >             time should be long enough to allow for human response time
> > >             (including `think time') between the creation of the
> > >             conceptual row and the setting of the status to `active'.
> > >             In the absence of such information in the DESCRIPTION
> > >             clause, it is suggested that this period be approximately 5
> > >             minutes in length.  This removal action applies not only to
> > >             newly-created rows, but also to previously active rows which
> > >             are set to, and left in, the notInService state for a
> > >             prolonged period exceeding that which is considered normal
> > >             for such a conceptual row.
> > 
> > > In other words, the 'notInService' of RowStatus is for a temporary 
> > > delay in a management station setting it to `active'.  The "temporary"
> > > situation of a "pluggable module which is absent" is liable to be 
> > > much longer than the 5 minutes before the agent is required to 
> > > delete the row.
> > 
> > > Keith.

 TOC 
Network Working Group E. Beili
Internet-Draft Actelis Networks
Intended status: Standards Track February 18, 2007
Expires: August 22, 2007  


Ethernet in the First Mile Copper (EFMCu) Interfaces MIB
draft-ietf-hubmib-efm-cu-mib-07.txt

Status of this Memo

By submitting this Internet-Draft, each author represents that any applicable patent or other IPR claims of which he or she is aware have been or will be disclosed, and any of which he or she becomes aware will be disclosed, in accordance with Section 6 of BCP 79.

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.

This Internet-Draft will expire on August 22, 2007.

Copyright Notice

Copyright © The IETF Trust (2007).

Abstract

This document defines Management Information Base (MIB) modules for use with network management protocols in TCP/IP based internets. This document describes extensions to the Ethernet-like Interfaces MIB and MAU MIB modules with a set of objects for managing Ethernet in the First Mile Copper (EFMCu) interfaces 10PASS-TS and 2BASE-TL, defined in IEEE Std 802.3ah-2004. In addition a set of objects is defined, describing cross-connect capability of a managed device with multi-layer (stacked) interfaces, extending the stack management objects in the Interfaces Group MIB and the Inverted Stack Table MIB modules.


Table of Contents

1.  Introduction
2.  The Internet-Standard Management Framework
3.  Relation to other MIB modules
    3.1.  Relation to Interfaces Group MIB module
        3.1.1.  Layering Model
        3.1.2.  PME Aggregation Function (PAF)
        3.1.3.  Discovery Operation
        3.1.4.  EFMCu ports initialization
        3.1.5.  Usage of ifTable
    3.2.  Relation to SHDSL MIB module
    3.3.  Relation to VDSL MIB module
    3.4.  Relation to Ethernet-Like and MAU MIB modules
4.  MIB Structure
    4.1.  EFM Copper MIB Overview
    4.2.  Interface stack capability MIB Overview
    4.3.  PME Profiles
    4.4.  Mapping of IEEE 802.3ah Managed Objects
5.  Interface Stack Capability MIB Definitions
6.  EFM Copper MIB Definitions
7.  Security Considerations
8.  IANA Considerations
9.  Acknowledgments
10.  Notes to RFC Editor
11.  References
    11.1.  Normative References
    11.2.  Informative References
§  Author's Address
§  Intellectual Property and Copyright Statements



 TOC 

1.  Introduction

New Ethernet-like interfaces have been defined in the Institute of Electrical and Electronics Engineers (IEEE) Standard 802.3ah-2004 [802.3ah] (IEEE, “IEEE Standard for Information technology - Telecommunications and information exchange between systems - Local and metropolitan area networks - Specific requirements - Part 3: Carrier Sense Multiple Access with Collision Detection (CSMA/CD) Access Method and Physical Layer Specifications - Amendment: Media Access Control Parameters, Physical Layers and Management Parameters for Subscriber Access Networks,” September 2004.), a.k.a. Ethernet in the First Mile (EFM), which is now a part of the base IEEE Standard 802.3-2005 [802.3] (IEEE, “IEEE Standard for Information technology - Telecommunications and information exchange between systems - Local and metropolitan area networks - Specific requirements - Part 3: Carrier Sense Multiple Access with Collision Detection (CSMA/CD) Access Method and Physical Layer Specifications,” December 2005.). In particular 2BASE-TL and 10PASS-TS physical interfaces (PHYs), defined over voice-grade copper pairs, have been specified for the long and short reach respectively. These interfaces, collectively called EFM Copper (EFMCu), are based on Single-pair High-speed Digital Subscriber Line (SHDSL) [G.991.2] (ITU-T, “Single-pair High-speed Digital Subscriber Line (SHDSL) transceivers,” December 2003.) and Very High speed Digital Subscriber Line (VDSL) [G.993.1] (ITU-T, “Very High speed Digital Subscriber Line transceivers,” June 2004.) technology, supporting optional Physical Medium Entity (PME) aggregation (a.k.a. multi-pair bonding) with variable rates.

2BASE-TL PHY is capable of providing at least 2Mbps over 2700 m long single copper pair with a mean Bit Error Rate (BER) of 10^-7 (using 5dB target noise margin).

10PASS-TS PHY is capable of providing at least 10Mbps over 750 m long single copper pair with a mean BER of 10^-7 (using 6dB target noise margin).

This memo defines a Management Information Base (MIB) module for use with network management protocols in the Internet community to manage EFMCu interfaces. In addition a MIB module is defined describing cross-connect capability of a stacked interface.

Note that managed objects for Operation, Administration and Management (OAM) and Ethernet over Passive Optical Networks (EPON) clauses of IEEE 802.3ah are defined in EFM-COMMON-MIB [I‑D.ietf‑hubmib‑efm‑mib] (Squire, M., “Definitions and Managed Objects for OAM Functions on Ethernet Like Interfaces,” October 2006.) and EFM-EPON-MIB [I‑D.ietf‑hubmib‑efm‑epon‑mib] (Khermosh, L., “Managed Objects of EPON,” November 2006.) respectively.


 TOC 

2.  The Internet-Standard Management Framework

For a detailed overview of the documents that describe the current Internet-Standard Management Framework, please refer to section 7 of RFC 3410 [RFC3410] (Case, J., Mundy, R., Partain, D., and B. Stewart, “Introduction and Applicability Statements for Internet-Standard Management Framework,” December 2002.).

Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB. MIB objects are generally accessed through the Simple Network Management Protocol (SNMP). Objects in the MIB are defined using the mechanisms defined in the Structure of Management Information (SMI). This memo specifies MIB modules that are compliant to the SMIv2, which is described in STD 58, RFC 2578 [RFC2578] (McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, “Structure of Management Information Version 2 (SMIv2),” April 1999.), STD 58, RFC 2579 [RFC2579] (McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, “Textual Conventions for SMIv2,” April 1999.) and STD 58, RFC 2580 [RFC2580] (McCloghrie, K., Perkins, D., and J. Schoenwaelder, “Conformance Statements for SMIv2,” April 1999.).

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 [RFC2119] (Bradner, S., “Key words for use in RFCs to Indicate Requirement Levels,” March 1997.).


 TOC 

3.  Relation to other MIB modules

This section outlines the relationship of the MIB modules defined in this document with other MIB modules described in the relevant RFCs. Specifically, Interfaces Group MIB (IF-MIB), Ethernet-Like (EtherLike-MIB), MAU (MAU-MIB), SHDSL (HDSL2-SHDSL-LINE-MIB) and VDSL (VDSL-LINE-EXT-MCM-MIB) are discussed.


 TOC 

3.1.  Relation to Interfaces Group MIB module

2BASE-TL and 10PASS-TS PHY's specified in the EFM-CU-MIB module are stacked (a.k.a. aggregated or bonded) Ethernet interfaces and as such are managed using generic interface management objects defined in the IF-MIB [RFC2863] (McCloghrie, K. and F. Kastenholz, “The Interfaces Group MIB,” June 2000.).

The stack management, i.e. actual connection of the sub-layers to the top layer interface, is done via the ifStackTable, as defined in the IF-MIB [RFC2863] (McCloghrie, K. and F. Kastenholz, “The Interfaces Group MIB,” June 2000.) and its inverse ifInvStackTable, as defined in the IF-INVERTED-STACK-MIB [RFC2864] (McCloghrie, K. and G. Hanson, “The Inverted Stack Table Extension to the Interfaces Group MIB,” June 2000.).

The new tables ifCapStackTable and its inverse ifInvCapStackTable defined in the IF-CAP-STACK-MIB module below, extend the stack management with an ability to describe possible connections or cross-connect capability, when a flexible cross-connect matrix is present between the interface layers.


 TOC 

3.1.1.  Layering Model

An EFMCu interface can aggregate up to 32 Physical Medium Entity (PME) sub-layer devices (modems), using so called PME Aggregation Function (PAF).

A generic EFMCu device can have a number of Physical Coding Sublayer (PCS) ports, each connected to a MAC via Medium Independent Interface (MII) at the upper layer, and cross-connected to a number of underlying PMEs, with a single PCS per PME relationship, see clause 61.1 of [802.3ah] (IEEE, “IEEE Standard for Information technology - Telecommunications and information exchange between systems - Local and metropolitan area networks - Specific requirements - Part 3: Carrier Sense Multiple Access with Collision Detection (CSMA/CD) Access Method and Physical Layer Specifications - Amendment: Media Access Control Parameters, Physical Layers and Management Parameters for Subscriber Access Networks,” September 2004.) for more details.

Each PME in the aggregated EFMCu port is represented in the Interface table (ifTable) as a separate interface with ifType of shdsl(169) for 2BASE-TL or vdsl(97) for 10PASS-TS. The ifType values are defined in [IANAifType‑MIB] (Internet Assigned Numbers Authority (IANA), “IANAifType Textual Convention definition,” .).

ifSpeed for each PME SHALL return the actual data bitrate of the active PME (e.g. for 2BaseTL PMEs it is a multiple of 64Kbps). Zero value SHALL be returned when PME is initializing or down.

The ifSpeed of the PCS is the sum of the current operating data rates of all PMEs in the aggregation group, without the 64/65B encapsulation overhead and PAF overhead, but accounting for the Inter-Frame Gaps (IFG).

When using the stated definition of ifSpeed for the PCS, there would be no frame loss in the following configuration (the test-sets are configured to generate 100% of back to back traffic, i.e. minimal IFG, at 10 or 100Mbps, with min and max frame sizes; the EFM interfaces are aggregated, to achieve the shown speed):

[testset]--10BaseT--[CO]--2BaseTL--[CPE]--10BaseT--[testset] ifSpeed= 10Mbps 10Mbps 10Mbps [testset]--100BaseT--[CO]--10PassTS--[CPE]--100BaseT--[testset] ifSpeed= 100Mbps 100Mbps 100Mbps
 Figure 1: Example configuration with no frame loss 

The following figure shows the layering diagram and corresponding use of ifTable and ifMauTable:

_________________________ _ | LLC | | +-------------------------+ | 1 ifEntry | MAC | | ifType: ethernetCsmacd(6) +-------------------------+ > ifMauEntry | Reconsiliation | | ifMauType: dot3MauType2BaseTL or +-------------------------+ | dot3MauType10PassTS | PCS | | +-------------+---+-------+ + | TC \ | | | | +-----\ | | | | | PMA > PME 1 |...| PME N | > N ifEntry (N=1..32) +-----/ | | | | ifType: shdsl(169) or vdsl(97) | PMD/ | | | | -------------+---+------- -
 Figure 2: Use of ifTable and ifMauTable for EFMCu ports 

The ifStackTable is indexed by the ifIndex values of the aggregated EFMCu port (PCS) and the PMEs connected to it. ifStackTable allows a Network Management application to determine which PMEs are connected to a particular PCS and change connections (if supported by the application). The ifInvStackTable, being an inverted version of the ifStackTable, provides an efficient means for a Network Management application to read a subset of the ifStackTable and thereby determine which PCS runs on top of a particular PME.

A new table ifCapStackTable defined in the IF-CAP-STACK-MIB module, specifies for each higher-layer interface (e.g. PCS port) a list of lower-layer interfaces (e.g. PMEs), which can possibly be cross-connected to that higher-layer interface, determined by the cross-connect capability of the device. This table, modeled after ifStackTable, is read only, reflecting current cross-connect capability of a stacked interface, which can be dynamic in some implementations (e.g. if PMEs are located on a pluggable module and the module is pulled out). Note that PME availability per PCS, described by ifCapStackTable, can be constrained by other parameters, for example by aggregation capacity of a PCS or by the PME in question being already connected to another PCS. So, in order to ensure that a particular PME can be connected to the PCS, all respective parameters (e.g. ifCapStackTable, ifStackTable and efmCuPAFCapacity) SHALL be inspected.

The ifInvCapStackTable, also defined in the IF-CAP-STACK-MIB module, describes which higher-layer interfaces (e.g. PCS ports) can possibly be connected to a particular lower-layer interface (e.g. PME), providing inverted mapping of ifCapStackTable. While it contains no additional information beyond that already contained in the ifCapStackTable, the ifInvCapStackTable has the ifIndex values in its INDEX clause in the reverse order, i.e., the lower-layer interface first, and the higher-layer interface second, providing an efficient means for a Network Management application to read a subset of the ifCapStackTable and thereby determine which interfaces can be connected to run on top of a particular interface.


 TOC 

3.1.2.  PME Aggregation Function (PAF)

The PME Aggregation Function (PAF) allows a number of PMEs to be aggregated onto a PCS port, by fragmenting the Ethernet frames, transmitting the fragments over multiple PMEs and assembling the original frames at the remote port. PAF is OPTIONAL, meaning that a device with a single PME MAY perform fragmentation and re-assembly if this function is supported by the device. Note however that the agent is REQUIRED to report on the PAF capability for all EFMCu ports (2BASE-TL and 10PASS-TS).

The EFM-CU-MIB module allows a Network Management application to query PAF capability and enable/disable it if supported. Note that enabling PAF effectively turns on fragmentation and re-assembly, even on a single-PME port.


 TOC 

3.1.3.  Discovery Operation

The EFMCu ports may optionally support discovery operation, whereby PMEs, during initialization, exchange information about their respective aggregation groups (PCS). This information can then be used to detect copper misconnections or for an automatic assignment of the local PMEs into aggregation groups instead of a fixed pre-configuration.

The MIB modules defined in this document allow a Network Management application to control EFM Discovery mechanism and query its results. Note that the Discovery mechanism can work only if PAF is supported and enabled.

Two tables are used by the EFM Discovery mechanism: ifStackTable and ifCapStackTable. The following pseudo-code gives an example of the Discovery and automatic PME assignment for a generic PAF enabled multi-PCS EFMCu device, located at Central Office (CO), using objects defined in these MIB modules and in IF-MIB [Note that automatic PME assignment is only shown here for the purposes of the example. Fixed PME pre-assignment, manual assignment or auto-assignment using an alternative internal algorithm may be chosen by a particular implementation]:

// Go over all PCS ports in the CO device FOREACH pcs[i] IN CO_device { // Perform discovery and auto-assignment only on PAF enabled ports // with room for more PMEs IF ( pcs[i].PAFSupported AND pcs[i].NumPMEs < pcs[i].PAFCapacity ) { dc = pcs[i].DiscoveryCode = MAC[i]; // unique 6-octets per PCS // Go over all disconnected PMEs, which can // potentially be connected to the PCS FOREACH pme[j] IN ifCapStackTable[pcs[i]] AND NOT ifInvStackTable[pme[j]] // not connected { // Try to grab the remote RT_device, by writing the value // of the local 6-octet discovery code to the remote // discovery code register (via handshake mechanism). // This operation is atomic Set-if-Clear action, i.e. it // would succeed only if the remote discovery register was // zero. Read the remote discovery code register via Get // operation to see if the RT_device, attached via the PME // is indeed marked as being the CO_device peer. pme[j].RemoteDiscoveryCode = dc; // Set-if-Clear r = pme[j].RemoteDiscoveryCode; // Get IF ( r == dc AND pcs[i].NumPMEs < pcs[i].PAFCapacity) { // Remote RT_device connected via PME[j] is/was a peer // for PCS[i] and there is room for another PME in the // PCS[i] aggregation group (max. PAF capacity is not // reached yet). // Connect this PME to the PCS (via ifStackTable, // ifInvStackTable being inverse of ifStackTable is // updated automatically) ADD pme[j] TO ifStackTable[pcs[i]]; // pcs[i] is auto-added to ifInvStackTable[pme[j]] pcs[i].NumPMEs = pcs[i].NumPMEs + 1; // Discover all other disconnected PMEs, // attached to the same RT_device and connect them to // the PCS provided there is enough room for more PMEs. FOREACH pme[k] IN ifCapStackTable[pcs[i]] and NOT ifInvStackTable[pme[k]] { r = pme[k].RemoteDiscoveryCode; // Get IF ( r == dc AND pcs[i].NumPMEs < pcs[i].PAFCapacity) { ADD pme[k] TO ifStackTable[pcs[i]]; // pcs[i] is added TO ifInvStackTable[pme[k]] pcs[i].NumPMEs = pcs[i].NumPMEs + 1; } } } // At this point we have discovered all local PMEs which // are physically connected to the same remote RT_device // and connected them to PCS[i]. Go to the next PCS. BREAK; } } }

An SNMP Agent for a EFMCu device builds ifCapStackTable and its inverse ifInvCapStackTable according to the information contained in the Clause 45 PME_Available_register (see [802.3ah] (IEEE, “IEEE Standard for Information technology - Telecommunications and information exchange between systems - Local and metropolitan area networks - Specific requirements - Part 3: Carrier Sense Multiple Access with Collision Detection (CSMA/CD) Access Method and Physical Layer Specifications - Amendment: Media Access Control Parameters, Physical Layers and Management Parameters for Subscriber Access Networks,” September 2004.) 61.1.5.3 and 45.2.3.20).

Adding a PME to the ifStackTable row for a specific PCS, involves actual connection of the PME to the PCS, which can be done by modifying Clause 45 PME_Aggregate_register (see [802.3ah] (IEEE, “IEEE Standard for Information technology - Telecommunications and information exchange between systems - Local and metropolitan area networks - Specific requirements - Part 3: Carrier Sense Multiple Access with Collision Detection (CSMA/CD) Access Method and Physical Layer Specifications - Amendment: Media Access Control Parameters, Physical Layers and Management Parameters for Subscriber Access Networks,” September 2004.) 61.1.5.3 and 45.2.3.21).

Note that PCS port does not have to be operationally 'down' for the connection to succeed. In fact, a dynamic PME addition (and removal) MAY be implemented with an available PME being initialized first (by setting its ifAdminStatus to 'up') and then added to an operationally 'up' PCS port, by modifying a respective ifStackTable (and respective ifInvStackTable) entry.

It is RECOMMENDED that a removal of the last operationally 'up' PME from an operationally 'up' PCS would be rejected by the implementation, as this action would completely drop the link.


 TOC 

3.1.4.  EFMCu ports initialization

EFMCu ports being built on top of xDSL technology, require a lengthy initialization or 'training' process, before any data can pass. During this initialization both ends of a link (peers) work cooperatively to achieve required data rate on a particular copper pair. Sometimes, when the copper line is too long or the noise on the line is too high, that 'training' process may fail to achieve a specific target rate with required characteristics.

The ifAdminStatus object from the IF-MIB, controls the desired state of a PCS with all the PMEs connected to it or of an individual PME port. Setting this object to 'up' instructs a particular PCS or PME to start initialization process, which may take tens of seconds for EFMCu ports, especially if PAF is involved. The ifOperStatus object shows the operational state of an interface (extended by ifMauMediaAvailable object from MAU-MIB for PCS and efmCuPmeOperStatus defined in the EFM-CU-MIB module for PME interfaces).

A disconnected PME may be initialized by changing the ifAdminState from 'down' to 'up'. Changing the ifAdminState to 'up' on the PCS initializes all PMEs connected to that particular PCS. Note that in case of PAF some interfaces may fail to initialize while others succeed. The PCS is considered operationally 'up' if at least one PME aggregated by its PAF is operationally 'up'. When all PMEs connected to the PCS are 'down' the PCS SHALL be considered operationally 'lowerLayerDown'. The PCS SHALL be considered operationally 'notPresent' if it is not connected to any PME. The PCS/PME interface SHALL remain operationally 'down' during initialization.

The efmCuPmeOperStatus defined in the EFM-CU-MIB module expands PME's ifOperStatus value of 'down' to 'downReady', 'downNotReady' and 'init' values, indicating various EFMCu PME specific states.


 TOC 

3.1.5.  Usage of ifTable

Both PME and PCS interfaces of the EFMCu PHY are managed using interface specific management objects defined in the EFM-CU-MIB module and generic interface objects from the ifTable of IF-MIB, with all management table entries referenced by the interface index ifIndex.

The following table summarizes EFMCu specific interpretations for some of the ifTable objects specified by the mandatory ifGeneralInformationGroup:


IF-MIB objectEFMCu interpretation
ifIndex Interface index. Note that each PME and each PCS in the EFMCu PHY MUST have a unique index, as there are some PCS and PME specific attributes accessible only on the PCS or PME level.
ifType ethernetCsmacd(6) for PCS, shdsl(169) for 2BASE-TL PME, vdsl(97) for 10PASS-TS PME
ifSpeed Operating data rate for the PME. For the PCS it is the sum of the current operating data rates of all PMEs in the aggregation group, without the 64/65B encapsulation overhead and PAF overhead, but accounting for the Inter-Frame Gaps (IFG)
ifAdminStatus Setting this object to 'up' instructs a particular PCS (with all PMEs connected to it) or PME to start initialization process
ifOperStatus efmCuPmeOperStatus supplements the 'down' value of ifOperStatus for PMEs.
 Table 1 

 TOC 

3.2.  Relation to SHDSL MIB module

G.SHDSL.bis modems, similar to PME(s) comprising a 2BASE-TL port, are described in HDSL2-SHDSL-LINE-MIB [RFC4319] (Sikes, C., Ray, B., and R. Abbi, “Definitions of Managed Objects for High Bit-Rate DSL - 2nd generation (HDSL2) and Single-Pair High-Speed Digital Subscriber Line (SHDSL) Lines,” December 2005.). Note that not all attributes of G.SHDSL modems reflected in HDSL2-SHDSL-LINE-MIB have adequate management objects (Clause 30 attributes and Clause 45 registers) in the EFM standard.

Because of these differences and for the purposes of simplicity, unification of attributes common to both 2BASE-TL and 10PASS-TS PMEs and name consistency (e.g. prefixing the 2BASE-TL PME related objects with 'efmCuPme2B' instead of 'hdsl2shdsl'), it was decided not to reference HDSL2-SHDSL-LINE-MIB objects, but define all the relevant objects in the EFM-CU-MIB module.

However, if some functionality, not available in the EFM-CU-MIB module, is required and supported by the PME, e.g. performance monitoring, relevant HDSL2-SHDSL-LINE-MIB groups MAY be included and applied for PMEs of 2BASE-TL subtype.


 TOC 

3.3.  Relation to VDSL MIB module

VDSL modems, similar to the PME(s) comprising a 10PASS-TS port, are described in VDSL-LINE-EXT-MCM-MIB [RFC4070] (Dodge, M. and B. Ray, “Definitions of Managed Object Extensions for Very High Speed Digital Subscriber Lines (VDSL) Using Multiple Carrier Modulation (MCM) Line Coding,” May 2005.). Note that not all attributes of VDSL modems reflected in VDSL-LINE-EXT-MCM-MIB have adequate management objects (Clause 30 attributes and Clause 45 registers) in the EFM standard.

Because of these differences and for the purposes of simplicity, unification of attributes common to both 2BASE-TL and 10PASS-TS PMEs and name consistency, it was decided not to reference VDSL-LINE-EXT-MCM-MIB objects, but define all the relevant objects in the EFM-CU-MIB module.

However, if some functionality, not available in the EFM-CU-MIB module, is required and supported by the PME, relevant VDSL-LINE-EXT-MCM-MIB groups MAY be included and applied for PMEs of 10PASS-TS subtype.


 TOC 

3.4.  Relation to Ethernet-Like and MAU MIB modules

The implementation of EtherLike-MIB [RFC3635] (Flick, J., “Definitions of Managed Objects for the Ethernet-like Interface Types,” September 2003.) and MAU-MIB [I‑D.ietf‑hubmib‑rfc3636bis] (Beili, E., “Definitions of Managed Objects for IEEE 802.3 Medium Attachment Units (MAUs),” July 2006.) is REQUIRED for the EFMCu interfaces.

Two new values of ifMauType (OBJECT-IDENTITIES of dot3MauType) and corresponding bit definitions of ifMauTypeListBits (IANAifMauTypeListBits) have been defined in the IANA-MAU-MIB [I‑D.ietf‑hubmib‑rfc3636bis] (Beili, E., “Definitions of Managed Objects for IEEE 802.3 Medium Attachment Units (MAUs),” July 2006.) for the EFMCu MAUs:

  • dot3MauType2BaseTL and b2BaseTL - for 2BASE-TL MAU
  • dot3MauType10PassTS and b10PassTS - for 10PASS-TS MAU

Additionally IANA-MAU-MIB defines two new values of ifMauMediaAvailable, as a textual convention IANAifMauMediaAvailable - availableReduced and ready, specifically for the EFMCu ports. Due to the PME aggregation, the EFMCu interpretation of some possible ifMauMediaAvailable values differs from other MAUs as follows:

  • unknown - the EFMCu interface (PCS with connected PMEs) is initializing
  • ready - the interface is down, at least one PME in the aggregation group (all PMEs connected to the PCS) is ready for handshake
  • available - the interface is up, all PMEs in the aggregation group are up
  • notAvailable - the interface is down, all PMEs in the aggregation group are down, no handshake tones are detected by any PME
  • availableReduced - the interface is up, a link fault is detected at the receive direction by one or more PMEs in the aggregation group, but at least one PME is up
  • pmdLinkFault - a link fault is detected at the receive direction by all PMEs in the aggregation group

As an EtherLike interface every EFMCu port (an ifEntry representing a consolidation of LLC, MAC and PCS (sub)layers) SHALL return an ifType of ethernetCsmacd(6). While most of the MAU characteristics are not applicable to the EFMCu ports (no auto-negotiation, false carriers or jabber), they SHALL return an appropriate ifMauType (dot3MauType2BaseTL or dot3mauType10PassTS) in order to direct the management software to look in the EFM-CU-MIB module for the desired information. For example the information on the particular EFMCu flavor that an EFMCu port is running is available from efmCuOperSubType, defined in the EFM-CU-MIB module.

Since EFMCu PMEs are not EtherLike interfaces, they cannot be instantiated as MAU interface objects.


 TOC 

4.  MIB Structure


 TOC 

4.1.  EFM Copper MIB Overview

The main management objects defined in the EFM-CU-MIB module are split into 2 groups:

  • efmCuPort - containing objects for configuration, capabilities, status and notifications, common to all EFMCu PHYs.
  • efmCuPme - containing objects for configuration, capabilities, status and notifications of EFMCu PMEs.

The efmCuPme group in turn contains efmCuPme2B and efmCuPme10P groups, which define PME Profiles specific to 2BASE-TL and 10PASS-TS PMEs respectively, as well as PME specific status information.


 TOC 

4.2.  Interface stack capability MIB Overview

The IF-CAP-STACK-MIB module contains 2 tables:

  • ifCapStackTable - containing objects that define possible relationships among the sub-layers of an interface with flexible cross-connect (cross-connect capability).
  • ifInvCapStackTable - an inverse of the ifCapstackTable.


 TOC 

4.3.  PME Profiles

Since a managed node can have a large number of EFMCu PHYs, provisioning every parameter on every EFMCu PHY may become burdensome. Moreover, most PMEs are provisioned identically with the same set of parameters. To simplify the provisioning process, the EFM-CU-MIB module makes use of configuration profiles, similar to HDSL2-SHDSL-LINE-MIB and VDSL-LINE-EXT-MCM-MIB. A profile is a set of parameters, used either for configuration or representation of a PME. The same profile can be shared by multiple PME ports, using the same configuration.

The PME profiles are defined in efmCuPme2BProfileTable and efmCuPme10PProfileTable for 2BASE-TL and 10PASS-TS PMEs respectively. There are 12 predefined standard profiles for 2BASE-TL and 22 standard profiles for 10PASS-TS, defined in 802.3ah and dedicated for rapid provisioning of EFMCu PHYs in most scenarios. In addition the EFM-CU-MIB defines two additional predefined profiles for "best-effort" provisioning of 2BASE-TL PMEs. An ability to define new configuration profiles is also provided to allow for EFMCu deployment tailored to specific copper environment and spectral regulations.

A specific configuration or administrative profile is assigned to a specific PME via efmCuPmeAdminProfile object. If efmCuPmeAdminProfile is zero, then efmCuAdminProfile object of the PCS port, connected to the PME, determines the configuration profile (or a list of possible profiles) for that PME. This mechanism allows to specify a common profile(s) for all PMEs connected to the PCS port, with an ability to change individual PME profiles by setting efmCuPmeAdminProfile object, which overwrites the profile set by efmCuAdminProfile.

A current operating PME profile is pointed to by efmCuPmeOperProfile object. Note that this profile entry, can be created automatically, to reflect achieved parameters in adaptive (not fixed) initialization.


 TOC 

4.4.  Mapping of IEEE 802.3ah Managed Objects

This section contains the mapping between relevant managed objects (attributes) defined in [802.3ah] (IEEE, “IEEE Standard for Information technology - Telecommunications and information exchange between systems - Local and metropolitan area networks - Specific requirements - Part 3: Carrier Sense Multiple Access with Collision Detection (CSMA/CD) Access Method and Physical Layer Specifications - Amendment: Media Access Control Parameters, Physical Layers and Management Parameters for Subscriber Access Networks,” September 2004.) Clause 30, and managed objects defined in this document and in associated MIB modules, i.e., the IF-MIB [RFC2863] (McCloghrie, K. and F. Kastenholz, “The Interfaces Group MIB,” June 2000.).

Note that majority of the objects defined in the EFM-CU-MIB module do not have direct counterparts in Clause 30 and instead refer to Clause 45 registers.


IEEE 802.3 Managed ObjectCorresponding SNMP Object
oMAU - Basic Package (Mandatory)  
aMAUType ifMauType (MAU-MIB)
aMAUTypeList ifMauTypeListBits (MAU-MIB)
aMediaAvailable ifMediaAvailable (MAU-MIB)
oPAF - Basic Package (Mandatory)  
aPAFID ifIndex (IF-MIB)
aPhyEnd efmCuPhySide
aPHYCurrentStatus efmCuStatus
aPAFSupported efmCuPAFSupported
oPAF - PME Aggregation Package (Optional)  
aPAFAdminState efmCuPAFAdminState
aLocalPAFCapacity efmCuPAFCapacity
aLocalPMEAvailable ifCapStackTable
aLocalPMEAggregate ifStackTable (IF-MIB)
aRemotePAFSupported efmCuRemotePAFSupported
aRemotePAFCapacity efmCuRemotePAFCapacity
aRemotePMEAggregate  
oPME - 10P/2B Package (Mandatory)  
aPMEID ifIndex (IF-MIB)
aPMEAdminState ifAdminState (IF-MIB)
aPMEStatus efmCuPmeStatus
aPMESNRMgn efmCuPmeSnrMgn
aTCCodingViolations efmCuPmeTCCodingErrors
aTCCRCErrors efmCuPmeTCCrcErrors
aProfileSelect efmCuAdminProfile, efmCuPmeAdminProfile
aOperatingProfile efmCuPmeOperProfile
aPMEFECCorrectedBlocks efmCuPme10PFECCorrectedBlocks
aPMEFECUncorrectableBlocks efmCuPme10PFECUncorrectedBlocks
 Table 2 

 TOC 

5.  Interface Stack Capability MIB Definitions

IF-CAP-STACK-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, mib-2 FROM SNMPv2-SMI -- RFC 2578 TruthValue FROM SNMPv2-TC -- RFC 2579 MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF -- RFC 2580 ifStackGroup2, ifStackHigherLayer, ifStackLowerLayer FROM IF-MIB -- RFC 2863 ifInvStackGroup FROM IF-INVERTED-STACK-MIB -- RFC 2864 ; ifCapStackMIB MODULE-IDENTITY LAST-UPDATED "200702180000Z" -- February 18, 2007 ORGANIZATION "IETF Ethernet Interfaces and Hub MIB Working Group" CONTACT-INFO "WG charter: http://www.ietf.org/html.charters/hubmib-charter.html Mailing Lists: General Discussion: hubmib <at> ietf.org To Subscribe: hubmib-request <at> ietf.org In Body: subscribe your_email_address Chair: Bert Wijnen Postal: Alcatel-Lucent Schagen 33 3461 GL Linschoten Netherlands Tel: +31-348-407-775 E-mail: bwijnen <at> alcatel-lucent.com Editor: Edward Beili Postal: Actelis Networks Inc. 25 Bazel St., P.O.B. 10173 Petach-Tikva 10173 Israel Tel: +972-3-924-3491 E-mail: edward.beili <at> actelis.com" DESCRIPTION "The objects in this MIB module are used to describe cross-connect capabilities of stacked (layered) interfaces, complementing ifStackTable and ifInvStackTable defined in IF-MIB and IF-INVERTED-STACK-MIB respectively. Copyright (C) The IETF Trust (2007). This version of this MIB module is part of RFC XXXX; see the RFC itself for full legal notices." REVISION "200702180000Z" -- February 18, 2007 DESCRIPTION "Initial version, published as RFC XXXX." -- EdNote: Replace XXXX with the actual RFC number & -- remove this note ::= { mib-2 ZZZ } -- EdNote: Replace ZZZ with a real OID once it is -- allocated & remove this note. -- Sections of the module -- Structured as recommended by RFC 4181, see -- Appendix D: Suggested OID Layout ifCapStackObjects OBJECT IDENTIFIER ::= { ifCapStackMIB 1 } ifCapStackConformance OBJECT IDENTIFIER ::= { ifCapStackMIB 2 } -- Groups in the module -- -- ifCapStackTable group -- ifCapStackTable OBJECT-TYPE SYNTAX SEQUENCE OF IfCapStackEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table, modeled after ifStackTable from IF-MIB, contains information on the possible 'on-top-of' relationships between the multiple sub-layers of network interfaces (as opposed to actual relationships described in ifStackTable). In particular, it contains information on which sub-layers MAY possibly run 'on top of' which other sub-layers, as determined by cross-connect capability of the device, where each sub-layer corresponds to a conceptual row in the ifTable. For example, when the sub-layer with ifIndex value x can be connected to run on top of the sub-layer with ifIndex value y, then this table contains: ifCapStackStatus.x.y=true ifCapStackStatus.x.y row does not exist if it is impossible to connect between the sub-layers x and y. Note that for most stacked interfaces (e.g. 2BASE-TL) there's always at least one higher-level interface (e.g. PCS port) for each lower-level interface (e.g. PME) and at least one lower-level interface for each higher-level interface, that is, there is at least a single row with a 'true' status for any existing value of x or y. This table is read only as it describes device capability" REFERENCE "IF-MIB, ifStackTable" ::= { ifCapStackObjects 1 } ifCapStackEntry OBJECT-TYPE SYNTAX IfCapStackEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Information on a particular relationship between two sub-layers, specifying that one sub-layer MAY possibly run on 'top' of the other sub-layer. Each sub-layer corresponds to a conceptual row in the ifTable (interface index for lower- and higher-layer respectively)." INDEX { ifStackHigherLayer, ifStackLowerLayer } ::= { ifCapStackTable 1 } IfCapStackEntry ::= SEQUENCE { ifCapStackStatus TruthValue } ifCapStackStatus OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "The status of the 'cross-connect capability' relationship between two sub-layers. The following values can be returned: true(1) - indicates that the sub-layer interface, identified by the ifStackLowerLayer MAY be connected to run 'below' the sub-layer interface, identified by the ifStackHigherLayer index. false(2) - the sub-layer interfaces cannot be connected temporarily due to unavailability of the interface(s), e.g. one of the interfaces is located on an absent pluggable module. Note that lower-layer interface availability per higher-layer, indicated by the value of 'true', can be constrained by other parameters, for example by the aggregation capacity of a higher-layer interface or by the lower-layer interface in question being already connected to another higher-layer interface. In order to ensure that a particular sub-layer can be connected to another sub-layer, all respective objects (e.g. ifCapStackTable, ifStackTable and efmCuPAFCapacity for for EFMCu interfaces) SHALL be inspected. This object is read only, unlike ifStackStatus, as it describes a cross-connect capability." ::= { ifCapStackEntry 1 } ifInvCapStackTable OBJECT-TYPE SYNTAX SEQUENCE OF IfInvCapStackEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table containing information on the possible relationships between the multiple sub-layers of network interfaces. This table, modeled after ifInvStackTable from IF-INVERTED-STACK-MIB, is an inverse of the ifCapStackTable defined in this MIB module. In particular, this table contains information on which sub-layers MAY run 'underneath' which other sub-layers, where each sub-layer corresponds to a conceptual row in the ifTable. For example, when the sub-layer with ifIndex value x MAY be connected to run underneath the sub-layer with ifIndex value y, then this table contains: ifInvCapStackStatus.x.y=true This table contains exactly the same number of rows as the ifCapStackTable, but the rows appear in a different order. This table is read only as it describes a cross-connect capability." REFERENCE "IF-INVERTED-STACK-MIB, ifInvStackTable" ::= { ifCapStackObjects 2 } ifInvCapStackEntry OBJECT-TYPE SYNTAX IfInvCapStackEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Information on a particular relationship between two sub- layers, specifying that one sub-layer MAY run underneath the other sub-layer. Each sub-layer corresponds to a conceptual row in the ifTable." INDEX { ifStackLowerLayer, ifStackHigherLayer } ::= { ifInvCapStackTable 1 } IfInvCapStackEntry ::= SEQUENCE { ifInvCapStackStatus TruthValue } ifInvCapStackStatus OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "The status of the possible 'cross-connect capability' relationship between two sub-layers. An instance of this object exists for each instance of the ifCapStackStatus object, and vice versa. For example, if the variable ifCapStackStatus.H.L exists, then the variable ifInvStackStatus.L.H must also exist, and vice versa. In addition, the two variables always have the same value. The ifInvStackStatus object is read-only, as it describes a cross-connect capability." REFERENCE "ifCapStackStatus" ::= { ifInvCapStackEntry 1 } -- -- Conformance Statements -- ifCapStackGroups OBJECT IDENTIFIER ::= { ifCapStackConformance 1 } ifCapStackCompliances OBJECT IDENTIFIER ::= { ifCapStackConformance 2 } -- Units of Conformance ifCapStackGroup OBJECT-GROUP OBJECTS { ifCapStackStatus, ifInvCapStackStatus } STATUS current DESCRIPTION "A collection of objects providing information on the cross-connect capability of multi-layer (stacked) network interfaces." ::= { ifCapStackGroups 1 } -- Compliance Statements ifCapStackCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for SNMP entities, which provide information on the cross-connect capability of multi-layer (stacked) network interfaces, with flexible cross-connect between the sub-layers. Compliance with the following external compliance statements is REQUIRED: MIB Module Compliance Statement ---------- -------------------- IF-MIB ifCompliance3 IF-INVERTED-STACK-MIB ifInvCompliance" MODULE -- this module MANDATORY-GROUPS { ifCapStackGroup } OBJECT ifCapStackStatus SYNTAX TruthValue { true(1) } DESCRIPTION "Support for the false(2) value is OPTIONAL for implementations supporting pluggable interfaces." OBJECT ifInvCapStackStatus SYNTAX TruthValue { true(1) } DESCRIPTION "Support for the false(2) value is OPTIONAL for implementations supporting pluggable interfaces." MODULE IF-MIB MANDATORY-GROUPS { ifStackGroup2 } MODULE IF-INVERTED-STACK-MIB MANDATORY-GROUPS { ifInvStackGroup } ::= { ifCapStackCompliances 1 } END

 TOC 

6.  EFM Copper MIB Definitions

EFM-CU-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, Integer32, Unsigned32, Counter32, mib-2 FROM SNMPv2-SMI -- RFC 2578 TEXTUAL-CONVENTION, TruthValue, RowStatus, PhysAddress FROM SNMPv2-TC -- RFC 2579 MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF -- RFC 2580 SnmpAdminString FROM SNMP-FRAMEWORK-MIB -- RFC 3411 ifIndex, ifSpeed FROM IF-MIB -- RFC 2863 ; efmCuMIB MODULE-IDENTITY LAST-UPDATED "200702180000Z" -- February 18, 2007 ORGANIZATION "IETF Ethernet Interfaces and Hub MIB Working Group" CONTACT-INFO "WG charter: http://www.ietf.org/html.charters/hubmib-charter.html Mailing Lists: General Discussion: hubmib <at> ietf.org To Subscribe: hubmib-request <at> ietf.org In Body: subscribe your_email_address Chair: Bert Wijnen Postal: Alcatel-Lucent Schagen 33 3461 GL Linschoten Netherlands Tel: +31-348-407-775 E-mail: bwijnen <at> alcatel-lucent.com Editor: Edward Beili Postal: Actelis Networks Inc. 25 Bazel St., P.O.B. 10173 Petach-Tikva 10173 Israel Tel: +972-3-924-3491 E-mail: edward.beili <at> actelis.com" DESCRIPTION "The objects in this MIB module are used to manage the Ethernet in the First Mile (EFM) Copper (EFMCu) Interfaces 2BASE-TL and 10PASS-TS, defined in IEEE Std. 802.3ah-2004, which is now a part of IEEE Std. 802.3-2005. The following references are used throughout this MIB module: [802.3ah] refers to: IEEE Std 802.3ah-2004: 'IEEE Standard for Information technology - Telecommunications and information exchange between systems - Local and metropolitan area networks - Specific requirements - Part 3: Carrier Sense Multiple Access with Collision Detection (CSMA/CD) Access Method and Physical Layer Specifications - Amendment: Media Access Control Parameters, Physical Layers and Management Parameters for Subscriber Access Networks', 07 September 2004. Of particular interest are Clause 61, 'Physical Coding Sublayer (PCS) and common specifications, type 10PASS-TS and type 2BASE-TL', Clause 30, 'Management', Clause 45, 'Management Data Input/Output (MDIO) Interface', Annex 62A, 'PMD profiles for 10PASS-TS' and Annex 63A, 'PMD profiles for 2BASE-TL'. [G.991.2] refers to: ITU-T Recommendation G.991.2: 'Single-pair High-speed Digital Subscriber Line (SHDSL) transceivers', December 2003. [ANFP] refers to: NICC Document ND1602:2005/08: 'Specification of the Access Network Frequency Plan (ANFP) applicable to transmission systems used on the BT Access Network,' August 2005. Naming Conventions: Atn - Attenuation CO - Central Office CPE - Customer Premises Equipment EFM - Ethernet in the First Mile EFMCu - EFM Copper MDIO - Management Data Input/Output Mgn - Margin PAF - PME Aggregation Function PBO - Power Back-Off PCS - Physical Coding Sublayer PMD - Physical Medium Dependent PME - Physical Medium Entity PSD - Power Spectral Density SNR - Signal to Noise Ratio TCPAM - Trellis Coded Pulse Amplitude Modulation Copyright (C) The IETF Trust (2007). This version of this MIB module is part of RFC XXXX; see the RFC itself for full legal notices." REVISION "200702180000Z" -- February 18, 2007 DESCRIPTION "Initial version, published as RFC XXXX." -- EdNote: Replace XXXX with the actual RFC number & -- remove this note ::= { mib-2 YYY } -- EdNote: Replace YYY with a real OID once it is -- allocated & remove this note. -- Sections of the module efmCuObjects OBJECT IDENTIFIER ::= { efmCuMIB 1 } efmCuConformance OBJECT IDENTIFIER ::= { efmCuMIB 2 } -- Groups in the module efmCuPort OBJECT IDENTIFIER ::= { efmCuObjects 1 } efmCuPme OBJECT IDENTIFIER ::= { efmCuObjects 2 } -- Textual Conventions EfmProfileIndex ::= TEXTUAL-CONVENTION DISPLAY-HINT "d" STATUS current DESCRIPTION "A unique value, greater than zero, for each PME configuration profile in the managed EFMCu port. It is RECOMMENDED that values are assigned contiguously starting from 1. The value for each profile MUST remain constant at least from one re-initialization of the entity's network management system to the next re-initialization." SYNTAX Unsigned32 (1..255) EfmProfileIndexOrZero ::= TEXTUAL-CONVENTION DISPLAY-HINT "d" STATUS current DESCRIPTION "This textual convention is an extension of EfmProfileIndex convention. The latter defines a greater than zero value used to identify a PME profile in the managed EFMCu port. This extension permits the additional value of zero. The value of zero is object-specific and MUST therefore be defined as part of the description of any object which uses this syntax. Examples of the usage of zero value might include situations where current operational profile is unknown." SYNTAX Unsigned32 (0..255) EfmProfileIndexList ::= TEXTUAL-CONVENTION DISPLAY-HINT "1d:" STATUS current DESCRIPTION "Represents a list of up to 6 EfmProfileIndex's. The EfmProfileIndex textual convention defines a greater than zero value used to identify a PME profile in the managed EFMCu port. The value of this object is a concatenation of one or more (up to 6) octets, where each octet contains an 8-bit EfmProfileIndex value. The EfmProfileIndexList specifies a list of alternative profiles, any of which can be chosen for configuration of an PME." SYNTAX OCTET STRING (SIZE(1..6)) EfmTruthValueOrUnknown ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "This textual convention is an extension of the TruthValue convention. The latter defines a boolean value with possible values of true(1) and false(2). This extension permits the additional value of unknown(0), which can be returned as a result of GET operation, when an exact true or false value of the object cannot be determined." SYNTAX INTEGER { unknown(0), true(1), false(2) } -- Port Notifications Group efmCuPortNotifications OBJECT IDENTIFIER ::= { efmCuPort 0 } efmCuLowRateCrossing NOTIFICATION-TYPE OBJECTS { -- ifIndex is not needed here since we are under specific PCS ifSpeed, efmCuThreshLowRate } STATUS current DESCRIPTION "This notification indicates that the EFMCu port' data rate has reached/dropped below or exceeded the low rate threshold, specified by efmCuThreshLowRate. This notification MAY be send for the -O subtype ports (2BaseTL-O/10PassTS-O) while the port is up, on the crossing event in both directions: from normal (rate is above the threshold) to low (rate equals the threshold or below it) and from low to normal. This notification is not applicable to the -R subtypes. It is RECOMMENDED that a small debouncing period of 2.5 sec, between the detection of the condition and notification, is implemented to prevent simultaneous LinkUp/LinkDown and efmCuLowRateCrossing notifications to be sent. The adaptive nature of the EFMCu technology allows the port to adapt itself to the changes in the copper environment, e.g. an impulse noise, alien crosstalk or a micro-interruption may temporarily drop one or more PMEs in the aggregation group, causing a rate degradation of the aggregated EFMCu link. The dropped PMEs would then try to re-initialize, possibly at a lower rate than before, adjusting the rate to provide required target SNR margin. Generation of this notification is controlled by the efmCuLowRateCrossingEnable object." ::= { efmCuPortNotifications 1 } -- PCS Port group efmCuPortConfTable OBJECT-TYPE SYNTAX SEQUENCE OF EfmCuPortConfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Table for Configuration of EFMCu 2BASE-TL/10PASS-TS (PCS) Ports. Entries in this table MUST be maintained in a persistent manner" ::= { efmCuPort 1 } efmCuPortConfEntry OBJECT-TYPE SYNTAX EfmCuPortConfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the EFMCu Port Configuration table. Each entry represents an EFMCu port indexed by the ifIndex. Note that an EFMCu PCS port runs on top of a single or multiple PME port(s), which are also indexed by ifIndex." INDEX { ifIndex } ::= { efmCuPortConfTable 1 } EfmCuPortConfEntry ::= SEQUENCE { efmCuPAFAdminState INTEGER, efmCuPAFDiscoveryCode PhysAddress, efmCuAdminProfile EfmProfileIndexList, efmCuTargetDataRate Unsigned32, efmCuTargetSnrMgn Unsigned32, efmCuAdaptiveSpectra TruthValue, efmCuThreshLowRate Unsigned32, efmCuLowRateCrossingEnable TruthValue } efmCuPAFAdminState OBJECT-TYPE SYNTAX INTEGER { enabled(1), disabled(2) } MAX-ACCESS read-write STATUS current DESCRIPTION "Administrative (desired) state of the PAF of the EFMCu port (PCS). When 'disabled', PME Aggregation will not be performed by the PCS. No more than a single PME can be assigned to this PCS in this case. When 'enabled', PAF will be performed by the PCS when the link is Up, even on a single attached PME, if PAF is supported. PCS ports incapable of supporting PAF SHALL return a value of 'disabled'. Attempts to 'enable' such ports SHALL be rejected. PAF 'enabled' port with multiple PMEs assigned cannot be 'disabled'. Attempts to 'disable' such port SHALL be rejected, until at most one PME is left assigned. Changing PAFAdminState is a traffic disruptive operation and as such SHALL be done when the link is Down. Attempts to change this object SHALL be rejected if the link is Up or Initializing. This object maps to the Clause 30 attribute aPAFAdminState. If a Clause 45 MDIO Interface to the PCS is present, then this object maps to the PAF enable bit in the 10P/2B PCS control register. This object MUST be maintained in a persistent manner." REFERENCE "[802.3ah] 61.2.2, 45.2.3.18.3" ::= { efmCuPortConfEntry 1 } efmCuPAFDiscoveryCode OBJECT-TYPE SYNTAX PhysAddress (SIZE(6)) MAX-ACCESS read-write STATUS current DESCRIPTION "PAF Discovery Code of the EFMCu port (PCS). A unique 6 octet long code used by the Discovery function, when PAF is supported. PCS ports incapable of supporting PAF SHALL return a value of all zeroes. Attempts to change this object SHALL be rejected in this case. This object MUST be instantiated for the -O subtype PCS before writing operations on the efmCuPAFRemoteDiscoveryCode (Set_if_Clear and Clear_if_Same) are performed by PMEs associated with the PCS. The initial value of this object for -R subtype ports after reset is all zeroes. For -R subtype ports, the value of this object cannot be changed directly. This value may be changed as a result of writing operation on the efmCuPAFRemoteDiscoveryCode object of remote PME of -O subtype, connected to one of the local PMEs associated with the PCS. Discovery MUST be performed when the link is Down. Attempts to change this object MUST be rejected (in case of SNMP with the error inconsistentValue), if the link is Up or Initializing. The PAF Discovery code maps to the local Discovery code variable in PAF (note that it does not have a corresponding Clause 45 register)" REFERENCE "[802.3ah] 61.2.2.8.3, 61.2.2.8.4, 45.2.6.6.1" ::= { efmCuPortConfEntry 2 } efmCuAdminProfile OBJECT-TYPE SYNTAX EfmProfileIndexList MAX-ACCESS read-write STATUS current DESCRIPTION "Desired configuration Profile(s), common for all PMEs in the EFMCu port. This object is a list of pointers to entries in either efmCuPme2BProfileTable or efmCuPme10PProfileTable, depending on the current operating SubType of the EFMCu port as indicated by efmCuPortSide. The value of this object is a list of up to 6 indices of Profiles. If this list consists of a single Profile index, then all PMEs assigned to this EFMCu port SHALL be configured according to the Profile referenced by that index, unless it is overwritten by corresponding non-zero efmCuPmeAdminProfile, which takes precedence over efmCuAdminProfile. The list, consisting of more than one index, allows each PME in the port to be configured according to any Profile specified in the list. By default this object has a value of 0x01, referencing 1st entry in efmCuPme2BProfileTable or efmCuPme10PProfileTable. This object is writable and readable for the -O subtype (2BaseTL-O or 10PassTS-O) EFMCu ports. It is unsupported for the -R subtype (2BaseTL-R or 10PassTS-R) ports. Note that current operational Profile value is available via efmCuPmeOperProfile object. Modification of this object MUST be performed when the link is Down. Attempts to change this object MUST be rejected, if the link is Up or Initializing. Attempts to set this object to a list with a member value, that is not the value of the index for an active entry in the corresponding profile table, MUST be rejected. This object MUST be maintained in a persistent manner." REFERENCE "[802.3ah] 30.11.2.1.6" DEFVAL { '01'H } ::= { efmCuPortConfEntry 3 } efmCuTargetDataRate OBJECT-TYPE SYNTAX Unsigned32(1..100000|999999) UNITS "Kbps" MAX-ACCESS read-write STATUS current DESCRIPTION "Desired EFMCu port 'net' (as seen across MII) Data Rate in Kbps, to be achieved during initialization, under spectral restrictions placed on each PME via efmCuAdminProfile or efmCuPmeAdminProfile, with the desired SNR Margin specified by efmCuTargetSnrMgn. In case of PAF, this object represents a sum of individual PME data rates, modified to compensate for fragmentation and 64/65B framing overhead (e.g. target data rate of 10Mbps SHALL allow lossless transmission of full-duplex 10Mbps Ethernet frame stream with minimal inter-frame gap). The value is limited above by 100Mbps as this is the max burst rate across MII for EFMCu ports. The value between 1 and 100000 indicates that the total data rate (ifSpeed) of the EFMCu port after initialization SHALL be equal to the target data rate or less, if the target data rate cannot be achieved under spectral restrictions specified by efmCuAdminProfile/efmCuPmeAdminProfile and with desired SNR margin. In case the copper environment allows to achieve higher total data rate than that specified by the target, the excess capability SHALL be either converted to additional SNR margin or reclaimed by minimizing transmit power as controlled by efmCuAdaptiveSpectra. The value of 999999 means that the target data rate is not fixed and SHALL be set to the maximum attainable rate during initialization (Best Effort), under specified spectral restrictions and with desired SNR Margin. This object is read-write for the -O subtype EFMCu ports (2BaseTL-O/10PassTS-O) and not available for the -R subtypes. Changing of the Target Data Rate MUST be performed when the link is Down. Attempts to change this object MUST be rejected (in case of SNMP with the error inconsistentValue), if the link is Up or Initializing. Note that current Data Rate of the EFMCu port is represented by ifSpeed object of IF-MIB. This object MUST be maintained in a persistent manner." ::= { efmCuPortConfEntry 4 } efmCuTargetSnrMgn OBJECT-TYPE SYNTAX Unsigned32(0..21) UNITS "dB" MAX-ACCESS read-write STATUS current DESCRIPTION "Desired EFMCu port SNR Margin to be achieved on all PMEs assigned to the port, during initializiation. (The SNR margin is the difference between the desired SNR and the actual SNR). Note that 802.3ah recommends using default Target SNR Margin of 5dB for 2BASE-TL ports and 6dB for 10PASS-TS ports in order to achieve mean Bit Error Rate (BER) of 10^-7 at the PMA service interface. This object is read-write for the -O subtype EFMCu ports (2BaseTL-O/10PassTS-O) and not available for the -R subtypes. Changing of the Target SNR Margin MUST be performed when the link is Down. Attempts to change this object MUST be rejected (in case of SNMP with the error inconsistentValue), if the link is Up or Initializing. Note that current SNR Margin of the PMEs comprising the EFMCu port is represented by efmCuPmeSnrMgn. This object MUST be maintained in a persistent manner." REFERENCE "[802.3ah] 61.1.2" ::= { efmCuPortConfEntry 5 } efmCuAdaptiveSpectra OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "Indicates how to utilize excess capacity when the copper environment allows to achieve higher total data rate than that specified by the efmCuTargetDataRate. Value of true(1) indicates that the excess capability SHALL be reclaimed by minimizing transmit power, e.g. using higher constellations and Power Back-Off, in order to reduce interference to other copper pairs in the binder and the adverse impact to link/system performance. Value of false(2) indicates that the excess capability SHALL be converted to additional SNR margin and spread evenly across all active PMEs assigned to the (PCS) port, to increase link robustness. This object is read-write for the -O subtype EFMCu ports (2BaseTL-O/10PassTS-O) and not available for the -R subtypes. Changing of this object MUST be performed when the link is Down. Attempts to change this object MUST be rejected (in case of SNMP with the error inconsistentValue), if the link is Up or Initializing. This object MUST be maintained in a persistent manner." ::= { efmCuPortConfEntry 6 } efmCuThreshLowRate OBJECT-TYPE SYNTAX Unsigned32(1..100000) UNITS "Kbps" MAX-ACCESS read-write STATUS current DESCRIPTION "This object configures the EFMCu port low rate crossing alarm threshold. When the current value of ifSpeed for this port reaches/drops below or exceeds this threshold, an efmCuLowRateCrossing notification MAY be generated if enabled by efmCuLowRateCrossingEnable. This object is read-write for the -O subtype EFMCu ports (2BaseTL-O/10PassTS-O) and not available for the -R subtypes. This object MUST be maintained in a persistent manner." ::= { efmCuPortConfEntry 7 } efmCuLowRateCrossingEnable OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "Indicates whether efmCuLowRateCrossing notifications should be generated for this interface. Value of true(1) indicates that efmCuLowRateCrossing notification is enabled. Value of false(2) indicates that the notification is disabled. This object is read-write for the -O subtype EFMCu ports (2BaseTL-O/10PassTS-O) and not available for the -R subtypes. This object MUST be maintained in a persistent manner." ::= { efmCuPortConfEntry 8 } efmCuPortCapabilityTable OBJECT-TYPE SYNTAX SEQUENCE OF EfmCuPortCapabilityEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Table for Capabilities of EFMCu 2BASE-TL/10PASS-TS (PCS) Ports. Entries in this table MUST be maintained in a persistent manner" ::= { efmCuPort 2 } efmCuPortCapabilityEntry OBJECT-TYPE SYNTAX EfmCuPortCapabilityEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the EFMCu Port Capability table. Each entry represents an EFMCu port indexed by the ifIndex. Note that an EFMCu PCS port runs on top of a single or multiple PME port(s), which are also indexed by ifIndex." INDEX { ifIndex } ::= { efmCuPortCapabilityTable 1 } EfmCuPortCapabilityEntry ::= SEQUENCE { efmCuPAFSupported TruthValue, efmCuPeerPAFSupported EfmTruthValueOrUnknown, efmCuPAFCapacity Unsigned32, efmCuPeerPAFCapacity Unsigned32 } efmCuPAFSupported OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "PME Aggregation Function (PAF) Capability of the EFMCu port (PCS). This object has a value of true(1) when the PCS can perform PME aggregation on the available PMEs. Ports incapable of PAF SHALL return a value of false(2). This object maps to the Clause 30 attribute aPAFSupported. If a Clause 45 MDIO Interface to the PCS is present, then this object maps to the PAF available bit in the 10P/2B capability register." REFERENCE "[802.3ah] 61.2.2, 30.11.1.1.4, 45.2.3.17.1" ::= { efmCuPortCapabilityEntry 1 } efmCuPeerPAFSupported OBJECT-TYPE SYNTAX EfmTruthValueOrUnknown MAX-ACCESS read-only STATUS current DESCRIPTION "PME Aggregation Function (PAF) Capability of the EFMCu port (PCS) link partner. This object has a value of true(1) when the remote PCS can perform PME aggregation on its available PMEs. Ports whose peers are incapable of PAF, SHALL return a value of false(2). Ports whose peers cannot be reached because of the link state, SHALL return a value if unknown(0). This object maps to the Clause 30 attribute aRemotePAFSupported. If a Clause 45 MDIO Interface to the PCS is present, then this object maps to the Remote PAF supported bit in the 10P/2B capability register." REFERENCE "[802.3ah] 61.2.2, 30.11.1.1.9, 45.2.3.17.2" ::= { efmCuPortCapabilityEntry 2 } efmCuPAFCapacity OBJECT-TYPE SYNTAX Unsigned32 (1..32) MAX-ACCESS read-only STATUS current DESCRIPTION "Number of PMEs that can be aggregated by the local PAF. The number of PMEs currently assigned to a particular EFMCu port (efmCuNumPMEs) is never greater than efmCuPAFCapacity. This object maps to the Clause 30 attribute aLocalPAFCapacity." REFERENCE "[802.3ah] 61.2.2, 30.11.1.1.6" ::= { efmCuPortCapabilityEntry 3 } efmCuPeerPAFCapacity OBJECT-TYPE SYNTAX Unsigned32 (0|1..32) MAX-ACCESS read-only STATUS current DESCRIPTION "Number of PMEs that can be aggregated by the PAF of the peer Phy (PCS port). Value of 0 is returned when peer PAF Capacity is unknown (peer cannot be reached). This object maps to the Clause 30 attribute aRemotePAFCapacity." REFERENCE "[802.3ah] 61.2.2, 30.11.1.1.10" ::= { efmCuPortCapabilityEntry 4 } efmCuPortStatusTable OBJECT-TYPE SYNTAX SEQUENCE OF EfmCuPortStatusEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table provides overall status information of EFMCu 2BASE-TL/10PASS-TS ports, complementing the generic status information from the ifTable of IF-MIB and ifMauTable of MAU-MIB. Additional status information about connected PMEs is available from efmCuPmeStatusTable. This table contains live data from the equipment. As such, it is NOT persistent." ::= { efmCuPort 3 } efmCuPortStatusEntry OBJECT-TYPE SYNTAX EfmCuPortStatusEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the EFMCu Port Status table. Each entry represents an EFMCu port indexed by the ifIndex. Note that an EFMCu PCS port runs on top of a single or multiple PME port(s), which are also indexed by ifIndex." INDEX { ifIndex } ::= { efmCuPortStatusTable 1 } EfmCuPortStatusEntry ::= SEQUENCE { efmCuFltStatus BITS, efmCuPortSide INTEGER, efmCuNumPMEs Unsigned32, efmCuPAFInErrors Counter32, efmCuPAFInSmallFragments Counter32, efmCuPAFInLargeFragments Counter32, efmCuPAFInBadFragments Counter32, efmCuPAFInLostFragments Counter32, efmCuPAFInLostStarts Counter32, efmCuPAFInLostEnds Counter32, efmCuPAFInOverflows Counter32 } efmCuFltStatus OBJECT-TYPE SYNTAX BITS { noPeer(0), peerPowerLoss(1), pmeSubTypeMismatch(2), lowRate(3) } MAX-ACCESS read-only STATUS current DESCRIPTION "EFMCu (PCS) port Fault Status. This is a bitmap of possible conditions. The various bit positions are: noPeer - peer PHY cannot be reached (e.g. no PMEs attached, all PMEs are Down etc.) More info is available in efmCuPmeFltStatus. peerPowerLoss - peer PHY has indicated impending unit failure due to loss of local power ('Dying Gasp'). pmeSubTypeMismatch - local PMEs in the aggregation group are not of the same sub-type, e.g. some PMEs in the local device are -O while others are -R subtype. lowRate - ifSpeed of the port reached or dropped below efmCuThreshLowRate This object is intended to supplement ifOperStatus object in IF-MIB and ifMauMediaAvailable in MAU-MIB. Additional information is available via efmCuPmeFltStatus object for each PME in the aggregation group (single PME if PAF is disabled)." REFERENCE "IF-MIB, ifOperStatus; MAU-MIB, ifMauMediaAvailable; efmCuPmeFltStatus" ::= { efmCuPortStatusEntry 1 } efmCuPortSide OBJECT-TYPE SYNTAX INTEGER { subscriber(1), office(2), unknown(3) } MAX-ACCESS read-only STATUS current DESCRIPTION "EFM port mode of operation (subtype). The value of 'subscriber' indicates the port is designated as '-R' subtype (all PMEs assigned to this port are of subtype '-R'). The value of the 'office' indicates that the port is designated as '-O' subtype (all PMEs assigned to this port are of subtype '-O'). The value of 'unknown' indicates that the port has no assigned PMEs yet or that the assigned PMEs are not of the same side (subTypePMEMismatch). This object partially maps to the Clause 30 attribute aPhyEnd" REFERENCE "[802.3ah] 61.1, 30.11.1.1.2" ::= { efmCuPortStatusEntry 2 } efmCuNumPMEs OBJECT-TYPE SYNTAX Unsigned32 (0..32) MAX-ACCESS read-only STATUS current DESCRIPTION "Number of PMEs that is currently aggregated by the local PAF (assigned to the EFMCu port using ifStackTable). This number is never greater than efmCuPAFCapacity. This object SHALL be automatically incremented or decremented when a PME is added or deleted to/from the EFMCu port using ifStackTable." REFERENCE "[802.3ah] 61.2.2, 30.11.1.1.6" ::= { efmCuPortStatusEntry 3 } efmCuPAFInErrors OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A number of fragments that have been received across the gamma interface with RxErr asserted and discarded. This read-only counter is inactive (not incremented) when the PAF is unsupported or disabled. Upon disabling the PAF, the counter retains its previous value. If a Clause 45 MDIO Interface to the PCS is present, then this object maps to the 10P/2B PAF RX error register. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime, defined in IF-MIB." REFERENCE "[802.3ah] 45.2.3.21" ::= { efmCuPortStatusEntry 4 } efmCuPAFInSmallFragments OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A number of fragments smaller than minFragmentSize (64 Bytes), which have been received across the gamma interface and discarded. This read-only counter is inactive when the PAF is unsupported or disabled. Upon disabling the PAF, the counter retains its previous value. If a Clause 45 MDIO Interface to the PCS is present, then this object maps to the 10P/2B PAF small fragments register. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime, defined in IF-MIB." REFERENCE "[802.3ah] 45.2.3.22" ::= { efmCuPortStatusEntry 5 } efmCuPAFInLargeFragments OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A number of fragments larger than maxFragmentSize (512 Bytes), which have been received across the gamma interface and discarded. This read-only counter is inactive when the PAF is unsupported or disabled. Upon disabling the PAF, the counter retains its previous value. If a Clause 45 MDIO Interface to the PCS is present, then this object maps to the 10P/2B PAF large fragments register. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime, defined in IF-MIB." REFERENCE "[802.3ah] 45.2.3.23" ::= { efmCuPortStatusEntry 6 } efmCuPAFInBadFragments OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A number of fragments which do not fit into the sequence expected by the frame assembly function, that have been received across the gamma interface and discarded (the frame buffer is flushed to the next valid frame start). This read-only counter is inactive when the PAF is unsupported or disabled. Upon disabling the PAF, the counter retains its previous value. If a Clause 45 MDIO Interface to the PCS is present, then this object maps to the 10P/2B PAF bad fragments register. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime, defined in IF-MIB." REFERENCE "[802.3ah] 45.2.3.25" ::= { efmCuPortStatusEntry 7 } efmCuPAFInLostFragments OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A number of gaps in the sequence of fragments, which have been received across the gamma interface (the frame buffer is flushed to the next valid frame start, when fragment/fragments expected by the frame assembly function is/are not received). This read-only counter is inactive when the PAF is unsupported or disabled. Upon disabling the PAF, the counter retains its previous value. If a Clause 45 MDIO Interface to the PCS is present, then this object maps to the 10P/2B PAF lost fragment register. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime, defined in IF-MIB." REFERENCE "[802.3ah] 45.2.3.26" ::= { efmCuPortStatusEntry 8 } efmCuPAFInLostStarts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A number of missing StartOfPacket indicators expected by the frame assembly function. This read-only counter is inactive when the PAF is unsupported or disabled. Upon disabling the PAF, the counter retains its previous value. If a Clause 45 MDIO Interface to the PCS is present, then this object maps to the 10P/2B PAF lost start of fragment register. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime, defined in IF-MIB." REFERENCE "[802.3ah] 45.2.3.27" ::= { efmCuPortStatusEntry 9 } efmCuPAFInLostEnds OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A number of missing EndOfPacket indicators expected by the frame assembly function. This read-only counter is inactive when the PAF is unsupported or disabled. Upon disabling the PAF, the counter retains its previous value. If a Clause 45 MDIO Interface to the PCS is present, then this object maps to the 10P/2B PAF lost start of fragment register. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime, defined in IF-MIB." REFERENCE "[802.3ah] 45.2.3.28" ::= { efmCuPortStatusEntry 10 } efmCuPAFInOverflows OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A number of fragments, received across the gamma interface and discarded, which would have caused the frame assembly buffer to overflow. This read-only counter is inactive when the PAF is unsupported or disabled. Upon disabling the PAF, the counter retains its previous value. If a Clause 45 MDIO Interface to the PCS is present, then this object maps to the 10P/2B PAF overflow register. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime, defined in IF-MIB." REFERENCE "[802.3ah] 45.2.3.24" ::= { efmCuPortStatusEntry 11 } -- PME Notifications Group efmCuPmeNotifications OBJECT IDENTIFIER ::= { efmCuPme 0 } efmCuPmeLineAtnCrossing NOTIFICATION-TYPE OBJECTS { efmCuPmeLineAtn, efmCuPmeThreshLineAtn } STATUS current DESCRIPTION "This notification indicates that the loop attenuation threshold (as per the efmCuPmeThreshLineAtn value) has been reached/exceeded for the 2BASE-TL/10PASS-TS PME. This notification MAY be send on the crossing event in both directions: from normal to exceeded and from exceeded to normal. It is RECOMMENDED that a small debouncing period of 2.5 sec, between the detection of the condition and notification, is implemented to prevent intermittent notifications to be sent. Generation of this notification is controlled by the efmCuPmeLineAtnCrossingEnable object." ::= { efmCuPmeNotifications 1 } efmCuPmeSnrMgnCrossing NOTIFICATION-TYPE OBJECTS { efmCuPmeSnrMgn, efmCuPmeThreshSnrMgn } STATUS current DESCRIPTION "This notification indicates that the SNR margin threshold (as per the efmCuPmeThreshSnrMgn value) has been reached/exceeded for the 2BASE-TL/10PASS-TS PME. This notification MAY be send on the crossing event in both directions: from normal to exceeded and from exceeded to normal. It is RECOMMENDED that a small debouncing period of 2.5 sec, between the detection of the condition and notification, is implemented to prevent intermittent notifications to be sent. Generation of this notification is controlled by the efmCuPmeSnrMgnCrossingEnable object." ::= { efmCuPmeNotifications 2 } efmCuPmeDeviceFault NOTIFICATION-TYPE OBJECTS { efmCuPmeFltStatus } STATUS current DESCRIPTION "This notification indicates that a fault in the PME has been detected by a vendor specific diagnostic or a self-test. Generation of this notification is controlled by the efmCuPmeDeviceFaultEnable object." ::= { efmCuPmeNotifications 3 } efmCuPmeConfigInitFailure NOTIFICATION-TYPE OBJECTS { efmCuPmeFltStatus, efmCuAdminProfile, efmCuPmeAdminProfile } STATUS current DESCRIPTION "This notification indicates that PME initialization has failed, due to inability of the PME link to achieve requested configuration profile. Generation of this notification is controlled by the efmCuPmeConfigInitFailEnable object." ::= { efmCuPmeNotifications 4 } efmCuPmeProtocolInitFailure NOTIFICATION-TYPE OBJECTS { efmCuPmeFltStatus, efmCuPmeOperSubType } STATUS current DESCRIPTION "This notification indicates that peer PME was using incompatible protocol during initialization. Generation of this notification is controlled by the efmCuPmeProtocolInitFailEnable object." ::= { efmCuPmeNotifications 5 } -- The PME group efmCuPmeConfTable OBJECT-TYPE SYNTAX SEQUENCE OF EfmCuPmeConfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Table for Configuration of common aspects for EFMCu 2BASE-TL/10PASS-TS PME ports (modems). Configuration of aspects specific to 2BASE-TL or 10PASS-TS PME types is represented in efmCuPme2BConfTable and efmCuPme10PConfTable respectively. Entries in this table MUST be maintained in a persistent manner." ::= { efmCuPme 1 } efmCuPmeConfEntry OBJECT-TYPE SYNTAX EfmCuPmeConfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the EFMCu PME Configuration table. Each entry represents common aspects of an EFMCu PME port indexed by the ifIndex. Note that an EFMCu PME port can be stacked below a single PCS port, also indexed by ifIndex, possibly together with other PME ports if PAF is enabled." INDEX { ifIndex } ::= { efmCuPmeConfTable 1 } EfmCuPmeConfEntry ::= SEQUENCE { efmCuPmeAdminSubType INTEGER, efmCuPmeAdminProfile EfmProfileIndexOrZero, efmCuPAFRemoteDiscoveryCode PhysAddress, efmCuPmeThreshLineAtn Integer32, efmCuPmeThreshSnrMgn Integer32, efmCuPmeLineAtnCrossingEnable TruthValue, efmCuPmeSnrMgnCrossingEnable TruthValue, efmCuPmeDeviceFaultEnable TruthValue, efmCuPmeConfigInitFailEnable TruthValue, efmCuPmeProtocolInitFailEnable TruthValue } efmCuPmeAdminSubType OBJECT-TYPE SYNTAX INTEGER { ieee2BaseTLO(1), ieee2BaseTLR(2), ieee10PassTSO(3), ieee10PassTSR(4), ieee2BaseTLor10PassTSR(5), ieee2BaseTLor10PassTSO(6), ieee10PassTSor2BaseTLO(7) } MAX-ACCESS read-write STATUS current DESCRIPTION "Administrative (desired) sub-type of the PME. Possible values are: ieee2BaseTLO - PME SHALL operate as 2BaseTL-O ieee2BaseTLR - PME SHALL operate as 2BaseTL-R ieee10PassTSO - PME SHALL operate as 10PassTS-O ieee10PassTSR - PME SHALL operate as 10PassTS-R ieee2BaseTLor10PassTSR - PME SHALL operate as 2BaseTL-R or 10PassTS-R. Actual value will be set by -O link partner during initialization (handshake). ieee2BaseTLor10PassTSO - PME SHALL operate as 2BaseTL-O (preferred) or 10PassTS-O. Actual value will be set during initialization depending on -R link partner capability (i.e. if -R is incapable of the preferred 2BaseTL mode, 10PassTS will be used). ieee10PassTSor2BaseTLO - PME SHALL operate as 10PassTS-O (preferred) or 2BaseTL-O. Actual value will be set during initialization depending on -R link partner capability (i.e. if -R is incapable of the preferred 10PassTS mode, 2BaseTL will be used). Changing efmCuPmeAdminSubType is a traffic disruptive operation and as such SHALL be done when the link is Down. Attempts to change this object SHALL be rejected if the link is Up or Initializing. Attempts to change this object to an unsupported subtype (see efmCuPmeSubTypesSupported) SHALL be rejected. The current operational sub type is indicated by efmCuPmeOperSubType variable. If a Clause 45 MDIO Interface to the PMA/PMD is present, then this object combines values of the Port sub-type select bits and the PMA/PMD type selection bits in the 10P/2B PMA/PMD control register" REFERENCE "[802.3ah] 61.1, 45.2.1.11.4, 45.2.1.11.7" ::= { efmCuPmeConfEntry 1 } efmCuPmeAdminProfile OBJECT-TYPE SYNTAX EfmProfileIndexOrZero MAX-ACCESS read-write STATUS current DESCRIPTION "Desired PME configuration Profile. This object is a pointer to an entry in either efmCuPme2BProfileTable or efmCuPme10PProfileTable, depending on the current operating SubType of the PME. The value of this object is the index of the referenced profile. The value of zero (default) indicates that the PME is configured via efmCuAdminProfile object for the PCS port, to which this PME is assigned. That is, the profile referenced by efmCuPmeAdminProfile takes precedence over the profile(s) referenced by efmCuAdminProfile. This object is writable and readable for the CO subtype PMEs (2BaseTL-O or 10PassTS-O). It is unsupported for the CPE subtype (2BaseTL-R or 10PassTS-R). Note that current operational Profile value is available via efmCuPmeOperProfile object. Modification of this object MUST be performed when the link is Down. Attempts to change this object MUST be rejected, if the link is Up or Initializing. Attempts to set this object to a value that is not the value of the index for an active entry in the corresponding profile table, MUST be rejected." REFERENCE "[802.3ah] 30.11.2.1.6" DEFVAL { 0 } ::= { efmCuPmeConfEntry 2 } efmCuPAFRemoteDiscoveryCode OBJECT-TYPE SYNTAX PhysAddress (SIZE(6)) MAX-ACCESS read-write STATUS current DESCRIPTION "PAF Remote Discovery Code of the PME port at CO. A 6 octet long Discovery Code of the peer PCS connected via the PME. Reading this object results in a Discovery Get operation. Setting this object to all zeroes results in a Discovery Clear_if_Same operation (the value of efmCuPAFDiscoveryCode at the peer PCS SHALL be the same as efmCuPAFDiscoveryCode of the local PCS associated with the PME for the operation to succeed). Writing a non-zero value to this object results in a Discovery Set_if_Clear operation. A zero-length octet string SHALL be returned on an attempt to read this object when PAF aggregation is not enabled. This object is irrelevant in CPE port (-R) subtypes: in this case a zero length octet string SHALL be returned on an attempt to read this object, writing to this object SHALL be ignored. Discovery MUST be performed when the link is Down. Attempts to change this object MUST be rejected (in case of SNMP with the error inconsistentValue), if the link is Up or Initializing. If a Clause 45 MDIO Interface to the PMA/PMD is present, then this object is a function of 10P/2B aggregation discovery control register, Discovery operation result bits in 10P/2B aggregation and discovery status register and 10P/2B aggregation discovery code register" REFERENCE "[802.3ah] 61.2.2.8.4, 45.2.6.6-45.2.6.8" ::= { efmCuPmeConfEntry 3 } efmCuPmeThreshLineAtn OBJECT-TYPE SYNTAX Integer32(-127..128) UNITS "dB" MAX-ACCESS read-write STATUS current DESCRIPTION "Desired Line Attenuation Threshold for the 2B/10P PME. This object configures the line attenuation alarm threshold. When the current value of Line Attenuation reaches or exceeds this threshold, a efmCuPmeLineAtnCrossing notification MAY be generated, if enabled by efmCuPmeLineAtnCrossingEnable. This object is writable for the CO subtype PMEs (-O). It is read-only for the CPE subtype (-R). Changing of the Line Attenuation Threshold MUST be performed when the link is Down. Attempts to change this object MUST be rejected (in case of SNMP with the error inconsistentValue), if the link is Up or Initializing. If a Clause 45 MDIO Interface to the PME is present, then this object maps to the Loop attenuation threshold bits in the 2B PMD line quality thresholds register" REFERENCE "[802.3ah] 45.2.1.36" ::= { efmCuPmeConfEntry 4 } efmCuPmeThreshSnrMgn OBJECT-TYPE SYNTAX Integer32(-127..128) UNITS "dB" MAX-ACCESS read-write STATUS current DESCRIPTION "Desired SNR Margin Threshold for the 2B/10P PME. This object configures the SNR margin alarm threshold. When the current value of SNR Margin reaches or exceeds this threshold, a efmCuPmeSnrMgnCrossing notification MAY be generated, if enabled by efmCuPmeSnrMgnCrossingEnable. This object is writable for the CO subtype PMEs (2BaseTL-O/10PassTS-R). It is read-only for the CPE subtype (2BaseTL-R/10PassTS-R). Changing of the SNR Margin Threshold MUST be performed when the link is Down. Attempts to change this object MUST be rejected (in case of SNMP with the error inconsistentValue), if the link is Up or Initializing. If a Clause 45 MDIO Interface to the PME is present, then this object maps to the SNR margin threshold bits in the 2B PMD line quality thresholds register" REFERENCE "[802.3ah] 45.2.1.36" ::= { efmCuPmeConfEntry 5 } efmCuPmeLineAtnCrossingEnable OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "Indicates whether efmCuPmeLineAtnCrossing notifications should be generated for this interface. Value of true(1) indicates that efmCuPmeLineAtnCrossing notification is enabled. Value of false(2) indicates that the notification is disabled." ::= { efmCuPmeConfEntry 6 } efmCuPmeSnrMgnCrossingEnable OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "Indicates whether efmCuPmeSnrMgnCrossing notifications should be generated for this interface. Value of true(1) indicates that efmCuPmeSnrMgnCrossing notification is enabled. Value of false(2) indicates that the notification is disabled." ::= { efmCuPmeConfEntry 7 } efmCuPmeDeviceFaultEnable OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "Indicates whether efmCuPmeDeviceFault notifications should be generated for this interface. Value of true(1) indicates that efmCuPmeDeviceFault notification is enabled. Value of false(2) indicates that the notification is disabled." ::= { efmCuPmeConfEntry 8 } efmCuPmeConfigInitFailEnable OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "Indicates whether efmCuPmeConfigInitFailure notifications should be generated for this interface. Value of true(1) indicates that efmCuPmeConfigInitFailure notification is enabled. Value of false(2) indicates that the notification is disabled." ::= { efmCuPmeConfEntry 9 } efmCuPmeProtocolInitFailEnable OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "Indicates whether efmCuPmeProtocolInitFailure notifications should be generated for this interface. Value of true(1) indicates that efmCuPmeProtocolInitFailure notification is enabled. Value of false(2) indicates that the notification is disabled." ::= { efmCuPmeConfEntry 10 } efmCuPmeCapabilityTable OBJECT-TYPE SYNTAX SEQUENCE OF EfmCuPmeCapabilityEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Table for Configuration of common aspects for EFMCu 2BASE-TL/10PASS-TS PME ports (modems). Configuration of aspects specific to 2BASE-TL or 10PASS-TS PME types is represented in efmCuPme2BConfTable and efmCuPme10PConfTable respectively. Entries in this table MUST be maintained in a persistent manner." ::= { efmCuPme 2 } efmCuPmeCapabilityEntry OBJECT-TYPE SYNTAX EfmCuPmeCapabilityEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the EFMCu PME Capability table. Each entry represents common aspects of an EFMCu PME port indexed by the ifIndex. Note that an EFMCu PME port can be stacked below a single PCS port, also indexed by ifIndex, possibly together with other PME ports if PAF is enabled." INDEX { ifIndex } ::= { efmCuPmeCapabilityTable 1 } EfmCuPmeCapabilityEntry ::= SEQUENCE { efmCuPmeSubTypesSupported BITS } efmCuPmeSubTypesSupported OBJECT-TYPE SYNTAX BITS { ieee2BaseTLO(0), ieee2BaseTLR(1), ieee10PassTSO(2), ieee10PassTSR(3) } MAX-ACCESS read-only STATUS current DESCRIPTION "PME supported sub-types. This is a bitmap of possible sub-types. The various bit positions are: ieee2BaseTLO - PME is capable of operating as 2BaseTL-O ieee2BaseTLR - PME is capable of operating as 2BaseTL-R ieee10PassTSO - PME is capable of operating as 10PassTS-O ieee10PassTSR - PME is capable of operating as 10PassTS-R An desired mode of operation is determined by efmCuPmeAdminSubType, while efmCuPmeOperSubType reflects the current operating mode. If a Clause 45 MDIO Interface to the PCS is present, then this object combines the 10PASS-TS capable and 2BASE-TL capable bits in the 10P/2B PMA/PMD speed ability register and the CO supported and CPE supported bits in the 10P/2B PMA/PMD status register" REFERENCE "[802.3ah] 61.1, 45.2.1.4.1, 45.2.1.4.2, 45.2.1.12.2, 45.2.1.12.3" ::= { efmCuPmeCapabilityEntry 1 } efmCuPmeStatusTable OBJECT-TYPE SYNTAX SEQUENCE OF EfmCuPmeStatusEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table provides common status information of EFMCu 2BASE-TL/10PASS-TS PME ports. Status information specific to 10PASS-TS PME is represented in efmCuPme10PStatusTable. This table contains live data from the equipment. As such, it is NOT persistent." ::= { efmCuPme 3 } efmCuPmeStatusEntry OBJECT-TYPE SYNTAX EfmCuPmeStatusEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the EFMCu PME Status table. Each entry represents common aspects of an EFMCu PME port indexed by the ifIndex. Note that an EFMCu PME port can be stacked below a single PCS port, also indexed by ifIndex, possibly together with other PME ports if PAF is enabled." INDEX { ifIndex } ::= { efmCuPmeStatusTable 1 } EfmCuPmeStatusEntry ::= SEQUENCE { efmCuPmeOperStatus INTEGER, efmCuPmeFltStatus BITS, efmCuPmeOperSubType INTEGER, efmCuPmeOperProfile EfmProfileIndexOrZero, efmCuPmeSnrMgn Integer32, efmCuPmePeerSnrMgn Integer32, efmCuPmeLineAtn Integer32, efmCuPmePeerLineAtn Integer32, efmCuPmeEquivalentLength Unsigned32, efmCuPmeTCCodingErrors Counter32, efmCuPmeTCCrcErrors Counter32 } efmCuPmeOperStatus OBJECT-TYPE SYNTAX INTEGER { up(1), downNotReady(2), downReady(3), init(4) } MAX-ACCESS read-only STATUS current DESCRIPTION "Current PME link Operational Status. Possible values are: up(1) - link is Up and ready to pass 64/65B encoded frames or fragments. downNotReady(2) - link is Down and the PME does not detect Handshake tones from its peer. This value may indicate a possible problem with the peer PME. downReady(3) - link is Down and the PME detects Handshake tones from its peer. init(4) - link is initializing, as a result of ifAdminStatus being set to 'up' for a particular PME or a PCS the PME is connected to. This object is intended to supplement Down state of ifOperStatus. This object partially maps to the Clause 30 attribute aPMEStatus. If a Clause 45 MDIO Interface to the PME is present, then this object partially maps to PMA/PMD link status bits in 10P/2B PMA/PMD status register." REFERENCE "[802.3ah] 30.11.2.1.3, 45.2.1.12.4" ::= { efmCuPmeStatusEntry 1 } efmCuPmeFltStatus OBJECT-TYPE SYNTAX BITS { lossOfFraming(0), snrMgnDefect(1), lineAtnDefect(2), deviceFault(3), configInitFailure(4), protocolInitFailure(5) } MAX-ACCESS read-only STATUS current DESCRIPTION "Current/Last PME link Fault Status. This is a bitmap of possible conditions. The various bit positions are: lossOfFraming - Loss of Framing for 10P or Loss of Sync word for 2B PMD or Loss of 64/65B Framing snrMgnDefect - SNR Margin dropped below the Threshold lineAtnDefect - Line Attenuation exceeds the Threshold deviceFault - Indicates a vendor-dependent diagnostic or self-test fault has been detected. configInitFailure - Configuration initialization failure, due to inability of the PME link to support configuration profile, requested during initialization. protocolInitFailure - Protocol initialization failure, due to incompatible protocol used by the Peer PME during init (that could happen if a peer PMD is a regular G.SDHSL/VDSL modem instead of a 2BASE-TL/10PASS-TS PME). This object is intended to supplement ifOperStatus in IF-MIB. This object holds information about the last fault. efmCuPmeFltStatus is cleared by the device restart. In addition lossOfFraming, configInitFailure and protocolInitFailure are cleared by PME init. deviceFault is cleared by successful diagnostics/test. snrMgnDefect and lineAtnDefect are cleared by SNR Margin and line Attenuation respectively returning to norm and by PME init. This object partially maps to the Clause 30 attribute aPMEStatus. If a Clause 45 MDIO Interface to the PME is present, then this object consolidates information from various PMA/PMD registers, namely: Fault bit in PMA/PMD status 1 register, 10P/2B PMA/PMD link loss register, 10P outgoing indicator bits status register, 10P incoming indicator bits status register, 2B state defects register." REFERENCE "[802.3ah] 30.11.2.1.3, 45.2.1.2.1, 45.2.1.38, 45.2.1.39, 45.2.1.54" ::= { efmCuPmeStatusEntry 2 } efmCuPmeOperSubType OBJECT-TYPE SYNTAX INTEGER { ieee2BaseTLO(1), ieee2BaseTLR(2), ieee10PassTSO(3), ieee10PassTSR(4) } MAX-ACCESS read-only STATUS current DESCRIPTION "Current operational sub-type of the PME. Possible values are: ieee2BaseTLO - PME operates as 2BaseTL-O ieee2BaseTLR - PME operates as 2BaseTL-R ieee10PassTSO - PME operates as 10PassTS-O ieee10PassTSR - PME operates as 10PassTS-R The operational sub type of the PME can be configured via efmCuPmeAdminSubType variable. If a Clause 45 MDIO Interface to the PMA/PMD is present, then this object combines values of the Port sub-type select bits, the PMA/PMD type selection bits in the 10P/2B PMA/PMD control register and the PMA/PMD link status bits in the 10P/2B PMA/PMD status register." REFERENCE "[802.3ah] 61.1, 45.2.1.11.4, 45.2.1.11.7, 45.2.1.12.4" ::= { efmCuPmeStatusEntry 3 } efmCuPmeOperProfile OBJECT-TYPE SYNTAX EfmProfileIndexOrZero MAX-ACCESS read-only STATUS current DESCRIPTION "PME current operating Profile. This object is a pointer to an entry in either efmCuPme2BProfileTable or efmCuPme10PProfileTable, depending on the current operating SubType of the PME as indicated by efmCuPmeOperSubType. Note that a profile entry, to which efmCuPmeOperProfile is pointing to, can be created automatically, to reflect achieved parameters in adaptive (not fixed) initialization, i.e. values of efmCuPmeOperProfile and efmCuAdminProfile or efmCuPmeAdminProfile may differ. The value of zero indicates that PME is down or initializing. This object partially maps to the aOperatingProfile attribute in Clause 30." REFERENCE "[802.3ah] 30.11.2.1.7" ::= { efmCuPmeStatusEntry 4 } efmCuPmeSnrMgn OBJECT-TYPE SYNTAX Integer32(-127..128|65535) UNITS "dB" MAX-ACCESS read-only STATUS current DESCRIPTION "The current Signal-to-Noise Ratio (SNR) margin with respect to the received signal as perceived by the local PME. The value of 65535 is returned when PME is down or initializing. This object maps to the aPMESNRMgn attribute in Clause 30. If a Clause 45 MDIO Interface is present, then this object maps to the 10P/2B RX SNR margin register." REFERENCE "[802.3ah] 30.11.2.1.4, 45.2.1.16" ::= { efmCuPmeStatusEntry 5 } efmCuPmePeerSnrMgn OBJECT-TYPE SYNTAX Integer32(-127..128|65535) UNITS "dB" MAX-ACCESS read-only STATUS current DESCRIPTION "The current SNR margin in dB with respect to the received signal, as perceived by the remote (link partner) PME. The value of 65535 is returned when PME is down or initializing. This object is not supported by -R PME subtypes. If a Clause 45 MDIO Interface is present, then this object maps to the 10P/2B link partner RX SNR margin register." REFERENCE "[802.3ah] 45.2.1.17" ::= { efmCuPmeStatusEntry 6} efmCuPmeLineAtn OBJECT-TYPE SYNTAX Integer32(-127..128|65535) UNITS "dB" MAX-ACCESS read-only STATUS current DESCRIPTION "The current Line Attenuation in dB as perceived by the local PME. The value of 65535 is returned when PME is down or initializing. If a Clause 45 MDIO Interface is present, then this object maps to the Line Attenuation register" REFERENCE "[802.3ah] 45.2.1.18" ::= { efmCuPmeStatusEntry 7 } efmCuPmePeerLineAtn OBJECT-TYPE SYNTAX Integer32(-127..128|65535) UNITS "dB" MAX-ACCESS read-only STATUS current DESCRIPTION "The current Line Attenuation in dB as perceived by the remote (link partner) PME. The value of 65535 is returned when PME is down or initializing. This object is not supported by CPE port (-R) subtypes. If a Clause 45 MDIO Interface is present, then this object maps to the 20P/2B link partner Line Attenuation register." REFERENCE "[802.3ah] 45.2.1.19" ::= { efmCuPmeStatusEntry 8 } efmCuPmeEquivalentLength OBJECT-TYPE SYNTAX Unsigned32(0..8192|65535) UNITS "m" MAX-ACCESS read-only STATUS current DESCRIPTION "An estimate of the equivalent loop's Physical Length in meters, as perceived by the PME after the link is established. An equivalent loop is a hypothetical 26AWG (0.4mm) loop with a perfect square root attenuation characteristic, without any bridged taps. The value of 65535 is returned if the link is Down or Initializing or the PME is unable to estimate the Equivalent Length. For 10BASE-TL PME, if a Clause 45 MDIO Interface to the PME is present, then this object maps to the 10P Electrical Length register" REFERENCE "[802.3ah] 45.2.1.21" ::= { efmCuPmeStatusEntry 9 } efmCuPmeTCCodingErrors OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A number of 64/65-octet encapsulation errors. This counter is incremented for each 64/65-octet encapsulation error detected by the 64/65-octet receive function. This object maps to aTCCodingViolations attribute in clause 30. If a Clause 45 MDIO Interface to the PME TC is present, then this object maps to the TC coding violations register (see 45.2.6.12). Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime, defined in IF-MIB." REFERENCE "[802.3ah] 61.3.3.1, 30.11.2.1.5, 45.2.6.12" ::= { efmCuPmeStatusEntry 10 } efmCuPmeTCCrcErrors OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A number of TC-CRC errors. This counter is incremented for each TC-CRC error detected by the 64/65-octet receive function (see 61.3.3.3 and Figure 61-19). This object maps to aTCCRCErrors attribute in clause 30. If a Clause 45 MDIO Interface to the PCME TC is present, then this object maps to the TC CRC error register (see 45.2.6.11). Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime, defined in IF-MIB." REFERENCE "[802.3ah] 61.3.3.3, 30.11.2.1.10, 45.2.6.11" ::= { efmCuPmeStatusEntry 11 } -- 2BASE-TL specific PME group efmCuPme2B OBJECT IDENTIFIER ::= { efmCuPme 5 } efmCuPme2BProfileTable OBJECT-TYPE SYNTAX SEQUENCE OF EfmCuPme2BProfileEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table supports definitions of administrative and operating Profiles for 2BASE-TL PMEs. First 14 entries in this table SHALL always be defined as follows (see 802.3ah Annex 63A): -------+-------+-------+-----+------+------------------ Profile MinRate MaxRate Power Region Constellation index (Kbps) (Kbps) (dBm) -------+-------+-------+-----+------+------------------ 1 5696 5696 13.5 1 32-TCPAM (default) 2 3072 3072 13.5 1 32-TCPAM 3 2048 2048 13.5 1 16-TCPAM 4 1024 1024 13.5 1 16-TCPAM 5 704 704 13.5 1 16-TCPAM 6 512 512 13.5 1 16-TCPAM 7 5696 5696 14.5 2 32-TCPAM 8 3072 3072 14.5 2 32-TCPAM 9 2048 2048 14.5 2 16-TCPAM 10 1024 1024 13.5 2 16-TCPAM 11 704 704 13.5 2 16-TCPAM 12 512 512 13.5 2 16-TCPAM 13 192 5696 0 1 0 (best effort) 14 192 5696 0 2 0 (best effort) These default entries SHALL be created during agent initialization and MUST NOT be deleted. Entries following the first 14, can be dynamically created and deleted, to provide custom administrative (configuration) profiles and automatic operating profiles. This table MUST be maintained in a persistent manner." REFERENCE "[802.3ah] Annex 63A, 30.11.2.1.6" ::= { efmCuPme2B 2 } efmCuPme2BProfileEntry OBJECT-TYPE SYNTAX EfmCuPme2BProfileEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Each entry corresponds to a single 2BASE-TL PME profile. Each profile contains a set of parameters, used either for configuration or representation of a 2BASE-TL PME. In case a particular profile is referenced via efmCuPmeAdminProfile object (or efmCuAdminProfile if efmCuPmeAdminProfile is zero), it represent the desired parameters the 2BaseTL-O PME initialization. If a profile is referenced via efmCuPmeOperProfile object, it represents current operating parameters of the operational PME. Profiles may be created/deleted using the row creation/ deletion mechanism via efmCuPme2BProfileRowStatus. If an active entry is referenced, the entry MUST remain 'active' until all references are removed. Default entries MUST NOT be removed." INDEX { efmCuPme2BProfileIndex } ::= { efmCuPme2BProfileTable 1 } EfmCuPme2BProfileEntry ::= SEQUENCE { efmCuPme2BProfileIndex EfmProfileIndex, efmCuPme2BProfileDescr SnmpAdminString, efmCuPme2BRegion INTEGER, efmCuPme2BsMode EfmProfileIndexOrZero, efmCuPme2BMinDataRate Unsigned32, efmCuPme2BMaxDataRate Unsigned32, efmCuPme2BPower Unsigned32, efmCuPme2BConstellation INTEGER, efmCuPme2BProfileRowStatus RowStatus } efmCuPme2BProfileIndex OBJECT-TYPE SYNTAX EfmProfileIndex MAX-ACCESS not-accessible STATUS current DESCRIPTION "2BASE-TL PME Profile index. This object is the unique index associated with this profile. Entries in this table are referenced via efmCuAdminProfile or efmCuPmeAdminProfile objects." ::= { efmCuPme2BProfileEntry 1 } efmCuPme2BProfileDescr OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-create STATUS current DESCRIPTION "A textual string containing information about 2BASE-TL PME Profile. The string may include information about data rate and spectral limitations of this particular profile." ::= { efmCuPme2BProfileEntry 2 } efmCuPme2BRegion OBJECT-TYPE SYNTAX INTEGER { region1(1), region2(2) } MAX-ACCESS read-create STATUS current DESCRIPTION "Regional settings for 2BASE-TL PME, as specified in the relevant Regional Annex of [G.991.2]. Regional settings specify Power Spectral Density (PSD) mask, Power Back-Off (PBO) values and place limitations on the max allowed data rate, power and constellation. Possible values for this object are: region1 - Annexes A and F (e.g. North America) region2 - Annexes B and G (e.g. Europe) Annex A/B specify regional settings for data rates 192-2304 Kbps using 16-TCPAM encoding. Annex F/G specify regional settings for rates 2320-3840 Kbps using 16-TCPAM encoding and 768-5696 Kbps using 32-TCPAM encoding. If a Clause 45 MDIO Interface to the PME is present, then this object partially maps to the Region bits in the 2B general parameter register." REFERENCE "[802.3ah] 45.2.1.42; [G.991.2] Annexes A, B, F and G" ::= { efmCuPme2BProfileEntry 3 } efmCuPme2BsMode OBJECT-TYPE SYNTAX EfmProfileIndexOrZero MAX-ACCESS read-create STATUS current DESCRIPTION "Desired custom Spectral Mode for 2BASE-TL PME. This object is a pointer to an entry in efmCuPme2BsModeTable and a block of entries in efmCuPme2BRateReachTable, which together define (country-specific) reach dependent rate limitations in addition to those defined by efmCuPme2BRegion. The value of this object is the index of the referenced spectral mode. The value of zero (default) indicates that no specific spectral mode is applicable. Attempts to set this object to a value that is not the value of the index for an active entry in the corresponding spectral mode table, MUST be rejected." REFERENCE "efmCuPme2BsModeTable, efmCuPme2BRateReachTable" DEFVAL { 0 } ::= { efmCuPme2BProfileEntry 4 } efmCuPme2BMinDataRate OBJECT-TYPE SYNTAX Unsigned32(192..5696) UNITS "Kbps" MAX-ACCESS read-create STATUS current DESCRIPTION "Minimum Data Rate for the 2BASE-TL PME. This object can take values of (n x 64)Kbps, where n=3..60 for 16-TCPAM and n=12..89 for 32-TCPAM encoding. The data rate of the 2BASE-TL PME is considered 'fixed' when the value of this object equals that of efmCuPme2BMaxDataRate. If efmCuPme2BMinDataRate is less than efmCuPme2BMaxDataRate in the administrative profile, the data rate is considered 'adaptive', and SHALL be set to the maximum attainable rate not exceeding efmCuPme2BMaxDataRate, under the spectral limitations placed by the efmCuPme2BRegion and efmCuPme2BsMode. Note that current operational data rate of the PME is represented by ifSpeed object of IF-MIB. If a Clause 45 MDIO Interface to the PME is present, then this object maps to the Min Data Rate1 bits in the 2B PMD parameters register. This object MUST be maintained in a persistent manner." REFERENCE "[802.3ah] 45.2.1.43" ::= { efmCuPme2BProfileEntry 5 } efmCuPme2BMaxDataRate OBJECT-TYPE SYNTAX Unsigned32(192..5696) UNITS "Kbps" MAX-ACCESS read-create STATUS current DESCRIPTION "Maximum Data Rate for the 2BASE-TL PME. This object can take values of (n x 64)Kbps, where n=3..60 for 16-TCPAM and n=12..89 for 32-TCPAM encoding. The data rate of the 2BASE-TL PME is considered 'fixed' when the value of this object equals that of efmCuPme2BMinDataRate. If efmCuPme2BMinDataRate is less than efmCuPme2BMaxDataRate in the administrative profile, the data rate is considered 'adaptive', and SHALL be set to the maximum attainable rate not exceeding efmCuPme2BMaxDataRate, under the spectral limitations placed by the efmCuPme2BRegion and efmCuPme2BsMode. Note that current operational data rate of the PME is represented by ifSpeed object of IF-MIB. If a Clause 45 MDIO Interface to the PME is present, then this object maps to the Max Data Rate1 bits in the 2B PMD parameters register. This object MUST be maintained in a persistent manner." REFERENCE "[802.3ah] 45.2.1.43" ::= { efmCuPme2BProfileEntry 6 } efmCuPme2BPower OBJECT-TYPE SYNTAX Unsigned32(0|10..42) UNITS "0.5 dBm" MAX-ACCESS read-create STATUS current DESCRIPTION "Signal Transmit Power. Multiple of 0.5dBm. The value of 0 in the administrative profile means that the signal transmit power is not fixed and SHALL be set to maximize the attainable rate, under the spectral limitations placed by the efmCuPme2BRegion and efmCuPme2BsMode. If a Clause 45 MDIO Interface to the PME is present, then this object maps to the Power1 bits in the 2B PMD parameters register" REFERENCE "[802.3ah] 45.2.1.43" ::= { efmCuPme2BProfileEntry 7 } efmCuPme2BConstellation OBJECT-TYPE SYNTAX INTEGER { adaptive(0), tcpam16(1), tcpam32(2) } MAX-ACCESS read-create STATUS current DESCRIPTION "TCPAM Constellation of the 2BASE-TL PME. The possible values are: adaptive(0) - either 16- or 32-TCPAM tcpam16(1) - 16-TCPAM tcpam32(2) - 32-TCPAM The value of adaptive(0) in the administrative profile means that the constellation is not fixed and SHALL be set to maximize the attainable rate, under the spectral limitations placed by the efmCuPme2BRegion and efmCuPme2BsMode. If a Clause 45 MDIO Interface to the PME is present, then this object maps to the Constellation1 bits in the 2B general parameter register." REFERENCE "[802.3ah] 45.2.1.43" ::= { efmCuPme2BProfileEntry 8 } efmCuPme2BProfileRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "This object controls creation/deletion of the associated entry in efmCuPme2BProfileTable per the semantics of RowStatus. If an 'active' entry is referenced via efmCuAdminProfile or efmCuPmeAdminProfile, the entry MUST remain 'active' until all references are removed." ::= { efmCuPme2BProfileEntry 9 } efmCuPme2BsModeTable OBJECT-TYPE SYNTAX SEQUENCE OF EfmCuPme2BsModeEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table, together with efmCu2BReachRateTable, supports definition of administrative custom spectral modes for 2BASE-TL PMEs, describing spectral limitations in addition to those specified by efmCuPme2BRegion. Some countries spectral regulations (e.g. UK ANFP) limit the length of the loops for certain data rates. This table allows these country-specific limitations to be specified. Entries in this table referenced by the efmCuPme2BsMode MUST NOT be deleted until all the active references are removed. This table MUST be maintained in a persistent manner." REFERENCE "efmCu2BReachRateTable" ::= { efmCuPme2B 3 } efmCuPme2BsModeEntry OBJECT-TYPE SYNTAX EfmCuPme2BsModeEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Each entry specifies spectral mode description and its index, which is used to reference corresponding entries in the efmCu2BReachRateTable. Entries may be created/deleted using the row creation/ deletion mechanism via efmCuPme2BsModeRowStatus." INDEX { efmCuPme2BsModeIndex } ::= { efmCuPme2BsModeTable 1 } EfmCuPme2BsModeEntry ::= SEQUENCE { efmCuPme2BsModeIndex EfmProfileIndex, efmCuPme2BsModeDescr SnmpAdminString, efmCuPme2BsModeRowStatus RowStatus } efmCuPme2BsModeIndex OBJECT-TYPE SYNTAX EfmProfileIndex MAX-ACCESS not-accessible STATUS current DESCRIPTION "2BASE-TL PME Spectral Mode index. This object is the unique index associated with this spectral mode. Entries in this table are referenced via efmCuPme2BsMode object." ::= { efmCuPme2BsModeEntry 1 } efmCuPme2BsModeDescr OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-create STATUS current DESCRIPTION "A textual string containing information about 2BASE-TL PME spectral mode. The string may include information about corresponding (country-specific) spectral regulations and rate/reach limitations of this particular spectral mode." ::= { efmCuPme2BsModeEntry 2 } efmCuPme2BsModeRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "This object controls creation/deletion of the associated entry in efmCuPme2BsModeTable per the semantics of RowStatus. If an 'active' entry is referenced via efmCuPme2BsMode, the entry MUST remain 'active' until all references are removed." ::= { efmCuPme2BsModeEntry 3 } efmCuPme2BReachRateTable OBJECT-TYPE SYNTAX SEQUENCE OF EfmCuPme2BReachRateEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table supports definition of administrative custom spectral modes for 2BASE-TL PMEs, providing spectral limitations in addition to those specified by efmCuPme2BRegion. The spectral regulations in some countries (e.g. UK ANFP) limit the length of the loops for certain data rates. This table allows these country-specific limitations to be specified. Below is an example of this table for [ANFP]: ----------+-------+-------+ Equivalent MaxRate MaxRate Length PAM16 PAM32 (m) (Kbps) (Kbps) ----------+-------+-------+ 975 2304 5696 1125 2304 5504 1275 2304 5120 1350 2304 4864 1425 2304 4544 1500 2304 4288 1575 2304 3968 1650 2304 3776 1725 2304 3520 1800 2304 3264 1875 2304 3072 1950 2048 2688 2100 1792 2368 2250 1536 0 2400 1408 0 2550 1280 0 2775 1152 0 2925 1152 0 3150 1088 0 3375 1024 0 ----------+-------+-------+ Entries in this table referenced by the efmCuPme2BsMode MUST NOT be deleted until all the active references are removed. This table MUST be maintained in a persistent manner." REFERENCE "[ANFP]" ::= { efmCuPme2B 4 } efmCuPme2BReachRateEntry OBJECT-TYPE SYNTAX EfmCuPme2BReachRateEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Each entry specifies maximum 2BASE-TL PME data rates allowed for a certain equivalent loop length, when using 16-TCPAM or 32-TCPAM encoding. When 2BASE-TL PME is initialized, its data rate MUST NOT exceed one of the following limitations: - the value of efmCuPme2BMaxDataRate - maximum data rate allowed by efmCuPme2BRegion and efmCuPme2BPower - maximum data rate for a given encoding specified in the efmCuPme2BsModeEntry, corresponding to the equivalent loop length, estimated by the PME. It is RECOMMENDED that the efmCuPme2BEquivalentLength values are assigned in the increasing order, starting from the minimum value. Entries may be created/deleted using the row creation/ deletion mechanism via efmCuPme2ReachRateRowStatus." INDEX { efmCuPme2BsModeIndex, efmCuPme2BReachRateIndex } ::= { efmCuPme2BReachRateTable 1 } EfmCuPme2BReachRateEntry ::= SEQUENCE { efmCuPme2BReachRateIndex EfmProfileIndex, efmCuPme2BEquivalentLength Unsigned32, efmCuPme2BMaxDataRatePam16 Unsigned32, efmCuPme2BMaxDataRatePam32 Unsigned32, efmCuPme2BReachRateRowStatus RowStatus } efmCuPme2BReachRateIndex OBJECT-TYPE SYNTAX EfmProfileIndex MAX-ACCESS not-accessible STATUS current DESCRIPTION "2BASE-TL custom spectral mode Reach-Rate table index. This object is the unique index associated with each enry." ::= { efmCuPme2BReachRateEntry 1 } efmCuPme2BEquivalentLength OBJECT-TYPE SYNTAX Unsigned32(0..8192) UNITS "m" MAX-ACCESS read-create STATUS current DESCRIPTION "Maximum allowed Equivalent loop's Physical Length in meters for the specified data rates. An equivalent loop is a hypothetical 26AWG (0.4mm) loop with a perfect square root attenuation characteristic, without any bridged taps." ::= { efmCuPme2BReachRateEntry 2 } efmCuPme2BMaxDataRatePam16 OBJECT-TYPE SYNTAX Unsigned32(0|192..5696) UNITS "Kbps" MAX-ACCESS read-create STATUS current DESCRIPTION "Maximum data rate for 2BASE-TL PME at the specified Equivalent loop's Length using TC-PAM16 encoding. The value of zero means that TC-PAM16 encoding should not be used at this distance." ::= { efmCuPme2BReachRateEntry 3 } efmCuPme2BMaxDataRatePam32 OBJECT-TYPE SYNTAX Unsigned32(0|192..5696) UNITS "Kbps" MAX-ACCESS read-create STATUS current DESCRIPTION "Maximum data rate for 2BASE-TL PME at the specified Equivalent loop's Length using TC-PAM32 encoding. The value of zero means that TC-PAM32 encoding should not be used at this distance." ::= { efmCuPme2BReachRateEntry 4 } efmCuPme2BReachRateRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "This object controls creation/deletion of the associated entry in efmCuPme2BReachRateTable per the semantics of RowStatus. If an 'active' entry is referenced via efmCuPme2BsMode, the entry MUST remain 'active' until all references are removed." ::= { efmCuPme2BReachRateEntry 5 } -- 10PASS-TS specific PME group efmCuPme10P OBJECT IDENTIFIER ::= { efmCuPme 6 } efmCuPme10PProfileTable OBJECT-TYPE SYNTAX SEQUENCE OF EfmCuPme10PProfileEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table supports definitions of configuration profiles for 10PassTL PMEs. First 22 entries in this table SHALL always be defined as follows (see 802.3ah Annex 62B.3): -------+--------+----+---------+-----+------------ Profile Bandplan UPBO BandNotch DRate URate Index PSDMask# p# p# p# p# -------+--------+----+---------+-----+------------ 1 1 3 2,6,10,11 20 20(default) 2 13 5 0 20 20 3 1 1 0 20 20 4 16 0 0 100 100 5 16 0 0 70 50 6 6 0 0 50 10 7 17 0 0 30 30 8 8 0 0 30 5 9 4 0 0 25 25 10 4 0 0 15 15 11 23 0 0 10 10 12 23 0 0 5 5 13 16 0 2,5,9,11 100 100 14 16 0 2,5,9,11 70 50 15 6 0 2,6,10,11 50 10 16 17 0 2,5,9,11 30 30 17 8 0 2,6,10,11 30 5 18 4 0 2,6,10,11 25 25 19 4 0 2,6,10,11 15 15 20 23 0 2,5,9,11 10 10 21 23 0 2,5,9,11 5 5 22 30 0 0 200 50 These default entries SHALL be created by during agent initialization and MUST NOT be deleted. Entries following the first 22, can be dynamically created and deleted, to provide custom administrative (configuration) profiles and automatic operating profiles. This table MUST be maintained in a persistent manner." REFERENCE "[802.3ah] Annex 62B.3, 30.11.2.1.6" ::= { efmCuPme10P 1 } efmCuPme10PProfileEntry OBJECT-TYPE SYNTAX EfmCuPme10PProfileEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Each entry corresponds to a single 10PASS-TS PME profile. Each profile contains a set of parameters, used either for configuration or representation of a 10PASS-TS PME. In case a particular profile is referenced via efmCuPmeAdminProfile object (or efmCuAdminProfile if efmCuPmeAdminProfile is zero), it represent the desired parameters the 10PassTS-O PME initialization. If a profile is referenced via efmCuPmeOperProfile object, it represents current operating parameters of the PME. Profiles may be created/deleted using the row creation/ deletion mechanism via efmCuPme10PProfileRowStatus. If an 'active' entry is referenced, the entry MUST remain 'active' until all references are removed. Default entries MUST NOT be removed." INDEX { efmCuPme10PProfileIndex } ::= { efmCuPme10PProfileTable 1 } EfmCuPme10PProfileEntry ::= SEQUENCE { efmCuPme10PProfileIndex EfmProfileIndex, efmCuPme10PProfileDescr SnmpAdminString, efmCuPme10PBandplanPSDMskProfile INTEGER, efmCuPme10PUPBOReferenceProfile INTEGER, efmCuPme10PBandNotchProfiles BITS, efmCuPme10PPayloadURateProfile INTEGER, efmCuPme10PPayloadDRateProfile INTEGER, efmCuPme10PProfileRowStatus RowStatus } efmCuPme10PProfileIndex OBJECT-TYPE SYNTAX EfmProfileIndex MAX-ACCESS not-accessible STATUS current DESCRIPTION "10PASS-TS PME Profile Index. This object is the unique index associated with this profile. Entries in this table are referenced via efmCuAdminProfile or efmCuPmeAdminProfile." ::= { efmCuPme10PProfileEntry 1 } efmCuPme10PProfileDescr OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-create STATUS current DESCRIPTION "A textual string containing information about 10PASS-TS PME Profile. The string may include information about data rate and spectral limitations of this particular profile." ::= { efmCuPme10PProfileEntry 2 } efmCuPme10PBandplanPSDMskProfile OBJECT-TYPE SYNTAX INTEGER { profile1(1), profile2(2), profile3(3), profile4(4), profile5(5), profile6(6), profile7(7), profile8(8), profile9(9), profile10(10), profile11(11), profile12(12), profile13(13), profile14(14), profile15(15), profile16(16), profile17(17), profile18(18), profile19(19), profile20(20), profile21(21), profile22(22), profile23(23), profile24(24), profile25(25), profile26(26), profile27(27), profile28(28), profile29(29) } MAX-ACCESS read-create STATUS current DESCRIPTION "10PASS-TS PME Bandplan and PSD Mask profile, as specified in 802.3ah Annex 62A. Possible values are: --------------+------------------------+-----------+--------- Profile Name PSD Mask Bands Bandplan --------------+------------------------+-----------+--------- profile1(1) - T1.424/T-U P1 FTTCab.M1 x/D/U/D/U A profile2(2) - T1.424/T-U P1 FTTEx.M1 profile3(3) - T1.424/T-U P1 FTTCab.M2 profile4(4) - T1.424/T-U P1 FTTEx.M2 profile5(5) - T1.424/T-U P1 FTTCab.M1 D/D/U/D/U profile6(6) - T1.424/T-U P1 FTTEx.M1 profile7(7) - T1.424/T-U P1 FTTCab.M2 profile8(8) - T1.424/T-U P1 FTTEx.M2 profile9(9) - T1.424/T-U P1 FTTCab.M1 U/D/U/D/x profile10(10) - T1.424/T-U P1 FTTEx.M1 profile11(11) - T1.424/T-U P1 FTTCab.M2 profile12(12) - T1.424/T-U P1 FTTEx.M2 profile13(13) - TS1 101 270-1 Pcab.M1.A x/D/U/D/U B profile14(14) - TS1 101 270-1 Pcab.M1.B profile15(15) - TS1 101 270-1 Pex.P1.M1 profile16(16) - TS1 101 270-1 Pex.P2.M1 profile17(17) - TS1 101 270-1 Pcab.M2 profile18(18) - TS1 101 270-1 Pex.P1.M2 profile19(19) - TS1 101 270-1 Pex.P2.M2 profile20(20) - TS1 101 270-1 Pcab.M1.A U/D/U/D/x profile21(21) - TS1 101 270-1 Pcab.M1.B profile22(22) - TS1 101 270-1 Pex.P1.M1 profile23(23) - TS1 101 270-1 Pex.P2.M1 profile24(24) - TS1 101 270-1 Pcab.M2 profile25(25) - TS1 101 270-1 Pex.P1.M2 profile26(26) - TS1 101 270-1 Pex.P2.M2 profile27(27) - G.993.1 F.1.2.1 (VDSLoPOTS) x/D/U/D/U F profile28(28) - G.993.1 F.1.2.2 (VDSLoTCM-ISDN) profile29(29) - G.993.1 F.1.2.3 (PSD reduction) This object maps to the aBandplanPSDMaskProfile attribute in Clause 30." REFERENCE "[802.3ah] Annex 62A, 30.5.1.1.22" ::= { efmCuPme10PProfileEntry 3 } efmCuPme10PUPBOReferenceProfile OBJECT-TYPE SYNTAX INTEGER { profile1(1), profile2(2), profile3(3), profile4(4), profile5(5), profile6(6), profile7(7), profile8(8), profile9(9) } MAX-ACCESS read-create STATUS current DESCRIPTION "10PASS-TS PME Upstream Power Back-Off (UPBO) Reference PSD Profile, as specified in 802.3ah Annex 62A. Possible values are: profile1(1) - T1.424/T-U Noise A M1 profile2(2) - T1.424/T-U Noise A M2 profile3(3) - T1.424/T-U Noise F M1 profile4(4) - T1.424/T-U Noise F M2 profile5(5) - ETSI TS 101 270-1 Noise A&B profile6(6) - ETSI TS 101 270-1 Noise C profile7(7) - ETSI TS 101 270-1 Noise D profile8(8) - ETSI TS 101 270-1 Noise E profile9(9) - ETSI TS 101 270-1 Noise F This object maps to the aUPBOReferenceProfile attribute in Clause 30." REFERENCE "[802.3ah] Annex 62A.3.4, 30.5.1.1.23" ::= { efmCuPme10PProfileEntry 4 } efmCuPme10PBandNotchProfiles OBJECT-TYPE SYNTAX BITS { profile0(0), profile1(1), profile2(2), profile3(3), profile4(4), profile5(5), profile6(6), profile7(7), profile8(8), profile9(9), profile10(10), profile11(11) } MAX-ACCESS read-create STATUS current DESCRIPTION "10PASS-TS PME Egress Control Band Notch Profile bitmap, as specified in 802.3ah Annex 62A. Possible values are: --------------+---------+----------+-----------+------+----- Profile Name G.991.3 T1.424/T-U TS101 270-1 StartF EndF Table Table Table (MHz) (MHz) --------------+---------+----------+-----------+------+----- profile0(0) - no profile profile1(1) - F-5 #01 - - 1.810 1.825 profile2(2) - 6-2 15-1 17 1.810 2.000 profile3(3) - F-5 #02 - - 1.907 1.912 profile4(4) - F-5 #03 - - 3.500 3.575 profile5(5) - 6-2 - 17 3.500 3.800 profile6(6) - - 15-1 - 3.500 4.000 profile7(7) - F-5 #04 - - 3.747 3.754 profile8(8) - F-5 #05 - - 3.791 3.805 profile9(9) - 6-2 - 17 7.000 7.100 profile10(10) - F-5 #06 15-1 - 7.000 7.300 profile11(11) - 6-2 15-1 1 10.100 10.150 Any combination of profiles can be specified by ORing individual profiles, for example value of 0x0622 selects profiles 2,6,10 and 11. This object maps to the aBandNotchProfile attribute in Clause 30." REFERENCE "[802.3ah] Annex 62A.3.5, 30.5.1.1.19" ::= { efmCuPme10PProfileEntry 5 } efmCuPme10PPayloadURateProfile OBJECT-TYPE SYNTAX INTEGER { profile5(5), profile10(10), profile15(15), profile20(20), profile25(25), profile30(30), profile50(50), profile70(70), profile100(100) } MAX-ACCESS read-create STATUS current DESCRIPTION "10PASS-TS PME Upstream Payload Rate Profile, as specified in 802.3ah Annex 62A. Possible values are: profile5(5) - 2.5 Mbps profile10(10) - 5 Mbps profile15(15) - 7.5 Mbps profile20(20) - 10 Mbps profile25(25) - 12.5 Mbps profile30(30) - 15 Mbps profile50(50) - 25 Mbps profile70(70) - 35 Mbps profile100(100) - 50 Mbps Each value represents a target for the PME's Upstream Payload Bitrate as seen at the MII. If the payload rate of the selected profile cannot be achieved based on the loop environment, bandplan and PSD mask, the PME initialization SHALL fail. This object maps to the aPayloadRateProfileUpstream attribute in Clause 30." REFERENCE "[802.3ah] Annex 62A.3.6, 30.5.1.1.20" ::= { efmCuPme10PProfileEntry 6 } efmCuPme10PPayloadDRateProfile OBJECT-TYPE SYNTAX INTEGER { profile5(5), profile10(10), profile15(15), profile20(20), profile25(25), profile30(30), profile50(50), profile70(70), profile100(100), profile140(140), profile200(200) } MAX-ACCESS read-create STATUS current DESCRIPTION "10PASS-TS PME Downstream Payload Rate Profile, as specified in 802.3ah Annex 62A. Possible values are: profile5(5) - 2.5 Mbps profile10(10) - 5 Mbps profile15(15) - 7.5 Mbps profile20(20) - 10 Mbps profile25(25) - 12.5 Mbps profile30(30) - 15 Mbps profile50(50) - 25 Mbps profile70(70) - 35 Mbps profile100(100) - 50 Mbps profile140(140) - 70 Mbps profile200(200) - 100 Mbps Each value represents a target for the PME's Downstream Payload Bitrate as seen at the MII. If the payload rate of the selected profile cannot be achieved based on the loop environment, bandplan and PSD mask, the PME initialization SHALL fail. This object maps to the aPayloadRateProfileDownstream attribute in Clause 30." REFERENCE "[802.3ah] Annex 62A.3.6, 30.5.1.1.21" ::= { efmCuPme10PProfileEntry 7 } efmCuPme10PProfileRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "This object controls creation/deletion of the associated entry in efmCuPme10PProfileTable per the semantics of RowStatus. If an active entry is referenced via efmCuAdminProfile or efmCuPmeAdminProfile, the entry MUST remain 'active' until all references are removed." ::= { efmCuPme10PProfileEntry 8 } efmCuPme10PStatusTable OBJECT-TYPE SYNTAX SEQUENCE OF EfmCuPme10PStatusEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Table reflecting status of EFMCu 10PASS-TS PMEs (modems)." ::= { efmCuPme10P 2 } efmCuPme10PStatusEntry OBJECT-TYPE SYNTAX EfmCuPme10PStatusEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the EFMCu 10PASS-TS PME Status table." AUGMENTS { efmCuPmeStatusEntry } ::= { efmCuPme10PStatusTable 1 } EfmCuPme10PStatusEntry ::= SEQUENCE { efmCuPme10PFECCorrectedBlocks Counter32, efmCuPme10PFECUncorrectedBlocks Counter32 } efmCuPme10PFECCorrectedBlocks OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A count of received and corrected FEC codewords in 10PASS-TS PME. This object maps to aPMEFECCorrectedBlocks attribute in clause 30. If a Clause 45 MDIO Interface to the PMA/PMD is present, then this object maps to the 10P FEC correctable errors register Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime, defined in IF-MIB." REFERENCE "[802.3ah] 45.2.1.22, 30.11.2.1.8" ::= { efmCuPme10PStatusEntry 1 } efmCuPme10PFECUncorrectedBlocks OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A count of received FEC codewords in 10PASS-TS PME, which are uncorrectable. This object maps to aPMEFECUncorrectableBlocks attribute in clause 30. If a Clause 45 MDIO Interface to the PMA/PMD is present, then this object maps to the 10P FEC uncorrectable errors register Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime, defined in IF-MIB." REFERENCE "[802.3ah] 45.2.1.23, 30.11.2.1.9" ::= { efmCuPme10PStatusEntry 2 } -- -- Conformance Statements -- efmCuGroups OBJECT IDENTIFIER ::= { efmCuConformance 1 } efmCuCompliances OBJECT IDENTIFIER ::= { efmCuConformance 2 } -- Object Groups efmCuBasicGroup OBJECT-GROUP OBJECTS { efmCuPAFSupported, efmCuAdminProfile, efmCuTargetDataRate, efmCuTargetSnrMgn, efmCuAdaptiveSpectra, efmCuPortSide, efmCuFltStatus } STATUS current DESCRIPTION "A collection of objects representing management information common for all types of EFMCu ports." ::= { efmCuGroups 1 } efmCuPAFGroup OBJECT-GROUP OBJECTS { efmCuPeerPAFSupported, efmCuPAFCapacity, efmCuPeerPAFCapacity, efmCuPAFAdminState, efmCuPAFDiscoveryCode, efmCuPAFRemoteDiscoveryCode, efmCuNumPMEs } STATUS current DESCRIPTION "A collection of objects supporting OPTIONAL PME Aggregation Function (PAF) and PAF discovery in EFMCu ports." ::= { efmCuGroups 2 } efmCuPAFErrorsGroup OBJECT-GROUP OBJECTS { efmCuPAFInErrors, efmCuPAFInSmallFragments, efmCuPAFInLargeFragments, efmCuPAFInBadFragments, efmCuPAFInLostFragments, efmCuPAFInLostStarts, efmCuPAFInLostEnds, efmCuPAFInOverflows } STATUS current DESCRIPTION "A collection of objects supporting OPTIONAL error counters of PAF on EFMCu ports." ::= { efmCuGroups 3 } efmCuPmeGroup OBJECT-GROUP OBJECTS { efmCuPmeAdminProfile, efmCuPmeOperStatus, efmCuPmeFltStatus, efmCuPmeSubTypesSupported, efmCuPmeAdminSubType, efmCuPmeOperSubType, efmCuPAFRemoteDiscoveryCode, efmCuPmeOperProfile, efmCuPmeSnrMgn, efmCuPmePeerSnrMgn, efmCuPmeLineAtn, efmCuPmePeerLineAtn, efmCuPmeEquivalentLength, efmCuPmeTCCodingErrors, efmCuPmeTCCrcErrors, efmCuPmeThreshLineAtn, efmCuPmeThreshSnrMgn } STATUS current DESCRIPTION "A collection of objects providing information about a 2BASE-TL/10PASS-TS PME." ::= { efmCuGroups 4 } efmCuAlarmConfGroup OBJECT-GROUP OBJECTS { efmCuThreshLowRate, efmCuLowRateCrossingEnable, efmCuPmeThreshLineAtn, efmCuPmeLineAtnCrossingEnable, efmCuPmeThreshSnrMgn, efmCuPmeSnrMgnCrossingEnable, efmCuPmeDeviceFaultEnable, efmCuPmeConfigInitFailEnable, efmCuPmeProtocolInitFailEnable } STATUS current DESCRIPTION "A collection of objects supporting configuration of alarm thresholds and notifications in EFMCu ports." ::= { efmCuGroups 5 } efmCuNotificationGroup NOTIFICATION-GROUP NOTIFICATIONS { efmCuLowRateCrossing, efmCuPmeLineAtnCrossing, efmCuPmeSnrMgnCrossing, efmCuPmeDeviceFault, efmCuPmeConfigInitFailure, efmCuPmeProtocolInitFailure -- efmCuPmeDeviceFault, -- efmCuPmeLocalPowerLoss } STATUS current DESCRIPTION "This group supports notifications of significant conditions associated with EFMCu ports." ::= { efmCuGroups 6 } efmCuPme2BProfileGroup OBJECT-GROUP OBJECTS { efmCuPme2BProfileDescr, efmCuPme2BRegion, efmCuPme2BsMode, efmCuPme2BMinDataRate, efmCuPme2BMaxDataRate, efmCuPme2BPower, efmCuPme2BConstellation, efmCuPme2BProfileRowStatus, efmCuPme2BsModeDescr, efmCuPme2BsModeRowStatus, efmCuPme2BEquivalentLength, efmCuPme2BMaxDataRatePam16, efmCuPme2BMaxDataRatePam32, efmCuPme2BReachRateRowStatus } STATUS current DESCRIPTION "A collection of objects that constitute a configuration profile for configuration of 2BASE-TL ports." ::= { efmCuGroups 7} efmCuPme10PProfileGroup OBJECT-GROUP OBJECTS { efmCuPme10PProfileDescr, efmCuPme10PBandplanPSDMskProfile, efmCuPme10PUPBOReferenceProfile, efmCuPme10PBandNotchProfiles, efmCuPme10PPayloadURateProfile, efmCuPme10PPayloadDRateProfile, efmCuPme10PProfileRowStatus } STATUS current DESCRIPTION "A collection of objects that constitute a configuration profile for configuration of 10PASS-TS ports." ::= { efmCuGroups 8 } efmCuPme10PStatusGroup OBJECT-GROUP OBJECTS { efmCuPme10PFECCorrectedBlocks, efmCuPme10PFECUncorrectedBlocks } STATUS current DESCRIPTION "A collection of objects providing status information specific to 10PASS-TS PMEs." ::= { efmCuGroups 9 } -- Compliance Statements efmCuCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for 2BASE-TL/10PASS-TS interfaces. Compliance with the following external compliance statements is REQUIRED: MIB Module Compliance Statement ---------- -------------------- IF-MIB ifCompliance3 EtherLike-MIB dot3Compliance2 MAU-MIB mauModIfCompl3 Compliance with the following external compliance statements is OPTIONAL for implementations supporting PME Aggregation Function (PAF) with flexible cross-connect between the PCS and PME ports: MIB Module Compliance Statement ---------- -------------------- IF-INVERTED-STACK-MIB ifInvCompliance IF-CAP-STACK-MIB ifCapStackCompliance" MODULE -- this module MANDATORY-GROUPS { efmCuBasicGroup, efmCuPmeGroup, efmCuAlarmConfGroup, efmCuNotificationGroup } GROUP efmCuPme2BProfileGroup DESCRIPTION "Support for this group is only required for implementations supporting 2BASE-TL Phy." GROUP efmCuPme10PProfileGroup DESCRIPTION "Support for this group is only required for implementations supporting 10PASS-TS Phy." GROUP efmCuPAFGroup DESCRIPTION "Support for this group is only required for implementations supporting PME Aggregation Function (PAF)." GROUP efmCuPAFErrorsGroup DESCRIPTION "Support for this group is OPTIONAL for implementations supporting PME Aggregation Function (PAF)." GROUP efmCuPme10PStatusGroup DESCRIPTION "Support for this group is OPTIONAL for implementations supporting 10PASS-TS Phy." OBJECT efmCuPmeSubTypesSupported SYNTAX BITS { ieee2BaseTLO(0), ieee2BaseTLR(1), ieee10PassTSO(2), ieee10PassTSR(3) } DESCRIPTION "Support for all subtypes is not required. However at least one value SHALL be supported" OBJECT efmCuPmeAdminSubType MIN-ACCESS read-only DESCRIPTION "Write access is not required (needed only for PMEs supporting more than a single subtype, e.g. ieee2BaseTLO and ieee2BaseTLR or ieee10PassTSO and ieee10PassTSR)" OBJECT efmCuTargetSnrMgn MIN-ACCESS read-only DESCRIPTION "Write access is OPTIONAL. For PHYs without write access the target SNR margin SHALL be fixed at 5dB for 2BASE-TL and 6dB for 10PASS-TS." OBJECT efmCuAdaptiveSpectra MIN-ACCESS read-only DESCRIPTION "Write access is OPTIONAL. For PHYs without write access the default value SHOULD be false." ::= { efmCuCompliances 1 } END

 TOC 

7.  Security Considerations

There is a number of managed objects defined in the EFM-CU-MIB module that have a MAX-ACCESS clause of read-write or read-create. Most objects are writeable only when the link is Down. Writing to these objects can have potentially disruptive effects on network operation, for example:

  • Changing of efmCuPmeAdminSubType may lead to a potential locking of the link, as peer PMEs of the same sub-type cannot exchange handshake messages.
  • Changing of efmCuPAFAdminState to enabled may lead to a potential locking of the link, if the peer Phy does not support PAF.
  • Changing of efmCuPAFDiscoveryCode, before the discovery operation, may lead to a wrongful discovery, for example when two -O ports are connected to the same multi-PME -R port and both -O ports have the same Discovery register value.
  • Changing PCS or PME configuration parameters (e.g. profile of a PCS or PME via efmCuAdminProfile or efmCuPmeAdminProfile) may lead to anything from link quality and rate degradation to a complete link initialization failure, as ability of an EFMCu port to support a particular configuration depends on the copper environment.
  • Activation of a PME can cause a severe degradation of service for another EFMCu Phy, whose PME(s) may be affected by the cross-talk from the newly activated PME.
  • Removal of a PME from an operationally 'up' EFMCu port, aggregating several PMEs, may cause port's rate degradation

The user of the EFM-CU-MIB module must therefore be aware that support for SET operations in a non-secure environment without proper protection can have a negative effect on network operations.

The readable objects in the EFM-CU-MIB module (i.e., those with MAX-ACCESS other than not-accessible) may be considered sensitive in some environments since, collectively, they provide information about the performance of network interfaces and can reveal some aspects of their configuration. In particular, since EFMCu can be carried over Unshielded Twisted Pair (UTP) voice grade copper in a bundle with other pairs belonging to another operator/customer, it is theoretically possible to evasdrop to an EFMCu transmission simply by "listening" to a cross-talk from the EFMCu pairs, especially if the parameters of the EFMCu link in question are known.

In such environments it is important to control also GET and NOTIFY access to these objects and possibly even to encrypt their values when sending them over the network via SNMP.

SNMP versions prior to SNMPv3 did not include adequate security. 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 these MIB modules.

It is RECOMMENDED that implementers consider the security features as provided by the SNMPv3 framework (see [RFC3410] (Case, J., Mundy, R., Partain, D., and B. Stewart, “Introduction and Applicability Statements for Internet-Standard Management Framework,” December 2002.), section 8), including full support for the SNMPv3 cryptographic mechanisms (for authentication and privacy).

Further, deployment of SNMP versions prior to SNMPv3 is NOT RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to enable cryptographic security. It is then a customer/operator responsibility to ensure that the SNMP entity giving access to an instance of these MIB modules 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.


 TOC 

8.  IANA Considerations

The two new values of dot3MauType (dot3MauType2BaseTL and dot3MauType10PassTS) and corresponding IANAifMauTypeListBits bit definitions (b2BaseTL and b10PassTS), as well as the new values for IANAifMauMediaAvailable (availableReduced and ready) SHALL be defined by the IANA in the IANA-MAU-MIB module (see [I‑D.ietf‑hubmib‑rfc3636bis] (Beili, E., “Definitions of Managed Objects for IEEE 802.3 Medium Attachment Units (MAUs),” July 2006.)) before this document is published as an RFC.

Additionally, object identifiers for efmCuMIB MODULE-IDENTITY and ifCapStackMIB MODULE-IDENTITY SHALL be allocated by IANA in the MIB-2 sub-tree, before this document is published.


 TOC 

9.  Acknowledgments

This document was produced by the IETF Ethernet Interfaces and Hub MIB Working Group, whose efforts were greatly advanced by the contributions of the following people (in alphabetical order):

Bert Wijnen (Alcatel)

Dan Romascanu (Avaya)

Marina Popilov (Actelis)

Mathias Riess (Infineon)

Matt Squire (Hatteras)

Mike Heard

Udi Ashkenazi (Actelis)


 TOC 

10.  Notes to RFC Editor

This section contains notes to the RFC Editor and should be removed prior to publication.

Please replace [I‑D.ietf‑hubmib‑efm‑mib] (Squire, M., “Definitions and Managed Objects for OAM Functions on Ethernet Like Interfaces,” October 2006.) and [I‑D.ietf‑hubmib‑rfc3636bis] (Beili, E., “Definitions of Managed Objects for IEEE 802.3 Medium Attachment Units (MAUs),” July 2006.) with actual RFC numbers if those are available at time of publication.


 TOC 

11.  References


 TOC 

11.1. Normative References

[802.3] IEEE, “IEEE Standard for Information technology - Telecommunications and information exchange between systems - Local and metropolitan area networks - Specific requirements - Part 3: Carrier Sense Multiple Access with Collision Detection (CSMA/CD) Access Method and Physical Layer Specifications,” IEEE Std 802.3-2005, December 2005.
[802.3ah] IEEE, “IEEE Standard for Information technology - Telecommunications and information exchange between systems - Local and metropolitan area networks - Specific requirements - Part 3: Carrier Sense Multiple Access with Collision Detection (CSMA/CD) Access Method and Physical Layer Specifications - Amendment: Media Access Control Parameters, Physical Layers and Management Parameters for Subscriber Access Networks,” IEEE Std 802.3ah-2004, September 2004.
[I-D.ietf-hubmib-rfc3636bis] Beili, E., “Definitions of Managed Objects for IEEE 802.3 Medium Attachment Units (MAUs),” draft-ietf-hubmib-rfc3636bis-05 (work in progress), July 2006.
[RFC2119] Bradner, S., “Key words for use in RFCs to Indicate Requirement Levels,” BCP 14, RFC 2119, March 1997 (HTML, XML).
[RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., McCloghrie, K., 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., McCloghrie, K., Rose, M., and S. Waldbusser, “Textual Conventions for SMIv2,” STD 58, RFC 2579, April 1999.
[RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder, “Conformance Statements for SMIv2,” STD 58, RFC 2580, April 1999.
[RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, “Introduction and Applicability Statements for Internet-Standard Management Framework,” RFC 3410, December 2002.

 TOC 

11.2. Informative References

[ANFP] Network Interoperability Consultative Committee (NICC), “Specification of the Access Network Frequency Plan (ANFP) applicable to transmission systems used on the BT Access Network,” NICC Document ND1602:2005/08, August 2005.
[G.991.2] ITU-T, “Single-pair High-speed Digital Subscriber Line (SHDSL) transceivers,” ITU-T Recommendation G.991.2, December 2003.
[G.993.1] ITU-T, “Very High speed Digital Subscriber Line transceivers,” ITU-T Recommendation G.993.1, June 2004.
[I-D.ietf-hubmib-efm-epon-mib] Khermosh, L., “Managed Objects of EPON,” draft-ietf-hubmib-efm-epon-mib-06 (work in progress), November 2006.
[I-D.ietf-hubmib-efm-mib] Squire, M., “Definitions and Managed Objects for OAM Functions on Ethernet Like Interfaces,” draft-ietf-hubmib-efm-mib-05 (work in progress), October 2006.
[IANAifType-MIB] Internet Assigned Numbers Authority (IANA), “IANAifType Textual Convention definition,”  http://www.iana.org/assignments/ianaiftype-mib.
[RFC2863] McCloghrie, K. and F. Kastenholz, “The Interfaces Group MIB,” RFC 2863, June 2000.
[RFC2864] McCloghrie, K. and G. Hanson, “The Inverted Stack Table Extension to the Interfaces Group MIB,” RFC 2864, June 2000.
[RFC3635] Flick, J., “Definitions of Managed Objects for the Ethernet-like Interface Types,” RFC 3635, September 2003.
[RFC4070] Dodge, M. and B. Ray, “Definitions of Managed Object Extensions for Very High Speed Digital Subscriber Lines (VDSL) Using Multiple Carrier Modulation (MCM) Line Coding,” RFC 4070, May 2005.
[RFC4319] Sikes, C., Ray, B., and R. Abbi, “Definitions of Managed Objects for High Bit-Rate DSL - 2nd generation (HDSL2) and Single-Pair High-Speed Digital Subscriber Line (SHDSL) Lines,” RFC 4319, December 2005.

 TOC 

Author's Address

  Edward Beili
  Actelis Networks
  Bazel 25
  Petach-Tikva
  Israel
Phone:  +972-3-924-3491
Email:  edward.beili <at> actelis.com

 TOC 

Full Copyright Statement

Intellectual Property

Acknowledgment

Attachment (if-cap-stack-mib.mib): application/octet-stream, 10 KiB
Attachment (efm-cu-mib.mib): application/octet-stream, 110 KiB

Network Working Group                                           E. Beili
Internet-Draft                                          Actelis Networks
Expires: August 22, 2007                               February 18, 2007


        Ethernet in the First Mile Copper (EFMCu) Interfaces MIB
                  draft-ietf-hubmib-efm-cu-mib-07.txt

Status of this Memo

   By submitting this Internet-Draft, each author represents that any
   applicable patent or other IPR claims of which he or she is aware
   have been or will be disclosed, and any of which he or she becomes
   aware will be disclosed, in accordance with Section 6 of BCP 79.

   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.

   This Internet-Draft will expire on August 22, 2007.

Copyright Notice

   Copyright (C) The IETF Trust (2007).

Abstract

   This document defines Management Information Base (MIB) modules for
   use with network management protocols in TCP/IP based internets.
   This document describes extensions to the Ethernet-like Interfaces
   MIB and MAU MIB modules with a set of objects for managing Ethernet
   in the First Mile Copper (EFMCu) interfaces 10PASS-TS and 2BASE-TL,
   defined in IEEE Std 802.3ah-2004.  In addition a set of objects is
   defined, describing cross-connect capability of a managed device with
   multi-layer (stacked) interfaces, extending the stack management
   objects in the Interfaces Group MIB and the Inverted Stack Table MIB



Beili                    Expires August 22, 2007                [Page 1]

Internet-Draft            EFMCu Interfaces MIB             February 2007


   modules.


Table of Contents

   1.  Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  3
   2.  The Internet-Standard Management Framework . . . . . . . . . .  3
   3.  Relation to other MIB modules  . . . . . . . . . . . . . . . .  4
     3.1.  Relation to Interfaces Group MIB module  . . . . . . . . .  4
       3.1.1.  Layering Model . . . . . . . . . . . . . . . . . . . .  4
       3.1.2.  PME Aggregation Function (PAF) . . . . . . . . . . . .  6
       3.1.3.  Discovery Operation  . . . . . . . . . . . . . . . . .  7
       3.1.4.  EFMCu ports initialization . . . . . . . . . . . . . .  9
       3.1.5.  Usage of ifTable . . . . . . . . . . . . . . . . . . .  9
     3.2.  Relation to SHDSL MIB module . . . . . . . . . . . . . . . 10
     3.3.  Relation to VDSL MIB module  . . . . . . . . . . . . . . . 10
     3.4.  Relation to Ethernet-Like and MAU MIB modules  . . . . . . 11
   4.  MIB Structure  . . . . . . . . . . . . . . . . . . . . . . . . 12
     4.1.  EFM Copper MIB Overview  . . . . . . . . . . . . . . . . . 12
     4.2.  Interface stack capability MIB Overview  . . . . . . . . . 12
     4.3.  PME Profiles . . . . . . . . . . . . . . . . . . . . . . . 13
     4.4.  Mapping of IEEE 802.3ah Managed Objects  . . . . . . . . . 13
   5.  Interface Stack Capability MIB Definitions . . . . . . . . . . 14
   6.  EFM Copper MIB Definitions . . . . . . . . . . . . . . . . . . 21
   7.  Security Considerations  . . . . . . . . . . . . . . . . . . . 82
   8.  IANA Considerations  . . . . . . . . . . . . . . . . . . . . . 83
   9.  Acknowledgments  . . . . . . . . . . . . . . . . . . . . . . . 84
   10. Notes to RFC Editor  . . . . . . . . . . . . . . . . . . . . . 84
   11. References . . . . . . . . . . . . . . . . . . . . . . . . . . 84
     11.1. Normative References . . . . . . . . . . . . . . . . . . . 84
     11.2. Informative References . . . . . . . . . . . . . . . . . . 85
   Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 87
   Intellectual Property and Copyright Statements . . . . . . . . . . 88


















Beili                    Expires August 22, 2007                [Page 2]

Internet-Draft            EFMCu Interfaces MIB             February 2007


1.  Introduction

   New Ethernet-like interfaces have been defined in the Institute of
   Electrical and Electronics Engineers (IEEE) Standard 802.3ah-2004
   [802.3ah], a.k.a.  Ethernet in the First Mile (EFM), which is now a
   part of the base IEEE Standard 802.3-2005 [802.3].  In particular
   2BASE-TL and 10PASS-TS physical interfaces (PHYs), defined over
   voice-grade copper pairs, have been specified for the long and short
   reach respectively.  These interfaces, collectively called EFM Copper
   (EFMCu), are based on Single-pair High-speed Digital Subscriber Line
   (SHDSL) [G.991.2] and Very High speed Digital Subscriber Line (VDSL)
   [G.993.1] technology, supporting optional Physical Medium Entity
   (PME) aggregation (a.k.a. multi-pair bonding) with variable rates.

   2BASE-TL PHY is capable of providing at least 2Mbps over 2700 m long
   single copper pair with a mean Bit Error Rate (BER) of 10^-7 (using
   5dB target noise margin).

   10PASS-TS PHY is capable of providing at least 10Mbps over 750 m long
   single copper pair with a mean BER of 10^-7 (using 6dB target noise
   margin).

   This memo defines a Management Information Base (MIB) module for use
   with network management protocols in the Internet community to manage
   EFMCu interfaces.  In addition a MIB module is defined describing
   cross-connect capability of a stacked interface.

   Note that managed objects for Operation, Administration and
   Management (OAM) and Ethernet over Passive Optical Networks (EPON)
   clauses of IEEE 802.3ah are defined in EFM-COMMON-MIB [I-D.ietf-
   hubmib-efm-mib] and EFM-EPON-MIB [I-D.ietf-hubmib-efm-epon-mib]
   respectively.


2.  The Internet-Standard Management Framework

   For a detailed overview of the documents that describe the current
   Internet-Standard Management Framework, please refer to section 7 of
   RFC 3410 [RFC3410].

   Managed objects are accessed via a virtual information store, termed
   the Management Information Base or MIB.  MIB objects are generally
   accessed through the Simple Network Management Protocol (SNMP).
   Objects in the MIB are defined using the mechanisms defined in the
   Structure of Management Information (SMI).  This memo specifies MIB
   modules that are compliant to the SMIv2, which is described in STD
   58, RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC
   2580 [RFC2580].



Beili                    Expires August 22, 2007                [Page 3]

Internet-Draft            EFMCu Interfaces MIB             February 2007


   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
   document are to be interpreted as described in RFC 2119 [RFC2119].


3.  Relation to other MIB modules

   This section outlines the relationship of the MIB modules defined in
   this document with other MIB modules described in the relevant RFCs.
   Specifically, Interfaces Group MIB (IF-MIB), Ethernet-Like
   (EtherLike-MIB), MAU (MAU-MIB), SHDSL (HDSL2-SHDSL-LINE-MIB) and VDSL
   (VDSL-LINE-EXT-MCM-MIB) are discussed.

3.1.  Relation to Interfaces Group MIB module

   2BASE-TL and 10PASS-TS PHY's specified in the EFM-CU-MIB module are
   stacked (a.k.a. aggregated or bonded) Ethernet interfaces and as such
   are managed using generic interface management objects defined in the
   IF-MIB [RFC2863].

   The stack management, i.e. actual connection of the sub-layers to the
   top layer interface, is done via the ifStackTable, as defined in the
   IF-MIB [RFC2863] and its inverse ifInvStackTable, as defined in the
   IF-INVERTED-STACK-MIB [RFC2864].

   The new tables ifCapStackTable and its inverse ifInvCapStackTable
   defined in the IF-CAP-STACK-MIB module below, extend the stack
   management with an ability to describe possible connections or cross-
   connect capability, when a flexible cross-connect matrix is present
   between the interface layers.

3.1.1.  Layering Model

   An EFMCu interface can aggregate up to 32 Physical Medium Entity
   (PME) sub-layer devices (modems), using so called PME Aggregation
   Function (PAF).

   A generic EFMCu device can have a number of Physical Coding Sublayer
   (PCS) ports, each connected to a MAC via Medium Independent Interface
   (MII) at the upper layer, and cross-connected to a number of
   underlying PMEs, with a single PCS per PME relationship, see clause
   61.1 of [802.3ah] for more details.

   Each PME in the aggregated EFMCu port is represented in the Interface
   table (ifTable) as a separate interface with ifType of shdsl(169) for
   2BASE-TL or vdsl(97) for 10PASS-TS.  The ifType values are defined in
   [IANAifType-MIB].




Beili                    Expires August 22, 2007                [Page 4]

Internet-Draft            EFMCu Interfaces MIB             February 2007


   ifSpeed for each PME SHALL return the actual data bitrate of the
   active PME (e.g. for 2BaseTL PMEs it is a multiple of 64Kbps).  Zero
   value SHALL be returned when PME is initializing or down.

   The ifSpeed of the PCS is the sum of the current operating data rates
   of all PMEs in the aggregation group, without the 64/65B
   encapsulation overhead and PAF overhead, but accounting for the
   Inter-Frame Gaps (IFG).

   When using the stated definition of ifSpeed for the PCS, there would
   be no frame loss in the following configuration (the test-sets are
   configured to generate 100% of back to back traffic, i.e. minimal
   IFG, at 10 or 100Mbps, with min and max frame sizes; the EFM
   interfaces are aggregated, to achieve the shown speed):

   [testset]--10BaseT--[CO]--2BaseTL--[CPE]--10BaseT--[testset]
     ifSpeed=  10Mbps         10Mbps         10Mbps

   [testset]--100BaseT--[CO]--10PassTS--[CPE]--100BaseT--[testset]
     ifSpeed=  100Mbps         100Mbps         100Mbps

   Figure 1: Example configuration with no frame loss

   The following figure shows the layering diagram and corresponding use
   of ifTable and ifMauTable:

    _________________________   _
   |        LLC              |  |
   +-------------------------+  | 1 ifEntry
   |        MAC              |  |     ifType: ethernetCsmacd(6)
   +-------------------------+  >   ifMauEntry
   |        Reconsiliation   |  |     ifMauType: dot3MauType2BaseTL or
   +-------------------------+  |                dot3MauType10PassTS
   |        PCS              |  |
   +-------------+---+-------+  +
   | TC \        |   |       |  |
   +-----\       |   |       |  |
   | PMA > PME 1 |...| PME N |  > N ifEntry  (N=1..32)
   +-----/       |   |       |  |     ifType: shdsl(169) or vdsl(97)
   | PMD/        |   |       |  |
    -------------+---+-------   -

   Figure 2: Use of ifTable and ifMauTable for EFMCu ports

   The ifStackTable is indexed by the ifIndex values of the aggregated
   EFMCu port (PCS) and the PMEs connected to it. ifStackTable allows a
   Network Management application to determine which PMEs are connected
   to a particular PCS and change connections (if supported by the



Beili                    Expires August 22, 2007                [Page 5]

Internet-Draft            EFMCu Interfaces MIB             February 2007


   application).  The ifInvStackTable, being an inverted version of the
   ifStackTable, provides an efficient means for a Network Management
   application to read a subset of the ifStackTable and thereby
   determine which PCS runs on top of a particular PME.

   A new table ifCapStackTable defined in the IF-CAP-STACK-MIB module,
   specifies for each higher-layer interface (e.g.  PCS port) a list of
   lower-layer interfaces (e.g.  PMEs), which can possibly be cross-
   connected to that higher-layer interface, determined by the cross-
   connect capability of the device.  This table, modeled after
   ifStackTable, is read only, reflecting current cross-connect
   capability of a stacked interface, which can be dynamic in some
   implementations (e.g. if PMEs are located on a pluggable module and
   the module is pulled out).  Note that PME availability per PCS,
   described by ifCapStackTable, can be constrained by other parameters,
   for example by aggregation capacity of a PCS or by the PME in
   question being already connected to another PCS.  So, in order to
   ensure that a particular PME can be connected to the PCS, all
   respective parameters (e.g. ifCapStackTable, ifStackTable and
   efmCuPAFCapacity) SHALL be inspected.

   The ifInvCapStackTable, also defined in the IF-CAP-STACK-MIB module,
   describes which higher-layer interfaces (e.g.  PCS ports) can
   possibly be connected to a particular lower-layer interface (e.g.
   PME), providing inverted mapping of ifCapStackTable.  While it
   contains no additional information beyond that already contained in
   the ifCapStackTable, the ifInvCapStackTable has the ifIndex values in
   its INDEX clause in the reverse order, i.e., the lower-layer
   interface first, and the higher-layer interface second, providing an
   efficient means for a Network Management application to read a subset
   of the ifCapStackTable and thereby determine which interfaces can be
   connected to run on top of a particular interface.

3.1.2.  PME Aggregation Function (PAF)

   The PME Aggregation Function (PAF) allows a number of PMEs to be
   aggregated onto a PCS port, by fragmenting the Ethernet frames,
   transmitting the fragments over multiple PMEs and assembling the
   original frames at the remote port.  PAF is OPTIONAL, meaning that a
   device with a single PME MAY perform fragmentation and re-assembly if
   this function is supported by the device.  Note however that the
   agent is REQUIRED to report on the PAF capability for all EFMCu ports
   (2BASE-TL and 10PASS-TS).

   The EFM-CU-MIB module allows a Network Management application to
   query PAF capability and enable/disable it if supported.  Note that
   enabling PAF effectively turns on fragmentation and re-assembly, even
   on a single-PME port.



Beili                    Expires August 22, 2007                [Page 6]

Internet-Draft            EFMCu Interfaces MIB             February 2007


3.1.3.  Discovery Operation

   The EFMCu ports may optionally support discovery operation, whereby
   PMEs, during initialization, exchange information about their
   respective aggregation groups (PCS).  This information can then be
   used to detect copper misconnections or for an automatic assignment
   of the local PMEs into aggregation groups instead of a fixed pre-
   configuration.

   The MIB modules defined in this document allow a Network Management
   application to control EFM Discovery mechanism and query its results.
   Note that the Discovery mechanism can work only if PAF is supported
   and enabled.

   Two tables are used by the EFM Discovery mechanism: ifStackTable and
   ifCapStackTable.  The following pseudo-code gives an example of the
   Discovery and automatic PME assignment for a generic PAF enabled
   multi-PCS EFMCu device, located at Central Office (CO), using objects
   defined in these MIB modules and in IF-MIB [Note that automatic PME
   assignment is only shown here for the purposes of the example.  Fixed
   PME pre-assignment, manual assignment or auto-assignment using an
   alternative internal algorithm may be chosen by a particular
   implementation]:

   // Go over all PCS ports in the CO device
   FOREACH pcs[i] IN CO_device
   { // Perform discovery and auto-assignment only on PAF enabled ports
     // with room for more PMEs
     IF ( pcs[i].PAFSupported AND pcs[i].NumPMEs < pcs[i].PAFCapacity )
       { dc = pcs[i].DiscoveryCode = MAC[i]; // unique 6-octets per PCS
         // Go over all disconnected PMEs, which can
         // potentially be connected to the PCS
         FOREACH pme[j] IN ifCapStackTable[pcs[i]] AND
                        NOT ifInvStackTable[pme[j]]  // not connected
           { // Try to grab the remote RT_device, by writing the value
             // of the local 6-octet discovery code to the remote
             // discovery code register (via handshake mechanism).
             // This operation is atomic Set-if-Clear action, i.e. it
             // would succeed only if the remote discovery register was
             // zero. Read the remote discovery code register via Get
             // operation to see if the RT_device, attached via the PME
             // is indeed marked as being the CO_device peer.
             pme[j].RemoteDiscoveryCode = dc;        // Set-if-Clear
             r = pme[j].RemoteDiscoveryCode;         // Get
             IF ( r == dc AND pcs[i].NumPMEs < pcs[i].PAFCapacity)
               { // Remote RT_device connected via PME[j] is/was a peer
                 // for PCS[i] and there is room for another PME in the
                 // PCS[i] aggregation group (max. PAF capacity is not



Beili                    Expires August 22, 2007                [Page 7]

Internet-Draft            EFMCu Interfaces MIB             February 2007


                 // reached yet).
                 // Connect this PME to the PCS (via ifStackTable,
                 // ifInvStackTable being inverse of ifStackTable is
                 // updated automatically)
                 ADD pme[j] TO ifStackTable[pcs[i]];
                   // pcs[i] is auto-added to ifInvStackTable[pme[j]]
                 pcs[i].NumPMEs = pcs[i].NumPMEs + 1;
                 // Discover all other disconnected PMEs,
                 // attached to the same RT_device and connect them to
                 // the PCS provided there is enough room for more PMEs.
                 FOREACH pme[k] IN ifCapStackTable[pcs[i]] and
                                NOT ifInvStackTable[pme[k]]
                   { r = pme[k].RemoteDiscoveryCode; // Get
                     IF ( r == dc AND
                          pcs[i].NumPMEs < pcs[i].PAFCapacity)
                       { ADD pme[k] TO ifStackTable[pcs[i]];
                           // pcs[i] is added TO ifInvStackTable[pme[k]]
                         pcs[i].NumPMEs = pcs[i].NumPMEs + 1;
                       }
                   }
               }
             // At this point we have discovered all local PMEs which
             // are physically connected to the same remote RT_device
             // and connected them to PCS[i]. Go to the next PCS.
             BREAK;
           }
       }
   }

   An SNMP Agent for a EFMCu device builds ifCapStackTable and its
   inverse ifInvCapStackTable according to the information contained in
   the Clause 45 PME_Available_register (see [802.3ah] 61.1.5.3 and
   45.2.3.20).

   Adding a PME to the ifStackTable row for a specific PCS, involves
   actual connection of the PME to the PCS, which can be done by
   modifying Clause 45 PME_Aggregate_register (see [802.3ah] 61.1.5.3
   and 45.2.3.21).

   Note that PCS port does not have to be operationally 'down' for the
   connection to succeed.  In fact, a dynamic PME addition (and removal)
   MAY be implemented with an available PME being initialized first (by
   setting its ifAdminStatus to 'up') and then added to an operationally
   'up' PCS port, by modifying a respective ifStackTable (and respective
   ifInvStackTable) entry.

   It is RECOMMENDED that a removal of the last operationally 'up' PME
   from an operationally 'up' PCS would be rejected by the



Beili                    Expires August 22, 2007                [Page 8]

Internet-Draft            EFMCu Interfaces MIB             February 2007


   implementation, as this action would completely drop the link.

3.1.4.  EFMCu ports initialization

   EFMCu ports being built on top of xDSL technology, require a lengthy
   initialization or 'training' process, before any data can pass.
   During this initialization both ends of a link (peers) work
   cooperatively to achieve required data rate on a particular copper
   pair.  Sometimes, when the copper line is too long or the noise on
   the line is too high, that 'training' process may fail to achieve a
   specific target rate with required characteristics.

   The ifAdminStatus object from the IF-MIB, controls the desired state
   of a PCS with all the PMEs connected to it or of an individual PME
   port.  Setting this object to 'up' instructs a particular PCS or PME
   to start initialization process, which may take tens of seconds for
   EFMCu ports, especially if PAF is involved.  The ifOperStatus object
   shows the operational state of an interface (extended by
   ifMauMediaAvailable object from MAU-MIB for PCS and
   efmCuPmeOperStatus defined in the EFM-CU-MIB module for PME
   interfaces).

   A disconnected PME may be initialized by changing the ifAdminState
   from 'down' to 'up'.  Changing the ifAdminState to 'up' on the PCS
   initializes all PMEs connected to that particular PCS.  Note that in
   case of PAF some interfaces may fail to initialize while others
   succeed.  The PCS is considered operationally 'up' if at least one
   PME aggregated by its PAF is operationally 'up'.  When all PMEs
   connected to the PCS are 'down' the PCS SHALL be considered
   operationally 'lowerLayerDown'.  The PCS SHALL be considered
   operationally 'notPresent' if it is not connected to any PME.  The
   PCS/PME interface SHALL remain operationally 'down' during
   initialization.

   The efmCuPmeOperStatus defined in the EFM-CU-MIB module expands PME's
   ifOperStatus value of 'down' to 'downReady', 'downNotReady' and
   'init' values, indicating various EFMCu PME specific states.

3.1.5.  Usage of ifTable

   Both PME and PCS interfaces of the EFMCu PHY are managed using
   interface specific management objects defined in the EFM-CU-MIB
   module and generic interface objects from the ifTable of IF-MIB, with
   all management table entries referenced by the interface index
   ifIndex.

   The following table summarizes EFMCu specific interpretations for
   some of the ifTable objects specified by the mandatory



Beili                    Expires August 22, 2007                [Page 9]

Internet-Draft            EFMCu Interfaces MIB             February 2007


   ifGeneralInformationGroup:

   +---------------+---------------------------------------------------+
   | IF-MIB object | EFMCu interpretation                              |
   +---------------+---------------------------------------------------+
   | ifIndex       | Interface index. Note that each PME and each PCS  |
   |               | in the EFMCu PHY MUST have a unique index, as     |
   |               | there are some PCS and PME specific attributes    |
   |               | accessible only on the PCS or PME level.          |
   | ifType        | ethernetCsmacd(6) for PCS, shdsl(169) for         |
   |               | 2BASE-TL PME, vdsl(97) for 10PASS-TS PME          |
   | ifSpeed       | Operating data rate for the PME. For the PCS it   |
   |               | is the sum of the current operating data rates of |
   |               | all PMEs in the aggregation group, without the    |
   |               | 64/65B encapsulation overhead and PAF overhead,   |
   |               | but accounting for the Inter-Frame Gaps (IFG)     |
   | ifAdminStatus | Setting this object to 'up' instructs a           |
   |               | particular PCS (with all PMEs connected to it) or |
   |               | PME to start initialization process               |
   | ifOperStatus  | efmCuPmeOperStatus supplements the 'down' value   |
   |               | of ifOperStatus for PMEs.                         |
   +---------------+---------------------------------------------------+

                                  Table 1

3.2.  Relation to SHDSL MIB module

   G.SHDSL.bis modems, similar to PME(s) comprising a 2BASE-TL port, are
   described in HDSL2-SHDSL-LINE-MIB [RFC4319].  Note that not all
   attributes of G.SHDSL modems reflected in HDSL2-SHDSL-LINE-MIB have
   adequate management objects (Clause 30 attributes and Clause 45
   registers) in the EFM standard.

   Because of these differences and for the purposes of simplicity,
   unification of attributes common to both 2BASE-TL and 10PASS-TS PMEs
   and name consistency (e.g. prefixing the 2BASE-TL PME related objects
   with 'efmCuPme2B' instead of 'hdsl2shdsl'), it was decided not to
   reference HDSL2-SHDSL-LINE-MIB objects, but define all the relevant
   objects in the EFM-CU-MIB module.

   However, if some functionality, not available in the EFM-CU-MIB
   module, is required and supported by the PME, e.g. performance
   monitoring, relevant HDSL2-SHDSL-LINE-MIB groups MAY be included and
   applied for PMEs of 2BASE-TL subtype.

3.3.  Relation to VDSL MIB module

   VDSL modems, similar to the PME(s) comprising a 10PASS-TS port, are



Beili                    Expires August 22, 2007               [Page 10]

Internet-Draft            EFMCu Interfaces MIB             February 2007


   described in VDSL-LINE-EXT-MCM-MIB [RFC4070].  Note that not all
   attributes of VDSL modems reflected in VDSL-LINE-EXT-MCM-MIB have
   adequate management objects (Clause 30 attributes and Clause 45
   registers) in the EFM standard.

   Because of these differences and for the purposes of simplicity,
   unification of attributes common to both 2BASE-TL and 10PASS-TS PMEs
   and name consistency, it was decided not to reference VDSL-LINE-EXT-
   MCM-MIB objects, but define all the relevant objects in the EFM-CU-
   MIB module.

   However, if some functionality, not available in the EFM-CU-MIB
   module, is required and supported by the PME, relevant VDSL-LINE-EXT-
   MCM-MIB groups MAY be included and applied for PMEs of 10PASS-TS
   subtype.

3.4.  Relation to Ethernet-Like and MAU MIB modules

   The implementation of EtherLike-MIB [RFC3635] and MAU-MIB [I-D.ietf-
   hubmib-rfc3636bis] is REQUIRED for the EFMCu interfaces.

   Two new values of ifMauType (OBJECT-IDENTITIES of dot3MauType) and
   corresponding bit definitions of ifMauTypeListBits
   (IANAifMauTypeListBits) have been defined in the IANA-MAU-MIB
   [I-D.ietf-hubmib-rfc3636bis] for the EFMCu MAUs:

   o  dot3MauType2BaseTL and b2BaseTL - for 2BASE-TL MAU

   o  dot3MauType10PassTS and b10PassTS - for 10PASS-TS MAU

   Additionally IANA-MAU-MIB defines two new values of
   ifMauMediaAvailable, as a textual convention IANAifMauMediaAvailable
   - availableReduced and ready, specifically for the EFMCu ports.  Due
   to the PME aggregation, the EFMCu interpretation of some possible
   ifMauMediaAvailable values differs from other MAUs as follows:

   o  unknown - the EFMCu interface (PCS with connected PMEs) is
      initializing

   o  ready - the interface is down, at least one PME in the aggregation
      group (all PMEs connected to the PCS) is ready for handshake

   o  available - the interface is up, all PMEs in the aggregation group
      are up

   o  notAvailable - the interface is down, all PMEs in the aggregation
      group are down, no handshake tones are detected by any PME




Beili                    Expires August 22, 2007               [Page 11]

Internet-Draft            EFMCu Interfaces MIB             February 2007


   o  availableReduced - the interface is up, a link fault is detected
      at the receive direction by one or more PMEs in the aggregation
      group, but at least one PME is up

   o  pmdLinkFault - a link fault is detected at the receive direction
      by all PMEs in the aggregation group

   As an EtherLike interface every EFMCu port (an ifEntry representing a
   consolidation of LLC, MAC and PCS (sub)layers) SHALL return an ifType
   of ethernetCsmacd(6).  While most of the MAU characteristics are not
   applicable to the EFMCu ports (no auto-negotiation, false carriers or
   jabber), they SHALL return an appropriate ifMauType
   (dot3MauType2BaseTL or dot3mauType10PassTS) in order to direct the
   management software to look in the EFM-CU-MIB module for the desired
   information.  For example the information on the particular EFMCu
   flavor that an EFMCu port is running is available from
   efmCuOperSubType, defined in the EFM-CU-MIB module.

   Since EFMCu PMEs are not EtherLike interfaces, they cannot be
   instantiated as MAU interface objects.


4.  MIB Structure

4.1.  EFM Copper MIB Overview

   The main management objects defined in the EFM-CU-MIB module are
   split into 2 groups:

   o  efmCuPort - containing objects for configuration, capabilities,
      status and notifications, common to all EFMCu PHYs.

   o  efmCuPme - containing objects for configuration, capabilities,
      status and notifications of EFMCu PMEs.

   The efmCuPme group in turn contains efmCuPme2B and efmCuPme10P
   groups, which define PME Profiles specific to 2BASE-TL and 10PASS-TS
   PMEs respectively, as well as PME specific status information.

4.2.  Interface stack capability MIB Overview

   The IF-CAP-STACK-MIB module contains 2 tables:

   o  ifCapStackTable - containing objects that define possible
      relationships among the sub-layers of an interface with flexible
      cross-connect (cross-connect capability).





Beili                    Expires August 22, 2007               [Page 12]

Internet-Draft            EFMCu Interfaces MIB             February 2007


   o  ifInvCapStackTable - an inverse of the ifCapstackTable.

4.3.  PME Profiles

   Since a managed node can have a large number of EFMCu PHYs,
   provisioning every parameter on every EFMCu PHY may become
   burdensome.  Moreover, most PMEs are provisioned identically with the
   same set of parameters.  To simplify the provisioning process, the
   EFM-CU-MIB module makes use of configuration profiles, similar to
   HDSL2-SHDSL-LINE-MIB and VDSL-LINE-EXT-MCM-MIB.  A profile is a set
   of parameters, used either for configuration or representation of a
   PME.  The same profile can be shared by multiple PME ports, using the
   same configuration.

   The PME profiles are defined in efmCuPme2BProfileTable and
   efmCuPme10PProfileTable for 2BASE-TL and 10PASS-TS PMEs respectively.
   There are 12 predefined standard profiles for 2BASE-TL and 22
   standard profiles for 10PASS-TS, defined in 802.3ah and dedicated for
   rapid provisioning of EFMCu PHYs in most scenarios.  In addition the
   EFM-CU-MIB defines two additional predefined profiles for "best-
   effort" provisioning of 2BASE-TL PMEs.  An ability to define new
   configuration profiles is also provided to allow for EFMCu deployment
   tailored to specific copper environment and spectral regulations.

   A specific configuration or administrative profile is assigned to a
   specific PME via efmCuPmeAdminProfile object.  If
   efmCuPmeAdminProfile is zero, then efmCuAdminProfile object of the
   PCS port, connected to the PME, determines the configuration profile
   (or a list of possible profiles) for that PME.  This mechanism allows
   to specify a common profile(s) for all PMEs connected to the PCS
   port, with an ability to change individual PME profiles by setting
   efmCuPmeAdminProfile object, which overwrites the profile set by
   efmCuAdminProfile.

   A current operating PME profile is pointed to by efmCuPmeOperProfile
   object.  Note that this profile entry, can be created automatically,
   to reflect achieved parameters in adaptive (not fixed)
   initialization.

4.4.  Mapping of IEEE 802.3ah Managed Objects

   This section contains the mapping between relevant managed objects
   (attributes) defined in [802.3ah] Clause 30, and managed objects
   defined in this document and in associated MIB modules, i.e., the IF-
   MIB [RFC2863].

   Note that majority of the objects defined in the EFM-CU-MIB module do
   not have direct counterparts in Clause 30 and instead refer to Clause



Beili                    Expires August 22, 2007               [Page 13]

Internet-Draft            EFMCu Interfaces MIB             February 2007


   45 registers.

   +---------------------------------+---------------------------------+
   | IEEE 802.3 Managed Object       | Corresponding SNMP Object       |
   +---------------------------------+---------------------------------+
   | oMAU - Basic Package            |                                 |
   | (Mandatory)                     |                                 |
   | aMAUType                        | ifMauType (MAU-MIB)             |
   | aMAUTypeList                    | ifMauTypeListBits (MAU-MIB)     |
   | aMediaAvailable                 | ifMediaAvailable (MAU-MIB)      |
   | oPAF - Basic Package            |                                 |
   | (Mandatory)                     |                                 |
   | aPAFID                          | ifIndex (IF-MIB)                |
   | aPhyEnd                         | efmCuPhySide                    |
   | aPHYCurrentStatus               | efmCuStatus                     |
   | aPAFSupported                   | efmCuPAFSupported               |
   | oPAF - PME Aggregation Package  |                                 |
   | (Optional)                      |                                 |
   | aPAFAdminState                  | efmCuPAFAdminState              |
   | aLocalPAFCapacity               | efmCuPAFCapacity                |
   | aLocalPMEAvailable              | ifCapStackTable                 |
   | aLocalPMEAggregate              | ifStackTable (IF-MIB)           |
   | aRemotePAFSupported             | efmCuRemotePAFSupported         |
   | aRemotePAFCapacity              | efmCuRemotePAFCapacity          |
   | aRemotePMEAggregate             |                                 |
   | oPME - 10P/2B Package           |                                 |
   | (Mandatory)                     |                                 |
   | aPMEID                          | ifIndex (IF-MIB)                |
   | aPMEAdminState                  | ifAdminState (IF-MIB)           |
   | aPMEStatus                      | efmCuPmeStatus                  |
   | aPMESNRMgn                      | efmCuPmeSnrMgn                  |
   | aTCCodingViolations             | efmCuPmeTCCodingErrors          |
   | aTCCRCErrors                    | efmCuPmeTCCrcErrors             |
   | aProfileSelect                  | efmCuAdminProfile,              |
   |                                 | efmCuPmeAdminProfile            |
   | aOperatingProfile               | efmCuPmeOperProfile             |
   | aPMEFECCorrectedBlocks          | efmCuPme10PFECCorrectedBlocks   |
   | aPMEFECUncorrectableBlocks      | efmCuPme10PFECUncorrectedBlocks |
   +---------------------------------+---------------------------------+

                                  Table 2


5.  Interface Stack Capability MIB Definitions


   IF-CAP-STACK-MIB DEFINITIONS ::= BEGIN




Beili                    Expires August 22, 2007               [Page 14]

Internet-Draft            EFMCu Interfaces MIB             February 2007


     IMPORTS
       MODULE-IDENTITY, OBJECT-TYPE, mib-2
         FROM SNMPv2-SMI         -- RFC 2578
       TruthValue
         FROM SNMPv2-TC          -- RFC 2579
       MODULE-COMPLIANCE, OBJECT-GROUP
         FROM SNMPv2-CONF        -- RFC 2580
       ifStackGroup2, ifStackHigherLayer, ifStackLowerLayer
         FROM IF-MIB             -- RFC 2863
       ifInvStackGroup
         FROM IF-INVERTED-STACK-MIB -- RFC 2864
       ;

     ifCapStackMIB MODULE-IDENTITY
       LAST-UPDATED "200702180000Z"  -- February 18, 2007
       ORGANIZATION "IETF Ethernet Interfaces and Hub MIB Working Group"
       CONTACT-INFO
         "WG charter:
           http://www.ietf.org/html.charters/hubmib-charter.html

         Mailing Lists:
           General Discussion: hubmib <at> ietf.org
           To Subscribe: hubmib-request <at> ietf.org
           In Body: subscribe your_email_address

         Chair:  Bert Wijnen
         Postal: Alcatel-Lucent
                 Schagen 33
                 3461 GL Linschoten
                 Netherlands
            Tel: +31-348-407-775
         E-mail: bwijnen <at> alcatel-lucent.com

         Editor: Edward Beili
         Postal: Actelis Networks Inc.
                 25 Bazel St., P.O.B. 10173
                 Petach-Tikva 10173
                 Israel
                 Tel: +972-3-924-3491
         E-mail: edward.beili <at> actelis.com"

       DESCRIPTION
         "The objects in this MIB module are used to describe
         cross-connect capabilities of stacked (layered) interfaces,
         complementing ifStackTable and ifInvStackTable defined in
         IF-MIB and IF-INVERTED-STACK-MIB respectively.

         Copyright (C) The IETF Trust (2007).  This version



Beili                    Expires August 22, 2007               [Page 15]

Internet-Draft            EFMCu Interfaces MIB             February 2007


         of this MIB module is part of RFC XXXX;  see the RFC
         itself for full legal notices."

       REVISION    "200702180000Z"  -- February 18, 2007
       DESCRIPTION "Initial version, published as RFC XXXX."

         -- EdNote: Replace XXXX with the actual RFC number &
         -- remove this note

       ::= { mib-2 ZZZ }

         -- EdNote: Replace ZZZ with a real OID once it is
         -- allocated & remove this note.

      -- Sections of the module
      -- Structured as recommended by RFC 4181, see
      -- Appendix D: Suggested OID Layout

      ifCapStackObjects     OBJECT IDENTIFIER ::= { ifCapStackMIB 1 }

      ifCapStackConformance OBJECT IDENTIFIER ::= { ifCapStackMIB 2 }

      -- Groups in the module

      --
      -- ifCapStackTable group
      --

      ifCapStackTable  OBJECT-TYPE
        SYNTAX      SEQUENCE OF IfCapStackEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "This table, modeled after ifStackTable from IF-MIB,
          contains information on the possible 'on-top-of'
          relationships between the multiple sub-layers of network
          interfaces (as opposed to actual relationships described in
          ifStackTable). In particular, it contains information on
          which sub-layers MAY possibly run 'on top of' which other
          sub-layers, as determined by cross-connect capability of the
          device, where each sub-layer corresponds to a conceptual row
          in the ifTable. For example, when the sub-layer with ifIndex
          value x can be connected to run on top of the sub-layer with
          ifIndex value y, then this table contains:

            ifCapStackStatus.x.y=true

          ifCapStackStatus.x.y row does not exist if it is impossible



Beili                    Expires August 22, 2007               [Page 16]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          to connect between the sub-layers x and y.

          Note that for most stacked interfaces (e.g. 2BASE-TL)
          there's always at least one higher-level interface (e.g. PCS
          port) for each lower-level interface (e.g. PME) and at
          least one lower-level interface for each higher-level
          interface, that is, there is at least a single row with a
          'true' status for any existing value of x or y.

          This table is read only as it describes device capability"
        REFERENCE
          "IF-MIB, ifStackTable"
        ::= { ifCapStackObjects 1 }

      ifCapStackEntry  OBJECT-TYPE
        SYNTAX      IfCapStackEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "Information on a particular relationship between two
          sub-layers, specifying that one sub-layer MAY possibly run
          on 'top' of the other sub-layer. Each sub-layer corresponds
          to a conceptual row in the ifTable (interface index for
          lower- and higher-layer respectively)."
        INDEX {
          ifStackHigherLayer,
          ifStackLowerLayer
        }
        ::= { ifCapStackTable 1 }

      IfCapStackEntry ::= SEQUENCE {
           ifCapStackStatus       TruthValue
         }

      ifCapStackStatus  OBJECT-TYPE
        SYNTAX      TruthValue
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "The status of the 'cross-connect capability' relationship
          between two sub-layers. The following values can be returned:
            true(1)         - indicates that the sub-layer interface,
                              identified by the ifStackLowerLayer MAY
                              be connected to run 'below' the sub-layer
                              interface, identified by the
                              ifStackHigherLayer index.
            false(2)        - the sub-layer interfaces cannot be
                              connected temporarily due to



Beili                    Expires August 22, 2007               [Page 17]

Internet-Draft            EFMCu Interfaces MIB             February 2007


                              unavailability of the interface(s), e.g.
                              one of the interfaces is located on an
                              absent pluggable module.

          Note that lower-layer interface availability per higher-layer,
          indicated by the value of 'true', can be constrained by
          other parameters, for example by the aggregation capacity of
          a higher-layer interface or by the lower-layer interface in
          question being already connected to another higher-layer
          interface. In order to ensure that a particular sub-layer can
          be connected to another sub-layer, all respective objects
          (e.g. ifCapStackTable, ifStackTable and efmCuPAFCapacity for
          for EFMCu interfaces) SHALL be inspected.

          This object is read only, unlike ifStackStatus, as it
          describes a cross-connect capability."
        ::= { ifCapStackEntry 1 }

      ifInvCapStackTable  OBJECT-TYPE
        SYNTAX        SEQUENCE OF IfInvCapStackEntry
        MAX-ACCESS    not-accessible
        STATUS        current
        DESCRIPTION
          "A table containing information on the possible relationships
          between the multiple sub-layers of network interfaces. This
          table, modeled after ifInvStackTable from
          IF-INVERTED-STACK-MIB, is an inverse of the ifCapStackTable
          defined in this MIB module.
          In particular, this table contains information on which
          sub-layers MAY run 'underneath' which other sub-layers, where
          each sub-layer corresponds to a conceptual row in the ifTable.
          For example, when the sub-layer with ifIndex value x MAY be
          connected to run underneath the sub-layer with ifIndex value
          y, then this table contains:

             ifInvCapStackStatus.x.y=true

          This table contains exactly the same number of rows as the
          ifCapStackTable, but the rows appear in a different order.

          This table is read only as it describes a cross-connect
          capability."
        REFERENCE
           "IF-INVERTED-STACK-MIB, ifInvStackTable"
        ::= { ifCapStackObjects 2 }

      ifInvCapStackEntry  OBJECT-TYPE
        SYNTAX        IfInvCapStackEntry



Beili                    Expires August 22, 2007               [Page 18]

Internet-Draft            EFMCu Interfaces MIB             February 2007


        MAX-ACCESS    not-accessible
        STATUS        current
        DESCRIPTION
           "Information on a particular relationship between two sub-
           layers, specifying that one sub-layer MAY run underneath the
           other sub-layer. Each sub-layer corresponds to a conceptual
           row in the ifTable."
        INDEX { ifStackLowerLayer, ifStackHigherLayer }
        ::= { ifInvCapStackTable 1 }

       IfInvCapStackEntry ::= SEQUENCE {
         ifInvCapStackStatus       TruthValue
       }

      ifInvCapStackStatus  OBJECT-TYPE
        SYNTAX         TruthValue
        MAX-ACCESS     read-only
        STATUS         current
        DESCRIPTION
           "The status of the possible 'cross-connect capability'
           relationship between two sub-layers.

           An instance of this object exists for each instance of the
           ifCapStackStatus object, and vice versa. For example, if the
           variable ifCapStackStatus.H.L exists, then the variable
           ifInvStackStatus.L.H must also exist, and vice versa.  In
           addition, the two variables always have the same value.

           The ifInvStackStatus object is read-only, as it describes
           a cross-connect capability."
        REFERENCE
           "ifCapStackStatus"
        ::= { ifInvCapStackEntry 1 }

     --
     -- Conformance Statements
     --

      ifCapStackGroups      OBJECT IDENTIFIER ::=
           { ifCapStackConformance 1 }

      ifCapStackCompliances OBJECT IDENTIFIER ::=
           { ifCapStackConformance 2 }

      -- Units of Conformance

      ifCapStackGroup OBJECT-GROUP
        OBJECTS {



Beili                    Expires August 22, 2007               [Page 19]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          ifCapStackStatus,
          ifInvCapStackStatus
        }
        STATUS  current
        DESCRIPTION
          "A collection of objects providing information on the
          cross-connect capability of multi-layer (stacked) network
          interfaces."
        ::= { ifCapStackGroups 1 }


     -- Compliance Statements

      ifCapStackCompliance MODULE-COMPLIANCE
        STATUS      current
        DESCRIPTION
          "The compliance statement for SNMP entities, which provide
          information on the cross-connect capability of multi-layer
          (stacked) network interfaces, with flexible cross-connect
          between the sub-layers.
          Compliance with the following external compliance statements
          is REQUIRED:

          MIB Module             Compliance Statement
          ----------             --------------------
          IF-MIB                 ifCompliance3
          IF-INVERTED-STACK-MIB  ifInvCompliance"


        MODULE  -- this module
          MANDATORY-GROUPS {
            ifCapStackGroup
          }

          OBJECT       ifCapStackStatus
          SYNTAX       TruthValue { true(1) }
          DESCRIPTION
            "Support for the false(2) value is OPTIONAL for
            implementations supporting pluggable interfaces."

          OBJECT       ifInvCapStackStatus
          SYNTAX       TruthValue { true(1) }
          DESCRIPTION
            "Support for the false(2) value is OPTIONAL for
            implementations supporting pluggable interfaces."

        MODULE  IF-MIB
          MANDATORY-GROUPS {



Beili                    Expires August 22, 2007               [Page 20]

Internet-Draft            EFMCu Interfaces MIB             February 2007


            ifStackGroup2
          }

        MODULE  IF-INVERTED-STACK-MIB
          MANDATORY-GROUPS {
            ifInvStackGroup
          }

        ::= { ifCapStackCompliances 1 }
   END





6.  EFM Copper MIB Definitions


   EFM-CU-MIB DEFINITIONS ::= BEGIN

     IMPORTS
       MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, Integer32,
       Unsigned32, Counter32, mib-2
         FROM SNMPv2-SMI         -- RFC 2578
       TEXTUAL-CONVENTION, TruthValue, RowStatus, PhysAddress
         FROM SNMPv2-TC          -- RFC 2579
       MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
         FROM SNMPv2-CONF        -- RFC 2580
       SnmpAdminString
         FROM SNMP-FRAMEWORK-MIB -- RFC 3411
       ifIndex, ifSpeed
         FROM IF-MIB             -- RFC 2863
       ;

     efmCuMIB MODULE-IDENTITY
       LAST-UPDATED "200702180000Z"  -- February 18, 2007
       ORGANIZATION "IETF Ethernet Interfaces and Hub MIB Working Group"
       CONTACT-INFO
         "WG charter:
           http://www.ietf.org/html.charters/hubmib-charter.html

         Mailing Lists:
           General Discussion: hubmib <at> ietf.org
           To Subscribe: hubmib-request <at> ietf.org
           In Body: subscribe your_email_address

         Chair:  Bert Wijnen
         Postal: Alcatel-Lucent



Beili                    Expires August 22, 2007               [Page 21]

Internet-Draft            EFMCu Interfaces MIB             February 2007


                 Schagen 33
                 3461 GL Linschoten
                 Netherlands
            Tel: +31-348-407-775
         E-mail: bwijnen <at> alcatel-lucent.com

         Editor: Edward Beili
         Postal: Actelis Networks Inc.
                 25 Bazel St., P.O.B. 10173
                 Petach-Tikva 10173
                 Israel
                 Tel: +972-3-924-3491
         E-mail: edward.beili <at> actelis.com"

       DESCRIPTION
         "The objects in this MIB module are used to manage
         the Ethernet in the First Mile (EFM) Copper (EFMCu) Interfaces
         2BASE-TL and 10PASS-TS, defined in IEEE Std. 802.3ah-2004,
         which is now a part of IEEE Std. 802.3-2005.

         The following references are used throughout this MIB module:

         [802.3ah] refers to:
           IEEE Std 802.3ah-2004: 'IEEE Standard for Information
           technology - Telecommunications and information exchange
           between systems - Local and metropolitan area networks -
           Specific requirements -
           Part 3: Carrier Sense Multiple Access with Collision
           Detection (CSMA/CD) Access Method and Physical Layer
           Specifications -
           Amendment: Media Access Control Parameters, Physical
           Layers and Management Parameters for Subscriber Access
           Networks', 07 September 2004.

         Of particular interest are Clause 61, 'Physical Coding
         Sublayer (PCS) and common specifications, type 10PASS-TS and
         type 2BASE-TL', Clause 30, 'Management', Clause 45,
         'Management Data Input/Output (MDIO) Interface', Annex 62A,
         'PMD profiles for 10PASS-TS' and Annex 63A, 'PMD profiles for
         2BASE-TL'.

         [G.991.2] refers to:
           ITU-T Recommendation G.991.2: 'Single-pair High-speed Digital
           Subscriber Line (SHDSL) transceivers', December 2003.

         [ANFP] refers to:
           NICC Document ND1602:2005/08: 'Specification of the Access
           Network Frequency Plan (ANFP) applicable to transmission



Beili                    Expires August 22, 2007               [Page 22]

Internet-Draft            EFMCu Interfaces MIB             February 2007


           systems used on the BT Access Network,' August 2005.

         Naming Conventions:
           Atn   - Attenuation
           CO    - Central Office
           CPE   - Customer Premises Equipment
           EFM   - Ethernet in the First Mile
           EFMCu - EFM Copper
           MDIO  - Management Data Input/Output
           Mgn   - Margin
           PAF   - PME Aggregation Function
           PBO   - Power Back-Off
           PCS   - Physical Coding Sublayer
           PMD   - Physical Medium Dependent
           PME   - Physical Medium Entity
           PSD   - Power Spectral Density
           SNR   - Signal to Noise Ratio
           TCPAM - Trellis Coded Pulse Amplitude Modulation

         Copyright (C) The IETF Trust (2007).  This version
         of this MIB module is part of RFC XXXX;  see the RFC
         itself for full legal notices."

       REVISION    "200702180000Z"  -- February 18, 2007
       DESCRIPTION "Initial version, published as RFC XXXX."

         -- EdNote: Replace XXXX with the actual RFC number &
         -- remove this note

       ::= { mib-2 YYY }

         -- EdNote: Replace YYY with a real OID once it is
         -- allocated & remove this note.

      -- Sections of the module

      efmCuObjects     OBJECT IDENTIFIER ::= { efmCuMIB 1 }

      efmCuConformance OBJECT IDENTIFIER ::= { efmCuMIB 2 }

      -- Groups in the module

      efmCuPort        OBJECT IDENTIFIER ::= { efmCuObjects 1 }

      efmCuPme         OBJECT IDENTIFIER ::= { efmCuObjects 2 }

      -- Textual Conventions




Beili                    Expires August 22, 2007               [Page 23]

Internet-Draft            EFMCu Interfaces MIB             February 2007


      EfmProfileIndex ::= TEXTUAL-CONVENTION
        DISPLAY-HINT "d"
        STATUS       current
        DESCRIPTION
          "A unique value, greater than zero, for each PME configuration
          profile in the managed EFMCu port. It is RECOMMENDED that
          values are assigned contiguously starting from 1. The value
          for each profile MUST remain constant at least from one
          re-initialization of the entity's network management system
          to the next re-initialization."
        SYNTAX       Unsigned32 (1..255)

      EfmProfileIndexOrZero ::= TEXTUAL-CONVENTION
        DISPLAY-HINT "d"
        STATUS       current
        DESCRIPTION
          "This textual convention is an extension of EfmProfileIndex
          convention. The latter defines a greater than zero value used
          to identify a PME profile in the managed EFMCu port. This
          extension permits the additional value of zero. The value of
          zero is object-specific and MUST therefore be defined as part
          of the description of any object which uses this syntax.
          Examples of the usage of zero value might include situations
          where current operational profile is unknown."
        SYNTAX       Unsigned32 (0..255)

      EfmProfileIndexList ::= TEXTUAL-CONVENTION
        DISPLAY-HINT "1d:"
        STATUS       current
        DESCRIPTION
          "Represents a list of up to 6 EfmProfileIndex's.
          The EfmProfileIndex textual convention defines a greater than
          zero value used to identify a PME profile in the managed EFMCu
          port. The value of this object is a concatenation of one or
          more (up to 6) octets, where each octet contains an 8-bit
          EfmProfileIndex value.
          The EfmProfileIndexList specifies a list of alternative
          profiles, any of which can be chosen for configuration of an
          PME."
        SYNTAX       OCTET STRING (SIZE(1..6))

      EfmTruthValueOrUnknown ::= TEXTUAL-CONVENTION
        STATUS       current
        DESCRIPTION
          "This textual convention is an extension of the TruthValue
          convention. The latter defines a boolean value with
          possible values of true(1) and false(2). This
          extension permits the additional value of unknown(0), which



Beili                    Expires August 22, 2007               [Page 24]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          can be returned as a result of GET operation, when an exact
          true or false value of the object cannot be determined."
        SYNTAX       INTEGER { unknown(0), true(1), false(2) }

     -- Port Notifications Group

      efmCuPortNotifications OBJECT IDENTIFIER ::= { efmCuPort 0 }

      efmCuLowRateCrossing NOTIFICATION-TYPE
        OBJECTS {
          -- ifIndex is not needed here since we are under specific PCS
          ifSpeed,
          efmCuThreshLowRate
        }
        STATUS      current
        DESCRIPTION
          "This notification indicates that the EFMCu port' data rate
          has reached/dropped below or exceeded the low rate threshold,
          specified by efmCuThreshLowRate.

          This notification MAY be send for the -O subtype ports
          (2BaseTL-O/10PassTS-O) while the port is up, on the crossing
          event in both directions: from normal (rate is above the
          threshold) to low (rate equals the threshold or below it) and
          from low to normal. This notification is not applicable to
          the -R subtypes.

          It is RECOMMENDED that a small debouncing period of 2.5 sec,
          between the detection of the condition and notification,
          is implemented to prevent simultaneous LinkUp/LinkDown and
          efmCuLowRateCrossing notifications to be sent.

          The adaptive nature of the EFMCu technology allows the port to
          adapt itself to the changes in the copper environment, e.g.
          an impulse noise, alien crosstalk or a micro-interruption may
          temporarily drop one or more PMEs in the aggregation group,
          causing a rate degradation of the aggregated EFMCu link.
          The dropped PMEs would then try to re-initialize, possibly at
          a lower rate than before, adjusting the rate to provide
          required target SNR margin.

          Generation of this notification is controlled by the
          efmCuLowRateCrossingEnable object."
        ::= { efmCuPortNotifications 1 }

      -- PCS Port group

      efmCuPortConfTable OBJECT-TYPE



Beili                    Expires August 22, 2007               [Page 25]

Internet-Draft            EFMCu Interfaces MIB             February 2007


        SYNTAX      SEQUENCE OF EfmCuPortConfEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "Table for Configuration of EFMCu 2BASE-TL/10PASS-TS (PCS)
          Ports. Entries in this table MUST be maintained in a
          persistent manner"
        ::= { efmCuPort 1 }

      efmCuPortConfEntry OBJECT-TYPE
        SYNTAX      EfmCuPortConfEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "An entry in the EFMCu Port Configuration table.
          Each entry represents an EFMCu port indexed by the ifIndex.
          Note that an EFMCu PCS port runs on top of a single
          or multiple PME port(s), which are also indexed by ifIndex."
        INDEX  { ifIndex }
        ::= { efmCuPortConfTable 1 }

      EfmCuPortConfEntry ::=
        SEQUENCE {
          efmCuPAFAdminState               INTEGER,
          efmCuPAFDiscoveryCode            PhysAddress,
          efmCuAdminProfile                EfmProfileIndexList,
          efmCuTargetDataRate              Unsigned32,
          efmCuTargetSnrMgn                Unsigned32,
          efmCuAdaptiveSpectra             TruthValue,
          efmCuThreshLowRate               Unsigned32,
          efmCuLowRateCrossingEnable       TruthValue
        }

      efmCuPAFAdminState  OBJECT-TYPE
        SYNTAX      INTEGER {
          enabled(1),
          disabled(2)
        }
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
          "Administrative (desired) state of the PAF of the EFMCu port
          (PCS).
          When 'disabled', PME Aggregation will not be performed by the
          PCS. No more than a single PME can be assigned to this PCS in
          this case.
          When 'enabled', PAF will be performed by the PCS when the link
          is Up, even on a single attached PME, if PAF is supported.



Beili                    Expires August 22, 2007               [Page 26]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          PCS ports incapable of supporting PAF SHALL return a value of
          'disabled'. Attempts to 'enable' such ports SHALL be rejected.

          PAF 'enabled' port with multiple PMEs assigned cannot be
          'disabled'. Attempts to 'disable' such port SHALL be rejected,
          until at most one PME is left assigned.

          Changing PAFAdminState is a traffic disruptive operation and
          as such SHALL be done when the link is Down. Attempts to
          change this object SHALL be rejected if the link is Up or
          Initializing.

          This object maps to the Clause 30 attribute aPAFAdminState.

          If a Clause 45 MDIO Interface to the PCS is present, then this
          object maps to the PAF enable bit in the 10P/2B PCS control
          register.

          This object MUST be maintained in a persistent manner."
        REFERENCE
          "[802.3ah] 61.2.2, 45.2.3.18.3"
        ::= { efmCuPortConfEntry 1 }

      efmCuPAFDiscoveryCode  OBJECT-TYPE
        SYNTAX      PhysAddress (SIZE(6))
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
          "PAF Discovery Code of the EFMCu port (PCS).
          A unique 6 octet long code used by the Discovery function,
          when PAF is supported.
          PCS ports incapable of supporting PAF SHALL return a value of
          all zeroes. Attempts to change this object SHALL be rejected
          in this case.
          This object MUST be instantiated for the -O subtype PCS before
          writing operations on the efmCuPAFRemoteDiscoveryCode
          (Set_if_Clear and Clear_if_Same) are performed by PMEs
          associated with the PCS.
          The initial value of this object for -R subtype ports after
          reset is all zeroes. For -R subtype ports, the value of this
          object cannot be changed directly. This value may be changed
          as a result of writing operation on the
          efmCuPAFRemoteDiscoveryCode object of remote PME of -O
          subtype, connected to one of the local PMEs associated with
          the PCS.

          Discovery MUST be performed when the link is Down.
          Attempts to change this object MUST be rejected (in case of



Beili                    Expires August 22, 2007               [Page 27]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          SNMP with the error inconsistentValue), if the link is Up or
          Initializing.

          The PAF Discovery code maps to the local Discovery code
          variable in PAF (note that it does not have a corresponding
          Clause 45 register)"
        REFERENCE
          "[802.3ah] 61.2.2.8.3, 61.2.2.8.4, 45.2.6.6.1"
        ::= { efmCuPortConfEntry 2 }

      efmCuAdminProfile  OBJECT-TYPE
        SYNTAX      EfmProfileIndexList
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
          "Desired configuration Profile(s), common for all PMEs in the
          EFMCu port. This object is a list of pointers to entries in
          either efmCuPme2BProfileTable or
          efmCuPme10PProfileTable, depending on the current
          operating SubType of the EFMCu port as indicated by
          efmCuPortSide.
          The value of this object is a list of up to 6 indices of
          Profiles. If this list consists of a single Profile index,
          then all PMEs assigned to this EFMCu port SHALL be configured
          according to the Profile referenced by that index, unless it
          is overwritten by corresponding non-zero efmCuPmeAdminProfile,
          which takes precedence over efmCuAdminProfile.
          The list, consisting of more than one index, allows each PME
          in the port to be configured according to any Profile
          specified in the list.
          By default this object has a value of 0x01, referencing 1st
          entry in efmCuPme2BProfileTable or efmCuPme10PProfileTable.

          This object is writable and readable for the -O subtype
          (2BaseTL-O or 10PassTS-O) EFMCu ports. It is unsupported for
          the -R  subtype (2BaseTL-R or 10PassTS-R) ports.

          Note that current operational Profile value is available via
          efmCuPmeOperProfile object.

          Modification of this object MUST be performed when the link is
          Down. Attempts to change this object MUST be rejected, if the
          link is Up or Initializing.
          Attempts to set this object to a list with a member
          value, that is not the value of the index for an active entry
          in the corresponding profile table, MUST be rejected.

          This object MUST be maintained in a persistent manner."



Beili                    Expires August 22, 2007               [Page 28]

Internet-Draft            EFMCu Interfaces MIB             February 2007


        REFERENCE
          "[802.3ah] 30.11.2.1.6"
        DEFVAL { '01'H }
        ::= { efmCuPortConfEntry 3 }

      efmCuTargetDataRate  OBJECT-TYPE
        SYNTAX      Unsigned32(1..100000|999999)
        UNITS       "Kbps"
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
          "Desired EFMCu port 'net' (as seen across MII) Data Rate in
          Kbps, to be achieved during initialization, under spectral
          restrictions placed on each PME via efmCuAdminProfile or
          efmCuPmeAdminProfile, with the desired SNR Margin specified by
          efmCuTargetSnrMgn.
          In case of PAF, this object represents a sum of individual PME
          data rates, modified to compensate for fragmentation and
          64/65B framing overhead (e.g. target data rate of 10Mbps
          SHALL allow lossless transmission of full-duplex 10Mbps
          Ethernet frame stream with minimal inter-frame gap).

          The value is limited above by 100Mbps as this is the max
          burst rate across MII for EFMCu ports.

          The value between 1 and 100000 indicates that the total data
          rate (ifSpeed) of the EFMCu port after initialization SHALL
          be equal to the target data rate or less, if the target data
          rate cannot be achieved under spectral restrictions specified
          by efmCuAdminProfile/efmCuPmeAdminProfile and with desired SNR
          margin. In case the copper environment allows to achieve
          higher total data rate than that specified by the target, the
          excess capability SHALL be either converted to additional SNR
          margin or reclaimed by minimizing transmit power as controlled
          by efmCuAdaptiveSpectra.

          The value of 999999 means that the target data rate is not
          fixed and SHALL be set to the maximum attainable rate during
          initialization (Best Effort), under specified spectral
          restrictions and with desired SNR Margin.

          This object is read-write for the -O subtype EFMCu ports
          (2BaseTL-O/10PassTS-O) and not available for the -R subtypes.

          Changing of the Target Data Rate MUST be performed when the
          link is Down. Attempts to change this object MUST be rejected
          (in case of SNMP with the error inconsistentValue), if the
          link is Up or Initializing.



Beili                    Expires August 22, 2007               [Page 29]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          Note that current Data Rate of the EFMCu port is represented
          by ifSpeed object of IF-MIB.

          This object MUST be maintained in a persistent manner."
        ::= { efmCuPortConfEntry 4 }

      efmCuTargetSnrMgn  OBJECT-TYPE
        SYNTAX      Unsigned32(0..21)
        UNITS       "dB"
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
          "Desired EFMCu port SNR Margin to be achieved on all PMEs
          assigned to the port, during initializiation. (The SNR margin
          is the difference between the desired SNR and the actual SNR).

          Note that 802.3ah recommends using default Target SNR Margin
          of 5dB for 2BASE-TL ports and 6dB for 10PASS-TS ports in order
          to achieve mean Bit Error Rate (BER) of 10^-7 at the PMA
          service interface.

          This object is read-write for the -O subtype EFMCu ports
          (2BaseTL-O/10PassTS-O) and not available for the -R subtypes.

          Changing of the Target SNR Margin MUST be performed when the
          link is Down. Attempts to change this object MUST be rejected
          (in case of SNMP with the error inconsistentValue), if the
          link is Up or Initializing.

          Note that current SNR Margin of the PMEs comprising the EFMCu
          port is represented by efmCuPmeSnrMgn.

          This object MUST be maintained in a persistent manner."
        REFERENCE
          "[802.3ah] 61.1.2"
        ::= { efmCuPortConfEntry 5 }

      efmCuAdaptiveSpectra  OBJECT-TYPE
        SYNTAX      TruthValue
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
          "Indicates how to utilize excess capacity when the copper
          environment allows to achieve higher total data rate than that
          specified by the efmCuTargetDataRate.

          Value of true(1) indicates that the excess capability SHALL be
          reclaimed by minimizing transmit power, e.g. using higher



Beili                    Expires August 22, 2007               [Page 30]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          constellations and Power Back-Off, in order to reduce
          interference to other copper pairs in the binder and the
          adverse impact to link/system performance.

          Value of false(2) indicates that the excess capability SHALL
          be converted to additional SNR margin and spread evenly across
          all active PMEs assigned to the (PCS) port, to increase link
          robustness.

          This object is read-write for the -O subtype EFMCu ports
          (2BaseTL-O/10PassTS-O) and not available for the -R subtypes.

          Changing of this object MUST be performed when the link is
          Down. Attempts to change this object MUST be rejected (in case
          of SNMP with the error inconsistentValue), if the link is Up
          or Initializing.

          This object MUST be maintained in a persistent manner."
        ::= { efmCuPortConfEntry 6 }

      efmCuThreshLowRate  OBJECT-TYPE
        SYNTAX      Unsigned32(1..100000)
        UNITS       "Kbps"
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
          "This object configures the EFMCu port low rate crossing alarm
          threshold. When the current value of ifSpeed for this port
          reaches/drops below or exceeds this threshold, an
          efmCuLowRateCrossing notification MAY be generated if enabled
          by efmCuLowRateCrossingEnable.

          This object is read-write for the -O subtype EFMCu ports
          (2BaseTL-O/10PassTS-O) and not available for the -R subtypes.

          This object MUST be maintained in a persistent manner."
        ::= { efmCuPortConfEntry 7 }

      efmCuLowRateCrossingEnable  OBJECT-TYPE
        SYNTAX      TruthValue
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
          "Indicates whether efmCuLowRateCrossing notifications should
          be generated for this interface.

          Value of true(1) indicates that efmCuLowRateCrossing
          notification is enabled. Value of false(2) indicates that



Beili                    Expires August 22, 2007               [Page 31]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          the notification is disabled.

          This object is read-write for the -O subtype EFMCu ports
          (2BaseTL-O/10PassTS-O) and not available for the -R subtypes.

          This object MUST be maintained in a persistent manner."
        ::= { efmCuPortConfEntry 8 }


      efmCuPortCapabilityTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF EfmCuPortCapabilityEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "Table for Capabilities of EFMCu 2BASE-TL/10PASS-TS (PCS)
          Ports. Entries in this table MUST be maintained in a
          persistent manner"
        ::= { efmCuPort 2 }

      efmCuPortCapabilityEntry OBJECT-TYPE
        SYNTAX      EfmCuPortCapabilityEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "An entry in the EFMCu Port Capability table.
          Each entry represents an EFMCu port indexed by the ifIndex.
          Note that an EFMCu PCS port runs on top of a single
          or multiple PME port(s), which are also indexed by ifIndex."
        INDEX  { ifIndex }
        ::= { efmCuPortCapabilityTable 1 }

      EfmCuPortCapabilityEntry ::=
        SEQUENCE {
          efmCuPAFSupported                TruthValue,
          efmCuPeerPAFSupported            EfmTruthValueOrUnknown,
          efmCuPAFCapacity                 Unsigned32,
          efmCuPeerPAFCapacity             Unsigned32
        }

      efmCuPAFSupported  OBJECT-TYPE
        SYNTAX      TruthValue
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "PME Aggregation Function (PAF) Capability of the EFMCu port
          (PCS).
          This object has a value of true(1) when the PCS can perform
          PME aggregation on the available PMEs.



Beili                    Expires August 22, 2007               [Page 32]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          Ports incapable of PAF SHALL return a value of false(2).

          This object maps to the Clause 30 attribute aPAFSupported.

          If a Clause 45 MDIO Interface to the PCS is present,
          then this object maps to the PAF available bit in the
          10P/2B capability register."
        REFERENCE
          "[802.3ah] 61.2.2, 30.11.1.1.4, 45.2.3.17.1"
        ::= { efmCuPortCapabilityEntry 1 }

      efmCuPeerPAFSupported  OBJECT-TYPE
        SYNTAX      EfmTruthValueOrUnknown
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "PME Aggregation Function (PAF) Capability of the EFMCu port
          (PCS) link partner.
          This object has a value of true(1) when the remote PCS can
          perform PME aggregation on its available PMEs.
          Ports whose peers are incapable of PAF, SHALL return a value
          of false(2).
          Ports whose peers cannot be reached because of the link
          state, SHALL return a value if unknown(0).

          This object maps to the Clause 30 attribute
          aRemotePAFSupported.

          If a Clause 45 MDIO Interface to the PCS is present, then
          this object maps to the Remote PAF supported bit in the
          10P/2B capability register."
        REFERENCE
          "[802.3ah] 61.2.2, 30.11.1.1.9, 45.2.3.17.2"
        ::= { efmCuPortCapabilityEntry 2 }

      efmCuPAFCapacity  OBJECT-TYPE
        SYNTAX      Unsigned32 (1..32)
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "Number of PMEs that can be aggregated by the local PAF.
          The number of PMEs currently assigned to a particular
          EFMCu port (efmCuNumPMEs) is never greater than
          efmCuPAFCapacity.

          This object maps to the Clause 30 attribute
          aLocalPAFCapacity."
        REFERENCE



Beili                    Expires August 22, 2007               [Page 33]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          "[802.3ah] 61.2.2, 30.11.1.1.6"
        ::= { efmCuPortCapabilityEntry 3 }

      efmCuPeerPAFCapacity  OBJECT-TYPE
        SYNTAX      Unsigned32 (0|1..32)
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "Number of PMEs that can be aggregated by the PAF of the peer
          Phy (PCS port).
          Value of 0 is returned when peer PAF Capacity is unknown
          (peer cannot be reached).

          This object maps to the Clause 30 attribute
          aRemotePAFCapacity."
        REFERENCE
          "[802.3ah] 61.2.2, 30.11.1.1.10"
        ::= { efmCuPortCapabilityEntry 4 }


      efmCuPortStatusTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF EfmCuPortStatusEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "This table provides overall status information of EFMCu
          2BASE-TL/10PASS-TS ports, complementing the generic status
          information from the ifTable of IF-MIB and ifMauTable of
          MAU-MIB. Additional status information about connected PMEs
          is available from efmCuPmeStatusTable.

          This table contains live data from the equipment. As such,
          it is NOT persistent."
        ::= { efmCuPort 3 }

      efmCuPortStatusEntry OBJECT-TYPE
        SYNTAX      EfmCuPortStatusEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "An entry in the EFMCu Port Status table.
          Each entry represents an EFMCu port indexed by the ifIndex.
          Note that an EFMCu PCS port runs on top of a single
          or multiple PME port(s), which are also indexed by ifIndex."
        INDEX  { ifIndex }
        ::= { efmCuPortStatusTable 1 }

      EfmCuPortStatusEntry ::=



Beili                    Expires August 22, 2007               [Page 34]

Internet-Draft            EFMCu Interfaces MIB             February 2007


        SEQUENCE {
          efmCuFltStatus                   BITS,
          efmCuPortSide                    INTEGER,
          efmCuNumPMEs                     Unsigned32,
          efmCuPAFInErrors                 Counter32,
          efmCuPAFInSmallFragments         Counter32,
          efmCuPAFInLargeFragments         Counter32,
          efmCuPAFInBadFragments           Counter32,
          efmCuPAFInLostFragments          Counter32,
          efmCuPAFInLostStarts             Counter32,
          efmCuPAFInLostEnds               Counter32,
          efmCuPAFInOverflows              Counter32
        }

      efmCuFltStatus  OBJECT-TYPE
        SYNTAX      BITS {
          noPeer(0),
          peerPowerLoss(1),
          pmeSubTypeMismatch(2),
          lowRate(3)
        }
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "EFMCu (PCS) port Fault Status. This is a bitmap of possible
          conditions. The various bit positions are:
            noPeer              - peer PHY cannot be reached (e.g.
                                  no PMEs attached, all PMEs are Down
                                  etc.) More info is available in
                                  efmCuPmeFltStatus.
            peerPowerLoss       - peer PHY has indicated impending unit
                                  failure due to loss of local power
                                  ('Dying Gasp').
            pmeSubTypeMismatch  - local PMEs in the aggregation group
                                  are not of the same sub-type, e.g.
                                  some PMEs in the local device are -O
                                  while others are -R subtype.
            lowRate             - ifSpeed of the port reached or dropped
                                  below efmCuThreshLowRate

          This object is intended to supplement ifOperStatus object
          in IF-MIB and ifMauMediaAvailable in MAU-MIB.

          Additional information is available via efmCuPmeFltStatus
          object for each PME in the aggregation group (single PME if
          PAF is disabled)."
        REFERENCE
          "IF-MIB, ifOperStatus; MAU-MIB, ifMauMediaAvailable;



Beili                    Expires August 22, 2007               [Page 35]

Internet-Draft            EFMCu Interfaces MIB             February 2007


           efmCuPmeFltStatus"
        ::= { efmCuPortStatusEntry 1 }

      efmCuPortSide  OBJECT-TYPE
        SYNTAX      INTEGER {
          subscriber(1),
          office(2),
          unknown(3)
        }
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "EFM port mode of operation (subtype).
          The value of 'subscriber' indicates the port is designated as
          '-R' subtype (all PMEs assigned to this port are of subtype
          '-R').
          The value of the 'office' indicates that the port is
          designated as '-O' subtype (all PMEs assigned to this port are
          of subtype '-O').
          The value of 'unknown' indicates that the port has no assigned
          PMEs yet or that the assigned PMEs are not of the same side
          (subTypePMEMismatch).

          This object partially maps to the Clause 30 attribute
          aPhyEnd"
        REFERENCE
           "[802.3ah] 61.1, 30.11.1.1.2"
        ::= { efmCuPortStatusEntry 2 }

      efmCuNumPMEs  OBJECT-TYPE
        SYNTAX      Unsigned32 (0..32)
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "Number of PMEs that is currently aggregated by the local PAF
          (assigned to the EFMCu port using ifStackTable).
          This number is never greater than efmCuPAFCapacity.

          This object SHALL be automatically incremented or decremented
          when a PME is added or deleted to/from the EFMCu port using
          ifStackTable."
        REFERENCE
          "[802.3ah] 61.2.2, 30.11.1.1.6"
        ::= { efmCuPortStatusEntry 3 }

      efmCuPAFInErrors OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only



Beili                    Expires August 22, 2007               [Page 36]

Internet-Draft            EFMCu Interfaces MIB             February 2007


        STATUS      current
        DESCRIPTION
          "A number of fragments that have been received across the
          gamma interface with RxErr asserted and discarded.
          This read-only counter is inactive (not incremented) when the
          PAF is unsupported or disabled. Upon disabling the PAF, the
          counter retains its previous value.

          If a Clause 45 MDIO Interface to the PCS is present, then
          this object maps to the 10P/2B PAF RX error register.

          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other times
          as indicated by the value of ifCounterDiscontinuityTime,
          defined in IF-MIB."
        REFERENCE
          "[802.3ah] 45.2.3.21"
        ::= { efmCuPortStatusEntry 4 }

      efmCuPAFInSmallFragments OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "A number of fragments smaller than minFragmentSize
          (64 Bytes), which have been received across the gamma
          interface and discarded.
          This read-only counter is inactive when the PAF is
          unsupported or disabled. Upon disabling the PAF, the counter
          retains its previous value.

          If a Clause 45 MDIO Interface to the PCS is present, then
          this object maps to the 10P/2B PAF small fragments
          register.

          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other times
          as indicated by the value of ifCounterDiscontinuityTime,
          defined in IF-MIB."
        REFERENCE
          "[802.3ah] 45.2.3.22"
        ::= { efmCuPortStatusEntry 5 }

      efmCuPAFInLargeFragments OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION



Beili                    Expires August 22, 2007               [Page 37]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          "A number of fragments larger than maxFragmentSize
          (512 Bytes), which have been received across the gamma
          interface and discarded.
          This read-only counter is inactive when the PAF is
          unsupported or disabled. Upon disabling the PAF, the counter
          retains its previous value.

          If a Clause 45 MDIO Interface to the PCS is present, then
          this object maps to the 10P/2B PAF large fragments
          register.

          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other times
          as indicated by the value of ifCounterDiscontinuityTime,
          defined in IF-MIB."
        REFERENCE
          "[802.3ah] 45.2.3.23"
        ::= { efmCuPortStatusEntry 6 }

      efmCuPAFInBadFragments OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "A number of fragments which do not fit into the sequence
          expected by the frame assembly function, that have been
          received across the gamma interface and discarded (the
          frame buffer is flushed to the next valid frame start).
          This read-only counter is inactive when the PAF is
          unsupported or disabled. Upon disabling the PAF, the counter
          retains its previous value.

          If a Clause 45 MDIO Interface to the PCS is present, then
          this object maps to the 10P/2B PAF bad fragments
          register.

          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other times
          as indicated by the value of ifCounterDiscontinuityTime,
          defined in IF-MIB."
        REFERENCE
          "[802.3ah] 45.2.3.25"
        ::= { efmCuPortStatusEntry 7 }

      efmCuPAFInLostFragments OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current



Beili                    Expires August 22, 2007               [Page 38]

Internet-Draft            EFMCu Interfaces MIB             February 2007


        DESCRIPTION
          "A number of gaps in the sequence of fragments, which have
          been received across the gamma interface (the frame buffer is
          flushed to the next valid frame start, when fragment/fragments
          expected by the frame assembly function is/are not received).
          This read-only counter is inactive when the PAF is
          unsupported or disabled. Upon disabling the PAF, the counter
          retains its previous value.

          If a Clause 45 MDIO Interface to the PCS is present, then
          this object maps to the 10P/2B PAF lost fragment
          register.

          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other times
          as indicated by the value of ifCounterDiscontinuityTime,
          defined in IF-MIB."
        REFERENCE
          "[802.3ah] 45.2.3.26"
        ::= { efmCuPortStatusEntry 8 }

      efmCuPAFInLostStarts OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "A number of missing StartOfPacket indicators expected by the
          frame assembly function.
          This read-only counter is inactive when the PAF is
          unsupported or disabled. Upon disabling the PAF, the counter
          retains its previous value.

          If a Clause 45 MDIO Interface to the PCS is present, then
          this object maps to the 10P/2B PAF lost start of fragment
          register.

          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other times
          as indicated by the value of ifCounterDiscontinuityTime,
          defined in IF-MIB."
        REFERENCE
          "[802.3ah] 45.2.3.27"
        ::= { efmCuPortStatusEntry 9 }

      efmCuPAFInLostEnds OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current



Beili                    Expires August 22, 2007               [Page 39]

Internet-Draft            EFMCu Interfaces MIB             February 2007


        DESCRIPTION
          "A number of missing EndOfPacket indicators expected by the
          frame assembly function.
          This read-only counter is inactive when the PAF is
          unsupported or disabled. Upon disabling the PAF, the counter
          retains its previous value.

          If a Clause 45 MDIO Interface to the PCS is present, then
          this object maps to the 10P/2B PAF lost start of fragment
          register.

          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other times
          as indicated by the value of ifCounterDiscontinuityTime,
          defined in IF-MIB."
        REFERENCE
          "[802.3ah] 45.2.3.28"
        ::= { efmCuPortStatusEntry 10 }

      efmCuPAFInOverflows OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "A number of fragments, received across the gamma interface
          and discarded, which would have caused the frame assembly
          buffer to overflow.
          This read-only counter is inactive when the PAF is
          unsupported or disabled. Upon disabling the PAF, the counter
          retains its previous value.

          If a Clause 45 MDIO Interface to the PCS is present, then
          this object maps to the 10P/2B PAF overflow register.

          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other times
          as indicated by the value of ifCounterDiscontinuityTime,
          defined in IF-MIB."
        REFERENCE
          "[802.3ah] 45.2.3.24"
        ::= { efmCuPortStatusEntry 11 }

     -- PME Notifications Group

      efmCuPmeNotifications OBJECT IDENTIFIER ::= { efmCuPme 0 }

      efmCuPmeLineAtnCrossing NOTIFICATION-TYPE
        OBJECTS {



Beili                    Expires August 22, 2007               [Page 40]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          efmCuPmeLineAtn,
          efmCuPmeThreshLineAtn
        }
        STATUS      current
        DESCRIPTION
          "This notification indicates that the loop attenuation
          threshold (as per the efmCuPmeThreshLineAtn
          value) has been reached/exceeded for the 2BASE-TL/10PASS-TS
          PME. This notification MAY be send on the crossing event in
          both directions: from normal to exceeded and from exceeded
          to normal.

          It is RECOMMENDED that a small debouncing period of 2.5 sec,
          between the detection of the condition and notification,
          is implemented to prevent intermittent notifications to be
          sent.

          Generation of this notification is controlled by the
          efmCuPmeLineAtnCrossingEnable object."
        ::= { efmCuPmeNotifications 1 }

      efmCuPmeSnrMgnCrossing NOTIFICATION-TYPE
        OBJECTS {
          efmCuPmeSnrMgn,
          efmCuPmeThreshSnrMgn
        }
        STATUS      current
        DESCRIPTION
          "This notification indicates that the SNR margin threshold
          (as per the efmCuPmeThreshSnrMgn value) has been
          reached/exceeded for the 2BASE-TL/10PASS-TS PME.
          This notification MAY be send on the crossing event in
          both directions: from normal to exceeded and from exceeded
          to normal.

          It is RECOMMENDED that a small debouncing period of 2.5 sec,
          between the detection of the condition and notification,
          is implemented to prevent intermittent notifications to be
          sent.

          Generation of this notification is controlled by the
          efmCuPmeSnrMgnCrossingEnable object."
        ::= { efmCuPmeNotifications 2 }

      efmCuPmeDeviceFault NOTIFICATION-TYPE
        OBJECTS {
          efmCuPmeFltStatus
        }



Beili                    Expires August 22, 2007               [Page 41]

Internet-Draft            EFMCu Interfaces MIB             February 2007


        STATUS      current
        DESCRIPTION
          "This notification indicates that a fault in the PME has been
          detected by a vendor specific diagnostic or a self-test.

          Generation of this notification is controlled by the
          efmCuPmeDeviceFaultEnable object."
        ::= { efmCuPmeNotifications 3 }

      efmCuPmeConfigInitFailure NOTIFICATION-TYPE
        OBJECTS {
          efmCuPmeFltStatus,
          efmCuAdminProfile,
          efmCuPmeAdminProfile
        }
        STATUS      current
        DESCRIPTION
          "This notification indicates that PME initialization has
          failed, due to inability of the PME link to achieve requested
          configuration profile.

          Generation of this notification is controlled by the
          efmCuPmeConfigInitFailEnable object."
        ::= { efmCuPmeNotifications 4 }

      efmCuPmeProtocolInitFailure NOTIFICATION-TYPE
        OBJECTS {
          efmCuPmeFltStatus,
          efmCuPmeOperSubType
        }
        STATUS     current
        DESCRIPTION
          "This notification indicates that peer PME was using
          incompatible protocol during initialization.

          Generation of this notification is controlled by the
          efmCuPmeProtocolInitFailEnable object."
        ::= { efmCuPmeNotifications 5 }

      -- The PME group

      efmCuPmeConfTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF EfmCuPmeConfEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "Table for Configuration of common aspects for EFMCu
          2BASE-TL/10PASS-TS PME ports (modems). Configuration of



Beili                    Expires August 22, 2007               [Page 42]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          aspects specific to 2BASE-TL or 10PASS-TS PME types is
          represented in efmCuPme2BConfTable and efmCuPme10PConfTable
          respectively.

          Entries in this table MUST be maintained in a persistent
          manner."
        ::= { efmCuPme 1 }

      efmCuPmeConfEntry OBJECT-TYPE
        SYNTAX      EfmCuPmeConfEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "An entry in the EFMCu PME Configuration table.
          Each entry represents common aspects of an EFMCu PME port
          indexed by the ifIndex. Note that an EFMCu PME port can be
          stacked below a single PCS port, also indexed by ifIndex,
          possibly together with other PME ports if PAF is enabled."
        INDEX  { ifIndex }
        ::= { efmCuPmeConfTable 1 }

      EfmCuPmeConfEntry ::=
        SEQUENCE {
          efmCuPmeAdminSubType           INTEGER,
          efmCuPmeAdminProfile           EfmProfileIndexOrZero,
          efmCuPAFRemoteDiscoveryCode    PhysAddress,
          efmCuPmeThreshLineAtn          Integer32,
          efmCuPmeThreshSnrMgn           Integer32,
          efmCuPmeLineAtnCrossingEnable  TruthValue,
          efmCuPmeSnrMgnCrossingEnable   TruthValue,
          efmCuPmeDeviceFaultEnable      TruthValue,
          efmCuPmeConfigInitFailEnable   TruthValue,
          efmCuPmeProtocolInitFailEnable TruthValue
        }

      efmCuPmeAdminSubType  OBJECT-TYPE
        SYNTAX      INTEGER {
          ieee2BaseTLO(1),
          ieee2BaseTLR(2),
          ieee10PassTSO(3),
          ieee10PassTSR(4),
          ieee2BaseTLor10PassTSR(5),
          ieee2BaseTLor10PassTSO(6),
          ieee10PassTSor2BaseTLO(7)
        }
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION



Beili                    Expires August 22, 2007               [Page 43]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          "Administrative (desired) sub-type of the PME.
          Possible values are:
            ieee2BaseTLO           - PME SHALL operate as 2BaseTL-O
            ieee2BaseTLR           - PME SHALL operate as 2BaseTL-R
            ieee10PassTSO          - PME SHALL operate as 10PassTS-O
            ieee10PassTSR          - PME SHALL operate as 10PassTS-R
            ieee2BaseTLor10PassTSR - PME SHALL operate as 2BaseTL-R or
                                     10PassTS-R. Actual value will be
                                     set by -O link partner during
                                     initialization (handshake).
            ieee2BaseTLor10PassTSO - PME SHALL operate as 2BaseTL-O
                                     (preferred) or 10PassTS-O. Actual
                                     value will be set during
                                     initialization depending on -R
                                     link partner capability (i.e. if
                                     -R is incapable of the preferred
                                     2BaseTL mode, 10PassTS will be
                                     used).
            ieee10PassTSor2BaseTLO - PME SHALL operate as 10PassTS-O
                                     (preferred) or 2BaseTL-O. Actual
                                     value will be set during
                                     initialization depending on -R
                                     link partner capability (i.e. if
                                     -R is incapable of the preferred
                                     10PassTS mode, 2BaseTL will be
                                     used).

          Changing efmCuPmeAdminSubType is a traffic disruptive
          operation and as such SHALL be done when the link is Down.
          Attempts to change this object SHALL be rejected if the link
          is Up or Initializing.
          Attempts to change this object to an unsupported subtype
          (see efmCuPmeSubTypesSupported) SHALL be rejected.

          The current operational sub type is indicated by
          efmCuPmeOperSubType variable.

          If a Clause 45 MDIO Interface to the PMA/PMD is present, then
          this object combines values of the Port sub-type select bits
          and the PMA/PMD type selection bits in the 10P/2B PMA/PMD
          control register"
        REFERENCE
          "[802.3ah] 61.1, 45.2.1.11.4, 45.2.1.11.7"
        ::= { efmCuPmeConfEntry 1 }

      efmCuPmeAdminProfile  OBJECT-TYPE
        SYNTAX      EfmProfileIndexOrZero
        MAX-ACCESS  read-write



Beili                    Expires August 22, 2007               [Page 44]

Internet-Draft            EFMCu Interfaces MIB             February 2007


        STATUS      current
        DESCRIPTION
          "Desired PME configuration Profile. This object is a pointer
          to an entry in either efmCuPme2BProfileTable or
          efmCuPme10PProfileTable, depending on the current operating
          SubType of the PME. The value of this object is the index of
          the referenced profile.
          The value of zero (default) indicates that the PME is
          configured via efmCuAdminProfile object for the PCS port,
          to which this PME is assigned. That is, the profile referenced
          by efmCuPmeAdminProfile takes precedence over the profile(s)
          referenced by efmCuAdminProfile.

          This object is writable and readable for the CO subtype PMEs
          (2BaseTL-O or 10PassTS-O). It is unsupported for the CPE
          subtype (2BaseTL-R or 10PassTS-R).

          Note that current operational Profile value is available via
          efmCuPmeOperProfile object.

          Modification of this object MUST be performed when the link is
          Down. Attempts to change this object MUST be rejected, if the
          link is Up or Initializing.
          Attempts to set this object to a value that is not the value
          of the index for an active entry in the corresponding profile
          table, MUST be rejected."
        REFERENCE
          "[802.3ah] 30.11.2.1.6"
        DEFVAL { 0 }
        ::= { efmCuPmeConfEntry 2 }

      efmCuPAFRemoteDiscoveryCode  OBJECT-TYPE
        SYNTAX      PhysAddress (SIZE(6))
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
          "PAF Remote Discovery Code of the PME port at CO.
          A 6 octet long Discovery Code of the peer PCS connected via
          the PME.
          Reading this object results in a Discovery Get operation.
          Setting this object to all zeroes results in a Discovery
          Clear_if_Same operation (the value of efmCuPAFDiscoveryCode
          at the peer PCS SHALL be the same as efmCuPAFDiscoveryCode of
          the local PCS associated with the PME for the operation to
          succeed).
          Writing a non-zero value to this object results in a
          Discovery Set_if_Clear operation.
          A zero-length octet string SHALL be returned on an attempt to



Beili                    Expires August 22, 2007               [Page 45]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          read this object when PAF aggregation is not enabled.

          This object is irrelevant in CPE port (-R) subtypes: in this
          case a zero length octet string SHALL be returned on an
          attempt to read this object, writing to this object SHALL
          be ignored.

          Discovery MUST be performed when the link is Down.
          Attempts to change this object MUST be rejected (in case of
          SNMP with the error inconsistentValue), if the link is Up or
          Initializing.

          If a Clause 45 MDIO Interface to the PMA/PMD is present, then
          this object is a function of 10P/2B aggregation discovery
          control register, Discovery operation result bits in 10P/2B
          aggregation and discovery status register and
          10P/2B aggregation discovery code register"
        REFERENCE
          "[802.3ah] 61.2.2.8.4, 45.2.6.6-45.2.6.8"
        ::= { efmCuPmeConfEntry 3 }

      efmCuPmeThreshLineAtn  OBJECT-TYPE
        SYNTAX  Integer32(-127..128)
        UNITS       "dB"
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
          "Desired Line Attenuation Threshold for the 2B/10P PME.
          This object configures the line attenuation alarm threshold.
          When the current value of Line Attenuation reaches or
          exceeds this threshold, a efmCuPmeLineAtnCrossing
          notification MAY be generated, if enabled by
          efmCuPmeLineAtnCrossingEnable.

          This object is writable for the CO subtype PMEs (-O).
          It is read-only for the CPE subtype (-R).

          Changing of the Line Attenuation Threshold MUST be performed
          when the link is Down. Attempts to change this object MUST be
          rejected (in case of SNMP with the error inconsistentValue),
          if the link is Up or Initializing.

          If a Clause 45 MDIO Interface to the PME is present, then this
          object maps to the Loop attenuation threshold bits in
          the 2B PMD line quality thresholds register"
        REFERENCE
          "[802.3ah] 45.2.1.36"
        ::= { efmCuPmeConfEntry 4 }



Beili                    Expires August 22, 2007               [Page 46]

Internet-Draft            EFMCu Interfaces MIB             February 2007


      efmCuPmeThreshSnrMgn  OBJECT-TYPE
        SYNTAX      Integer32(-127..128)
        UNITS       "dB"
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
          "Desired SNR Margin Threshold for the 2B/10P PME.
          This object configures the SNR margin alarm threshold.
          When the current value of SNR Margin reaches or exceeds this
          threshold, a efmCuPmeSnrMgnCrossing notification MAY be
          generated, if enabled by efmCuPmeSnrMgnCrossingEnable.

          This object is writable for the CO subtype PMEs
          (2BaseTL-O/10PassTS-R). It is read-only for the CPE subtype
          (2BaseTL-R/10PassTS-R).

          Changing of the SNR Margin Threshold MUST be performed when
          the link is Down. Attempts to change this object MUST be
          rejected (in case of SNMP with the error inconsistentValue),
          if the link is Up or Initializing.

          If a Clause 45 MDIO Interface to the PME is present, then this
          object maps to the SNR margin threshold bits in the 2B PMD
          line quality thresholds register"
        REFERENCE
          "[802.3ah] 45.2.1.36"
        ::= { efmCuPmeConfEntry 5 }

      efmCuPmeLineAtnCrossingEnable  OBJECT-TYPE
        SYNTAX      TruthValue
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
          "Indicates whether efmCuPmeLineAtnCrossing notifications
          should be generated for this interface.

          Value of true(1) indicates that efmCuPmeLineAtnCrossing
          notification is enabled. Value of false(2) indicates that
          the notification is disabled."
        ::= { efmCuPmeConfEntry 6 }

      efmCuPmeSnrMgnCrossingEnable  OBJECT-TYPE
        SYNTAX      TruthValue
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
          "Indicates whether efmCuPmeSnrMgnCrossing notifications
          should be generated for this interface.



Beili                    Expires August 22, 2007               [Page 47]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          Value of true(1) indicates that efmCuPmeSnrMgnCrossing
          notification is enabled. Value of false(2) indicates that
          the notification is disabled."
        ::= { efmCuPmeConfEntry 7 }

      efmCuPmeDeviceFaultEnable  OBJECT-TYPE
        SYNTAX      TruthValue
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
          "Indicates whether efmCuPmeDeviceFault notifications
          should be generated for this interface.

          Value of true(1) indicates that efmCuPmeDeviceFault
          notification is enabled. Value of false(2) indicates that
          the notification is disabled."
        ::= { efmCuPmeConfEntry 8 }

      efmCuPmeConfigInitFailEnable  OBJECT-TYPE
        SYNTAX      TruthValue
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
          "Indicates whether efmCuPmeConfigInitFailure notifications
          should be generated for this interface.

          Value of true(1) indicates that efmCuPmeConfigInitFailure
          notification is enabled. Value of false(2) indicates that
          the notification is disabled."
        ::= { efmCuPmeConfEntry 9 }

      efmCuPmeProtocolInitFailEnable  OBJECT-TYPE
        SYNTAX      TruthValue
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
          "Indicates whether efmCuPmeProtocolInitFailure notifications
          should be generated for this interface.

          Value of true(1) indicates that efmCuPmeProtocolInitFailure
          notification is enabled. Value of false(2) indicates that
          the notification is disabled."
        ::= { efmCuPmeConfEntry 10 }


      efmCuPmeCapabilityTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF EfmCuPmeCapabilityEntry
        MAX-ACCESS  not-accessible



Beili                    Expires August 22, 2007               [Page 48]

Internet-Draft            EFMCu Interfaces MIB             February 2007


        STATUS      current
        DESCRIPTION
          "Table for Configuration of common aspects for EFMCu
          2BASE-TL/10PASS-TS PME ports (modems). Configuration of
          aspects specific to 2BASE-TL or 10PASS-TS PME types is
          represented in efmCuPme2BConfTable and efmCuPme10PConfTable
          respectively.

          Entries in this table MUST be maintained in a persistent
          manner."
        ::= { efmCuPme 2 }

      efmCuPmeCapabilityEntry OBJECT-TYPE
        SYNTAX      EfmCuPmeCapabilityEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "An entry in the EFMCu PME Capability table.
          Each entry represents common aspects of an EFMCu PME port
          indexed by the ifIndex. Note that an EFMCu PME port can be
          stacked below a single PCS port, also indexed by ifIndex,
          possibly together with other PME ports if PAF is enabled."
        INDEX  { ifIndex }
        ::= { efmCuPmeCapabilityTable 1 }

      EfmCuPmeCapabilityEntry ::=
        SEQUENCE {
          efmCuPmeSubTypesSupported     BITS
        }

      efmCuPmeSubTypesSupported  OBJECT-TYPE
        SYNTAX      BITS {
          ieee2BaseTLO(0),
          ieee2BaseTLR(1),
          ieee10PassTSO(2),
          ieee10PassTSR(3)
        }
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "PME supported sub-types. This is a bitmap of possible
          sub-types. The various bit positions are:
            ieee2BaseTLO    - PME is capable of operating as 2BaseTL-O
            ieee2BaseTLR    - PME is capable of operating as 2BaseTL-R
            ieee10PassTSO   - PME is capable of operating as 10PassTS-O
            ieee10PassTSR   - PME is capable of operating as 10PassTS-R

          An desired mode of operation is determined by



Beili                    Expires August 22, 2007               [Page 49]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          efmCuPmeAdminSubType, while efmCuPmeOperSubType reflects the
          current operating mode.

          If a Clause 45 MDIO Interface to the PCS is present, then this
          object combines the 10PASS-TS capable and 2BASE-TL capable
          bits in the 10P/2B PMA/PMD speed ability register and the
          CO supported and CPE supported bits in the 10P/2B PMA/PMD
          status register"
        REFERENCE
          "[802.3ah] 61.1, 45.2.1.4.1, 45.2.1.4.2, 45.2.1.12.2,
          45.2.1.12.3"
        ::= { efmCuPmeCapabilityEntry 1 }


      efmCuPmeStatusTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF EfmCuPmeStatusEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "This table provides common status information of EFMCu
          2BASE-TL/10PASS-TS PME ports. Status information specific
          to 10PASS-TS PME is represented in efmCuPme10PStatusTable.

          This table contains live data from the equipment. As such,
          it is NOT persistent."
        ::= { efmCuPme 3 }

      efmCuPmeStatusEntry OBJECT-TYPE
        SYNTAX      EfmCuPmeStatusEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "An entry in the EFMCu PME Status table.
          Each entry represents common aspects of an EFMCu PME port
          indexed by the ifIndex. Note that an EFMCu PME port can be
          stacked below a single PCS port, also indexed by ifIndex,
          possibly together with other PME ports if PAF is enabled."
        INDEX  { ifIndex }
        ::= { efmCuPmeStatusTable 1 }

      EfmCuPmeStatusEntry ::=
        SEQUENCE {
          efmCuPmeOperStatus            INTEGER,
          efmCuPmeFltStatus             BITS,
          efmCuPmeOperSubType           INTEGER,
          efmCuPmeOperProfile           EfmProfileIndexOrZero,
          efmCuPmeSnrMgn                Integer32,
          efmCuPmePeerSnrMgn            Integer32,



Beili                    Expires August 22, 2007               [Page 50]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          efmCuPmeLineAtn               Integer32,
          efmCuPmePeerLineAtn           Integer32,
          efmCuPmeEquivalentLength      Unsigned32,
          efmCuPmeTCCodingErrors        Counter32,
          efmCuPmeTCCrcErrors           Counter32
        }

      efmCuPmeOperStatus  OBJECT-TYPE
        SYNTAX      INTEGER {
          up(1),
          downNotReady(2),
          downReady(3),
          init(4)
        }
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "Current PME link Operational Status. Possible values are:
            up(1)           - link is Up and ready to pass 64/65B
                              encoded frames or fragments.
            downNotReady(2) - link is Down and the PME does not detect
                              Handshake tones from its peer. This value
                              may indicate a possible problem with
                              the peer PME.
            downReady(3)    - link is Down and the PME detects Handshake
                              tones from its peer.
            init(4)         - link is initializing, as a result of
                              ifAdminStatus being set to 'up' for a
                              particular PME or a PCS the PME is
                              connected to.

          This object is intended to supplement Down state of
          ifOperStatus.

          This object partially maps to the Clause 30 attribute
          aPMEStatus.

          If a Clause 45 MDIO Interface to the PME is present, then this
          object partially maps to PMA/PMD link status bits in 10P/2B
          PMA/PMD status register."
        REFERENCE
          "[802.3ah] 30.11.2.1.3, 45.2.1.12.4"
        ::= { efmCuPmeStatusEntry 1 }

      efmCuPmeFltStatus  OBJECT-TYPE
        SYNTAX      BITS {
          lossOfFraming(0),
          snrMgnDefect(1),



Beili                    Expires August 22, 2007               [Page 51]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          lineAtnDefect(2),
          deviceFault(3),
          configInitFailure(4),
          protocolInitFailure(5)
        }
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "Current/Last PME link Fault Status. This is a bitmap of
          possible conditions. The various bit positions are:

            lossOfFraming       - Loss of Framing for 10P or
                                  Loss of Sync word for 2B PMD or
                                  Loss of 64/65B Framing
            snrMgnDefect        - SNR Margin dropped below the Threshold
            lineAtnDefect       - Line Attenuation exceeds the Threshold
            deviceFault         - Indicates a vendor-dependent
                                  diagnostic or self-test fault
                                  has been detected.
            configInitFailure   - Configuration initialization failure,
                                  due to inability of the PME link to
                                  support configuration profile,
                                  requested during initialization.
            protocolInitFailure - Protocol initialization failure,
                                  due to incompatible protocol used by
                                  the Peer PME during init (that could
                                  happen if a peer PMD is a regular
                                  G.SDHSL/VDSL modem instead of a
                                  2BASE-TL/10PASS-TS PME).

          This object is intended to supplement ifOperStatus in IF-MIB.

          This object holds information about the last fault.
          efmCuPmeFltStatus is cleared by the device restart.
          In addition lossOfFraming, configInitFailure and
          protocolInitFailure are cleared by PME init.
          deviceFault is cleared by successful diagnostics/test.
          snrMgnDefect and lineAtnDefect are cleared by SNR Margin
          and line Attenuation respectively returning to norm and by
          PME init.

          This object partially maps to the Clause 30 attribute
          aPMEStatus.

          If a Clause 45 MDIO Interface to the PME is present, then this
          object consolidates information from various PMA/PMD
          registers, namely: Fault bit in PMA/PMD status 1 register,
          10P/2B PMA/PMD link loss register,



Beili                    Expires August 22, 2007               [Page 52]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          10P outgoing indicator bits status register,
          10P incoming indicator bits status register,
          2B state defects register."
        REFERENCE
          "[802.3ah] 30.11.2.1.3, 45.2.1.2.1, 45.2.1.38,
          45.2.1.39, 45.2.1.54"
        ::= { efmCuPmeStatusEntry 2 }

      efmCuPmeOperSubType  OBJECT-TYPE
        SYNTAX      INTEGER {
          ieee2BaseTLO(1),
          ieee2BaseTLR(2),
          ieee10PassTSO(3),
          ieee10PassTSR(4)
        }
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "Current operational sub-type of the PME.
          Possible values are:
            ieee2BaseTLO           - PME operates as 2BaseTL-O
            ieee2BaseTLR           - PME operates as 2BaseTL-R
            ieee10PassTSO          - PME operates as 10PassTS-O
            ieee10PassTSR          - PME operates as 10PassTS-R

          The operational sub type of the PME can be configured via
          efmCuPmeAdminSubType variable.

          If a Clause 45 MDIO Interface to the PMA/PMD is present, then
          this object combines values of the Port sub-type select
          bits, the PMA/PMD type selection bits in the 10P/2B
          PMA/PMD control register and the PMA/PMD link status bits in
          the 10P/2B PMA/PMD status register."
        REFERENCE
          "[802.3ah] 61.1, 45.2.1.11.4, 45.2.1.11.7, 45.2.1.12.4"
        ::= { efmCuPmeStatusEntry 3 }

      efmCuPmeOperProfile  OBJECT-TYPE
        SYNTAX      EfmProfileIndexOrZero
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "PME current operating Profile. This object is a pointer to
          an entry in either efmCuPme2BProfileTable or
          efmCuPme10PProfileTable, depending on the current
          operating SubType of the PME as indicated by
          efmCuPmeOperSubType.
          Note that a profile entry, to which efmCuPmeOperProfile is



Beili                    Expires August 22, 2007               [Page 53]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          pointing to, can be created automatically, to reflect achieved
          parameters in adaptive (not fixed) initialization,
          i.e. values of efmCuPmeOperProfile and efmCuAdminProfile or
          efmCuPmeAdminProfile may differ.
          The value of zero indicates that PME is down or initializing.

          This object partially maps to the aOperatingProfile
          attribute in Clause 30."
        REFERENCE
          "[802.3ah] 30.11.2.1.7"
        ::= { efmCuPmeStatusEntry 4 }

      efmCuPmeSnrMgn OBJECT-TYPE
        SYNTAX      Integer32(-127..128|65535)
        UNITS       "dB"
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "The current Signal-to-Noise Ratio (SNR) margin with respect
          to the received signal as perceived by the local PME.
          The value of 65535 is returned when PME is down or
          initializing.

          This object maps to the aPMESNRMgn attribute in Clause 30.

          If a Clause 45 MDIO Interface is present, then this
          object maps to the 10P/2B RX SNR margin register."
        REFERENCE
          "[802.3ah] 30.11.2.1.4, 45.2.1.16"
        ::= { efmCuPmeStatusEntry 5 }

      efmCuPmePeerSnrMgn OBJECT-TYPE
        SYNTAX      Integer32(-127..128|65535)
        UNITS       "dB"
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "The current SNR margin in dB with respect to the received
          signal, as perceived by the remote (link partner) PME.
          The value of 65535 is returned when PME is down or
          initializing.

          This object is not supported by -R PME subtypes.

          If a Clause 45 MDIO Interface is present, then this
          object maps to the 10P/2B link partner RX SNR margin
          register."
        REFERENCE



Beili                    Expires August 22, 2007               [Page 54]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          "[802.3ah] 45.2.1.17"
        ::= { efmCuPmeStatusEntry 6}

      efmCuPmeLineAtn OBJECT-TYPE
        SYNTAX      Integer32(-127..128|65535)
        UNITS       "dB"
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "The current Line Attenuation in dB as perceived by the local
          PME.
          The value of 65535 is returned when PME is down or
          initializing.

          If a Clause 45 MDIO Interface is present, then this
          object maps to the Line Attenuation register"
        REFERENCE
          "[802.3ah] 45.2.1.18"
        ::= { efmCuPmeStatusEntry 7 }

      efmCuPmePeerLineAtn OBJECT-TYPE
        SYNTAX      Integer32(-127..128|65535)
        UNITS       "dB"
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "The current Line Attenuation in dB as perceived by the remote
          (link partner) PME.
          The value of 65535 is returned when PME is down or
          initializing.

          This object is not supported by CPE port (-R) subtypes.

          If a Clause 45 MDIO Interface is present, then this
          object maps to the 20P/2B link partner Line Attenuation
          register."
        REFERENCE
          "[802.3ah] 45.2.1.19"
        ::= { efmCuPmeStatusEntry 8 }

      efmCuPmeEquivalentLength  OBJECT-TYPE
        SYNTAX      Unsigned32(0..8192|65535)
        UNITS       "m"
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "An estimate of the equivalent loop's Physical Length in
          meters, as perceived by the PME after the link is established.



Beili                    Expires August 22, 2007               [Page 55]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          An equivalent loop is a hypothetical 26AWG (0.4mm) loop with a
          perfect square root attenuation characteristic, without any
          bridged taps.
          The value of 65535 is returned if the link is Down or
          Initializing or the PME is unable to estimate the Equivalent
          Length.

          For 10BASE-TL PME, if a Clause 45 MDIO Interface to the PME is
          present, then this object maps to the 10P Electrical Length
          register"
        REFERENCE
          "[802.3ah] 45.2.1.21"
        ::= { efmCuPmeStatusEntry 9 }

      efmCuPmeTCCodingErrors OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "A number of 64/65-octet encapsulation errors. This counter is
          incremented for each 64/65-octet encapsulation error detected
          by the 64/65-octet receive function.

          This object maps to aTCCodingViolations attribute in
          clause 30.

          If a Clause 45 MDIO Interface to the PME TC is present, then
          this object maps to the TC coding violations register
          (see 45.2.6.12).

          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other times
          as indicated by the value of ifCounterDiscontinuityTime,
          defined in IF-MIB."
        REFERENCE
          "[802.3ah] 61.3.3.1, 30.11.2.1.5, 45.2.6.12"
        ::= { efmCuPmeStatusEntry 10 }

      efmCuPmeTCCrcErrors OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "A number of TC-CRC errors. This counter is incremented for
          each TC-CRC error detected by the 64/65-octet receive function
          (see 61.3.3.3 and Figure 61-19).

          This object maps to aTCCRCErrors attribute in



Beili                    Expires August 22, 2007               [Page 56]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          clause 30.

          If a Clause 45 MDIO Interface to the PCME TC is present, then
          this object maps to the TC CRC error register
          (see 45.2.6.11).

          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other times
          as indicated by the value of ifCounterDiscontinuityTime,
          defined in IF-MIB."
        REFERENCE
          "[802.3ah] 61.3.3.3, 30.11.2.1.10, 45.2.6.11"
        ::= { efmCuPmeStatusEntry 11 }

     -- 2BASE-TL specific PME group

      efmCuPme2B      OBJECT IDENTIFIER ::= { efmCuPme 5 }

      efmCuPme2BProfileTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF EfmCuPme2BProfileEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "This table supports definitions of administrative and
          operating Profiles for 2BASE-TL PMEs.
          First 14 entries in this table SHALL always be defined as
          follows (see 802.3ah Annex 63A):
          -------+-------+-------+-----+------+------------------
          Profile MinRate MaxRate Power Region Constellation
           index  (Kbps)  (Kbps)  (dBm)
          -------+-------+-------+-----+------+------------------
             1     5696    5696    13.5    1   32-TCPAM (default)
             2     3072    3072    13.5    1   32-TCPAM
             3     2048    2048    13.5    1   16-TCPAM
             4     1024    1024    13.5    1   16-TCPAM
             5      704     704    13.5    1   16-TCPAM
             6      512     512    13.5    1   16-TCPAM
             7     5696    5696    14.5    2   32-TCPAM
             8     3072    3072    14.5    2   32-TCPAM
             9     2048    2048    14.5    2   16-TCPAM
            10     1024    1024    13.5    2   16-TCPAM
            11      704     704    13.5    2   16-TCPAM
            12      512     512    13.5    2   16-TCPAM
            13      192    5696       0    1   0        (best effort)
            14      192    5696       0    2   0        (best effort)

          These default entries SHALL be created during agent
          initialization and MUST NOT be deleted.



Beili                    Expires August 22, 2007               [Page 57]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          Entries following the first 14, can be dynamically created and
          deleted, to provide custom administrative (configuration)
          profiles and automatic operating profiles.

          This table MUST be maintained in a persistent manner."
        REFERENCE
          "[802.3ah] Annex 63A, 30.11.2.1.6"
        ::= { efmCuPme2B  2 }

      efmCuPme2BProfileEntry OBJECT-TYPE
        SYNTAX      EfmCuPme2BProfileEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "Each entry corresponds to a single 2BASE-TL PME profile.
          Each profile contains a set of parameters, used either for
          configuration or representation of a 2BASE-TL PME.
          In case a particular profile is referenced via
          efmCuPmeAdminProfile object (or efmCuAdminProfile if
          efmCuPmeAdminProfile is zero), it represent the desired
          parameters the 2BaseTL-O PME initialization.
          If a profile is referenced via efmCuPmeOperProfile object,
          it represents current operating parameters of the
          operational PME.

          Profiles may be created/deleted using the row creation/
          deletion mechanism via efmCuPme2BProfileRowStatus. If an
          active entry is referenced, the entry MUST remain 'active'
          until all references are removed.
          Default entries MUST NOT be removed."
        INDEX { efmCuPme2BProfileIndex }
        ::= { efmCuPme2BProfileTable 1 }

      EfmCuPme2BProfileEntry ::=
        SEQUENCE {
          efmCuPme2BProfileIndex           EfmProfileIndex,
          efmCuPme2BProfileDescr           SnmpAdminString,
          efmCuPme2BRegion                 INTEGER,
          efmCuPme2BsMode                  EfmProfileIndexOrZero,
          efmCuPme2BMinDataRate            Unsigned32,
          efmCuPme2BMaxDataRate            Unsigned32,
          efmCuPme2BPower                  Unsigned32,
          efmCuPme2BConstellation          INTEGER,
          efmCuPme2BProfileRowStatus       RowStatus
        }

      efmCuPme2BProfileIndex OBJECT-TYPE
        SYNTAX      EfmProfileIndex



Beili                    Expires August 22, 2007               [Page 58]

Internet-Draft            EFMCu Interfaces MIB             February 2007


        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "2BASE-TL PME Profile index.
          This object is the unique index associated with this profile.
          Entries in this table are referenced via efmCuAdminProfile
          or efmCuPmeAdminProfile objects."
        ::= { efmCuPme2BProfileEntry 1 }

      efmCuPme2BProfileDescr OBJECT-TYPE
        SYNTAX      SnmpAdminString
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "A textual string containing information about 2BASE-TL PME
          Profile. The string may include information about data rate
          and spectral limitations of this particular profile."
        ::= { efmCuPme2BProfileEntry 2 }

      efmCuPme2BRegion  OBJECT-TYPE
        SYNTAX      INTEGER {
          region1(1),
          region2(2)
        }
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "Regional settings for 2BASE-TL PME, as specified in the
          relevant Regional Annex of [G.991.2].
          Regional settings specify Power Spectral Density (PSD) mask,
          Power Back-Off (PBO) values and place limitations on the max
          allowed data rate, power and constellation.

          Possible values for this object are:
            region1      - Annexes A and F (e.g. North America)
            region2      - Annexes B and G (e.g. Europe)

          Annex A/B specify regional settings for data rates 192-2304
          Kbps using 16-TCPAM encoding.
          Annex F/G specify regional settings for rates 2320-3840 Kbps
          using 16-TCPAM encoding and 768-5696 Kbps using 32-TCPAM
          encoding.

          If a Clause 45 MDIO Interface to the PME is present, then this
          object partially maps to the Region bits in the 2B general
          parameter register."
        REFERENCE
          "[802.3ah] 45.2.1.42; [G.991.2] Annexes A, B, F and G"



Beili                    Expires August 22, 2007               [Page 59]

Internet-Draft            EFMCu Interfaces MIB             February 2007


        ::= { efmCuPme2BProfileEntry 3 }

      efmCuPme2BsMode  OBJECT-TYPE
        SYNTAX      EfmProfileIndexOrZero
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "Desired custom Spectral Mode for 2BASE-TL PME. This object
          is a pointer to an entry in efmCuPme2BsModeTable and a block
          of entries in efmCuPme2BRateReachTable, which together define
          (country-specific) reach dependent rate limitations in
          addition to those defined by efmCuPme2BRegion.

          The value of this object is the index of the referenced
          spectral mode.
          The value of zero (default) indicates that no specific
          spectral mode is applicable.

          Attempts to set this object to a value that is not the value
          of the index for an active entry in the corresponding spectral
          mode table, MUST be rejected."
        REFERENCE
          "efmCuPme2BsModeTable, efmCuPme2BRateReachTable"
        DEFVAL { 0 }
        ::= { efmCuPme2BProfileEntry 4 }

      efmCuPme2BMinDataRate  OBJECT-TYPE
        SYNTAX  Unsigned32(192..5696)
        UNITS       "Kbps"
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "Minimum Data Rate for the 2BASE-TL PME.
          This object can take values of (n x 64)Kbps,
          where n=3..60 for 16-TCPAM and n=12..89 for 32-TCPAM encoding.

          The data rate of the 2BASE-TL PME is considered 'fixed' when
          the value of this object equals that of efmCuPme2BMaxDataRate.
          If efmCuPme2BMinDataRate is less than efmCuPme2BMaxDataRate in
          the administrative profile, the data rate is considered
          'adaptive', and SHALL be set to the maximum attainable rate
          not exceeding efmCuPme2BMaxDataRate, under the spectral
          limitations placed by the efmCuPme2BRegion and
          efmCuPme2BsMode.

          Note that current operational data rate of the PME is
          represented by ifSpeed object of IF-MIB.




Beili                    Expires August 22, 2007               [Page 60]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          If a Clause 45 MDIO Interface to the PME is present, then this
          object maps to the Min Data Rate1 bits in the 2B PMD
          parameters register.

          This object MUST be maintained in a persistent manner."
        REFERENCE
          "[802.3ah] 45.2.1.43"
        ::= { efmCuPme2BProfileEntry 5 }

      efmCuPme2BMaxDataRate  OBJECT-TYPE
        SYNTAX  Unsigned32(192..5696)
        UNITS       "Kbps"
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "Maximum Data Rate for the 2BASE-TL PME.
          This object can take values of (n x 64)Kbps,
          where n=3..60 for 16-TCPAM and n=12..89 for 32-TCPAM encoding.

          The data rate of the 2BASE-TL PME is considered 'fixed' when
          the value of this object equals that of efmCuPme2BMinDataRate.
          If efmCuPme2BMinDataRate is less than efmCuPme2BMaxDataRate in
          the administrative profile, the data rate is considered
          'adaptive', and SHALL be set to the maximum attainable rate
          not exceeding efmCuPme2BMaxDataRate, under the spectral
          limitations placed by the efmCuPme2BRegion and
          efmCuPme2BsMode.

          Note that current operational data rate of the PME is
          represented by ifSpeed object of IF-MIB.

          If a Clause 45 MDIO Interface to the PME is present, then this
          object maps to the Max Data Rate1 bits in the 2B PMD
          parameters register.

          This object MUST be maintained in a persistent manner."
        REFERENCE
          "[802.3ah] 45.2.1.43"
        ::= { efmCuPme2BProfileEntry 6 }

      efmCuPme2BPower  OBJECT-TYPE
        SYNTAX      Unsigned32(0|10..42)
        UNITS       "0.5 dBm"
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "Signal Transmit Power. Multiple of 0.5dBm.
          The value of 0 in the administrative profile means that the



Beili                    Expires August 22, 2007               [Page 61]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          signal transmit power is not fixed and SHALL be set to
          maximize the attainable rate, under the spectral limitations
          placed by the efmCuPme2BRegion and efmCuPme2BsMode.

          If a Clause 45 MDIO Interface to the PME is present, then this
          object maps to the Power1 bits in the 2B PMD parameters
          register"
        REFERENCE
          "[802.3ah] 45.2.1.43"
        ::= { efmCuPme2BProfileEntry 7 }

      efmCuPme2BConstellation  OBJECT-TYPE
        SYNTAX      INTEGER {
          adaptive(0),
          tcpam16(1),
          tcpam32(2)
        }
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "TCPAM Constellation of the 2BASE-TL PME.
          The possible values are:
            adaptive(0)    - either 16- or 32-TCPAM
            tcpam16(1)     - 16-TCPAM
            tcpam32(2)     - 32-TCPAM

          The value of adaptive(0) in the administrative profile means
          that the constellation is not fixed and SHALL be set to
          maximize the attainable rate, under the spectral limitations
          placed by the efmCuPme2BRegion and efmCuPme2BsMode.

          If a Clause 45 MDIO Interface to the PME is present, then this
          object maps to the Constellation1 bits in the 2B general
          parameter register."
        REFERENCE
           "[802.3ah] 45.2.1.43"
        ::= { efmCuPme2BProfileEntry 8 }

      efmCuPme2BProfileRowStatus OBJECT-TYPE
        SYNTAX      RowStatus
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "This object controls creation/deletion of the associated
          entry in efmCuPme2BProfileTable per the semantics of
          RowStatus.
          If an 'active' entry is referenced via efmCuAdminProfile or
          efmCuPmeAdminProfile, the entry MUST remain 'active' until all



Beili                    Expires August 22, 2007               [Page 62]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          references are removed."
        ::= { efmCuPme2BProfileEntry 9 }


      efmCuPme2BsModeTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF EfmCuPme2BsModeEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "This table, together with efmCu2BReachRateTable, supports
          definition of administrative custom spectral modes for
          2BASE-TL PMEs, describing spectral limitations in addition to
          those specified by efmCuPme2BRegion.

          Some countries spectral regulations (e.g. UK ANFP) limit the
          length of the loops for certain data rates. This table allows
          these country-specific limitations to be specified.

          Entries in this table referenced by the efmCuPme2BsMode
          MUST NOT be deleted until all the active references are
          removed.

          This table MUST be maintained in a persistent manner."
        REFERENCE
          "efmCu2BReachRateTable"
        ::= { efmCuPme2B  3 }

      efmCuPme2BsModeEntry OBJECT-TYPE
        SYNTAX      EfmCuPme2BsModeEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "Each entry specifies spectral mode description and its index,
          which is used to reference corresponding entries in the
          efmCu2BReachRateTable.

          Entries may be created/deleted using the row creation/
          deletion mechanism via efmCuPme2BsModeRowStatus."
        INDEX { efmCuPme2BsModeIndex }
        ::= { efmCuPme2BsModeTable 1 }

      EfmCuPme2BsModeEntry ::=
        SEQUENCE {
          efmCuPme2BsModeIndex             EfmProfileIndex,
          efmCuPme2BsModeDescr             SnmpAdminString,
          efmCuPme2BsModeRowStatus         RowStatus
        }




Beili                    Expires August 22, 2007               [Page 63]

Internet-Draft            EFMCu Interfaces MIB             February 2007


      efmCuPme2BsModeIndex OBJECT-TYPE
        SYNTAX      EfmProfileIndex
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "2BASE-TL PME Spectral Mode index.
          This object is the unique index associated with this spectral
          mode.
          Entries in this table are referenced via efmCuPme2BsMode
          object."
        ::= { efmCuPme2BsModeEntry 1 }

      efmCuPme2BsModeDescr OBJECT-TYPE
        SYNTAX      SnmpAdminString
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "A textual string containing information about 2BASE-TL PME
          spectral mode. The string may include information about
          corresponding (country-specific) spectral regulations
          and rate/reach limitations of this particular spectral mode."
        ::= { efmCuPme2BsModeEntry 2 }

      efmCuPme2BsModeRowStatus OBJECT-TYPE
        SYNTAX      RowStatus
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "This object controls creation/deletion of the associated
          entry in efmCuPme2BsModeTable per the semantics of
          RowStatus.
          If an 'active' entry is referenced via efmCuPme2BsMode, the
          entry MUST remain 'active' until all references are removed."
        ::= { efmCuPme2BsModeEntry 3 }


      efmCuPme2BReachRateTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF EfmCuPme2BReachRateEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "This table supports definition of administrative custom
          spectral modes for 2BASE-TL PMEs, providing spectral
          limitations in addition to those specified by
          efmCuPme2BRegion.

          The spectral regulations in some countries (e.g. UK ANFP)
          limit the length of the loops for certain data rates.



Beili                    Expires August 22, 2007               [Page 64]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          This table allows these country-specific limitations to be
          specified.

          Below is an example of this table for [ANFP]:
          ----------+-------+-------+
          Equivalent MaxRate MaxRate
            Length    PAM16   PAM32
              (m)     (Kbps)  (Kbps)
          ----------+-------+-------+
              975      2304    5696
             1125      2304    5504
             1275      2304    5120
             1350      2304    4864
             1425      2304    4544
             1500      2304    4288
             1575      2304    3968
             1650      2304    3776
             1725      2304    3520
             1800      2304    3264
             1875      2304    3072
             1950      2048    2688
             2100      1792    2368
             2250      1536       0
             2400      1408       0
             2550      1280       0
             2775      1152       0
             2925      1152       0
             3150      1088       0
             3375      1024       0
          ----------+-------+-------+

          Entries in this table referenced by the efmCuPme2BsMode
          MUST NOT be deleted until all the active references are
          removed.

          This table MUST be maintained in a persistent manner."
        REFERENCE
          "[ANFP]"
        ::= { efmCuPme2B  4 }

      efmCuPme2BReachRateEntry OBJECT-TYPE
        SYNTAX      EfmCuPme2BReachRateEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "Each entry specifies maximum 2BASE-TL PME data rates
          allowed for a certain equivalent loop length, when using
          16-TCPAM or 32-TCPAM encoding.



Beili                    Expires August 22, 2007               [Page 65]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          When 2BASE-TL PME is initialized, its data rate MUST NOT
          exceed one of the following limitations:
          - the value of efmCuPme2BMaxDataRate
          - maximum data rate allowed by efmCuPme2BRegion and
            efmCuPme2BPower
          - maximum data rate for a given encoding specified in the
            efmCuPme2BsModeEntry, corresponding to the equivalent loop
            length, estimated by the PME.

          It is RECOMMENDED that the efmCuPme2BEquivalentLength values
          are assigned in the increasing order, starting from the
          minimum value.

          Entries may be created/deleted using the row creation/
          deletion mechanism via efmCuPme2ReachRateRowStatus."
        INDEX { efmCuPme2BsModeIndex, efmCuPme2BReachRateIndex }
        ::= { efmCuPme2BReachRateTable 1 }

      EfmCuPme2BReachRateEntry ::=
        SEQUENCE {
          efmCuPme2BReachRateIndex         EfmProfileIndex,
          efmCuPme2BEquivalentLength       Unsigned32,
          efmCuPme2BMaxDataRatePam16       Unsigned32,
          efmCuPme2BMaxDataRatePam32       Unsigned32,
          efmCuPme2BReachRateRowStatus     RowStatus
        }

      efmCuPme2BReachRateIndex OBJECT-TYPE
        SYNTAX      EfmProfileIndex
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "2BASE-TL custom spectral mode Reach-Rate table index.
          This object is the unique index associated with each enry."
        ::= { efmCuPme2BReachRateEntry 1 }

      efmCuPme2BEquivalentLength  OBJECT-TYPE
        SYNTAX      Unsigned32(0..8192)
        UNITS       "m"
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "Maximum allowed Equivalent loop's Physical Length in meters
          for the specified data rates.
          An equivalent loop is a hypothetical 26AWG (0.4mm) loop with a
          perfect square root attenuation characteristic, without any
          bridged taps."
        ::= { efmCuPme2BReachRateEntry 2 }



Beili                    Expires August 22, 2007               [Page 66]

Internet-Draft            EFMCu Interfaces MIB             February 2007


      efmCuPme2BMaxDataRatePam16  OBJECT-TYPE
        SYNTAX      Unsigned32(0|192..5696)
        UNITS       "Kbps"
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "Maximum data rate for 2BASE-TL PME at the specified
          Equivalent loop's Length using TC-PAM16 encoding.
          The value of zero means that TC-PAM16 encoding should not be
          used at this distance."
        ::= { efmCuPme2BReachRateEntry 3 }

      efmCuPme2BMaxDataRatePam32  OBJECT-TYPE
        SYNTAX      Unsigned32(0|192..5696)
        UNITS       "Kbps"
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "Maximum data rate for 2BASE-TL PME at the specified
          Equivalent loop's Length using TC-PAM32 encoding.
          The value of zero means that TC-PAM32 encoding should not be
          used at this distance."
        ::= { efmCuPme2BReachRateEntry 4 }

      efmCuPme2BReachRateRowStatus OBJECT-TYPE
        SYNTAX      RowStatus
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "This object controls creation/deletion of the associated
          entry in efmCuPme2BReachRateTable per the semantics of
          RowStatus.
          If an 'active' entry is referenced via efmCuPme2BsMode, the
          entry MUST remain 'active' until all references are removed."
        ::= { efmCuPme2BReachRateEntry 5 }


     -- 10PASS-TS specific PME group

      efmCuPme10P      OBJECT IDENTIFIER ::= { efmCuPme 6 }

      efmCuPme10PProfileTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF EfmCuPme10PProfileEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "This table supports definitions of configuration profiles for
          10PassTL PMEs.



Beili                    Expires August 22, 2007               [Page 67]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          First 22 entries in this table SHALL always be defined as
          follows (see 802.3ah Annex 62B.3):
          -------+--------+----+---------+-----+------------
          Profile Bandplan UPBO BandNotch DRate URate
           Index  PSDMask#  p#    p#        p#    p#
          -------+--------+----+---------+-----+------------
             1      1      3    2,6,10,11    20    20(default)
             2     13      5    0            20    20
             3      1      1    0            20    20
             4     16      0    0           100   100
             5     16      0    0            70    50
             6      6      0    0            50    10
             7     17      0    0            30    30
             8      8      0    0            30     5
             9      4      0    0            25    25
            10      4      0    0            15    15
            11     23      0    0            10    10
            12     23      0    0             5     5
            13     16      0    2,5,9,11    100   100
            14     16      0    2,5,9,11     70    50
            15      6      0    2,6,10,11    50    10
            16     17      0    2,5,9,11     30    30
            17      8      0    2,6,10,11    30     5
            18      4      0    2,6,10,11    25    25
            19      4      0    2,6,10,11    15    15
            20     23      0    2,5,9,11     10    10
            21     23      0    2,5,9,11      5     5
            22     30      0    0           200    50

          These default entries SHALL be created by during agent
          initialization and MUST NOT be deleted.

          Entries following the first 22, can be dynamically created and
          deleted, to provide custom administrative (configuration)
          profiles and automatic operating profiles.

          This table MUST be maintained in a persistent manner."
        REFERENCE
          "[802.3ah] Annex 62B.3, 30.11.2.1.6"
        ::= { efmCuPme10P  1 }

      efmCuPme10PProfileEntry OBJECT-TYPE
        SYNTAX      EfmCuPme10PProfileEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "Each entry corresponds to a single 10PASS-TS PME
          profile.



Beili                    Expires August 22, 2007               [Page 68]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          Each profile contains a set of parameters, used either for
          configuration or representation of a 10PASS-TS PME.
          In case a particular profile is referenced via
          efmCuPmeAdminProfile object (or efmCuAdminProfile if
          efmCuPmeAdminProfile is zero), it represent the desired
          parameters the 10PassTS-O PME initialization.
          If a profile is referenced via efmCuPmeOperProfile object,
          it represents current operating parameters of the PME.

          Profiles may be created/deleted using the row creation/
          deletion mechanism via efmCuPme10PProfileRowStatus. If an
          'active' entry is referenced, the entry MUST remain 'active'
          until all references are removed.
          Default entries MUST NOT be removed."
        INDEX { efmCuPme10PProfileIndex }
        ::= { efmCuPme10PProfileTable 1 }

      EfmCuPme10PProfileEntry ::=
        SEQUENCE {
          efmCuPme10PProfileIndex           EfmProfileIndex,
          efmCuPme10PProfileDescr           SnmpAdminString,
          efmCuPme10PBandplanPSDMskProfile  INTEGER,
          efmCuPme10PUPBOReferenceProfile   INTEGER,
          efmCuPme10PBandNotchProfiles      BITS,
          efmCuPme10PPayloadURateProfile    INTEGER,
          efmCuPme10PPayloadDRateProfile    INTEGER,
          efmCuPme10PProfileRowStatus       RowStatus
        }

      efmCuPme10PProfileIndex OBJECT-TYPE
        SYNTAX      EfmProfileIndex
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "10PASS-TS PME Profile Index.
          This object is the unique index associated with this profile.
          Entries in this table are referenced via efmCuAdminProfile or
          efmCuPmeAdminProfile."
        ::= { efmCuPme10PProfileEntry 1 }

      efmCuPme10PProfileDescr OBJECT-TYPE
        SYNTAX      SnmpAdminString
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "A textual string containing information about 10PASS-TS PME
          Profile. The string may include information about data rate
          and spectral limitations of this particular profile."



Beili                    Expires August 22, 2007               [Page 69]

Internet-Draft            EFMCu Interfaces MIB             February 2007


        ::= { efmCuPme10PProfileEntry 2 }

      efmCuPme10PBandplanPSDMskProfile  OBJECT-TYPE
        SYNTAX  INTEGER {
          profile1(1),
          profile2(2),
          profile3(3),
          profile4(4),
          profile5(5),
          profile6(6),
          profile7(7),
          profile8(8),
          profile9(9),
          profile10(10),
          profile11(11),
          profile12(12),
          profile13(13),
          profile14(14),
          profile15(15),
          profile16(16),
          profile17(17),
          profile18(18),
          profile19(19),
          profile20(20),
          profile21(21),
          profile22(22),
          profile23(23),
          profile24(24),
          profile25(25),
          profile26(26),
          profile27(27),
          profile28(28),
          profile29(29)
        }
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "10PASS-TS PME Bandplan and PSD Mask profile,
          as specified in 802.3ah Annex 62A. Possible values are:
          --------------+------------------------+-----------+---------
          Profile Name    PSD Mask                  Bands     Bandplan
          --------------+------------------------+-----------+---------
          profile1(1)   - T1.424/T-U P1 FTTCab.M1  x/D/U/D/U  A
          profile2(2)   - T1.424/T-U P1 FTTEx.M1
          profile3(3)   - T1.424/T-U P1 FTTCab.M2
          profile4(4)   - T1.424/T-U P1 FTTEx.M2
          profile5(5)   - T1.424/T-U P1 FTTCab.M1  D/D/U/D/U
          profile6(6)   - T1.424/T-U P1 FTTEx.M1



Beili                    Expires August 22, 2007               [Page 70]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          profile7(7)   - T1.424/T-U P1 FTTCab.M2
          profile8(8)   - T1.424/T-U P1 FTTEx.M2
          profile9(9)   - T1.424/T-U P1 FTTCab.M1  U/D/U/D/x
          profile10(10) - T1.424/T-U P1 FTTEx.M1
          profile11(11) - T1.424/T-U P1 FTTCab.M2
          profile12(12) - T1.424/T-U P1 FTTEx.M2
          profile13(13) - TS1 101 270-1 Pcab.M1.A  x/D/U/D/U  B
          profile14(14) - TS1 101 270-1 Pcab.M1.B
          profile15(15) - TS1 101 270-1 Pex.P1.M1
          profile16(16) - TS1 101 270-1 Pex.P2.M1
          profile17(17) - TS1 101 270-1 Pcab.M2
          profile18(18) - TS1 101 270-1 Pex.P1.M2
          profile19(19) - TS1 101 270-1 Pex.P2.M2
          profile20(20) - TS1 101 270-1 Pcab.M1.A  U/D/U/D/x
          profile21(21) - TS1 101 270-1 Pcab.M1.B
          profile22(22) - TS1 101 270-1 Pex.P1.M1
          profile23(23) - TS1 101 270-1 Pex.P2.M1
          profile24(24) - TS1 101 270-1 Pcab.M2
          profile25(25) - TS1 101 270-1 Pex.P1.M2
          profile26(26) - TS1 101 270-1 Pex.P2.M2
          profile27(27) - G.993.1 F.1.2.1 (VDSLoPOTS) x/D/U/D/U  F
          profile28(28) - G.993.1 F.1.2.2 (VDSLoTCM-ISDN)
          profile29(29) - G.993.1 F.1.2.3 (PSD reduction)

          This object maps to the aBandplanPSDMaskProfile attribute
          in Clause 30."
        REFERENCE
          "[802.3ah] Annex 62A, 30.5.1.1.22"
        ::= { efmCuPme10PProfileEntry 3 }

      efmCuPme10PUPBOReferenceProfile  OBJECT-TYPE
        SYNTAX  INTEGER {
          profile1(1),
          profile2(2),
          profile3(3),
          profile4(4),
          profile5(5),
          profile6(6),
          profile7(7),
          profile8(8),
          profile9(9)
        }
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "10PASS-TS PME Upstream Power Back-Off (UPBO) Reference PSD
          Profile, as specified in 802.3ah Annex 62A. Possible values
          are:



Beili                    Expires August 22, 2007               [Page 71]

Internet-Draft            EFMCu Interfaces MIB             February 2007


            profile1(1)   - T1.424/T-U         Noise A M1
            profile2(2)   - T1.424/T-U         Noise A M2
            profile3(3)   - T1.424/T-U         Noise F M1
            profile4(4)   - T1.424/T-U         Noise F M2
            profile5(5)   - ETSI TS 101 270-1  Noise A&B
            profile6(6)   - ETSI TS 101 270-1  Noise C
            profile7(7)   - ETSI TS 101 270-1  Noise D
            profile8(8)   - ETSI TS 101 270-1  Noise E
            profile9(9)   - ETSI TS 101 270-1  Noise F

          This object maps to the aUPBOReferenceProfile attribute
          in Clause 30."
        REFERENCE
          "[802.3ah] Annex 62A.3.4, 30.5.1.1.23"
        ::= { efmCuPme10PProfileEntry 4 }

      efmCuPme10PBandNotchProfiles  OBJECT-TYPE
        SYNTAX  BITS {
          profile0(0),
          profile1(1),
          profile2(2),
          profile3(3),
          profile4(4),
          profile5(5),
          profile6(6),
          profile7(7),
          profile8(8),
          profile9(9),
          profile10(10),
          profile11(11)
        }
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "10PASS-TS PME Egress Control Band Notch Profile bitmap,
          as specified in 802.3ah Annex 62A. Possible values are:
          --------------+---------+----------+-----------+------+-----
          Profile Name    G.991.3  T1.424/T-U TS101 270-1 StartF EndF
                          Table    Table      Table       (MHz)  (MHz)
          --------------+---------+----------+-----------+------+-----
          profile0(0)   - no profile
          profile1(1)   - F-5 #01  -          -           1.810  1.825
          profile2(2)   - 6-2      15-1       17          1.810  2.000
          profile3(3)   - F-5 #02  -          -           1.907  1.912
          profile4(4)   - F-5 #03  -          -           3.500  3.575
          profile5(5)   - 6-2      -          17          3.500  3.800
          profile6(6)   - -        15-1       -           3.500  4.000
          profile7(7)   - F-5 #04  -          -           3.747  3.754



Beili                    Expires August 22, 2007               [Page 72]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          profile8(8)   - F-5 #05  -          -           3.791  3.805
          profile9(9)   - 6-2      -          17          7.000  7.100
          profile10(10) - F-5 #06  15-1       -           7.000  7.300
          profile11(11) - 6-2      15-1       1           10.100 10.150

          Any combination of profiles can be specified by ORing
          individual profiles, for example value of 0x0622 selects
          profiles 2,6,10 and 11.

          This object maps to the aBandNotchProfile attribute
          in Clause 30."
        REFERENCE
          "[802.3ah] Annex 62A.3.5, 30.5.1.1.19"
        ::= { efmCuPme10PProfileEntry 5 }

      efmCuPme10PPayloadURateProfile  OBJECT-TYPE
        SYNTAX      INTEGER {
          profile5(5),
          profile10(10),
          profile15(15),
          profile20(20),
          profile25(25),
          profile30(30),
          profile50(50),
          profile70(70),
          profile100(100)
        }
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "10PASS-TS PME Upstream Payload Rate Profile,
          as specified in 802.3ah Annex 62A. Possible values are:
            profile5(5)       - 2.5 Mbps
            profile10(10)     - 5 Mbps
            profile15(15)     - 7.5 Mbps
            profile20(20)     - 10 Mbps
            profile25(25)     - 12.5 Mbps
            profile30(30)     - 15 Mbps
            profile50(50)     - 25 Mbps
            profile70(70)     - 35 Mbps
            profile100(100)   - 50 Mbps

          Each value represents a target for the PME's Upstream Payload
          Bitrate as seen at the MII. If the payload rate of the
          selected profile cannot be achieved based on the loop
          environment, bandplan and PSD mask, the PME initialization
          SHALL fail.




Beili                    Expires August 22, 2007               [Page 73]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          This object maps to the aPayloadRateProfileUpstream
          attribute in Clause 30."
        REFERENCE
          "[802.3ah] Annex 62A.3.6, 30.5.1.1.20"
        ::= { efmCuPme10PProfileEntry 6 }

      efmCuPme10PPayloadDRateProfile  OBJECT-TYPE
        SYNTAX      INTEGER {
          profile5(5),
          profile10(10),
          profile15(15),
          profile20(20),
          profile25(25),
          profile30(30),
          profile50(50),
          profile70(70),
          profile100(100),
          profile140(140),
          profile200(200)
        }
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "10PASS-TS PME Downstream Payload Rate Profile,
          as specified in 802.3ah Annex 62A. Possible values are:
            profile5(5)      - 2.5 Mbps
            profile10(10)    - 5 Mbps
            profile15(15)    - 7.5 Mbps
            profile20(20)    - 10 Mbps
            profile25(25)    - 12.5 Mbps
            profile30(30)    - 15 Mbps
            profile50(50)    - 25 Mbps
            profile70(70)    - 35 Mbps
            profile100(100)  - 50 Mbps
            profile140(140)  - 70 Mbps
            profile200(200)  - 100 Mbps

          Each value represents a target for the PME's Downstream
          Payload Bitrate as seen at the MII. If the payload rate of
          the selected profile cannot be achieved based on the loop
          environment, bandplan and PSD mask, the PME initialization
          SHALL fail.

          This object maps to the aPayloadRateProfileDownstream
          attribute in Clause 30."
        REFERENCE
          "[802.3ah] Annex 62A.3.6, 30.5.1.1.21"
        ::= { efmCuPme10PProfileEntry 7 }



Beili                    Expires August 22, 2007               [Page 74]

Internet-Draft            EFMCu Interfaces MIB             February 2007


      efmCuPme10PProfileRowStatus OBJECT-TYPE
        SYNTAX      RowStatus
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
          "This object controls creation/deletion of the associated
          entry in efmCuPme10PProfileTable per the semantics of
          RowStatus.
          If an active entry is referenced via efmCuAdminProfile or
          efmCuPmeAdminProfile, the entry MUST remain 'active' until
          all references are removed."
        ::= { efmCuPme10PProfileEntry 8 }


      efmCuPme10PStatusTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF EfmCuPme10PStatusEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "Table reflecting status of EFMCu 10PASS-TS PMEs (modems)."
        ::= { efmCuPme10P 2 }

      efmCuPme10PStatusEntry OBJECT-TYPE
        SYNTAX      EfmCuPme10PStatusEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
          "An entry in the EFMCu 10PASS-TS PME Status table."
        AUGMENTS { efmCuPmeStatusEntry }
        ::= { efmCuPme10PStatusTable 1 }

      EfmCuPme10PStatusEntry ::=
        SEQUENCE {
          efmCuPme10PFECCorrectedBlocks     Counter32,
          efmCuPme10PFECUncorrectedBlocks   Counter32
        }

      efmCuPme10PFECCorrectedBlocks  OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "A count of received and corrected FEC codewords in 10PASS-TS
          PME.

          This object maps to aPMEFECCorrectedBlocks attribute in
          clause 30.




Beili                    Expires August 22, 2007               [Page 75]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          If a Clause 45 MDIO Interface to the PMA/PMD is present,
          then this object maps to the 10P FEC correctable errors
          register

          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other times
          as indicated by the value of ifCounterDiscontinuityTime,
          defined in IF-MIB."
        REFERENCE
          "[802.3ah] 45.2.1.22, 30.11.2.1.8"
        ::= { efmCuPme10PStatusEntry 1 }

      efmCuPme10PFECUncorrectedBlocks  OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
          "A count of received FEC codewords in 10PASS-TS PME, which are
          uncorrectable.

          This object maps to aPMEFECUncorrectableBlocks attribute in
          clause 30.

          If a Clause 45 MDIO Interface to the PMA/PMD is present,
          then this object maps to the 10P FEC uncorrectable errors
          register

          Discontinuities in the value of this counter can occur at
          re-initialization of the management system, and at other times
          as indicated by the value of ifCounterDiscontinuityTime,
          defined in IF-MIB."
        REFERENCE
          "[802.3ah] 45.2.1.23, 30.11.2.1.9"
        ::= { efmCuPme10PStatusEntry 2 }

     --
     -- Conformance Statements
     --

      efmCuGroups      OBJECT IDENTIFIER ::= { efmCuConformance 1 }

      efmCuCompliances OBJECT IDENTIFIER ::= { efmCuConformance 2 }

      -- Object Groups

      efmCuBasicGroup OBJECT-GROUP
        OBJECTS {
          efmCuPAFSupported,



Beili                    Expires August 22, 2007               [Page 76]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          efmCuAdminProfile,
          efmCuTargetDataRate,
          efmCuTargetSnrMgn,
          efmCuAdaptiveSpectra,
          efmCuPortSide,
          efmCuFltStatus
        }
        STATUS      current
        DESCRIPTION
          "A collection of objects representing management information
          common for all types of EFMCu ports."
        ::= { efmCuGroups 1 }

      efmCuPAFGroup OBJECT-GROUP
        OBJECTS {
          efmCuPeerPAFSupported,
          efmCuPAFCapacity,
          efmCuPeerPAFCapacity,
          efmCuPAFAdminState,
          efmCuPAFDiscoveryCode,
          efmCuPAFRemoteDiscoveryCode,
          efmCuNumPMEs
        }
        STATUS      current
        DESCRIPTION
          "A collection of objects supporting OPTIONAL PME
          Aggregation Function (PAF) and PAF discovery in EFMCu ports."
        ::= { efmCuGroups 2 }

      efmCuPAFErrorsGroup OBJECT-GROUP
        OBJECTS {
          efmCuPAFInErrors,
          efmCuPAFInSmallFragments,
          efmCuPAFInLargeFragments,
          efmCuPAFInBadFragments,
          efmCuPAFInLostFragments,
          efmCuPAFInLostStarts,
          efmCuPAFInLostEnds,
          efmCuPAFInOverflows
        }
        STATUS      current
        DESCRIPTION
          "A collection of objects supporting OPTIONAL error counters
          of PAF on EFMCu ports."
        ::= { efmCuGroups 3 }

      efmCuPmeGroup OBJECT-GROUP
        OBJECTS {



Beili                    Expires August 22, 2007               [Page 77]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          efmCuPmeAdminProfile,
          efmCuPmeOperStatus,
          efmCuPmeFltStatus,
          efmCuPmeSubTypesSupported,
          efmCuPmeAdminSubType,
          efmCuPmeOperSubType,
          efmCuPAFRemoteDiscoveryCode,
          efmCuPmeOperProfile,
          efmCuPmeSnrMgn,
          efmCuPmePeerSnrMgn,
          efmCuPmeLineAtn,
          efmCuPmePeerLineAtn,
          efmCuPmeEquivalentLength,
          efmCuPmeTCCodingErrors,
          efmCuPmeTCCrcErrors,
          efmCuPmeThreshLineAtn,
          efmCuPmeThreshSnrMgn
        }
        STATUS      current
        DESCRIPTION
          "A collection of objects providing information about
          a 2BASE-TL/10PASS-TS PME."
        ::= { efmCuGroups 4 }

      efmCuAlarmConfGroup OBJECT-GROUP
        OBJECTS {
          efmCuThreshLowRate,
          efmCuLowRateCrossingEnable,
          efmCuPmeThreshLineAtn,
          efmCuPmeLineAtnCrossingEnable,
          efmCuPmeThreshSnrMgn,
          efmCuPmeSnrMgnCrossingEnable,
          efmCuPmeDeviceFaultEnable,
          efmCuPmeConfigInitFailEnable,
          efmCuPmeProtocolInitFailEnable
        }
        STATUS      current
        DESCRIPTION
          "A collection of objects supporting configuration of alarm
          thresholds and notifications in EFMCu ports."
        ::= { efmCuGroups 5 }

      efmCuNotificationGroup NOTIFICATION-GROUP
        NOTIFICATIONS {
          efmCuLowRateCrossing,
          efmCuPmeLineAtnCrossing,
          efmCuPmeSnrMgnCrossing,
          efmCuPmeDeviceFault,



Beili                    Expires August 22, 2007               [Page 78]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          efmCuPmeConfigInitFailure,
          efmCuPmeProtocolInitFailure
   --       efmCuPmeDeviceFault,
   --       efmCuPmeLocalPowerLoss
        }
        STATUS      current
        DESCRIPTION
          "This group supports notifications of significant conditions
          associated with EFMCu ports."
        ::= { efmCuGroups 6 }

      efmCuPme2BProfileGroup OBJECT-GROUP
        OBJECTS {
          efmCuPme2BProfileDescr,
          efmCuPme2BRegion,
          efmCuPme2BsMode,
          efmCuPme2BMinDataRate,
          efmCuPme2BMaxDataRate,
          efmCuPme2BPower,
          efmCuPme2BConstellation,
          efmCuPme2BProfileRowStatus,
          efmCuPme2BsModeDescr,
          efmCuPme2BsModeRowStatus,
          efmCuPme2BEquivalentLength,
          efmCuPme2BMaxDataRatePam16,
          efmCuPme2BMaxDataRatePam32,
          efmCuPme2BReachRateRowStatus
        }
        STATUS      current
        DESCRIPTION
          "A collection of objects that constitute a configuration
          profile for configuration of 2BASE-TL ports."
        ::= { efmCuGroups 7}

      efmCuPme10PProfileGroup OBJECT-GROUP
        OBJECTS {
          efmCuPme10PProfileDescr,
          efmCuPme10PBandplanPSDMskProfile,
          efmCuPme10PUPBOReferenceProfile,
          efmCuPme10PBandNotchProfiles,
          efmCuPme10PPayloadURateProfile,
          efmCuPme10PPayloadDRateProfile,
          efmCuPme10PProfileRowStatus
        }
        STATUS  current
        DESCRIPTION
          "A collection of objects that constitute a configuration
          profile for configuration of 10PASS-TS ports."



Beili                    Expires August 22, 2007               [Page 79]

Internet-Draft            EFMCu Interfaces MIB             February 2007


        ::= { efmCuGroups 8 }

      efmCuPme10PStatusGroup OBJECT-GROUP
        OBJECTS {
          efmCuPme10PFECCorrectedBlocks,
          efmCuPme10PFECUncorrectedBlocks
        }
        STATUS  current
        DESCRIPTION
          "A collection of objects providing status information
          specific to 10PASS-TS PMEs."
        ::= { efmCuGroups 9 }

     -- Compliance Statements

      efmCuCompliance MODULE-COMPLIANCE
        STATUS      current
        DESCRIPTION
          "The compliance statement for 2BASE-TL/10PASS-TS interfaces.
          Compliance with the following external compliance statements
          is REQUIRED:

          MIB Module             Compliance Statement
          ----------             --------------------
          IF-MIB                 ifCompliance3
          EtherLike-MIB          dot3Compliance2
          MAU-MIB                mauModIfCompl3

          Compliance with the following external compliance statements
          is OPTIONAL for implementations supporting PME Aggregation
          Function (PAF) with flexible cross-connect between the PCS
          and PME ports:

          MIB Module             Compliance Statement
          ----------             --------------------
          IF-INVERTED-STACK-MIB  ifInvCompliance
          IF-CAP-STACK-MIB       ifCapStackCompliance"

        MODULE  -- this module
          MANDATORY-GROUPS {
            efmCuBasicGroup,
            efmCuPmeGroup,
            efmCuAlarmConfGroup,
            efmCuNotificationGroup
          }

          GROUP       efmCuPme2BProfileGroup
          DESCRIPTION



Beili                    Expires August 22, 2007               [Page 80]

Internet-Draft            EFMCu Interfaces MIB             February 2007


            "Support for this group is only required for implementations
            supporting 2BASE-TL Phy."

          GROUP       efmCuPme10PProfileGroup
          DESCRIPTION
            "Support for this group is only required for implementations
            supporting 10PASS-TS Phy."

          GROUP       efmCuPAFGroup
          DESCRIPTION
            "Support for this group is only required for
            implementations supporting PME Aggregation Function (PAF)."

          GROUP       efmCuPAFErrorsGroup
          DESCRIPTION
            "Support for this group is OPTIONAL for implementations
            supporting PME Aggregation Function (PAF)."

          GROUP       efmCuPme10PStatusGroup
          DESCRIPTION
            "Support for this group is OPTIONAL for implementations
            supporting 10PASS-TS Phy."

          OBJECT      efmCuPmeSubTypesSupported
          SYNTAX      BITS {
            ieee2BaseTLO(0),
            ieee2BaseTLR(1),
            ieee10PassTSO(2),
            ieee10PassTSR(3)
          }
          DESCRIPTION
            "Support for all subtypes is not required. However at least
            one value SHALL be supported"

          OBJECT      efmCuPmeAdminSubType
          MIN-ACCESS  read-only
          DESCRIPTION
            "Write access is not required (needed only for PMEs
            supporting more than a single subtype, e.g.
            ieee2BaseTLO and ieee2BaseTLR or ieee10PassTSO and
            ieee10PassTSR)"

          OBJECT      efmCuTargetSnrMgn
          MIN-ACCESS  read-only
          DESCRIPTION
            "Write access is OPTIONAL. For PHYs without write access
            the target SNR margin SHALL be fixed at 5dB for 2BASE-TL
            and 6dB for 10PASS-TS."



Beili                    Expires August 22, 2007               [Page 81]

Internet-Draft            EFMCu Interfaces MIB             February 2007


          OBJECT      efmCuAdaptiveSpectra
          MIN-ACCESS  read-only
          DESCRIPTION
            "Write access is OPTIONAL. For PHYs without write access
            the default value SHOULD be false."

        ::= { efmCuCompliances 1 }
   END




7.  Security Considerations

   There is a number of managed objects defined in the EFM-CU-MIB module
   that have a MAX-ACCESS clause of read-write or read-create.  Most
   objects are writeable only when the link is Down.  Writing to these
   objects can have potentially disruptive effects on network operation,
   for example:

   o  Changing of efmCuPmeAdminSubType may lead to a potential locking
      of the link, as peer PMEs of the same sub-type cannot exchange
      handshake messages.

   o  Changing of efmCuPAFAdminState to enabled may lead to a potential
      locking of the link, if the peer Phy does not support PAF.

   o  Changing of efmCuPAFDiscoveryCode, before the discovery operation,
      may lead to a wrongful discovery, for example when two -O ports
      are connected to the same multi-PME -R port and both -O ports have
      the same Discovery register value.

   o  Changing PCS or PME configuration parameters (e.g. profile of a
      PCS or PME via efmCuAdminProfile or efmCuPmeAdminProfile) may lead
      to anything from link quality and rate degradation to a complete
      link initialization failure, as ability of an EFMCu port to
      support a particular configuration depends on the copper
      environment.

   o  Activation of a PME can cause a severe degradation of service for
      another EFMCu Phy, whose PME(s) may be affected by the cross-talk
      from the newly activated PME.

   o  Removal of a PME from an operationally 'up' EFMCu port,
      aggregating several PMEs, may cause port's rate degradation

   The user of the EFM-CU-MIB module must therefore be aware that
   support for SET operations in a non-secure environment without proper



Beili                    Expires August 22, 2007               [Page 82]

Internet-Draft            EFMCu Interfaces MIB             February 2007


   protection can have a negative effect on network operations.

   The readable objects in the EFM-CU-MIB module (i.e., those with MAX-
   ACCESS other than not-accessible) may be considered sensitive in some
   environments since, collectively, they provide information about the
   performance of network interfaces and can reveal some aspects of
   their configuration.  In particular, since EFMCu can be carried over
   Unshielded Twisted Pair (UTP) voice grade copper in a bundle with
   other pairs belonging to another operator/customer, it is
   theoretically possible to evasdrop to an EFMCu transmission simply by
   "listening" to a cross-talk from the EFMCu pairs, especially if the
   parameters of the EFMCu link in question are known.

   In such environments it is important to control also GET and NOTIFY
   access to these objects and possibly even to encrypt their values
   when sending them over the network via SNMP.

   SNMP versions prior to SNMPv3 did not include adequate security.
   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 these MIB modules.

   It is RECOMMENDED that implementers consider the security features as
   provided by the SNMPv3 framework (see [RFC3410], section 8),
   including full support for the SNMPv3 cryptographic mechanisms (for
   authentication and privacy).

   Further, deployment of SNMP versions prior to SNMPv3 is NOT
   RECOMMENDED.  Instead, it is RECOMMENDED to deploy SNMPv3 and to
   enable cryptographic security.  It is then a customer/operator
   responsibility to ensure that the SNMP entity giving access to an
   instance of these MIB modules 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.


8.  IANA Considerations

   The two new values of dot3MauType (dot3MauType2BaseTL and
   dot3MauType10PassTS) and corresponding IANAifMauTypeListBits bit
   definitions (b2BaseTL and b10PassTS), as well as the new values for
   IANAifMauMediaAvailable (availableReduced and ready) SHALL be defined
   by the IANA in the IANA-MAU-MIB module (see [I-D.ietf-hubmib-
   rfc3636bis]) before this document is published as an RFC.

   Additionally, object identifiers for efmCuMIB MODULE-IDENTITY and
   ifCapStackMIB MODULE-IDENTITY SHALL be allocated by IANA in the MIB-2



Beili                    Expires August 22, 2007               [Page 83]

Internet-Draft            EFMCu Interfaces MIB             February 2007


   sub-tree, before this document is published.


9.  Acknowledgments

   This document was produced by the IETF Ethernet Interfaces and Hub
   MIB Working Group [1], whose efforts were greatly advanced by the
   contributions of the following people (in alphabetical order):

      Bert Wijnen (Alcatel)

      Dan Romascanu (Avaya)

      Marina Popilov (Actelis)

      Mathias Riess (Infineon)

      Matt Squire (Hatteras)

      Mike Heard

      Udi Ashkenazi (Actelis)


10.  Notes to RFC Editor

   This section contains notes to the RFC Editor and should be removed
   prior to publication.

      Please replace [I-D.ietf-hubmib-efm-mib] and [I-D.ietf-hubmib-
      rfc3636bis] with actual RFC numbers if those are available at time
      of publication.


11.  References

11.1.  Normative References

   [802.3]    IEEE, "IEEE Standard for Information technology -
              Telecommunications and information exchange between
              systems - Local and metropolitan area networks - Specific
              requirements - Part 3: Carrier Sense Multiple Access with
              Collision Detection (CSMA/CD) Access Method and Physical
              Layer Specifications", IEEE Std 802.3-2005, December 2005.

   [802.3ah]  IEEE, "IEEE Standard for Information technology -
              Telecommunications and information exchange between
              systems - Local and metropolitan area networks - Specific



Beili                    Expires August 22, 2007               [Page 84]

Internet-Draft            EFMCu Interfaces MIB             February 2007


              requirements - Part 3: Carrier Sense Multiple Access with
              Collision Detection (CSMA/CD) Access Method and Physical
              Layer Specifications - Amendment: Media Access Control
              Parameters, Physical Layers and Management Parameters for
              Subscriber Access Networks", IEEE Std 802.3ah-2004,
              September 2004.

   [I-D.ietf-hubmib-rfc3636bis]
              Beili, E., "Definitions of Managed Objects for IEEE 802.3
              Medium Attachment Units (MAUs)",
              draft-ietf-hubmib-rfc3636bis-05 (work in progress),
              July 2006.

   [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
              Requirement Levels", BCP 14, RFC 2119, March 1997.

   [RFC2578]  McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
              McCloghrie, K., 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.,
              McCloghrie, K., Rose, M., and S. Waldbusser, "Textual
              Conventions for SMIv2", STD 58, RFC 2579, April 1999.

   [RFC2580]  McCloghrie, K., Perkins, D., and J. Schoenwaelder,
              "Conformance Statements for SMIv2", STD 58, RFC 2580,
              April 1999.

   [RFC3410]  Case, J., Mundy, R., Partain, D., and B. Stewart,
              "Introduction and Applicability Statements for Internet-
              Standard Management Framework", RFC 3410, December 2002.

11.2.  Informative References

   [ANFP]     Network Interoperability Consultative Committee (NICC),
              "Specification of the Access Network Frequency Plan (ANFP)
              applicable to transmission systems used on the BT Access
              Network", NICC Document ND1602:2005/08, August 2005.

   [G.991.2]  ITU-T, "Single-pair High-speed Digital Subscriber Line
              (SHDSL) transceivers", ITU-T Recommendation G.991.2,
              December 2003.

   [G.993.1]  ITU-T, "Very High speed Digital Subscriber Line
              transceivers", ITU-T Recommendation G.993.1, June 2004.

   [I-D.ietf-hubmib-efm-epon-mib]



Beili                    Expires August 22, 2007               [Page 85]

Internet-Draft            EFMCu Interfaces MIB             February 2007


              Khermosh, L., "Managed Objects of EPON",
              draft-ietf-hubmib-efm-epon-mib-06 (work in progress),
              November 2006.

   [I-D.ietf-hubmib-efm-mib]
              Squire, M., "Definitions and Managed Objects for OAM
              Functions on Ethernet Like Interfaces",
              draft-ietf-hubmib-efm-mib-05 (work in progress),
              October 2006.

   [IANAifType-MIB]
              Internet Assigned Numbers Authority (IANA), "IANAifType
              Textual Convention definition",
               http://www.iana.org/assignments/ianaiftype-mib.

   [RFC2863]  McCloghrie, K. and F. Kastenholz, "The Interfaces Group
              MIB", RFC 2863, June 2000.

   [RFC2864]  McCloghrie, K. and G. Hanson, "The Inverted Stack Table
              Extension to the Interfaces Group MIB", RFC 2864,
              June 2000.

   [RFC3635]  Flick, J., "Definitions of Managed Objects for the
              Ethernet-like Interface Types", RFC 3635, September 2003.

   [RFC4070]  Dodge, M. and B. Ray, "Definitions of Managed Object
              Extensions for Very High Speed Digital Subscriber Lines
              (VDSL) Using Multiple Carrier Modulation (MCM) Line
              Coding", RFC 4070, May 2005.

   [RFC4319]  Sikes, C., Ray, B., and R. Abbi, "Definitions of Managed
              Objects for High Bit-Rate DSL - 2nd generation (HDSL2) and
              Single-Pair High-Speed Digital Subscriber Line (SHDSL)
              Lines", RFC 4319, December 2005.

URIs

   [1]  <http://www.ietf.org/html.charters/hubmib-charter.html>













Beili                    Expires August 22, 2007               [Page 86]

Internet-Draft            EFMCu Interfaces MIB             February 2007


Author's Address

   Edward Beili
   Actelis Networks
   Bazel 25
   Petach-Tikva
   Israel

   Phone: +972-3-924-3491
   Email: edward.beili <at> actelis.com









































Beili                    Expires August 22, 2007               [Page 87]

Internet-Draft            EFMCu Interfaces MIB             February 2007


Intellectual Property Statement

   The IETF takes no position regarding the validity or scope of any
   Intellectual Property Rights or other rights that might be claimed to
   pertain to the implementation or use of the technology described in
   this document or the extent to which any license under such rights
   might or might not be available; nor does it represent that it has
   made any independent effort to identify any such rights.  Information
   on the procedures with respect to rights in RFC documents can be
   found in BCP 78 and BCP 79.

   Copies of IPR disclosures made to the IETF Secretariat and any
   assurances of licenses to be made available, or the result of an
   attempt made to obtain a general license or permission for the use of
   such proprietary rights by implementers or users of this
   specification can be obtained from the IETF on-line IPR repository at
   http://www.ietf.org/ipr.

   The IETF invites any interested party to bring to its attention any
   copyrights, patents or patent applications, or other proprietary
   rights that may cover technology that may be required to implement
   this standard.  Please address the information to the IETF at
   ietf-ipr <at> ietf.org.


Disclaimer of Validity

   This document and the information contained herein are provided on an
   "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
   OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
   ENGINEERING TASK FORCE DISCLAIM 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.


Copyright Statement

   Copyright (C) The IETF Trust (2007).  This document is subject
   to the rights, licenses and restrictions contained in BCP 78, and
   except as set forth therein, the authors retain all their rights.


Acknowledgment

   Funding for the RFC Editor function is currently provided by the
   IETF Administrative Support Activity (IASA).




Beili                    Expires August 22, 2007               [Page 88]

_______________________________________________
Hubmib mailing list
Hubmib <at> ietf.org
https://www1.ietf.org/mailman/listinfo/hubmib
Wijnen, Bert (Bert | 20 Feb 2007 17:14
Favicon

RE: My review of: draft-ietf-hubmib-efm-cu-mib-06.txt

Thanks for the revision Ed,

I still have some comments though.

- Not sure if I mentioned this before. But anyway.
  I see:

      ifCapStackCompliance MODULE-COMPLIANCE
        STATUS      current
        DESCRIPTION
          "The compliance statement for SNMP entities, which provide
          information on the cross-connect capability of multi-layer
          (stacked) network interfaces, with flexible cross-connect
          between the sub-layers.
!          Compliance with the following external compliance statements
!          is REQUIRED:
!
!          MIB Module             Compliance Statement
!          ----------             --------------------
!          IF-MIB                 ifCompliance3
!          IF-INVERTED-STACK-MIB  ifInvCompliance"

        MODULE  -- this module
          MANDATORY-GROUPS {
            ifCapStackGroup
          }

          OBJECT       ifCapStackStatus
          SYNTAX       TruthValue { true(1) }
          DESCRIPTION
            "Support for the false(2) value is OPTIONAL for
            implementations supporting pluggable interfaces."

          OBJECT       ifInvCapStackStatus
          SYNTAX       TruthValue { true(1) }
          DESCRIPTION
            "Support for the false(2) value is OPTIONAL for
            implementations supporting pluggable interfaces."

        MODULE  IF-MIB
          MANDATORY-GROUPS {

            ifStackGroup2
          }

  <at>        MODULE  IF-INVERTED-STACK-MIB
  <at>          MANDATORY-GROUPS {
  <at>            ifInvStackGroup
  <at>          }

        ::= { ifCapStackCompliances 1 }

  My concerns are these:
  - I wonder if we want to keep (all) the lines that I marked with !
  - part of it is already coverd with the lines I marked with  <at> 
    So I would at least remove the line
         IF-INVERTED-STACK-MIB  ifInvCompliance
    to avoid duplication. 

  At the other hand, I could also live with what you have.

- But I do want you to fix SMICng reported error:

  E: f(rfc2864.mi2), (168,26) Item "ifStackGroup2" should be IMPORTed

  since you do list that as a mandatory group.

- see below answers from me for resolutions that I am not
  agreeing to. I removed all the items we agree on. Thanks
  for fixing or answering/explaining.

 
> > From: Wijnen, Bert (Bert)
> > [mailto:bwijnen <at> alcatel-lucent.com]
> > Sent: Thursday, January 18, 2007 21:45
> > To: Edward Beili
> > Cc: Dan Romascanu (E-mail)
> > Subject: RE: [Hubmib] My review of: 
> > draft-ietf-hubmib-efm-cu-mib-06.txt
> 
> >- Did we resolve the use of Rowstatus for the ifCapStackTable
> >  and ifInvCapStackTable? In any event, pls re-check the
> >  feedback we've got on that. I do not think that what we
> >  currently have in the MIB module is acceptable.
> 
> [EB] Replaced with TruthValue.
> 

This is much better.
I wonder if it would now be better to rename the object from
ifCapStackStatus to ifCapStackCapability to better represent
its purpose. Same for possibly renaming ifInvCapStackStatus
into ifInvCapStackCapability.

I am not hung up on it though.

> >- for 
> >     efmCuPAFDiscoveryCode  OBJECT-TYPE
> >       SYNTAX      PhysAddress
> >       MAX-ACCESS  read-write
> >       STATUS      current
> >       DESCRIPTION
> >         "PAF Discovery Code of the EFMCu port (PCS).
> >         A unique 6 Byte long code used by the Discovery function,
when
> >         PAF is supported.
> >         PCS ports incapable of supporting PAF SHALL return a value
of
> >         all zeroes. Attempts to change this object SHALL be ignored
in
> >         this case.
> >         This object MUST be instantiated for the -O subtype PCS
before
> >         writing operations on the efmCuPAFRemoteDiscoveryCode
> >         (Set_if_Clear and Clear_if_Same) are performed by PMEs
> >         associated with the PCS.
> >         The value of this object is read-only for -R port subtypes.
> >         The initial value of this object for -R ports after reset
> >         is 0. This value may be changed as a result of writing
> >         operation on efmCuPAFRemoteDiscoveryCode variable of remote
> >         PME of -O subtype, connected to one of the local PMEs
> >         associated with the PCS.
> >
> >         Discovery MUST be performed when the link is Down.
> >         Attempts to change this object MUST be rejected with the
error
> >         inconsistentValue if the link is Up or Initializing.
> >
> >         The PAF Discovery code maps to the local Discovery code
> >         variable in PAF (note that it does not have a corresponding
> >         Clause 45 register)"
> >       REFERENCE
> >         "[802.3ah] 61.2.2.8.3, 61.2.2.8.4, 45.2.6.6.1"
> >       ::= { efmCuPortConfEntry 2 }
> >
> >  I am trying to figure out what made you choose PhysAddress as the  
> > SYNTAX for the discovery code. Can you explain, or point me to  the 
> > 802.3ah clause that explains/justifies that?
> 
> [EB] The remote discovery code is defined by 802.3ah as a 
> 6-octets (48-bit) value, see 45.2.6.8. Clause 61A.2 actually 
> suggests to use a MAC address for the discovery operation, in 
> order to ensure its 'local uniqueness'.
> Since PhysAddress represents media- or physical-level 
> addresses it was a natural choice. I've added the size 
> attribute to indicate it's length. 
> 

Would it not be wise to also add 45.2.6.8 and 61A.2 in the
REFERENCE clause?

> >- For efmCuAdminProfile I read in DESCRIPTION clause:
> >
> >          This object is writable and readable for the -O subtype
> >          (2BaseTL-O or 10PassTS-O) EFMCu ports. It is unavailable
for
> >          the -R  subtype (2BaseTL-R or 10PassTS-R) ports.
> >
> >  what does it mean that this object is "unavailable"
> >  Do you not want it instatntiated in that case, or do you want  its 
> >  value to be ignored/irrelevant? Pls be specific.
> >
> >  You use that at various other places as well. Pls check and fix.
> 
> [EB] Replaced 'unavailable' with 'unsupported'
> 

But I keep wondering what that means? Does the object get instantiated
with some value that means "unsupported"? What is a SNMP SET occurs,
that one gets rejected I guess (probably with inconsistentValue for
SNMP)?
Or is the object not instantiated?
Or if read, does it return a zero-length OCTET STRING?
Oh no, that is not possible, cause the TC has a SIZE (1..6)

Maybe we need a TC EfmProfileIndexListOrNone, which allows a 
SIZE (0..6), and requries that an OBJECT of that SYNTAX specifies in
the DESCRIPTION clause what the zero length means. And in this case
it could mean "unsupported".

Similar questions/comments for other uses of "unsupported"

> >- For
> >     efmCuPAFRemoteDiscoveryCode  OBJECT-TYPE
> >       SYNTAX      PhysAddress
> >       MAX-ACCESS  read-write
> >       STATUS      current
> >       DESCRIPTION
> >         "PAF Remote Discovery Code of the PME port at CO.
> >         A 6 Byte long Discovery Code of the peer PCS connected via
> >         the PME.
> >         Reading this object results in a Discovery Get operation.
> >         Writing a zero to this object results in a Discovery
> >         Clear_if_Same operation (the value of efmCuPAFDiscoveryCode
> >         at the peer PCS SHALL be the same as efmCuPAFDiscoveryCode
of
> >         the local PCS associated with the PME for the operation to
> >         succeed).
> >         Writing a non-zero value to this object results in a
> >         Discovery Set_if_Clear operation.
> >         This object does not exist in CPE port subtypes. A zero
length
> >         octet string SHALL be returned for CPE port subtypes and
also
> >         when PAF aggregation is not enabled.
> >
> >  What is "writing a zero value" ??
> >  Is that 6 octets, all zeroes?
> >  Or one octet conatining zero,
> >  or the zero length octet-string?
> >  What means "does not exist" is it not instanctiated? I guess so.
> >  pls be clear. You do get gaps in the tables if some objects are
not 
> > instantiated. Might be easier (on NM apps) if there was a value
(like 
> > all zeros, or zerolength string) that can be ignored.
> 
> [EB] Reworded as follows:
>        This object is irrelevant in CPE port (-R) subtypes: in this
>        case a zero length octet string SHALL be returned on an
>        attempt to read this object, writing to this object SHALL
>        be ignored.

MMM... remember I do not understand what "writing to this object SHALL
be ignored" means. You had replaced "ignored" with "rejected" in other
objects. Maybe you better do that here as wel;l.

You also changed the SYNTAX from

  SYNTAX      PhysAddress

to

  SYNTAX      PhysAddress (SIZE(6))

Such was needed for INDEX objects, but not necessarily for this object.
I do find it wise though to also be specific as to what the SIZE is,
specifically since the DESCRIPTION clause does state that it is a
6-octet
value. However, that makes it invalid to state:

          A zero-length octet string SHALL be returned on an attempt to
          read this object when PAF aggregation is not enabled.

          This object is irrelevant in CPE port (-R) subtypes: in this
          case a zero length octet string SHALL be returned on an
          attempt to read this object, writing to this object SHALL
          be ignored.

Because the SYNTAX states that it CANNOT be zero length. To cover this,
you
can use a SYNTAX of:

  SYNTAX      PhysAddress (SIZE(0 | 6))

> >- For efmCuPme2BProfileRowStatus I wonder if any (all?) of the
objects
> >  in a row can be changed while the row is active? Would that not
> >  be disruptive? In any event, pls specify if any (which( objects
> >  can be changed or stat eif none can be change in active state.
> 
> [EB] I believe that 'read-create' in MAX-ACCESS clause of all 
> the objects in a row (except for the 'not-accessible' index) 
> already indicates that in order to change an object in a 
> particular profile, one would have to create a new one, 
> change the reference(s) from the old profile to a new one and 
> remove the old (inactive) profile if not needed anymore.
> 

Mmm... a MAX-ACCESS read-create does not imply that semantic.
So I would be more specific and state this somewhere. 
the DESCRIPTION clause of the RowStatus object might be a good 
place for that.

I could imagine that efmCuPme2BProfileDescr might be changed even
for an active row. At least from the DESCRIPTION clause of that
object, I do not get the impression that it controls/prescribes
operational attributes, does it?

I can see that for the other objects, they probably cannot be 
changed while the row is active and referenced. But maybe one
could put the row in notInService, changed the attributes and
use it again?

I hope I am now explaining better why I wondered (and still wonder).

In any event, this is not clear from the current definitions.
If you want to prescirbe that 
    in order to change an object in a particular profile, 
    one would have to create a new one, change the reference(s)
    from the old profile to a new one and remove the old 
    (inactive) profile if not needed anymore.

then pls be explict and put it in a DESCRIPTION clause.

> 
> >  Same question for efmCuPme2BsModeRowStatus, although there a change

> > is probably not disruptive.
> >  Pls check all occurences of RowStatus
> 
> [EB] Same answer as above.
> 
Same comment as above.

> >- I really wonder if we are doing a smart thing by give the 
> same labels
> >  to the various enums in
> >          efmCuPme10PBandplanPSDMskProfile  INTEGER,
> >          efmCuPme10PUPBOReferenceProfile   INTEGER,
> >          efmCuPme10PBandNotchProfiles      BITS,
> >          efmCuPme10PPayloadURateProfile    INTEGER,
> >          efmCuPme10PPayloadDRateProfile    INTEGER,
> >  They have different meanings, don't they? So would it not be better
> >  to differentiate between the labels of the neumerations?
> 
> [EB] If we take it to extreme why not turning all enums to TCs?
> Personally I prefer inline enums (if they are not repeated of 
> course which would make they perfectly good candidates for 
> TCs) as they list the values and their meaning in the 
> description for the object - less jumps between the object 
> and a TC when reading the MIB.
> 

As I said. I wondered if it is smart.
If no one else wonders, and thereby (implicitly, by being silent)
agrees with you. Then I am OK with what you have.

> >- With regard to naming, I am somewhat worried about the conventions
that
> >  are used (or maybe those that are not used). I always find it
smarter
> >  to have all columnar objects in a table prefixed with a string that
> >  makes it clear to which table the object belongs. For example for
> >  the efmCuPortConfTable:
> >
> >     EfmCuPortConfEntry ::=
> >       SEQUENCE {
> >         efmCuPAFAdminState               INTEGER,
> >         efmCuPAFDiscoveryCode            PhysAddress,
> >         efmCuAdminProfile                ProfileIndexList,
> >         efmCuTargetDataRate              Unsigned32,
> >         efmCuTargetSnrMgn                Unsigned32,
> >         efmCuAdaptiveSpectra             TruthValue,
> >         efmCuThreshLowRate               Unsigned32,
> >         efmCuLowRateCrossingEnable       TruthValue
> >       }
> >  
> >  I would personally prefer the columns to be alll prefixed with  
> > efmCuPortConf, so I would have named them as follows:
> >
> >     EfmCuPortConfEntry ::=
> >       SEQUENCE {
> >         efmCuPortConfPAFAdminState               INTEGER,
> >         efmCuPortConfPAFDiscoveryCode            PhysAddress,
> >         efmCuPortConfAdminProfile                ProfileIndexList,
> >         efmCuPortConfTargetDataRate              Unsigned32,
> >         efmCuPortConfTargetSnrMgn                Unsigned32,
> >         efmCuPortConfAdaptiveSpectra             TruthValue,
> >         efmCuPortConfThreshLowRate               Unsigned32,
> >         efmCuPortConfLowRateCrossingEnable       TruthValue
> >       }
> >
> >  This also holds true for most (all of) the other tables.
> >  My suggested naming convention above has (in my view) 2 advantages:
> >  
> >    - less change for conflicting names. 
> >      I will admit, that this is not too big a risk, since this is
> >      all within the same MIB module. Nevertheless, I think it just
> >      makes it easier if any additions need to be made in the future.
> >    - easier for people to see which objects belong to which tables.
> >      I think this is a strong point. But I also understand it is
> >      somewhat subjective.
> >
> >   I can accept if the WG and/or editor/author tells me that I am far
> >   too late with this type of comment. It of course requires a quite 
> >   massive editorial change. So, although I think it would improve
> >   the human-friendlyness of the MIB module, I will not insist on
> >   this change.
> 
> [EB] While I tend to agree with the advantages of the naming 
> scheme you proposed, I would like to ask to be forgiven and 
> leave the names as they are now, due to the following rasons:
> - It is a big change (considering also that there are at 
> least 2 experimental implementations of this draft that I know of)

I know it is a big change, and so I am willing to accept what you 
have because of that.

The fact that there are 2 experimental implementations is somewhat
of a bad argument. They should (in order to avoid conflicts
with whatever we finally produce as a standards track MIB module)
have taken an approach whereby:

- they have rooted the MIB module under their own enterprise OID
  tree
- renamed the MIB mdoule and all objects so they won't conflict 
  with our (soon to be) standard MIB module. Normally one then
  prefixes all object names with the company name or some such.

> - Some time ago I was asked to stick with the RFC 2578/2579 
> recommendation of 32 char restriction - the proposed change 
> would make some names to be longer than 32 chars. (Yes, I 
> just read RFC 4181 view on that - the 32 character 
> restriction recommendation of SMIv2 SHOULD be set aside in 
> favor of promoting clarity and uniqueness). However it could 
> be argued that it is easier to remember 
> efmCuLowRateCrossingEnable vs. efmCuPortConfLowRateCrossingEnable
> 

Not so strong argument, but I understand what you are saying.

So based on the "it is a BIG change and it is late in the process"
I will not require the change to be made. Hope Dan agrees as well,
and I assume that WG members also agree. 

WG members/paritcipants: Speak up if not!

> >- This table
> >     efmCuPmeStatusTable OBJECT-TYPE
> >       SYNTAX      SEQUENCE OF EfmCuPmeStatusEntry
> >       MAX-ACCESS  not-accessible
> >       STATUS      current
> >       DESCRIPTION
> >         "This table provides common status information of EFMCu
> >         2BASE-TL/10PASS-TS PME ports. Status information specific
> >         to 10PASS-TS PME is represented in efmCuPme10PStatusTable.
> >
> >         This table contains live data from the equipment. As such,
> >         it is NOT persistent."
> >       ::= { efmCuPme 3 }
> >
> >  Is cmposed of just read-only objects. So the last sentence of the  
> > DESCRIPTION clause is not needed. In general people expect 
> (I think)  
> > writable objects when they see such a ststament.
> 
> [EB] You are right. However when one is looking at the 
> description clause of a 'not-accessible' table, the only way 
> to determine if it is composed of read-only objects is to 
> check the Max access value of each and every object in the 
> table. I believe that the 'NOT persistent'
> sentence helps reader to understand the nature of a table 
> quicker, so I would leave it as is.
> 

Mmmm... also read-write objects can be NON-persistent (volatile).
So I do not follow your logic ??

I believe I still see other objects that are read-write or read-create
and for which it is not clear what the persistency behaviour is 
supposed to be. Can you pls check and make sure that that is specified
for all writable objects. If the behaviour is the same for all
objects in a row, you can describe it in the xxxEntry DESCRITPION
clause for that row.

Bert
Wijnen, Bert (Bert | 20 Feb 2007 17:21
Favicon

RE: New things for the EFM-CU-MIB

Edward and WG participants.

This question has bee out on the mailing list for quite a while.
Edward already asked for opinions on this back on Dec 7th in a
posting to this mailing list. Since then we've had a couple of
answers that indicate they rather see the current work completed.

So I am inclined to tell the WG that we stick to what we have in
the current draft and do no new additions. I'll give the WG till
the end of this week to speak up more on this topic. If I do not
see more support for Edwards suggested changes, then we'll not
undertake them now.

Bert Wijnen
speaking as HUBMIB WG chair.

> -----Original Message-----
> From: Edward Beili [mailto:EdwardB <at> actelis.com] 
> Sent: maandag 19 februari 2007 13:10
> To: hubmib <at> ietf.org
> Cc: Wijnen, Bert (Bert); Romascanu, Dan (Dan); Matt Squire
> Subject: RE: [Hubmib] New things for the EFM-CU-MIB
> 
> Dear Hubmib group members,
> 
> I would like to hear your opinion on the proposed additions 
> to the EFM-CU-MIB specified in my original mail below.
> 
> Regards,
> -E.
> 
> 
> > -----Original Message-----
> > From: Romascanu, Dan (Dan) [mailto:dromasca <at> avaya.com]
> > Sent: Monday, December 11, 2006 16:22
> > To: Edward Beili; hubmib <at> ietf.org
> > Cc: Wijnen, Bert (Bert)
> > Subject: RE: [Hubmib] New things for the EFM-CU-MIB
> > 
> > I believe that the WG should focus on completing the 
> current charter 
> > before discussing about any new work 'stemming from ... 
> latest RFPs', 
> > otherwise it risks to run forever trying to catch with the 
> permanently 
> > moving target of the Ethernet technology.
> > 
> > Dan
> > 
> > -----Original Message-----
> > From: Matt Squire [mailto:MSquire <at> HatterasNetworks.com]
> > Sent: Friday, December 08, 2006 2:53
> > To: Edward Beili; hubmib <at> ietf.org
> > Cc: Wijnen, Bert (Bert); Dan Romascanu (E-mail)
> > Subject: RE: [Hubmib] New things for the EFM-CU-MIB
> > 
> > Hi Ed -
> > 
> > The second two seem useful.  The first one doesn't seem 
> that useful as 
> > it is easily derived from other entries.  In general, I'm not a big 
> > fan of adding 2nd level data (e.g.
> > stuff derived from other stuff).  
> > 
> > My 2 cents. 
> > 
> > - Matt
> > 
> > > -----Original Message-----
> > > From: Edward Beili [mailto:EdwardB <at> actelis.com]
> > > Sent: Friday, December 08, 2006 12:41 AM
> > > To: hubmib <at> ietf.org
> > > Cc: Wijnen, Bert (Bert); Romascanu, Dan (Dan)
> > > Subject: [Hubmib] New things for the EFM-CU-MIB
> > > 
> > > Hi,
> > > 
> > > I would like to propose a few minor modifications to the 
> EFM-CU-MIB, 
> > > to provide support for some carrier requirements for the Ethernet 
> > > over copper, stemming from some latest RFPs.
> > > 
> > > 1. Add a new leaf to efmCuPortStatusTable, showing the equivalent 
> > > length of the bonded link, which would be calculated as a 
> median of 
> > > all the efmCuPmeEquivalentLength in the link.
> > > 
> > > 2. Add an optional ability to specify Min and Max noise margin 
> > > (probably in efmCuPortConfEntry), which would allow one 
> to configure 
> > > the working SNR range for the lines in the bonded link, that is:
> > > - if the SNR Margin on the copper pair in the bonded link
> > > (efmCuPmeSnrMgn) goes below specified Min margin, the pair should 
> > > re-train to achieve higher SNR margin than the Min (e.g.
> > > efmCuTargetSnrMgn)
> > > - if the SNR Margin on the copper pair goes above specified Max 
> > > margin, the pair should/could lower its transmitted power (e.g. 
> > > using Power Back-off if efmCuAdaptiveSpectra is true).
> > > 
> > > 3. Add an ability to specify Min Power Back-off, to allow an 
> > > operator to limit the signal transmit power to a lower level than 
> > > that allowed by the spectral limitations placed by the 
> > > efmCuPme2BRegion and efmCuPme2BsMode.
> > > 
> > > I would appreciate your comments.
> > > 
> > > Regards,
> > > -E. 
> 
> 
Wijnen, Bert (Bert | 21 Feb 2007 15:51
Favicon

RE: My review of: draft-ietf-hubmib-efm-cu-mib-06.txt

Looks good now. One thing (I should have seen yesterday too)
is that you need to move a few informative refrences to 
the normative references and vice versa

- I think RFC3410 is informative (it is also an informational
  RFC).

- RFC2863 and RFC2864 are normative, because we IMPORT from those.

- Since we use them in REFERENCE clauses or we use profiles
  from (as listed in DESCRIPTION clauses), I think that also
  ANFP< but certainly 991.2 and 992.1 are normative, no?

- Since we state:
   3.4.  Relation to Ethernet-Like and MAU MIB modules

   The implementation of EtherLike-MIB [RFC3635] and MAU-MIB
   [I-D.ietf-hubmib-rfc3636bis] is REQUIRED for the EFMCu interfaces.

  We probably also better make RFC3635 a normative ref.

With that I think we would be ready.

Further, I would like to react to a few of Ed's rebuttals:

> > - But I do want you to fix SMICng reported error:
> > 
> >   E: f(rfc2864.mi2), (168,26) Item "ifStackGroup2" should be
IMPORTed
> >   
> >   since you do list that as a mandatory group.
> 
> [EB] ifStackGroup2 is already imported, I've fixed that in 
> the version I sent before.
> 

My appology, the error is in RFC2864, not in the EFM-CU-MIB.

> > > >- Did we resolve the use of Rowstatus for the ifCapStackTable
> > > >  and ifInvCapStackTable? In any event, pls re-check the
> > > >  feedback we've got on that. I do not think that what we
> > > >  currently have in the MIB module is acceptable.
> > > 
> > > [EB] Replaced with TruthValue.
> > 
> > This is much better.
> > I wonder if it would now be better to rename the object from 
> > ifCapStackStatus to ifCapStackCapability to better represent its 
> > purpose. Same for possibly renaming ifInvCapStackStatus into 
> > ifInvCapStackCapability.
> > 
> > I am not hung up on it though.
> 
> [EB] ifCapStack already stands for "Interface Capability 
> Stack" - appending "Capability" would make it "Interface 
> Capability Stack Capability". How about: ifCapStackAbility ?
> Or we can leave it ifCapStackStatus, to emphasize its 
> similarity with IfStackTable
> 

Your argument for consistency with ifCapStackStatus makes sense.
And as I said, I am not hung up on it.
So I am OK now.

> [EB] I've found only one table without the persistency definition
> (efmCuPme10PStatusTable) and corrected it - now all tables 
> contain the persistency behavior definition in the 
> DESCRIPTION clause for the table.
> Basically only the Status tables are non-persistent.
> Would that be satisfactory?
> 

Yep.

I think we made good progress.

Pls correct the references (as stated at the top of this email)
and then you can submit to internet-drafts as far as I am
concenrned.

Next step is then (another) W Last Call to givbe anyone a chance
to look at the latest changes.

Bert
Matt Squire | 21 Feb 2007 17:16
Favicon

draft-ietf-hubmib-efm-oam-06


A new (and hopefully final) revision to the EFM OAM MIB Internet Draft
has been submitted. 

The changes to the document reflect comments issued during last call.
Comments were received by the following individuals:
  Bert Wijnen
  Dan Romascanu
  Eric Gray
  Sean Turner
Thanks to these and all other reviewers in the process. 

The changes were pretty editorial, but some of main comments addressed
were as follows:

* Added a DEFVAL to dot3OamErrFrameWindow, dot3OamErrFrameThreshold,
dot3OamErrFrameEvNotifEnable, dot3OamErrFrameSecsSummaryWindow,
dot3OamErrFrameSecsSummaryThreshold,
dot3OamErrFrameSecsEvNotifEnable, dot3OamDyingGaspEnable,
dot3OamCriticalEventEnable

* Changed OUI object name from Dot3Oui to EightOTwoOui in order to make
it more correct hopefully useable by other MIBs in the future.  The OUI
is really an 802 concept, not an 802.3 concept.  

* Updated boilerplate with newer IETF Trust wording.

* Added and corrected some issues with references in that some normative
references ones weren't appearing normative.  References were added to
the IMPORT section of the MIB so that all normative references were
actually used in the document.  

Excruciating details are included below, but those are the highlights.  

- Matt

************************************************
************************************************
************************************************
************************************************

Many other (tens) of editorial items (misspellings, typos, minor wording
improvements, etc.) were also addressed.  Details below. Responses
indicated with "MBS>>".    

=============================================================
=============================================================

Comments from Dan, Feb-07-2007

1. The header of the document should include: 'Intended Status -
Proposed Standard'

MBS>>>
Replaced the header line:
                    Ethernet OAM MIB              October 2006
with:
Intended Status - Proposed Standard               February 2007

2. References problems:

- Unused Reference: 'RFC2586' is defined on line 2715, but not
referenced
    '[RFC2586]   Bierman, A., McCloghrie, K., Presuhn, R., "Textual
Convent...'
MBS>> CHANGED TO 2856

  - Unused Reference: 'RFC3636' is defined on line 2738, but not
referenced
    '[RFC3636]   Flick, J., "Definitions of Managed Objects for IEEE
802.3...'
MBS>> 

  * Downref: Informational Normative Reference: RFC 2586 - this is
actually a typo (should be 2856) combined with another unused references

Now, at least part of these unused references is caused by the fact that
the MIB module does not list (commented) the RFC where the imported TCs
originate. This should be Normative References

Also, I would suggest to replace [RFC3636] with the update draft, which
was already approved by the IESG and is in RFC Editor Queue

MBS>> I fixed the reference 2586.  Note that I don't actually
reference 3636 anywhere, so I removed that from the references.
Added references to MIB module when importing from other MIBs.  

3. It would be good to run again the latest version of idnits. There are
more complaints about the boilerplate and about pages exceeding the
maximal allowed number of lines per page.

MBS>> Done. Nothing major found (though it still spits out concerns
related to spacing and IP addresses which are not appropriate).  

4. Section 3: 

   Although Ethernet access
   deployments were the primary motivation for the task force activity,
   the results of the task force are not strictly limited to that
   application.  

Maybe we can be even more explicit here by adding:

'For example Ethernet OAM could be implemented on Ethernet links that
are not necessarily EFM.'

MBS>> Addressed

5. Something seems to be missing in the following phrase in Section 3.4:

'OAMPDUs are the mechanism two
   directly connected Ethernet interfaces exchange OAM information. '

MBS>> Changed to "OAMPDUs are the mechanism by which two directly 
connected Ethernet interfaces exchange OAM information."

6. Section 4.1 - would be better to avoid saying 'SNMP MIB Modules' in
the title as MIB modules can be used with another protocol than SNMP

MBS>> Removed SNMP from title of 4.1

7. Update hubmib chair name and contact information

MBS>> Done, put in Bert's email (no phone).  

8. dot3OamPeerVendorInfo - I may be wrong, but the reference points to
table 57-11 in the IEEE specification and the 32-bit information there
is not other but the SMI Enterprise Number. If I am correct we may want
to mention this in the DESCRIPTION

MBS>> After side conversations with commenters, changed the description
field of this to reflect that the semantics are unknown and up to the
vendor, and that this field simply reflects what was received.  Included
an example that it could be used for a product or product family
identifier.   

9. Why is not DEFVAL used to specify the default values of read-write or
read-create objects wherever they are fixed - dot3OamErrFrameWindow,
dot3OamErrFrameThreshold, dot3OamErrFrameEvNotifEnable,
dot3OamErrFrameSecsSummaryWindow, dot3OamErrFrameSecsSummaryThreshold,
dot3OamErrFrameSecsEvNotifEnable, dot3OamDyingGaspEnable,
dot3OamCriticalEventEnable

MBS>> Probably because nobody pointed it out before...  Added defval
for all of the above consistent with the text in the description
section.   

10. The Abstract section contains a reference - this should be avoideda

MBS>> Removed

11. According to the naming convention in RFC 4181 the name of the
Dot3Oui TC should be Dot3oamOui. Now one may argue that this TC is not
Dot3-OAM specific, but then it is not Dot3 specific either. If we
already infringe the naming convention let us use a more generic name
(maybe just Oui or EightOTwoOui that would encourage the TC to be
imported by other MIB modules. 

MBS>> Good point - changed to EightOTwoOui.  

=============================================================
=============================================================

>From Bert Jan-18-2007

Wow... this one dropped through the cracks.
And nobody warned me. Oh well..

I see (I means smicng tells me) an INDEX object:
      dot3OamEventLogIndex       OBJECT-TYPE
        SYNTAX      Unsigned32 
that would need a range.
I assume that zero is not an intended value, so I would do:
      dot3OamEventLogIndex       OBJECT-TYPE
        SYNTAX      Unsigned32(1..4294967295)

MBS>> Added range. 

I also see that you have mad a few "editorial" changes
- a few occurences of "possibility" into "possiblity".
  The latter is nota real word, is it?
- "multiplexer" into "mulitplexor" ??
- "identifying" into "identifiying" ??

MBS>> Fixed 3 occurences of possiblity, 1 occurence of mulitplexer, 1
occurence of identifiying. 

Anyway, the latter can be fixed by RFC editor, and the INDEX fix (if
that is acceptable) can be done with a note-to-rfc-editor by Dan, or we
can see it as a first IETF Last Call Comments.

I don't think we need to respin a new version for this.
(However, if you do plan a new rev, then pls be aware you  need new
copy-right text, as I posted to the list last week).

MBS>> updated copyright with IETF Trust as per RFC4748. 

=============================================================
=============================================================

>From Sean Turner Feb-14-2007

- Sec 3.4: 1st sentence is missing a )
MBS>> Fixed.

- Sec 6: I'd probably add an RFC EDITOR note to update the copyright
notice to 2007.  It's right before the 1st RFC Editor note.
MBS>> Addressed the copy right notice issue re RFC 4748. 

- Sec 6 dot3OamAdminState OBJECT-TYPE: Description says disabled(1) it
should be disabled(2) to match the syntax.
MBS>>> Fixed.  

- Sec 6 dot3OamPeerEntry OBJECT-TYPE: Description last line:"(4). or"
should be "(4), or" 
MBS>> Fixed. 

=============================================================
=============================================================

>From Eric Feb-11-2007

Summary:
=======

Comments:
========

Weird formatting of section headers takes some getting used to.
Weird formatting of the reference section makes it difficult to
find specific references (especially if using a paper copy).

MBS>> Fixed reference section and section headers.  

___________________________________________________________________

As a purely structural comment, the text immediately preceding 
section 3.1 should either say something about section 3.4, or it 
should not say anything about sections 3.1 - 3.3.  Alternatively,
you might consider re-structuring section 3 (e.g. - 3.1.1, 3.1.2,
3.1.3 and 3.2).

MBS>> Mentioned content/purpose of 3.4.  
___________________________________________________________________

In the description text on page 10 (second paragraph), you have
the following text (without quotation marks):

     "[802.3-2005] refers to:
              IEEE Std 802.3-2002:"

I belive the second line should read (without quotation marks) - 

             "IEEE Std 802.3-2005:" 

This looks like a cut-and-paste error.

MBS>> Fixed.  
___________________________________________________________________

In the 1st line of the paragraph at the bottom of page 21, 
"looopback" should be "loopback" (there is an extra "o" in 
the current version).

MBS>> Fixed mulitple occurences of looopback.  

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Questions:
=========

>From section 3 (Overview - paraphrased):
Three functional objectives (of OAM):

    Remote fault indication  
    Link monitoring 
    Remote loopback

Is this a general observation about OAM, or does it affect the 
way that the MIB objects and tables are laid out?

MBS>> Intent is a general statement about OAM.  Did not make any
changes.  
___________________________________________________________________

At the top of page 13, should "At initialization and failure ..."
be "At initialization and recovery ..."?

MBS>> Didn't make any changes as it seemed ok either way.  
___________________________________________________________________

In section 7, Security Considerations, you include the following
statement:

"Unlike SNMP, IEEE P802.3ah OAM does not include encryption or 
 authorization mechanisms."

Should "authorization" be "authentication"?

MBS>> Yes it should, changed. 
___________________________________________________________________

On page 53, 3rd line, you say:

"information available obtainable via OAM ..."

Is the phrase "available obtainable" supposed to mean something,
or should one, or the other, of the two words be omitted?

MBS>>  Redundant wording, removed obtainable. 
__________________________________________________________________

In the 2nd paragraph of page 53, the 2nd sentence starts with
"Even if ..." and includes the phrase "..., even then, ..." -
what conditions does the 2nd use of "even" apply to (or is it 
used for additional emphasis)?

I had some difficulty in parsing this sentence, but it may be
that I was trying to read something that isn't there...

MBS>> No changes made (see Bert's response)

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Results from running idnits (non verbose)
==========================================

idnits 2.01.1 

tmp/draft-ietf-hubmib-efm-mib-05.txt:

  Checking boilerplate required by RFC 3978 and 3979, updated by RFC
4748:
  * This document has an original RFC 3978 Section 5.4 Copyright Line,
    instead of the newer IETF Trust Copyright according to RFC 4748.
  * This document has an original RFC 3978 Section 5.5 Disclaimer,
instead of
    the newer disclaimer which includes the IETF Trust according to RFC
4748.

MBS>> Added IETF trust stuff. 
Wijnen, Bert (Bert | 21 Feb 2007 17:22
Favicon

RE: draft-ietf-hubmib-efm-oam-06

Thanks Matt.
Indeed I think that this is the final revision so we can then
get Dan to put it on IESG Agenda.

Anyway, if anyone has comments on the below, pls let us know asap.
Also, when the new rev shows up (later today or tomorrow), pls do
check and speak up if you see any concerns.

I have carefully reviewed the latest changes that Matt made (before
he did send it to internet-drafts) and I am happy and confident that
all changes are OK.

Bert Wijnen
HUBMIB WG chair

> -----Original Message-----
> From: Matt Squire [mailto:MSquire <at> HatterasNetworks.com] 
> Sent: woensdag 21 februari 2007 17:17
> To: hubmib <at> ietf.org
> Subject: [Hubmib] draft-ietf-hubmib-efm-oam-06
> 
> 
> A new (and hopefully final) revision to the EFM OAM MIB 
> Internet Draft has been submitted. 
> 
> The changes to the document reflect comments issued during last call.
> Comments were received by the following individuals:
>   Bert Wijnen
>   Dan Romascanu
>   Eric Gray
>   Sean Turner
> Thanks to these and all other reviewers in the process. 
> 
> The changes were pretty editorial, but some of main comments 
> addressed were as follows:
> 
> * Added a DEFVAL to dot3OamErrFrameWindow, 
> dot3OamErrFrameThreshold, dot3OamErrFrameEvNotifEnable, 
> dot3OamErrFrameSecsSummaryWindow, dot3OamErrFrameSecsSummaryThreshold,
> dot3OamErrFrameSecsEvNotifEnable, dot3OamDyingGaspEnable, 
> dot3OamCriticalEventEnable
> 
> * Changed OUI object name from Dot3Oui to EightOTwoOui in 
> order to make it more correct hopefully useable by other MIBs 
> in the future.  The OUI is really an 802 concept, not an 
> 802.3 concept.  
> 
> * Updated boilerplate with newer IETF Trust wording.
> 
> * Added and corrected some issues with references in that 
> some normative references ones weren't appearing normative.  
> References were added to the IMPORT section of the MIB so 
> that all normative references were actually used in the document.  
> 
> Excruciating details are included below, but those are the 
> highlights.  
> 
> - Matt
> 
> 
> 
> 
> ************************************************
> ************************************************
> ************************************************
> ************************************************
> 
> 
> 
> 
> Many other (tens) of editorial items (misspellings, typos, 
> minor wording improvements, etc.) were also addressed.  
> Details below. Responses
> indicated with "MBS>>".    
> 
> 
> =============================================================
> =============================================================
> 
> Comments from Dan, Feb-07-2007
> 
> 1. The header of the document should include: 'Intended 
> Status - Proposed Standard'
> 
> MBS>>>
> Replaced the header line:
>                     Ethernet OAM MIB              October 2006
> with:
> Intended Status - Proposed Standard               February 2007
> 
> 
> 
> 
> 2. References problems:
> 
> - Unused Reference: 'RFC2586' is defined on line 2715, but 
> not referenced
>     '[RFC2586]   Bierman, A., McCloghrie, K., Presuhn, R., "Textual
> Convent...'
> MBS>> CHANGED TO 2856
> 
>   - Unused Reference: 'RFC3636' is defined on line 2738, but 
> not referenced
>     '[RFC3636]   Flick, J., "Definitions of Managed Objects for IEEE
> 802.3...'
> MBS>> 
> 
>   * Downref: Informational Normative Reference: RFC 2586 - 
> this is actually a typo (should be 2856) combined with 
> another unused references
> 
> Now, at least part of these unused references is caused by 
> the fact that the MIB module does not list (commented) the 
> RFC where the imported TCs originate. This should be 
> Normative References
> 
> Also, I would suggest to replace [RFC3636] with the update 
> draft, which was already approved by the IESG and is in RFC 
> Editor Queue
> 
> MBS>> I fixed the reference 2586.  Note that I don't actually
> reference 3636 anywhere, so I removed that from the references.
> Added references to MIB module when importing from other MIBs.  
> 
> 
> 
> 3. It would be good to run again the latest version of 
> idnits. There are more complaints about the boilerplate and 
> about pages exceeding the maximal allowed number of lines per page.
> 
> MBS>> Done. Nothing major found (though it still spits out concerns
> related to spacing and IP addresses which are not appropriate).  
> 
> 
> 
> 4. Section 3: 
> 
>    Although Ethernet access
>    deployments were the primary motivation for the task force 
> activity,
>    the results of the task force are not strictly limited to that
>    application.  
> 
> Maybe we can be even more explicit here by adding:
> 
> 'For example Ethernet OAM could be implemented on Ethernet 
> links that are not necessarily EFM.'
> 
> MBS>> Addressed
> 
> 
> 
> 5. Something seems to be missing in the following phrase in 
> Section 3.4:
> 
> 'OAMPDUs are the mechanism two
>    directly connected Ethernet interfaces exchange OAM information. '
> 
> MBS>> Changed to "OAMPDUs are the mechanism by which two directly
> connected Ethernet interfaces exchange OAM information."
> 
> 
> 
> 6. Section 4.1 - would be better to avoid saying 'SNMP MIB Modules' in
> the title as MIB modules can be used with another protocol than SNMP
> 
> MBS>> Removed SNMP from title of 4.1
> 
> 
> 
> 7. Update hubmib chair name and contact information
> 
> MBS>> Done, put in Bert's email (no phone).  
> 
> 
> 
> 8. dot3OamPeerVendorInfo - I may be wrong, but the reference points to
> table 57-11 in the IEEE specification and the 32-bit information there
> is not other but the SMI Enterprise Number. If I am correct 
> we may want
> to mention this in the DESCRIPTION
> 
> MBS>> After side conversations with commenters, changed the 
> description
> field of this to reflect that the semantics are unknown and up to the
> vendor, and that this field simply reflects what was 
> received.  Included
> an example that it could be used for a product or product family
> identifier.   
> 
> 
> 
> 9. Why is not DEFVAL used to specify the default values of 
> read-write or
> read-create objects wherever they are fixed - dot3OamErrFrameWindow,
> dot3OamErrFrameThreshold, dot3OamErrFrameEvNotifEnable,
> dot3OamErrFrameSecsSummaryWindow, dot3OamErrFrameSecsSummaryThreshold,
> dot3OamErrFrameSecsEvNotifEnable, dot3OamDyingGaspEnable,
> dot3OamCriticalEventEnable
> 
> MBS>> Probably because nobody pointed it out before...  Added defval
> for all of the above consistent with the text in the description
> section.   
> 
> 
> 
> 10. The Abstract section contains a reference - this should 
> be avoideda
> 
> MBS>> Removed
> 
> 
> 
> 11. According to the naming convention in RFC 4181 the name of the
> Dot3Oui TC should be Dot3oamOui. Now one may argue that this TC is not
> Dot3-OAM specific, but then it is not Dot3 specific either. If we
> already infringe the naming convention let us use a more generic name
> (maybe just Oui or EightOTwoOui that would encourage the TC to be
> imported by other MIB modules. 
> 
> MBS>> Good point - changed to EightOTwoOui.  
> 
> 
> 
> =============================================================
> =============================================================
> 
> >From Bert Jan-18-2007
> 
> Wow... this one dropped through the cracks.
> And nobody warned me. Oh well..
> 
> I see (I means smicng tells me) an INDEX object:
>       dot3OamEventLogIndex       OBJECT-TYPE
>         SYNTAX      Unsigned32 
> that would need a range.
> I assume that zero is not an intended value, so I would do:
>       dot3OamEventLogIndex       OBJECT-TYPE
>         SYNTAX      Unsigned32(1..4294967295)
> 
> MBS>> Added range. 
> 
> I also see that you have mad a few "editorial" changes
> - a few occurences of "possibility" into "possiblity".
>   The latter is nota real word, is it?
> - "multiplexer" into "mulitplexor" ??
> - "identifying" into "identifiying" ??
> 
> MBS>> Fixed 3 occurences of possiblity, 1 occurence of mulitplexer, 1
> occurence of identifiying. 
> 
> 
> Anyway, the latter can be fixed by RFC editor, and the INDEX fix (if
> that is acceptable) can be done with a note-to-rfc-editor by 
> Dan, or we
> can see it as a first IETF Last Call Comments.
> 
> I don't think we need to respin a new version for this.
> (However, if you do plan a new rev, then pls be aware you  need new
> copy-right text, as I posted to the list last week).
> 
> MBS>> updated copyright with IETF Trust as per RFC4748. 
> 
> 
> =============================================================
> =============================================================
> 
> >From Sean Turner Feb-14-2007
> 
> - Sec 3.4: 1st sentence is missing a )
> MBS>> Fixed.
> 
> - Sec 6: I'd probably add an RFC EDITOR note to update the copyright
> notice to 2007.  It's right before the 1st RFC Editor note.
> MBS>> Addressed the copy right notice issue re RFC 4748. 
> 
> - Sec 6 dot3OamAdminState OBJECT-TYPE: Description says disabled(1) it
> should be disabled(2) to match the syntax.
> MBS>>> Fixed.  
> 
> - Sec 6 dot3OamPeerEntry OBJECT-TYPE: Description last line:"(4). or"
> should be "(4), or" 
> MBS>> Fixed. 
> 
> 
> =============================================================
> =============================================================
> 
> >From Eric Feb-11-2007
> 
> 
> Summary:
> =======
> 
> 
> Comments:
> ========
> 
> Weird formatting of section headers takes some getting used to.
> Weird formatting of the reference section makes it difficult to
> find specific references (especially if using a paper copy).
> 
> MBS>> Fixed reference section and section headers.  
> 
> ___________________________________________________________________
> 
> As a purely structural comment, the text immediately preceding 
> section 3.1 should either say something about section 3.4, or it 
> should not say anything about sections 3.1 - 3.3.  Alternatively,
> you might consider re-structuring section 3 (e.g. - 3.1.1, 3.1.2,
> 3.1.3 and 3.2).
> 
> MBS>> Mentioned content/purpose of 3.4.  
> ___________________________________________________________________
> 
> In the description text on page 10 (second paragraph), you have
> the following text (without quotation marks):
> 
>      "[802.3-2005] refers to:
>               IEEE Std 802.3-2002:"
> 
> I belive the second line should read (without quotation marks) - 
> 
>              "IEEE Std 802.3-2005:" 
> 
> This looks like a cut-and-paste error.
> 
> MBS>> Fixed.  
> ___________________________________________________________________
> 
> In the 1st line of the paragraph at the bottom of page 21, 
> "looopback" should be "loopback" (there is an extra "o" in 
> the current version).
> 
> MBS>> Fixed mulitple occurences of looopback.  
> 
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Questions:
> =========
> 
> >From section 3 (Overview - paraphrased):
> Three functional objectives (of OAM):
> 
>     Remote fault indication  
>     Link monitoring 
>     Remote loopback
> 
> Is this a general observation about OAM, or does it affect the 
> way that the MIB objects and tables are laid out?
> 
> MBS>> Intent is a general statement about OAM.  Did not make any
> changes.  
> ___________________________________________________________________
> 
> At the top of page 13, should "At initialization and failure ..."
> be "At initialization and recovery ..."?
> 
> MBS>> Didn't make any changes as it seemed ok either way.  
> ___________________________________________________________________
> 
> In section 7, Security Considerations, you include the following
> statement:
> 
> "Unlike SNMP, IEEE P802.3ah OAM does not include encryption or 
>  authorization mechanisms."
> 
> Should "authorization" be "authentication"?
> 
> MBS>> Yes it should, changed. 
> ___________________________________________________________________
> 
> On page 53, 3rd line, you say:
> 
> "information available obtainable via OAM ..."
> 
> Is the phrase "available obtainable" supposed to mean something,
> or should one, or the other, of the two words be omitted?
> 
> MBS>>  Redundant wording, removed obtainable. 
> __________________________________________________________________
> 
> In the 2nd paragraph of page 53, the 2nd sentence starts with
> "Even if ..." and includes the phrase "..., even then, ..." -
> what conditions does the 2nd use of "even" apply to (or is it 
> used for additional emphasis)?
> 
> I had some difficulty in parsing this sentence, but it may be
> that I was trying to read something that isn't there...
> 
> MBS>> No changes made (see Bert's response)
> 
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Results from running idnits (non verbose)
> ==========================================
> 
> idnits 2.01.1 
> 
> tmp/draft-ietf-hubmib-efm-mib-05.txt:
> 
>   Checking boilerplate required by RFC 3978 and 3979, updated by RFC
> 4748:
>   * This document has an original RFC 3978 Section 5.4 Copyright Line,
>     instead of the newer IETF Trust Copyright according to RFC 4748.
>   * This document has an original RFC 3978 Section 5.5 Disclaimer,
> instead of
>     the newer disclaimer which includes the IETF Trust 
> according to RFC
> 4748.
> 
> MBS>> Added IETF trust stuff. 
> 
> 
> 
> 
> _______________________________________________
> Hubmib mailing list
> Hubmib <at> ietf.org
> https://www1.ietf.org/mailman/listinfo/hubmib
> 

Gmane