Skip to main content

moat-modbus

% start synopsis % start main

This is an anyio-enabled async Modbus client/server, built on the sans-IO protocol core moat-lib-modbus (no pymodbus dependency).

% end synopsis

Usage

Check the example client and server for rudimentary usage.

Documentation patches gladly accepted.

Background

moat-modbus diverges from pymodbus in that it does not expose a "data store" context to the user. Instead, every bus value is a separate object, with arbitrary length and encapsulating its own encoding and decoding rules.

A Modbus server exposing writeable registers only needs to

  • register the value in question
  • wait for it to be written to

The rest happens behind the scenes.

Device Server

As some Modbus devices only allow ine server at a time, MoaT's Modbus supports a simple bidirectional gateway.

How to get there:

  • Write a generic device description. Put it in the modbus-data repository.
  • Add an interface overlay that describes which topic to send the data to / which topic to read.
  • Run moat modbus dev poll FILE.yaml. You can use a generic systemd service if you copy the file to /etc/moat/modbus.

The values can be modified (factor+offset); the gateway works in both directions (command/state).

% end main

MQTT / MoaT-KV interface

MoaT-Modbus includes a server that's informed by a device profile. This server acts as a bidirectional gateway from and to MQTT and/or MoaT-KV storage.

See "gateway.rst" for details.

TODO

  • configurable codecs
  • get/set attributes
  • pack multiple values into a message
  • read-after-write if no slot

Metadata

Release files for moat-modbus 0.9.21

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for moat-modbus 0.9.21
File Size Uploaded Provenance
moat_modbus-0.9.21.tar.gz 49.3 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for moat-modbus 0.9.21
File Interpreter ABI Platform
moat_modbus-0.9.21-py3-none-any.whl Python 3 none any Details

Total release size: 99.9 kB

Release files / moat_modbus-0.9.21.tar.gz

Download URL moat_modbus-0.9.21.tar.gz
Size 49.3 kB
Tags Source
SHA-256 checksum
How to use checksums
09dc364c34b9d06c596d787c658329157a7560bf6d85998901f9d7324a9a92f0
BLAKE2b-256 checksum
How to use checksums
a90c15934ddc39e3e8ac610364d5ba27ca10e81e39cde5ae38e48a463e45ee8e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Release files / moat_modbus-0.9.21-py3-none-any.whl

Download URL moat_modbus-0.9.21-py3-none-any.whl
Size 50.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
19231bc52fb5aec82926735cb82fdd70082734182e2614ddb593d5a5689470ac
BLAKE2b-256 checksum
How to use checksums
2afb19538fe6c111e7cd96a739b3c41e972e2e9edb1b03d08241c5c5ac5a8074
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Security for moat-modbus 0.9.21

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release

0.9.21 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page