原创 Air780E软件指南：C语言内存数组(zbuff)，技术工程师必看！

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

此核心板的详细使用说明参考：
https://docs.openluat.com/air780e/product/

Air780E产品手册中的<<开发板Core_Air780E使用说明V1.0.5.pdf>>，X.X.X指版本号；核心板使用过程中遇到任何问题，可以直接参考这份使用说明pdf文档。

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

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

typec接口USB数据线即可。

WINDOWS系统。

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

5、ZBUFF操作软硬件资料

780E模块使用固件：SDK&Demo-文档中心，本demo使用的固件版本是：

LuatOS-SoC_V1112_EC618_FULL.soc

本教程使用的demo：

https://gitee.com/openLuat/LuatOS-Air780E/tree/master/demo/zbuff

将固件和脚本烧录到模块中：Luatools下载和使用教程-模组资料中心

源码和固件已打包，如下所示：点我,下载完整压缩文件包

zbuff-全部api地址，如果只看本demo的api直接看下面的5.2demo使用api介绍即可。

作用：创建zbuff。

参数

返回值

作用：zbuff写数据（从当前指针位置开始；执行后指针会向后移动）。

参数

返回值

作用：zbuff读数据（从当前指针位置开始；执行后指针会向后移动）

参数

返回值

作用：zbuff清空数据（与当前指针位置无关；执行后指针位置不变）

参数

返回值

无

作用：zbuff设置光标位置（可能与当前指针位置有关；执行后指针会被设置到指定位置）

参数

返回值

作用：将一系列数据按照格式字符转化，并写入（从当前指针位置开始；执行后指针会向后移动）

参数

返回值

例子：

作用：将一系列数据按照格式字符读取出来（从当前指针位置开始；执行后指针会向后移动）

参数

返回值

作用：读取一个指定类型的数据（从当前指针位置开始；执行后指针会向后移动）

参数

类型可为：（前缀I指有符号位，U指无符号位，后面的数字指有几位）I8、U8、I16、U16、I32、U32、I64、U64。

（浮点数）F32、F64

返回值

例如:

作用：写入一个指定类型的数据（从当前指针位置开始；执行后指针会向后移动）

参数

写入类型，可为：（前缀I指有符号位，U指无符号位，后面的数字指有几位）I8、U8、I16、U16、I32、U32、I64、U64。

（浮点数）F32、F64

返回值

例如:

locallen=buff:writeI8(10)locallen=buff:writeU32(1024)

作用：获取zbuff对象的长度（与当前指针位置无关；执行后指针位置不变）

参数

无

返回值

作用：获取zbuff中最后一个数据位置指针到首地址的偏移量，表示zbuff内已有有效数据量大小。注意，此值不同于分配的空间大小，seek()会改变最后一个数据位置指针，也会影响used()的返回值。

参数

无

返回值

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

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

6.1.6 取出指定区间的数据

测试zbuff的使用

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

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