CCAP Configuration
and Status
Mark Lynch, ARRIS
June 5, 2014
© 2014 CableLabs®. All rights reserved.
Topics







CCAP Overview
CCAP OFDM Configuration
CCAP OFDM Status
CCAP OFDMA Configuration
CCAP OFDMA Status
CCAP Miscellaneous Configuration
YANG/XML Example
Slide 2
© 2014 CableLabs®. All rights reserved.
Converged Cable Access Platform Overview
• OSSI team had a choice of extending DOCSIS 3.0 OSSI
specification directly or extending CCAP OSSI specification.
• All known vendors are implementing CCAP, not CMTS, so
CCAP was chosen.
• CCAP OSSI specification combines DOCSIS 3.0 and EQAM
configuration, performance, and fault management.
Slide 3
© 2014 CableLabs®. All rights reserved.
CCAP Overview (cont.)
Configuration Management
• Configuration model was defined first in UML, manually
translated to YANG, then converted to XSD XML schema.
• Configuration is solely via XML; there are no configuration
MIBs.
• Full and partial XML configuration files must be supported.
• Exporting configuration in an XML file must be supported.
• XML files use a small subset of the NETCONF operations
(RFC 6241): replace, merge, delete.
Slide 4
© 2014 CableLabs®. All rights reserved.
CCAP Overview (cont.)
Configuration Management
• Vendors can extend standard CCAP schema at pre-defined
extension points either in YANG or directly in the XML
schema.
• These extension points accept any XML, so the vendor XML
file still validates against the standard CCAP schema.
• Vendor-supplied schema provides normal validation of
vendor-specific XML extensions.
Slide 5
© 2014 CableLabs®. All rights reserved.
CCAP Overview (cont.)
Performance Management
•
•
•
•
CCAP performance management is still via SNMP MIBs.
Configuration status via read-only MIBs is required.
Vendors may support read/write MIBs for configuration.
New CCAP MIB provides:
– Mapping between XML indices and ifIndices
– Video input program bitrate monitoring
– Status for the ECM Decoder and ECM Generator
Slide 6
© 2014 CableLabs®. All rights reserved.
CCAP Overview (cont.)
Fault Management
• CCAP requires support of all mandatory DOCSIS OSSIv3.0 events
• CCAP requires support of additional events (CCAP Annex C):
– Configuration file errors
– Element Resource Manager (ERM) interface events
– Power events
– Redundancy events
– A few other events
Slide 7
© 2014 CableLabs®. All rights reserved.
Topics







CCAP Overview
CCAP OFDM Configuration
CCAP OFDM Status
CCAP OFDMA Configuration
CCAP OFDMA Status
CCAP Miscellaneous Configuration
YANG/XML Example
Slide 8
© 2014 CableLabs®. All rights reserved.
CCAP OFDM Configuration
OFDM Channel UML Model
Down
Channel
DsNcpExclusionCfg
Start Freq (key)
Stop Freq
DsRfPort
DsOfdmChannelCfg
LowerEdgeFreq
UpperEdgeFreq
DsOfdmExclusionCfg
Start Freq (key)
Stop Freq
DsOfdmProfileCfg
Profile ID (key)
Modulation Default
DsOfdmSubcarrierCfg
Start Freq (key)
Stop Freq
Skip
Main Modulation
Skip Modulation
Slide 9
© 2014 CableLabs®. All rights reserved.
CCAP OFDM Configuration
OFDM Channel UML Model (cont)
• DsOfdmChannelCfg
-
Index (key)
AdminState
DocsisChanId
LowerEdgeFreq
UpperEdgeFreq
PlcFreq
CyclicPrefix
RolloffPeriod
-
TimeInterleaveDepth
SubcarrierSpacing
UpDownTrapEnabled
NumPilots
SubcarrierZeroFreq
LowerGuardBandwidth
UpperGuardBandwidth
NcpModulation
Slide 10
© 2014 CableLabs®. All rights reserved.
Topics







CCAP Overview
CCAP OFDM Configuration
CCAP OFDM Status
CCAP OFDMA Configuration
CCAP OFDMA Status
CCAP Miscellaneous Configuration
YANG/XML Example
Slide 11
© 2014 CableLabs®. All rights reserved.
CCAP OFDM Status
• OFDM Profile Statistics MIB Table DsOfdmProfileStats containing
– NumCodeWordTotal
– NumEthernetFrameBytes
– NumFullCodewords
• MIB Tables containing same attributes as configuration objects:
– DsNcpExclusionCfg
– DsOfdmExclusionCfg
– DsOfdmChannelCfg
– DsOfdmProfileCfg
– DsOfdmSubcarrierCfg
Slide 12
© 2014 CableLabs®. All rights reserved.
Topics







CCAP Overview
CCAP OFDM Configuration
CCAP OFDM Status
CCAP OFDMA Configuration
CCAP OFDMA Status
CCAP Miscellaneous Configuration
YANG/XML Example
Slide 13
© 2014 CableLabs®. All rights reserved.
CCAP OFDMA Configuration
OFDMA Channel UML Model
DocsCfg
Upstream
Physical
Channel
UsRfPort
UsOfdmaChannel
LowerEdgeFreq
UpperEdgeFreq
UsOfdmaChanDataIuc
DataIuc (key)
UsOfdmaExclusionCfg
Start Freq (key)
Stop Freq
UsOfdmaMinislotCfg
LowerFreq (key)
UpperFreq
MinislotPilotPattern
MinislotModulation
UsOfdmaModulationTemplate
UsOfdmaFineRangingIuc
NumSubcarriers
Guardband
UsOfdmaDataIuc
DataIuc (key)
DefaultMod
DefaultPilotPattern
UsOfdmaInitialRangingIuc
NumSubcarriers
Guardband
Slide 14
© 2014 CableLabs®. All rights reserved.
CCAP OFDMA Configuration
OFDMA Channel UML Model (cont)
• UsOfdmaChannel
-
Index (key)
AdminState
LowerEdgeFreq
UpperEdgeFreq
UpDownTrapEnabled
ChanId
ProvAttribMask
TxBackoffStart
-
TxBackoffEnd
RangingBackoffStart
RangingBackoffEnd
AutoOfdmaTemplateCfg
TargetRxPower
UsOfdmaModTemplateId
- PreEqEnable
Slide 15
© 2014 CableLabs®. All rights reserved.
CCAP OFDMA Configuration
OFDMA Channel UML Model (cont)
• UsOfdmaModulationTemplate
– ModTemplateIndex (key)
– ModTemplateDescription
– SubcarrierSpacing
– CyclicPrefix
– RolloffPeriod
– NumSymbolsPerFrame
Slide 16
© 2014 CableLabs®. All rights reserved.
Topics







CCAP Overview
CCAP OFDM Configuration
CCAP OFDM Status
CCAP OFDMA Configuration
CCAP OFDMA Status
CCAP Miscellaneous Configuration
YANG/XML Example
Slide 17
© 2014 CableLabs®. All rights reserved.
CCAP OFDMA Status
•
•
Per template per channel statistics MIB Table UsOfdmaModTemplateStats containing
– ErrorFreeCodeWords
– FecCorrectedCodeWords
– FecUnreliableCodeWords
– TotalFecCodeWords
– MacFrames
MIB Tables containing configuration attributes:
– DsOfdmaExclusionStatus
– DsOfdmaChannelStatus
– UsOfdmaChannelIucStatus (Channel IUC, Minislot configuration)
– UsOfdmaModTemplateStatus (Mod template, Init ranging, fine ranging)
– UsOfdmaModTemplateIucStatus
Slide 18
© 2014 CableLabs®. All rights reserved.
Topics







CCAP Overview
CCAP OFDM Configuration
CCAP OFDM Status
CCAP OFDMA Configuration
CCAP OFDMA Status
CCAP Miscellaneous Configuration
YANG/XML Example
Slide 19
© 2014 CableLabs®. All rights reserved.
CCAP DOCSIS 3.1 Global Configuration
• Global DOCSIS parameters are in DocsisGlobalCfg:
– MaximumScheduledCodesEnabled*
– L2VpnGlobalEnabled*
– AqmGlobalEnable
– AqmGlobalDefaultLatencyTarget
*Part of original CCAP model
Slide 20
© 2014 CableLabs®. All rights reserved.
CCAP Mac Domain Configuration
MacCfg
DsBondingGroupCfg
MdCfg
…
AqmMdEnable
AqmMdDefaultLatencyTarget
DsOfdmChannelCfg
UsBondingGrpCfg
RccCfg
UsOfdmaChannel
RxChCfg
PrimaryDsIndicator
DocsisDownChannel
UpstreamLogicalChannel
Slide 21
© 2014 CableLabs®. All rights reserved.
HQoS Configuration
DocsCfg
IatcProfile
DocsQosCfg
Name (key)
MaxTrafficRate
ServiceFlowTrafficPriorityLow
ServiceFlowTrafficPriorityHigh
AsfQosProfile
Name (key)
AggregateTrafficRate
IatcAppId
AppId (key)
IatcScn
Scn (key)
Slide 22
© 2014 CableLabs®. All rights reserved.
Topics







CCAP Overview
CCAP OFDM Configuration
CCAP OFDM Status
CCAP OFDMA Configuration
CCAP OFDMA Status
CCAP Miscellaneous Configuration
YANG/XML Example
Slide 23
© 2014 CableLabs®. All rights reserved.
YANG US Bonding Group
list upstream-bonding-group {
key bonding-group-name;
min-elements 0;
leaf bonding-group-name { type string; }
leaf sf-provisioned-attribute-mask {
type attribute-mask-type;
default bonded;
}
list upstream-logical-channel-ref {
key "slot us-rf-port upstream-physical-channel upstream-logical-channel";
min-elements 0;
uses upstream-logical-channel-reference;
container yang-ext { ccap:extensionPoint; }
}
list ofdma-channel-ref {
key "slot us-rf-port ofdma-channel";
min-elements 0;
uses ofdma-channel-reference;
container yang-ext { ccap:extensionPoint; }
}
container yang-ext { ccap:extensionPoint;
}
Slide 24
© 2014 CableLabs®. All rights reserved.
YANG OFDMA Channel Reference
grouping ofdma-channel-reference {
leaf slot {
type leafref {
path "/ccap/chassis/slot/slot-number";
}
}
leaf us-rf-port {
type leafref {
path "/ccap/chassis/slot[slot-number=current()/../slot]/us-rf-port/port-number";
}
}
leaf ofdma-channel {
type leafref {
path "/ccap/chassis/slot[slot-number=current()/../slot]/us-rf-port[portnumber=current()/../us-rf-port]/ofdma-channel/ofdma-channel-index";
}
}
}
Slide 25
© 2014 CableLabs®. All rights reserved.
US Bonding Group XSD Schema
<xs:complexType name="ofdma-channel-ref-type">
<xs:sequence>
<xs:element name="slot" minOccurs="1" maxOccurs="1">
<xs:simpleType>
<xs:restriction base="xs:unsignedByte"> /xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="us-rf-port" minOccurs="1" maxOccurs="1">
<xs:simpleType>
<xs:restriction base="xs:unsignedInt"> </xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="ofdma-channel" minOccurs="1" maxOccurs="1">
<xs:simpleType>
<xs:restriction base="xs:unsignedShort"> </xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="yang-ext" minOccurs="0" maxOccurs="1" type="ext-type">
</xs:element>
<xs:element name="ext" type="ext-type" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
Slide 26
© 2014 CableLabs®. All rights reserved.
XSD Schema (cont)
<xs:complexType name="upstream-bonding-group-type">
<xs:sequence>
<xs:element name="bonding-group-name" minOccurs="1" maxOccurs="1"
type="xs:string"> </xs:element>
<xs:element name="sf-provisioned-attribute-mask" minOccurs="0" maxOccurs="1"
type="attribute-mask-type" default="bonded"> </xs:element>
<xs:element name="upstream-logical-channel-ref" minOccurs="0"
maxOccurs="unbounded" type="upstream-logical-channel-ref-type"> </xs:element>
<xs:element name="ofdma-channel-ref" minOccurs="0" maxOccurs="unbounded"
type="ofdma-channel-ref-type"> </xs:element>
<xs:element name="yang-ext" minOccurs="0" maxOccurs="1" type="ext-type">
</xs:element>
<xs:element name="ext" type="ext-type" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
Slide 27
© 2014 CableLabs®. All rights reserved.
XSD Schema (cont)
<xs:element name="upstream-bonding-group" minOccurs="0" maxOccurs="unbounded" type="upstreambonding-group-type">
<xs:key name="key_mac-domain_docs-mac-domain_docsis_ccap_upstream-bonding-group_upstreamlogical-channel-ref">
<xs:selector xpath="upstream-logical-channel-ref"/>
<xs:field xpath="slot"/>
<xs:field xpath="us-rf-port"/>
<xs:field xpath="upstream-physical-channel"/>
<xs:field xpath="upstream-logical-channel"/>
</xs:key>
<xs:key name="key_mac-domain_docs-mac-domain_docsis_ccap_upstream-bonding-group_ofdma-channelref">
<xs:selector xpath="ofdma-channel-ref"/>
<xs:field xpath="slot"/>
<xs:field xpath="us-rf-port"/>
<xs:field xpath="ofdma-channel"/>
</xs:key>
</xs:element>
Slide 28
© 2014 CableLabs®. All rights reserved.
US Bonding Group XML Example
<upstream-bonding-group>
<bonding-group-name>UsBondingGroup1</bonding-group-name>
<sf-provisioned-attribute-mask>bonded</sf-provisioned-attribute-mask>
<upstream-logical-channel-ref>
<slot>9</slot>
<us-rf-port>0</us-rf-port>
<upstream-physical-channel>0</upstream-physical-channel>
<upstream-logical-channel>0</upstream-logical-channel>
</upstream-logical-channel-ref>
<ofdma-channel-ref>
<slot>9</slot>
<us-rf-port>0</us-rf-port>
<ofdma-channel>0</ofdma-channel>
</ofdma-channel-ref>
</upstream-bonding-group>
Slide 29
© 2014 CableLabs®. All rights reserved.
Thank You
Slide 30
© 2014 CableLabs®. All rights reserved.