Skip to end of metadata
Go to start of metadata

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

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


  • No labels

6 Comments

  1. Hello,

    I try the command: 

    dmcli eRT setv Device.Ethernet.X_RDKCENTRAL-COM_WAN.Enabled bool True

    to enable ethwan and I get this error : CCSP_ERR_INVALID_PARAMETER_VALUE (9007).


    Can someone help me please.
    1. Hi Mohamed Habib Mallek 

      On which platform are you trying out this command? What is the output of 'getv' for the same command ?

  2. Hi Narayanaswamy Ramaiyer 

    About the platform:

    1/ Output of uname -a: Linux RaspberryPi-Gateway 4.14.68 #1 SMP Fri Dec 25 CET 2020 arm7l GNU/Linux.

    2/ Output of cat /etc/os-release:

    ID=rdk

    NAME=RDK (A Yocto Project based Distro)

    VERSION=2.0 (morty)

    VERSION_ID=2.0

    PRETTY_NAME=RDK (A Yocto Project based Distro) 2.0 (morty)


     the output of 'getv' for the same command:

    Device.Ethernet.X_RDKCENTRAL-COM_WAN.Enabled

    type:        bool,     value: false




    Thanks Ramaiyer 

    1. Hi Mohamed Habib Mallek 


      Thanks for the update. We see the getv value is 'False' for you . Could you please share us the output of below command too?

      syscfg get eth_wan_enabled

      Thanks,
      Swamy

  3. Hi Narayanaswamy Ramaiyer 

    Output of: syscfg get eth_wan_enabled is empty.


    Output of : ps | grep 'ethwan' is:

    227 root             6:26 /usr/ccsp/gw_prov_ethwan



    Thanks.

  4. Hi Mohamed Habib Mallek ,


    EthWan in RDKB is a protected feature, could you try to enable the  flag "ENABLE_ETH_WAN" for rpi ( using CFLGAS_append ) and then check please.


    Thank you.