###########
moat-modbus
###########
This is an anyio-enabled async frontend for pymodbus.
+++++
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).
++++++++++++++++++++++++
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
Raw data
{
"_id": null,
"home_page": null,
"name": "moat-modbus",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "MoaT",
"author": null,
"author_email": "Matthias Urlichs <matthias@urlichs.de>",
"download_url": "https://files.pythonhosted.org/packages/40/61/9e18b0e5ad27975b8a329c38fe99229351009403efaf87c6a7f9a59577eb/moat_modbus-0.8.6.tar.gz",
"platform": null,
"description": "###########\nmoat-modbus\n###########\n\nThis is an anyio-enabled async frontend for pymodbus.\n\n+++++\nUsage\n+++++\n\nCheck the example client and server for rudimentary usage.\n\nDocumentation patches gladly accepted.\n\n++++++++++\nBackground\n++++++++++\n\n`moat-modbus` diverges from `pymodbus` in that it does not expose a \"data\nstore\" context to the user. Instead, every bus value is a separate object,\nwith arbitrary length and encapsulating its own encoding and decoding rules.\n\nA Modbus server exposing writeable registers only needs to\n\n* register the value in question\n\n* wait for it to be written to\n\nThe rest happens behind the scenes.\n\n+++++++++++++\nDevice Server\n+++++++++++++\n\nAs some Modbus devices only allow ine server at a time, MoaT's Modbus\nsupports a simple bidirectional gateway.\n\nHow to get there:\n\n* Write a generic device description. Put it in the modbus-data repository.\n\n* Add an interface overlay that describes which topic to send the data to /\n which topic to read.\n\n* Run ``moat modbus dev poll FILE.yaml``. You can use a generic systemd\n service if you copy the file to ``/etc/moat/modbus``.\n\nThe values can be modified (factor+offset); the gateway works in both\ndirections (command/state).\n\n++++++++++++++++++++++++\nMQTT / MoaT-KV interface\n++++++++++++++++++++++++\n\nMoaT-Modbus includes a server that's informed by a device profile. This server\nacts as a bidirectional gateway from and to MQTT and/or MoaT-KV storage.\n\nSee \"gateway.rst\" for details.\n\n\nTODO\n++++\n\n* configurable codecs\n* get/set attributes\n* pack multiple values into a message\n* read-after-write if no slot\n",
"bugtrack_url": null,
"license": null,
"summary": "Modular async modbus client and server",
"version": "0.8.6",
"project_urls": {
"homepage": "https://m-o-a-t.org",
"repository": "https://github.com/M-o-a-T/moat"
},
"split_keywords": [
"moat"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d768c48fcec13e62a891477781c176277cd6c27bea072c125ece4b3dd0646df3",
"md5": "5fb67154a2ddd03547866eeba898c638",
"sha256": "06d1618af634666c90df537f079c07357909a92d31d6ec2bef8ed6aba10cb096"
},
"downloads": -1,
"filename": "moat_modbus-0.8.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5fb67154a2ddd03547866eeba898c638",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 35132,
"upload_time": "2025-07-22T07:33:11",
"upload_time_iso_8601": "2025-07-22T07:33:11.537960Z",
"url": "https://files.pythonhosted.org/packages/d7/68/c48fcec13e62a891477781c176277cd6c27bea072c125ece4b3dd0646df3/moat_modbus-0.8.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "40619e18b0e5ad27975b8a329c38fe99229351009403efaf87c6a7f9a59577eb",
"md5": "5f24b53bbfe1e273e48301edd0a54cb8",
"sha256": "1b378109725e6582e905c911f3698b4b245da8863e1f482faf49a4217d498df7"
},
"downloads": -1,
"filename": "moat_modbus-0.8.6.tar.gz",
"has_sig": false,
"md5_digest": "5f24b53bbfe1e273e48301edd0a54cb8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 34347,
"upload_time": "2025-07-22T07:33:12",
"upload_time_iso_8601": "2025-07-22T07:33:12.944529Z",
"url": "https://files.pythonhosted.org/packages/40/61/9e18b0e5ad27975b8a329c38fe99229351009403efaf87c6a7f9a59577eb/moat_modbus-0.8.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-22 07:33:12",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "M-o-a-T",
"github_project": "moat",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "anyio",
"specs": []
},
{
"name": "anyio_serial",
"specs": []
},
{
"name": "trio",
"specs": []
},
{
"name": "asyncclick",
"specs": []
},
{
"name": "asyncscope",
"specs": []
},
{
"name": "git",
"specs": []
},
{
"name": "msgpack",
"specs": []
},
{
"name": "simpleeval",
"specs": []
},
{
"name": "ruyaml",
"specs": []
},
{
"name": "cffi",
"specs": []
},
{
"name": "packaging",
"specs": []
},
{
"name": "pymodbus",
"specs": []
},
{
"name": "tomlkit",
"specs": []
}
],
"lcname": "moat-modbus"
}
JSON
