Adding a State to an Event

---

You can program a button on your interface to change its appearance according to the State of a device. Elements of the button appearance that can be changed include: text, color, text bolding and button image.

This article explains how to configure a button to change its appearance using the Mute state of a device as an example.

Page Setup

• Launch into the Builder from your controlled space.
• Make sure devices are imported.
• Make sure buttons are added to a page.

Adding States to the Button

1. Double click the button to which you would like to add the state based change.
2. Select your device from the Devices tab in the right pane. For this example, we are using an Onkyo receiver.
3. Select the Category type. For this example, select Volume.
4. Drag the relevant Command to the center pane. For this example, select Mute Toggle.
5. Scroll below the Commands list in the Devices tab to the list of States.
6. Stay within the selected Category and drag the relevant State (for this example, the Mute state) to the center pane section where the following words are displayed: “Drop state here to add Event”.
A popup window opens.
In the example of the Mute Toggle Command, the popup shows a dialogue asking what zone is being controlled with this button and which State we are tracking. 
Do one of the following:

• Select a single state to track. OR
• Add multiple States to a single button and use conditional logic to track multiple states. See the next section below.

Event 1 is added under the button action in the center pane.

Adding Substitutions via Conditional Logic

If you added an unspecified event to your button, follow the steps below to add conditional logic.

To add the first part of the IF statement:

1. Click the + icon in the event section.
2. Select Conditional.
3. Drag the relevant State from the Devices tab to the IF statement in the Event.
In our example, drag the Mute state from the Onkyo device. This is the same state you added to the event field of the button.
The Add State Expression window opens.
4. From the Operator field, select “=” (equals) or “!=” (does not equal).
For our example, select  “=” (equals).
5. Select the relevant option from the Value field.
In our example there are two options Mute On and Mute Off. Select Mute On for the IF statement.
6. Click the + icon in the Event section of the center pane and select Update property.
7. Select the Target property from the Properties window.
In our example, select the Image property.
8. Deselect the option to use State Value.
9. Drag the relevant image from the right pane to the Update property portion of the IF statement.
This image now appears when the State of your device matches your Conditional statement.
In our example, this is the image shown when the Mute State = Mute On.

To add the second part of the IF statement:

1. Click the + next to the first part of the IF statement that you created in the section above.
2. Add ELSEIF.
3. Drag the relevant State from the right pane to your IF statement.
Use the same State as the IF statement. In our example use the Mute State.
4. Make sure the ELSEIF statement is selected in the Event section, and click the + sign in the Event section of the center
pane.
5. Select the Add update property option.
6. Select the Target property from the Properties window.
In our example, select the Image property.
7. Deselect the option to use State Value.
8. Drag the relevant image from the right pane to the Update property portion of the ELSEIF statement.
This image now appears when the state of your device matches your Conditional statement.
In our example, this is the image shown when the Mute State = Mute Off.

IF your device has more possible states than two, repeat the above steps to create your ELSEIF statements for all possibilities

Creating a Repeat on Hold Button

---

There are two types of interface buttons. One type performs an action once per click and release. The other type of button repeats an action as long as the button is held and stops repeating when released. This is called a Repeat on Hold button. Typical applications of Repeat on Hold buttons are volume buttons and channel changing buttons, but interface button can be configured for repeat on hold.

This article explains how to configure an interface button to be a Repeat on Hold button.

Preliminary Steps

Make sure you have completed the following steps:

• Launch into the controlled space that requires the Repeat on Hold button.
• Add an interface button to use as a Repeat on Hold button.

Procedure

1. Double click the relevant interface button.
2. In the center pane, change the tab from Tap to Push.
3. Select the relevant device from the right pane.
4. Select the relevant category for the repeating command.
5. Drag the command from the right pane to the words “drag and drop commands here” in the center pane.
The Properties window displays information about the command that was just added.
6. Click the name of the button in the left pane.
The Properties window shows the editable fields of the button.
7. Select the Repeat PUSH on Hold check box in the Properties window.
8. Edit the Repeat Frequency field as needed.
Repeat Frequency is a value from 0.0 to infinity. 0.0 creates a smooth repetition of the function and higher values cause the function to repeat in more noticeable steps.

Toggle Button

---

This article explains how to create a single toggle button that performs different actions and changes appearance for each action. 

To add multiple actions to a button:

1.Launch the Builder.
2. Add a new button or select an existing button from the interface.
3. Select the Toggle Button checkbox in the Properties window.
Note: Selecting this option hides the Press and Release options from the button edit screen.
4. Select the relevant Device from the right panel.
5. Add actions to the button. 
Double-click the button to view the actions that were added. Multiple actions are shown as Tap: 1, Tap: 2 and so on.

To add and image for each action:

1. Make sure you have added the required button images to an Image Library.
2. Make sure the relevant interface button is selected.
3. Drag an image from the Images tab in the right pane to the Toggle Image 1 field in the Properties window.
Drag different images to each of the Toggle Image and Toggle Pressed Image fields as needed.
4. Save or Publish your changes.

SL Firmware Updating

---

This article explains the process of updating your Brain and Brain hardware. Included in this article are links to download the latest firmware and the tool for updating the firmware. 
Note: This process requires a PC. MAC computers are not supported for the upload process.

To download the firmware files:

1. Download K Upload.
2. Download the latest SL firmware.
3. Download the latest Brain firmware.

To Upload the firmware to the hardware:

Note: Make sure that the PC is connected to the same Network as the SL hardware.

1. Open the K Upload exe file.
2. Connect to the SL hardware by typing the IP address of the hardware.
3. Navigate to the SL firmware file on your PC.
4. Upload the SL firmware to the hardware.
5. Repeat the above steps for the Brain update.
It is recommended to restart the SL or disconnect the K Upload software before running the Brain update.