pyModbusTCP-cli 0.4.0a2__py3-none-any.whl → 0.4.0a3__py3-none-any.whl

{pymodbustcp_cli-0.4.0a2.dist-info → pymodbustcp_cli-0.4.0a3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pyModbusTCP-cli
-Version: 0.4.0a2
+Version: 0.4.0a3
 Summary: Command line tools for pyModbusTCP: Modbus/TCP server, client and Modbus TCP/RTU gateways
 Project-URL: Source, https://github.com/sourceperl/pyModbusTCP
 Project-URL: Issues, https://github.com/sourceperl/pyModbusTCP/issues
@@ -14,7 +14,7 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Topic :: System :: Networking
 Requires-Python: >=3.10
-Requires-Dist: pymodbustcp[serial]==0.4.0a2
+Requires-Dist: pymodbustcp[serial]==0.4.0a3
 Description-Content-Type: text/markdown
 
 # pyModbusTCP-cli
@@ -39,7 +39,7 @@ command in the PATH and installs no dependency.
 pipx install pyModbusTCP-cli
 
 # or in a virtual environment, with the library
-pip install "pyModbusTCP[cli]==0.4.0a2"
+pip install "pyModbusTCP[cli]==0.4.0a3"
 ```
 
 **Alpha**: pyModbusTCP-cli is new with pyModbusTCP 0.4.0, only pre-releases exist for now. The commands, their
@@ -51,7 +51,7 @@ Without this package, the tools can still be run from the library alone:
 ```bash
 python -m pyModbusTCP.tools server --help
 python -m pyModbusTCP.tools client --help
-pip install "pyModbusTCP[serial]==0.4.0a2"  # pyserial, only needed by the gateways
+pip install "pyModbusTCP[serial]==0.4.0a3"  # pyserial, only needed by the gateways
 python -m pyModbusTCP.tools tcp2rtu --help
 python -m pyModbusTCP.tools rtu2tcp --help
 ```
@@ -65,7 +65,11 @@ mbtcp-server --log-changes
 # read 4 holding registers from address 0, write some values
 mbtcp-client -p 5020 read-holding 0 -n 4
 mbtcp-client -p 5020 write-registers 0 100 200 0x1234
+mbtcp-client -p 5020 write-read 0 20 22 1 -n 4      # write then read in one request (function 0x17)
 mbtcp-client -p 5020 write-coil 10 on
+# float32 values on 2 registers, word swapped (CDAB): -T/--type and -b/--byte-order
+mbtcp-client -p 5020 write-registers 20 3.14 -2.5 -T float32 -b CDAB
+mbtcp-client -p 5020 read-holding 20 -n 2 -T float32 -b CDAB
 
 # TCP clients of the 192.168.1.0/24 network can read (only) the RTU slaves of /dev/ttyUSB0
 mbtcp-tcp2rtu -H 0.0.0.0 -A 192.168.1.0/24 --read-only -b 19200 --parity E /dev/ttyUSB0
@@ -74,7 +78,11 @@ mbtcp-tcp2rtu -H 0.0.0.0 -A 192.168.1.0/24 --read-only -b 19200 --parity E /dev/
 mbtcp-rtu2tcp -a 30 -H 192.168.1.10 /dev/ttyUSB0
 ```
 
-Run any command with `--help` for all its options.
+On a terminal, `mbtcp-client` prints a table (registers in hexadecimal, unsigned, signed, binary and ASCII, bits
+in a grid); with `-i` it is refreshed in place and the changed values are highlighted. For a script, `-f plain`,
+`-f csv` or `-f json` (the default output of a pipe is `plain`: one `address value` line per item).
+
+Run any command with `--help` for all its options, `-v/--version` for its version.
 
 ## Security
 
@@ -84,9 +92,13 @@ The server and the TCP to RTU gateway are designed to be safe by default:
 - they listen on `localhost` and on port 5020 by default: use `-H` with the address of the network interface that
   needs it (`0.0.0.0` only if every network of the host is trusted);
 - `-A/--allow` restricts the clients to some IP addresses or networks, `--read-only` refuses every write;
-- the TCP to RTU gateway refuses broadcast requests (unit id 0) unless `--allow-broadcast` is set;
+- the TCP to RTU gateway only relays the standard data functions by default (no diagnostics, file records or vendor
+  functions): `--functions` sets the list;
+- the TCP to RTU gateway refuses broadcast requests (unit id 0) unless `--allow-broadcast` is set (and then only
+  for the write functions, answered at once);
 - `--max-connections-per-host` (default 16) keeps a single client host from taking every connection, and the TCP
-  to RTU gateway shares the serial line between the client hosts (at most 2 pending requests per host).
+  to RTU gateway shares the serial line between the client hosts (at most 2 requests per host waiting for the line or
+  in progress).
 
 Port 502 (the standard Modbus/TCP port) is a privileged port on Unix systems. **Never run these commands as root (or
 with sudo) to listen on it.** Give the `CAP_NET_BIND_SERVICE` capability to the Python interpreter of a virtual

pymodbustcp_cli-0.4.0a3.dist-info/RECORD

@@ -0,0 +1,5 @@
+pymodbustcp_cli-0.4.0a3.dist-info/METADATA,sha256=HlQjtBbi8I4fBmDG66dOK9LC6eInVZRJsQTotg0Xe_4,6164
+pymodbustcp_cli-0.4.0a3.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+pymodbustcp_cli-0.4.0a3.dist-info/entry_points.txt,sha256=mui54qZCX_q1fqQAy91019E49Ygr0udexBRFOsRQJMk,226
+pymodbustcp_cli-0.4.0a3.dist-info/licenses/LICENSE,sha256=Q-TwRxZ_Hhz-lD3EK2MX1_4yE70R2LsYsWlVkA5ehwc,1077
+pymodbustcp_cli-0.4.0a3.dist-info/RECORD,,

pymodbustcp_cli-0.4.0a2.dist-info/RECORD

@@ -1,5 +0,0 @@
-pymodbustcp_cli-0.4.0a2.dist-info/METADATA,sha256=EGqBiDsQ3fMQA1_qBwb7kApiFepvWgce0CjuNtdRmW8,5241
-pymodbustcp_cli-0.4.0a2.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-pymodbustcp_cli-0.4.0a2.dist-info/entry_points.txt,sha256=mui54qZCX_q1fqQAy91019E49Ygr0udexBRFOsRQJMk,226
-pymodbustcp_cli-0.4.0a2.dist-info/licenses/LICENSE,sha256=Q-TwRxZ_Hhz-lD3EK2MX1_4yE70R2LsYsWlVkA5ehwc,1077
-pymodbustcp_cli-0.4.0a2.dist-info/RECORD,,