RDK Resources
[*RDK Preferred*]
Code Management Facility
RDK Forums
[RDK Conferences]
RDK Support
Archives
Papers & Presentations Archive
This page is under development
This section summarises technical specifications for operation of Multimedia Over Coax Alliance (MoCA) devices (“nodes”) using in-home coaxial wiring for transport of multimedia content. It describes the MoCA node protocol stack and physical network model.
The MoCA system network model creates a coax network which supports communications between a convergence layer in one MoCA node to the corresponding convergence layer in another MoCA node. The protocol stack of a MoCA node is shown in Figure 1-1. The MoCA specification does not include layers above the convergence layer.
Figure 1-1: MoCA Node Protocol Stack
Typical in-home coaxial networks are configured as a branching tree topology. The point of connection to the first splitter is called the Root Node. The MoCA nodes inside the home communicate with each other by having their signals traverse across one or more splitters. The signal path transmission between two MoCA nodes is the superposition of several individual paths. Each individual signal path may have a different magnitude and delay resulting in an aggregate signal path with frequency nulls, large attenuation, and significant delay spread. The MoCA Network will operate under these channel conditions.
Figure 1-2: A Typical In-home MoCA Network
MoCA object in its DML layer:
Device.MoCA.Interface. Device.MoCA.Interface.1.Enable Device.MoCA.Interface.1.Status Device.MoCA.Interface.1.Alias Device.MoCA.Interface.1.Name Device.MoCA.Interface.1.LastChange Device.MoCA.Interface.1.LowerLayers Device.MoCA.Interface.1.Upstream Device.MoCA.Interface.1.MACAddress Device.MoCA.Interface.1.FirmwareVersion Device.MoCA.Interface.1.MaxBitRate Device.MoCA.Interface.1.MaxIngressBW Device.MoCA.Interface.1.MaxEgressBW Device.MoCA.Interface.1.HighestVersion Device.MoCA.Interface.1.CurrentVersion Device.MoCA.Interface.1.NetworkCoordinator Device.MoCA.Interface.1.NodeID Device.MoCA.Interface.1.MaxNodes Device.MoCA.Interface.1.PreferredNC Device.MoCA.Interface.1.BackupNC Device.MoCA.Interface.1.PrivacyEnabledSetting Device.MoCA.Interface.1.PrivacyEnabled Device.MoCA.Interface.1.FreqCapabilityMask Device.MoCA.Interface.1.FreqCurrentMaskSetting Device.MoCA.Interface.1.FreqCurrentMask Device.MoCA.Interface.1.CurrentOperFreq Device.MoCA.Interface.1.LastOperFreq Device.MoCA.Interface.1.KeyPassphrase Device.MoCA.Interface.1.TxPowerLimit Device.MoCA.Interface.1.PowerCntlPhyTarget Device.MoCA.Interface.1.BeaconPowerLimit Device.MoCA.Interface.1.NetworkTabooMask Device.MoCA.Interface.1.NodeTabooMask Device.MoCA.Interface.1.TxBcastRate Device.MoCA.Interface.1.TxBcastPowerReduction Device.MoCA.Interface.1.QAM256Capable Device.MoCA.Interface.1.PacketAggregationCapability Device.MoCA.Interface.1.X_CISCO_COM_Reset Device.MoCA.Interface.1.X_CISCO_COM_MixedMode Device.MoCA.Interface.1.X_CISCO_COM_ChannelScanning Device.MoCA.Interface.1.X_CISCO_COM_AutoPowerControlEnable Device.MoCA.Interface.1.X_CISCO_COM_EnableTabooBit Device.MoCA.Interface.1.X_CISCO_COM_CycleMaster Device.MoCA.Interface.1.AutoPowerControlPhyRate Device.MoCA.Interface.1.X_CISCO_COM_BestNetworkCoordinatorID Device.MoCA.Interface.1.X_CISCO_NetworkCoordinatorMACAddress Device.MoCA.Interface.1.X_CISCO_COM_ChannelScanMask Device.MoCA.Interface.1.X_CISCO_COM_NumberOfConnectedClients Device.MoCA.Interface.1.LinkUpTime Device.MoCA.Interface.1.AssociatedDeviceNumberOfEntries Device.MoCA.Interface.1.X_CISCO_COM_PeerTableNumberOfEntries Device.MoCA.Interface.1.X_RDKCENTRAL-COM_MeshTableNumberOfEntries Device.MoCA.Interface.1.Stats.BytesSent Device.MoCA.Interface.1.Stats.BytesReceived Device.MoCA.Interface.1.Stats.PacketsSent Device.MoCA.Interface.1.Stats.PacketsReceived Device.MoCA.Interface.1.Stats.ErrorsSent Device.MoCA.Interface.1.Stats.ErrorsReceived Device.MoCA.Interface.1.Stats.UnicastPacketsSent Device.MoCA.Interface.1.Stats.UnicastPacketsReceived Device.MoCA.Interface.1.Stats.DiscardPacketsSent Device.MoCA.Interface.1.Stats.DiscardPacketsReceived Device.MoCA.Interface.1.Stats.MulticastPacketsSent Device.MoCA.Interface.1.Stats.MulticastPacketsReceived Device.MoCA.Interface.1.Stats.BroadcastPacketsSent Device.MoCA.Interface.1.Stats.BroadcastPacketsReceived Device.MoCA.Interface.1.Stats.UnknownProtoPacketsReceived Device.MoCA.Interface.1.Stats.Reset Device.MoCA.Interface.1.Stats.X_CISCO_COM_ExtAggrAverageTx Device.MoCA.Interface.1.Stats.X_CISCO_COM_ExtAggrAverageRx Device.MoCA.Interface.1.Stats.X_CISCO_COM_ExtCounterTableNumberOfEntries Device.MoCA.Interface.1.Stats.X_CISCO_COM_ExtAggrCounterTableNumberOfEntries Device.MoCA.Interface.1.Stats.X_CISCO_COM_ExtAggrCounterTable.1.Tx Device.MoCA.Interface.1.Stats.X_CISCO_COM_ExtAggrCounterTable.1.Rx Device.MoCA.Interface.1.QoS.X_CISCO_COM_Enabled Device.MoCA.Interface.1.QoS.EgressNumFlows Device.MoCA.Interface.1.QoS.IngressNumFlows Device.MoCA.Interface.1.QoS.FlowStatsNumberOfEntries Device.MoCA.Interface.1.X_CISCO_COM_PeerTable.1.PeerSpeed Device.MoCA.Interface.1.X_CISCO_COM_PeerTable.2.PeerSpeed
Moca Component registers with the CR using config files and xml files.
CcspMoCA.cfg specifies the datamodel, XmlConfig file CcspMoCADM.cfg which in turn specifies DmXml TR181-MoCA.XML
CcspMoCA.cfg :
Component>
<ID>com.cisco.spvtg.ccsp.moca</ID>
<Name>com.cisco.spvtg.ccsp.moca</Name>
<Version>1</Version>
<DbusPath>/com/cisco/spvtg/ccsp/moca</DbusPath>
<DataModelXmlCfg>CcspMoCADM.cfg</DataModelXmlCfg>
</Component>
CcspMoCADM.cfg:
<DataModels>
<DmXml>TR181-MoCA.XML</DmXml>
</DataModels>
Has two modules:-
Data model south bound API(board_sbapi) calls HAL APIs which abstract hardware configuration and status fetching.
The implementation of HAL APIs depends on platform SDK because different SoC vendors have different implementations for Moca.
When dmcli command is used to get or set a value , cosa_moca_dml.c in middle_layer_src is invoked.
For eg: $ ./dmcli eRT getv "Device.MoCA.Interface.1.LinkUpTime" Component path is eRT.com.cisco.spvtg.ccsp.moca. Depending on parameter datatype (Bool/uLong/String) described in TR181-MoCA.XML, the corresponding API in ./middle_layer_src/cosa_moca_dml.c (here, Interface1_GetParamUlongValue()) is called and collects values for the query parameter from moca HAL layer through board-sbapi.
Once the system is fully initialized, set the health as Green g_pComponent_COMMON_moca->Health = CCSP_COMMON_COMPONENT_HEALTH_Green;
Have some other functions like
* ssp_cancel //to unregister component
* ssp_CcdIfGetComponentName
* ssp_CcdIfGetComponentVersion
* ssp_CcdIfGetComponentAuthor
Some example APIs are listed below:
moca_GetIfConfig / moca_SetIfConfig moca_IfGetStaticInfo moca_IfGetDynamicInfo moca_IfGetStats moca_GetNumAssociatedDevices moca_GetAssociatedDevices moca_FreqMaskToValue moca_GetMocaCPEs moca_HardwareEquipped
Retrieve value using dmcli command
$ dmcli eRT getv Device.MoCA.Interface.1.AssociatedDevice.
CR component name is: eRT.com.cisco.spvtg.ccsp.CR subsystem_prefix eRT. getv from/to component(eRT.com.cisco.spvtg.ccsp.moca): Device.MoCA.Interface.1.AssociatedDevice. Execution succeed. Parameter 1 name: Device.MoCA.Interface.1.AssociatedDevice.1.MACAddress type: string, value: 12:BF:60:2E:4F:0D Parameter 2 name: Device.MoCA.Interface.1.AssociatedDevice.1.NodeID type: uint, value: 0 Parameter 3 name: Device.MoCA.Interface.1.AssociatedDevice.1.X_CISCO_COM_RxBcastRate type: uint, value: 630 Parameter 4 name: Device.MoCA.Interface.1.AssociatedDevice.1.PreferredNC type: bool, value: false Parameter 5 name: Device.MoCA.Interface.1.AssociatedDevice.1.HighestVersion type: string, value: 20 Parameter 6 name: Device.MoCA.Interface.1.AssociatedDevice.1.PHYTxRate type: uint, value: 658 Parameter 7 name: Device.MoCA.Interface.1.AssociatedDevice.1.PHYRxRate type: uint, value: 674 Parameter 8 name: Device.MoCA.Interface.1.AssociatedDevice.1.TxPowerControlReduction type: uint, value: 30 Parameter 9 name: Device.MoCA.Interface.1.AssociatedDevice.1.RxPowerLevel type: int, value: -47 Parameter 10 name: Device.MoCA.Interface.1.AssociatedDevice.1.TxBcastRate type: uint, value: 641 Parameter 11 name: Device.MoCA.Interface.1.AssociatedDevice.1.RxBcastPowerLevel type: uint, value: 0 Parameter 12 name: Device.MoCA.Interface.1.AssociatedDevice.1.TxPackets type: uint, value: 5509 Parameter 13 name: Device.MoCA.Interface.1.AssociatedDevice.1.RxPackets type: uint, value: 20680 Parameter 14 name: Device.MoCA.Interface.1.AssociatedDevice.1.RxErroredAndMissedPackets type: uint, value: 0 Parameter 15 name: Device.MoCA.Interface.1.AssociatedDevice.1.QAM256Capable type: bool, value: true Parameter 16 name: Device.MoCA.Interface.1.AssociatedDevice.1.PacketAggregationCapability type: uint, value: 1 Parameter 17 name: Device.MoCA.Interface.1.AssociatedDevice.1.RxSNR type: uint, value: 8 Parameter 18 name: Device.MoCA.Interface.1.AssociatedDevice.1.Active type: bool, value: true Parameter 19 name: Device.MoCA.Interface.1.AssociatedDevice.1.X_CISCO_COM_NumberOfClients type: uint, value: 0 Parameter 20 name: Device.MoCA.Interface.1.AssociatedDevice.2.MACAddress type: string, value: D4:0A:A9:1B:5D:5C Parameter 21 name: Device.MoCA.Interface.1.AssociatedDevice.2.NodeID type: uint, value: 2 Parameter 22 name: Device.MoCA.Interface.1.AssociatedDevice.2.X_CISCO_COM_RxBcastRate type: uint, value: 271 Parameter 23 name: Device.MoCA.Interface.1.AssociatedDevice.2.PreferredNC type: bool, value: true Parameter 24 name: Device.MoCA.Interface.1.AssociatedDevice.2.HighestVersion type: string, value: 11 Parameter 25 name: Device.MoCA.Interface.1.AssociatedDevice.2.PHYTxRate type: uint, value: 277 Parameter 26 name: Device.MoCA.Interface.1.AssociatedDevice.2.PHYRxRate type: uint, value: 272 Parameter 27 name: Device.MoCA.Interface.1.AssociatedDevice.2.TxPowerControlReduction type: uint, value: 29 Parameter 28 name: Device.MoCA.Interface.1.AssociatedDevice.2.RxPowerLevel type: int, value: -53 Parameter 29 name: Device.MoCA.Interface.1.AssociatedDevice.2.TxBcastRate type: uint, value: 274 Parameter 30 name: Device.MoCA.Interface.1.AssociatedDevice.2.RxBcastPowerLevel type: uint, value: 0 Parameter 31 name: Device.MoCA.Interface.1.AssociatedDevice.2.TxPackets type: uint, value: 4198 Parameter 32 name: Device.MoCA.Interface.1.AssociatedDevice.2.RxPackets type: uint, value: 102237 Parameter 33 name: Device.MoCA.Interface.1.AssociatedDevice.2.RxErroredAndMissedPackets type: uint, value: 0 Parameter 34 name: Device.MoCA.Interface.1.AssociatedDevice.2.QAM256Capable type: bool, value: true Parameter 35 name: Device.MoCA.Interface.1.AssociatedDevice.2.PacketAggregationCapability type: uint, value: 1 Parameter 36 name: Device.MoCA.Interface.1.AssociatedDevice.2.RxSNR type: uint, value: 8 Parameter 37 name: Device.MoCA.Interface.1.AssociatedDevice.2.Active type: bool, value: true Parameter 38 name: Device.MoCA.Interface.1.AssociatedDevice.2.X_CISCO_COM_NumberOfClients type: uint, value: 0 Parameter 39 name: Device.MoCA.Interface.1.AssociatedDevice.3.MACAddress type: string, value: 38:5F:66:16:2C:D1 Parameter 40 name: Device.MoCA.Interface.1.AssociatedDevice.3.NodeID type: uint, value: 3 Parameter 41 name: Device.MoCA.Interface.1.AssociatedDevice.3.X_CISCO_COM_RxBcastRate type: uint, value: 629 Parameter 42 name: Device.MoCA.Interface.1.AssociatedDevice.3.PreferredNC type: bool, value: false Parameter 43 name: Device.MoCA.Interface.1.AssociatedDevice.3.HighestVersion type: string, value: 20 Parameter 44 name: Device.MoCA.Interface.1.AssociatedDevice.3.PHYTxRate type: uint, value: 684 Parameter 45 name: Device.MoCA.Interface.1.AssociatedDevice.3.PHYRxRate type: uint, value: 674 Parameter 46 name: Device.MoCA.Interface.1.AssociatedDevice.3.TxPowerControlReduction type: uint, value: 30 Parameter 47 name: Device.MoCA.Interface.1.AssociatedDevice.3.RxPowerLevel type: int, value: -50 Parameter 48 name: Device.MoCA.Interface.1.AssociatedDevice.3.TxBcastRate type: uint, value: 641 Parameter 49 name: Device.MoCA.Interface.1.AssociatedDevice.3.RxBcastPowerLevel type: uint, value: 0 Parameter 50 name: Device.MoCA.Interface.1.AssociatedDevice.3.TxPackets type: uint, value: 2081 Parameter 51 name: Device.MoCA.Interface.1.AssociatedDevice.3.RxPackets type: uint, value: 8589 Parameter 52 name: Device.MoCA.Interface.1.AssociatedDevice.3.RxErroredAndMissedPackets type: uint, value: 0 Parameter 53 name: Device.MoCA.Interface.1.AssociatedDevice.3.QAM256Capable type: bool, value: true Parameter 54 name: Device.MoCA.Interface.1.AssociatedDevice.3.PacketAggregationCapability type: uint, value: 1 Parameter 55 name: Device.MoCA.Interface.1.AssociatedDevice.3.RxSNR type: uint, value: 8 Parameter 56 name: Device.MoCA.Interface.1.AssociatedDevice.3.Active type: bool, value: true Parameter 57 name: Device.MoCA.Interface.1.AssociatedDevice.3.X_CISCO_COM_NumberOfClients type: uint, value: 0