About the Sedona - New App tool

Sedona TXS-1.2 allows you to create Sedona apps in offline mode, similar to the way you create Niagara stations. The tool uses a wizard format much like the New Station tool in Niagara Workbench.

NoteIf using AX-3.7u1 (3.7.106 or later), after installing the TXS-1.2 bundle: version 1.2.2x (for example 1.2.28.4) you need to download and install a patched nsedona module, version 1.2.28.1. For more details, see the latest NiagaraAX Sedona Framework TXS-1.2 Installer Guide.

The Sedona-New App tool is available under the Workbench Tools menu when using either NiagaraAX Workbench 3.7 or later enabled for Sedona TXS-1.2, or when using Sedona Framework Workbench 1.2. Both Workbench products provide the identical tool. Access the Sedona-New App tool by selecting the option from the Workbench Tools menu, as shown in Figure 3.

Figure 3. Access Sedona - New App tool from Niagara Workbench enabled for Sedona TXS-1.2 (left) and from Sedona Framework Workbench (right)


Access Sedona - New App tool from Niagara Workbench enabled for Sedona TXS-1.2 (left) and from Sedona Framework Workbench (right)


Selecting this tool launches the New App wizard which walks you through the steps to create your own Sedona app. The three successive steps allow you to specify the file parameters and access parameters for the app, and to specify additional app parameters to identify the platform the app will run on and the device type.

Figure 4. New App Wizard


New App Wizard


First, simply enter the name for the SAX file you wish to create, omitting the file extension. Then click the directory icon to the right of the App Directory field and use the standard Ord Chooser to select the folder in which you wish to create the app file. Click the Next button to proceed.

NoteIf the file you specify already exists on your file system, you will be warned and asked if you wish to overwrite the file. Click Yes to overwrite the file or Cancel to go back and enter a different file name.

Figure 5. New App Wizard


New App Wizard


Next, in the Admin Password field, enter the desired password for the “admin” User. If you do not enter a password, a blank password is used. You must enter the same password in the Admin Password Confirm field.

NoteIf the two passwords do not match exactly, when you click Next an error message displays to alert you.

In the Sox Port field, enter the UDP port for Sox communications. The default, 1876, is pre-loaded for you. Most Sox traffic uses this port.

Figure 6. New App Wizard


New App Wizard


In the last step, specify additional app parameters, and finish the app creation process. In the Platform Service Type field, click to display a menu of available platforms and select the one your app uses. All available platform choices are shown in the “Sedona Type” style (kitName::typeName).

The PlatformServiceType drop down is populated with the list of PAR files that you have imported using the Sedona Installer. The platforms may have been imported as part of a bundle, environment file archives, regular PAR files, or simulator PAR files. For details on using the Sedona Installer, see the NiagaraAX Sedona Installer Guide.

NoteIf you do not see the platform type that you want in this list, you may need to obtain the platform and install it. To obtain a platform, contact the vendor of that Sedona platform. Otherwise, a sample device simulator platform is included in the Sedona Framework TXS-1.2 Bundle. For more information, see Sample device simulator platform included in TXS bundle.

Finally, you may wish to give the app a “Device Name” in the App Device Name field. This will set the root App component’s “deviceName” property, which is useful for distinguishing otherwise identical apps from one another in a multiple-device installation.

If you wish to continue editing the app using the Offline App Editor, check the box to Open App SAX on Finish, and you will be taken to the offline editor on completion.Click Finish to create the app.