LONMARK® Resource File API Source Code ReadMe
Version 2.4, April 2013

Copyright © 2002 – 2013 Echelon Corporation
All Rights Reserved

 

1       Overview

This document describes Version 2.4 of the LONMARK Resource File API source code for LONWORKS® software products and other software and devices compliant with the ISO/IEC 14908-1 control networking protocol.  This is the C source code for the read portion of the API included with the LONMARK Version 14.00 standard resource file set.  The installation software for the LONMARK Version 14.00 standard resource file set installs this code compiled for Microsoft Windows®.  You can use this source code to port the read portion of the same API to other platforms and read version 1 – 6 type files, version 1 – 5 functional profiles, and version 1 – 3 language files in LONMARK resource files.

2       Contents

1        Overview.. 1

2        Contents. 1

3        New Features. 1

3.1         Version 2.1. 1

3.2         Version 2.2. 1

3.3         Version 2.3. 1

3.4         Version 2.4. 2

4        Documentation. 2

5        Installation. 2

 

3       New Features

This section describes the new features added in each release of the LONMARK Resource File API.

3.1      Version 2.1

Support added for version 3 type files and version 3 functional profiles.  The new version 3 type file format supports larger resource files and supports new invalid value and obsolete flag fields.  The new version 3 functional profile format supports inherited functional profiles and network variable member numbers that are not consecutive.

3.2      Version 2.2

Support added for version 4 type files, version 4 functional profile templates, and version 3 language files. Version 4 type files and functional profiles add support for configuration property arrays and for permanently deleting types and profiles. Version 3 language files add support for permanently deleting language strings.

3.3      Version 2.3

Support added for version 5 type files.  Version 5 type files add support for new unsigned quad and double float data types.  To provide backward compatibility, support for these new data types is not enabled by default in the version 2.3 API.  Applications must inform the API that they can support the new types.

3.4      Version 2.4

Support added for version 6 type files and version 5 functional profiles.  Version 6 type files add support for new 64-bit signed and unsigned integer data types and expand the SNVT ID to support more than 255 SNVTs.  To provide backward compatibility, support for these new data types and extended SNVT IDs is not enabled by default in the version 2.4 API.  Applications must inform the API that they can support the new types.  Version 5 functional profiles add support for additional flags.

4       Documentation

See the LONMARK Resource File API Reference Guide for documentation of the LONMARK Resource File API.

5       Installation

If you are using Microsoft Windows, use the LONMARK Version 14.00 Standard Resource File Set installation software or newer to install the LONMARK Resource File API.  If you are using a different operating system, extract the source code files included with the LONMARK Resource File API source code to a working directory and then port them to your target platform.

 

 

Echelon, LON, and LONWORKS are trademarks of Echelon Corporation registered in the United States and other countries.  Microsoft and Windows are trademarks of Microsoft Corporation registered in the United States and other countries.  LONMARK and the LONMARK Logo are trademarks of LONMARK International registered in the United States and other countries.  All other trademarks are the property of their respective owners.