Browse and Discovery
5 min
browse and asset discovery two different "discovery" features exist in litmus edge don't confuse them 1\ asset discovery (network level) scans your network for assets that aren't yet configured in devicehub returns ip addresses, vendor / model hints, and protocol guesses api folder devicehub > asset discovery per interface scan eth0, wlan0, etc operations get /devicehub/assetdiscovery/ (rest) enable / disable scanning per interface use when "i have a new plc plugged into the same vlan what's its ip and what protocol does it speak?" 2\ browse (device level) walks the address space of an already configured device and surfaces tags / nodes you can import api folder devicehub > browse graphql operations on /devicehub/v2 operates against a device id (the device must already exist) use when "i have an opc ua server configured show me every node so i can pick which ones to monitor " browse modes per driver the 146 drivers vary in what they support mode what it does drivers browse one shot full address space walk opc ua advanced, ab logix, siemens s7commplus, 38 total dynamicbrowse re browse on demand for changing address spaces subset of browse capable drivers streambrowse incremental walk for large servers opc ua advanced primarily drivers without browse support (e g modbus, since modbus has no enumeration capability) cannot use the browse chain tags must be created directly via createregisters the generator driver (simulator) doesn't support browse either if you're using the generator for testing, skip the browse chain browse workflow createbrowsetask > startbrowsetasks > \[poll] listbrowsetasks > browsetask getfoldersfortreeview > browsetask getfolderitems > cart additems (optional cart updateproperties) > cart createallregisters 7 steps, all on /devicehub/v2 see browse bulk tag discovery workflow # useful side endpoints download browse tags ( get /devicehub/browsing/download csv/task/{task id} ) exports discovered tags to csv before committing lets users review in excel before creating upload csv (rest) import tags from csv (skip browse entirely if you already have the spreadsheet)