{"type":"doc","content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Local EnOcean Interface is supported with SmartServer 4.0 and higher.","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"You can download, create, and modify a device interface (XIF) definition for an EnOcean device using local mode. An EnOcean XIF definition specifies the name, program ID, manufacturer, and datapoints in a device. ","type":"text"}]},{"type":"paragraph","content":[{"text":"This page includes the following sections and applies to local EnOcean interface:","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"maxLevel":{"value":"3"}},"macroMetadata":{"macroId":{"value":"fea0cba6-ec9c-442a-be7b-15045d71440b"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"9e7cbfb6-22c3-47ef-8086-f6e448fa6c96"}},{"type":"paragraph","content":[{"text":"For remote mode, see ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"(Optional) Creating a Remote EnOcean (Beta) Device Interface (XIF) Definition","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/394006786"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Creating a Local EnOcean XIF File","type":"text"}]},{"type":"paragraph","content":[{"text":"For a local EnOcean XIF definition, create a CSV file with an ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":".eno","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" extension defining the EnOcean device interface. The name of the EnOcean XIF file, without the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":".eno ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":"extension, is the name of the EnOcean XIF. The extension must be ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":".ENO","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" or ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":".eno","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"You cannot use a compound extension name (i.e., ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":".eno.csv","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":"). To monitor, log, or generate alarms based on datapoint values for an EnOcean datapoint, set the datapoint properties for the datapoint as described in ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Defining Datapoint Properties","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/2198640"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"An EnOcean XIF file has the following three sections.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A file type specification that identifies the file as an EnOcean XIF file.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A product details section that specifies the program ID, version, product name, and manufacturer for the EnOcean device.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A datapoint list that specifies the datapoints on the device to be available to the SmartServer. The first line of the datapoint list is a header with column headings for a datapoint list. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]},{"type":"paragraph","content":[{"text":"The following figure shows the top portion of an EnOcean XIF file:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"codeBlock","content":[{"text":"#filetype,EnOcean_xif\n#program_ID,8A000BD21441E001\n#version,v02\n#product_name,STM550 Multisensor\n#manufacturer,EnOcean\nDatapoint Name,IAP Type,Block Name,Block Index,Address,Write Enable,Precision,Receive Timeout","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"File Type Specification","type":"text"}]},{"type":"paragraph","content":[{"text":"Identify an EnOcean XIF file with an ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"EnOcean_xif ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":"filetype specification as shown in the following example:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"codeBlock","content":[{"text":"#filetype,EnOcean_xif","type":"text"}]},{"type":"paragraph","content":[{"text":"If you open a CSV file with this line in Excel, it is displayed as two cells, one with ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"#filetype","type":"text","marks":[{"type":"strong"}]},{"text":" and one with ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"EnOcean_xif","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Product Details","type":"text"}]},{"type":"paragraph","content":[{"text":"Provide details about the product hosting the XIF described in the EnOcean XIF file with the program_ID, version, product_name, and manufacturer specifications as shown in the following example:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"codeBlock","content":[{"text":"#program_ID,\n#version,\n#product_name,\n#manufacturer,","type":"text"}]},{"type":"paragraph","content":[{"text":"If you open a CSV file with these lines in Excel, each line is displayed as two cells.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"Specify the details as follows:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Program ID","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"em"}]},{"text":"> – (required) in the 3 bytes comprising the Device Class and Usage fields (the 4th, 5th, and 6th bytes), the program ID contains the EnOcean Equipment Profile (EEP) values. The EEP informs","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" the EnOcean driver how to decode the radio telegrams that it receives for this device type, based on a set of profiles that are built into the ","type":"text"},{"text":"EoLink ","type":"text","marks":[{"type":"strong"}]},{"text":"library code used by the driver. As of SmartServer 4.0, there are about 100 different profiles built into the EoLink library. The program ID can optionally have delimiters on 8-bit boundaries (e.g., ","type":"text"},{"text":"8A000BD21441E001","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":", or 80:00:0B:D2:14:41:E0:01 with delimiters).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"Version","type":"text","marks":[{"type":"em"}]},{"text":"> – (optional) version of the device.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"Product Name","type":"text","marks":[{"type":"em"}]},{"text":"> – (optional) manufacturer's name for the device.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"Manufacturer","type":"text","marks":[{"type":"em"}]},{"text":"> – (optional) device manufacturer.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Example product details specifications for an ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"STM550","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":" Multisensor are shown below.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"codeBlock","content":[{"text":"#program_ID,8A000BD21441E001\n#version,v02\n#product_name,STM550 Multisensor\n#manufacturer,EnOcean","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Datapoint List","type":"text"}]},{"type":"paragraph","content":[{"text":"An EnOcean XIF describes a set of datapoints that are embedded in a single EnOcean radio telegram from an EnOcean device.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"The first line of the datapoint list is a header with column headings for a datapoint list as shown in the example below.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"codeBlock","content":[{"text":"Datapoint Name,IAP Type,Block Name,Block Index,Address,Write Enable,Precision,Receive Timeout","type":"text"}]},{"type":"paragraph","content":[{"text":"The following table describes the column contents for the datapoint list. You can arrange the columns in any order; the SmartServer uses the name in the heading row entry to identify the contents of the column. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"table","attrs":{"layout":"center","width":766.0,"localId":"5c877eb3-710a-448e-b5d9-03bfca6cb02b"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Required/","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"type":"hardBreak"},{"text":"Optional","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[507.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"Datapoint Name","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Required","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[507.0]},"content":[{"type":"paragraph","content":[{"text":"The datapoint XIF name. This is a descriptive name to identify the datapoint.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"IAP Type","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Required","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[507.0]},"content":[{"type":"paragraph","content":[{"text":"An IAP type specifies the data encoding for a datapoint, the datapoint value appearance in IAP/MQ, and identifies the datapoint type to be reported in IAP/MQ when a datapoint update is published to IAP/MQ. ","type":"text"}]},{"type":"paragraph","content":[{"text":"An IAP type may also specify the semantic meaning of a datapoint. ","type":"text"},{"text":"Each driver may support a different subset of IAP types for the native types.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"text":"The following IAP types are defined:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Base types","type":"text","marks":[{"type":"em"}]},{"text":" – ","type":"text"},{"text":"bit","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"},{"text":" boolean","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"sint8","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"uint8","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"uint16","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"},{"text":" sint16","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"uint32","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"sint32","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"uint64","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"sint64","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"float","type":"text","marks":[{"type":"strong"}]},{"text":", and ","type":"text"},{"text":"float32","type":"text","marks":[{"type":"strong"}]},{"text":". Base type values are case-sensitive and must use lower-case letters.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Standard types","type":"text","marks":[{"type":"em"}]},{"text":" – the types listed in the ","type":"text"},{"text":"SNVT","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"SCPT","type":"text","marks":[{"type":"strong"}]},{"text":", and ","type":"text"},{"text":"ENUM","type":"text","marks":[{"type":"strong"}]},{"text":" sections of ","type":"text"},{"text":"Online Resource Files - LonMark","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.lonmark.org/technology/technical-resources/functional-profile/"}}]},{"text":". As of SmartServer 3.2, the IAP standard resource file set is based on the version 16.00 LonMark standard resource file set and the version 2.01 IoT resource file set. These types are made available to IAP applications by the Resource Publisher. ","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Custom types","type":"text","marks":[{"type":"em"}]},{"text":" – types defined by a custom IAP resource file set. Custom types are defined by an XML format export from the IzoT Resource Editor. Custom IAP resource file sets include a program ID and a scope identifier that specifies a mask for the program ID. The scope ID may be 3, 4, 5, or 6 corresponding to program ID masks of 0xFFFFFF0000000000 for 3, 0xFFFFFFFFFF000000 for 4, 0xFFFFFFFFFFFFFF00 for 5, and 0xFFFFFFFFFFFFFFFF for 6. Custom types are specified as <","type":"text"},{"text":"program ID","type":"text","marks":[{"type":"em"}]},{"text":">","type":"text"},{"text":"-","type":"text","marks":[{"type":"strong"}]},{"text":"<","type":"text"},{"text":"scope","type":"text","marks":[{"type":"em"}]},{"text":">","type":"text"},{"text":"/","type":"text","marks":[{"type":"strong"}]},{"text":"<","type":"text"},{"text":"type name","type":"text","marks":[{"type":"em"}]},{"text":"> where the <","type":"text"},{"text":"program ID","type":"text","marks":[{"type":"em"}]},{"text":">","type":"text"},{"text":"-","type":"text","marks":[{"type":"strong"}]},{"text":"<","type":"text"},{"text":"scope","type":"text","marks":[{"type":"em"}]},{"text":"> specification is the set identifier. ","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"Block Name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[507.0]},"content":[{"type":"paragraph","content":[{"text":"Block XIF name for the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]},{"text":"datapoint","type":"text"},{"text":". ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]},{"text":"If ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"not specified","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]},{"text":" because the column does not exist or the existing column has no entry, then the block name will be ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"block","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"Block Index","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[507.0]},"content":[{"type":"paragraph","content":[{"text":"Specifies a numeric block index. The block index can be any positive (>=0) integer value and is not required to be sequential. ","type":"text"},{"text":"If not specified, the block index will be zero.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"Example: for a device with 8 digital outputs, you can define 8 blocks, each named DO, using indexes 0 through 7 (it is not required for the index names to be sequential and they may not start with zero).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"Address","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Required","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[507.0]},"content":[{"type":"paragraph","content":[{"text":"Identifies the datapoint that the driver is interested in. ","type":"text"},{"text":"Address","type":"text","marks":[{"type":"strong"}]},{"text":" refers to the name of one of the EoLink ","type":"text"},{"text":"channels","type":"text","marks":[{"type":"strong"}]},{"text":" for the device type. ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"Write Enable","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Required","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[507.0]},"content":[{"type":"paragraph","content":[{"text":"Specify read-only (","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"-","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":") for an EnOcean device. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"Native 1 Value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[507.0]},"content":[{"type":"paragraph","content":[{"text":"Specifies the first of two native values for the datapoint. To specify scaling for a datapoint, specify two scaled values for the datapoint. The SmartServer uses the two sets of values to determine the scaling factors for converting a native value to an IAP value, as well as to convert an IAP value to a native value. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Example, a native value can be scaled to an IAP value with the following:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]}]},{"type":"paragraph","content":[{"text":"Scaled Value = ((Native Value - Native Value 1) * ((Scaled Value 2- Scaled Value 1) / (Native Value 2- Native Value 1))) + Scaled Value 1","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Example, an IAP value can be scaled to a native value with the following:","type":"text"}]},{"type":"paragraph","content":[{"text":"Native Value = ((Scaled Value - Scaled Value 1) * ((Native Value 2 - Native Value 1) / (Scaled Value 2 - Scaled Value 1))) + Native Value 1","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"If a Native Value 1 value is specified, the Native Value 2, Scaled Value 1, and Scaled Value 2 values are required.","type":"text"}]},{"type":"paragraph","content":[{"text":"For Celsius to Fahrenheit conversion: 0 deg C = 32 deg F, and 100 deg C = 212 deg F","type":"text"},{"type":"hardBreak"},{"text":"Native Value 1 = 0, Scaled Value 1 = 32 ","type":"text"},{"type":"hardBreak"},{"text":"Native Value 2 = 100, Scaled Value 2 = 212","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"Native Value 2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[507.0]},"content":[{"type":"paragraph","content":[{"text":"Specifies the second of two native values for the datapoint. If a Native Value 2 value is specified, the Native Value 2, Scaled Value 1, and Scaled Value 2 values are required. See the Native Value 1 parameter for usage and value requirements. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"Scaled Value 1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[507.0]},"content":[{"type":"paragraph","content":[{"text":"Specifies the first of two scaled values for the datapoint. If a Scaled Value 1 value is specified, the Native Value 1, Native Value 2, and Scaled Value 2 values are required. See the Native Value 1 parameter for ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]},{"text":"usage","type":"text"},{"text":", value requirements, and backward compatibility requirements. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"Scaled Value 2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[507.0]},"content":[{"type":"paragraph","content":[{"text":"Specifies the second of two scaled values for the datapoint. If a Scaled Value 2 value is specified, the Native Value 1, Native Value 2, and Scaled Value 1 values are required. See the Native Value 1 parameter for usage, value requirements, and backward compatibility requirements. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"Precision","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[507.0]},"content":[{"type":"paragraph","content":[{"text":"Controls the number of decimals that will appear following a decimal point.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"Receive Timeout","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[507.0]},"content":[{"type":"paragraph","content":[{"text":"Implements a per-device timeout in seconds.","type":"text"}]},{"type":"paragraph","content":[{"text":"This parameter is intended for event-driven datapoint updates. If the timeout elapses without any new datapoint data appearing, then the device will transition to ","type":"text"},{"text":"health : down","type":"text","marks":[{"type":"strong"}]},{"text":". Once new datapoint data appears, the timer is reset, and the device will transition to ","type":"text"},{"text":"health : normal","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"The Receive Timeout value only needs to appear in the XIF for a single datapoint (typically the first one). If multiple datapoints have this value, then the last one has the setting advantage.","type":"text"}]},{"type":"paragraph","content":[{"text":"This timeout should be configured based on the expected rate of data messages from the edge devices. Some EnOcean devices will only present data at a rate of up to 30 minutes (unless there is a change in data that would result in a new update).","type":"text"}]},{"type":"paragraph","content":[{"text":"Other types may never present data unless a change occurs (e.g., the Rocker Switch devices). For these device types, Receive Timeout cannot be used.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Importing an EnOcean XIF File","type":"text"}]},{"type":"paragraph","content":[{"text":"You can import a EnOcean XIF file that you downloaded or created as described in the previous sections. The XIF file may be standalone, or it may be embedded in a device type package (","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]},{"text":".dtp","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}},{"type":"strong"}]},{"text":") file. A device type package file is a Zip archive containing multiple definition files. To import an EnOcean XIF or device type package file, follow these steps:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the SmartServer CMS","type":"text","marks":[{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/539099391"}}]},{"text":".","type":"text"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click the","type":"text"},{"text":" Import / Export button","type":"text","marks":[{"type":"strong"}]},{"text":" (","type":"text"},{"type":"mediaInline","attrs":{"width":50,"alt":"image-20250217-211457.png","id":"0872fdc0-b7fd-4729-96e8-2ad9a1504315","collection":"contentId-289965592","type":"image","height":56}},{"text":") on the CMS dashboard.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":790,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1920,"alt":"image-20250217-211513.png","id":"592669a9-0998-43ee-9b85-54036ec43b74","collection":"contentId-289965592","type":"file","height":1000},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The Import / Export dialog appears.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":600,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1024,"alt":"image-20250217-211536.png","id":"e8cfe8f5-4f7c-4483-af6d-062900023873","collection":"contentId-289965592","type":"file","height":1028},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Drag your XIF or device type package file to the ","type":"text"},{"text":"Drop Files to Import ","type":"text","marks":[{"type":"strong"}]},{"text":"box, or click ","type":"text"},{"text":"Browse","type":"text","marks":[{"type":"strong"}]},{"text":" to browse for your file.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"The example shown below is for the ","type":"text"},{"text":"STM550","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":" Multisensor, which by default sends out a radio telegram every 60 seconds; therefore, it has a receive timeout of 120 seconds. This type of device can also be configured for a different ","type":"text"},{"text":"application type","type":"text","marks":[{"type":"em"}]},{"text":" other than the default, which would result in a different radio telegram structure and consequently, a different application type byte (and a different EnOcean XIF file).","type":"text"}]},{"type":"paragraph","content":[{"text":"The filename for the example shown below is ","type":"text"},{"text":"STM550-V2.eno","type":"text","marks":[{"type":"strong"}]},{"text":". This example defines an EnOcean XIF for EEP D2-14-41.","type":"text"}]},{"type":"codeBlock","content":[{"text":"#filetype,EnOcean_xif\n#program_ID,8A000BD21441E001\n#version,v02\n#product_name,STM550 Multisensor\n#manufacturer,EnOcean\nDatapoint Name,IAP Type,Block Name,Block Index,Address,Write Enable,Precision,Receive Timeout\nTemperature,float,Multisensor,1,Temperature,-,1,120\nHumidity,float,Multisensor,2,Relative humidity,-,0\nLuminance,float,Multisensor,3,Luminance,-,0\nAcceleration Status,float,Multisensor,4,Acceleration Status,-,0\nAcceleration X,float,Multisensor,5,Acceleration X,-,2\nAcceleration Y,float,Multisensor,6,Acceleration Y,-,2\nAcceleration Z,float,Multisensor,7,Acceleration Z,-,2\nContact State,boolean,Multisensor,8,Contact State,-,0","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Additional example EnOcean XIF files are available in the EnOcean resources library at:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-external-image","parameters":{"src":"https://github.githubassets.com/favicon.ico","width":"","height":""}}},{"text":"https://github.com/izot/smartserver-iot/tree/master/resources/enocean","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"link","attrs":{"href":"https://github.com/izot/smartserver-iot/tree/master/resources/enocean"}}]}]},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph"}],"version":1}

Browser not supported