跳转至

C语言内存数组(zbuff)

一、ZBUFF(C 内存数组)简介

zbuff 库可以用 c 风格直接操作(下标从 0 开始),例如 buff[0] = buff[3]

可以在 sram 上或者 psram 上申请空间,也可以自动申请(如存在 psram 则在 psram 进行申请,如不存在或失败则在 sram 进行申请)。

操作里面的元素时,可以根据 光标进行增删改查。偏移方式有三种:从头、当前位置、末尾开始。常用参数如下:

常量 类型 解释
zbuff.SEEK_SET number 以头为基点
zbuff.SEEK_CUR number 以当前位置为基点
zbuff.SEEK_END number 以末尾为基点
zbuff.HEAP_AUTO number 自动申请(如存在 psram 则在 psram 进行申请,如不存在或失败则在 sram 进行申请)
zbuff.HEAP_SRAM number 在 sram 申请
zbuff.HEAP_PSRAM number 在 psram 申请

二、演示功能概述

本 demo 将演示 ZBUFF 的创建、写入数据、读取数据、获取 zbuff 长度、获取光标位置。

三、准备硬件环境

3.1 Air201模组,包括天线、USB 数据线

使用 Air201模组,如下图所示:

点击链接购买:合宙Air201模组淘宝购买链接

此模组的详细使用说明参考:Air201 产品手册

3.2 SIM 卡

请准备一张可正常上网的 SIM 卡,该卡可以是物联网卡或您的个人手机卡。

特别提醒:请确保 SIM 卡未欠费且网络功能正常,以便顺利进行后续操作。

3.3 数据通信线

typec 接口 USB 数据线即可。

3.4 PC 电脑

WIN10以及以上版本的WINDOWS系统。

四、准备软件环境

4.1 基本的下载调试工具

使用说明参考:Luatools 下载和详细使用

五、ZBUFF 操作软硬件资料

5.1 文档和工具:

六、代码示例介绍

6.1 zbuff 操作示例

6.1.1 创建 zbuff,以 c 语言数组的形式操作 zbuff

local buff = zbuff.create(1024)
    -- 可当成数组直接赋值和取值
    buff[0] = 0xAE
    log.info("zbuff", "buff[0]", buff[0])

6.1.2 以 io 的形式操作

-- 写数据write, 操作之后指针会移动,跟文件句柄一样
    buff:write("123") -- 字符串
    buff:write(0x12, 0x13, 0x13, 0x33) -- 直接写数值也可以

    -- 设置指针位置, seek
    buff:seek(5, zbuff.SEEK_CUR) -- 指针位置+5
    -- 指针位置设置为0
    buff:seek(0)                 -- 绝对地址

    -- 读数据read, 指针也会移动
    -- 读取前三个字节,即"123"
    local data = buff:read(3)
    log.info("zbuff", "data", data)

6.1.3 清除 zbuff

-- 清除全部数据,但指针位置不变
    buff:clear() -- 默认填0
    buff:clear(0xA5) -- 也可以指定填充的内容

6.1.4 以 pack 库的形式写入或读取数据

-- 支持以pack库的形式写入或读取数据
    buff:seek(0)
    buff:pack(">IIHA", 0x1234, 0x4567, 0x12,"abcdefg")
    buff:seek(0)
    local cnt,a,b,c,s = buff:unpack(">IIHA10")

6.1.5 按类型读写数据

读取类型可为:I8、U8、I16、U16、I32、U32、I64、U64、F32、F64

读取的时候,记得注意下标位置。

-- 也可以直接按类型读写数据
    local len = buff:writeI8(10)
    local len = buff:writeU32(1024)
    local i8data = buff:readI8()
    local u32data = buff:readU32()

6.1.6 取出指定区间的数据

-- 取出指定区间的数据
    local fz = buff:toStr(0,5)

6.1.7 获取创建的 zbuff 的长度,和指针当前位置

-- 获取其长度
    log.info("zbuff", "len", buff:len())
    -- 获取其指针位置
    log.info("zbuff", "len", buff:used())

6.1.8 测试 F32(32 位单精度浮点数)类型数据的读写

-- 测试writeF32, 注意, EC618系列(Air780E等), V1106会死机, 在V1107修复
    buff:seek(0, zbuff.SEEK_SET)
    buff:writeF32(1.2)
    buff:seek(0, zbuff.SEEK_SET)
    log.info("buff", "rw", "f32", buff:readF32())

七、功能验证

测试 zbuff 的使用

八、总结

本示例介绍了 zbuff 的作用和用法。

扩展

常见问题

1、先 buff:write(0x12),再设置光标到正确位置后,使用 buff:read(1)读取不到数据。

直接读取是不可见字符,要使用 buff:read(1):toHex()读取数据。