Arithmetic Operations Using the Sum Node

This guide assumes familiarity with the following information:

In this guide, you'll learn how to perform an arithmetic operation of addition using a Sum Node in an action flow. You can use a Sum Node to increase the attribute value of a device, such as volume or brightness level, by a specific integer within a specified range. And while this guide highlights the addition operation, you can also use other arithmetic operations in Bixby Home Studio (BHS). The device used in this guide is a SmartThings-enabled TV.

This guide uses the example "Increase the volume of the television" to raise the television's volume level by a reasonable amount in response to the user's command.

Using the volume - increase Voice Intent

The goal is to define the action flow for the volume-increase voice intent for the device. For this voice intent, the user should be satisfied the volume has increased a reasonable amount.

Example: "Increase the volume of the television."

Fetching the Volume Value

You need to add and configure an Attribute Node to fetch the current volume value of the device.

The current volume value of the device is an attribute of the audioVolume capability.

To add and configure this node:

Drag the Attribute Node from the action flow nodes sidebar to the editor area. Select the node. This opens the Node Configuration menu on the right of the editor area.

Open Node Configuration Menu

Select the audioVolume capability. In most cases, you can leave the component selection as the default option, main. For more information on components, see the note at the bottom of this section.

Select audioVolume Capability

In the pop-up, select the value property for the audioVolume attribute. Click SAVE.

Select Value Property

The Node Configuration window will look like this:

Node Configuration Window

Note

Most devices have only one operating section or compartment. In this case, the only option for component is main. If a device has many sections or compartments that you can operate independently, there will be multiple component options, such as top, bottom, and middle.

Now you're ready to add a Sum Node to the action flow.

Adding With the Sum Node

A satisfactory volume level varies from person to person; in this guide, you'll increase the current volume level by 10.

Drag a Constant Node from the action flow nodes sidebar to the editor area. Set its value type to Integer and give it the value 10.

The values of the Attribute Node and the Constant Node get passed to a Sum Node, whose output sets the final audioVolume of the device. Drag a Sum Node from the sidebar to the editor area.

The Sum Node has two input data ports (leftValue and rightValue), and one output data port. The output port returns the result of adding the leftValue and rightValue. Connect the Constant Node to one input port of the Sum Node, and the Attribute Node to the other input port.

Sum Node Diagram

Next, you need to add a Command Node to the action flow to set the device's audioVolume.

Setting the audioVolume

Finally, add a Command Node. The output value of the Sum Node will be the argument for the Command Node. Configure the Command Node to tell the device to set its audioVolume to the argument value:

Drag a Command Node to the flow editor area. Then, click the node to open the Node Configuration menu on the right. Click APPEND NEW ITEM.

Open the Command Node Configuration Menu

Select main in the component menu. Then, select audioVolume in the capability menu.

Select audioVolume Capability

A pop-up for the audioVolume capability opens. Select the setVolume command. Click SAVE.

Select setVolume Command

The Command Node should now have a dynamic input port for the audioVolume value. The input value determines the volume value for this device.

The New Input Port for Command Node

Now you need to connect a data path from the Sum Node's value data port to the Command Node's dynamic input port. You also need to connect the Start Node's main port to the Sum Node's trigger port and the Sum Node's main port to the Command Node's trigger port.

Here's the finished action flow:

Finished Action Flow

Testing Your Action Flow

To test the action flow, click the Try It button at the top right of the editor window. The flow editor should look like this:

Execution Flow

As you can see above, the current audioVolume value is 21. To increment it by 10, configure a Constant Node to have a value of 10. Those two values are fed into the Sum Node, which gives the result of 31. This value is sent to the device using the Command Node to set the audioVolume to 31.

Using Other Arithmetic Operations

You can use any of these arithmetic operations in action flows:

  • addition (increase by n) Sum Node
  • subtraction (reduce by n) Subtraction Node
  • multiplication (increase by n times) Multiplication Node
  • division (reduce by n times) Division Node

You can also perform calculations with the Sub Graph feature to reduce the complexity of a graph and separate functionality into distinctive and reusable sections.

For an additional example, see the "Increase the Brightness of the Device by a Value" Sample Graph.