{"type":"doc","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"networkconfiguration ","type":"text","marks":[{"type":"em"}]},{"text":"object allows for configuration of the network interfaces on the player. Each object instance corresponds to a single network interface (Ethernet, WiFi, or modem), which is specified using the ","type":"text"},{"text":"type","type":"text","marks":[{"type":"code"}]},{"text":" attribute.","type":"text"}]},{"type":"paragraph","content":[{"text":"This object only allows you to configure/retrieve settings related to the network interfaces on the device. For other network information, use the Node.js® OS module.","type":"text"}]},{"type":"paragraph","content":[{"text":"networkconfiguration IDL","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"[\n Constructor(String ifName)\n] interface NetworkInterface {\n attribute String type; // values: wifi, ethernet, modem\n NetworkInterfaceConfig defaultConfig();\n Promise getConfig(NetworkInterfaceConfigRequestParams params[optional]); // Promise will be resolved as WifiInterfaceConfig, ModemInterfaceConfig, EthernetInterfaceConfig\n Promise applyConfig(NetworkInterfaceConfig config);\n [type == \"ethernet\"] Promise getNeighborInformation();\n [type == \"ethernet\"] Promise enableLeds();\n [type == \"wifi\"] Promise scan();\n [type == \"wifi\"] Promise reassociate();\n};\n\ninterface WifiAccessPointList {\n attribute String essId;\n attribute String bssId;\n attribute long signal;\n};\n\ninterface LLDPNeighborInformation {\n // information is directly converted from LLDP. Fields are defined deep down there.\n};\n\ninterface NetworkInterfaceConfig {\n attribute long metric;\n [optional = CONFIG_DHCP_SERVER] attribute DHCPServerConfig dhcpServerConfig;\n attribute Array dnsServerList;\n attribute IPAddressList ipAddressList;\n attribute long inboundShaperRate;\n attribute long mtu;\n [optional = CONFIG_VLAN] attribute Array vlanIdList;\n attribute String clientIdentifier;\n attribute String domain;\n\tattribute Array enabledProtocolList;\n};\n\n[optional = CONFIG_DIALUP] interface DialUpInterfaceConfig : public NetworkInterfaceConfig {\n attribute String user;\n attribute String password;\n attribute String number;\n attribute String initString;\n};\n\ninterface DHCPServerConfig {\n attribute String start;\n attribute String end;\n};\n\ninterface IPAddress {\n attribute String family;\n attribute String address;\n attribute String netmask;\n attribute String gateway;\n attribute String broadcast;\n};\n\ninterface EthernetInterfaceConfig : public NetworkInterfaceConfig {\n attribute String securityMode;\n attribute String identity;\n attribute String eapTlsOptions;\n attribute String caCertificates;\n attribute String clientCertificate;\n attribute String privateKey;\n};\n\ninterface WifiInterfaceConfig : public NetworkInterfaceConfig{\n attribute String essId;\n attribute String passphrase;\n attribute String obfuscatedPassphrase;\n attribute String securityMode;\n attribute String identity;\n attribute String eapTlsOptions;\n attribute String caCertificates;\n attribute String clientCertificate;\n attribute String privateKey;\n attribute String frequencies;\n [optional = CONFIG_WIFI_AP] attribute bool accessPointMode;\n [optional = CONFIG_WIFI_AP] attribute long accessPointFrequency;\n [optional = CONFIG_WIFI_AP] attribute bool accessPointHidden;\n};","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Object Creation","type":"text"}]},{"type":"paragraph","content":[{"text":"To create a ","type":"text"},{"text":"networkconfiguration","type":"text","marks":[{"type":"em"}]},{"text":" object, first load the ","type":"text"},{"text":"brightsign/networkconfiguration","type":"text","marks":[{"type":"code"}]},{"text":" module using the ","type":"text"},{"text":"require()","type":"text","marks":[{"type":"code"}]},{"text":" method. Then create an instance of the ","type":"text"},{"text":"networkconfiguration","type":"text","marks":[{"type":"em"}]},{"text":" class using a string value that indicates the network interface associated with the instance.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"var NetworkConfigClass = require(\"@brightsign/networkconfiguration\");\nvar networkConfigEth = new NetworkConfigClass(\"eth0\"); ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"NetworkInterface","type":"text"}]},{"type":"paragraph","content":[{"text":"Use this interface to configure a network interface on the player.","type":"text"},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#3d3d3d"}}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Attribute","type":"text","marks":[{"type":"textColor","attrs":{"color":"#3d3d3d"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"type","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The network interface type, which can be one of the following:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"ethernet\"","type":"text","marks":[{"type":"code"}]},{"text":": An Ethernet port on the BrightSign player","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"wifi\":","type":"text","marks":[{"type":"code"}]},{"text":" The internal WiFi","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"modem\"","type":"text","marks":[{"type":"code"}]},{"text":": A connected modem","type":"text"}]}]}]}]}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Tip","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The network interface can be configured as a VLAN using the following string format: ","type":"text"},{"text":"\"[parent_interface].[vlan_id]\"","type":"text","marks":[{"type":"code"}]},{"text":" (e.g ","type":"text"},{"text":"\"eth0.42\"","type":"text","marks":[{"type":"code"}]},{"text":"). Once the VLAN interface(s) are configured, they must be enabled on the parent network interface (e.g. \"eth0\") by including them in the ","type":"text"},{"text":"vlanIdList","type":"text","marks":[{"type":"code"}]},{"text":" of the parent interface. VLAN interfaces use DHCP by default. They are supported on Series 4 (XTx44, XDx34, HDx24, LS424) and Series 3 (XTx43, XDx33, HDx23, LS423, HO523) players only. Also see ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://brightsign.atlassian.net/wiki/spaces/DOC/pages/1827569665"}},{"text":".","type":"text"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"getConfig()","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"Promise getConfig(NetworkInterfaceConfigRequestParams params[optional])","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns configuration settings for the network interface. Depending on the specified ","type":"text"},{"text":"type","type":"text","marks":[{"type":"code"}]},{"text":", this method will return an ","type":"text"},{"text":"EthernetInterfaceConfig","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"WiFiInterfaceConfig","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"ModemInterfaceConfig","type":"text","marks":[{"type":"code"}]},{"text":" interface. ","type":"text"},{"text":" If there is a set password, ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"getConfig()","type":"text","marks":[{"type":"code"}]},{"text":" will return true for the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"password","type":"text","marks":[{"type":"code"}]},{"text":" parameter. If there isn't a set password, ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"getConfig()","type":"text","marks":[{"type":"code"}]},{"text":" will return false for the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"password","type":"text","marks":[{"type":"code"}]},{"text":" parameter.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"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 ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"Node.js® OS module","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}},{"type":"link","attrs":{"href":"https://nodejs.org/api/os.html#os_os_networkinterfaces"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"applyConfig()","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"Promise applyConfig(NetworkInterfaceConfig config)","type":"text"}]},{"type":"paragraph","content":[{"text":"Configures the network interface using the parameters in the passed ","type":"text"},{"text":"NetworkInterfaceConfig","type":"text","marks":[{"type":"em"}]},{"text":" object. This method returns void upon success. ","type":"text"}]},{"type":"paragraph","content":[{"text":"To reset a network-interface setting to its default value, pass the ","type":"text"},{"text":"NetworkInterfaceConfig ","type":"text","marks":[{"type":"em"}]},{"text":"object without the corresponding attribute.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"config","type":"text","marks":[{"type":"code"}]},{"text":" 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 ","type":"text"},{"text":"getConfig","type":"text","marks":[{"type":"code"}]},{"text":" and modify the returned object ","type":"text"},{"text":"(see the example in the Examples section).","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"getNeighborInformation()","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"Promise getNeighborInformation()","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns LLDP information related to the network, or null. This method is available with the ethernet interface only.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"enableLeds()","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"Promise enableLeds()","type":"text"}]},{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"scan()","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"Promise scan()","type":"text"}]},{"type":"paragraph","content":[{"text":"Scans for WiFi access points are returns a list of detected access points. This method is available with the WiFi interface only.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"reassociate()","type":"text"}]},{"type":"codeBlock","content":[{"text":"Promise reassociate()","type":"text"}]},{"type":"paragraph","content":[{"text":"Attempts to disconnect and reconnect to the currently-configured WiFi network asynchronously. This should not normally be necessary, but could be useful when diagnosing network problems. If successful, the returned promise will be resolved. If unsuccessful, the returned promise will be rejected with error information.","type":"text"}]},{"type":"paragraph","content":[{"text":"This method is present in BOS 8.4.20 and above, BOS 8.5.26 and above, and in all BOS 9.0 versions. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that the promise may be resolved before the network has been reconnected. Use ","type":"text"},{"text":"@brightsign/networkhotplug","type":"text","marks":[{"type":"code"}]},{"text":" to determine when reconnection is complete.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"WifiAccessPointList","type":"text"}]},{"type":"paragraph","content":[{"text":"This interface represents the results of a scan for wireless networks. Each entry in the list contains the following parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"essID","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": ","type":"text"},{"text":"the WiFi ESSId network name","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"bssID","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": ","type":"text"},{"text":" the BSSId of the access point","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"signal","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"long","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": 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.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"LLDPNeighborInformation","type":"text"}]},{"type":"paragraph","content":[{"text":"This interface contains location information received from the network infrastructure using the ","type":"text"},{"text":"LLDP-MED protocol","type":"text","marks":[{"type":"link","attrs":{"href":"https://brightsign.atlassian.net/wiki/spaces/DOC/pages/370673153#roNetworkConfiguration-lldp"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"NetworkInterfaceConfigRequestParams ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[bool] includeEncryptedSecrets:","type":"text","marks":[{"type":"code"}]},{"text":" If set to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":", encrypted secrets are included, if set to ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":" they are not.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"NetworkInterfaceConfig","type":"text"}]},{"type":"paragraph","content":[{"text":"This interface contains settings related to a network interface.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"metric","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"long","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The routing metric for the default gateway on the interface. Routes with lower metrics are preferred over routes with higher metrics. ","type":"text"},{"text":"If not specified the metric will be set to ensure that interfaces are preferred consistently for a given configuration.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"dhcpServerConfig","type":"text","marks":[{"type":"code"}]},{"text":" DHCPServerConfig","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": A ","type":"text"},{"text":"DHCPServerConfig","type":"text","marks":[{"type":"em"}]},{"text":" 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 ","type":"text"},{"text":"applyConfig()","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"dnsServerList","type":"text","marks":[{"type":"code"}]},{"text":" Array","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": A string list containing a maximum of three DNS servers. Each string should contain the dotted-quad IP address of a DNS server. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ipAddressList","type":"text","marks":[{"type":"code"}]},{"text":" Array","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": ","type":"text"},{"text":"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","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"inboundShaperRate","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"long","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The bandwidth limit for inbound traffic in bits per second. ","type":"text"},{"text":"If undefined, there is no bandwidth limit.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"mtu","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"long","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The maximum transmission unit (MTU) for the network interface in bytes. If not specified an appropriate mtu value will be chosen automatically.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"vlanIdList","type":"text","marks":[{"type":"code"}]},{"text":" Array","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": ","type":"text"},{"text":"A list of VLAN IDs that this network interface is the parent for.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"clientIdentifier","type":"text","marks":[{"type":"code"}]},{"text":" String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The DHCP client identifier for the network interface","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"domain","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":" String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The domain name for the network interface","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"enabledProtocolList","type":"text","marks":[{"type":"code"}]},{"text":" Array","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": An optional array containing the set of enabled IP protocols. The default value is ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"[","type":"text"},{"text":"IPv4","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"IPv6","type":"text","marks":[{"type":"code"}]},{"text":"].","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"DialUpInterfaceConfig","type":"text"}]},{"type":"paragraph","content":[{"text":"This interface contains attributes related to the modem interface:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"user","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":" String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The username that has been entered: some operators will require the username, others will not.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"password","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The password that has been entered: some operators will require the password, others will not.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"number","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":" String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The \"start connection\" command, which previously dialed a number. ","type":"text"},{"text":"Now, ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"number","type":"text","marks":[{"type":"code"}]},{"text":" is almost always \"*99#\". ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"initString","type":"text","marks":[{"type":"code"}]},{"text":" String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": ","type":"text"},{"text":"The general modem setup string, which varies between operators. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"DHCPServerConfig","type":"text"}]},{"type":"paragraph","content":[{"text":"This interface configures a DHCP server on the Ethernet port or wireless access point. If configuring DHCP for WiFi, note that the WiFi interface must be in access point mode.","type":"text"}]},{"type":"paragraph","content":[{"text":"A static IP address must be assigned to the ","type":"text"},{"text":"wlan0","type":"text","marks":[{"type":"code"}]},{"text":" interface for the DHCP server to work correctly. To apply a static IP address, refer to ","type":"text"},{"text":"networkconfiguration#NetworkInterfaceConfig","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.brightsign.biz/space/DOC/370678197/networkconfiguration#NetworkInterfaceConfig"}}]},{"text":", and use the ","type":"text"},{"text":"ipAddressList","type":"text","marks":[{"type":"code"}]},{"text":" setting.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"start","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":" String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The beginning of the range of offered IP addresses","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"end","type":"text","marks":[{"type":"code"}]},{"text":" String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The end of the range of offered IP addresses","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"gateway","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":"optional","type":"text","marks":[{"type":"textColor","attrs":{"color":"#00b8d9"}}]},{"text":": IPv4 address of the gateway to be used by clients.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"dnsServerList","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"Array ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":"optional","type":"text","marks":[{"type":"textColor","attrs":{"color":"#00b8d9"}}]},{"text":": An array of strings containing the IPv4 addresses of name servers (IPv6 addresses are not currently supported)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"domain","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":" String ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":"optional","type":"text","marks":[{"type":"textColor","attrs":{"color":"#00b8d9"}}]},{"text":": The domain suffix to be used by clients","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"IPAddress","type":"text"}]},{"type":"paragraph","content":[{"text":"This interface represents an IP address configuration.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"family","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The IP configuration (","type":"text"},{"text":"must be set to ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"IPv4","type":"text","marks":[{"type":"code"}]},{"text":")","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"address","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The IP4 address. ","type":"text"},{"text":"This a string dotted decimal quad, for example \"192.168.1.42\".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"netmask","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The ","type":"text"},{"text":"IP4 ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"netmask. ","type":"text"},{"text":"This a string dotted decimal quad, for example \"255.255.255.0\".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"gateway","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": ","type":"text"},{"text":"The IP4 interface configuration. This a string dotted decimal quad, for example \"192.168.1.2\".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"broadcast","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The ","type":"text"},{"text":"IP4 ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"broadcast address. ","type":"text"},{"text":"This a string dotted decimal quad, for example \"192.168.1.255\".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"EthernetInterfaceConfig","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"securityMode","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": Sets the encryption method.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"identity","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": 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).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"eapTlsOptions","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": A string containing EAP-specific options","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"caCertificates","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The contents of a CA certificate file in text form (that is, a \"pem\" file)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"clientCertificate","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The contents of a client certificate file in text form (that is, a \"pem\" file)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"privateKey","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The private key for authentication","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"WiFiInterfaceConfig","type":"text"}]},{"type":"paragraph","content":[{"text":"This interface contains attributes related to the WiFi interface:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"essId","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The ESSID of the wireless network","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"passphrase","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The plain-text passphrase/key for the wireless network","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"obfuscatedPassphrase","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":"optional","type":"text","marks":[{"type":"textColor","attrs":{"color":"#00b8d9"}}]},{"text":": The passphrase/key for the wireless network that has been obfuscated using a shared secret. Contact ","type":"text"},{"text":"support@brightsign.biz","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:support@brightsign.biz"}}]},{"text":" to learn more about generating a key for obfuscation and storing it on the player.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The following attributes relate to WPA Enterprise support:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"securityMode","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": 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.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"identity","type":"text","marks":[{"type":"code"}]},{"text":" String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": 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).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"eapTlsOptions","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": A string that contains EAP-specific options. Currently, this string can be used to enable or disable MD5 support (\"md5=enable\" or \"md5=disable\").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"caCertificates","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The contents of a CA certificate file in text form (i.e. a \"pem\" file). Certificates can also be sent from an EAP peer.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"clientCertificate","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The contents of a client certificate in text form (i.e. a \"pem\" file)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"privateKey","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The private key for authentication. If the private key is password protected, use the ","type":"text"},{"text":"passphrase","type":"text","marks":[{"type":"code"}]},{"text":"/","type":"text"},{"text":"obfuscatedPassphrase","type":"text","marks":[{"type":"code"}]},{"text":" attribute to set the password. If the client certificate and associated private key are in the same PKCS#12 file, the file contents should be specified in the ","type":"text"},{"text":"privateKey","type":"text","marks":[{"type":"code"}]},{"text":" field and the ","type":"text"},{"text":"clientCertificate","type":"text","marks":[{"type":"code"}]},{"text":" field should be left blank.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"frequencies","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": Gets the WiFi frequencies list","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"accessPointMode","type":"text","marks":[{"type":"code"}]},{"text":" bool","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":" ","type":"text"},{"text":"optional","type":"text","marks":[{"type":"textColor","attrs":{"color":"#00b8d9"}}]},{"text":": 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 ","type":"text"},{"text":"essId","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"passphrase","type":"text","marks":[{"type":"code"}]},{"text":"/","type":"text"},{"text":"obfuscatedPassphrase","type":"text","marks":[{"type":"code"}]},{"text":" attributes. If a passphrase has been set, the wireless access point will use WPA2 authentication–otherwise, it will use no authentication.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"accessPointFrequency","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"long","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":" ","type":"text"},{"text":"optional","type":"text","marks":[{"type":"textColor","attrs":{"color":"#00b8d9"}}]},{"text":": The ","type":"text"},{"text":"frequency","type":"text","marks":[{"type":"link","attrs":{"href":"https://en.wikipedia.org/wiki/List_of_WLAN_channels"}}]},{"text":" of the WiFi access point (in MHz)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"accessPointHidden","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"bool","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":" ","type":"text"},{"text":"optional","type":"text","marks":[{"type":"textColor","attrs":{"color":"#00b8d9"}}]},{"text":": 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.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"var networkConfigClass = require(\"@brightsign/networkconfiguration\");\nvar nc = new networkConfigClass(\"ethO\");\n\nnc.getConfig().then(\n function(data) {\n console.log(\"***General Interface Data***\");\n console.log(JSON.stringify(data));\n })\n .catch(\n function(data) {\n console.log(JSON.stringify(data));\n });","type":"text"}]},{"type":"paragraph","content":[{"text":"The following code applies a static IP address to the ethernet interface. If a static IP address is not provided, it configures the interface for DHCP instead:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"function main() {\n process.chdir('/storage/sd');\n\n var networkConfig = {\n ipAddress:\"10.0.1.20\",\n defaultGateway:\"10.0.1.1\",\n subnetMask:\"255.255.255.0\",\n broadcast: \"10.0.1.255\"\n };\n var networkConfigClass = require(\"@brightsign/networkconfiguration\");\n var networkConfigEthernet = new networkConfigClass(\"eth0\");\n var networkConfig = {};\n networkConfigEthernet.getConfig()\n .then(\n function(data) {\n console.log(\"=== Current config: \" + JSON.stringify(data));\n networkConfig = data;\n if (networkConfig.dnsServers) {\n networkConfig.dnsServerList = networkConfig.dnsServers;\n }\n if (networkConfig.ipAddress) {\n // Use static IP address.\n var ipAddress = {\n family: \"IPv4\",\n address: networkConfig.ipAddress,\n netmask: networkConfig.subnetMask, \n gateway: networkConfig.defaultGateway, \n broadcast: networkConfig.broadcast,\n };\n networkConfig.ipAddressList = [ipAddress];\n }\n else {\n // Use DHCP to obtain dynamic IP address.\n networkConfig.ipAddressList = [];\n }\n console.log(\"=== Applying config: \" + JSON.stringify(networkConfig));\n networkConfigEthernet.applyConfig(networkConfig)\n .then(\n function () {\n console.log(\"=== Success\");\n })\n .catch(\n function(err) {\n console.log(err);\n });\n })\n .catch(\n function(err) {\n console.log(err);\n });\n}\nwindow.main = main;\n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"The following code restricts IP version support to IPv4 only:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"var networkConfigClass = require(\"@brightsign/networkconfiguration\");\nvar networkConfigEthernet = new networkConfigClass(\"eth0\");\nnetworkConfigEthernet.getConfig()\n .then(\n function(data) {\n networkConfig = {}\n networkConfig.enabledProtocolList = [\"IPv4\"];\n networkConfigEthernet.applyConfig(networkConfig)\n .then(\n function() {\n console.log(\"Success\");\n })\n .catch(\n function(err) {\n console.log(err);\n });\n })\n .catch(\n function(err) {\n console.log(err);\n });","type":"text"}]},{"type":"paragraph","content":[{"text":"To ","type":"text"},{"text":"change one item while keeping the rest of the configuration the same, call ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"getConfig","type":"text","marks":[{"type":"code"}]},{"text":" and modify the returned object:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":" var NetworkConfiguration = require('@brightsign/networkconfiguration');\n var address = {\n ipAddress:\"10.0.1.20\",\n defaultGateway:\"10.0.1.1\",\n subnetMask:\"255.255.255.0\",\n broadcast: \"10.0.1.255\"\n };\n var networkConfig = new NetworkConfiguration(\"eth0\");\n networkConfig.getConfig()\n .then(function(config) {\n var ipAddress = {\n family: \"IPv4\",\n address: address.ipAddress,\n netmask: address.subnetMask,\n gateway: address.defaultGateway,\n broadcast: address.broadcast,\n };\n config.ipAddressList = [ipAddress];\n networkConfig.applyConfig(config);\n })\n .then(function() {\n console.log(\"Success\");\n })\n .catch(function(error) {\n console.log(`${JSON.stringify(error)}`);\n });","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported