uctypes - 以结构化方式访问二进制数据

2023-11-01

该模块为MicroPython实现“外部数据接口”。它背后的想法类似于CPython的 ctypes 模块，但实际的API是不同的，
简化并针对小尺寸进行了优化。该模块的基本思想是定义具有与C语言允许的功能大致相同的数据的数据结构布局，
然后使用熟悉的点语法访问它以引用子字段。

构建对象

class uctypes.struct(addr, descriptor, type)

将内存中以c形式打包的结构体或联合体转换为字典，并返回该字典。

  • addr:开始转换的地址

  • descriptor:转换描述符

    • 格式: "field_name":offset|uctypes.UINT32
    • offset：偏移量，单位：字节, VOID、UINT8、INT8、UINT16、INT16、UINT32、INT32、UINT64、INT64、BFUINT8、BFINT8、BFUINT16、BFINT16、BFUINT32、BFINT32、BF_POS、BF_LEN、FLOAT32、FLOAT64、PTR、ARRAY

  • type:c结构体或联合体存储类型，默认为本地存储类型

    • NATIVE:MricoPython本地的存储类型
    • LITTLE_ENDIAN:小端存储
    • BIG_ENDIAN:大端存储

示例:

  #如果需要C文件中的结构体，需要使用VC或者VS生成.dll（windows）或.os（linux、mac）文件，然后下载进入MCU中，使用MCU打开此文件，获取结构体或联合体
  >>> a = b"0123"
  >>> s = uctypes.struct(uctypes.addressof(a), {"a": uctypes.UINT8 | 0, "b": uctypes.UINT16 | 1}, uctypes.LITTLE_ENDIAN)
  >>> print(s)
  <struct STRUCT 3ffc7360>
  >>> print(s.a)
  48
  >>> s.a = 49
  >>> print(a)
  b'1123'