String Command Control

## String Command Control

![](/media/202601/5ed2c383-077e-4bcf-9064-c6bcf778f2e4_1768532768.png)

## Module Principle
[Simple description of module principle]

## Usage Scenarios
[Some modules have their own proprietary usage scenarios, please list them in detail in this section]

## Usage Method

### Pre/Post-Sequence Modules
[Upper and lower modules used in normal use of this module]

## Parameter Configuration Description
![](/media/202601/eb321581-7bed-4d39-be4e-d660ef847361_1768532910.png)
1. Communication Port Selection: Select the communication port to be read. Gray light indicates the communication port is unused; red light indicates communication port connection failed; green light indicates communication port connected normally. When the specified communication port type is a device supporting string communication such as serial port, tcp client, tcp server, etc., display client IP, start character, end character and other parameter information; otherwise display the type of the specified communication port.
2. Client IP:
3. Start Character: Used to judge and remove the header of the received string. If the header is not the same, it means it is not the required content and is not processed. If it is the same, it is removed during processing. When the start character is empty, judgment and removal are not performed.
4. End Character: Used to judge and remove the tail of the received string. If the tail is not the same, it means it is not the required content and is not processed. If it is the same, it is removed during processing. When the end character is empty, judgment and removal are not performed.
5. Separator: Mainly used to split the string after removing the start character and end character, converting it into commands and parameters.

## Output Description

![](/media/202601/78ede5ae-2246-4e65-a19d-e798ab3e27aa_1768532930.png)
1. Run Result: If the specified communication port data type is incorrect or writing fails when not connected, it is false; when the specified communication port type is correct and writing succeeds when connected, it is true.
2. Read String: The string read by the specified communication port.
3. Read String Length: The length of the string read by the specified communication port.
4. Action Return Value: If the read string triggers an added action, return the output value of the specified action. When there is no action, only return 0.

## Other Supplements
Supported command methods include: start, stop, switch recipe, trigger flow, write value (i.e., write global variable), write value then trigger flow, switch recipe based on parameters, trigger flow based on parameters.

## Precautions

---

Click here to jump to the corresponding Chinese manual page: [String Command Control](/doc/250)