The Dash OS Calculator App is a multi-purpose Dash Application that gives your end-users a Calculator to use within their systems. However, that is not where the real functionality of the Dash Calculator comes in. It’s true power comes from it’s ability to provide mathematic operations within your macros as well as counters that can provide methods of automating many tasks and keeping track of various functions when building your system(s).
A Dash OS plugin which allows you to execute standard math functions in macros. In addition it allows you to create reactive counters which allows you to execute different macros based on the frequency of events in the system. Counters can also be monitored from the DashOS Dashboard.
This is coupled with an interface allowing the user to run a quick calculation without reaching for their phone or computer.
Available TCL Commands
- Math Operation – Evaluate a simple math operation with two operands.
Takes two operands and the operator. The result of the math operation is saved to a variable. Decimal values are truncated to the whole number.
- Initialize counter – Create a counter
Creates and initializes counter to 0. Returns either 0 for success or -1 when the counter already exists.
Counters can be created persistent. This means that they will not be deleted in the case of a base station reboot. This command is required before any other commands can be used for a specific counter.
- Get Counter Value – Returns the current value of specified counter.
- Adjust Counter – Increases or decreases the value of the counter with the entered value
- Set Counter – Set the counter to a specific value
Available Device Events
- Counter Event – Events can be set for a counter. This means that a macro can be executed when a specific state of the counter is reached. An event can be programmed to occur when the counter becomes greater than, equal or less than a specified value. Events can only be triggered based on the “Adjust Counter command”.
Dash App Documentation Overview
This page will guide you through the installation, configuration, and programming of the specified Dash App. You can navigate to various sections of the documentation by using the menu to the left. New information is always being added to Dash’s Documentation so be sure to check back often to discover new ways to utilize your apps!
My > IP Database > AUX > Dash Apps > Calculator
Dash – Calculator.csd
Dash OS Update History
Whenever an update is available for a Dash App, a log of the major changes in the version will be provided below. This does not necessarily reflect every change that was made as some minor changes may have been made that are undocumented, but it should reflect any changes that affect the operation of the Dash App.
Download & Import the Dash App
In order for the Dash App to become recognized by the URC Programming Software we will need to import the provided TCM File into the Software. Once this has been done properly the Dash App should show up in the “Add Other Devices” programming step in the “Accelerator Location” provided on the overview tab.
In your Programming Software locate the “Import TCM Files” button in the File tab of the top menu toolbar. Click it to open the Windows File Browsing window. Browse to the TCM file you wish to import and select it.
Based on the Dash App / Module you are importing, a dialog similar to the below will appear. This window indicates what interfaces are supported by the TCM File you selected. System Plugins may only show “Driver” and “Base Station Files” when no User Interface is provided by the module.
After Importing your TCM File it is always safe to quickly restart your Accelerator Software to make sure your changes are properly made. While this isn’t required every time, it is a good step to make sure everything is changed as needed.
Confirm that the Dash App was successfully imported. You can do this by navigating to the driver where the Dash App is installed (see Overview Tab) and making sure a checkbox is provided for “8. Select 2-Way Modules for Network Remotes / Keypads”
Non URC Network Setup
Network Setup is a step that is required regardless of if the module is communicating with a physical device. This step will go over how your Network Setup should be configured for this Dash App. You will generally find the Dash App under “Network Setup > Non URC Device” in your URC Program.
This Dash App does not require that a specific IP Address is setup for it to operate. However, it should be assigned an “Instance ID.” When a module does not require a specific IP Address be setup, you can assign any IP Address to the Dash App that is unique from any other device in the list.
Your IP Address will be used as an “Instance ID” which will separate it from any other Dash Apps or URC Modules you have setup. This ID is helpful when you want to create jumps to the Dash App / Module in multiple rooms / areas of your programming.
In the example below we have added two Dash Apps, “System Monitor” and “Time Tools.” Each has been given a unique value “0.0.0.1” and “0.0.0.2.” If they were assigned the same value the Dash App would result in an error and would not start up properly.
Step 11. 3rd Party 2-Way Settings
Properly configuring the Dash App Parameters in your Automation Programming Software is important in order to make the App work as you want it to. These Parameters will be used each time the App starts up to configure how the App will operate. Below we will go over each available parameter.
Dash App Feature Tour / Walkthroughs
Welcome to the Dash App Feature Tour! This page will go over the features available to you when using the Dash App within your Dash OS-powered systems. These tours may include specific programming guides, file examples, drivers, or simply detailed explanations of the features listed on the Product Description tab. Use the tabs to the left to select a feature that you would like to learn more about! Enjoy!
Counters And Values
Counters are created and adjusted using TCL Commands. Initializing a counter can be set for persistent or not, meaning that they wont be deleted with a base station reboot. The initial value of a counter will be set to 0, or -1 if the counter already exists.
Using the “Get Counter Value” command, you can save the value of the counter into a URC Integer Variable.
“Adjust Counter” will be the only thing that will trigger the Counter Events. This will change the value of the counter by the set parameters.
“Set Counter” will set the current value for a specified counter.
Using A Counter Event
Counter events can be triggered when ever a counter equals, is greater than, or less than a set amount. These events will only be triggered on an “Adjust Counter” TCL Command.