企业官网建设流程全解析

.2–轮询获取陀螺仪数据)

概述

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

视频教学

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

样品申请

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

源码下载

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

硬件准备

首先需要准备一个开发板，这里我准备的是自己绘制的开发板，需要的可以进行申请。
主控为STM32C542CC，陀螺仪为LSM6DSK320X，磁力计为LIS2MDL。

参考程序

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

https://gitee.com/CoreMaker/STM32C542_LSM6DSK320X_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 中添加头文件

#include"mx_usart1.h"#include<stdio.h>#include<string.h>

printf 重定向

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

int_write(intfile,char*ptr,intlen){hal_uart_handle_t*huart1=mx_usart1_uart_gethandle();if(huart1!=NULL){HAL_UART_Transmit(huart1,ptr,len,1000);}returnlen;}

参考程序

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

添加对应驱动程序。

CMake设置

把lsm6dsv320x_reg.c 加入 CMake 编译 。

#Stubs to be able to add compiler flag overrides,e.g.-Ostarget_sources(${CMAKE_PROJECT_NAME}PRIVATE#Add additional source files herelsm6dsv320x_reg.c)

printf 输出浮点数需要额外开启 float printf 支持。
CMake 官方说明 target_link_options() 就是给可执行目标添加 linker options 的命令。

target_link_options(${CMAKE_PROJECT_NAME}PUBLIC#Add additional linker flags here-u _printf_float)

头文件设置

添加头文件。

#include"lsm6dsv320x_reg.h"

初始换管脚

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

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

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);

变量定义。

/* Private macro -------------------------------------------------------------*/#defineBOOT_TIME10//ms/* Private variables ---------------------------------------------------------*/staticuint8_twhoamI;/* Extern variables ----------------------------------------------------------*//* Private functions ---------------------------------------------------------*//* * WARNING: * Functions declare in this section are defined at the end of this file * and are strictly related to the hardware platform used. * */staticint32_tplatform_write(void*handle,uint8_treg,constuint8_t*bufp,uint16_tlen);staticint32_tplatform_read(void*handle,uint8_treg,uint8_t*bufp,uint16_tlen);staticvoidplatform_delay(uint32_tms);staticstmdev_ctx_tdev_ctx;staticvolatileuint8_tthread_wake=0;

获取ID

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

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

lsm6dsv320x_interrupt_mode_tirq={0};lsm6dsv320x_tap_detection_ttap={0};lsm6dsv320x_tap_thresholds_ttap_ths={0};lsm6dsv320x_tap_time_windows_ttap_win={0};lsm6dsv320x_pin_int_route_tpin_int={0};lsm6dsv320x_if_cfg_tif_cfg={0};/* 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();/* Wait sensor boot time */platform_delay(BOOT_TIME);/* Check device ID */lsm6dsv320x_device_id_get(&dev_ctx,&whoamI);printf("LSM6DSK320X_ID=0x%x,id=0x%x\n",0x75,whoamI);if(whoamI!=0x75)while(1);

复位传感器

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

/* Perform device power-on-reset */lsm6dsv320x_sw_por(&dev_ctx);

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进行开启。

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

/* Enable Block Data Update */lsm6dsv320x_block_data_update_set(&dev_ctx,PROPERTY_ENABLE);

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

该代码用于配置加速度计和陀螺仪的基本采样参数：
● 将加速度计和陀螺仪的输出数据率均设置为 480 Hz。
● 将加速度计量程设置为 ±8 g。
对应程序如下所示。

/* * Tap detection uses Low-G accelerometer. * ODR = 480 Hz, FS = +/-8 g */lsm6dsv320x_xl_setup(&dev_ctx,LSM6DSV320X_ODR_AT_480Hz,LSM6DSV320X_XL_HIGH_PERFORMANCE_MD);lsm6dsv320x_xl_full_scale_set(&dev_ctx,LSM6DSV320X_8g);

外部中断回调函数

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

/** * @brief EXTI trigger callback */voidHAL_EXTI_TriggerCallback(hal_exti_handle_t*hexti,hal_exti_trigger_ttrigger){if(HAL_EXTI_GetInstance(hexti)==HAL_EXTI_GPIO_0){thread_wake=1;}}

中断配置

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

/* INT1/INT2: open-drain + active low */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);/* Enable interrupt function */irq.enable=PROPERTY_ENABLE;irq.lir=0;lsm6dsv320x_interrupt_enable_set(&dev_ctx,irq);

中断映射

程序首先只开启 Z 轴的敲击检测，并设置 Z 轴 Tap 阈值为 3；随后通过 shock、quiet 和 tap_gap 设置敲击持续时间、第一次敲击后的静默时间以及双击允许的最大时间间隔，这些参数共同决定单击和双击动作的识别条件。之后将工作模式设置为 LSM6DSV320X_BOTH_SINGLE_DOUBLE，同时开启单击和双击识别，并通过 pin_int.single_tap 和 pin_int.double_tap 将两种事件映射到 INT1 引脚；当传感器识别到有效敲击动作后，即可通过 INT1 产生中断通知 STM32。ST 官方文档也说明，Tap 检测需要选择检测轴、设置各轴阈值以及 Shock、Quiet、Duration 时间窗口，并可将 Single Tap 和 Double Tap 分别路由到 INT1。

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

读取事件

当 传感器 的 INT1 产生中断后，HAL_EXTI_TriggerCallback() 会将 thread_wake 置 1；主循环检测到该标志后，调用 lsm6dsv320x_all_sources_get() 读取传感器当前的中断源状态，并根据 double_tap 和 single_tap 标志判断是双击还是单击事件，最后通过串口输出对应结果。ST 官方 AN6119 也说明，Tap 事件可通过 TAP_SRC 中的 SINGLE_TAP 和 DOUBLE_TAP 状态位进行判断。

while(1){if(thread_wake){lsm6dsv320x_all_sources_tstatus={0};thread_wake=0;/* Read interrupt source */lsm6dsv320x_all_sources_get(&dev_ctx,&status);if(status.double_tap){printf("Double Tap\r\n");}elseif(status.single_tap){printf("Single Tap\r\n");}}}

演示

单击和双击测试如下。