WIO Overview

• WIO Setup | WIO Control | User Bitmaps | WIO Firmware | WIO CAM | WIO Mobile | Cable | LEDScript | IOScript

LEDScript runs in WIO context, and can be activated by Rocrail commands.
Its a simple plain ASCII file, which must be uploaded to the WIO.
The target Color LEDs must be supported by the FastLED library.

WIO version 295+.
Rocrail version 2.1.1042+.

The text format has some restrictions:

• A blank line will stop the LEDScript parser the same as with 'end'.
• Comment lines are prefixed with the '#' sign, and are restricted to 64 characters incl. linefeed.
• Only linefeeds are allowed without extra carriage return. (Unix format)
• Max. 32 sequences are allowed.

The filename must be formatted like this:

<freetext><nr>.led

The number, <nr> ranges from 01 to 99.
Example:

disco04.led

Zero, *00.led, cannot be addressed.

The header just contains one line:

The rgbip values can be left out, and in this case the last parsed values are used.

*range: A 16bit RGB value range. Example: Range from 150 to 220. Value = 220+(150*256)=38620 (Ver 374+)

*1: for increase until the next l command. With + the LEDs stays on, with - not. See example below (Ver 377+)

If t > 0 this is used at the end of the script to reset LEDs.

At a LED(output) off command, the following fields are used to reset LEDs, if the LEDs are still on after the script has finished.

Uploading LEDScript files can be done with a WEB Browser as explained here:
Upload by WEB Browser

Set the address value greater then 100, and <nr> is address - 100.

Set the LED address value greater then 100, and <nr> is address - 100.

# start 0=endless loop, 1...255=iterations
s2 
# led 0 to 5
l0
c6
r255
g0
b0
i50
p1000
# led 0 to 2
l0
c3
r255
g255
b0
i50
p1000
# end
e

# Disco
# start 0=endless loop, 1...255=iterations
s0 
# led 0 to 19
l0
c20
# random
a
r255
g100
b100
i80
p20
e

# warning lights
s0 	//Script declared endless
l0 	
-6	//starting increase with LEDs off after p
r255
g115
b0
i150
p10     //end increase
l0 	
c6	
r255
g115
b0
i150
p5
l0 	
c6	
i0
p100
l0 	
+6	//starting increase with LEDs staying on after p
r255
g115
b0
i150
p10     //end increase
l0 	
c6	
i0
p100
#LED-reset, all LED off
d0
t6
e

#brightinc
s0
l0 	
+1    
r255
g80
b0
>150  //increase brightness
l1 	
+1   
r255
g80
b0
<150  //decrease brightness
p3
#LED-reset, LED ausschalten.
d0
t2
e

The WIO parser is very simple, and reads the file line by line.
After reading a line, the first character is checked as listed in the Instructions paragraph.
If a number is expected, the C function atoi() is used with the line pointer + 1. A none numeric character should follow the number.
Because of the simple nature of this parser, it is also allowed to add some text to make the LEDScript more readable:

i80 // brightness 80 of 255
p20 // pause 20 * 10ms
end

But the total line length, incl. linefeed, should not exceed the 64 byte boundary.