Page Comparison

...

Use this interface to configure a network interface on the player. 

getConfig()

Promise<NetworkInterfaceConfig> getConfig(NetworkInterfaceConfigRequestParams params[optional])

Returns configuration settings for the network interface. Depending on the specified type, this method will return an EthernetInterfaceConfig, WiFiInterfaceConfig, or ModemInterfaceConfig interface.  If there is a set password, getConfig() will return true for the password parameter. If there isn't a set password, getConfig() will return false for the password parameter.

Note that this class concerns itself with the player's persistent network configuration. If you wish to determine the current settings (for example the IP address that has been retrieved via DHCP) then use the Node.js os js® OS module.

applyConfig()

Promise<void> applyConfig(NetworkInterfaceConfig config)

...

The config parameter should contain the complete desired configuration. Any previous configuration is overwritten. If you wish to change one item while keeping the rest of the configuration the same then first call getConfig and modify the returned object (see the example in the Examples section).

getNeighborInformation()

Promise<LLDPNeighborInformation> getNeighborInformation()

Returns LLDP information related to the network. This method is available with the ethernet interface only.

enableLeds()

Promise<void> enableLeds()

Enables or disables the ethernet activity LEDs (that is, flashing during link and activity behavior). Ethernet LEDs are enabled by default. Changes to this setting do not persist across reboots. This method is available with the ethernet interface only.

scan()

Promise<WifiAccessPointList> scan()

Scans for WiFi access points are returns a list of detected access points. This method is available with the WiFi interface only.

Attributes

• [String] type: The network interface type, which can one of the following:
  • "eth0": The ethernet port on the BrightSign player
  • "wlan0": The internal WiFi
  • "ppp0": A connected modem

WifiAccessPointList

This interface represents the results of a scan for wireless networks. Each entry in the list contains the following parameters:

• [String] essId:  the WiFi ESSId network name
• [String] bssId: BSSID the BSSId of the access point
• [long] signal: The received signal strength. The absolute value of this attribute is usually not relevant, but it can be compared with the reported value on other networks or in different locations.

...

NetworkInterfaceConfigRequestParams 

•    [bool] includeEncryptedSecrets: If set to true, encrypted secrets are included, if set to false they are not.

NetworkInterfaceConfig

This interface contains settings related to a network interface.

• [long] metric: The routing metric for the default gateway on the interface. Routes with lower metrics are preferred over routes with higher metrics. If not specified the metric will be set to ensure that interfaces are preferred consistently for a given configuration.
• [DHCPServerConfig] dhcpServerConfig:  A DHCPServerConfig interface that specifies the DHCP server configuration for the interface. The DHCP server can be disabled by setting this attribute to a null value when calling applyConfig().
• [Array<String>] dnsServerList: A string list containing a maximum of three DNS servers. Each string should contain the dotted-quad IP address of a DNS server. 
• [Array<IPAddress>] ipAddressList: An array containing zero or one static IPv4 address configurations. Players do not currently support more than one IPv4 address per interface or static configuration of IPv6 addresses. If the array is empty then IP addresses will be assigned using DHCP.

• [long] inboundShaperRate: If defined, the bandwidth limit for inbound traffic in bits per second. If undefined, there is no bandwidth limit.

  Note
  title Note
  Because of overhead on the shaping algorithm, attempting to limit the bandwidth at rates greater than approximately 2Mbit/s will reduce speeds to less than the specified rate.

• [long] mtu: The maximum transmission unit (MTU) for the network interface in bytes. If not specified an appropriate mtu value will be chosen automatically.
• [Array<int>] vlanIdList: A list of VLAN IDs that this network interface is the parent for.
• [String] clientIdentifier: The DHCP client identifier for the network interface
• [String] domain: The domain name for the network interface

• [Array<String>] enabledProtocolList: An optional array containing the set of enabled IP protocols. The default value is [IPv4, IPv6].

DialUpInterfaceConfig

This interface contains attributes related to the modem interface:

• [String] user:[String] password: The username that has been entered: some operators will require the username, others will not.
• [String] password: The password that has been entered: some operators will require the password, others will not.
• [String] number: The "start connection" command, which previously dialed a number. Now, number is almost always "*99#". 
• [String] initString:

DHCPServerConfig

...

•  The general modem setup string, which varies between operators. 

DHCPServerConfig

This interface contains settings related to the DHCP server on the WiFi access point. This interface is only applicable if the player is using WiFi access-point mode.

...

• [String] family: The IP configuration (must be set to IPv4).
• [String] address: The IP addressIP4 address. This a string dotted decimal quad, for example "192.168.1.42".
• [String] netmask: The IP4 netmask. This a string dotted decimal quad, for example "255.255.255.0".
• [String] gateway: The gateway[String] broadcast: The broadcast address The IP4 interface configuration. This a string dotted decimal quad, for example "192.168.1.2".
• [String] broadcast: The IP4 broadcast address. This a string dotted decimal quad, for example "192.168.1.255".

EthernetInterfaceConfig

• [String] securityMode: Sets the encryption method.
• [String] identity:
• [String] eapTlsOptions:
• [String] caCertificates: The RADIUS (Remote Authentication Dial-In User Service) identity. If this value is blank, it will be taken from the specified client certificate ("subjectAltName" will be used if present; otherwise, the "commonName" is used).
• [String] clientCertificate: eapTlsOptions: A string containing EAP-specific options
[String] essId: The ESSID of the wireless network
• [String] privateKey:

WifiInterfaceConfig

This interface contains attributes related to the WiFi interface:

•  caCertificates: The contents of a CA certificate file in text form (that is, a "pem" file)
• [String]
passphrase
• clientCertificate:
The plain-text passphrase/key for the wireless network
• [optional] [String] obfuscatedPassphrase: The passphrase/key for the wireless network that has been obfuscated using a shared secret.

The following attributes relate to WPA Enterprise support:

[String] securityMode:
•  The contents of a client certificate file in text form (that is, a "pem" file)
• [String] privateKey: The private key for authentication

WifiInterfaceConfig

This interface contains attributes related to the WiFi interface:

• [String] essId: The ESSID of the wireless network
• [String] passphrase: The plain-text passphrase/key for the wireless network
• [optional] [String] obfuscatedPassphrase: The passphrase/key for the wireless network that has been obfuscated using a shared secret.

The following attributes relate to WPA Enterprise support:

• [String] securityMode: Sets the WiFi encryption method. By default, both WPA (TKIP) and WPA2 (CCMP) encryption are permitted. This method accepts a space-separated, case-insensitive list that can include either "tkip" or "ccmp" values. Passing an empty string sets the default mode. If both CCMP and TKIP are allowed, CCMP always has priority.
• [String] identity: The RADIUS identity. If this value is blank, it will be taken from the specified client certificate ("subjectAltName" will be used if present; otherwise, the "commonName" is used).
• [String] eapTlsOptions: A string that contains EAP-specific options. Currently, this string can be used to enable or disable MD5 support ("md5=enable" or "md5=disable").
• [String] caCertificates: The contents of a CA certificate file in text form (i.e. a "pem" file). Certificates can also be sent from an EAP peer.
• [String] clientCertificate: The contents of a client certificate in text form (i.e. a "pem" file)

• [String] privateKey: The private key for authentication. If the private key is password protected, use the passphrase/obfuscatedPassphrase attribute to set the password.

  Note
  title Note
  If the client certificate and associated private key are in the same PKCS#12 file, the file contents should be specified in the privateKey field and the clientCertificate field should be left blank.

• [String] frequencies: Gets the WiFi frequencies list
• [optional] [bool] accessPointMode:

  Anchor
  accessPointMode accessPointMode

  A Boolean flag specifying whether WiFi access-point mode is enabled or disabled. The ESSID and passphrase of the WiFi access point is set with the essId and passphrase/obfuscatedPassphrase attributes. If a passphrase has been set, the wireless access point will use WPA2 authentication–otherwise, it will use no authentication.
• [optional] [long] accessPointFrequency: The frequency of the WiFi access point (in MHz)
• [optional] [bool] accessPointHidden: A Boolean flag that specifies if hidden is true, the SSID is hidden, if false it is visible. The default is non-hidden, which was the previous behavior.

...