...

The Device Types widget provides the ability to create, view, and edit device types. Device type definition (DTD) files are CSV files that list the device type names, program identifier (ID), application image names, and graphics assets to be used as icons for specified device types. These file use a .dtd extension. 

You first have to import any XIF files (see Collecting or Creating Device Definitions), resource files, application image files, system image files, and graphics files that you plan to use. When an XIF file that does not already have an associated device type defined is imported, a default device type will be created with the device type name equal to the XIF file name, the protocol and program ID set from the XIF file, and the graphics file set to a default device icon.

Once imported, you will be able to create new device types in the Device Types widget, and since the referenced files are already available in the database, you will only have to type a device type name (all the other entries will be selections from pull-down lists).

You can create a device type package (DTP) file that is an archive file that contains assets, resources, and definitions for defining new device types using the Export feature on the Device Types widget.

Users with Administrator, Owner, Controller, or Tenant roles can use this widget to create, modify, and delete device types datapoints within the geozones where they have the Administrator, Owner, Controller, or Tenant roles.  

Creating a Graphics File

You can specify a graphics file to customize the image displayed for a device type.  You can supply the graphics file as a .JPG or .PNG. file.  Files with a .JPG extension are interpreted as JPEG files, as defined by ISO/IEC 10918-1. Files with a .PNG extension are interpreted as Portable Network Graphics files, as defined by ISO/IEC 15948. 

...

You can create a device type using the Device Types widget. To do so, perform the following steps:

1. Open the SmartServer IoT CMS and go to CMS.
   
   
2. Open the Device Types widget. Click the Expand button (  ). 
   
   
   
   
3. Click the Create Device button ().
   
   
   
   
4. Enter the device type parameters as appropriate, including:
   
   
   • Device Type – a unique name for the device type
   • Protocol – the communications protocol (BACnet, EnOcean for local EnOcean interface, LON, LoRaWAN, Modbus, iotc for remote EnOcean interface)

   • XIF File – provides the ability to upload an XIF file plus a list of all available XIF files with the selected protocol in the SmartServer CMS database

   • Program ID – read-only field with the program ID of the selected XIF file

   • Default Application Image – provides the ability to upload an application image file plus a list of all available application image files with the selected protocol in the SmartServer CMS database. (For SmartServer IoT 2.5, this option is only available for LON devices.)
     

   • Automatic Application Image Load – indicates if the default application image must be loaded upon initial provisioning a device of the specified type. The default value is cleared. It is cleared and grayed out if a Default Application Image is not selected
     

   • Default System Image – provides the ability to upload a system image file plus a list of all available system image files with the selected protocol in the database.  (For SmartServer IoT 2.5, this option is only available for LON devices.)

   • Automatic System Image Load – indicates if the default system image must be loaded upon initial provisioning a device of the specified type. The default value is cleared. It is cleared and grayed out if a Default System Image is not selected.

   • Graphics File – provides the ability to upload a graphics file plus a list of all available graphics files in the SmartServer CMS database
     
     

   
   Create Device Type settings
   
   
   Create Device Type settings – LON example
   
   
   Create Device Type settings – EnOcean example
   
   

5. Click SAVE to create the new device type.

...

To set a filter, perform the following steps:

1. Open the SmartServer IoT CMS and go to CMS.
   
   
2. Open the Device Types widget. Click the Expand button (  ). 
   
   
   
   
3. Click the Set Filter button ().
   
   
   
   The Set filters view appears.
   
   
   
   
4. Enter the search criteria. Click the down arrow to select the filter options (i.e., by name, segment controller, XIF file, driver, and/or program ID) and click the plus sign ( ) to add filters.
   
   
   
   
5. Click Apply Filters.
   
   The results below show the name filter results for Segment Controller = smartserver-17qes5s and Device = Tstat-01.
   
   
   
   The Device Types widget display includes:
   
   

   • Device Type – the device type name

   • Driver – the protocol specified by the device template

   • Device Count – the number of defined devices implementing the device template

   Each heading has a Sort button (). When clicked, the device type list is sorted in forward or reverse order by the selected heading.
   
   

6. The Reset Filter button () clears the filter settings.

...

You can copy a device type using the Device Types widget. To do so, perform the following steps:

1. Open the SmartServer IoT CMS and go to CMS.
   
   
2. Open the Device Types widget. Click the Expand button (  ). 
   
   
   
   
3. Click the Action button () and select the Copy action.
   
   
   
   
4. Enter a new device type name, and select the XIF file, default application image file (for SmartServer IoT 2.5, LON device support only), default system image file (for SmartServer IoT 2.5, LON device support only), and graphic file as appropriate. 
   
   The Automatic Application/System Image Load checkbox indicates if the default application/system image must be loaded upon initial provisioning a device of the specified type. The default value is cleared. It is cleared and grayed out if a Default Application/System Image is not selected.
   
   
   
   
5. Click SAVE to copy device type.

...

You can edit a device type using the Device Types widget. To do so, perform the following steps:

1. Open the SmartServer IoT CMS and go to CMS.
   
   
2. Open the Device Types widget. Click the Expand button (  ). 
   
   
   
   
3. Click the Action button () for the selected device type and select the Edit action.
   
   
   
   
4. Edit the device type parameters as appropriate, including:
   
   
   • Device Type
   • XIF File
   • Default Application Image
   • Default System Image
   • Graphic File
   • Automatic Application/System Image Load checkbox
     

...

You can remove a device type using the Device Types widget. To do so, perform the following steps:

1. Open the SmartServer IoT CMS and go to CMS.
   
   
2. Open the Device Types widget. Click the Expand button (  ). 
   
   
   
   
3. Click the Action button () and select the Remove action.
   
   
   
   
4. Click OK in the confirmation dialog box to remove the selected device type.
   
   

...

You can remove multiple device types using the Device Types widget. To do so, perform the following steps:

1. Open the SmartServer IoT CMS and go to CMS.
   
   
2. Open the Device Types widget. Click the Expand button (  ). 
   
   
   
   
3. Click the checkmark for the device types you wish to remove from the Device Types widget, or click the Select All button () to select all device types.
   
   The checkmark changes from blue to yellow.
   
   
   
   
4. Click the Action button () and select the Remove Selected Device Types action.
   
   
   
   
5. Click OK in the confirmation dialog box to remove the selected device types.

   
   

   

...

A DTD file contains the following columns (headings and values are not case sensitive):

...

1. If you are importing LoRaWAN or remote EnOcean interface device types for SmartServer Pi 4.3, then first perform the steps found in (Optional) Importing LoRaWAN and Remote EnOcean Device Types (Release 4.3)/wiki/spaces/TEMP/pages/384270337
   
   
2. Open the SmartServer IoT CMS.
   
   
3. Click the Import / Export button () on the CMS dashboard.
   
   
   
   
   The Import / Export dialog appears.
   
   
   
   
4. Select the device types file to be imported and place it in the Drop Files to Import or Browse box.
   
   
   
   
5. Click IMPORT.
   
   Notification messages (similar to the one shown below) will appear indicating that device types are being uploaded and the CPU usage on the main CMS page will show increased activity. 
   
   
   
   
6. When the device types file has finished loading, click CANCEL to close the Import / Export dialog.

Exporting a Device Type

You can export your device type definitions to a device type definition (DTD) file from the Device Types widget.  You can use this capability to export a set of device type definitions to any number of new SmartServers in a single operation per SmartServer.

To export a device type, perform the following steps:

1. Open the SmartServer IoT CMS and go to CMS.
   
   
2. Open the Device Types widget. Click the Expand button (  ). 
   
   
   
   
3. Click the Action button () and select the Export action.
   
   
   
   
4. Enable or disable the Download as Package option.  If you enable Download as Package when you click Export the CMS creates a device type definition (DTD) file with your selected device type definitions, creates a device logging and alarming (DLA) file with your DLA specifications, collects all of your other device type definition files including resource files, CON files, and graphics files, and packages them into a single zip archive called the device type package (DTP).  If you do not enable Download as Package, the CMS creates the DTD file but does not package all the dependent files with it.  You can use the DTP file to specify the same device type definitions on multiple SmartServers.  You can collect all your device type definition files on one SmartServer, use it to create a DTP file, and then import the DTP file on your other SmartServers using the Import action that is available through the Device Types widget.
   
   
   
   
5. Click DOWNLOAD ALL to export the device type.

...

To export multiple device types, perform the following steps:

1. Open the SmartServer IoT CMS and go to CMS.
   
   
2. Open the Device Types widget. Click the Expand button (  ). 
   
   
   
   
3. Click the checkmark for the device types you wish to export on the Device Types widget, or click the Select All button () to select all device types.
   
   The checkmark changes from blue to yellow.
   
   
   
   
4. Click the Action button () and select the Export Selected Device Types action.
   
   
   
   
5. Enable or disable the Download as package option.
   
   The Export feature saves a DTP containing DTDs for the selected device types, and all dependent files if the Download as a package option is selected, or DTDs for the selected device types and all dependent files if the Download as a package option is not selected. 
   
   
   
   
6. Click DOWNLOAD ALL to export the device types.

...