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
EthWAN | Docsis |
---|
GwProvApp-EthWan is used for EthWan configuration | GwProvApp is used for Docsis configuration |
Default CR device profile used is cr-ethwandeviceprofile.xml | There 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
- CcspEthAgent – Ccsp component to control EthWAN feature along with data model support
- Gw-prov-app-EthWAN – Gateway provisioning component for EthWAN
eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IlotWW9nb21heWEgTWFoYXJhbmEiLCJvdXRwdXRUeXBlIjoiYmxvY2siLCJsYXN0TW9kaWZpZXJOYW1lIjoiWi1Zb2dvbWF5YSBNYWhhcmFuYSIsImxhbmd1YWdlIjoiZW4iLCJkaWFncmFtRGlzcGxheU5hbWUiOiIiLCJzRmlsZUlkIjoiIiwiYXR0SWQiOiIxNDQ5MDEwODYiLCJkaWFncmFtTmFtZSI6Ik9OVS5kcmF3aW8iLCJhc3BlY3QiOiIiLCJsaW5rcyI6ImF1dG8iLCJjZW9OYW1lIjoiRXRoV0FOIiwidGJzdHlsZSI6InRvcCIsImNhbkNvbW1lbnQiOmZhbHNlLCJkaWFncmFtVXJsIjoiIiwiY3N2RmlsZVVybCI6IiIsImJvcmRlciI6dHJ1ZSwibWF4U2NhbGUiOiIxIiwib3duaW5nUGFnZUlkIjo5MDExNDE3NywiZWRpdGFibGUiOmZhbHNlLCJjZW9JZCI6OTAxMTQxNzcsInBhZ2VJZCI6IiIsImxib3giOnRydWUsInNlcnZlckNvbmZpZyI6eyJlbWFpbHByZXZpZXciOiIxIn0sIm9kcml2ZUlkIjoiIiwicmV2aXNpb24iOjEsIm1hY3JvSWQiOiIxODg3ODNmYS1lN2FhLTRjOTAtYTQxOS04ZDY0NjFkZWNhZmIiLCJwcmV2aWV3TmFtZSI6Ik9OVS5kcmF3aW8ucG5nIiwibGljZW5zZVN0YXR1cyI6Ik9LIiwic2VydmljZSI6IiIsImlzVGVtcGxhdGUiOiIiLCJ3aWR0aCI6Im51bGwiLCJzaW1wbGVWaWV3ZXIiOmZhbHNlLCJsYXN0TW9kaWZpZWQiOjE2MTQ2OTQ1NDYwMDAsImV4Y2VlZFBhZ2VXaWR0aCI6ZmFsc2UsIm9DbGllbnRJZCI6IiJ9
Objects
DM | Description |
---|
Device.Ethernet.X_RDKCENTRALCOM_WAN.Enabled | The DML is used to ON/OFF the EthWan Feature. The default value is OFF. |
Device.Ethernet.X_RDKCENTRALCOM_WAN.Port | The 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.CurrentOperationalMode | The DML is used to verify in which MODE the box is currently operating |
How to Enable EthWan
To support manual configuration via local GUI (user side) to change configuration to Ethernet WAN or DOCSIS WAN.
Code Flow
Ccsp EthAgent Dmcli Code flow
eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IlotWW9nb21heWEgTWFoYXJhbmEiLCJvdXRwdXRUeXBlIjoiYmxvY2siLCJsYXN0TW9kaWZpZXJOYW1lIjoiWi1Zb2dvbWF5YSBNYWhhcmFuYSIsImxhbmd1YWdlIjoiZW4iLCJkaWFncmFtRGlzcGxheU5hbWUiOiIiLCJzRmlsZUlkIjoiIiwiYXR0SWQiOiIxNDQ5MDA3NjgiLCJkaWFncmFtTmFtZSI6IkNjc3AgRXRoQWdlbnQgRE1DTEkgQ29kZSBmbG93LmRyYXdpbyIsImFzcGVjdCI6IiIsImxpbmtzIjoiYXV0byIsImNlb05hbWUiOiJFdGhXQU4iLCJ0YnN0eWxlIjoidG9wIiwiY2FuQ29tbWVudCI6ZmFsc2UsImRpYWdyYW1VcmwiOiIiLCJjc3ZGaWxlVXJsIjoiIiwiYm9yZGVyIjp0cnVlLCJtYXhTY2FsZSI6IjEiLCJvd25pbmdQYWdlSWQiOjkwMTE0MTc3LCJlZGl0YWJsZSI6ZmFsc2UsImNlb0lkIjo5MDExNDE3NywicGFnZUlkIjoiIiwibGJveCI6dHJ1ZSwic2VydmVyQ29uZmlnIjp7ImVtYWlscHJldmlldyI6IjEifSwib2RyaXZlSWQiOiIiLCJyZXZpc2lvbiI6MSwibWFjcm9JZCI6ImUzMTE0YjczLWFlMzEtNDc4Yy04ZjFlLWJlNzhlNWU2YmUzMSIsInByZXZpZXdOYW1lIjoiQ2NzcCBFdGhBZ2VudCBETUNMSSBDb2RlIGZsb3cuZHJhd2lvLnBuZyIsImxpY2Vuc2VTdGF0dXMiOiJPSyIsInNlcnZpY2UiOiIiLCJpc1RlbXBsYXRlIjoiIiwid2lkdGgiOiJudWxsIiwic2ltcGxlVmlld2VyIjpmYWxzZSwibGFzdE1vZGlmaWVkIjoxNjE0Njk0NTQyMDAwLCJleGNlZWRQYWdlV2lkdGgiOmZhbHNlLCJvQ2xpZW50SWQiOiIifQ==
GW Prov Ethwan Code flow
eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IlotWW9nb21heWEgTWFoYXJhbmEiLCJvdXRwdXRUeXBlIjoiYmxvY2siLCJsYXN0TW9kaWZpZXJOYW1lIjoiWi1Zb2dvbWF5YSBNYWhhcmFuYSIsImxhbmd1YWdlIjoiZW4iLCJkaWFncmFtRGlzcGxheU5hbWUiOiIiLCJzRmlsZUlkIjoiIiwiYXR0SWQiOiIxNDQ5MDA3NjIiLCJkaWFncmFtTmFtZSI6IkdXIFByb3YgRXRod2FuIENvZGUgZmxvdy5kcmF3aW8iLCJhc3BlY3QiOiIiLCJsaW5rcyI6ImF1dG8iLCJjZW9OYW1lIjoiRXRoV0FOIiwidGJzdHlsZSI6InRvcCIsImNhbkNvbW1lbnQiOmZhbHNlLCJkaWFncmFtVXJsIjoiIiwiY3N2RmlsZVVybCI6IiIsImJvcmRlciI6dHJ1ZSwibWF4U2NhbGUiOiIxIiwib3duaW5nUGFnZUlkIjo5MDExNDE3NywiZWRpdGFibGUiOmZhbHNlLCJjZW9JZCI6OTAxMTQxNzcsInBhZ2VJZCI6IiIsImxib3giOnRydWUsInNlcnZlckNvbmZpZyI6eyJlbWFpbHByZXZpZXciOiIxIn0sIm9kcml2ZUlkIjoiIiwicmV2aXNpb24iOjEsIm1hY3JvSWQiOiJlMDhkMDRhYy05OTQzLTQ5NTgtYTc4Ni04NDYxNTE4MDg5OGMiLCJwcmV2aWV3TmFtZSI6IkdXIFByb3YgRXRod2FuIENvZGUgZmxvdy5kcmF3aW8ucG5nIiwibGljZW5zZVN0YXR1cyI6Ik9LIiwic2VydmljZSI6IiIsImlzVGVtcGxhdGUiOiIiLCJ3aWR0aCI6Im51bGwiLCJzaW1wbGVWaWV3ZXIiOmZhbHNlLCJsYXN0TW9kaWZpZWQiOjE2MTQ2OTQ1NDIwMDAsImV4Y2VlZFBhZ2VXaWR0aCI6ZmFsc2UsIm9DbGllbnRJZCI6IiJ9
APIs
Commands to get EthWAN info from hal
Command | Description |
---|
hal_test ethwan enableEthwan | To enable EthWan |
hal_test ethwan disableEthwan | To disable EthWan |
hal_test ethwan GetEthWanInterfaceName | To get the EthWan Interface name |
hal_test ethwan getEthWanEnabled | To get the EthWan status (enabled or disabled) |
hal_test ethwan getEthWanPort | To know which port is enabled for EthWan feature |
References
https://wiki.rdkcentral.com/courses/playcourse.action?course=90113230&capsule=3
12 Comments
Z-Mohamed Habib Mallek
Hello,
I try the command:
Narayanaswamy Ramaiyer
Hi Z-Mohamed Habib Mallek
On which platform are you trying out this command? What is the output of 'getv' for the same command ?
Z-Mohamed Habib Mallek
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
Narayanaswamy Ramaiyer
Hi Z-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
Z-Mohamed Habib Mallek
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.
sipra samantray
Hi Z-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.
Z-Mihir Sevak
HI sipra samantray,
even after adding ENABLE_ETH_WAN in CFLAGS in ./meta-cmf-raspberrypi/meta-rdk-broadband/recipes-ccsp/ccsp/ccsp-gwprovapp-ethwan.bbappend file and ./meta-rdk-broadband/recipes-ccsp/ccsp/ccsp-gwprovapp-ethwan.bb file I am not able to enable ETH_WAN on my raspberrypi. I am getting same error as invalid value. Can you please advise what should be correct procedure to resolve this??? By the way for me syscft get is returning true so does that mean value is set to true in configuration???
Moreover, I am under impression that by enabling this feature and changing values of WAN_PROTO and ip address etc in syscfg.db file I will be able to assign static IP addess on my WAN interface (erouter0). If I am wrong please advise.
Here is output:
root@RaspberryPi-Gateway:~# syscfg get eth_wan_enabled
true
root@RaspberryPi-Gateway:~# dmcli eRT setv Device.Ethernet.X_RDKCENTRAL-COM_WAN.Enabled bool True
CR component name is: eRT.com.cisco.spvtg.ccsp.CR
subsystem_prefix eRT.
setv from/to component(eRT.com.cisco.spvtg.ccsp.ethagent): Device.Ethernet.X_RDKCENTRAL-COM_WAN.Enabled
Execution fail(error code:CCSP_ERR_INVALID_PARAMETER_VALUE(9007)).
root@RaspberryPi-Gateway:~#
Thanks.
Have a great day.
sipra samantray
Hi Z-Mihir Sevak
Which CMF release code you are using for Rpi ? For Rpi there is only one profile which is FIXED_MODE and it is Ethwan mode.
By default the Rpi will come up with ethwan mode now. You don't have to set anything, those tr181 not required to set to ethwan mode.
Thank you.
Z-Mihir Sevak
Hi sipra samantray ,
thanks for response. I used
repo init -u https://code.rdkcentral.com/r/rdkcmf/manifests -m rdkb-extsrc.xml -b rdkb-2022q2-dunfell
to download and build image for Raspberry Pi. I also think EthWan is enabled because in syscfg.db it is true. My objective is to assign a static IP address on the WAN port. In syscfg.db there are fields like wan_proto and wan_ipaddr etc. Can you please advise what do you mean by FIXED_MODE and if that will allow me to assign a fixed IP on WAN side?? Also how do I accomplish that? What values or modules I should turn on in order to do this?Thanks.
sipra samantray
Hi Z-Mihir Sevak ,
Currently WanManager doesn't support static WAN ip. The FIXED_MODE means fixed WAN type, not multi WAN profile.
( Parameter 1 name: Device.X_RDK_WanManager.Policytype: string, value: FIXED_MODE )
Z-Mihir Sevak
Thanks sipra samantray .
Swenson Deng
Hi, does the data model support multiple logical WAN interfaces within one physical WAN port? it seems there is no instance number for WAN interace here. If I need to create more than one logical WAN interfaces, what shall I do, please advise. Many thanks.