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.20

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.20
File Size Uploaded Provenance
moat_modbus-0.9.20.tar.gz 49.1 kB Without provenance Details

Built distribution (wheel)

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

Total release size: 99.5 kB

Release files / moat_modbus-0.9.20.tar.gz

Download URL moat_modbus-0.9.20.tar.gz
Size 49.1 kB
Tags Source
SHA-256 checksum
How to use checksums
439f638c88eb9cc2df0549e71b5a9a03663618eaacfd809aaa0fda1ec4c888fd
BLAKE2b-256 checksum
How to use checksums
6aafd444b3ac7b3395340592f805d715b7c7a5c5ff970aa65c1c48917c307cff
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.20-py3-none-any.whl

Download URL moat_modbus-0.9.20-py3-none-any.whl
Size 50.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4c895ec5249fd951319099d66fe73f3779894ec173d8c3512995c1ba0530f060
BLAKE2b-256 checksum
How to use checksums
6a229df3ce7210e0ee58fce948ac8245753c7aa6800b05b07de3a7704d5eb65c
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.20

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.20 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