{"type":"doc","content":[{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"paragraph","content":[{"text":"The ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"deviceinfo","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"em"}]},{"text":" object lets you identify device hardware, firmware, and features.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"deviceinfo IDL","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"interface DeviceInfo {\n attribute String model;\n attribute String osVersion;\n attribute String bootVersion;\n attribute String serialNumber;\n attribute String family;\n \n int osVersionCompare(String version);\n int bootVersionCompare(String bootVersion);\n bool osVersionIsAtLeast(String version);\n bool bootVersionIsAtLeast(String bootVersion);\n bool hasFeature(String feature);\n Promise getLoadStatistics(String item);\n Promise getTemperature();\n Promise getUsbTopology();\n};\n\ndictionary TemperatureLocation {\n float celsius;\n};\n\ninterface UsbTopologyInterface {\n attribute String vid;\n attribute String pid;\n attribute String raw;\n attribute String fid;\n [optional] attribute String category;\n [optional] attribute String ident;\n attribute Array children;\n};\n","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"panel","parameters":{"macroParams":{"borderColor":{"value":"#3D3D3D"},"bgColor":{"value":"#F4F4F4"},"titleColor":{"value":"#3D3D3D"},"borderWidth":{"value":"0"},"titleBGColor":{"value":"#3D3D3D"},"borderStyle":{"value":"solid"}},"macroMetadata":{"macroId":{"value":"6041596c-97c4-48dc-8f94-eb2b1d949b1e"},"schemaVersion":{"value":"1"},"title":"Panel"}},"localId":"cb7daeab-2607-4030-9c2e-c55a9b3e332a"},"content":[{"type":"paragraph","content":[{"text":"ON THIS PAGE","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"indent":{"value":"20px"}},"macroMetadata":{"macroId":{"value":"47b4ce7e-9563-4cd5-98e4-28fa04ea1bea"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"992446b5-6f09-4212-bc39-f35703f095eb"}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Object Creation","type":"text"}]},{"type":"paragraph","content":[{"text":"To create a ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"deviceinfo","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"em"}]},{"text":" object, load the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"@brightsign/deviceinfo","type":"text","marks":[{"type":"code"}]},{"text":" module using the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"require()","type":"text","marks":[{"type":"code"}]},{"text":" method. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"diClass = require(\"@brightsign/deviceinfo\");\ndi = new diClass(); \n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"DeviceInfo","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"getLoadStatistics()","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"Promise getLoadStatistics(String item)","type":"text"}]},{"type":"paragraph","content":[{"text":"Provides current performance information related to the Linux kernel. The ","type":"text"},{"text":"item","type":"text","marks":[{"type":"code"}]},{"text":" can be any of the following:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"loadavg","type":"text","marks":[{"type":"code"}]},{"text":": Provides information about system performance. The first three columns measure CPU and I/O utilization over the past 1, 5, and 10 minutes, respectively. The fourth column displays the number of currently running processes and the total number of processes. The last column displays the ID of the most recently used process.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"meminfo","type":"text","marks":[{"type":"code"}]},{"text":": Displays physical and swap memory usage","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"slabinfo","type":"text","marks":[{"type":"code"}]},{"text":": Provides information about memory usage at the slab level","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"stat","type":"text","marks":[{"type":"code"}]},{"text":": Provides overall statistics about the system (for example, the number of page faults since the system booted)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"vmstat","type":"text","marks":[{"type":"code"}]},{"text":": Displays detailed virtual memory statistics from the kernel","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"zoneinfo","type":"text","marks":[{"type":"code"}]},{"text":": Provides overall statistics about the system, broken down by system Node","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"interrupts","type":"text","marks":[{"type":"code"}]},{"text":": Displays which interrupts are in use and how many of each type there have been","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"version","type":"text","marks":[{"type":"code"}]},{"text":": Provides the kernel version","type":"text"}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"getTemperature()","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":" getTemperature()","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"key","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"string","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": A ","type":"text"},{"text":"dynamic string location key","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"value","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"float","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The device temperature as a floating point value","type":"text"}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"getUsbTopology()","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":" getUsbTopology()","type":"text"}]},{"type":"paragraph","content":[{"text":"Gets the USB topology of the player.","type":"text"}]},{"type":"paragraph","content":[{"text":"These attributes return","type":"text"},{"text":" information about the BrightSign player:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"model","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"string","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": Returns the model name for the BrightSign device running the script, as a string (for example, \"HD1020\" or \"XD230\").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"osVersion","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"string","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": Returns the OS version number for the BrightSign device running the script.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"bootVersion","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"string","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": Returns the version number of the BrightSign boot firmware, also known as \"safe mode\", as a string (for example, \"1.0.4\").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"serialNumber","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"string","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": Returns the device serial number which, if not an empty string, is unique to the unit running the script.","type":"text"}]}]},{"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":": Returns a single string that indicates the family to which the device belongs. A device family is a set of models that are all capable of running the same firmware.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"osVersionCompare()","type":"text"}]},{"type":"codeBlock","content":[{"text":"int osVersionCompare(String version)","type":"text"}]},{"type":"paragraph","content":[{"text":"This function returns an integer greater than zero if the current OS version is greater than the parameter, 0 if it is exactly equal, or less than zero if lesser. For example:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"if (di.osVersionCompare(\"8.2\") > 0) { console.log(\"Firmware version is greater than 8.2\") }","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":2}}],"content":[{"text":"or:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"if (di.osVersionCompare(\"8.4\") < 0) { console.log(\"Firmware version is less than 8.4\") }","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"bootVersionCompare()","type":"text"}]},{"type":"codeBlock","content":[{"text":"int bootVersionCompare(String bootVersion)","type":"text"}]},{"type":"paragraph","content":[{"text":"This function returns an integer greater than zero if the current boot loader version is greater than the parameter, 0 if it is exactly equal, or less than zero if lesser (see the examples for ","type":"text"},{"text":"osVersionCompare()","type":"text","marks":[{"type":"code"}]},{"text":"). ","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"osVersionIsAtLeast()","type":"text"}]},{"type":"codeBlock","content":[{"text":"bool osVersionIsAtLeast(String version)","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns ","type":"text"},{"text":"True","type":"text","marks":[{"type":"code"}]},{"text":" if the BrightSign OS version on the device is greater than or equal to the version number represented by the passed string (for example, \"4.0.13\").","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"bootVersionIsAtLeast()","type":"text"}]},{"type":"codeBlock","content":[{"text":"bool bootVersionIsAtLeast(String bootVersion)","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns ","type":"text"},{"text":"True","type":"text","marks":[{"type":"code"}]},{"text":" if the BrightSign boot OS version on the device is greater than or equal to the version number represented by the passed string (for example, \"4.4.22\").","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"hasFeature()","type":"text"}]},{"type":"codeBlock","content":[{"text":"bool hasFeature(String feature)","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns ","type":"text"},{"text":"True","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"if the player feature in the passed string (which is passed as a case-insensitive string parameter) is present on the current device and firmware. The possible features that can be queried from the script are listed below:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"Important","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"If you pass a parameter other than one of those listed below, it may return False even if the feature is available on the hardware and firmware.","type":"text"}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"5v serial\"","type":"text","marks":[{"type":"code"}]},{"text":": A 5V serial port","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"audio1\"","type":"text","marks":[{"type":"code"}]},{"text":": The first audio output","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"audio2\"","type":"text","marks":[{"type":"code"}]},{"text":": A second audio output","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"audio3\"","type":"text","marks":[{"type":"code"}]},{"text":": A third audio output","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"brightscript1\"","type":"text","marks":[{"type":"code"}]},{"text":": BrightScript Version 1","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"brightscript2\"","type":"text","marks":[{"type":"code"}]},{"text":": BrightScript Version 2","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"component video\"","type":"text","marks":[{"type":"code"}]},{"text":": A component video output","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"ethernet\"","type":"text","marks":[{"type":"code"}]},{"text":": An Ethernet interface","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"gpio connector\"","type":"text","marks":[{"type":"code"}]},{"text":": A DA15 or Pheonix-style GPIO port ","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"hdmi\"","type":"text","marks":[{"type":"code"}]},{"text":": An HDMI","type":"text"},{"text":"®","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}},{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"strong"}]},{"text":" output","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"hdmi input\"","type":"text","marks":[{"type":"code"}]},{"text":": An HDMI input","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"hevc_decode\"","type":"text","marks":[{"type":"code"}]},{"text":": An H.265 video decoder","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"media_decryption\"","type":"text","marks":[{"type":"code"}]},{"text":": The ability to decrypt AES-encrypted media, including video, image, and audio files.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"nand storage\"","type":"text","marks":[{"type":"code"}]},{"text":": NAND storage for the boot loader and firmware","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"networking\"","type":"text","marks":[{"type":"code"}]},{"text":": Any form of networking capability. A False return may indicate that no network is currently available.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"reset button\"","type":"text","marks":[{"type":"code"}]},{"text":": A reset button","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"registry\"","type":"text","marks":[{"type":"code"}]},{"text":": On-board persistent storage","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"rtc\"","type":"text","marks":[{"type":"code"}]},{"text":": A real-time clock (RTC)","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"sd\"","type":"text","marks":[{"type":"code"}]},{"text":": SD- or SDHC-compatible storage","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"sdhc\"","type":"text","marks":[{"type":"code"}]},{"text":": SDHC-compatible storage only","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"serial port 0\"","type":"text","marks":[{"type":"code"}]},{"text":": The first serial port","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"serial port 1\"","type":"text","marks":[{"type":"code"}]},{"text":": A second serial port","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"serial port 2\"","type":"text","marks":[{"type":"code"}]},{"text":": A third serial port","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"svc button\"","type":"text","marks":[{"type":"code"}]},{"text":": A service (\"SVC\") button. Passing the legacy term ","type":"text"},{"text":"\"gpio12 button\"","type":"text","marks":[{"type":"code"}]},{"text":" will yield the same result.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"usb\"","type":"text","marks":[{"type":"code"}]},{"text":": One or more USB interfaces","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"vga\"","type":"text","marks":[{"type":"code"}]},{"text":": A VGA output","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":3}}],"content":[{"text":"\"video_encoder\"","type":"text","marks":[{"type":"code"}]},{"text":": A video encoder/transcoder","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"TemperatureLocation","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"celsius","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"float","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": Returns the temperature of the device in celsius, as a floating point number.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"UsbTopologyInterface","type":"text"}]},{"type":"paragraph","content":[{"text":"These attributes return the USB topology of the player, which can be used to determine whether certain USB devices are connected to certain ports. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"vid","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"string","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": Four character strings encoding the Vendor ID and Product ID in hexadecimal. Leading zeros are present and alpha characters are lower case (for example, vid = \"0b95\").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pid","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"string","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": ","type":"text"},{"text":"Four character strings encoding the Vendor ID and Product ID in hexadecimal. Leading zeros are present and alpha characters are lower case (for example, pid = \"0b95\").","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"raw","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"string","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": This is an internal (Linux) USB device node ID.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"fid","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"string","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":":","type":"text"},{"text":"Ports that have USB devices connected to them will include a ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"fid","type":"text","marks":[{"type":"code"}]},{"text":" (friendly ID) value, which can be used to determine which physical port the USB device is connected to on the player. See","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" ","type":"text"},{"text":"roDeviceInfo","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.brightsign.biz/display/DOC/roDeviceInfo"}}]},{"text":" for more information. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"category","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":": This optional string describes the device type (for example, \"HUB\", \"SERIAL\", \"NET\", \"HID\", \"AUDIO\", or \"OTHER\").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ident","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":": This is an additional identifier. For devices of category \"NET\", the ","type":"text"},{"text":"ident","type":"text","marks":[{"type":"code"}]},{"text":" is the system network interface name (for example, \"usb0\").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"children","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"Array<","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":" ","type":"text"},{"text":"optional","type":"text","marks":[{"type":"textColor","attrs":{"color":"#00b8d9"}}]},{"text":": Children are present for devices of category \"HUB\". Child devices have the same structure, so nested hubs will produce nested child data.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"This example returns the USB topology for the device:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"diClass = require(\"@brightsign/deviceinfo\");\ndi = new diClass();\n \nusbTopology = await di.getUsbTopology();\n \nparseTopology = function(usbT) {\n for(i in usbT) {\n let device = usbT[i];\n if (device.category === \"HUB\")\n parseTopology(device.children); \n if (device.category === \"NET\")\n console.log(\"Found \" + device.fid + \" interface \" + device.ident);\n }\n};\n \nparseTopology(usbTopology);","type":"text"}]},{"type":"paragraph","content":[{"text":"To replace","type":"text"},{"text":" BSDeviceInfo with the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"deviceinfo","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"em"}]},{"text":" object:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"if (typeof(BSDeviceInfo) === typeof undefined) \n{\n global.BSDeviceInfo = class BSDeviceInfo {\n constructor() {\n let fs = require('fs');\n let DeviceInfoClass = require('@brightsign/deviceinfo');\n let deviceInfo = new DeviceInfoClass();\n\n // Map properties and getters\n this.model = deviceInfo.model;\n this.version = deviceInfo.osVersion;\n this.bootVersion = deviceInfo.bootVersion;\n this.deviceUniqueId = deviceInfo.serialNumber;\n this.family = deviceInfo.family;\n Object.defineProperty(this, 'deviceUptime', {\n get: Object.getOwnPropertyDescriptor(deviceInfo, 'deviceUptime').get,\n enumerable: true,\n });\n // And methods\n this.VersionCompare = deviceInfo.osVersionCompare;\n this.BootVersionCompare = deviceInfo.bootVersionCompare;\n this.FirmwareIsAtLeast = deviceInfo.osVersionIsAtLeast;\n this.BootFirmwareIsAtLeast = deviceInfo.bootVersionIsAtLeast;\n this.HasFeature = deviceInfo.hasFeature;\n this.GetLoadStatistics = function(s) {\n let stats = new Set([ 'zoneinfo', 'loadavg', 'meminfo', 'stat', 'vmstat', 'interrupts', 'version', 'boardid' ]);\n var result = 'n/a';\n if (stats.has(s)) {\n result = fs.readFileSync('/proc/' + s).toString();\n }\n return result;\n };\n // GetTemperature and GetUsbTopology are not present in the BSDeviceInfo class\n };\n };\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported