System Requirements
This article contains system requirements for operating Kramer Control.- Supported Browsers (when creating projects in the Builder): Google Chrome
- Supported Mobile Operating Systems for Kramer Control App:
- iOS version 10.0 and above
- Android version 6.0 and above
System Requirements
This article contains system requirements for operating Kramer Control.- Supported Browsers (when creating projects in the Builder): Google Chrome
- Supported Mobile Operating Systems for Kramer Control App:
- iOS version 10.0 and above
- Android version 6.0 and above
Properties Section
The Properties section of the Builder is the area where you edit specific details of interface elements. Items such as interface names, button size, font, font color and background color.
This article lists and explains the items that can be edited in the Properties section of the Builder.
Text Options
- Text – adds custom words to identify a button, page or interface.
- Font – the text font displayed in your user interface.
- Font Size – the size of the text that is displayed in the user interface. This is an indefinite number field ranging from 1 to infinity.
- Bold – bolds the text.
- Background Color – defines the background color of an interface element.
- Color – opens a color picker for editing the color of the text that appears in the user interface.
- Alignment – define the position of the text inside an interface element. You can position the text in the upper left, upper middle, upper right, center left, center center, center right, lower left, lower center, or lower right of a button or other interface element.
Page Position Options
- Adjusting the X value changes the location of the interface element on the page based on its left to right position.
- Adjusting the Y value changes the location of the interface element based on its position related to the top or bottom of the page.
Size Options
Use these options to adjust the Width and Height of the interface element.
Image Options
- Image and Pressed Image – thumbnails of the image currently being used for a button for the default image and the image that appears upon pressing the button once in control mode.
- Click the red X in the thumbnail to remove the image from the element. You can also drag a new image to this field to change the currently used image.
- Image Size – includes the following options:
- Contain – adjusts the width and height of the image to the largest possible value that fits the interface element (i.e. button, background, etc.) while maintaining image proportions.
- Stretch – enlarges your image to fill the area of the interface element, ignoring image proportions, .
- Normal – maintains the image proportions regardless of the size of your placeholder.
Slider Properties
- Orientation – defines the the orientation of the slider. Two options are available:
- Vertical – used in a bottom to top motion. The bottom of the slider is the lowest possible value and the top of the slider is the highest possible value.
- Horizontal – used in a side to side motion. The left side of the slider is the lowest possible value and the right side of the slider is the highest possible value
- Steps – defines the number of commands that can be executed within the slider. For example, a dimmer light could have 100 steps for each percentage of illumination, starting at 0% and ending at 100%. This field is editable and the number of steps can be changed from the default range that appears based on the device driver.
- Send Commands On – two options:
- Drag – sends commands as the user changes the position of the slider knob.
- Release – waits until the user releases the mouse button to send a command. The command is executed based on the last position of the knob.
- Delay – defines the amount of time between executing commands while dragging a slider knob. This option is enabled when the Drag option is selected.
- Knob Color – defines the color of the slider knob.
- Bar Fill Color – defines the color of the filled area of a slider. The filled area of the slider indicates the current level of the parameter that is controlled by the slider. This is the area under the knob of a vertical slider and to the left of the knob on a horizontal slider.
- Bar Empty Color – defines the color of the area of a slider above the current level. The empty area is above the knob in a vertical slider and to the right of the knob on a horizontal slider.
- Thickness – defines the width of a vertical slider and the height of a horizontal slider.
- Knob radius – defines the size of the slider knob.
Brain Indicator Colors and Troubleshooting
In the Kramer Control application, there is an indicator that changes color based on the status of the Brain.
This article explains the different colors and what steps can be taken to troubleshoot any issues you may be experiencing.
Green
Green is the color you are striving for. A green indicator light means:
- The Brain is connected to a server.
- All Gateways are successfully connected to the Brain.
- All controlled devices are connected to Gateways.
Red
A red indicator means that the Brain is not communicating with the server.
If the brain is not communicating with the server, power cycle the Brain hardware.
Blue
A blue indicator means that the Brain is currently synchronizing and the interface cannot be accessed until synchronizing is finished.
If the Brain is stuck in this state, power cycle the Brain hardware.
Yellow
A yellow indicator means that one or more Gateways are not connected to the Brain.
To connect a Gateway confirm the following items:
- The controlled devices are on the local network.
- The IP addresses of the controlled hardware match what was created in the Builder Hardware section.
We recommend applications such as Fing and LanScan to identify the IP address of devices on the local network.
White
A white indicator means that there are no Gateways communicating with the Brain.
This could mean one of the following:
- No Gateways were created in the Builder Hardware section.
- All IP addresses in the Builder Hardware section are incorrect.
- Devices are on a different subnet of the network.
- The Brain is on a different network than the controlled hardware.
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:
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.
Use Cases Overview
Use cases are example scenarios that can be created when using Kramer Control. The articles in this section contain examples such as when to save vs when to publish, state based events that change the image to indicate current state and more.
Examples
Adding Backgrounds
Adding Buttons
Adding a Slider
Saving vs Publishing
State based image change using logic
Changing frames to a different overlay
Repeat on Hold Buttons
SL Firmware Updating
System Device
Toggle Button
Dashboard Overview
The Dashboard is designed to view usage information for each of your controlled spaces. The Dashboard includes adaptable charts, device information, space alerts and a live stream of current data. This information can be viewed remotely in case an administrative person needs to access a space to view errors or test the system.
Viewing Project Information
The Dashboard has two panes. The left pane shows a list of projects that are also displayed in the Manager.
1. Click the name of a project in the left pane.The center pane displays the Project information contained in the Manager: Business hours, Business days, Last Modified information, Business location, and Space information.
2. Click the left arrow in the upper right corner of the center pane.
The left pane closes, providing you with a full screen view of your project.