LEDS

These objects are used to implement indicators on the Panel

1. Object definition


Two different kinds of LEDs can be inserted into the panel:

  • Predefined LEDs are indicators with fixed, already defined, graphics (the designer can choose among available types).
  • Customized LEDs are indicators that allow the designer to choose the images which should appear for each state of the indicator (the images must be selected among those available, see image gallery). Moreover, it is possible to have up to 10 states.

 
  • Predefined LEDs

A predefined LED can be added to the panel using the following syntax:

L
ID type [stylers] [events] : status : [text] ;

The fields between brackets [ ] are optional

The following table describes in details the meaning of each field

 

Field Lengh Description Values
L  1 char
Fixed char that starts the LED definition L
ID 1 char Unique ID to identify the led on the Panel. This field can be a decimal digit or an upper-case character. The maximum number of LEDs that can be created on the panel is 20 (0,9)-(A,J)
 type variable One or more upper-case characters that identify the type of LED to be created (such as graphics, color, border...)
see LED types below
 [stylers] variable One or more stylers that define the graphical appearance of the LED (such as, size, position, opacity, border, background, ...). Some stylers may not take effect on the LED. see stylers
 [events] variable  One or more event specifiers see events
 status 1 char  Define the initial state of the LED (on/off). The LEDs with "type" = {R,G,B,Y} have only 2 states (0,1), while other LED types may have up to 10 different states.
 (0,1) or (0,9)
 [text] variable 
The text that will appear next to the LED (right side). To insert different texts, please use the Text object.
All characters except semi-colon (;)

 

 

Examples (predefined LEDs)

Example n.1

Target:

Panel with a green LED.
State on; text "Alarm"; default styles;

Message

L1G:1:Alarm;




Example n.2

Target:

Panel with a green LED.
Double size; state on; text red "Power"; default styles;

Message

L1G*20#F00:1:Power;




   

 
  • Customized LEDs

To define a customised LED, which permits to specify the images to use for each state, the syntax is:

L ID type
[stylers] [events] : status : image_0 , image_1 , .... , image_N;


Where the fields above has the same meaning described for predefined LEDs, with the exception that:

  • Field type = 'M' (multi-image)
  • The number N of states are equal to the number of images you specify on the fields "image_xx" (max 10) .

Examples

LED having 4 states (for each state the image n. 1.101, 1.102, 1.103 1.104 respectively):  L1M:0:1.101,1.102,1.103,1.104;


2. LED Usage


The following explanation is valid for all LED types.


Change the LED status  (Controller --> WiFi Module --> Panel screen)

The microcontroller can changes the status of a LED on the panel by sending a simple message to the WiFi module.
The message format is:

#
L
ID status 

Examples

  • Switch on the LED with ID=1: #L11
  • Switch off the LED with ID=1: #L10

Note:

Some types of LEDs could have more than two states.


Events (Panel screen --> WiFi Module --> Controller)

Read the events section to learn how to enable and manage the events for this object.

 

 

3. LED types

The following list reports the predefined LEDs. For Customised LEDs please refer to the list of global images, available in the Image section.
 

Type
Status
0R



0
1
 
Type
Status
1R

0 1
 
Type
Status
2R



0 1
 
Type
Status
3R



0 1
 
Type
Status
4R



0 1

Type
Status
0G


0
1

Type
Status
1G



0 1

Type
Status
2G



0 1

Type
Status
3G



0 1

Type
Status
4G



0 1

Type
Status
0B


0
1

Type
Status
1B


0 1

Type
Status
2B



0 1

Type
Status
3B



0 1

Type
Status
4B



0 1

Type
Status
0Y



0
1

Type
Status
1Y



0 1

Type
Status
2Y



0 1

Type
Status
3Y



0 1

Type
Status
4Y



0 1

Type
Status
0P



0
1

Type
Status
1P



0 1

Type
Status
2P



0 1

Type
Status
3P



0 1

Type
Status
4P



0 1

Type
Status
1N







0 1 2
3
4
5

Type
Status
2N







0 1 2
3
4
5

Type
Status
5











0 1 2
3
4
5
6
7
8
9

Type
Status
5R











0 1 2
3
4
5
6
7
8
9