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

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.16
File Size Uploaded
moat_modbus-0.9.16.tar.gz 46.1 kB Details

Built distribution (wheel)

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

Total release size: 93.0 kB

Release files / moat_modbus-0.9.16.tar.gz

Download URL moat_modbus-0.9.16.tar.gz
Size 46.1 kB
Tags Source
SHA-256 checksum
How to use checksums
14a3102f909712129d36656013fdb09df5922c49a57b6d3fb52146110c04d677
BLAKE2b-256 checksum
How to use checksums
93a76c1da21ba2a8f24599c6539d02441e9b1d5e7e5e9e7ed1f96902ebd8896c
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.16-py3-none-any.whl

Download URL moat_modbus-0.9.16-py3-none-any.whl
Size 46.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f230882c0105e7876b91881969d88a75254be4fe21d73a7a93c40b1ca64242ac
BLAKE2b-256 checksum
How to use checksums
2081e1ff7d8556d721e912767d95e4dea5250954bd7544cd7199c48b44d9a8a5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Release history Release notifications | RSS feed

This release

0.9.16 This release

2 release files

0.9.9

2 release files

0.9.7

2 release files

0.9.5

2 release files

0.9.4

2 release files

0.9.3

2 release files

0.9.2

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.10

2 release files

0.8.9

2 release files

0.8.8

2 release files

0.8.7

2 release files

0.8.6

2 release files

0.8.5

2 release files

0.8.3

2 release files

0.8.2

2 release files

0.8.0

2 release files

0.7.2

2 release files

0.6.2

2 release files

0.5.3

2 release files

0.4.7

2 release files

0.4.6

2 release files

0.4.4

2 release files

0.3.2

1 release file

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