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')

results matching ""

    No results matching ""