ZT-100-C Tool
=============

Version   0.1.0
Built     2026-08-24 18:20 +08
Source    et25001-m27-docs @ ec3ac39
Files     42

WHAT THIS IS
------------
The ZT-100-C Tool configuration and service tool, as SOURCE. It is not a
standalone executable - the target machine needs Python 3.12 or later.

This is the only build published on zelentech.co, and it runs on Windows,
Linux and macOS alike. Python 3.12 or later must be installed first - the
Software page carries a step-by-step setup guide for Windows and for Linux.

INSTALL
-------
1. Unpack this archive.
2. In the unpacked folder:

       pip install -e .

   That installs the dependencies (PySide6, pyqtgraph, pyserial, pymodbus)
   and creates the launcher.

3. Run it:

       zt100c-app

   It works from any directory once installed. Without the install step you
   can still run it from the unpacked folder with:

       python -m zt100c_app

CONNECTING
----------
The tool finds serial ports by itself and classifies them - a card's USB
console, an FTDI RS485 cable, a HART modem. Pick the port on the Connect
page. There are also simulator targets that need no hardware at all, which
are the fastest way to see whether the tool itself is working.

If no ports are listed with a cable plugged in, check that its driver is
installed and that nothing else is holding the port open - a terminal left
running on the same port is the usual cause.

TERMINAL-ONLY MODE
------------------
The Connect page has a "Terminal only" tick box. It skips the two large
replies this app asks for (`help` and `cfg list`), which some cards cannot
survive over USB. You lose the generated pages and the command list; the
terminal itself works normally. If a card goes quiet the moment you connect,
try it.

NOTE
----
Nothing in this tool has been verified against a real card at the byte
level; see NOT_HARDWARE_VERIFIED.md in the source repository for what that
means and what is still to be checked.
