[LAB 3] BAS Controller: How to Use the Sedona Application Editor

In this lab, we will be using iConnect Training’s BL-01 BAS controller because of its small footprint and ease of moving it around.

During this lab, you’ll learn how to:

1. Connect to the emulated BAS controller with Sedona (also known as SAE)
2. Use the Nav, Kit and Work (wiresheet) panes
3. Add components onto the work pane 
4. Link to form a complete program

For a step-by-step video tutorial, visit our YouTube page here. 

 

What Is Sedona (SAE)?

The Sedona Application Editor (SAE) gives technicians the ability to develop control applications for Sedona devices. With this software developed by Tridium, Inc, techs can easily build smart, networked and embedded devices for implementing control applications.

 

Step 1: Connect to the Emulated BAS Controller

Start the emulator which should open a new browser window asking for your username and password. Upon logging in, you’ll see the emulators running. Now, open the Sedona application editor. When you open the software, there’s not a whole lot to see until you connect your controller. There’s the title bar, menu bar and the welcome screen.

There are two ways to open a connection. You can navigate to File on the menu bar and then Open Connection or select the open connection icon on the toolbar. A new window will open with preloaded IP addresses. To make the connection, put in your username and password.

 

Step 2: Overview of the Sedona Panes

Once the connection is made, the look of the Sedona application changes significantly and there are four visible windows. In the middle, there’s the work pane. The navigation pane is located in the upper left corner and has a tree-like structure. You’ll also be able to see the IP address of the emulated controller. If there were multiple controllers, you’d have multiple tabs. The kits pane is in the left bottom and the properties pane to the right of the work pane.

 

Step 3: Add Components to the Work Pane and Link

There are two folders: service and sheets. For now, ignore the service folder, but do not delete as it has a lot of the background tasks that are required to run a functioning Sedona device. If you open the sheets folder, you’ll see a blank wire sheet. This is where you’ll create a program using the kits pane and dragging components onto the wire sheet. When you’re doing a full programming, you’ll use a lot of different kits.

To get started adding components, place a folder in the work pane. You can rename this component by clicking on the component so that a red border will pop up. Select the name in the properties window to rename. Note: You can only have up to seven continuous characters and cannot lead with a number or a special character. 

When you double click the test folder, it will open another blank wire sheet. In the kits pane, contract the sys kit and open the function kit. Then, drag TickToc and Count onto the wire sheet. Now, drag the Out of the TickToc to the In of the Count. This links them together and they are now counting together. 

Open the types kit, find the Constbool component and drag onto the wire sheet. Link the Out slot to the Enable slot on the Count component. However, there’s a problem. The Enable is still labeled as false and it needs to be set to true. To change it, you must select all three components. Then, under the properties pane, navigate to ConstantBo. Go to the Out and select True. When you click Out, you can see the Count component is going to start counting Ticks and Tocs. Congratulations! You’ve just created your first program.

 

Step 4: Test and Save to the Controller

Now’s the time to test and save this program to the controller. To do this, go to the navigation pane, open up Test and you’ll see the three components. If you’re seeing an asterisk, this means changes have been made to the program but have not been saved to the device. Make sure to save your work. NOTE: When you’re developing an application, you’re working on a live controller. While it’s convenient, it needs to be done with care, especially if it’s hooked up to actual equipment. With the emulator, you can make changes but not screw up the actual controller. 

Want to rename the program? Go to Tools > App Configuration. You can update both device name and app name. Just hit Apply to rename. 

You can save this program to the controller one of two ways: select the controller lightning bolt icon in the toolbar or select File and Save to Controller. Now, the asterisks in your navigation should no longer be there. If you’d rather, you can save the program to your computer. 

Run a quick test by highlighting all of your components and deleting them. If you close the controller and reopen, then load from PC and select the file. Once it loads, the program should be back in place.

 

Request a Quote for Our BAS Controller Training Units

These educational products are specifically designed for the Direct Digital Controls (DDC) industry. Request a quote here or give us a call today at 716-699-2031.