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 文档和工具:
- Air201模组使用固件:LuatOS 固件版本下载地址本 demo 使用的固件版本是:LuatOS-SoC_V2002_Air201.soc
- 本教程使用的 demo:https://gitee.com/openLuat/LuatOS-Air201/tree/master/demo/zbuff
- 将固件和脚本烧录到模块中:Luatools 下载和使用教程 - 合宙模组资料中心
- 源码和固件已打包,如下所示: 点我,下载完整压缩文件包
- zbuff-api地址
六、代码示例介绍
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()读取数据。