Air8000-LuatOS exvib扩展库全流程操作手册：实战经验全分享

news/2025/11/1 20:09:24/文章来源:https://www.cnblogs.com/luatos/p/19183784

面对复杂的振动监测需求，Air8000-LuatOS的exvib扩展库提供了高效解决方案。本文基于实战经验，全面梳理从初始化到数据输出的全流程操作，包括依赖安装、参数调优和性能测试，为开发者提供一份即学即用的实操手册。

一、GSENSOR 概述

gsensor 即 G-sensor，重力传感器，又名加速度传感器。Air8000 使用的 G-sensor 传感器型号是 da221。

da221 传感器是一种低功耗、高性能的电容式三轴线性加速度计，采用微机械技术开发。该器件采用 2x2x1.1 mm 的 LGA 封装，保证在 -40°C 至 +85°C 的宽温度范围内工作。传感器元件采用单晶硅通过 DRIE 工艺制造，并通过密封的硅帽保护免受环境影响。该器件具有用户可选的 ±2g/±4g/±8g 满量程测量范围，数据输出速率从 1Hz 到 1 kHz，并集成了信号调节和主动检测功能。da221 具有断电模式，非常适合手机电源管理。一个独立且灵活的中断大大简化了各种运动状态检测的算法。

二、演示功能概述

使用 Air8000 开发板，本示例主要是展示 exvib 库的使用，提供了三种场景应用：

1，微小震动检测：用于检测轻微震动的场景，例如用手敲击桌面；加速度量程 2g；

2，运动检测：用于电动车或汽车行驶时的检测和人行走和跑步时的检测；加速度量程 4g；

3，跌倒检测：用于人或物体瞬间跌倒时的检测；加速度量程 8g；

在震动检测方面提供了两种模式，有效震动模式和持续震动检测模式：

持续震动检测模式：震动强度超过设定阈值时，会进入中断处理函数，获取 xyz 三轴的数据

有效震动模式：当 10 秒内触发 5 次震动强度超过设定阈值时，持续触发震动事件，并执行相应的处理函数，30 分钟内只能触发一次，直到 30 分钟之后，再重新开始检测

三、准备硬件环境

本篇教程用 Air8000 开发板来开发调试。大家准备好硬件环境。

四、准备软件环境

烧录工具 Luatools；
内核固件文件（底层 core 固件文件）：LuatOS-SoC_V2014_Air8000；此页面有新版本固件的话选用最新版本固件，本次操作用的是 101 号固件，可以根据自己的需求选择自己需要的固件。
LuatOS 需要的脚本和资源文件：https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/demo/gsensor/vibration
lib 脚本文件：使用 Luatools 烧录时，勾选添加默认 lib 选项，使用默认 lib 脚本文件,如果没有下载最新的 lib，可以在 luatos 库里面下载最新的 lib 使用：https://gitee.com/openLuat/LuatOS/tree/master/script/libs；

准备好软件环境之后，接下来查看如何烧录项目文件到 Air8000 开发板中，将本篇文章中演示使用的项目文件烧录到 Air8000 开发板中。（https://docs.openluat.com/air8000/common/Luatools/）

五、软硬件参考

5.1 API 接口介绍

本教程使用 api 接口为:

https://docs.openluat.com/osapi/ext/exvib/

六、代码示例介绍

6.1 代码讲解

main.lua

主要是加载 vibration 模块

vibration.lua

加载了 exvib 库，开启 task 协程，调用 exvib.open(1)接口开启振动监测模式 1:微小震动检测，设置 gpio.WAKEUP2 防抖 100ms，防抖的作用是 100ms 只能触发一次，防止误触，然后设置中断模式触发，关于触发方式我们提供了两种场景的应用：

第一种场景是持续震动场景：只要检测到震动就会一直触发

第二种场景是有效震动场景：在 10 秒内检测到 5 次震动则判定为有效震动，有效震动触发之后，30 分钟之后才能再次触发，有效震动的逻辑大概是用循环定时器的方式每秒都把 tick 值 +1，然后每次触发震动则记录 tick 值到表里面，然后对表里面的最后一次触发的 tick 和第一次触发的 tick 进行对比，如果小于 10 并且第五次的值为有效值就判定为有效震动，也可以改动成自己项目的有效震动逻辑。