ESP32 常用的模块 uctypes 3.1.14

uctypes模块用来访问二进制数据结构，该模块为MicroPython实现“外部数据接口”。

宏

• uctypes.LITTLE_ENDIAN — 小端压缩结构。
• uctypes.BIG_ENDIAN — 大端压缩结构类型。

构造函数

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'

函数

1. uctypes.sizeof(struct)

函数说明：按字节返回数据的大小。参数可以是类或者数据对象 (或集合)。
示例：

>>> a = b"0123"
>>>b = uctypes.struct(uctypes.addressof(a), {"a": uctypes.UINT8 | 0, "b": uctypes.UINT16 | 1}, uctypes.LITTLE_ENDIAN)
>>> b.a
48
>>> print(uctypes.sizeof(b))
3

2. uctypes.addressof(obj)

函数说明：返回对象地址。参数需要是 bytes, bytearray 。
示例：

>>> a = b"0123"
>>> print(uctypes.addressof(a))
1073504048

3. uctypes.bytes_at(addr, size)

函数说明：捕捉从 addr 开始到 size 个地址偏移量结束的内存数据为 bytearray 对象并返回。
示例：

>>> a = b"0123"
>>>print( uctypes.bytes_at(uctypes.addressof(a), 4))
b'0123'

4. uctypes.bytearray_at(addr, size)

函数说明：捕捉给定大小和地址内存为 bytearray 对象。与bytes_at()函数不同的是，它可以被再次写入，可以访问给定地址的参数。
示例：

>>> a = b"0123"
>>> print(uctypes.bytearray_at(uctypes.addressof(a), 2))
bytearray(b'01')