This repository demonstrates how to create a reusable TCP communication layer (CSM-TCP-Router) to turn a local program into a TCP server for remote control. This example showcases the advantages of the CSM framework's invisible bus.

## Features

- All CSM messages that can be sent locally can be transmitted to the local program via TCP connection using CSM synchronous and asynchronous message formats.
- Based on the JKI-TCP-Server library, it supports multiple TCP clients connecting simultaneously.
- [client] Provides a standard TCP client that can connect to the server to verify remote connections and message sending.

> [!IMPORTANT]
> `TCP Packet Format:` | Data Length (4 bytes) | CSM Command String (plain text) |

> [!NOTE]
> Example: Suppose there is a CSM module named DAQmx locally with an interface "API: Start Sampling".
> Locally, we can send messages to this module to control the start and stop of sampling:
>
> - API: Start Sampling -@ DAQmx // Synchronous message
> - API: Start Sampling -> DAQmx // Asynchronous message
> - API: Start Sampling ->| DAQmx // Asynchronous message without return
>
> Now, by sending the same text message via TCP connection, remote control can be achieved.

> [!WARNING]
> Currently, CSM-TCP-Router only supports synchronous messages (-@) and asynchronous messages without return (->|). Asynchronous messages (->) will be treated as asynchronous messages without return.

## Usage

1. Install this tool and dependencies via VIPM
2. Open the example project CSM-TCP-Router.lvproj in the CSM examples
3. Start the CSM-TCP-Router(Server).vi in the code project
4. Start Client.vi, enter the server's IP address and port number, and click connect
5. Enter commands and click send to see the returned messages in the console
6. View the history of executed messages in the log interface of the Server program
7. Enter `Bye` in Client.vi to disconnect
8. Close the Server program