Start Sedona Workbench and open the demo app

NoteBefore starting the Sedona Workbench, make sure you have the wireless USB adapter you are using installed in a USB port. If you have more than one such Sedona USB adapter, then only one can be installed on a PC at a time.

After installing the Sedona Framework software and FTDI driver, and inserting the wireless USB adapter, use the following procedures to get started with the dev board.

  1. Start Sedona Workbench and configure the adapter (adapter configuration needed only once).

  2. Open Sedona dev board with sox connection.

Start Sedona Workbench and configure the adapter

  1. Select All Programs->Sedona Workbench->Sedona Workbench from the Windows Start menu.

    NoteThe first time you start Sedona Workbench, a series of license-related popup dialogs occur. Enter your license key and item number in the online licensing request form, and submit it to the licensing server. Sedona Workbench will then close. If you successfully submitted your license information, simply restart Sedona Workbench to have your license automatically detected and installed. If a problem with online submission of your license form occurs, you can email your Host ID (shown in the online form) along with your license key to axlicensing@tridium.com. An email reply will be sent to you, with a license file attachment. For more details, see About your Sedona Workbench license.

  2. Sedona Workbench opens in a paned window, where the left side bar area shows the Nav tree and Sedona palette, and the right main area (view side) shows the Sedona Workbench home page (Figure 3).

    Figure 3. Sedona Workbench home


    Sedona Workbench home

    Your host PC appears in the Nav tree side bar (“My Host” in left pane). Note that the Sedona palette will remain “unavailable” until you open a connection to a node that has a Sedona app.

    NoteAs needed in Workbench, drag dividers between panes to resize areas—say, between the (left) side bar area and the main view area, or in the side bar area between the Nav tree and the Sedona palette. The Window menu (from menu bar) also provides a way to show or hide side bars.

  3. From the menu bar, select Tools->New Jennic Wireless Adapter

    The New Jennic Wireless Adapter wizard dialog appears, as shown in Figure 4.

    Figure 4. New Jennic Wireless Adapter wizard


    New Jennic Wireless Adapter wizard

  4. In the Port field, select the COMn port that Windows previously assigned to the USB wireless adapter when inserted into your PC, for example, COM7.

  5. Change Auto Start from false to true.

  6. In the Panid field, enter: db00

    This matches the Panid in the standard demo app, as shipped on a new Sedona dev board.

  7. In the Channel field, enter: 17

  8. Click the Install button.

    The wizard configures Workbench to use this COM port as the Jennic wireless adapter, showing a progress bar near the dialog’s bottom as shown in Figure 5

    Figure 5. Installing new Jennic wireless adapter


    Installing new Jennic wireless adapter

    When Done, the wizard automatically starts the USB wireless adapter’s connection to its network.

    NoteNow the LED on the USB wireless adapter should be blinking green, at a one second rate.

  9. Click the Exit button to close the wizard, leaving Workbench open.

  10. From the menu bar, select Tools->Jennic Serial Port Tool

    The Jennic Serial Port Tool view appears, as shown in Figure 6.

    Figure 6. Jennic Serial Port Tool


    Jennic Serial Port Tool

    Verify that the tool is configured to auto-start (1) and that the adapter is also set to auto-start (2). If necessary, click these options to be set as shown in Figure 6.

    On your Workbench PC, you do not need to run the New Jennic Wireless Adapter wizard again, unless you physically replace your USB wireless adapter with another one. In that case, note that Windows assigns a different COMn port number to the new adapter.

    To reconfigure the network settings of your USB wireless adapter, use the Jennic Serial Port Tool, by selecting the adapter’s COM port. For details, see Jennic Serial Port Tool.

    NoteIf using Sedona Workbench build 1.0.47, you should upgrade (flash) the firmware in your USB adapter now. After flashing, the adapter should appear in the Jennic Serial Port Tool with a Firmware Version of “1.2.5”. In addition, Sedona Workbench build 1.0.47 contains upgraded firmware for the Dev Board itself—you should should also upgrade (flash) it now too. Use the Jennic Serial Port Tool in Workbench to flash both devices. For details and procedures see Firmware upgrades for the Sedona Dev Kit.

Open Sedona dev board with sox connection

Perform the following to open the Sedona dev board in sox, the Sedona communications protocol.

  1. Start Workbench, if not already started.

  2. Power up the dev board, or if already powered up, press its Reset switch (SW5). Within a minute or so, a “ghosted node” should appear in the left Nav tree pane of Workbench, as shown in Figure 7.

    Figure 7. Ghosted node in Nav tree represents Sedona Dev Board


    Ghosted node in Nav tree represents Sedona Dev Board

    The node is listed with the unique IPv6 address of the SED-M0x module, e.g. “FE80::0215:8d00:000e:66fc”, which indicates you can now open a sox connection to it.

    NoteIf you do not see the ghosted node, cycle power to the Sedona Dev Board and wait another minute for it to appear in the Nav tree of Workbench. Also, make sure that the Jennic Serial Port Tool and the associated wireless adapter are started. Typically you will want them configured to autostart.

  3. Right-click the ghosted node and select Open Sedona (sox).

    An “Open Sedona” login dialog appears, as shown in Figure 8, using the default 1876 port for sox.

    Figure 8. Right-click ghosted node and select Open Sedona (sox)


    Right-click ghosted node and select Open Sedona (sox)

  4. Login credentials for the factory-shipped Sedona demo app are:

    Username: admin       Password: <none>

  5. After you click OK, Workbench connects to the SED-M0x module.

    NoteThis can take around 10 seconds or so, as Workbench uploads all the schema from the installed kits.

    The initial view is the Sox Manager, listing the node’s schema (a specific list of installed kit parts).

    Figure 9. SED-M0x module opened in sox, showing default Sox Manager view


    SED-M0x module opened in sox, showing default Sox Manager view

    Refer to the section Sox Manager for further details on this view.

  6. To explore the installed demo app, expand the node in the Nav tree, which lists the App and its components. Each component has a default view, which you can see by simply double-clicking it in the Nav tree. Folder components are “containers” for other components, and have a default “wire sheet” view.

    Figure 10. Example wire sheet view of shipped “jenDbDemo” app


    Example wire sheet view of shipped “jenDbDemo” app

    Figure 10 above shows the wire sheet view of a folder in the demo app, which holds the components defining the logic responsible for flashing the D1 and D2 LEDs on the dev board. To see this view, simply double-click the folder in the Nav tree, or right-click it and select Views->Wire Sheet.

    NoteRight-click any component, either in the Nav tree or in any view (e.g., wire sheet), and see its available views listed in the Views shortcut menu. A component’s default view is listed at top. All components have a “property sheet” view, which lists its properties, and also reflects any “child components hierarchy”.

  7. In wire sheet views you can select components directly to do various operations. For instance, you can drag them around, go to property sheet views, and make links between components.

    Figure 11. Adjusting property in TickToc component of demo app


    Adjusting property in TickToc component of demo app

    The figure above shows going to the property sheet view of the “TickToc” component in the demo app (you can simply double-click it for this view), and its default properties.

    If you click in the “Ticks Per Sec” field and replace the 4 with 1, then click the Save button notice that the D1 and D2 LED flash rate on the dev board slows down, as this becomes immediately effective. For other possible exploration ideas for the demo app, see the Working with apps section.