New functions using Azure SDK for Python

This commit is contained in:
2025-03-17 08:33:46 +01:00
parent 139f271905
commit 888352d3b8
5 changed files with 418 additions and 0 deletions

219
Python/server_async.py Normal file
View File

@@ -0,0 +1,219 @@
#!/usr/bin/env python3
"""Pymodbus asynchronous Server Example.
An example of a multi threaded asynchronous server.
usage::
server_async.py [-h] [--comm {tcp,udp,serial,tls}]
[--framer {ascii,rtu,socket,tls}]
[--log {critical,error,warning,info,debug}]
[--port PORT] [--store {sequential,sparse,factory,none}]
[--slaves SLAVES]
-h, --help
show this help message and exit
-c, --comm {tcp,udp,serial,tls}
set communication, default is tcp
-f, --framer {ascii,rtu,socket,tls}
set framer, default depends on --comm
-l, --log {critical,error,warning,info,debug}
set log level, default is info
-p, --port PORT
set port
set serial device baud rate
--store {sequential,sparse,factory,none}
set datastore type
--slaves SLAVES
set number of slaves to respond to
The corresponding client can be started as:
python3 client_sync.py
"""
import asyncio
import logging
import sys
from collections.abc import Callable
from typing import Any
try:
import helper # type: ignore[import-not-found]
except ImportError:
print("*** ERROR --> THIS EXAMPLE needs the example directory, please see \n\
https://pymodbus.readthedocs.io/en/latest/source/examples.html\n\
for more information.")
sys.exit(-1)
from pymodbus import __version__ as pymodbus_version
from pymodbus.datastore import (
ModbusSequentialDataBlock,
ModbusServerContext,
ModbusSlaveContext,
ModbusSparseDataBlock,
)
from pymodbus.device import ModbusDeviceIdentification
from pymodbus.server import (
StartAsyncSerialServer,
StartAsyncTcpServer,
StartAsyncTlsServer,
StartAsyncUdpServer,
)
_logger = logging.getLogger(__file__)
_logger.setLevel(logging.INFO)
def setup_server(description=None, context=None, cmdline=None):
"""Run server setup."""
args = helper.get_commandline(server=True, description=description, cmdline=cmdline)
if context:
args.context = context
datablock: Callable[[], Any]
if not args.context:
_logger.info("### Create datastore")
# The datastores only respond to the addresses that are initialized
# If you initialize a DataBlock to addresses of 0x00 to 0xFF, a request to
# 0x100 will respond with an invalid address exception.
# This is because many devices exhibit this kind of behavior (but not all)
if args.store == "sequential":
# Continuing, use a sequential block without gaps.
datablock = lambda : ModbusSequentialDataBlock(0x00, [17] * 100) # pylint: disable=unnecessary-lambda-assignment
elif args.store == "sparse":
# Continuing, or use a sparse DataBlock which can have gaps
datablock = lambda : ModbusSparseDataBlock({0x00: 0, 0x05: 1}) # pylint: disable=unnecessary-lambda-assignment
elif args.store == "factory":
# Alternately, use the factory methods to initialize the DataBlocks
# or simply do not pass them to have them initialized to 0x00 on the
# full address range::
datablock = lambda : ModbusSequentialDataBlock.create() # pylint: disable=unnecessary-lambda-assignment,unnecessary-lambda
if args.slaves > 1:
# The server then makes use of a server context that allows the server
# to respond with different slave contexts for different slave ids.
# By default it will return the same context for every slave id supplied
# (broadcast mode).
# However, this can be overloaded by setting the single flag to False and
# then supplying a dictionary of slave id to context mapping::
context = {}
for slave in range(args.slaves):
context[slave] = ModbusSlaveContext(
di=datablock(),
co=datablock(),
hr=datablock(),
ir=datablock(),
)
single = False
else:
context = ModbusSlaveContext(
di=datablock(), co=datablock(), hr=datablock(), ir=datablock()
)
single = True
# Build data storage
args.context = ModbusServerContext(slaves=context, single=single)
# ----------------------------------------------------------------------- #
# initialize the server information
# ----------------------------------------------------------------------- #
# If you don't set this or any fields, they are defaulted to empty strings.
# ----------------------------------------------------------------------- #
args.identity = ModbusDeviceIdentification(
info_name={
"VendorName": "Pymodbus",
"ProductCode": "PM",
"VendorUrl": "https://github.com/pymodbus-dev/pymodbus/",
"ProductName": "Pymodbus Server",
"ModelName": "Pymodbus Server",
"MajorMinorRevision": pymodbus_version,
}
)
return args
async def run_async_server(args) -> None:
"""Run server."""
txt = f"### start ASYNC server, listening on {args.port} - {args.comm}"
_logger.info(txt)
if args.comm == "tcp":
address = (args.host if args.host else "", args.port if args.port else None)
await StartAsyncTcpServer(
context=args.context, # Data storage
identity=args.identity, # server identify
address=address, # listen address
# custom_functions=[], # allow custom handling
framer=args.framer, # The framer strategy to use
# ignore_missing_slaves=True, # ignore request to a missing slave
# broadcast_enable=False, # treat slave 0 as broadcast address,
# timeout=1, # waiting time for request to complete
)
elif args.comm == "udp":
address = (
args.host if args.host else "127.0.0.1",
args.port if args.port else None,
)
await StartAsyncUdpServer(
context=args.context, # Data storage
identity=args.identity, # server identify
address=address, # listen address
# custom_functions=[], # allow custom handling
framer=args.framer, # The framer strategy to use
# ignore_missing_slaves=True, # ignore request to a missing slave
# broadcast_enable=False, # treat slave 0 as broadcast address,
# timeout=1, # waiting time for request to complete
)
elif args.comm == "serial":
# socat -d -d PTY,link=/tmp/ptyp0,raw,echo=0,ispeed=9600
# PTY,link=/tmp/ttyp0,raw,echo=0,ospeed=9600
await StartAsyncSerialServer(
context=args.context, # Data storage
identity=args.identity, # server identify
# timeout=1, # waiting time for request to complete
port=args.port, # serial port
# custom_functions=[], # allow custom handling
framer=args.framer, # The framer strategy to use
# stopbits=1, # The number of stop bits to use
# bytesize=8, # The bytesize of the serial messages
# parity="N", # Which kind of parity to use
baudrate=args.baudrate, # The baud rate to use for the serial device
# handle_local_echo=False, # Handle local echo of the USB-to-RS485 adaptor
# ignore_missing_slaves=True, # ignore request to a missing slave
# broadcast_enable=False, # treat slave 0 as broadcast address,
)
elif args.comm == "tls":
address = (args.host if args.host else "", args.port if args.port else None)
await StartAsyncTlsServer(
context=args.context, # Data storage
# port=port, # on which port
identity=args.identity, # server identify
# custom_functions=[], # allow custom handling
address=address, # listen address
framer=args.framer, # The framer strategy to use
certfile=helper.get_certificate(
"crt"
), # The cert file path for TLS (used if sslctx is None)
# sslctx=sslctx, # The SSLContext to use for TLS (default None and auto create)
keyfile=helper.get_certificate(
"key"
), # The key file path for TLS (used if sslctx is None)
# password="none", # The password for for decrypting the private key file
# ignore_missing_slaves=True, # ignore request to a missing slave
# broadcast_enable=False, # treat slave 0 as broadcast address,
# timeout=1, # waiting time for request to complete
)
async def async_helper() -> None:
"""Combine setup and run."""
_logger.info("Starting...")
run_args = setup_server(description="Run asynchronous server.")
await run_async_server(run_args)
if __name__ == "__main__":
asyncio.run(async_helper(), debug=True)