STM32C5开发LSM6DSV320X(3)----配置单击与双击检测

记帖2026-10-13 19:37

STM32C5开发LSM6DSV320X .2--配置单击与双击检测

.2--配置单击与双击检测)

概述

本章介绍如何使用 STM32C542CCT6 驱动 LSM6DSV320X 实现单击（Single Tap）和双击（Double Tap）检测。LSM6DSV320X 内置硬件 Tap 检测功能，可通过低 G 加速度计对敲击动作进行识别，并支持将单击、双击事件映射到 INT1/INT2 中断引脚。

需要样片的可以加qun申请：925643491 / 615061293 。

视频教学

https://www.bilibili.com/video/BV1JLHi6sEBX

样品申请

https://www.wjx.top/vm/OhcKxJk.aspx#

源码下载

https://download.csdn.net/download/qq_24312945/93681044

硬件准备

首先需要准备一个开发板，这里我准备的是自己绘制的开发板，需要的可以进行申请。

主控为STM32C542CC，陀螺仪为LSM6DV320X，磁力计为LIS2MDL。

参考程序

https://github.com/CoreMaker-lab/STM32C542_LSM6DSV320X_LIS2MDL

https://gitee.com/CoreMaker/STM32C542_LSM6DSV320X_LIS2MDL

串口配置

查看原理图，PA9和PA10设置为开发板的串口。

  1. 在左侧 Peripherals 中选择 Connectivity → USART1
  2. Mode 选择 Async，表示配置为异步串口模式
  3. Function used by the component 显示为 UART，说明 USART1 在异步模式下使用 UART HAL 驱动
  4. 串口参数配置为：115200 波特率、8 位数据位、无校验、1 位停止位、收发模式
  1. GPIO Tx：USART1_TX 选择 PA9
  2. GPIO Rx：USART1_RX 选择 PA10
  3. PA9 / PA10 均配置为 Alternate 复用功能模式
  4. Pull 选择 No pull-up and no pull-down，Output type 选择 Push pull，Speed 选择 Low

IIC配置

STM32C542CCT6通过扩展接口与传感器模块连接，其中PB6作为I²C时钟线SCL，PB7作为I²C数据线SDA

首先在 STM32CubeMX2 中进入 Peripherals 外设配置页面，在 Connectivity 分类中选择 I2C1，并将 I2C1 外设使能。

如图所示，本实验的 I2C1 配置步骤如下：

  1. 点击左侧 Peripherals 外设配置入口
  2. 在 Connectivity 分类中选择 I2C1
  3. 将 I2C1 Mode 设置为 I2C，并确认 I2C1 显示为 Active
  4. Speed frequency 设置为 Fast mode - 400 kHz
  5. 确认 I2C1 的 GPIO 引脚映射，SCL 为 PB6，SDA 为 PB7

CS和SA0设置

确认I2C 模式选择和地址选择：

CS 需要处于 I2C 模式对应电平

SA0 需要固定为高电平或低电平

将 PA1 和 PB2 配置为普通 GPIO。

在 STM32CubeMX2 的 Pinout 页面中，将 PA1 和 PB2 配置为普通 GPIO。

SA0：用于选择 LSM6DSR 的 I2C 地址

CS：用于选择 LSM6DSR 的通信接口模式

在右侧 Pin signals 中，将对应引脚设置为 GPIO → Configured，表示该引脚将作为普通 GPIO 使用，由用户程序控制输出高低电平。

进入 System → GPIO 配置页面，可以看到 PA1 和 PB2 已经被加入 GPIO 配置列表。

本实验中将 PB2 作为 CS 控制脚 , 将 PA1 作为 SA0 控制脚 。

由于还有一个磁力计，需要把该CS也使能。

在 STM32CubeMX2 的 Pinout 页面中，将 PA6配置为普通 GPIO。

进入 System → GPIO 配置页面， PA6 作为 CS2 控制脚 。

INT设置

硬件连接中，IMU 的 INT1（Pin4）连接至 MCU 的 PB0，用于触发陀螺仪数据更新中断。

在 Pinout 页面中，将 PB2 配置为 GPIO 输入，并开启 EXTI 功能。

在 GPIO 配置页面中，PB0 对应 EXTI2 中断线，触发方式选择 Falling edge。

开启 EXTI0 Interrupt，并生成 IRQ Handler。

生成项目

  1. 修改配置后，左下角会提示 Click to save，需要先保存当前工程配置
  2. 点击左侧 Project settings，进入工程生成设置页面
  3. 在 IDE Project Generation 中选择工程格式和工具链，本例选择 CMake + GCC，然后点击 Generate IDE project 生成工程

导入STM32CubeIDE

  1. 打开 STM32CubeIDE，点击菜单栏 File
  2. 选择 Import...，准备导入 STM32CubeMX2 生成的 CMake 工程
  1. 在 Import 窗口中展开 Import STM32 Project
  2. 选择 STM32 CMake Project
  3. 点击 Next，进入 CMake 工程路径选择页面
  1. Project name：填写导入到 STM32CubeIDE 中显示的工程名称
  2. Source directory：选择 STM32CubeMX2 生成的 CMake 工程目录
  3. 点击 Next，继续完成工程导入
  1. Toolchain：选择 MCU ARM GCC，表示使用 ARM GCC 工具链进行编译
  2. MCU：确认芯片型号为 STM32C542CCTx，与前面 STM32CubeMX2 中选择的 MCU 保持一致
  3. CPU/Core：确认内核为 Cortex-M33，Core 为 0
  4. 点击 Finish，完成 CMake 工程导入

设置工程编码

  1. 在 Project Explorer 中选中当前工程
  2. 点击菜单栏 Project
  3. 选择 Properties，进入工程属性设置
  1. 在工程属性中选择 Resource
  2. Text file encoding 选择 Other
  3. 编码格式输入 GBK
  4. 点击 Apply and Close 保存设置

添加头文件

在 main.c 中添加头文件

c 复制代码 
#include "mx_usart1.h"
#include <stdio.h>
#include <string.h>

printf 重定向

为了让 printf() 输出到 USART1，需要重写 _write() 函数。GCC 工程中，printf() 底层会调用 _write() 输出字符，因此只需要在 _write() 中调用 HAL_UART_Transmit()，就可以把 printf() 的内容通过串口发送出去。

c 复制代码 
int _write(int file, char *ptr, int len)
{
    hal_uart_handle_t *huart1 = mx_usart1_uart_gethandle();

    if (huart1 != NULL)
    {
        HAL_UART_Transmit(huart1, ptr, len, 1000);
    }

    return len;
}

参考程序

https://github.com/STMicroelectronics/lsm6dsv320x-pid

添加对应驱动程序。

CMake设置

把lsm6dsv320x_reg.c 加入 CMake 编译 。

c 复制代码 
# Stubs to be able to add compiler flag overrides, e.g. -Os
target_sources(${CMAKE_PROJECT_NAME} PRIVATE
  # Add additional source files here
  lsm6dsv320x_reg.c
)

printf 输出浮点数需要额外开启 float printf 支持。

CMake 官方说明 target_link_options() 就是给可执行目标添加 linker options 的命令。

c 复制代码 
target_link_options(${CMAKE_PROJECT_NAME} PUBLIC
  # Add additional linker flags here
  -u _printf_float
)

头文件设置

添加头文件。

c 复制代码 
#include "lsm6dsv320x_reg.h"

初始换管脚

由于需要向LSM6DSV320X_I2C_ADD_L写入以及为IIC模式。

所以使能CS为高电平，配置为IIC模式。

配置SA0为低电平。

c 复制代码 
	  printf("HELLO\n");
	  HAL_GPIO_WritePin(CS1_PORT, CS1_PIN, HAL_GPIO_PIN_SET);
	  HAL_GPIO_WritePin(SA0_PORT, SA0_PIN, HAL_GPIO_PIN_RESET);
	  HAL_GPIO_WritePin(CS2_PORT, CS2_PIN, HAL_GPIO_PIN_SET);

定义变量

定义全局变量

c 复制代码 
/* Private macro -------------------------------------------------------------*/
#define BOOT_TIME 10 // ms

/* Private variables ---------------------------------------------------------*/
static uint8_t whoamI;

static int32_t platform_write(void *handle, uint8_t reg, const uint8_t *bufp,
                              uint16_t len);
static int32_t platform_read(void *handle, uint8_t reg, uint8_t *bufp,
                             uint16_t len);
static void platform_delay(uint32_t ms);

static volatile uint8_t thread_wake = 0;

static int32_t platform_write(void *handle, uint8_t reg, const uint8_t *bufp,
                              uint16_t len) {
  if (HAL_I2C_MASTER_MemWrite((hal_i2c_handle_t *)handle, LSM6DSV320X_I2C_ADD_L,
                              reg, HAL_I2C_MEM_ADDR_8BIT, bufp, len, 1000) != HAL_OK) {
    return -1;
  }
  return 0;
}

static int32_t platform_read(void *handle, uint8_t reg, uint8_t *bufp,
                             uint16_t len) {
  if (HAL_I2C_MASTER_MemRead((hal_i2c_handle_t *)handle, LSM6DSV320X_I2C_ADD_L,
                             reg, HAL_I2C_MEM_ADDR_8BIT, bufp, len, 1000) != HAL_OK) {
    return -1;
  }
  return 0;
}

static void platform_delay(uint32_t ms) {
  HAL_Delay(ms);
}

在main() 中定义Tap 相关结构体

c 复制代码 
stmdev_ctx_t dev_ctx;
lsm6dsv320x_tap_detection_t    tap     = {0};  /* fields: tap_x_en/tap_y_en/tap_z_en */
lsm6dsv320x_tap_thresholds_t   tap_ths = {0};  /* fields: x/y/z */
lsm6dsv320x_tap_time_windows_t tap_win = {0};  /* fields: shock/quiet/tap_gap */
lsm6dsv320x_pin_int_route_t    pin_int = {0};  /* fields: single_tap/double_tap/drdy_xl */
lsm6dsv320x_interrupt_mode_t   irq = {0};
lsm6dsv320x_if_cfg_t if_cfg = {0};

获取ID

我们可以向WHO_AM_I (0Fh)获取固定值，判断是否为0x73。

对应的获取ID驱动程序,如下所示。

c 复制代码 
/* Initialize mems driver interface */
dev_ctx.write_reg = platform_write;
dev_ctx.read_reg = platform_read;
dev_ctx.mdelay = platform_delay;
dev_ctx.handle = mx_i2c1_i2c_gethandle();

/* Init test platform */
// platform_init(dev_ctx.handle);

/* Wait sensor boot time */
platform_delay(BOOT_TIME);

/* Check device ID */
lsm6dsv320x_device_id_get(&dev_ctx, &whoamI);
printf("LSM6DSV320X_ID=0x%x,id=0x%x\n",LSM6DSV320X_ID,whoamI);
if (whoamI != LSM6DSV320X_ID)
	while (1);

复位传感器

该代码首先对 传感器进行软件复位。

c 复制代码 
/* Restore default configuration */
lsm6dsv320x_reset_set(&dev_ctx, LSM6DSV320X_RESTORE_CTRL_REGS);

BDU设置

在很多传感器中，数据通常被存储在输出寄存器中，这些寄存器分为两部分：MSB和LSB。这两部分共同表示一个完整的数据值。例如，在一个加速度计中，MSB和LSB可能共同表示一个加速度的测量值。

连续更新模式（BDU = '0'）：在默认模式下，输出寄存器的值会持续不断地被更新。这意味着在你读取MSB和LSB的时候，寄存器中的数据可能会因为新的测量数据而更新。这可能导致一个问题：当你读取MSB时，如果寄存器更新了，接下来读取的LSB可能就是新的测量值的一部分，而不是与MSB相对应的值。这样，你得到的就是一个"拼凑"的数据，它可能无法准确代表任何实际的测量时刻。

块数据更新（BDU）模式（BDU = '1'）：当激活BDU功能时，输出寄存器中的内容不会在读取MSB和LSB之间更新。这就意味着一旦开始读取数据（无论是先读MSB还是LSB），寄存器中的那一组数据就被"锁定"，直到两部分都被读取完毕。这样可以确保你读取的MSB和LSB是同一测量时刻的数据，避免了读取到代表不同采样时刻的数据。

简而言之，BDU位的作用是确保在读取数据时，输出寄存器的内容保持稳定，从而避免读取到拼凑或错误的数据。这对于需要高精度和稳定性的应用尤为重要。

可以向CTRL3_C(12h)的BDU寄存器写入1进行开启。

对应的驱动程序,如下所示。

c 复制代码 
/* Enable Block Data Update */
lsm6dsv320x_block_data_update_set(&dev_ctx, PROPERTY_ENABLE);

配置输出数据率与测量量程

该代码用于配置加速度计和陀螺仪的基本采样参数：

● 将加速度计的输出数据率设置为 480 Hz，每秒产生约 480 组新的传感器数据

● 将陀螺仪的输出数据率设置为15 Hz，每秒产生约 15 组新的传感器数据

● 将加速度计量程设置为 ±8 g。

● 将陀螺仪量程设置为 ±2000 dps。

对应程序如下所示。

c 复制代码 
/* Set Output Data Rate.
 * Selected data rate have to be equal or greater with respect
 * with MLC data rate.
*/
lsm6dsv320x_xl_data_rate_set(&dev_ctx, LSM6DSV320X_ODR_AT_480Hz);
lsm6dsv320x_gy_data_rate_set(&dev_ctx, LSM6DSV320X_ODR_AT_15Hz);

/* Set full scale */
lsm6dsv320x_xl_full_scale_set(&dev_ctx, LSM6DSV320X_8g);
lsm6dsv320x_gy_full_scale_set(&dev_ctx, LSM6DSV320X_2000dps);

外部中断回调函数

当 LSM6DSV320X 传感器 的 INT1 引脚产生中断信号后，MCU 进入 EXTI 中断处理流程，并调用 HAL_EXTI_TriggerCallback()。

c 复制代码 
void HAL_EXTI_TriggerCallback(hal_exti_handle_t *hexti,
                              hal_exti_trigger_t trigger)
{
    if (HAL_EXTI_GetInstance(hexti) == HAL_EXTI_GPIO_0)
    {
        thread_wake = 1;
    }
}

中断配置

对 LSM6DSV320X 的中断输出进行配置，将 INT1/INT2 设置为开漏输出并采用低电平有效方式，以配合硬件上的外部上拉电阻和 STM32 PB0 的下降沿外部中断。

c 复制代码 
/* INT1/INT2: open-drain + active low (matches external pull-up + PB0 falling edge) */
lsm6dsv320x_read_reg(&dev_ctx, LSM6DSV320X_IF_CFG, (uint8_t *)&if_cfg, 1);
if_cfg.pp_od     = 1;
if_cfg.h_lactive = 1;
lsm6dsv320x_write_reg(&dev_ctx, LSM6DSV320X_IF_CFG, (uint8_t *)&if_cfg, 1);

中断映射

程序首先只开启 Z 轴的敲击检测，并设置 Z 轴 Tap 阈值为 3；随后通过 shock、quiet 和 tap_gap 设置敲击持续时间、第一次敲击后的静默时间以及双击允许的最大时间间隔。之后将工作模式设置为 LSM6DSV16X_BOTH_SINGLE_DOUBLE，同时开启单击和双击识别，并通过 pin_int.single_tap 和 pin_int.double_tap 将两种事件映射到 INT1 引脚。

c 复制代码 
 /* Enable Z-axis Tap detection */
tap.tap_x_en = PROPERTY_DISABLE;
tap.tap_y_en = PROPERTY_DISABLE;
tap.tap_z_en = PROPERTY_ENABLE;
lsm6dsv320x_tap_detection_set(&dev_ctx, tap);

/* Set Tap threshold */
tap_ths.x = 0;
tap_ths.y = 0;
tap_ths.z = 3;
lsm6dsv320x_tap_thresholds_set(&dev_ctx, tap_ths);

/* Set Tap time windows */
tap_win.shock = 3;
tap_win.quiet = 3;
tap_win.tap_gap = 7;
lsm6dsv320x_tap_time_windows_set(&dev_ctx, tap_win);

/* Enable Single Tap and Double Tap */
lsm6dsv320x_tap_mode_set(&dev_ctx,
                               LSM6DSV320X_BOTH_SINGLE_DOUBLE);

/* Route Single Tap and Double Tap to INT1 */
pin_int.single_tap = PROPERTY_ENABLE;
pin_int.double_tap = PROPERTY_ENABLE;

/* enable interrupt on High-G XL (sensor at highest frequency) */
pin_int.drdy_xl = PROPERTY_DISABLE;
irq.enable = PROPERTY_ENABLE;
irq.lir    = 0;
lsm6dsv320x_interrupt_enable_set(&dev_ctx, irq);
lsm6dsv320x_pin_int1_route_set(&dev_ctx, &pin_int);

读取事件

当传感器的 INT1 产生中断后，HAL_EXTI_TriggerCallback() 会将 thread_wake 置 1；主循环检测到该标志后，调用 lsm6dsv16x_all_sources_get() 读取传感器当前的中断源状态，并根据 double_tap 和 single_tap 标志判断是双击还是单击事件，最后通过串口输出对应结果。

c 复制代码 
while (1) {

    if (thread_wake)
    {
      lsm6dsv320x_all_sources_t status = {0};

      thread_wake = 0;

      /* Read interrupt source */
      lsm6dsv320x_all_sources_get(&dev_ctx, &status);

      if (status.double_tap)
      {
        printf("Double Tap\r\n");
      }
      else if (status.single_tap)
      {
        printf("Single Tap\r\n");
      }
    }
  }

演示

单击和双击测试如下。

相关推荐
记帖1 天前
STM32C5开发LSM6DSV16X(4)----高级计步器、步数检测与步数计数
imu·陀螺仪·mems·lsm6dsv16x·stm32cubemx2·stm32c542cct6·高级计步器
记帖1 天前
STM32C5开发LSM6DS3TR-C(4)----高级计步器、步数检测与步数计数
imu·陀螺仪·mems·stm32cubemx2·stm32c542cct6·高级计步器·lsm6d3tr-c
记帖1 天前
STM32C5开发LSM6DSV80X(4)----高级计步器、步数检测与步数计数
imu·陀螺仪·mems·stm32cubemx2·stm32c542cct6·lsm6dsv80x·高级计步器
记帖1 天前
STM32C5开发LSM6DSR(4)----高级计步器、步数检测与步数计数
imu·陀螺仪·mems·stm32cubemx2·stm32c542cct6·高级计步器
记帖22 天前
STM32C5开发IIS3DWB10IS(2)----IIC获取震动计数据
stm32cubeide·mems·stm32c5·stm32cubemx2·stm32c542rct6·iis3dwb10is
宁静致远20211 个月前
VSCode 开发 STM32 的 Keil工程 （Keil Assistant）
vscode·stm32·stm32cubeide
记帖1 个月前
STM32C5A3R开发(7)----ADC电压采集
嵌入式硬件·adc·dac·stm32cubeide·stm32c5·stm32cubemx2·stm32c5a3rgt6
记帖2 个月前
STM32C542开发(7)----ADC电压采集
adc·dac·stm32cubeide·stm32c5·stm32cubemx2·stm32c542cct6
记帖2 个月前
STM32C542开发(4)----输出PWM及修改频率与占空比R
stm32cubeide·stm32c5·stm32cubemx2·stm32c542cct6·stm32c542rct6
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02历年考研数学一、数学二、数学三真题试卷及答案PDF03GitHub 镜像站点04「全语录+省流版」邵艾伦 × 孙宇晨：聊风口、聊个人IP、聊年轻人如何抓住 AI 时代的机会05蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接06如何新建文件夹？ 电脑新建文件夹的4种方法07Windows 10/11 如何退出微软账户并改用本地账户登录（含找不到选项的解决方法）08轻量化AI渗透武器库｜ARTEX自主攻防系统、资产梳理、漏洞挖掘、链路分析全流程智能化落地09Telegram APK 下载安装完整指南 — 2026年最新10微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新