mcp1081_async_driver

MicroPython asynchronous Modbus RTU driver for the MER-MCP1081-260-26 water-level sensor

2.1.0-async.1 yangcong-bit 更新时间: 2026-11-11
安装包
本地安装
mpremote mip install https://upypi.net/pkgs/mcp1081_async_driver/2.1.0-async.1
远程安装
mip.install("https://upypi.net/pkgs/mcp1081_async_driver/2.1.0-async.1")
版本选择
README

MicroPython asynchronous Modbus RTU driver for the MER-MCP1081-260-26 water-level sensor — MicroPython 异步驱动

实验性异步版本:尚未完成实物验收。

同步来源:同步版本。维护者说明同步版本已验证;本次未逐包复测同步来源,适用硬件和固件范围以原有记录为准。

异步版本:本包 Python 源码及示例已通过 MicroPython 1.23 / 1.29 编译检查;软件回归只覆盖选定路径,不代表本包全部 API、实际器件及并发行为已验证。

仓库验证说明 · 两轮软件检查 · 受限清单 · 安装与初始化迁移

目录

简介

mcp1081_async_driver 是当前仓库中独立发布的 MicroPython 异步包。设备/功能名称和 API 均来自包内运行时文件;它不是对同步 API 的无依据重命名。源包:sensors/mcp1081_driver。

主要功能

  • 可解析的公开类:AbstractSet, Any, AsyncContextManager, AsyncGenerator, AsyncIterable, AsyncIterator, Awaitable, ByteString, ChainMap, ClassVar, Collection, CommonModbusFunctions, Container, ContextManager, Coroutine, Counter, DefaultDict, Deque, FrozenSet, Generator, Generic, Hashable, ItemsView, Iterable, Iterator, KeysView, MERAsync, Mapping, MappingView, Modbus, ModbusException, ModbusRTU, ModbusTCP, MutableMapping, MutableSequence, MutableSet, NamedTuple, NoReturn, Request, Reversible, Sequence, Serial, Set, Sized, TCP, TCPServer, Type, ValuesView, dict_keys。
  • 可解析的公开调用入口:195 个(详见 API 矩阵)。
  • 异步等级:native_async;依据:代码使用协程/流或可轮询 I/O。

硬件要求

项目 从代码取得的事实
通信/IO UART, Pin(
示例 GPIO 16、17
供电、地址与电平 仅按模块实物标签、数据手册及代码常量配置;。

软件环境

项目 值
运行时 MicroPython + uasyncio
包版本 2.1.0-async.1
作者 leeqingshui
依赖 无声明的第三方依赖

文件结构

├── code/main.py
├── code/_gs_mcp1081_mcp1081_umodbus/__init__.py
├── code/_gs_mcp1081_mcp1081_umodbus/common.py
├── code/_gs_mcp1081_mcp1081_umodbus/const.py
├── code/_gs_mcp1081_mcp1081_umodbus/functions.py
├── code/_gs_mcp1081_mcp1081_umodbus/modbus.py
├── code/_gs_mcp1081_mcp1081_umodbus/serial.py
├── code/_gs_mcp1081_mcp1081_umodbus/tcp.py
├── code/_gs_mcp1081_mcp1081_umodbus/typing.py
├── code/_gs_mcp1081_mcp1081_umodbus/version.py
├── code/_gs_mcp1081_mer.py
├── code/mcp1081_mer_async.py
├── examples/main_sync.py
├── LICENSE
└── package.json

文件说明

  • code/:实际发布的运行时 Python 模块;以 package.json.urls 为安装映射依据。
  • code/main.py(若存在):异步演示入口,不是默认发布运行时映射。
  • examples/(若存在):同步保真基线或额外示例,不应当作安装后的运行时模块。
  • package.json、LICENSE:发布元数据和许可证的唯一事实来源。

快速开始

  1. 按 package.json.urls 将运行时文件复制到设备;不要把 examples/ 当作运行时依赖。
  2. 按上文硬件/运行环境配置总线、GPIO、网络或凭证。
  3. 使用包内真实 code/main.py 的 import 与构造方式运行。以下是当前文件逐字读取的异步入口;部署时请保留 try/finally 并调用对象实际提供的 deinit() 或 aclose()。
# Python env   : MicroPython v1.23.0
# -*- coding: utf-8 -*-
# @Time    : 2026/09/16
# @Author  : GraftSense Async Conversion
# @File    : main.py
# @Description : MER-MCP1081 asynchronous example
# @License : MIT

# ======================================== 导入相关模块 =========================================
try:
    import uasyncio as asyncio
except ImportError:
    import asyncio
from machine import UART, Pin
from _gs_mcp1081_mer import MER
from mcp1081_mer_async import MERAsync
from _gs_mcp1081_mcp1081_umodbus.serial import Serial as ModbusRTUMaster

# ======================================== 全局变量 ============================================
SLAVE_ADDR = 1

# ======================================== 功能函数 ============================================
# Static source-flow mapping; never called because it is the synchronous-host API.
def source_constructor_reference():
    return ModbusRTUMaster(pins=(16, 17), baudrate=9600, data_bits=8, stop_bits=1, parity=None, uart_id=0)

async def source_api_flow_async(sensor):
    await sensor.read_node_address_async()
    await sensor.read_hw_version_async()
    await sensor.read_fw_version_async()
    await sensor.read_device_uid_async()
    await sensor.read_filter_count_async()
    await sensor.read_fit_mode_async()
    await sensor.read_alarm_levels_async()
    await sensor.read_full_level_async()
    await sensor.read_measurements_async()
    sensor.deinit()

async def monitor_async(sensor):
    while True:
        try:
            print(await sensor.read_measurements_async())
        except RuntimeError as error:
            print("Transient communication error: %s" % error)
        await asyncio.sleep_ms(1000)

# ======================================== 自定义类 ============================================

# ======================================== 初始化配置 ===========================================
async def main_async():
    uart = UART(0, baudrate=9600, tx=Pin(16), rx=Pin(17))
    sensor = MERAsync(uart, slave_addr=SLAVE_ADDR)
    try:
        await monitor_async(sensor)
    finally:
        sensor.deinit()
        uart.deinit()

# ========================================  主程序  ============================================
try:
    asyncio.run(main_async())
finally:
    asyncio.new_event_loop()

异步设计与使用

源状态:sync_source。本包归属当前异步仓库;原始实现的作者和许可证以源包元数据及 LICENSE 为准。协程入口应以 asyncio.run(main()) 启动。若类提供 start()/stop()、deinit() 或 aclose(),必须按其实际签名管理后台任务和资源,且在 finally 中清理。

API Async Matrix

API Level Async strategy Residual blocking Timeout/cancellation
CommonModbusFunctions.read_coils native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
CommonModbusFunctions.read_discrete_inputs native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
CommonModbusFunctions.read_holding_registers native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
CommonModbusFunctions.read_input_registers native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
CommonModbusFunctions.write_multiple_coils native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
CommonModbusFunctions.write_multiple_registers native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
CommonModbusFunctions.write_single_coil native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
CommonModbusFunctions.write_single_register native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.calibrate_empty_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.calibrate_full_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.deinit native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_alarm_levels_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_calib_switch_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_cap_channels_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_capacitance_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_device_uid_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_filter_count_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_fit_mode_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_frequency_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_full_level_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_fw_version_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_hw_version_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_hw_version_raw_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_level_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_low_alarm_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_measurements_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_node_address_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_overflow_alarm_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_ratio_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_ref_level1_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_ref_level2_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_ref_level3_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_reference_point_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_reference_sf_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_register_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_registers_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_sf_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.read_temp_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.slave_addr native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.wake_up_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.write_calib_switch_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.write_filter_count_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.write_fit_mode_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.write_full_level_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.write_low_alarm_level_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.write_node_address_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.write_overflow_alarm_level_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.write_ref_level1_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.write_ref_level2_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.write_ref_level3_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.write_reference_point_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.write_reference_sf_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
MERAsync.write_register_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.add_coil native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.add_hreg native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.add_ireg native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.add_ist native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.changed_coils native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.changed_hregs native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.changed_registers native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.coils native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.get_coil native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.get_hreg native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.get_ireg native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.get_ist native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.hregs native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.iregs native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.ists native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.process native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.remove_coil native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.remove_hreg native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.remove_ireg native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.remove_ist native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.set_coil native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.set_hreg native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.set_ireg native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.set_ist native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Modbus.setup_registers native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
ModbusTCP.bind native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
ModbusTCP.get_bound_status native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Request.send_exception native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Request.send_response native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Serial.deinit native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Serial.get_request native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Serial.send_exception_response native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Serial.send_response native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
Serial.write_raw native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
TCPServer.bind native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
TCPServer.get_is_bound native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
TCPServer.get_request native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
TCPServer.is_bound native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
TCPServer.send_exception_response native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
TCPServer.send_response native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
add_coil native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
add_hreg native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
add_ireg native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
add_ist native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
bin_to_float native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
bind native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
bytes_to_bool native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
calibrate_empty_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
calibrate_full_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
cast native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
changed_coils native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
changed_hregs native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
changed_registers native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
coils native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
deinit native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
exception_response native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
float_to_bin native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
get_bound_status native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
get_coil native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
get_hreg native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
get_ireg native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
get_is_bound native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
get_ist native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
get_request native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
hregs native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
int_to_bin native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
iregs native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
is_bound native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
ists native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
main_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
monitor_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
overload native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
process native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_alarm_levels_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_calib_switch_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_cap_channels_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_capacitance_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_coils native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_device_uid_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_discrete_inputs native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_filter_count_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_fit_mode_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_frequency_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_full_level_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_fw_version_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_holding_registers native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_hw_version_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_hw_version_raw_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_input_registers native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_level_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_low_alarm_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_measurements_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_node_address_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_overflow_alarm_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_ratio_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_ref_level1_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_ref_level2_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_ref_level3_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_reference_point_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_reference_sf_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_register_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_registers_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_sf_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
read_temp_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
remove_coil native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
remove_hreg native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
remove_ireg native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
remove_ist native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
response native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
send_exception native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
send_exception_response native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
send_response native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
set_coil native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
set_hreg native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
set_ireg native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
set_ist native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
setup_registers native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
slave_addr native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
source_api_flow_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
source_constructor_reference native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
to_short native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
uint16_to_int16 native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
validate_resp_data native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
wake_up_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
write_calib_switch_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
write_filter_count_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
write_fit_mode_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
write_full_level_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
write_low_alarm_level_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
write_multiple_coils native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
write_multiple_registers native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
write_node_address_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
write_overflow_alarm_level_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
write_raw native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
write_ref_level1_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
write_ref_level2_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
write_ref_level3_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
write_reference_point_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
write_reference_sf_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
write_register_async native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
write_single_coil native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。
write_single_register native_async 代码使用协程/流或可轮询 I/O 底层总线/同步临界区可能阻塞事件循环 请使用实现中已有 timeout 参数;取消后执行清理。

Source Demo to Async Demo Mapping

Source sync step Source API/protocol action Async implementation Preserved output/error meaning Residual blocking
源包示例 code/main.py code/main.py 或本文快速开始 保留实际构造与调用;异常语义以运行时代码为准 存在

超时、取消、并发与残余阻塞

任何 await 不会自动使底层 I2C/SPI/UART/Pin 操作变为非阻塞。取消时应停止后台任务并在 finally 释放资源;没有实现超时参数的 API 不应被假定具有超时。协议命令、帧界限、ACK、静默间隔及错误含义只以当前实现和源示例可证明的内容为准。

UART Concurrency Contract

Model: caller-owned Reader owner: 调用方协程;不得让多个协程同时读取同一 UART。 Frame and unsolicited-data policy: 仅按当前运行时已有帧解析规则处理;未定义的非请求数据不得静默丢弃。

Hardware Acceptance

Level Evidence Not covered
Link 未实测:仅完成静态代码与文档取证。 总线/网络连接、设备身份响应。
Basic function 未实测。 一次真实业务 API 成功及结果正确性。
Complete business flow 未实测。 端到端设备、对端、供电、时序和异常恢复。

注意事项

类别 说明
并发 同一硬件实例应由调用方串行化;UART 额外遵守其并发契约。
阻塞 不把短同步总线访问或严格时序脉冲描述为真正可中断。
验收 文档生成不等于硬件验证;接入真实设备后分别记录三层验收证据。

版本记录

版本号 日期 作者 修改说明
2.1.0-async.1 2026-09-17 leeqingshui 基于当前异步代码、来源包和许可证重新取证 README。

联系方式

请通过本仓库的 issue 或维护者渠道联系;包内元数据作者为:leeqingshui。

许可协议

许可证声明:MIT。以下为本包 LICENSE 的逐字内容:

MIT License

Copyright (c) 2026 FreakStudio

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
文件列表
Name Size Type
LICENSE 1.0KB File
README.md 50.2KB Doc
code/_gs_mcp1081_mcp1081_umodbus/__init__.py 1.1KB Main
code/_gs_mcp1081_mcp1081_umodbus/common.py 24.8KB Python
code/_gs_mcp1081_mcp1081_umodbus/const.py 7.4KB Python
code/_gs_mcp1081_mcp1081_umodbus/functions.py 22.4KB Python
code/_gs_mcp1081_mcp1081_umodbus/modbus.py 50.0KB Python
code/_gs_mcp1081_mcp1081_umodbus/serial.py 29.3KB Python
code/_gs_mcp1081_mcp1081_umodbus/tcp.py 26.4KB Python
code/_gs_mcp1081_mcp1081_umodbus/typing.py 14.5KB Python
code/_gs_mcp1081_mcp1081_umodbus/version.py 1.1KB Python
code/_gs_mcp1081_mer.py 903B Python
code/main.py 1.0KB Main
code/mcp1081_mer_async.py 11.4KB Python
code/mcp1081_modbus_rtu_async.py 3.0KB Python
examples/main_sync.py 3.3KB Python
package.json 1.5KB Conf