Join= Command

Join= lets you set the default join value used functions within a task so you can send several messages with the same join.
This change is only for the task it is in and lasts until the next time you change the default area value.
It affects the functions Preset() ChannelLevel(), ResetPreset(), Panic(), UnPanic(), and PresetOffset().
Often this is used to make sure a task doesn’t trigger itself or to differentiate where a message came from.

Syntax

Join=x Where x is the value of the join. Can be set more than once within the task, i.e. can be set for the first 6 messages and then set for the next 6 messages in a 12-message-task.

The default Join is 0xFF.

Can be any value from 0x00 to 0xFF.

The task editor in System Builder has a bug and will apply any default modification commands that are skipped over by a BRA command. Essentially only the last default modification will apply.

You can use the tick boxes in the virtual panel configuration popup to help calculate the value you want.

Example

Will set all Commands that require an Join value to use 0x02 unless explicitly defined in the function call.
Will send the following when called “Preset 2-Area 3, Join of 0xFD” then “Preset 3-Area 9, Join of 0xFD” then “Delay for 1 second” then “Preset 5-Area 3, Join of 0xFF”

Task1()
{
Join=0x02               //Set default join value to 0x02
Preset(P=2,A=9)
Preset(P=3,A=9)
Delay(1)
Preset(P=5,A=9,J=0xFF)  //Use a join of 0xFF instead of default

}