How to Work with Note Out in Soifgo

Step 1: Create a Note

First, create a button and set its behavior to Note. Choose Create to generate a blank note. Then go to the Play page, click the button to open the note, and from the menu or play icon select Note Out to see the list of communication methods. For example, choose Bluetooth and return to the note. Now you can start writing the required commands line by line.

Step 2: Sending Options

At the top of the page, you will see the Send icon. By long-clicking on this icon, a list of settings will appear:

• Manual Sending: No delay is applied. After clicking the send icon, another icon appears on the screen. Each time you click it, one line is sent. The next click sends the next line, and so on.
• Automatic Sending: Delay settings are applied.
  • Custom Wait Off: A single delay time (e.g., 2 seconds) is set at the bottom of the page and applied to all lines equally.
  • Custom Wait On: Different delays can be defined for each line, as explained below.

Method 1: Fixed Delay for All Lines (Custom Wait Off)

In this method, every line is sent with the same delay. You simply write the commands normally, and the system applies a uniform delay between each line.

Example:

Here, each command line will be sent one after another with the same delay (e.g., 2 seconds).

Method 2: Custom Delay Between Lines (Custom Wait On)

In this method, you can define different delays for each command. The first line is the command, and the next line is only the delay time in seconds.

Example:

In this example:

• START_MACHINE is sent, then waits 3 seconds.
• SET_SPEED 1200 is sent, then waits 5 seconds.
• MOVE_X 50 is sent, then waits 2 seconds.
• MOVE_Y 30 is sent, then waits 4 seconds.
• STOP_MACHINE is sent at the end.

Step 3: Communication Settings

Each communication method (Bluetooth, API, MQTT) has its own specific settings. Below are the main options for Bluetooth (similar concepts apply to API and MQTT):

• Send Format: Choose how each line ends, e.g. CR+LF, CR, NULL, etc.
• Echo: After sending, the same data must be echoed back to Soifgo. If no echo is received, Soifgo retries the send up to 3 times. If still no response, an error is triggered. This ensures reliable delivery of each packet.
• Wait for NEXT: With this option enabled, Soifgo waits for the word next or NEXT after each command. This is useful for tasks with uncertain completion times. Example: A conveyor or crane may take 2–30 seconds to finish moving a heavy load. Once the task is complete, the destination sends NEXT back, signaling Soifgo to continue with the next line.
• Loop On/Off: In automatic sending mode, enabling Loop On makes the note repeat after finishing all lines. With Loop Off, the note stops after one full cycle.

These settings allow you to adapt Note Out for different devices and scenarios, ensuring both reliability and flexibility in communication.

⬅ Back to Tutorial

⬅ Back to Home