Create from scratch
Last updated
Last updated
In the left menu, click on Device Types.
If no device type has been created within your organization yet, the Device Types - Create your first device type page will be displayed.
Otherwise, the Device Type page will be displayed, showing the list of previously created device types.
In the Widgelix IoT cloud platform, you have the flexibility to add new devices individually through the Create option or import them using the Load From Repository option.
Click the +Create Device Type or +Create button, depending on the page you are on.
The Device Type page will be displayed, which consists of the following tabs: About, Uplink Data, Downlink Data, Tags, Additional Parameters, and Widgets.
The About tab allows you to provide basic information about your device type:
In the Name text box, enter the name of the device.
In the Description text box, enter a short description including what the device is intended for.
In the Manufacturer text box, enter the name of the device manufacturer.
Click on the picture box to browse and upload an image of the device.
Click on the + Map Marker button and select a suitable icon for your device. You can also use the Search box to find the icon by typing its name, for example, 'temperature'.
Click on the Next button.
You will be directed to the Uplink Data tab.
The Uplink Data tab allows you to provide information about the uplink data that is being sent from your device.
This section is optional, and you may skip it without providing uplink information.
In the Code text area, type or paste the uplink payload formatter code, which is written in JavaScript.
Ensure that the uplink payload formatter code has thedecode()function.
Here is an example of an uplink payload formatter code:
To test the uplink payload formatter, enter the binary payload in HEX into the Payload text box and then click on the Run button.
Here is an example of a binary payload in HEX that you can use with the above uplink payload formatter:
D0FFFFFF2500000001000000020000007FFF00FF00240C01
If it is valid, the decoded payload will display in the Output text area and it will look something like this:
In the Data Fields section, you can add keys that allow you to extract data from the payload.
In the Name text box, enter the key of the data field exactly as it appears in your uplink payload formatter. For example, according to the above uplink payload formatter code, the keys to be used are lastColorRed, lastColorBlue, lastColorGreen,lastColorOnTime, lastColorOffTime, messagesReceived, messagesSent, swRev, hwRev, adrState, rssi and snr.
Select the appropriate unit of measurement (if applicable) from the Units drop-down list.
Type the minimum and maximum values (if applicable) for the measurement in the Min and Max text boxes, respectively.
Click on the + button to add more data fields.
Alternatively, you can load the data fields in bulk from the decoded payload in the format of JSON object literal:
Click on the Load From Payload button.
Type or paste your JSON object literal in the Load Data Fields from Payload modal.
Click on the Load button.
The field names (keys) will be automatically filled in from the JSON object literal. Then, you can manually set units, min, and max values.
Widgelix also supports extracting the device id and device position (only applicable if the device has GPS support) from the payload:
Take device id from payload: First, turn on the 'Take device id from payload' slider button. In the Field name for device ID, type the key exactly as it appears in your uplink payload formatter.
Take position from payload: First, turn on the 'Take position from payload' slider button. In the Latitude field name and Longitude field name, type the keys exactly as they appear in your uplink payload formatter.
Click on the Next button.
You will be directed to the Downlink Data tab.
The Downlink Data tab allows you to provide information about the downlink data that is being received by your device.
This section is optional, and you may skip it without providing downlink information.
In the Code text area, type or paste the downlink payload formatter code, which is written in JavaScript.
Ensure that the downlink payload formatter code has thedecode()function.
Here is an example of a downlink payload formatter code:
To test the downlink payload formatter, type or paste its JSON payload (JSON object literal) into the Payload text box and then click on the Run button.
Here is a sample JSON payload you can use to test the downlink payload formatter code listed above:
If it is valid, the encoded binary payload in HEX will display in the Output text box and it will look something like this:
Click on the Next button.
You will be directed to the Tags tab.
The Tags tab allows you to add tags for your device type.
Tags are useful for easily finding and organizing your device types later on.
This section is optional, and you may skip it without adding any tags.
To add a tag to a device type, simply type the tag and press ENTER. You can add any number of tags that are related to your device type. For example, if the device type is a beacon, you can use tags like busy indicator, status light, and class C.
Click on the Next button.
You will be directed to the Additional Parameters tab.
The Additional Parameters tab allows you to provide additional parameters for your device type.
This section is optional, and you may skip it without providing additional parameters.
In the Additional Parameters tab, you can enable extracting radio parameters and battery parameters from the uplink payload.
Radio: Enabling the Radio option decodes RSSI and SNR from the payload.
Turn on the Take radio parameters from payload slider button.
In the Field name for RSSI and Field name for SNR text boxes, type the keys exactly as they appear in your uplink payload formatter.
Battery: Enabling the Battery option decodes battery voltage from the payload.
Turn on the Take battery parameters from payload slider button.
In the Field name for battery value text box, type the key exactly as it appears in your uplink payload formatter.
In the Power consumption per cycle, mAh text box, enter the power consumption of your device per transmission in mAh.
Select the battery type/chemistry from the Battery type drop-down list.
In the Capacity text box, enter the battery capacity in mAh.
Click on the Next button.
You will be directed to the Widgets tab.
The Widgets tab allows you to select the widgets that you want to use for data visualization in order to gain a better understanding of the data.
In the Widgets tab, click on the +Add Widget button.
In the Select Widget modal, click on the widget type that you want to add, for example, Chart.
The complete instructions on how to configure each widget type can be found on the Widgets page.
After adding the necessary widgets, click on the Save button to add the device type to your organization.
The new device type is listed on the Device Type page.
