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.


LON device interface (XIF)
File TypeFile ExtensionDevice TypeNotes and References

Device Interface (XIF) Definitions

BACnet device interface (BACnet XIF ) definitiondefinition.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) EnOcean local mode XIF definition

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

EnOCean local mode

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

.

EnOcean remote mode XIF definition.IOTC or iotc
(cannot use .iotc.csv)
EnOcean remote mode

See (Optional) Creating a Remote EnOcean Device Interface (XIF) Definition.

LON XIF definition

.xif

LON 

  • Provided by the device manufacturer, or created by the LON Compiler (NodeBuilder) or by NodeUtil

  • 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).

LoRaWAN device interface (XIF) LoRaWAN XIF 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 LoRaWAN Device Interface (XIF) Definition.Modbus device interface (XIF) definition 

Modbus XIF definition

.mod
(cannot use .mod.csv)

Modbus

  • Prepared by a network integrator

  • CSV format

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

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

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

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

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

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

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

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

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

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

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

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

See Backing Up, Restoring, and Cloning the SmartServer.

Software executable

.exe

N/A

  • Contains a software program

SmartServer Pi
SmartServer Pi software

.tar.gz

.deb

N/A

SmartServer Pi software file used for system installation or update

See Installing SmartServer Pi and Updating the SmartServer Pi.