Yotta Modbus CLI

A Node.js Command Line Interface (CLI) tool for controlling and monitoring Yottacontrol I/O modules via the Modbus TCP protocol.

🤖 AI-Native Ready: This repository includes a SKILL.md file, empowering modern AI Agents (like OpenCode or Claude) to act as your Modbus Engineer. You can ask an AI to "turn on the main light in the office" and it will parse your configuration, discover available channels, and execute the correct Modbus TCP commands automatically.

📦 Installation

Require Node.js 18+

npm install -g yotta-modbus-cli

🚀 Usage

Manage devices and read/write I/O channels directly from your terminal.

1. Device Management

Add your devices. The CLI automatically looks up and configures the I/O specifications (DO/DI/AI/AO counts & addresses) based on the model name.

# Add a device (auto configuration)
yotta add A1869 辦公室 192.168.10.10

# List all devices
yotta list

# Ping devices to check connectivity
yotta ping all

2. Labels and Channels

You can easily assign human-readable names to specific channels instead of using raw channel numbers.

# Set DO0 to "MainLight"
yotta set-label 辦公室 do 0 大燈

# View all channels
yotta channels 辦公室 all

3. Read I/O Status

# Read all I/O statuses
yotta read 辦公室 all 

# Read a specific labeled channel
yotta read 辦公室 大燈

# Read all DI channels
yotta read 辦公室 di

4. Control Outputs

# Turn ON a specific channel (by label or index)
yotta write-do 辦公室 大燈 1

# Turn OFF
yotta write-do 辦公室 大燈 0

# Write to AO (Analog Output)
yotta write-ao 測試設備 0 32768

🛠️ Configuration

Your device settings and channel labels are safely stored locally in: ~/.config/yotta-modbus-cli/config.json

🧠 AI Agent Integration (Tool-as-a-Skill)

For AI Agents, refer to the included SKILL.md. When added to your agent's workspace, it equips the AI with context on how to intelligently use the CLI commands to complete complex automation tasks based on user prompts.

License

MIT