本文自笔者博客: https://www.blog.zeeland.cn/archives/rgoihgxcoci3

我的项目地址: https://github.com/Undertone0809/cushy-serial/

简介

cushy-serial是一个轻量级的Serial框架，初衷是心愿使Serial编程变得更加简略、快捷，因而，相较于传统的pyserial，该框架能够更加疾速地构建起一个serial程序。

次要个性

  • 兼容pyserial的所有个性
  • 自定义serial音讯异步回调，无需破费精力在多线程上
  • 提供串口定时工作
  • 不便实现和治理多个serial连贯
  • 可自定义音讯协定，兼容性强

疾速上手

pip install cushy-serial --upgrade

  • 上面是一个简略的serial程序，当python客户端接管到来自串口的信息时会主动回调

    from cushy_serial import CushySerialserial = CushySerial("COM1", 9600)serial.send("I am python client")@serial.on_message()def handle_serial_message(msg: bytes):  str_msg = msg.decode("utf-8")  print(f"[serial] rec msg: {str_msg}")
须要阐明的是，CushySerial兼容了Serial中所有的性能，因而，你能够在CushySerial中应用Serial的所有性能。
  • 运行后果如下

<img src="https://zeeland-bucket.oss-cn-beijing.aliyuncs.com/images/20230310173226.png"/>

  • 如果你想要执行定时工作，CushySerial也提供了相干的解决方案，你能够不便的轮询发送指令，并获取来自串口的信息，示例如下：
from cushy_serial import CushySerial, enable_logenable_log()serial = CushySerial("COM1", 9600)instruction = bytes([0x01, 0x06, 0x00, 0x7F, 0x00, 0x01, 0x79, 0xD2])# msg为你要轮询发送的指令，interval为轮询的工夫距离，times为执行次数，可不填写@serial.polling_task(msg=instruction, interval=0.5, times=5)def handle_rec_msg(rec_msg):    print(f"[serial] rec polling message: {rec_msg}")

待办

  • [ ] 提供polling_task的函数回调版本
  • [ ] 提供bytes包解析性能，缩小在包解析上所破费的工作
  • [ ] 提供相干长久化解决方案
  • [ ] 提供数据流监控，进步数据稳定性
  • [ ] 提供更加细力度的数据包调控，升高丢包率
  • [x] 提供串口定时任务调度
  • [ ] 欠缺单元测试

奉献

如果你想为这个我的项目做奉献，你能够提交pr或issue。我很快乐看到更多的人参加并优化它。