CN32Pt, CN16Pt, CN16PtD, CN8Pt, CN8PtD
File Format
DP32Pt, DP16Pt, DP8Pt
Load & Save
The information contained in this document is believed to be correct, but OMEGA accepts no liability for any errors it contains, and
reserves the right to alter specifications without notice.
Platinum Load & Save File Format
Table of Contents
1 Introduction ........................................................................................................... 2
1.1 Purpose .................................................................................................................... 2
1.2 Definition of Terms and Acronyms ........................................................................ 2
1.3 Applicable Documents ............................................................................................ 3
2 File Format ............................................................................................................ 4
2.1 Meta records ............................................................................................................ 4
2.1.1 User Meta-records................................................................................................................. 5
2.2 Comments ................................................................................................................ 5
2.3 Data records ............................................................................................................ 5
2.3.1 Item Field ............................................................................................................................... 5
2.3.2 Value Field ............................................................................................................................ 5
2.4 Device Configuration Records ............................................................................... 5
Revision 0.1 Page 1 of 15
Platinum Load & Save File Format
1 Introduction
1.1 Purpose
The following document defines the file format used by the Platinum series Load and Save
commands.
The Save command is intended to capture the configuration of a Platinum series controller and save
it on removable media (ie: USB Stick memory).
The Load command is intended to read a configuration image from an external device (ie: USB
memory stick) and store it on a Platinum device.
The file format used is an ASCII text file, with tab delimiters between each field. These files may be
reviewed or modified using a simple text editor or application programs such as Microsoft Excel that
support reading tab delimited files.
1.2 Definition of Terms and Acr ony m s
I2C 2 wire serial interface
Base Device Device connected to sl a ve dev ice
Smart Input Device supporting 1 or more Input sensors
Smart Output Device supporting 1 or more Output Elements
Sensor Element One of the physical sensing elements on a Smart Output
AC Alternating Current
DC Direct Current
CS Chip Select
ADC Analog to Digital Converter
DAC Digital to Analog Converter
RS485 Electrical signals used for serial communications
RS232 Electrical signals used for serial communications
CSV Comma Separated Values
COTS Commercially-Off-The-Shelf
ESD Electo Static Discharge
FW Firmware
HW Hardware
I/O Input/Output
LED Light Emitting Diode
Hexadecimal Values expressed using base 16 (2
Revision 0.1 Page 2 of 15
4
)
Platinum Load & Save File Format
1.3 Applicable Documents
Doc. # Name / Description Rev. #, Date
Device Serialization and Version Information Rev 0.1
Omega Engineering Coding Standard Rev 1.2.0
Revision 0.1 Page 3 of 15
Platinum Load & Save File Format
Meta Record
Load Function
Save Function
Must be first record in
Generated as first record
Ignored
Generated based on file
Records device F/W
%Date <tab> …
Ignored
Not generated
%Author <tab> …
Ignored
Not generated
Ignored
Generated based on
2 File Format
The file format uses multiple records with each record having one or more fields. The ‘tab’ character
is used to separate fields within a record. All data information is represented by ASCII s tri ngs . Eac h
record is terminated by a CR/LF (0xd/0xa) character sequence.
Records fall into three general categories:
1) Comment / blank records
2) Keyword records
3) Data records
Record
Type
Meta Record % Defines
Comment // Allow users to insert
Blank Line Allow separating blocks
Data record <any
Tag
character
printable
character>
Use Example
operations/information
other than data records
comments to document
files
of information
Defines data to be read
or written
NOTE: The first record within the file must contain the Keyword %Platinum.
2.1 Meta records
The following Meta Records are defined:
%File <tab> Platinum_0000.txt
// This is a comment
INPUT_SENSOR <tab> 2
%Platinum
%File <tab> Platinum_xxxx.txt
%Version <ta b > yyy.yyyy.yyy y. y yy
%DeviceID <tab> xxxxxxxxx
Revision 0.1 Page 4 of 15
the file
Ignored
in the file
number entered by user
version information
internal DeviceID
information
Loading...