init: Air780EPM 官方 LuatOS 项目代码基线

- 来源: 合宙 LuatOS 官方仓库 air780epm 模块完整代码 - 路径: luatos/air780epm/module/Air780EPM/demo 含官方 demo(含 mqtt/mqtts/socket/uart 等) - 后续: 基于 demo 开发 UART<->MQTT 数据上报功能
2026-08-31 08:53:49 +08:00
commit 173dd6874f
813 changed files with 125484 additions and 0 deletions
@@ -0,0 +1,160 @@
+# string_DEMO 项目说明
+
+## 项目概述
+
+本项目演示了LuatOS的string核心库的使用，string核心库提供了丰富的字符串处理功能，包括编码转换、字符串分割、格式处理等。
+## 功能说明
+
+本demo通过多个示例演示string核心库的主要功能：
+
+    十六进制编码/解码：演示字符串与十六进制格式的互相转换
+
+    字符串分割处理：演示使用不同分隔符进行字符串分割
+
+    数值转换操作：演示字符串到二进制数据的转换
+
+    Base64编码解码：演示Base64编码和解码功能
+
+    Base32编码解码：演示Base32编码和解码功能
+
+    字符串前后缀判断：演示字符串前缀和后缀判断功能
+
+    字符串裁剪处理：演示去除字符串前后空白字符的功能
+
+## 演示硬件环境
+
+1、Air780EPM开发板
+ 
+![alt text]( https://docs.openLuat.com/cdn/image/Air780EPM开发板.jpg)
+
+2、TYPE-C USB数据线一根
+- Air780EPM开发板通过 TYPE-C USB 口供电；
+- TYPE-C USB 数据线直接插到核心板的 TYPE-C USB 座子，另外一端连接电脑 USB 口；
+
+
+## 演示软件环境
+
+1、Luatools下载调试工具 [https://docs.openluat.com/air780epm/common/Luatools/]
+
+2、固件版本LuatOS-SoC_V2016_Air780EPM 版本固件。不同版本区别请见 https://docs.openluat.com/air780epm/luatos/firmware/version/
+
+3、lib 脚本文件：使用 Luatools 烧录时，勾选 添加默认 lib 选项，使用默认 lib 脚本文件；
+
+4、准备好软件环境之后，接下来查看[如何烧录项目文件到 Air780EPM开发板中](https://docs.openluat.com/air780epm/luatos/common/download/)将本篇文章中演示使用的项目文件烧录到相应的核心板中。
+
+
+## 相关软件资料
+
+string 核心库文档：https://docs.openluat.com/osapi/core/string/
+
+## 演示核心步骤
+
+1、搭建好硬件环境
+
+2、Luatools烧录内核固件和demo脚本代码
+
+3、烧录成功后，自动开机运行
+
+4、在日志中查看演示结果
+
+``` lua
+ I/user.string_demo 字符串操作演示模块初始化
+ I/user.string_demo 开始执行所有字符串操作演示
+```
+
+本demo包含6个主要功能，运行后会在日志中输出每一步的结果：
+
+- 十六进制转换示例
+
+  演示字符串与十六进制格式的互相转换
+
+  ``` lua
+  I/user.=== 十六进制转换示例 ===
+  I/user.toHex 原始字符串: 123abc HEX结果: 313233616263 长度: 12
+  I/user.toHex 带空格分隔: 31 32 33 61 62 63 
+  I/user.fromHex HEX字符串解码: 123abc
+  I/user.toHex 二进制数据转HEX: 0102030405
+   ```
+
+- 字符串分割示例
+
+  演示使用不同分隔符进行字符串分割
+
+  ``` lua
+  I/user.=== 字符串分割示例 ===
+  I/user.split CSV分割结果: 3 ["123","456","789"]
+  I/user.split IP地址分割: 1 ["192.168.1.1"]
+  I/user.split 多字符分隔符: 4 ["a","b","c","d"]
+  I/user.split 路径分割: 4 ["usr","local","bin","lua"]
+  ```
+
+- 实数值转换示例
+
+  演示字符串到二进制数据的转换
+  
+  ``` lua
+  I/user.=== 数值转换示例 ===
+  I/user.toValue 原始字符串: 123456 转换字符数: 6
+  I/user.toValue 二进制结果HEX: 010203040506 12
+  I/user.toValue 混合字符串转换: 123abc 字符数: 6
+  I/user.toValue 混合结果HEX: 0102030A0B0C 12
+  ```
+
+- Base64编码示例
+
+  演示Base64编码和解码功能    
+  ``` lua
+  I/user.=== Base64编码示例 ===
+  I/user.toBase64 原文: Hello LuaOS! 编码后: SGVsbG8gTHVhT1Mh
+  I/user.fromBase64 解码结果: Hello LuaOS!
+  I/user.toBase64 中文原文: 你好世界 编码后: 5L2g5aW95LiW55WM
+  I/user.fromBase64 中文解码: 你好世界
+  ```
+
+- Base32编码示例
+  演示Base32编码和解码功能
+  ``` lua
+  I/user.=== Base32编码解码示例 ===
+  I/user.toBase32 原文: Hello World 编码后: JBSWY3DPEBLW64TMMQ======
+  I/user.fromBase32 解码结果: Hello World
+  I/user.toBase32 短字符串编码: test => ORSXG5A=
+  I/user.fromBase32 短字符串解码: test
+  I/user.toBase32 中文原文: 你好世界 编码后: 4S62BZNFXUYQKIIUHU4Q====
+  I/user.fromBase32 中文解码: 你好世界
+  I/user.toBase32 二进制数据HEX: 0102030405 Base32: AEBAGBAFAYDQ====
+  I/user.toBase32 空字符串编码:'' => 
+  I/user.fromBase32 空字符串解码: ''
+  ```
+
+- 字符串判断示例
+
+  演示字符串前缀和后缀判断功能
+
+  ``` lua
+  I/user.=== 字符串判断示例 ===
+  I/user.startsWith 字符串: hello world
+  I/user.startsWith 以'hello'开头: true
+  I/user.startsWith 以'world'开头: false
+  I/user.endsWith 以'world'结尾: true
+  I/user.endsWith 以'hello'结尾: false
+  ```
+
+- 字符串裁剪示例
+
+  演示去除字符串前后空白字符的功能
+
+  ``` lua
+  I/user.=== 字符串裁剪示例 ===
+  I/user.trim 原始字符串长度: 23
+  I/user.trim 裁剪后字符串: 'hello world' 长度: 11
+  I/user.trim 用户输入清理: '   admin   ' => 'admin'
+  ```
+
+
+
+## 注意事项
+
+本demo仅用于演示string核心库的基本用法，更多高级用法请参考[string核心库](https://docs.openluat.com/osapi/core/string/)文档。
+
+在实际使用中，请根据具体需求选择合适的字符串处理函数，注意不同函数对输入数据的要求和边界情况处理。
+