Channellevel() - The Channel Level Command

Used to send channel level messages onto the network fading individual channels or entire areas to a specified percentage.

Syntax

Channellevel(A=x,F=x,J=x,C=x,L=x)

Parameters

  • "A" is the area number (0-255) - Default of 1

  • "F" is the fade time in seconds (0-15300)- Default is 0.2 seconds

  • "J" is the join level (0x00-0xFF) - Default is 0xFF

  • "C" is the channel (0-255) - 0 = All Channels; Default is 1

  • "L" is the level as a percentage (0-100) - Default is 1%

Channel levels are temporary and unlike preset messages do not update indicators or toggle states of buttons.
If that is required use the 0x6b/OneTouch/Fade to preset message.

Examples

Example 1

{
ChannelLevel(A=3,F=4,C=6,L=10) //Channel 6 of Area 3 to 10% over 4 seconds with a join of FF
}

Example 2

Use channel level and reset preset to do a double warning flash.

const# BLA 250 //Baselink area for the open office areas.
{
ChannelLevel(A=BLA,C=0,L=0,F=.5) //Fade all channels to 0% over 500ms.
Delay(.5)
ResetPreset(A=BLA,F=.5)  //Return to previous levels over 500ms.
Delay(.5)
ChannelLevel(A=BLA,C=0,L=0,F=.5) //Fade all channels to 0% over 500ms.
Delay(.5)
ResetPreset(A=BLA,F=.5)  //Return to previous levels over 500ms.
}