Elnec BeeHive204, User Manual

Page: 100 / 179

Elnec s. r. o.
100
In the example file six serial values with labels „nav1“, „nav2“, ...“nav6“ are defined. Each value
is written to buffer on address $A7890. All values have size 6 bytes. The line with „nav6“ label
has also second value definition, which is written to buffer on address $FFFF6 and has size 10
bytes, i.e. the last byte of this value will be written to address $FFFFF.
Note: Address for Serialization is always assigned to actual device organization and buffer
organization that control program is using for current device. If the buffer organization is byte
org. (x8), the Serialization Address will be byte address. If the buffer organization is wider than
byte, e.g. 16 bit words (x16); the Serialization Address will be word address.
Playlist From-file serialization file format
From-file serialization playlist file includes list of filenames which contain serialization data. The
file format is similar to classic serialization file format. Following file format differences are for
playlist files:
1. The playlist file must have special header at the first no empty line of file. The header is text
line in format
FILETYPE=PG4UW SERIALIZATION PLAYLIST FILE
2. each serial data batch is represented by separate line in format
[label x] datafilename
labelx - represents label
Labels are identifiers for each no-empty line of input file. They are used for addressing each
line of file. The labels should be unique within the file. Addressing lines of file means, that the
required start label entered by user defines line in input file from which serial values reading
starts.
datafilename - defines name of data file, which contains serialization data. When serialization
requires new serial value, the data file will be loaded by standard PG4UW "Load file"
procedure to PG4UW buffer. File format can be binary or Hex file (Intel Hex etc.). The auto-
recognition system recognizes proper file format and forces load of file in the right file format.
Data filename is relative to parent (playlist) serialization file.
Example of playlist serialization file:
;---- following file header is required -----------------
FILETYPE=PG4UW SERIALIZATION PLAYLIST FILE
;----- references to serialization data files
[nav1] file1.dat
[nav2] file2.dat
[nav3] file3.dat
...
[label n] filex.dat
;-------- end of file ------------------------
For detailed and fully functional examples of From-file serialization files, look the examples
included with PG4UW, placed in installation directory in Examples\ subdirectory as following:
<PG4UW_inst_dir>\Examples\Serialization\fromfile_playlist_example\