EthWAN

Created on June 21, 2022

Introduction

  • EthWAN provides the functionality to enable wan side connection through Ethernet port.
  • The functionality is being used in deployments with ONU and Gateways.
  • It can co-exist with DOCSIS, so that the WAN source can switch between EthWAN or DOCSIS
  • If syndication partners want to deploy Comcast gateway and Wi-Fi solution for customers who have fiber connection, they will require this EthWAN feature.
  • In other words this feature allows our syndication partners to offer service to their fiber customers.
Differences between Docsis and EthWAN
EthWANDocsis
GwProvApp-EthWan is used for EthWan
configuration
GwProvApp is used for Docsis configuration
Default CR device profile used is cr-ethwandeviceprofile.xmlThere is a dependency on CM agent.
parodus2ccsp, xsmart ,ccsp LM lite and
webpa are not having dependencies on CM
agent
DML is used to verify in which MODE the box is
currently operating
WEBPA & Reverse SSH is working over WAN
MAC assigned to ifconfig erouter0 interface
The Device is using CM MAC as defined in
hardware system
XB6 Ethernet Port 1 must not be available
for LAN side connections
Ethernet Port 1 must be usable for LAN side client
connectivity
The Cable Modem is not active and there is
no active CM IP address
Cable Modem is active and there is active CM IP
Address
JTNDZGl2JTIwY2xhc3MlM0QlMjJ0YWJsZS13cmFwJTIyJTNFJTNDdGFibGUlMjBjbGFzcyUzRCUyMndyYXBwZWQlMjBjb25mbHVlbmNlVGFibGUlMjIlM0UlM0Njb2xncm91cCUzRSUzQ2NvbCUyRiUzRSUzQ2NvbCUyRiUzRSUzQyUyRmNvbGdyb3VwJTNFJTNDdGJvZHklM0UlM0N0ciUzRSUzQ3RoJTIwY2xhc3MlM0QlMjJjb25mbHVlbmNlVGglMjIlM0VFdGhXQU4lM0MlMkZ0aCUzRSUzQ3RoJTIwY2xhc3MlM0QlMjJjb25mbHVlbmNlVGglMjIlM0VEb2NzaXMlM0MlMkZ0aCUzRSUzQyUyRnRyJTNFJTNDdHIlM0UlM0N0ZCUyMGNsYXNzJTNEJTIyY29uZmx1ZW5jZVRkJTIyJTNFR3dQcm92QXBwLUV0aFdhbiUyMGlzJTIwdXNlZCUyMGZvciUyMEV0aFdhbiUzQ2JyJTJGJTNFY29uZmlndXJhdGlvbiUzQyUyRnRkJTNFJTNDdGQlMjBjbGFzcyUzRCUyMmNvbmZsdWVuY2VUZCUyMiUzRUd3UHJvdkFwcCUyMGlzJTIwdXNlZCUyMGZvciUyMERvY3NpcyUyMGNvbmZpZ3VyYXRpb24lM0MlMkZ0ZCUzRSUzQyUyRnRyJTNFJTNDdHIlM0UlM0N0ZCUyMGNsYXNzJTNEJTIyY29uZmx1ZW5jZVRkJTIyJTNFRGVmYXVsdCUyMENSJTIwZGV2aWNlJTIwcHJvZmlsZSUyMHVzZWQlMjBpcyUyMGNyLWV0aHdhbmRldmljZXByb2ZpbGUueG1sJTNDJTJGdGQlM0UlM0N0ZCUyMGNsYXNzJTNEJTIyY29uZmx1ZW5jZVRkJTIyJTNFVGhlcmUlMjBpcyUyMGElMjBkZXBlbmRlbmN5JTIwb24lMjBDTSUyMGFnZW50LiUzQyUyRnRkJTNFJTNDJTJGdHIlM0UlM0N0ciUzRSUzQ3RkJTIwY2xhc3MlM0QlMjJjb25mbHVlbmNlVGQlMjIlM0VwYXJvZHVzMmNjc3AlMkMlMjB4c21hcnQlMjAlMkNjY3NwJTIwTE0lMjBsaXRlJTIwYW5kJTNDYnIlMkYlM0V3ZWJwYSUyMGFyZSUyMG5vdCUyMGhhdmluZyUyMGRlcGVuZGVuY2llcyUyMG9uJTIwQ00lM0NiciUyRiUzRWFnZW50JTNDJTJGdGQlM0UlM0N0ZCUyMGNsYXNzJTNEJTIyY29uZmx1ZW5jZVRkJTIyJTNFRE1MJTIwaXMlMjB1c2VkJTIwdG8lMjB2ZXJpZnklMjBpbiUyMHdoaWNoJTIwTU9ERSUyMHRoZSUyMGJveCUyMGlzJTNDYnIlMkYlM0VjdXJyZW50bHklMjBvcGVyYXRpbmclM0MlMkZ0ZCUzRSUzQyUyRnRyJTNFJTNDdHIlM0UlM0N0ZCUyMGNsYXNzJTNEJTIyY29uZmx1ZW5jZVRkJTIyJTNFV0VCUEElMjAlMjZhbXAlM0IlMjBSZXZlcnNlJTIwU1NIJTIwaXMlMjB3b3JraW5nJTIwb3ZlciUyMFdBTiUzQ2JyJTJGJTNFTUFDJTIwYXNzaWduZWQlMjB0byUyMGlmY29uZmlnJTIwZXJvdXRlcjAlMjBpbnRlcmZhY2UlM0MlMkZ0ZCUzRSUzQ3RkJTIwY2xhc3MlM0QlMjJjb25mbHVlbmNlVGQlMjIlM0VUaGUlMjBEZXZpY2UlMjBpcyUyMHVzaW5nJTIwQ00lMjBNQUMlMjBhcyUyMGRlZmluZWQlMjBpbiUzQ2JyJTJGJTNFaGFyZHdhcmUlMjBzeXN0ZW0lM0MlMkZ0ZCUzRSUzQyUyRnRyJTNFJTNDdHIlM0UlM0N0ZCUyMGNvbHNwYW4lM0QlMjIxJTIyJTIwY2xhc3MlM0QlMjJjb25mbHVlbmNlVGQlMjIlM0VYQjYlMjBFdGhlcm5ldCUyMFBvcnQlMjAxJTIwbXVzdCUyMG5vdCUyMGJlJTIwYXZhaWxhYmxlJTNDYnIlMkYlM0Vmb3IlMjBMQU4lMjBzaWRlJTIwY29ubmVjdGlvbnMlM0MlMkZ0ZCUzRSUzQ3RkJTIwY29sc3BhbiUzRCUyMjElMjIlMjBjbGFzcyUzRCUyMmNvbmZsdWVuY2VUZCUyMiUzRUV0aGVybmV0JTIwUG9ydCUyMDElMjBtdXN0JTIwYmUlMjB1c2FibGUlMjBmb3IlMjBMQU4lMjBzaWRlJTIwY2xpZW50JTNDYnIlMkYlM0Vjb25uZWN0aXZpdHklM0MlMkZ0ZCUzRSUzQyUyRnRyJTNFJTNDdHIlM0UlM0N0ZCUyMGNvbHNwYW4lM0QlMjIxJTIyJTIwY2xhc3MlM0QlMjJjb25mbHVlbmNlVGQlMjIlM0VUaGUlMjBDYWJsZSUyME1vZGVtJTIwaXMlMjBub3QlMjBhY3RpdmUlMjBhbmQlMjB0aGVyZSUyMGlzJTNDYnIlMkYlM0VubyUyMGFjdGl2ZSUyMENNJTIwSVAlMjBhZGRyZXNzJTNDJTJGdGQlM0UlM0N0ZCUyMGNvbHNwYW4lM0QlMjIxJTIyJTIwY2xhc3MlM0QlMjJjb25mbHVlbmNlVGQlMjIlM0VDYWJsZSUyME1vZGVtJTIwaXMlMjBhY3RpdmUlMjBhbmQlMjB0aGVyZSUyMGlzJTIwYWN0aXZlJTIwQ00lMjBJUCUzQ2JyJTJGJTNFQWRkcmVzcyUzQyUyRnRkJTNFJTNDJTJGdHIlM0UlM0MlMkZ0Ym9keSUzRSUzQyUyRnRhYmxlJTNFJTNDJTJGZGl2JTNF
EthWANDocsis
GwProvApp-EthWan is used for EthWan
configuration
GwProvApp is used for Docsis configuration
Default CR device profile used is cr-ethwandeviceprofile.xmlThere is a dependency on CM agent.
parodus2ccsp, xsmart ,ccsp LM lite and
webpa are not having dependencies on CM
agent
DML is used to verify in which MODE the box is
currently operating
WEBPA & Reverse SSH is working over WAN
MAC assigned to ifconfig erouter0 interface
The Device is using CM MAC as defined in
hardware system
XB6 Ethernet Port 1 must not be available
for LAN side connections
Ethernet Port 1 must be usable for LAN side client
connectivity
The Cable Modem is not active and there is
no active CM IP address
Cable Modem is active and there is active CM IP
Address
JTNDdGFibGUlMjBjbGFzcyUzRCUyMndyYXBwZWQlMjBjb25mbHVlbmNlVGFibGUlMjIlM0UlM0Njb2xncm91cCUzRSUzQ2NvbCUyMCUyRiUzRSUzQ2NvbCUyMCUyRiUzRSUzQyUyRmNvbGdyb3VwJTNFJTNDdGJvZHklM0UlM0N0ciUzRSUzQ3RoJTIwY2xhc3MlM0QlMjJjb25mbHVlbmNlVGglMjIlM0VFdGhXQU4lM0MlMkZ0aCUzRSUzQ3RoJTIwY2xhc3MlM0QlMjJjb25mbHVlbmNlVGglMjIlM0VEb2NzaXMlM0MlMkZ0aCUzRSUzQyUyRnRyJTNFJTNDdHIlM0UlM0N0ZCUyMGNsYXNzJTNEJTIyY29uZmx1ZW5jZVRkJTIyJTNFR3dQcm92QXBwLUV0aFdhbiUyMGlzJTIwdXNlZCUyMGZvciUyMEV0aFdhbiUzQ2JyJTIwJTJGJTNFY29uZmlndXJhdGlvbiUzQyUyRnRkJTNFJTNDdGQlMjBjbGFzcyUzRCUyMmNvbmZsdWVuY2VUZCUyMiUzRUd3UHJvdkFwcCUyMGlzJTIwdXNlZCUyMGZvciUyMERvY3NpcyUyMGNvbmZpZ3VyYXRpb24lM0MlMkZ0ZCUzRSUzQyUyRnRyJTNFJTNDdHIlM0UlM0N0ZCUyMGNsYXNzJTNEJTIyY29uZmx1ZW5jZVRkJTIyJTNFRGVmYXVsdCUyMENSJTIwZGV2aWNlJTIwcHJvZmlsZSUyMHVzZWQlMjBpcyUyMGNyLWV0aHdhbmRldmljZXByb2ZpbGUueG1sJTNDJTJGdGQlM0UlM0N0ZCUyMGNsYXNzJTNEJTIyY29uZmx1ZW5jZVRkJTIyJTNFVGhlcmUlMjBpcyUyMGElMjBkZXBlbmRlbmN5JTIwb24lMjBDTSUyMGFnZW50LiUzQyUyRnRkJTNFJTNDJTJGdHIlM0UlM0N0ciUzRSUzQ3RkJTIwY2xhc3MlM0QlMjJjb25mbHVlbmNlVGQlMjIlM0VwYXJvZHVzMmNjc3AlMkMlMjB4c21hcnQlMjAlMkNjY3NwJTIwTE0lMjBsaXRlJTIwYW5kJTNDYnIlMjAlMkYlM0V3ZWJwYSUyMGFyZSUyMG5vdCUyMGhhdmluZyUyMGRlcGVuZGVuY2llcyUyMG9uJTIwQ00lM0NiciUyMCUyRiUzRWFnZW50JTNDJTJGdGQlM0UlM0N0ZCUyMGNsYXNzJTNEJTIyY29uZmx1ZW5jZVRkJTIyJTNFRE1MJTIwaXMlMjB1c2VkJTIwdG8lMjB2ZXJpZnklMjBpbiUyMHdoaWNoJTIwTU9ERSUyMHRoZSUyMGJveCUyMGlzJTNDYnIlMjAlMkYlM0VjdXJyZW50bHklMjBvcGVyYXRpbmclM0MlMkZ0ZCUzRSUzQyUyRnRyJTNFJTNDdHIlM0UlM0N0ZCUyMGNsYXNzJTNEJTIyY29uZmx1ZW5jZVRkJTIyJTNFV0VCUEElMjAlMjZhbXAlM0IlMjBSZXZlcnNlJTIwU1NIJTIwaXMlMjB3b3JraW5nJTIwb3ZlciUyMFdBTiUzQ2JyJTIwJTJGJTNFTUFDJTIwYXNzaWduZWQlMjB0byUyMGlmY29uZmlnJTIwZXJvdXRlcjAlMjBpbnRlcmZhY2UlM0MlMkZ0ZCUzRSUzQ3RkJTIwY2xhc3MlM0QlMjJjb25mbHVlbmNlVGQlMjIlM0VUaGUlMjBEZXZpY2UlMjBpcyUyMHVzaW5nJTIwQ00lMjBNQUMlMjBhcyUyMGRlZmluZWQlMjBpbiUzQ2JyJTIwJTJGJTNFaGFyZHdhcmUlMjBzeXN0ZW0lM0MlMkZ0ZCUzRSUzQyUyRnRyJTNFJTNDdHIlM0UlM0N0ZCUyMGNvbHNwYW4lM0QlMjIxJTIyJTIwY2xhc3MlM0QlMjJjb25mbHVlbmNlVGQlMjIlM0VYQjYlMjBFdGhlcm5ldCUyMFBvcnQlMjAxJTIwbXVzdCUyMG5vdCUyMGJlJTIwYXZhaWxhYmxlJTNDYnIlMjAlMkYlM0Vmb3IlMjBMQU4lMjBzaWRlJTIwY29ubmVjdGlvbnMlM0MlMkZ0ZCUzRSUzQ3RkJTIwY29sc3BhbiUzRCUyMjElMjIlMjBjbGFzcyUzRCUyMmNvbmZsdWVuY2VUZCUyMiUzRUV0aGVybmV0JTIwUG9ydCUyMDElMjBtdXN0JTIwYmUlMjB1c2FibGUlMjBmb3IlMjBMQU4lMjBzaWRlJTIwY2xpZW50JTNDYnIlMjAlMkYlM0Vjb25uZWN0aXZpdHklM0MlMkZ0ZCUzRSUzQyUyRnRyJTNFJTNDdHIlM0UlM0N0ZCUyMGNvbHNwYW4lM0QlMjIxJTIyJTIwY2xhc3MlM0QlMjJjb25mbHVlbmNlVGQlMjIlM0VUaGUlMjBDYWJsZSUyME1vZGVtJTIwaXMlMjBub3QlMjBhY3RpdmUlMjBhbmQlMjB0aGVyZSUyMGlzJTNDYnIlMjAlMkYlM0VubyUyMGFjdGl2ZSUyMENNJTIwSVAlMjBhZGRyZXNzJTNDJTJGdGQlM0UlM0N0ZCUyMGNvbHNwYW4lM0QlMjIxJTIyJTIwY2xhc3MlM0QlMjJjb25mbHVlbmNlVGQlMjIlM0VDYWJsZSUyME1vZGVtJTIwaXMlMjBhY3RpdmUlMjBhbmQlMjB0aGVyZSUyMGlzJTIwYWN0aXZlJTIwQ00lMjBJUCUzQ2JyJTIwJTJGJTNFQWRkcmVzcyUzQyUyRnRkJTNFJTNDJTJGdHIlM0UlM0MlMkZ0Ym9keSUzRSUzQyUyRnRhYmxlJTNF

Architecture

  • Once enabled in device all internet data traffic including voice and device management will be done through Ethernet Port of the device.
  • In Ethernet WAN mode device will connect to ONU (Optical Network Unit) at the customer premises, before it connects to Internet.
     Network < — > ONU < — > EthWAN 
  • Adds two new components to RDK-B
  1.  CcspEthAgent                  – Ccsp component to control EthWAN feature along with data model support
  2.  Gw-prov-app-EthWAN    – Gateway provisioning component for EthWAN


Objects

DM Description
Device.Ethernet.X_RDKCENTRALCOM_WAN.EnabledThe DML is used to ON/OFF the EthWan Feature. The
default value is OFF.
Device.Ethernet.X_RDKCENTRALCOM_WAN.PortThe DML provides the port number that is configured if
the feature is ENABLED with
Device.Ethernet.X_RDKCENTRAL-COM_WAN.Enabled
Device.DeviceInfo.X_RDKCENTRALCOM_EthernetWAN.CurrentOperationalModeThe DML is used to verify in which MODE the box is
currently operating


How to Enable EthWan

  • TR-69 Data model:
dmcli eRT setv Device.Ethernet.X_RDKCENTRAL-COM_WAN.Enabled bool True
dmcli eRT setv Device.Ethernet.X_RDKCENTRAL-COM_WAN.Port uint 0
  • WebUI:

To support manual configuration via local GUI (user side) to change configuration to Ethernet WAN or DOCSIS WAN.

Gateway> Connection > WAN Network

Code Flow

Ccsp EthAgent Dmcli Code flow

GW Prov Ethwan Code flow

APIs

Commands to get EthWAN info from hal

CommandDescription
hal_test ethwan enableEthwanTo enable EthWan
hal_test ethwan disableEthwanTo disable EthWan
hal_test ethwan GetEthWanInterfaceNameTo get the EthWan Interface name
hal_test ethwan getEthWanEnabledTo get the EthWan status (enabled or disabled)
hal_test ethwan getEthWanPortTo know which port is enabled for EthWan feature

References

 https://wiki.rdkcentral.com/courses/playcourse.action?course=90113230&capsule=3


Go To Top