Devices Management
This reference manual breaks down each page of West Connectivity device connectivity feature set and provides descriptions of each component's functionality. All device connectivity offerings are located within the realm of your Connector page.
Devices
The Devices page is where you will add, list, and manage all your devices (real or simulated). Once you have populated your list of devices, you will have the capability to search, sort, and filter your device list to suit your needs.
When you click the “+ NEW DEVICE(S)” button, you will have the option to add one device or many devices at once. Depending on your account tier, there may be a limit on the number of devices you are able to add.
You can also add multiple devices in Bulk.
Devices information are powered by the West Connectivity Device2 Micro-Service and are accessible from scripting. To Connect devices use one of the supported Device APIs.
Locking
This feature allows West Connectivity administrators to revoke the communication privileges on a per-device basis. Marking a device as locked will cause all connection attempts by the device to be ignored. This can be useful, for example, in development or during in-field management to temporarily disable device communications.
Tags
Tags are static device metadata enabling fast and flexible devices search and filtering.
In opposite to the device state, defined from the Connector resources and which holds dynamic data sent to and by the device, tags are not accessible to the device.
Powered by the Device2 Service a tag is a pair of a Tag Name
and a Tag Value
. Multiple pairs with the same Tag Name
with multiple values are possible.
Searching by Tags
Tags' main benefit is to enable efficient device search & filtering.
On the Connector Devices
tab, each entry have their tags displayed under the tags column.
By default the list of tag names is visible. You can display values for a given tag by selecting the tag name in the header drop down.
This will automatically filter all devices having a value for this tag. Once selected, you can now search devices by the selected tag value in the search box.
Adding tags
On each device details page, you can have a full view and control of the tags. Including the ability to add, update or delete Tags.
Note
- 1 tag name can hold multiple values.
- When provisioning devices in Bulk, you can provide the tags as part of the provided CSV document.
- The maximum of tags is 100.
Limitation: Tags cannot be set through the Device API.
Permission
User can set device permission to allow what device as a publisher or what topic this device could accept.
- Publisher: User can choose many devices as the publisher
- Topic: Set the topics which are allowed, See Subscribing data for more details.
Note
- Publisher means a specific device which can publish data on behalf of the target device, the publisher should be in same Connector with target device. See Publishing data for more details.