CcspCMAgent
Introduction
When a cable company offers Internet access over the cable, Internet information can use the same cables. Putting both upstream and downstream data on the cable television system requires two types of equipment:
- A cable modem on the customer end
- A cable modem termination system (CMTS) at the cable provider’s end.
The CMTS takes the traffic coming in from a group of customers on a single channel and routes it to an Internet service provider (ISP) for connection to the Internet. At the head-end, the cable providers will have, or lease space for a third-party ISP to have, servers for accounting and logging, Dynamic Host Configuration Protocol (DHCP) for assigning and administering the IP addresses of all the cable system’s users, and control servers.
RDK-B was designed to support any wide area network (WAN) type e.g DOCSIS, EPON. Gateways using RDK-B may provide a DOCSIS interface, but that DOCSIS code is typically tied to a particular piece of silicon and may even be provided by that silicon vendor. And the core philosophy of RDK-B was to be hardware and WAN type independent.
To address this situation, RDK-B does not include DOCSIS. It only includes components that provide an abstraction layer software interface to third party WAN. For the DOCSIS WAN, this component is known as the Cable Modem (CM) Agent. CM Agent provides interfaces for integrating WAN interfaces with RDK-B. RDK-B is not tied to DOCSIS and may be used with any WAN interface. Other RDK-B software components can be created that provide interfaces to other WANs.
Architecture
- CM Agent is a CCSP component that exposes TR181 parameters related to CM/DOCSIS interface characteristics.
- CM agent provides info like Upstream channels, downstream channels, boot file name, DOCSIS log, etc along with CM interface details.
- Maintains a TR181 data model XML file with dbus object path as /com/cisco/spvtg/ccsp/cm
- Has a layered architecture similar to any other CCSP component
Access Layer
- Access Layer interfaces with the CCSP message bus
- Receives any set or get calls and pass them onto the DML layer to manage the data which is in the request.
Data Model Management Layer
- Maintains the parameter list specified in the Data model XML file.
- Data Model Management Layer loads all data model access APIs from the Data model XML file
- The data model implementation in shared library interfaces HAL Integration (backend) Layer by calling backend integration APIs.
CM Agent HAL Integration (backend) Layer, a.k.a, component-specific HAL
- This layer makes calls to underlying HAL functions, Linux system calls/commands, third party modules, open-source modules etc.
- This layer will be more component-specific.
Code Flow
Objects
CMAgent object in its DML layer:
Device.X_RDKCENTRAL-COM_CableModem.
Retrieving cable modem values using dmcli
CR component name is: eRT.com.cisco.spvtg.ccsp.CR
subsystem_prefix eRT.
getv from/to component( href=”http://eRT.com.cisco.spvtg.ccsp.cm” class=”external-link” rel=”nofollow”>eRT.com.cisco.spvtg.ccsp.cm): Device.X_RDKCENTRAL-COM_CableModem.
Execution succeed.
Parameter 1 name: Device.X_RDKCENTRAL-COM_CableModem.DsOfdmChanNumberOfEntries
type: uint, value: 0
Parameter 2 name: Device.X_RDKCENTRAL-COM_CableModem.UsOfdmaChanNumberOfEntries
type: uint, value: 0
Parameter 3 name: Device.X_RDKCENTRAL-COM_CableModem.StatusOfdmaNumberOfEntries
type: uint, value: 0
HAL APIs
This hardware abstraction layer (HAL) concept is used for every interface.
The CM HAL provides a well-defined software interface that cable modem software developers can use to interface to RDK-B.
cm_hal.h provides function call prototypes and structure definitions used for the RDK-Broadband CM HAL.
Git repo : https://github.com/rdkcentral/rdkb-halif-cm/blob/main/include/cm_hal.h
Some example APIs are listed below:
APIs |
---|
cm_hal_InitDB |
docsis_InitDS |
docsis_InitUS |
docsis_getCMStatus |
docsis_GetDSChannel |
docsis_GetUsStatus |
docsis_GetUSChannel |
docsis_GetDOCSISInfo |
docsis_GetNumOfActiveTxChannels |
docsis_GetNumOfActiveRxChannels |
docsis_GetErrorCodewords |
docsis_GetMddIpModeOverride |
docsis_SetMddIpModeOverride |
docsis_GetUSChannelId |
docsis_GetDownFreq |
docsis_SetStartFreq |
docsis_GetDocsisEventLogItems |
docsis_ClearDocsisEventLog |
cm_hal_GetDHCPInfo |
cm_hal_GetIPv6DHCPInfo |
cm_hal_GetCPEList |
cm_hal_GetMarket |
cm_hal_Set_HTTP_Download_Url |
cm_hal_Get_HTTP_Download_Url |
cm_hal_Set_HTTP_Download_Interface |
cm_hal_Get_HTTP_Download_Interface |
cm_hal_HTTP_Download |
cm_hal_Get_HTTP_Download_Status |
cm_hal_Reboot_Ready |
cm_hal_HTTP_Download_Reboot_Now |
cm_hal_FWupdateAndFactoryReset |
cm_hal_ReinitMac |
docsis_GetProvIpType |
docsis_GetCert |
docsis_GetCertStatus |
cm_hal_Get_CableModemResetCount |
cm_hal_Get_LocalResetCount |
cm_hal_Get_DocsisResetCount |
cm_hal_Get_ErouterResetCount |
cm_hal_HTTP_LED_Flash |
docsis_GetDsOfdmChanTable |
docsis_GetUsOfdmaChanTable |