Overview

• A captive portal is a landing GUI page to users , when connected to the device WiFi for the first time,  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 on connected client's through Gateway network

  WAN  :  http://<WAN IP Address of device>:8080/captiveportal.php

  
  

  
  

Code Flow

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

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

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”

• 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