Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The table below provides an overview of the SmartServer file types. File extensions are not case sensitive.

SmartServer Pi (available with SmartServer 4.2 and higher) does not support LON.


File TypeFile ExtensionDevice TypeNotes and References

Device Interface (XIF) Definitions

BACnet device interface (XIF) definition.bac
(cannot use .bac.csv)
BACnet IP devices and
BACnet MS/TP devices
  • Prepared by a network integrator, or created automatically during device discovery

  • BACnet must first be enabled using the Add a BACnet Interface before importing files

  • CSV format

See (Optional) Creating a BACnet Device Interface (XIF) Definition.

EnOcean device interface (XIF) definition

.ENO or eno
(cannot use .eno.csv)

EnOCean

See (Optional) Creating an EnOcean Device Interface (XIF) Definition.

LON device interface (XIF) definition

.xif

LON 

  • Provided by the device manufacturer, or created by the LON Compiler (NodeBuilder) or by NodeUtil
    Valid extension: .xif

  • If the device uses custom resource files set, then you will also need to convert the resource files set to .xml files and import them into the SmartServer prior to importing the .xif file, or as part of a .dtp file with both the .xml and .xif files.

See (Optional) Creating a LON Device Interface (XIF) Definition.

See (Optional) Creating IAP Resource Definitions (XML).

BACnet device interface LoRaWAN device interface (XIF)  definition

.bac

BACnet IP devices and
BACnet MS/TP devices

Prepared by a network integrator, or created automatically during device discovery
BACnet must first be enabled using the Add a BACnet Interface before importing files
CSV format
Valid extension: .bac (cannot use .bac.csv)

definition

.LoRaWAN, .csv, or .LoRaWAN.csv

LoRaWAN

  • Requires a LoRaWAN Gateway to be set up, the LoRaWAN driver to be enabled, and ChirpStack to be installed. See (Optional) Add a LoRaWAN Interface or (Optional) Add a LoRaWAN Interface for SmartServer Pi (Release 4.2) depending on your environment.

  • The base name is the part of the XIF filename that precedes the extension.
    • Example: if the XIF filename is NetvoxR712V2.LoRaWAN, then the base name is NetvoxR712V2 and the extension is .LoRaWAN
    • If NetvoxR712V2.LoRaWAN and NetvoxR712V3.LoRaWAN are identical in content including the program ID, then they will be treated as two different XIFs because of the different XIF filenames.

  • The filename must match the device profile name in ChirpStack.

  • CSV format

See (Optional) Creating a BACnet LoRaWAN Device Interface (XIF) Definition.

Modbus device interface (XIF) definition 

.mod
(cannot use .mod.csv)

Modbus

  • Prepared by a network integrator

  • CSV format

  • Valid extension: .mod (cannot use .mod.csv)

See (Optional) Creating a Modbus Device Interface (XIF) Definition.

Neuron firmware or application image file for a LON device that supports downloadable firmware

.apb

LON

  • Supplied by LON device manufacturers, or automatically produced by your development tools if you are developing LON devices
    Valid extension: .apb

See Collecting or Creating Device Definitions.

BACnet Server

BACnet type mapping definition

.btm
(cannot use .btm.csv)

IOX, LON, Modbus, BACnet

  • Allows BACnet tools to see non-BACnet devices (e.g., LON, Modbus)

    • Provides a BACnet interface to any field devices available on your SmartServer, independent of the protocols used to communicate with the devices

    • Provides a customized BACnet interface to BACnet devices provisioned on the SmartServer

  • Prepared by a network integrator

  • BACnet must first be enabled using the Add a BACnet Interface before importing files

  • CSV format

  • Valid extension: .btm (cannot use .btm.csv)

See Add a BACnet Interface.

CMS Configuration 

Datapoint logging and alarming definition

.dla

IOX, LON, Modbus, BACnet

See Defining Datapoint Properties.

Device type definition 

.dtd

IOX, LON, Modbus, BACnet

  • Lists the device type names, program identifier (ID), application image names, and graphics assets to be used as icons for specified device types

  • Created using the CMS Device Types widget

  • CSV format

  • Valid extension: .dtd

See Defining Device Types.

Connection definitions

.con, .csv, or .con.csv

IOX, LON, Modbus, BACnet

  • Define connection templates that specify how datapoint outputs are connected to datapoint inputs

  • CSV format

  • Valid extensions: .con, .csv, .con.csv

See Setting up Datapoint Connections.

Graphics file

.jpg, or .png
(.jpg extensions are interpreted as jpeg files)

IOX, LON, Modbus, BACnet

  • Customizes the image displayed for a device type
    Valid extensions: .jpg.png(.jpg extensions are interpreted as jpeg files)

See Collecting or Creating Device Definitions.

Sequencing flows.jsonIOX, LON, Modbus, BACnet
  • Define a "sequence of operations" (i.e., flows) anddashboards to automate everyday tasks

  • Create instrument panels and dashboards for visualization
    Valid extension: .json

See Creating Sequence of Operations and SmartServer IoT Node-RED Tutorial.

Device Archive 

Device type package

dtp.gdtp, .zip.gzip, or .dtp.zip

IOX, LON, Modbus, BACnet

  • Provides a single-file package that contains multiple files for defining device types and datapoint properties in a single step using the CMS Devices widget

  • Created using the Export feature on the Device Types widget

  • ZIP format
    Valid extensions: .dtp, .gdtp, .zip.gzip, .dtp.zip

See Defining Device Types.

Datapoints Definitions
Datapoints file.data.csvIOX, LON, Modbus, BACnet
  • Provides a file defining the datapoint properties (such as device, block, block index, datapoint, datapoint XIF name, datapoint type, and so on)

  • Can be used to change the datapoint type
    Valid extension: .data.csv

See Modifying Datapoint Types.

SmartServer IoT Software

SmartServer software update/reimage

.zip

N/A

See Updating with the SmartServer Console and Updating with the SmartServer Configuration Page.

SmartServer software update

.glpo

N/A

  • SmartServer software file used for system updates performed through the SmartServer CMS

  • Points to the .glpi file, which controls update process

  • Files may be downloaded from the Software Downloader links provided in the SmartServer Release Notes section

  • Valid extension: .glpo

See Updating using the SmartServer CMS.

SmartServer software update

.glpi


N/A

  • SmartServer software file used for system updates performed using the SmartServer CMS

  • Controls the update process
    Valid extension: .glpi

See Updating using the SmartServer CMS.

SmartServer system backups

.tgz

N/A

  • File creation date is included in the name in the following format: SmartServer-System-Backup-yyyy-mm-dd-hhmmss.tgz

  • Valid extension: .tgz

See Backing Up, Restoring, and Cloning the SmartServer.

SmartServer database backups

.zip

N/A

  • File creation date is included in the name in the following format: SmartServer-DB-Backup-yyyy-mm-dd-hhmmss.zip

  • Valid extension: .zip

See Backing Up, Restoring, and Cloning the SmartServer.

Software executable

.exe

N/A

  • Contains a software program

  • Valid extension: .exe

SmartServer Pi
SmartServer Pi software.debN/A

SmartServer Pi software file used for system installation or update

Valid extension: .deb

See Installing SmartServer Pi and Updating the SmartServer Pi.