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

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.10.0
File Size Uploaded Provenance Actions
moat_modbus-0.10.0.tar.gz 49.5 kB Without provenance Details for moat_modbus-0.10.0.tar.gz

Built distribution (wheel)

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

Total release size: 100.2 kB

Release files / moat_modbus-0.10.0.tar.gz

Download URL moat_modbus-0.10.0.tar.gz
Size 49.5 kB
Tags Source
SHA-256 checksum
How to use checksums
874367f21386e29ca11b0f8c6db0af5f76c16255b3c68963ee7dd2e7888ae5e8
BLAKE2b-256 checksum
How to use checksums
8bfcb78934dfaac7d1e5483670802f0c97eca8718098c2b16aea992da87585e9
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.10.0-py3-none-any.whl

Download URL moat_modbus-0.10.0-py3-none-any.whl
Size 50.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9fb35f2fde2bd2ad9fd523402559493c2c695a1ad96838ef61974973ad067b94
BLAKE2b-256 checksum
How to use checksums
56f5877d5363322cbd276a82d5e3067a509ad3242d358f6a0172a361a7637ef0
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.10.0

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.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.10.0 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