Skip to main content

WebOS Setup

WebOS devices can connect to Wi-Fi networks such as WP2-Personal, Open network, and WPA2-Enterprise. To connect to a WPA2-Enterprise network, you need to configure your WebOS device's network settings. Below are the steps to set up a WPA2-Enterprise connection on a WebOS device.

Required WebOS version
  • WPA2-Enterprise networks are supported only on WebOS 6 and higher.
  • WPA2-Personal networks are supported on all versions.

Supported WPA2-Personal / WPA2-Enterprise authentication methods

Core App VersionFront-Applet VersionOPENWPA2-PersonalEAP-TLSEAP-TTLSPEAP (MSCHAPv2)PEAP (GTC)
≤2.9.0≤8.5.1
≥2.10.0≥8.5.2

Set up via JS API

To connect to Wi-Fi Enterprise, it's required to have those things prepared:

  • Correct Core App version (at least 2.10.0) installed on the device.
  • Correct Front-Applet version (at least 8.5.2) installed in Applet, Script, or Runner.

Importing certificates

This functionality is not supported for now.

Connecting to Wi-Fi Enterprise

With the Wi-Fi JS API SDK, you can programmatically connect to a WPA2-Enterprise network from your applet, script, or runner. This enables you to control the connection process within your application.

Our documentation page for Wi-FI connect function in JS API SDK.

WebOS connect issues

Connection to a Wi-Fi network on WebOS may fail if scan() is not called first. Always call sos.management.wifi.scan() before configuring a Wi-Fi network.

import sos from '@signageos/front-applet';

// Connect to WPA2-Enterprise network with PEAP + GTC method
await sos.management.wifi.connect('MyEnterpriseNetwork', undefined, {
securityType: '802.1X_EAP',
eap: {
method: 'PEAP',
identity: 'my-username',
identityPassword: 'tokenCode',
phase2Auth: 'GTC',
}
});