支持与文档

Requirements

• Python 3.10 or later
• pip (Python package manager)
• USB-to-RS485 adapter (FTDI recommended)
• ZT-100-C device connected via RS485

Installation

1. Download and extract: tar xzf ZT100C_Tool_1.0.0_linux.tar.gz
2. Create a virtual environment: python3 -m venv venv && source venv/bin/activate
3. Install dependencies: pip install -r requirements.txt

Serial Port Permissions

Your user must have access to serial ports. Add yourself to the dialout group: sudo usermod -a -G dialout $USER. Log out and back in for the change to take effect.

Running the Application

1. Start the application: python3 run.py
2. Your default browser opens automatically to http://localhost:8200
3. To run without opening a browser: python3 run.py --no-browser
4. Stop the application with Ctrl+C in the terminal

Connecting to a Device

1. Connect your USB-to-RS485 adapter to the PC
2. Connect the RS485 wires to the ZT-100-C device (A/B terminals)
3. In the browser, click the "Connect" tab in the left sidebar
4. Select "RS485 Terminal" mode (default)
5. Choose your serial port from the dropdown (typically /dev/ttyUSB0)
6. Click "Connect"
7. The device name and version appear in the top bar

Streaming Measurements

1. Go to the "Monitor" tab
2. Click "Start Stream" to begin live measurement polling
3. Values update every second (water cut, temperature, capacitance, current)
4. Click "Start Logging" to save measurements to a CSV file
5. The log file path appears in the top connection bar

Log File Location

CSV log files are saved to: ~/Documents/ZT100C_Logs/

Troubleshooting

• If no serial ports appear, check that your USB adapter is connected: ls /dev/ttyUSB*
• If you get "permission denied", ensure your user is in the dialout group
• If port 8200 is already in use, another instance may be running
• To use a different port, edit PORT in run.py