Table of Contents

Overview

• A captive portal is a landing GUI page to users before they gain broader access to gateway services.
• To configure Wi-Fi SSID, credentials

• On fresh boot-up and factory-reset, Captive Portal prompts to change the default ssid name and password for browsing a any http url's on connected client's through Gateway network

• Can be accessed by both LAN and WAN

  Panel
  LAN   :  http://10.0.0.1 WAN  :  http://<WAN IP Address of device>:8080

...

Code Flow

1) The below diagram depicts the captive portal flow via CcspPandM module.

Image Added

2) The below diagram depicts the captive portal flow via CcspWifiAgent module.

Image Added

Objects

Dmcli command to enable captive portal

$ dmcli eRT setv Device.DeviceInfo.X_RDKCENTRAL-COM_CaptivePortalEnable bool true

$ dmcli eRT setv Device.DeviceInfo.X_RDKCENTRAL-COM_ConfigureWiFi bool true

• If "Device.DeviceInfo.X_RDKCENTRAL-COM_CaptivePortalEnable“ is set to False , WebUI should be UP instead of captiveportal.

• If "Device.DeviceInfo.X_RDKCENTRAL-COM_CaptivePortalEnable" is set to True , Captive Portal should be UP instead of WebUI.

Supported Languages

• Currently the supported languages are “English” , “French”
• The default language is “eng”

Image Added

• The default language will be obtained as a string through “Device.DeviceInfo.X_RDKCENTRAL-COM_Syndication.RDKB_UIBranding.DefaultLanguage".

TroubleShooting

• During any captive portal issues, verify the below commands

1. cat  /nvram/syscfg.db | grep redirect
2.  cat  /nvram/syscfg.db | grep 10.0.0.1
3.  cat  /nvram/syscfg.db | grep PartnerID
4.  ifconfig erouter0 , brlan0
5.  dmcli eRT getv Device.DeviceInfo.X_RDKCENTRAL-COM_ConfigureWiFi
6.  dmcli eRT getv  Device.DeviceInfo.X_RDKCENTRAL-COM_CaptivePortalEnable
7. ps | grep lighttpd // Lighttpd process should be running
8. /nvram/hostapd0.conf
9. cat  /nvram/.partner_ID