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

STM32C5开发ISM330DHCX .3--配置单击与双击检测

概述
视频教学
样品申请
源码下载
硬件准备
参考程序
串口配置
IIC配置
CS和SA0设置
INT设置
生成项目
导入STM32CubeIDE
设置工程编码
添加头文件
[printf 重定向](#printf 重定向)
参考程序
CMake设置
头文件设置
初始换管脚
变量定义
获取ID
复位传感器
BDU设置
配置输出数据率与测量量程
外部中断回调函数
中断配置
中断映射
读取事件
演示

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

概述

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

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

视频教学

样品申请

源码下载

硬件准备

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

主控为STM32C542CCT6，陀螺仪为ISM330DHCX，磁力计为LIS2MDL。

参考程序

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

https://gitee.com/CoreMaker/STM32C542_ISM330DHCX_LIS2MDL

串口配置

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

在左侧 Peripherals 中选择 Connectivity → USART1
Mode 选择 Async，表示配置为异步串口模式
unction used by the component 显示为 UART，说明 USART1 在异步模式下使用 UART HAL 驱动
串口参数配置为：115200 波特率、8 位数据位、无校验、1 位停止位、收发模式
GPIO Tx：USART1_TX 选择 PA9
GPIO Rx：USART1_RX 选择 PA10
PA9 / PA10 均配置为 Alternate 复用功能模式
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 配置步骤如下：

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

CS和SA0设置

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

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

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

将 PA1 和 PB2 配置为普通 GPIO。

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

SA0：用于选择 I2C 地址

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

在右侧 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 页面中，将 PB0 配置为 GPIO 输入，并开启 EXTI 功能。

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

开启 EXTI0 Interrupt，并生成 IRQ Handler。

生成项目

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

导入STM32CubeIDE

打开 STM32CubeIDE，点击菜单栏 File
选择 Import...，准备导入 STM32CubeMX2 生成的 CMake 工程
在 Import 窗口中展开 Import STM32 Project
选择 STM32 CMake Project
点击 Next，进入 CMake 工程路径选择页面
Project name：填写导入到 STM32CubeIDE 中显示的工程名称
Source directory：选择 STM32CubeMX2 生成的 CMake 工程目录
点击 Next，继续完成工程导入

Toolchain：选择 MCU ARM GCC，表示使用 ARM GCC 工具链进行编译
MCU：确认芯片型号为 STM32C542CCTx，与前面 STM32CubeMX2 中选择的 MCU 保持一致
CPU/Core：确认内核为 Cortex-M33，Core 为 0
点击 Finish，完成 CMake 工程导入

设置工程编码

在 Project Explorer 中选中当前工程
点击菜单栏 Project
选择 Properties，进入工程属性设置
在工程属性中选择 Resource
Text file encoding 选择 Other
编码格式输入 GBK
点击 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/CoreMaker-lab/STM32C542_ISM330DHCX_LIS2MDL

添加对应驱动程序。

CMake设置

把ism330dhcx_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
  ism330dhcx_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 "ism330dhcx_reg.h"

初始换管脚

由于需要向ISM330DHCX_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;

在main() 中定义中断结构体

c 复制代码

stmdev_ctx_t dev_ctx;stmdev_ctx_t dev_ctx;
ism330dhcx_pin_int1_route_t  pin_int = {0};

获取ID

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

对应的获取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 */
ism330dhcx_device_id_get(&dev_ctx, &whoamI);
printf("ISM330DHCX_ID=0x%x,id=0x%x\n",ISM330DHCX_ID,whoamI);
if (whoamI != ISM330DHCX_ID)
    while (1);

复位传感器

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

c 复制代码

/* Restore default configuration */
ism330dhcx_reset_set(&dev_ctx, PROPERTY_ENABLE);
platform_delay(BOOT_TIME);

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 */
ism330dhcx_block_data_update_set(&dev_ctx, PROPERTY_ENABLE);

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

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

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

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

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

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

对应程序如下所示。

c 复制代码

/* Set Output Data Rate */
ism330dhcx_xl_data_rate_set(&dev_ctx, ISM330DHCX_XL_ODR_416Hz);
ism330dhcx_gy_data_rate_set(&dev_ctx, ISM330DHCX_GY_ODR_12Hz5);

/* Set full scale */
ism330dhcx_xl_full_scale_set(&dev_ctx, ISM330DHCX_8g);
ism330dhcx_gy_full_scale_set(&dev_ctx, ISM330DHCX_2000dps);

外部中断回调函数

当 ISM330DHCX 传感器的 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;
    }
}

中断配置

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

c 复制代码

/* INT1/INT2: open-drain + active low (matches external pull-up + PB0 falling edge) */
ism330dhcx_pin_mode_set(&dev_ctx, ISM330DHCX_OPEN_DRAIN);
ism330dhcx_pin_polarity_set(&dev_ctx, ISM330DHCX_ACTIVE_LOW);

中断映射

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

c 复制代码

/* Enable Z-axis Tap detection */
ism330dhcx_tap_detection_on_x_set(&dev_ctx, PROPERTY_DISABLE);
ism330dhcx_tap_detection_on_y_set(&dev_ctx, PROPERTY_DISABLE);
ism330dhcx_tap_detection_on_z_set(&dev_ctx, PROPERTY_ENABLE);

/* Set Tap threshold */
ism330dhcx_tap_threshold_x_set(&dev_ctx, 0);
ism330dhcx_tap_threshold_y_set(&dev_ctx, 0);
ism330dhcx_tap_threshold_z_set(&dev_ctx, 3);

/* Set Tap time windows (shock/quiet/tap_gap = 3/3/7) */
ism330dhcx_tap_shock_set(&dev_ctx, 3);
ism330dhcx_tap_quiet_set(&dev_ctx, 3);
ism330dhcx_tap_dur_set(&dev_ctx, 7);

/* Enable Single Tap and Double Tap */
ism330dhcx_tap_mode_set(&dev_ctx, ISM330DHCX_BOTH_SINGLE_DOUBLE);

/* Route Single Tap and Double Tap to INT1, keep XL data-ready off */
pin_int.md1_cfg.int1_single_tap = PROPERTY_ENABLE;
pin_int.md1_cfg.int1_double_tap = PROPERTY_ENABLE;
pin_int.int1_ctrl.int1_drdy_xl  = PROPERTY_DISABLE;
ism330dhcx_pin_int1_route_set(&dev_ctx, &pin_int);

/* Pulsed (latched disabled) interrupt notification */
ism330dhcx_int_notification_set(&dev_ctx, ISM330DHCX_ALL_INT_PULSED);

读取事件

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

c 复制代码

 while (1) {
    if (thread_wake)
    {
      ism330dhcx_all_sources_t status = {0};

      thread_wake = 0;

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

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

演示

单击和双击测试如下