Skip to content

Latest commit

 

History

History
2090 lines (1614 loc) · 51.5 KB

NetworkManagerPlugin.md

File metadata and controls

2090 lines (1614 loc) · 51.5 KB
Raw

NetworkManager Plugin

Version: 0.2.11

A NetworkManager plugin for Thunder framework.

Table of Contents

Abbreviation, Acronyms and Terms

[Refer to this link]

Description

A Unified NetworkManager plugin that allows you to manage Ethernet and Wifi interfaces on the device.

The plugin is designed to be an out-of-process service to be handled by Thunder framework. For more information about the framework refer to [Thunder].

Configuration

The table below lists configuration options of the plugin.

Name Type Description
callsign string Plugin instance name (default: org.rdk.NetworkManager)
classname string Class name: NetworkManager
locator string Library name: libWPEFrameworkNetworkManager.so
autostart boolean Determines if the plugin shall be started automatically along with the framework

Interfaces

This plugin implements the following interfaces:

Methods

The following methods are provided by the org.rdk.NetworkManager plugin:

NetworkManager interface methods:

Method Description
GetAvailableInterfaces Get device supported list of available interface including their state
GetPrimaryInterface Gets the primary/default network interface for the device
SetPrimaryInterface Sets the primary/default interface for the device
SetInterfaceState Enable the interface
GetInterfaceState Disable the interface
GetIPSettings Gets the IP setting for the given interface
SetIPSettings Sets the IP settings for the given interface
GetStunEndpoint Get the STUN Endpoint that is used to identify public IP of the device
SetStunEndpoint Set the STUN Endpoint to be used to identify public IP of the device
GetConnectivityTestEndpoints Gets currently used test endpoints
SetConnectivityTestEndpoints This method used to set up to 5 endpoints for a connectivity test
IsConnectedToInternet Seeks Whether the device has internet connectivity
GetCaptivePortalURI Gets the captive portal URI if connected to any captive portal network
StartConnectivityMonitoring Enable a continuous monitoring of internet connectivity with heart beat interval thats given
StopConnectivityMonitoring Stops the connectivity monitoring
GetPublicIP Gets the internet/public IP Address of the device
Ping Pings the specified endpoint with the specified number of packets
Trace Traces the specified endpoint with the specified number of packets using traceroute
StartWiFiScan Initiates WiFi scaning
StopWiFiScan Stops WiFi scanning
GetKnownSSIDs Gets list of saved SSIDs
AddToKnownSSIDs Saves the SSID, passphrase, and security mode for upcoming and future sessions
RemoveKnownSSID Remove given SSID from saved SSIDs
WiFiConnect Initiates request to connect to the specified SSID with the given passphrase
WiFiDisconnect Disconnects from the currently connected SSID
GetConnectedSSID Returns the connected SSID information
StartWPS Initiates a connection using Wifi Protected Setup (WPS)
StopWPS Cancels the in-progress WPS pairing operation
GetWiFiSignalStrength Get WiFiSignalStrength of connected SSID
GetSupportedSecurityModes Returns the Wifi security modes that the device supports
SetLogLevel Set Log level for more information
GetWifiState Returns the current Wifi State

GetAvailableInterfaces method

Get device supported list of available interface including their state.

Events

No Events

Parameters

This method takes no parameters.

Result

Name Type Description
result object
result?.Interfaces array (optional) An interface
result?.Interfaces[#] object (optional)
result?.Interfaces[#].type string Interface Type
result?.Interfaces[#].name string Interface Name. ex: eth0 or wlan0
result?.Interfaces[#].mac string Interface MAC address
result?.Interfaces[#].isEnabled boolean Whether the interface is currently enabled
result?.Interfaces[#].isConnected boolean Whether the interface is currently connected
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.GetAvailableInterfaces"
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "Interfaces": [
            {
                "type": "ETHERNET",
                "name": "eth0",
                "mac": "AA:AA:AA:AA:AA:AA",
                "isEnabled": true,
                "isConnected": true
            }
        ],
        "success": true
    }
}

GetPrimaryInterface method

Gets the primary/default network interface for the device. The active network interface is defined as the one that can make requests to the external network. Returns one of the supported interfaces as per GetAvailableInterfaces, or an empty value which indicates that there is no default network interface.

Events

No Events

Parameters

This method takes no parameters.

Result

Name Type Description
result object
result.interface string An interface, such as eth0 or wlan0, depending upon availability of the given interface

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.GetPrimaryInterface"
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "interface": "wlan0"
    }
}

SetPrimaryInterface method

Sets the primary/default interface for the device. This call fails if the interface is not enabled.

Events

Event Description
onActiveInterfaceChange Triggered when device’s default interface changed.
onInterfaceStateChange Triggered when interface’s state changed
onAddressChange Triggered when the device connects to router.
onInternetStatusChange Triggered when each IP address is lost or acquired.

Parameters

Name Type Description
params object
params.interface string An interface, such as eth0 or wlan0, depending upon availability of the given interface

Result

Name Type Description
result object
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.SetPrimaryInterface",
    "params": {
        "interface": "wlan0"
    }
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "success": true
    }
}

SetInterfaceState method

Enable or Disable the specified interface.

Events

Event Description
onInterfaceStateChange Triggered when interface’s status changes to enabled or disabled.

Parameters

Name Type Description
params object
params.interface string An interface, such as eth0 or wlan0, depending upon availability of the given interface in GetAvailableInterfaces
params.enabled boolean Set the state of the interface to be Enabled or Disabled

Result

Name Type Description
result object
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.SetInterfaceState",
    "params": {
        "interface": "wlan0",
        "enabled": true
    }
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "success": true
    }
}

GetInterfaceState method

Disable the specified interface.

Events

No Events

Parameters

Name Type Description
params object
params.interface string An interface, such as eth0 or wlan0, depending upon availability of the given interface in GetAvailableInterfaces

Result

Name Type Description
result object
result.isEnabled boolean Whether the Interface is enabled or disabled
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.GetInterfaceState",
    "params": {
        "interface": "wlan0"
    }
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "isEnabled": true,
        "success": true
    }
}

GetIPSettings method

Gets the IP setting for the given interface.

Events

No Events

Parameters

Name Type Description
params object
params.interface string An interface, such as eth0 or wlan0, depending upon availability of the given interface
params?.ipversion string (optional) either IPv4 or IPv6

Result

Name Type Description
result object
result.interface string An interface, such as eth0 or wlan0, depending upon availability of the given interface
result.ipversion string either IPv4 or IPv6
result.autoconfig boolean true if DHCP is used, false if IP is configured manually
result?.dhcpserver string (optional) The DHCP Server address
result.ipaddress string The IP address
result.prefix integer The prefix number
result.gateway string The gateway address
result.v6LinkLocal string The v6LinkLocal
result.primarydns string The primary DNS address
result.secondarydns string The secondary DNS address
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.GetIPSettings",
    "params": {
        "interface": "wlan0",
        "ipversion": "IPv4"
    }
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "interface": "wlan0",
        "ipversion": "IPv4",
        "autoconfig": true,
        "dhcpserver": "192.168.1.1",
        "ipaddress": "192.168.1.101",
        "prefix": 24,
        "gateway": "192.168.1.1",
        "v6LinkLocal": "192.168.1.1",
        "primarydns": "192.168.1.1",
        "secondarydns": "192.168.1.2",
        "success": true
    }
}

SetIPSettings method

Sets the IP settings for the given interface.

Events

Event Description
onAddressChange Triggered when the device connects to router.
onInternetStatusChange Triggered when each IP address is lost or acquired.

Parameters

Name Type Description
params object
params.interface string An interface, such as eth0 or wlan0, depending upon availability of the given interface
params.ipversion string either IPv4 or IPv6
params.autoconfig boolean true if DHCP is used, false if IP is configured manually
params.ipaddress string The IP address
params.prefix integer The prefix number
params.gateway string The gateway address
params.primarydns string The primary DNS address
params.secondarydns string The secondary DNS address

Result

Name Type Description
result object
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.SetIPSettings",
    "params": {
        "interface": "wlan0",
        "ipversion": "IPv4",
        "autoconfig": true,
        "ipaddress": "192.168.1.101",
        "prefix": 24,
        "gateway": "192.168.1.1",
        "primarydns": "192.168.1.1",
        "secondarydns": "192.168.1.2"
    }
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "success": true
    }
}

GetStunEndpoint method

Get the STUN Endpoint that is used to identify public IP of the device.

Events

No Events

Parameters

This method takes no parameters.

Result

Name Type Description
result object
result.endPoint string STUN server endPoint
result.port integer STUN server port
result.bindTimeout integer STUN server bind timeout
result.cacheTimeout integer STUN server cache timeout
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.GetStunEndpoint"
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "endPoint": "stun.l.google.com",
        "port": 3478,
        "bindTimeout": 30,
        "cacheTimeout": 0,
        "success": true
    }
}

SetStunEndpoint method

Set the STUN Endpoint to be used to identify public IP of the device.

Events

No Events

Parameters

Name Type Description
params object
params.endPoint string STUN server endPoint
params.port integer STUN server port
params?.bindTimeout integer (optional) STUN server bind timeout
params?.cacheTimeout integer (optional) STUN server cache timeout

Result

Name Type Description
result object
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.SetStunEndpoint",
    "params": {
        "endPoint": "stun.l.google.com",
        "port": 3478,
        "bindTimeout": 30,
        "cacheTimeout": 0
    }
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "success": true
    }
}

GetConnectivityTestEndpoints method

Gets currently used test endpoints. on success list out the connectivity test points connections.

Events

No Events

Parameters

This method takes no parameters.

Result

Name Type Description
result object
result.endpoints array
result.endpoints[#] string
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.GetConnectivityTestEndpoints"
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "endpoints": [
            "http://clients3.google.com/generate_204"
        ],
        "success": true
    }
}

SetConnectivityTestEndpoints method

This method used to set up to 5 endpoints for a connectivity test. Successful connections are verified with HTTP Status code 204 (No Content).

Events

No Events

Parameters

Name Type Description
params object
params.endpoints array A list of endpoints to test
params.endpoints[#] string

Result

Name Type Description
result object
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.SetConnectivityTestEndpoints",
    "params": {
        "endpoints": [
            "http://clients3.google.com/generate_204"
        ]
    }
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "success": true
    }
}

IsConnectedToInternet method

Seeks Whether the device has internet connectivity. This API might take up to 3s to validate internet connectivity.

Events

No Events

Parameters

Name Type Description
params object
params.ipversion string either IPv4 or IPv6

Result

Name Type Description
result object
result.isConnectedToInternet boolean true if internet connectivity is detected, otherwise false
result.internetState integer The internet state
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.IsConnectedToInternet",
    "params": {
        "ipversion": "IPv4"
    }
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "isConnectedToInternet": true,
        "internetState": 4,
        "success": true
    }
}

GetCaptivePortalURI method

Gets the captive portal URI if connected to any captive portal network.

Events

No Events

Parameters

This method takes no parameters.

Result

Name Type Description
result object
result.uri string Captive portal URI
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.GetCaptivePortalURI"
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "uri": "http://10.0.0.1/captiveportal.jst",
        "success": true
    }
}

StartConnectivityMonitoring method

Enable a continuous monitoring of internet connectivity with heart beat interval thats given. If the monitoring is already happening, it will be restarted with new given interval.

Events

Event Description
onInternetStatusChange Triggered when internet connection state changed.

Parameters

Name Type Description
params object
params.interval number Interval in sec

Result

Name Type Description
result object
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.StartConnectivityMonitoring",
    "params": {
        "interval": 30
    }
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "success": true
    }
}

StopConnectivityMonitoring method

Stops the connectivity monitoring.

Events

No Events

Parameters

This method takes no parameters.

Result

Name Type Description
result object
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.StopConnectivityMonitoring"
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "success": true
    }
}

GetPublicIP method

Gets the internet/public IP Address of the device.

Events

No Events

Parameters

Name Type Description
params object it allows empty parameter too
params.ipversion string either IPv4 or IPv6

Result

Name Type Description
result object
result.publicIP string Returns an public ip of the device
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.GetPublicIP",
    "params": {
        "ipversion": "IPv4"
    }
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "publicIP": "69.136.49.95",
        "success": true
    }
}

Ping method

Pings the specified endpoint with the specified number of packets.

Events

No Events

Parameters

Name Type Description
params object
params.endpoint string The host name or IP address
params.ipversion string either IPv4 or IPv6
params.noOfRequest integer The number of packets to send. Default is 15
params.timeout integer Timeout
params.guid string The globally unique identifier

Result

Name Type Description
result object
result.target string The target IP address
result.packetsTransmitted integer The number of packets sent
result.packetsReceived integer The number of packets received
result.packetLoss string The number of packets lost
result.tripMin string The minimum amount of time to receive the packets
result.tripAvg string The average time to receive the packets
result.tripMax string The maximum amount of time to receive the packets
result.tripStdDev string The standard deviation for the trip
result.error string An error message
result.guid string The globally unique identifier
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.Ping",
    "params": {
        "endpoint": "45.57.221.20",
        "ipversion": "IPv4",
        "noOfRequest": 10,
        "timeout": 30,
        "guid": "..."
    }
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "target": "45.57.221.20",
        "packetsTransmitted": 10,
        "packetsReceived": 10,
        "packetLoss": "0.0",
        "tripMin": "61.264",
        "tripAvg": "130.397",
        "tripMax": "230.832",
        "tripStdDev": "80.919",
        "error": "...",
        "guid": "...",
        "success": true
    }
}

Trace method

Traces the specified endpoint with the specified number of packets using traceroute.

Events

No Events

Parameters

Name Type Description
params object
params.ipversion string (optional) The host name or IP address
params.endpoint string The host name or IP address
params.packets integer (optional) The number of packets to send. Default is 10
params.guid string (optional) The globally unique identifier

Result

Name Type Description
result object
result.target string The target IP address
result.results string The results from traceroute
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.Trace",
    "params": {
        "endpoint": "45.57.221.20",
        "packets": 10
    }
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "target": "45.57.221.20",
        "success": true,
        "results": "<<<traceroute command results>>>"
    }
}

StartWiFiScan method

Initiates WiFi scaning. This method supports scanning for specific range of frequency like 2.4GHz only or 5GHz only or 6GHz only or ALL. When no input passed about the frequency to be scanned, it scans for all. It publishes 'onAvailableSSIDs' event upon completion.

Events

Event Description
onAvailableSSIDs Triggered when list of SSIDs is available after the scan completes.

Parameters

Name Type Description
params object
params.frequency string The frequency to scan. An empty or null value scans all frequencies. If a frequency is specified (2.4 or 5.0), then the results are only returned for matching frequencies

Result

Name Type Description
result object
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.StartWiFiScan",
    "params": {
        "frequency": "..."
    }
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "success": true
    }
}

StopWiFiScan method

Stops WiFi scanning. Any discovered SSIDs from the call to the StartWiFiScan method up to the point where this method is called are still returned as event.

Events

No Events

Parameters

This method takes no parameters.

Result

Name Type Description
result object
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.StopWiFiScan"
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "success": true
    }
}

GetKnownSSIDs method

Gets list of saved SSIDs. This method returns all the SSIDs that are saved as array.

Events

No Events

Parameters

This method takes no parameters.

Result

Name Type Description
result object
result.ssids array Known SSIDS
result.ssids[#] string
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.GetKnownSSIDs"
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "ssids": [
            "Xfinity_Guest"
        ],
        "success": true
    }
}

AddToKnownSSIDs method

Saves the SSID, passphrase, and security mode for upcoming and future sessions. This method only adds to the persistent memory; does not disconnect from currently connected SSID.

Events

No Events

Parameters

Name Type Description
params object
params.ssid string The paired SSID
params.passphrase string The access point password
params.securityMode integer The security mode. See getSupportedSecurityModes

Result

Name Type Description
result object
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.AddToKnownSSIDs",
    "params": {
        "ssid": "123412341234",
        "passphrase": "password",
        "securityMode": 6
    }
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "success": true
    }
}

RemoveKnownSSID method

Remove given SSID from saved SSIDs. This method just removes from the list and of the list is having only one entry thats being removed, it will initiate a disconnect.

Events

Event Description
onWiFiStateChange Triggered when Wifi state changes to DISCONNECTED
onAddressChange Triggered when an IP Address is assigned or lost
onInternetStatusChange Triggered when internet connection state changed

Parameters

Name Type Description
params object
params.ssid string The paired SSID

Result

Name Type Description
result object
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.RemoveKnownSSID",
    "params": {
        "ssid": "123412341234"
    }
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "success": true
    }
}

WiFiConnect method

Initiates request to connect to the specified SSID with the given passphrase. Passphrase can be null when the network security is NONE. When called with no arguments, this method attempts to connect to the saved SSID and password. See AddToKnownSSIDs.

Events

Event Description
onWiFiStateChange Triggered when Wifi state changes to CONNECTING, CONNECTED .

Parameters

Name Type Description
params object
params.ssid string The paired SSID
params.passphrase string The access point password
params.securityMode integer The security mode. See getSupportedSecurityModes
params.persistSSIDInfo boolean (optional) Option to connect to SSID without persisting AccessPoint details (default: true; always persist)

Result

Name Type Description
result object
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.WiFiConnect",
    "params": {
        "ssid": "123412341234",
        "passphrase": "password",
        "securityMode": 6,
        "persistSSIDInfo": true
    }
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "success": true
    }
}

WiFiDisconnect method

Disconnects from the currently connected SSID. A event will be posted upon completion.

Events

Event Description
onWIFIStateChange Triggered when Wifi state changes to DISCONNECTED (only if currently connected).
onAddressChange Triggered when an IP Address is assigned or lost
onInternetStatusChange Triggered when internet connection state changed

Parameters

This method takes no parameters.

Result

Name Type Description
result object
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.WiFiDisconnect"
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "success": true
    }
}

GetConnectedSSID method

Returns the connected SSID information.

Events

No Events

Parameters

This method takes no parameters.

Result

Name Type Description
result object
result.ssid string The paired SSID
result.bssid string The paired BSSID
result.securityMode string The security mode. See the connect method
result.signalStrength string The RSSI value in dBm
result.frequency string The supported frequency for this SSID in GHz
result.rate string The physical data rate in Mbps
result.noise string The average noise strength in dBm
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.GetConnectedSSID"
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "ssid": "123412341234",
        "bssid": "ff:ff:ff:ff:ff:ff",
        "securityMode": "5",
        "signalStrength": "-27.000000",
        "frequency": "2.442000",
        "rate": "144.000000",
        "noise": "-121.000000",
        "success": true
    }
}

StartWPS method

Initiates a connection using Wifi Protected Setup (WPS). An existing connection will be disconnected before attempting to initiate a new connection. Failure in WPS pairing will trigger an error event.

If the method parameter is set to SERIALIZED_PIN, then RDK retrieves the serialized pin using the Manufacturer (MFR) API. If the method parameter is set to PIN, then RDK use the pin supplied as part of the request. If the method parameter is set to PBC, then RDK uses Push Button Configuration (PBC) to obtain the pin.

Events

Event Description
onWIFIStateChange Triggered when Wifi state changes to DISCONNECTED (only if currently connected), CONNECTING, CONNECTED.
onAddressChange Triggered when an IP Address is assigned or lost
onInternetStatusChange Triggered when internet connection state changed

Parameters

Name Type Description
params object
params.method integer The method used to obtain the pin (must be one of the following: PBC=0, PIN=1, SERIALIZED_PIN=2)
params.wps_pin string A valid 8 digit WPS pin number. Use this parameter when the method parameter is set to PIN

Result

Name Type Description
result object
result?.pin string (optional) The WPS pin value. Valid only when method is set to PIN or SERIALIZED_PIN
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.StartWPS",
    "params": {
        "method": 1,
        "wps_pin": "88888888"
    }
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "pin": "88888888",
        "success": true
    }
}

StopWPS method

Cancels the in-progress WPS pairing operation. The operation forcefully stops the in-progress pairing attempt and aborts the current scan. WPS pairing must be in-progress for the operation to succeed.

Events

Event Description
onWIFIStateChange Triggered when Wifi state changes to DISCONNECTED.

Parameters

This method takes no parameters.

Result

Name Type Description
result object
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.StopWPS"
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "success": true
    }
}

GetWiFiSignalStrength method

Get WiFiSignalStrength of connected SSID.

Events

Event Description
onWiFiSignalStrengthChange Triggered when Wifi signal strength switches between Excellent, Good, Fair, Weak.

Parameters

This method takes no parameters.

Result

Name Type Description
result object
result.ssid string The paired SSID
result.signalStrength string The RSSI value in dBm
result.quality integer Signal strength Quality
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.GetWiFiSignalStrength"
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "ssid": "123412341234",
        "signalStrength": "-27.000000",
        "quality": 123,
        "success": true
    }
}

GetSupportedSecurityModes method

Returns the Wifi security modes that the device supports.

Events

No Events

Parameters

This method takes no parameters.

Result

Name Type Description
result object
result.security_modes object The supported security modes and its associated integer value
result.security_modes?.NET_WIFI_SECURITY_NONE integer (optional)
result.security_modes?.NET_WIFI_SECURITY_WEP_64 integer (optional)
result.security_modes?.NET_WIFI_SECURITY_WEP_128 integer (optional)
result.security_modes?.NET_WIFI_SECURITY_WPA_PSK_TKIP integer (optional)
result.security_modes?.NET_WIFI_SECURITY_WPA_PSK_AES integer (optional)
result.security_modes?.NET_WIFI_SECURITY_WPA2_PSK_TKIP integer (optional)
result.security_modes?.NET_WIFI_SECURITY_WPA2_PSK_AES integer (optional)
result.security_modes?.NET_WIFI_SECURITY_WPA_ENTERPRISE_TKIP integer (optional)
result.security_modes?.NET_WIFI_SECURITY_WPA_ENTERPRISE_AES integer (optional)
result.security_modes?.NET_WIFI_SECURITY_WPA2_ENTERPRISE_TKIP integer (optional)
result.security_modes?.NET_WIFI_SECURITY_WPA2_ENTERPRISE_AES integer (optional)
result.security_modes?.NET_WIFI_SECURITY_WPA_WPA2_PSK integer (optional)
result.security_modes?.NET_WIFI_SECURITY_WPA_WPA2_ENTERPRISE integer (optional)
result.security_modes?.NET_WIFI_SECURITY_WPA3_PSK_AES integer (optional)
result.security_modes?.NET_WIFI_SECURITY_WPA3_SAE integer (optional)
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.GetSupportedSecurityModes"
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "security_modes": {
            "NET_WIFI_SECURITY_NONE": 0,
            "NET_WIFI_SECURITY_WEP_64": 1,
            "NET_WIFI_SECURITY_WEP_128": 2,
            "NET_WIFI_SECURITY_WPA_PSK_TKIP": 3,
            "NET_WIFI_SECURITY_WPA_PSK_AES": 4,
            "NET_WIFI_SECURITY_WPA2_PSK_TKIP": 5,
            "NET_WIFI_SECURITY_WPA2_PSK_AES": 6,
            "NET_WIFI_SECURITY_WPA_ENTERPRISE_TKIP": 7,
            "NET_WIFI_SECURITY_WPA_ENTERPRISE_AES": 8,
            "NET_WIFI_SECURITY_WPA2_ENTERPRISE_TKIP": 9,
            "NET_WIFI_SECURITY_WPA2_ENTERPRISE_AES": 10,
            "NET_WIFI_SECURITY_WPA_WPA2_PSK": 11,
            "NET_WIFI_SECURITY_WPA_WPA2_ENTERPRISE": 12,
            "NET_WIFI_SECURITY_WPA3_PSK_AES": 13,
            "NET_WIFI_SECURITY_WPA3_SAE": 14
        },
        "success": true
    }
}

SetLogLevel method

Set Log level for more information. The possible set log level are as follows.

  • 0: FATAL
  • 1: ERROR
  • 2: WARNING
  • 3: INFO
  • 4: VERBOSE
  • 5: TRACE .

Events

No Events

Parameters

Name Type Description
params object
params.logLevel integer Set Log level to get more information

Result

Name Type Description
result object
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.SetLogLevel",
    "params": {
        "logLevel": 1
    }
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "success": true
    }
}

GetWifiState method

Returns the current Wifi State. The possible Wifi states are as follows.

  • 0: UNINSTALLED - The device was in an installed state and was uninstalled; or, the device does not have a Wifi radio installed
  • 1: DISABLED - The device is installed but not yet enabled
  • 2: DISCONNECTED - The device is installed and enabled, but not yet connected to a network
  • 3: PAIRING - The device is in the process of pairing, but not yet connected to a network
  • 4: CONNECTING - The device is attempting to connect to a network
  • 5: CONNECTED - The device is successfully connected to a network
  • 6: SSID_NOT_FOUND - The requested SSID to connect is not found
  • 7: SSID_CHANGED - The device connected SSID is changed
  • 8: CONNECTION_LOST - The device network connection is lost
  • 9: CONNECTION_FAILED - The device network connection got failed
  • 10: CONNECTION_INTERRUPTED - The device connection is interrupted
  • 11: INVALID_CREDENTIALS - The credentials provided to connect is not valid
  • 12: AUTHENTICATION_FAILED - Authentication process as a whole could not be successfully completed
  • 13: ERROR - The device has encountered an unrecoverable error with the Wifi adapter

Events

No Events

Parameters

This method takes no parameters.

Result

Name Type Description
result object
result.state integer The Wifi operational state
result.success boolean Whether the request succeeded

Example

Request

{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "org.rdk.NetworkManager.GetWifiState"
}

Response

{
    "jsonrpc": "2.0",
    "id": 42,
    "result": {
        "state": 2,
        "success": true
    }
}

Notifications

Notifications are autonomous events, triggered by the internals of the implementation, and broadcasted via JSON-RPC to all registered observers. Refer to [Thunder] for information on how to register for a notification.

The following events are provided by the org.rdk.NetworkManager plugin:

NetworkManager interface events:

Event Description
onInterfaceStateChange Triggered when an interface state is changed
onAddressChange Triggered when an IP Address is assigned or lost
onActiveInterfaceChange Triggered when the primary/active interface changes, regardless if it's from a system operation or through the SetPrimaryInterface method
onInternetStatusChange Triggered when internet connection state changed
onAvailableSSIDs Triggered when scan completes or when scan cancelled
onWiFiStateChange Triggered when WIFI connection state get changed
onWiFiSignalStrengthChange Triggered when WIFI connection Signal Strength get changed

onInterfaceStateChange event

Triggered when an interface state is changed. The possible states are

  • 'INTERFACE_ADDED'
  • 'INTERFACE_LINK_UP'
  • 'INTERFACE_LINK_DOWN'
  • 'INTERFACE_ACQUIRING_IP'
  • 'INTERFACE_REMOVED'
  • 'INTERFACE_DISABLED' .

Parameters

Name Type Description
params object
params.interface string An interface, such as eth0 or wlan0, depending upon availability of the given interface
params.state string Current state of the interface

Example

{
    "jsonrpc": "2.0",
    "method": "client.events.onInterfaceStateChange",
    "params": {
        "interface": "wlan0",
        "state": "INTERFACE_ADDED"
    }
}

onAddressChange event

Triggered when an IP Address is assigned or lost.

Parameters

Name Type Description
params object
params.interface string An interface, such as eth0 or wlan0, depending upon availability of the given interface
params.isIPv6 boolean It will be true if the IP address is IPv6
params.ipAddress string The IPv6 or IPv4 address for the interface
params.status string Whether IP address was acquired or lost (must be one of the following: 'ACQUIRED', 'LOST') (must be one of the following: ACQUIRED, LOST)

Example

{
    "jsonrpc": "2.0",
    "method": "client.events.onAddressChange",
    "params": {
        "interface": "wlan0",
        "isIPv6": false,
        "ipAddress": "192.168.1.100",
        "status": "ACQUIRED"
    }
}

onActiveInterfaceChange event

Triggered when the primary/active interface changes, regardless if it's from a system operation or through the SetPrimaryInterface method.

Parameters

Name Type Description
params object
params.oldInterfaceName string The previous interface that was changed
params.newInterfaceName string The current interface

Example

{
    "jsonrpc": "2.0",
    "method": "client.events.onActiveInterfaceChange",
    "params": {
        "oldInterfaceName": "wlan0",
        "newInterfaceName": "eth0"
    }
}

onInternetStatusChange event

Triggered when internet connection state changed.The possible internet connection status are NO_INTERNET, LIMITED_INTERNET, CAPTIVE_PORTAL, FULLY_CONNECTED.

Parameters

Name Type Description
params object
params.PrevState integer The privious internet connection state
params.PrevStatus string The previous internet connection status
params.state integer The internet connection state
params.status string The internet connection status

Example

{
    "jsonrpc": "2.0",
    "method": "client.events.onInternetStatusChange",
    "params": {
        "PrevState": 1,
        "PrevStatus": "NO_INTERNET",
        "state": 4,
        "status": "FULLY_CONNECTED"
    }
}

onAvailableSSIDs event

Triggered when scan completes or when scan cancelled.

Parameters

Name Type Description
params object
params.ssids array On Available SSID's
params.ssids[#] object
params.ssids[#].ssid string ssid
params.ssids[#].security integer security
params.ssids[#].signalStrength string signalStrength
params.ssids[#].frequency string frequency

Example

{
    "jsonrpc": "2.0",
    "method": "client.events.onAvailableSSIDs",
    "params": {
        "ssids": [
            {
                "ssid": "myAP-2.4",
                "security": 6,
                "signalStrength": "-27.000000",
                "frequency": "2.442000"
            }
        ]
    }
}

onWiFiStateChange event

Triggered when WIFI connection state get changed. The possible states are,

  • '0' - 'WIFI_STATE_UNINSTALLED'
  • '1' - 'WIFI_STATE_DISABLED'
  • '2' - 'WIFI_STATE_DISCONNECTED'
  • '3' - 'WIFI_STATE_PAIRING'
  • '4' - 'WIFI_STATE_CONNECTING'
  • '5' - 'WIFI_STATE_CONNECTED'
  • '6' - 'WIFI_STATE_SSID_NOT_FOUND'
  • '7' - 'WIFI_STATE_SSID_CHANGED'
  • '8' - 'WIFI_STATE_CONNECTION_LOST'
  • '9' - 'WIFI_STATE_CONNECTION_FAILED'
  • '10'- 'WIFI_STATE_CONNECTION_INTERRUPTED'
  • '11' - 'WIFI_STATE_INVALID_CREDENTIALS'
  • '12' - 'WIFI_STATE_AUTHENTICATION_FAILED'
  • '13' - 'WIFI_STATE_ERROR' .

Parameters

Name Type Description
params object
params.state integer onWiFiStateChange

Example

{
    "jsonrpc": "2.0",
    "method": "client.events.onWiFiStateChange",
    "params": {
        "state": 5
    }
}

onWiFiSignalStrengthChange event

Triggered when WIFI connection Signal Strength get changed.

Parameters

Name Type Description
params object
params.ssid string Signal Strength changed SSID
params.signalLevel string Signal Strength
params.signalQuality string Signal quality

Example

{
    "jsonrpc": "2.0",
    "method": "client.events.onWiFiSignalStrengthChange",
    "params": {
        "ssid": "home-new_123",
        "signalLevel": "-27.000000",
        "signalQuality": "Excellent"
    }
}