SQLite3 数据库操作示例

📁 源码位置: samples/libraries/sqlite3 查看源码

功能说明

演示如何在 ARCS SDK 环境中使用 SQLite3 数据库进行基本操作，包括数据库打开、加密查询以及与 LSFS 文件系统集成。

硬件连接

  • SDMMC0 接口：连接 eMMC/SD 卡，用于存储数据库文件

示例内容

  1. 初始化 SD 卡和 LSFS 文件系统

  2. 挂载 FAT 文件系统到 /SD: 挂载点

  3. 遍历根目录并列出数据库文件

  4. 打开加密数据库文件

  5. 执行 SQL 全文搜索查询并输出结果

  6. 关闭数据库并卸载文件系统

编译

重要提示：在编译前，请先确认您使用的开发板型号。SDK 目前支持以下开发板：

  • arcs_evb - ARCS EVB 评估板

  • arcs_mini - ARCS Mini 开发板

根据您的开发板型号，选择对应的编译命令：

在示例目录下执行编译:

# 使用 arcs_evb 开发板
./build.sh -C -DBOARD=arcs_evb

# 或使用 arcs_mini 开发板
./build.sh -C -DBOARD=arcs_mini

Note

如果在 SDK 根目录执行，需要指定示例路径:

# 使用 arcs_evb 开发板
./build.sh -C -S samples/<示例路径> -DBOARD=arcs_evb

# 或使用 arcs_mini 开发板
./build.sh -C -S samples/<示例路径> -DBOARD=arcs_mini

Note

确保已安装对应的工具链。

烧录

编译完成后，使用 SDK tools 目录下的 cskburn 工具烧录固件:

./tools/burn/cskburn -s /dev/ttyUSB0 -b 3000000 0x0 build/arcs.bin -C arcs

Note

烧录参数说明：

  • -s /dev/ttyUSB0：串口设备路径，需要根据实际情况修改 - Linux 系统：通常是 /dev/ttyUSB0 或 /dev/ttyACM0 - 可通过 ls /dev/tty* 命令查看可用串口设备 - 不同开发板或 USB 转串口芯片可能使用不同的设备名

  • -b 3000000：烧录波特率（3Mbps）

  • 0x0：烧录起始地址

  • build/arcs.bin：编译生成的固件路径

  • -C arcs：芯片类型

注意事项：

  • 确保开发板已正确连接到电脑

  • 如果无法识别串口设备，请检查 USB 连接线是否正常，或尝试其他 USB 端口

预期输出

SQLITE sample
/SD: mounted successfully
/SD:/ opendir: 0
25747456 test.db
26009600 test_csk_enc.db
25747456 test_wx_enc.db
0 dirs, 3 files.
Callback function called

SDK: WX_SQLITE3
DB: /SD:/test_wx_enc.db
SQL: select docid,type,audio_type,word_text from v_word WHERE word_text MATCH '小*时*不*识*月*，*呼*作*白*玉*盘*。'
+------------+---------+
| Operation  | Time(ms)  |
+------------+---------+
| Open      |    2    |
| Key       |  115    |
| Query     |  216    |
+------------+---------+
/SD: unmount success!

核心 API

API

说明

sqlite3_open()

打开或创建 SQLite 数据库

sqlite3_key()

设置数据库加密密钥

sqlite3_exec()

执行 SQL 语句

sqlite3_close()

关闭数据库

lsfs_mount()

挂载文件系统

lsfs_unmount()

卸载文件系统

关键代码

/* 挂载文件系统 */
lsfs_mount(&sdmmc_lsfs_mnt);

/* 打开加密数据库 */
sqlite3 *db;
sqlite3_open("/SD:/test_wx_enc.db", &db);
sqlite3_key(db, key, key_len);

/* 执行查询 */
sqlite3_exec(db, sql, callback, NULL, &err_msg);

/* 关闭数据库 */
sqlite3_close(db);
lsfs_unmount(&sdmmc_lsfs_mnt);

注意事项

  1. 文件系统镜像: 运行前需将包含数据库文件的 fatfs_db.bin 镜像烧录到 eMMC

  2. 烧录顺序: 先烧录文件系统镜像到 eMMC，再烧录应用固件到 Flash

  3. 加密支持: 数据库加密功能需要对应的加密模块支持，密钥需与数据库创建时一致

  4. 内存需求: SQLite3 运行需要较多内存，确保堆空间配置足够

  5. 文件路径: 数据库文件路径必须包含挂载点前缀，如 /SD:/test.db