Product Features
...
DeviceHub
Tags
Default Topics and Descriptions
11min
review the following information on default topics and descriptions to review use cases for topics, see topic use cases (plc status, poll once, write, manage, batch write) docid 0e9j90yla4nnrkhele2ce notes you need to follow the following guidelines for topic names subject based messaging when publishing structured data such as json, you must convert to a byte array (string) first to do this in a flow, you can use the json node data publishing formats devicehub collects data from plcs and sends data to a message broker for further distribution data flows trigger using an api call or execute according to a schedule manufacturing connect edge supports multiple data formats refer to the following formats used for data in devices raw topics devicehub tags docid\ atr2gyu0e5ci5wb 4mozm generate a raw topic, which is a local topic for publishing and subscribing data through the message broker manufacturing connect edge publishes each value to a tag specific topic in the following topic format devicehub raw {deviceid} {tagid} device raw topics when you copy a raw topic for a device in manufacturing connect edge, the topic is copied in the following format devicehub raw {deviceid} > the ">" character represents a wildcard this means that the topic will be used for any tag associated with the device example of a raw topic devicehub raw\ f7f72687 2f29 46e7 95e2 b5532471ebaa 2d7473c0 83a0 4174 83cc b48a63c1b1cf example of a raw device topic devicehub raw\ 16ac16f7 5e36 4ea0 8d00 17386c051281 > alias topics when you connect a device docid\ rfvijdxz7dbad8mwbisma , you have the option of using the enable alias topics option if you select to use alias topics for a device, then you won't be able to use raw topics as well each connected device can either use alias topics or raw topics, not both important when alias topics are enabled for a device, you can't use batch write topics to use batch write topics, you must not select the enable alias topics check box in the device configuration see connect a device docid\ rfvijdxz7dbad8mwbisma and manage devices docid uc67yvju fop8hagr3bb for more information when the enable alias topics check box is selected deviceid in the raw topic format is replaced with devicename tagid in the raw topic format is replaced with tagname alias topics use the following format devicehub alias {devicename} {tagname} example of an alias topic devicehub alias plc2 tag1 write topics write topics write data to a tag specific topic in the following topic format devicehub write {deviceid} {tagid } each device instance on the devicehub write {deviceid} topic receives all messages for the corresponding device the device instance executes a write to the specified tag on the connected device example of a write topic devicehub write f7f72687 2f29 46e7 95e2 b5532471ebaa 2d7473c0 83a0 4174 83cc b48a63c1b1cf batch write topics batch write topics can send multiple write requests simultaneously in the following format devicehub batch write {deviceid} important only gen 2 drivers can use batch write topics see the industrial systems connection guide docid\ q9scssqe xxk9dg9by8vr to review available gen 2 drivers this is only available for devices that don't select the enable alias topics check box in the device configuration you must use tags in the raw topic format see connect a device docid\ rfvijdxz7dbad8mwbisma and manage devices docid uc67yvju fop8hagr3bb for more information example of a batch write topic devicehub batch write 710b913b b915 4450 9122 8d57e803499b poll once topics poll once topics can be used to trigger a poll to a tag for data in the following topic formats if raw topics are enabled devicehub pollonce {deviceid} {tagid} if alias topics are enabled devicehub pollonce {devicename} {tagname} when a poll once topic is triggered by a message, manufacturing connect edge will get data for that tag and publish a message to the raw or alias topic for that tag example of a poll once topic devicehub pollonce f7f72687 2f29 46e7 95e2 b5532471ebaa 2d7473c0 83a0 4174 83cc b48a63c1b1cf topic formats the following table summarizes the types of device level and tag level topics, either with or without aliases you have the option of using raw topics or alias topics category topics notes device devicehub plcstatus {deviceid} subscription to a device status device devicehub manage {deviceid} to start/stop the device's connection device devicehub raw {deviceid} > publish/subscribe to all data from a specific device the ">" character represents a wildcard device devicehub plcstatus {devicename} to monitor the device's connection/disconnection status with alias topics enabled device devicehub manage {devicename} to start/stop the device connection with alias topics enabled device devicehub raw {devicename} > a wildcard to receive messages from all tags added to the device with alias topics enabled the ">" character represents a wildcard device devicehub batch write {deviceid} send multiple write requests simultaneously tag devicehub pollonce {deviceid} {tagid} trigger this topic to get data from a tag one time tag devicehub pollonce {devicename} {tagname} to receive data from a poll once raw topic with alias topics enabled tag devicehub raw {deviceid} {tagid} to receive data in raw format tag devicehub write {deviceid} {tagid} to write data tag devicehub alias {devicename} {tagname} to receive data in raw format with alias topics enabled tag devicehub write {devicename} {tagname} to write data with alias topics enabled events system events subscription to all system events