Logic Builder App


The Logic Builder app is where the user can create or edit logic programs in a simple and straightforward manner

  • The interface is divided between two sections: Workspace and Sidepanel

Workspace

In the workspace area, the blocks are arranged and interconnected to form program in an intuitive way to make it easier to understand

  • It presents as a grid where all the blocks from the sidepanel can be dragged from, arranged, and connected to create routines and programs

1. Blocks can also be added by clicking the port of another block, this will create a connection.

2. When the left mouse button is clicked again the Add Points to Logic Program form is launched

3. The block will be added to the mouse pointer location with a link already connected

  • In this case, the email block was connected

Tabs

The routines are contained in separate tabs for easier management: main and alarm

To add new routines just click the plus shaped button. This will add another tab containing the new routine.

To rename or delete a routine the user will hover the mouse over the tab title.

Routine Settings

If a routine other than Alarm is edited in the workspace, the routine settings menu will be shown on the upper right corner

  • The settings menu allows the user to set the interval timing (either slow, normal, or fast)

  • The routine can be set to be executed only on an event or manually

Macro Block Settings

If a macro block is edited (either macro or expression) in the application, the macro options will be available instead of Routine Settings

  • Can add ports which are color coded by type

  • The port name can be edited as desired, these can be set to input or output by toggling the option

  • To delete one port just click the x button on the right side

The Macro Block settings have 3 buttons:

  • Add New Point: Add a new port to be edited

  • Save Macro to Server: Save the macro and display under the macro folder on the Sidepanel Block Library

  • Delete Macro from Server: Deletes the macro and it will not appear in the library anymore

Sidepanel

In the sidepanel area, a series of tools are available to use and is divided in 3 sections: Title Bar, Variables/Routine, and Block Library

Title bar

On top, the program title is displayed.

  • Save: Save the changes made to the program

  • Align: Align the selected blocks on the preferred side, useful when managing more complex programs

  • Undo/Redo

  • Toggle Live Data

  • Open Enum Editor: Will open the enum editor allowing users to define or edit new enumerated type

  • Collapse Side Panel: Folds the side panel to the left. When the panel is folded, same button will restore it

Variables/Routines

In the middle, its where the variables are managed. There are 5 options available:

  • Add a new macro block: Add a new macro block and can be customized by clicking on them, which will open another workspace.

  • Add a new expression block: Add a new expression block

  • Add a new code macro block: Add a new code macro block. This option presents a field where, along the graphic interface macro options, the user can customize the macro block by writing bLine code

  • Add a new code expression block: Add a new code expression block

  • Search Bar: Able to lookup among the blocks used, useful when dealing with complex programs containing many blocks

The program blocks are displayed below, they can be dragged into the workspace for further use

  • The blocks can be dragged and dropped into workspace where they will be used to build routines

  • Variables have both set and get instances that can be dragged into the workspace as necessary

  • The blocks are color-coded to simplify management

    • Purple: Numeric

    • Green: Boolean

    • Golden: Stings, including enum

    • Teal: Time Variables

    • Dark Blue: Macro and expression blocks

  • The number of variables and routines is displayed under the last entry, helpful to keep track

Block Library

In the bottom, it contains all the operator blocks available

  • These are sorted in folders by their type

  • To use them, either lookup the block using the search bar or go to the folder and drag it into the workspace

useUnits for numeric evaluations

If there are some numeric evaluations where units are needed to be taken into account to properly convert them accordingly, then the useUnits tag needs to be added to the program record. This will allow the control engine to use units to run any numeric evaluations, thus converting numeric values accordingly.

To add this tag to the program record, do the following:

  1. Go to Folio → Launch

  2. Query for program

  3. Select the program to edit it

  4. Add the useUnits tag and save it

  5. That’s it, the program now should be converting the numeric evaluations