BARIX Streaming Client Installation Guide download pdf (Page 41)

Example 2: only the name of channels 017, 020 and 021 is defined. channels.ini

contains 17 empty lines, followed by the name of channel 017 on the next line,

followed by two empty lines and channel names for 020 and 021 on the last two

lines.

By default, the channels.ini file is empty.

8.1 The DILL Language

Introduction

The purpose of the DILL interface is to define a generic interpreted language

describing display content and events.

The DILL language is simple (in terms of complexity) to allow low memory

fingerprint of the interpreter as well as small size of the display description file.

It does not feature any text identifiers, but all functions, variables, etc. are indexed.

The indexing is described further in this section.

Language elements

The language describes FUNCTIONS which are called by the application on specific

events. E.g. when the user changes the volume, when the song changes, etc.

A function can manipulate the content of the display or control the execution of the

program (see the Program Execution section below).

A function is a set of COMMANDS. A command is an elementary operation like

print, scroll, wait, etc. The commands are executed sequentially. Every command

has a name in the format of one capital letter and is terminated with a semi-colon

(the character ';' - ASCII 0x3B). A complete list of commands follows below.

Commands have optional parameters which are either VARIABLES, CONSTANTS

or INTEGER EXPRESSIONS. Parameters are comma separated and enclosed in

brackets (characters '(' and ')' - ASCII 0x28 and 0x29). A command with zero

parameters is called with empty brackets. E.g.: A();

The variables or constants have either an INTEGER or a STRING type.

String constants are quoted "like this" and can contain ANSI escape sequences to

alter the cursor position, clear the display, etc. String constants can also contain

backslash sequences: \000 (octal character code), \\ (backslash), \" (quote), \n (new

line).

Variables are indexed, a separate indexing for integer and string variables is used.

Integer variables are prefixed with a small 'i' letter (ASCII 0x69) followed by the

variable index (starting from 0). String variables are prefixed with a small 's' letter

(ASCII 0x73) followed by the variable index. E.g. 'i12' or 's4'

INTEGER EXPRESSIONS can be build from integer constants or integer variables

using the + - * / operators. The order of operator evaluation is strictly left-to-right,

there is no precedence of evaluation (e.g. * before + ).

Certain commands also accept BOOLEAN EXPRESSIONS. They are built from a

single BOOLEAN OPERATOR optionally prefixed with the exclamation mark ('!',

ASCII 0x21) for the logical NOT function.

A boolean operator has a name: a small letter, and its parameters enclosed in

brackets. The parameters of a boolean operator are either integer or string

constants or variables.

DDF file

The display content is defined in a DDF file stored in device's FLASH. It is a text file

with either CRLF (ASCII 0x0D 0x0A) or LF only (ASCII 0x0A) end-of-line characters.

Each line of the file contains one function definition. Empty lines and lines starting

with a hash ('#', ASCII 0x23) are considered as comments and are ignored.

BARIX AG | 41/63

1 2 ... 36 37 38 39 40 41 42 43 44 45 46 ... 62 63

Comments to this Manuals

No comments

BARIX Streaming Client Installation Guide Page 41

Comments to this Manuals