套件概述
& F6 m; t- g9 V: y# C( }- L" i2 Z" h用于配置和设置 STHS34PF80 传感器的一些参数，以便进行存在检测和运动检测。

  T" T- k5 T  m7 p) p( [

参考程序初始化
) R6 I( H' w  Y: o相对于驱动人体检测demo，新的案例设置了传感器的存在和运动相关的阈值、滞后和中断配置，以实现存在检测和运动检测的功能，并在相关事件发生时触发中断。


: M0 {7 G$ d4 S# c  r4 \
; k1 v' f1 w) |2 E; H. h$ w省电模式
; }( `  L9 \7 F8 t下面文本描述了关机模式的使用和功能。关机模式是一种休眠模式，用于将传感器设备置于休眠状态，从而节省功耗。在关机模式下，设备停止数据采集，并且大部分内部模块都被关闭，以最小化电流消耗。这使得传感器在供电的情况下能够实现最低的功耗水平。
- i+ F7 D- O9 {' Q! z
尽管设备处于关机模式，但它仍保持 I²C / SPI 通信串口处于活动状态，以便能够与设备进行通信和配置设置。关机模式下，配置寄存器的内容被保留，而输出数据寄存器不会更新，这意味着在进入关机模式前，最后一次采样的数据将保留在内存中。

+ W, D4 P& m6 u为了进入关机模式并避免在重新进入连续模式时读取错误的输出数据，文本提供了正确的步骤。然而，这些步骤在你的问题中并未提供，因此无法给出完整的步骤。
' H6 l! N2 {- L2 p6 a0 Z
4 D& l& }2 O: L2 D2 U
! y# P5 J4 N) d) s" P3 ~
上面文档主要对0x25，0x23，0x20寄存器进行操作，其中读取0x25多次，主要功能是对STATUS (23h)的DRDY进行清0。
$ b' ]7 o3 R0 t  T
6 c* q4 j2 G# {+ e* v& m' {查看下面表格也可以得知，有多种操作可以对STATUS (23h)的DRDY 清零。
0 w2 O8 R3 A9 w& @

" b) s% E! A2 W  @9 h
! Y6 C4 f- q' _' m其中0x20是配置速率寄存器。



2 K3 L4 j# ~8 h* t% [% I( L% Y+ c设置存在阈值
4 m; e5 g0 v2 m' r# t0 c7 M存在检测如下所示。

! n6 H& R( _: U/ d+ Y2 f% j; O
/ E. y5 B& r  Q, |! t$ @; D
+ |3 R" B4 K  ]+ e/ L! X& F以设置存在阈值为例，探索设置的步骤。



这里使用的函数为 sths34pf80_presence_threshold_set(STHS34PF80_ADDRESS, 200)。

1. /**
   
2.   * @brief  Presence threshold.[set]
   
3.   *
   9 K- y& `- t$ d' W/ E; ~( q/ f% T
4.   * @param  ctx      read / write interface definitions
   
5.   * @param  val      presence threshold level
   * h$ G3 v/ Z0 P- Z' m4 f
6.   * @retval          interface status (MANDATORY: return 0 -> no Error)
   
7.   *
     S" K# R0 \' P& |1 @
8.   */
   / i2 T, u; Z0 o' ^. K. k
9. uint8_t sths34pf80_presence_threshold_set(uint8_t add, uint16_t val)
   
10. {
    
11.   sths34pf80_ctrl1_t ctrl1;
    
12.   uint8_t odr;
    
13.   uint8_t buff[2];
    
14.   int32_t ret;
    2 s! x. }  s; L
15. 
    " O, N3 u: Y8 T* M
16.   if ((val & 0x8000U) != 0x0U) {
    . r- c3 y9 l( ?, W0 X
17.     /* threshold values are on 15 bits */
    ' [8 ]# R$ y3 z6 A' @  Y9 b
18.     return -1;
      V. z- t. d( g5 J* t5 x# j
19.   }
    , Q; Z- o% q, ?- G7 S
20. 
    
21.   /* Save current odr and enter PD mode */
      L9 b' m( w) _9 i' J, j
22.   ret = sths34pf80_read_reg(add, STHS34PF80_CTRL1, (uint8_t *)&ctrl1, 1);//STHS34PF80_CTRL1->0x20
    7 h& W$ W/ j  b1 v' Y, j
23.   odr = ctrl1.odr;
    
24.   ret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, 0);
    # q) N$ e  I2 ?0 N! \( E2 ~; p
25. 
    2 K! \( f9 w5 k: g# G: e
26.   buff[1] = (uint8_t)(val / 256U);
    : }; \2 @- J) \* C
27.   buff[0] = (uint8_t)(val - (buff[1] * 256U));
    
28.   ret += sths34pf80_func_cfg_write(add, STHS34PF80_PRESENCE_THS, &buff[0], 2);//STHS34PF80_PRESENCE_THS->0x20U
    
29. 
    
30.   ret += sths34pf80_algo_reset(add);
    
31. 
    
32.   /* Set saved odr back */
      T$ G2 N4 [+ J( b$ b; z
33.   ret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, odr);
    5 T& |7 K/ ?9 }* a+ }: T9 ]8 ^
34. 
    - w7 A( _7 w8 ?+ x4 d3 h2 `- w
35.   return ret;
    - X3 W( n  a+ e# @. i& w9 x  l
36. }
    . P3 `* i2 N9 {, R7 c% t8 }4 R

复制代码

( C1 c; T5 c% s最开始读取CTRL1（20h）的数据，同时进行保存到odr变量中。

1.   ret = sths34pf80_read_reg(add, STHS34PF80_CTRL1, (uint8_t *)&ctrl1, 1);//STHS34PF80_CTRL1->0x20
   
2.   odr = ctrl1.odr;
   

复制代码

! S* B7 m9 a6 T! K: g) C; Dret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, 0)这行代码用于在设置存在阈值之前，通过调用 sths34pf80_tmos_odr_check_safe_set 函数来确保在设置新的参数之前传感器的状态是稳定且安全的。该函数如下所示。

1. /**
   + c- b+ b3 |. u
2.   * @brief  Enter to/Exit from power-down in a safe way
   
3.   *
   
4.   * @param  ctx      read / write interface definitions
   4 @$ S, [" m8 P" a
5.   * @param  ctrl1    Value of CTRL1 register
   ' k/ z- K, I6 c, V' Z! t) f* y4 e/ Y4 [( f
6.   * @param  odr_new  Value of new odr to be set
   % e. M' M+ W' E7 Z6 O
7.   * @retval          interface status (MANDATORY: return 0 -> no Error)
   
8.   *
     \3 h' V' y% ^& Z0 m( k: F
9.   */
   
10. static uint8_t sths34pf80_tmos_odr_check_safe_set(uint8_t add,sths34pf80_ctrl1_t ctrl1, uint8_t odr_new)
    9 L% |# y% o9 Q7 A1 N) ]9 s
11. {
    ! J; Q' w. j0 L$ ]& f6 S% \# J
12.   sths34pf80_func_status_t func_status;
    " ]( X* E- N2 A$ G
13.   sths34pf80_tmos_drdy_status_t status;
    
14.   int32_t ret = 0;
    
15. 
    5 A( d+ b- `5 ?1 `0 P" S* S# x
16.   if (odr_new > HAL_OK) {
    
17.     /*
    # e5 S! s. U8 ^
18.      * Do a clean reset algo procedure everytime odr is changed to an
    7 l2 k# Y" c- ^2 B, k/ a
19.      * operative state.
    " w& ]; c, r0 N3 M: U6 b# d6 q
20.      */
    ) G. `& p0 d* j* }2 \
21.     ctrl1.odr = 0;
    . e" T8 I$ g$ o$ W+ w
22.     ret = sths34pf80_write_reg(add, STHS34PF80_CTRL1, (uint8_t *)&ctrl1, 1);//STHS34PF80_CTRL1->0x20
    
23. 
    / n$ o7 {, ]2 |$ g$ C1 ?
24.     ret += sths34pf80_algo_reset(add);
    
25.   } else {
    
26.     /* if we need to go to power-down from an operative state
    
27.      * perform the safe power-down.
    
28.      */
    0 p: m3 Y, Q% d" F: @
29.     if ((uint8_t)ctrl1.odr > 0U) {
    ' N% a! q* }9 c5 d/ ~# K
30.       /* reset the DRDY bit */
    , X0 w" i/ M2 x: `# r
31.       ret = sths34pf80_read_reg(add, STHS34PF80_FUNC_STATUS, (uint8_t *)&func_status, 1);//STHS34PF80_FUNC_STATUS->0x25
    
32. 
    
33.       /* wait DRDY bit go to '1' */
    # ^/ _, I% |/ X, q8 t% k, u
34.       do {
    ( H" k% I& A& \5 w% |
35.         ret += sths34pf80_tmos_drdy_status_get(add, &status);
    5 T1 o+ c, b6 }/ C- c- X9 ?
36. 
    $ y) E7 v% @. A" q$ S" h- S1 W* P
37.       } while (status.drdy != 0U);
    
38. 
    
39.       /* set ODR to 0 */
    . H9 A: i. {9 w& @# ~+ w) }
40.       ctrl1.odr = 0;
    : q/ i! R+ K% D) W6 E1 b; A
41.       ret += sths34pf80_write_reg(add, STHS34PF80_CTRL1, (uint8_t *)&ctrl1, 1);
    % ]% z+ `: E" B/ j6 f
42. 
    ( @6 L5 v/ |. t7 v  [5 p8 I  p
43.       /* reset the DRDY bit */
    * o" B' H, z4 a
44.       ret += sths34pf80_read_reg(add, STHS34PF80_FUNC_STATUS, (uint8_t *)&func_status, 1);
    
45.     }
    
46.   }
    
47. 
    
48.   ctrl1.odr = (odr_new & 0xfU);
    
49.   ret += sths34pf80_write_reg(add, STHS34PF80_CTRL1, (uint8_t *)&ctrl1, 1);
    
50. 
    
51.   return ret;
    
52. }

复制代码

( l1 \0 B8 ]8 I& X6 O其中下电模式在else中执行。
# l/ W3 P  ?; ?9 E1 ^8 e先是执行sths34pf80_read_reg(add, STHS34PF80_FUNC_STATUS, (uint8_t *)&func_status, 1)，读取0x25主要功能是对STATUS (23h)的DRDY进行清0,之后执行如下代码。

1.       /* wait DRDY bit go to '1' */
   , u5 T( q# h" \6 @0 K6 {
2.       do {
   
3.         ret += sths34pf80_tmos_drdy_status_get(add, &status);
   & x: o" N$ K$ b7 z3 o
4. 
   , G- I' L1 Q! x& u  g
5.       } while (status.drdy != 0U);
   

复制代码

( L, U) N+ y8 d4 B  l9 Y3 p; Jsths34pf80_tmos_drdy_status_get代码主要是对STATUS (23h)的DRDY进行读取，当读取为0，跳出上面的循环。

1. /**
   8 \& h3 ?6 N/ B
2.   * @brief  status of drdy.[get]
   8 H! s* D' A3 m! }  _, }2 m
3.   *
   
4.   * @param  ctx      read / write interface definitions
   
5.   * @param  val      status of drdy bit (TAMB, TOBJ, TAMB_SHOCK, TPRESENCE, TMOTION).
   
6.   * @retval          interface status (MANDATORY: return 0 -> no Error)
   7 s) @1 V1 K2 q7 k$ A
7.   *
   
8.   */
   
9. uint8_t sths34pf80_tmos_drdy_status_get(uint8_t add, sths34pf80_tmos_drdy_status_t *val)
   % T. D0 w; j' f7 f2 |4 U1 @9 e
10. {
    
11.   sths34pf80_status_t status;
    / u$ D8 m1 z, p2 V! |/ A4 ~7 m
12.   int32_t ret;
    
13. 
    % S. O2 t) n" B) k8 X, _  M9 U
14.   ret = sths34pf80_read_reg(add, STHS34PF80_STATUS, (uint8_t *)&status, 1);//STHS34PF80_STATUS->0x23
    
15. 
    # U. c( j' m3 b
16.   val->drdy = status.drdy;
    
17. 
    
18.   return ret;
    0 d7 q/ o+ i7 n2 K: y
19. }
      J2 T" G& K/ d- T6 }5 F8 m% a% V" X

复制代码

之后重新回到sths34pf80_tmos_odr_check_safe_set函数中，执行如下操作。
主要功能就是将CTRL1（20h）里面的ODR数据清零，同时读取0x25，主要功能是对STATUS (23h)的DRDY进行清0

1.       /* set ODR to 0 */
   
2.       ctrl1.odr = 0;
   
3.       ret += sths34pf80_write_reg(add, STHS34PF80_CTRL1, (uint8_t *)&ctrl1, 1);//STHS34PF80_CTRL1->0x20
   2 c; ^3 Q) f. H# M4 K! i: u
4. 
   
5.       /* reset the DRDY bit */
   , A( r) T4 X0 f. E+ i( u
6.       ret += sths34pf80_read_reg(add, STHS34PF80_FUNC_STATUS, (uint8_t *)&func_status, 1);//STHS34PF80_FUNC_STATUS->0x25
   ' _4 i: L. T: [+ n

复制代码

然后执行如下代码将ODR数据重新写入CTRL1（20h）寄存器中。

1.   ctrl1.odr = (odr_new & 0xfU);
   - O  t9 q3 C: X1 j+ K
2.   ret += sths34pf80_write_reg(add, STHS34PF80_CTRL1, (uint8_t *)&ctrl1, 1);//STHS34PF80_CTRL1->0x20
   

复制代码

紧接着返回sths34pf80_presence_threshold_set函数中，执行如下操作。
+ i# A: `3 m! E# @将传入的数据保存到buff数组中，然后执行sths34pf80_func_cfg_write将buff数据传入到PRESENCE_THS (20h - 21h)中。

1. buff[1] = (uint8_t)(val / 256U);
   # Y5 W8 r2 P7 A/ |  m
2.   buff[0] = (uint8_t)(val - (buff[1] * 256U));
   
3.   ret += sths34pf80_func_cfg_write(add, STHS34PF80_PRESENCE_THS, &buff[0], 2);//STHS34PF80_PRESENCE_THS->0x20U

复制代码

: Y" l/ {+ Q7 v$ k/ c0 R查看sths34pf80_func_cfg_write函数，如下所示。

1. /**
   
2.   * @brief  Function Configuration write
   ' k2 ?6 Q# N! }
3.   *
   " D/ o5 F$ z  ^0 r) }* N1 E
4.   * @param  ctx      read / write interface definitions
   2 y5 [* }6 }! ^2 m3 u$ w7 T. C
5.   * @param  addr     embedded register address
   . y3 s" `/ r$ d( ]
6.   * @param  data     embedded register data
   $ C$ y  H, X: G5 G( {; G
7.   * @param  len      embedded register data len
   8 j+ N" x4 s+ r2 A& Z: Q! s( C
8.   * @retval          interface status (MANDATORY: return 0 -> no Error)
   
9.   *
   
10.   */
    8 l" V9 v3 b  N* S" d! ~
11. uint8_t sths34pf80_func_cfg_write(uint8_t add, uint8_t addr, uint8_t *data, uint8_t len)
    
12. {
    7 v5 ?% P  K  @6 X) A1 N9 U% f
13.   sths34pf80_ctrl1_t ctrl1;
    6 V: r( W3 I% l& o
14.   uint8_t odr;
    
15.   sths34pf80_page_rw_t page_rw = {0};
    
16.   int32_t ret;
    
17.   uint8_t i;
    * ^2 ~3 l8 ^! a5 x0 ~9 i! r
18. 
    5 X  ?: v9 w: _+ D$ r+ Q+ E8 }7 b
19.   /* Save current odr and enter PD mode */
    
20.   ret = sths34pf80_read_reg(add, STHS34PF80_CTRL1, (uint8_t *)&ctrl1, 1);//STHS34PF80_CTRL1->0x20
    4 I: b. w4 S' M" f( [
21.   odr = ctrl1.odr;
    
22.   ret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, 0);
    7 R: l. Z7 U6 ^
23. 
    - m0 U: d2 R$ z) T1 P1 m& e
24.   /* Enable access to embedded functions register */
    
25.   ret += sths34pf80_mem_bank_set(add, STHS34PF80_EMBED_FUNC_MEM_BANK);
    
26. 
    , `; F% e# g" r& w
27.   /* Enable write mode */
    
28.   page_rw.func_cfg_write = 1;
    4 ?" u2 O( T, _$ R
29.   ret += sths34pf80_write_reg(add, STHS34PF80_PAGE_RW, (uint8_t *)&page_rw, 1);
    
30. 
    7 C8 a; R# y8 N
31.   /* Select register address (it will autoincrement when writing) */
    
32.   ret += sths34pf80_write_reg(add, STHS34PF80_FUNC_CFG_ADDR, &addr, 1);
    3 D: n6 Y  T2 l) s& ^& Q! Z
33. 
    
34.   for (i = 0; i < len; i++)
    
35.   {
    
36.     /* Write data */
    . Q7 X& a. n- `/ ^/ K1 y
37.     ret += sths34pf80_write_reg(add, STHS34PF80_FUNC_CFG_DATA, &data[i], 1);
    2 a+ s& v* j- N7 z" ^: F( a
38.   }
      o0 z! C5 k; K+ g! h
39. 
    1 X5 o3 S& P' p2 r* v; I, d
40.   /* Disable write mode */
    ; |2 c3 a, h1 \3 f9 ]
41.   page_rw.func_cfg_write = 0;
    : t8 p* }6 b$ V% h
42.   ret += sths34pf80_write_reg(add, STHS34PF80_PAGE_RW, (uint8_t *)&page_rw, 1);
    # Q+ a" _* t" S# p2 j1 D& D' R
43. 
    
44.   /* Disable access to embedded functions register */
    ! x7 e0 @' S- T# a- ]0 L; a: L
45.   ret += sths34pf80_mem_bank_set(add, STHS34PF80_MAIN_MEM_BANK);
    
46. 
    
47.   /* Set saved odr back */
    
48.   ret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, odr);
    + T- z& u* c. I
49. 
    
50.   return ret;
    : d( L# x0 p, {; S+ R
51. }

复制代码

分析上面代码，其中sths34pf80_read_reg(add, STHS34PF80_CTRL1, (uint8_t *)&ctrl1, 1)为将ODR数据读取出来，接着执行sths34pf80_tmos_odr_check_safe_set(add, ctrl1, 0)，该函数上面已经讲解，主要是进入一个掉电模式，确保在设置新的参数之前传感器的状态是稳定且安全的，以防止设置参数时出现异常情况。接着执行sths34pf80_mem_bank_set(add, STHS34PF80_EMBED_FUNC_MEM_BANK)，该函数具体操作如下所示。

1. /**
   ' w: u  I! j( x& K* g: C7 e
2.   * @brief  Change memory bank.[set]
   - f* W4 ?+ r5 ^1 H+ M6 d
3.   *
   
4.   * @param  ctx      read / write interface definitions
   8 X+ f* N: n* \- r9 D9 S
5.   * @param  val      MAIN_MEM_BANK, EMBED_FUNC_MEM_BANK, SENSOR_HUB_MEM_BANK, STRED_MEM_BANK,
   
6.   * @retval          interface status (MANDATORY: return 0 -> no Error)
   7 D7 m9 d3 B6 _1 f
7.   *
   
8.   */
   & W% b1 h% d  l; q9 G2 o) }
9. uint8_t sths34pf80_mem_bank_set(uint8_t add, sths34pf80_mem_bank_t val)
   
10. {
    
11.   sths34pf80_ctrl2_t ctrl2;
    ( s  o* o: Q. a; C
12.   int32_t ret;
    
13. 
    
14.   ret = sths34pf80_read_reg(add, STHS34PF80_CTRL2, (uint8_t *)&ctrl2, 1);//STHS34PF80_CTRL2->0x21
    : t6 N( T  A3 @& Y3 A# E1 a7 x: ?
15. 
    
16.   if (ret == HAL_OK)
    4 n9 w1 D, f/ z% V0 M
17.   {
    4 u! s6 R) T7 U5 B* {
18.     ctrl2.func_cfg_access = ((uint8_t)val & 0x1U);
    
19.     ret = sths34pf80_write_reg(add, STHS34PF80_CTRL2, (uint8_t *)&ctrl2, 1);//STHS34PF80_CTRL2->0x21
    6 L. E. D7 k' z* O
20.   }
    
21. 
    - l$ {" i( N$ D& `
22.   return ret;
    
23. }

复制代码

1. CTRL2 (21h)如下所示，对FUNC_CFG_ACCESS设置为1主要是开启访问内嵌函数寄存器。
   ; w9 P6 G% b0 ]+ m+ t' w: c$ A
2. 
   : K5 c: }% q: [- V. U3 k: X
3. 
   2 \3 ^3 O8 ]0 p( @8 L  _6 B' f6 ?
4. 继续返回sths34pf80_func_cfg_write函数，
   " j; P! ?5 t! ~# z* m9 W( X: V
5. 之后执行如下函数，主要为向寄存器PAGE_RW (11h)的FUNC_CFG_WRITE标志位置为为1，启用嵌入式函数的写过程。

复制代码

1.   /* Enable write mode */
   
2.   page_rw.func_cfg_write = 1;
   
3.   ret += sths34pf80_write_reg(add, STHS34PF80_PAGE_RW, (uint8_t *)&page_rw, 1);
   

复制代码

9 Z$ e( b0 S5 S3 @9 `

继续返回sths34pf80_func_cfg_write函数，然后执行如下函数，该函数为写入或者读取嵌入式函数的地址，具体要看PAGE_RW (11h)设置为读或者写，同时写入固定的data指令，当写完之后进入PAGE_RW (11h)关闭读或写操作。

1.   /* Select register address (it will autoincrement when writing) */
   1 _& u7 p% u2 a) ]4 X$ g
2.   ret += sths34pf80_write_reg(add, STHS34PF80_FUNC_CFG_ADDR, &addr, 1);
   
3.   for (i = 0; i < len; i++)
   , W( _  R) J8 j" I8 m
4.   {
   # H; x# `3 {, U& A. y  k
5.     /* Write data */
   ; }/ M. m5 E& k2 J6 P& v6 j" I
6.     ret += sths34pf80_write_reg(add, STHS34PF80_FUNC_CFG_DATA, &data[i], 1);
   
7.   }
   / [  c5 o; B9 c  ^
8.   /* Disable write mode */
   
9.   page_rw.func_cfg_write = 0;
   / e* u  ~) O. s! n8 m: d6 d2 ~' ?5 S
10.   ret += sths34pf80_write_reg(add, STHS34PF80_PAGE_RW, (uint8_t *)&page_rw, 1);

复制代码

这里传入的地址addr为STHS34PF80_PRESENCE_THS，这是个15位的寄存器，PRESENCE_THS 寄存器（地址范围为 0x20 到 0x21）主要用于存在检测算法的存在阈值设置。存在检测算法用于判断是否存在某种状态或条件，通常与传感器测量数据相关。
; @6 d" H# ]/ H" M/ p
* j- j# r, P+ n" ^, f: w
+ {3 r, _# U" W/ y; i具体解释如下：
' V: L& q) h8 d/ s0 h! u3 Q- l存在阈值（Presence Threshold）： 这是一个用于存在检测算法的阈值。阈值定义了在测量数据中何时认为存在某种条件。在这里，阈值是一个 15 位的无符号整数（范围在 0 到 32767 之间）。


* c7 s: K5 _6 ?5 m默认值： 预设的存在阈值默认值是 200（0x00C8）。


" _: \* T- t& N; C
接着执行sths34pf80_tmos_odr_check_safe_set(add, ctrl1, odr)，将odr重新写入。
% k5 q1 w) H# ?
# [% }. J  E( n3 O1 S  t1 `

1.   /* Set saved odr back */
   , ]$ L5 ]& T" N5 [0 X% H
2.   ret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, odr);
   . K5 S3 y4 p6 d; ~& x! v0 d

复制代码

到此sths34pf80_func_cfg_write就已经设置完毕，返回sths34pf80_presence_threshold_set函数中，执行sths34pf80_algo_reset操作。

( s! Z$ ~  \; }

1.   ret += sths34pf80_algo_reset(add);

复制代码

0 j8 U" k; Z) Z+ Q% W7 i" Z" ]/ F  z该函数具体操作如下所示。

1. /**
   
2.   * @brief  Reset algo
   
3.   *
   ) [1 K; e9 l9 i  d! i* ]: D/ `: L
4.   * @param  ctx      read / write interface definitions
   
5.   * @param  val      reset algo structure
   - n' v( Q. l1 G9 n9 h& g
6.   * @retval          interface status (MANDATORY: return 0 -> no Error)
   
7.   *
   
8.   */
   ( |* X# L% ?6 i2 S& d" @
9. uint8_t sths34pf80_algo_reset(uint8_t add)
   
10. {
    
11.   uint8_t tmp;
    7 ?- b( e- x6 K. Z' P1 b" i
12.   int32_t ret;
    8 ]1 w5 x, Z! e& ]* k/ a/ z( f7 [
13. 
    
14.   tmp = 1;
    * @% n) S, b6 [8 M" u8 x/ l
15.   ret = sths34pf80_func_cfg_write(add, STHS34PF80_RESET_ALGO, &tmp, 1);//STHS34PF80_RESET_ALGO->0x2A
    $ D' R7 k' B% C# `! p! c4 O
16. 
    
17.   return ret;
    
18. }
    

复制代码

该函数对RESET_ALGO (2Ah)的ALGO_ENABLE_RESET 置为位1，执行算法重置操作。默认情况下，这个位的值为 0，表示不进行算法重置。当用户修改了与算法相关的参数时（例如阈值、滞后等），需要将 ALGO_ENABLE_RESET 位设置为 1。重置完成后，ALGO_ENABLE_RESET 位应返回到默认值 0。

; p& g5 q# S' f7 ]$ U

接着执行sths34pf80_tmos_odr_check_safe_set，将刚刚保存的ODR数据重新导入进入。

1.   /* Set saved odr back */
   : c$ [. n$ N% x0 w' ?3 x
2.   ret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, odr);

复制代码

到此，sths34pf80_presence_threshold_set函数就已经执行完毕。

& C0 f8 f! }, m/ {+ l! ?
9 l* N" w! ^0 C1 _设置存在滞后
6 y( m3 a) c8 W: U' X& m  X这里使用的函数为sths34pf80_presence_hysteresis_set(STHS34PF80_ADDRESS, 20)。

1. /**
   + K6 j4 m3 i! h; U
2.   * @brief  Presence hysteresis.[set]
   
3.   *
   + Q$ J  n8 a7 d7 u9 b. G
4.   * @param  ctx      read / write interface definitions
   
5.   * @param  val      Presence hysteresis value
   - \2 z3 I+ r: X% s( p
6.   * @retval          interface status (MANDATORY: return 0 -> no Error)
   " q) E/ t) y5 ~. ?& D5 i# A4 D
7.   *
   ! _. _7 g; F/ j7 s! Z
8.   */
   
9. uint8_t sths34pf80_presence_hysteresis_set(uint8_t add, uint8_t val)
   $ C2 S! p  n" n
10. {
    
11.   sths34pf80_ctrl1_t ctrl1;
    
12.   uint8_t odr;
    
13.   int32_t ret;
    
14. 
    
15.   /* Save current odr and enter PD mode */
    
16.   ret = sths34pf80_read_reg(add, STHS34PF80_CTRL1, (uint8_t *)&ctrl1, 1);
    
17.   odr = ctrl1.odr;
    
18.   ret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, 0);
    
19. 
    
20.   ret += sths34pf80_func_cfg_write(add, STHS34PF80_HYST_PRESENCE, &val, 1);
    
21. 
    
22.   ret += sths34pf80_algo_reset(add);
    
23. 
    
24.   /* Set saved odr back */
    
25.   ret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, odr);
    
26. 
    
27.   return ret;
    5 r' B' ]7 R* f8 |
28. }

复制代码

% f6 |& b' c) z2 ]8 [: x" [, I最开始读取CTRL1（20h）的数据，同时进行保存到odr变量中。
9 {4 y* s" z8 B- k8 C7 I

1.   /* Save current odr and enter PD mode */
   
2.   ret = sths34pf80_read_reg(add, STHS34PF80_CTRL1, (uint8_t *)&ctrl1, 1);//STHS34PF80_CTRL1->0x20
   
3.   odr = ctrl1.odr;
   

复制代码

- o# m& t$ G5 I. ^9 g+ q& Qret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, 0)这行代码用于在设置存在阈值之前，通过调用 sths34pf80_tmos_odr_check_safe_set 函数来确保在设置新的参数之前传感器的状态是稳定且安全的。
  K6 X5 Y- F; }% R, j8 S8 A% k/ V! D
紧接着将传入的数据保存到val数组中，然后执行sths34pf80_func_cfg_write将val数据传入到HYST_PRESENCE (27h)中。

1.   ret += sths34pf80_func_cfg_write(add, STHS34PF80_HYST_PRESENCE, &val, 1);

复制代码

这个滞后值有助于避免在边界值附近产生频繁的状态切换。

默认值： 预设的滞后值默认值是 32（0x32）。

: R5 N( Y' ]+ ?$ G
3 w" @2 E! p, X2 a  G
例如，假设 PRESENCE_THS 设置为 200，而 HYST_PRESENCE 设置为 32。当测量值超过 200 时，传感器会认为存在某种状态。然后，要从存在状态切换到非存在状态，传感器必须降低测量值至少到达 200 - 32 = 168。只有当测量值降低到 168 以下时，传感器才会触发状态切换。

# V! [0 j0 @4 h! x, f0 |5 e通过设置适当的滞后值，可以防止在测量值在阈值附近波动时出现不必要的状态切换，从而提高存在检测的稳定性。

接着执行sths34pf80_algo_reset函数，该函数主要对RESET_ALGO (2Ah)的ALGO_ENABLE_RESET 置为位1，执行算法重置操作。
# E" p$ i, a9 o+ w; ~

1. ret += sths34pf80_algo_reset(add);

复制代码

接着执行sths34pf80_tmos_odr_check_safe_set，将刚刚保存的ODR数据重新导入进入。

1.   /* Set saved odr back */
   3 D0 g" j0 U9 D9 c# O
2.   ret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, odr);

复制代码

到此，sths34pf80_presence_hysteresis_set函数就已经执行完毕。
6 Z+ \0 P0 G- ^9 Z9 S4 O9 l9 V

7 B- t8 v/ U- M! c设置动作阈值
这里使用的函数为sths34pf80_motion_threshold_set(STHS34PF80_ADDRESS, 300)。

1. /**
   
2.   * @brief  Motion threshold.[set]
   
3.   *
   
4.   * @param  ctx      read / write interface definitions
   % i: l/ Z% K$ B" b! L8 v# G5 k# m
5.   * @param  val      motion threshold level
   
6.   * @retval          interface status (MANDATORY: return 0 -> no Error)
   
7.   *
   
8.   */
   $ E7 b5 c5 e: \3 O
9. uint8_t sths34pf80_motion_threshold_set(uint8_t add,  uint16_t val)
   
10. {
    
11.   sths34pf80_ctrl1_t ctrl1;
    
12.   uint8_t odr;
    8 I& ]0 f2 `) q  z
13.   uint8_t buff[2];
    
14.   int32_t ret;
    
15. 
    
16.   if ((val & 0x8000U) != 0x0U) {
    
17.     /* threshold values are on 15 bits */
    
18.     return -1;
    
19.   }
    
20. 
    
21.   /* Save current odr and enter PD mode */
    
22.   ret = sths34pf80_read_reg(add, STHS34PF80_CTRL1, (uint8_t *)&ctrl1, 1);
    
23.   odr = ctrl1.odr;
    / A+ D1 @" T: Z$ _7 W
24.   ret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, 0);
    
25. 
    ' Y, F. `: \9 q5 o5 o0 g
26.   buff[1] = (uint8_t)(val / 256U);
    , }4 Z( Z* u. [' {% Z. \
27.   buff[0] = (uint8_t)(val - (buff[1] * 256U));
    . X0 S7 ]: U# L4 @% @
28.   ret += sths34pf80_func_cfg_write(add, STHS34PF80_MOTION_THS, &buff[0], 2);
    
29. 
    
30.   ret += sths34pf80_algo_reset(add);
    + C! O4 @0 m' a1 h4 P
31. 
    , F! p* Q5 o0 W# h6 \
32.   /* Set saved odr back */
    & C0 @7 V3 ]9 ?- d) E9 j, z; m3 L. ^
33.   ret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, odr);
    
34. 
    * s; m8 N* C- |* N- v! s6 F( {
35.   return ret;
    
36. }

复制代码

- u' v' |! @( a5 k) w& |8 ?最开始读取CTRL1（20h）的数据，同时进行保存到odr变量中。

1.   /* Save current odr and enter PD mode */
   
2.   ret = sths34pf80_read_reg(add, STHS34PF80_CTRL1, (uint8_t *)&ctrl1, 1);
   
3.   odr = ctrl1.odr;
   

复制代码

ret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, 0)这行代码用于在设置存在阈值之前，通过调用 sths34pf80_tmos_odr_check_safe_set 函数来确保在设置新的参数之前传感器的状态是稳定且安全的。
! u8 x$ e( B; Q- f/ [9 H: @, |5 ~

1.   ret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, 0);

复制代码

, s  k6 N! f( [) r) I. Y6 `9 H接着将传入的数据保存到buff数组中，然后执行sths34pf80_func_cfg_write将buff数据传入到MOTION_THS (22h - 23h)中。

1.   buff[1] = (uint8_t)(val / 256U);
   
2.   buff[0] = (uint8_t)(val - (buff[1] * 256U));
   8 G. g" B5 i2 e4 p8 p/ M: K
3.   ret += sths34pf80_func_cfg_write(add, STHS34PF80_MOTION_THS, &buff[0], 2);
   5 B9 X- y8 b6 h3 S! N

复制代码

& d" X  C; W; hMOTION_THS 寄存器（地址范围为 0x22 到 0x23）用于设置运动检测算法的阈值。运动检测算法用于检测是否发生了物体的运动或动作。
9 h- k% i6 B( O* T/ q) K' t# O3 x* h
8 K0 v2 S( |/ p3 V, }' |以下是这个寄存器的作用：

运动阈值（Motion Threshold）： 这是一个用于运动检测算法的阈值。阈值定义了在测量数据中，何时认为发生了物体的运动或动作。阈值是一个 15 位的无符号整数，其取值范围在 0 到 32767 之间。

! @) W: D/ K  R/ W默认值： 预设的运动阈值默认值是 200（0x00C8）。
/ K7 O7 U1 ^7 Q2 C2 ]2 ^  u4 y
  K  ^1 R/ U. ^7 \1 t0 V8 V1 T8 E例如，如果 MOTION_THS 设置为 300，这意味着当传感器测量的某个特定值超过了 300，传感器会认为发生了运动或动作状态。
( [$ w# a- O* _
通过设置适当的运动阈值，可以根据应用需求来调整运动检测的敏感度。更高的阈值会导致较大的变化才能被视为运动，而较低的阈值则会使传感器更敏感，甚至可能在较小的变化时触发运动检测。
5 i2 h0 f, m0 Y; |  K" I


接着执行sths34pf80_algo_reset函数，该函数主要对RESET_ALGO (2Ah)的ALGO_ENABLE_RESET 置为位1，执行算法重置操作。
$ M. |) Z4 t# E# b! r

1. ret += sths34pf80_algo_reset(add);

复制代码

接着执行sths34pf80_tmos_odr_check_safe_set，将刚刚保存的ODR数据重新导入进入。

1.   /* Set saved odr back */
     o. R  l' l1 ~8 @
2.   ret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, odr);
   . T: Y. I4 ^0 \# M/ ~% F$ S
3. 
   + y0 G9 ?4 C' b/ p  N6 h

复制代码

到此，sths34pf80_motion_threshold_set函数就已经执行完毕。
# a  S4 _! W* a, K9 G7 z; W

设置动作滞后
这里使用的函数为sths34pf80_motion_hysteresis_set(STHS34PF80_ADDRESS, 30)。

1. /**
   
2.   * @brief  Motion hysteresis threshold.[set]
   
3.   *
   
4.   * @param  ctx      read / write interface definitions
   5 l2 G6 ^+ g  ^& x5 L1 ~
5.   * @param  val      Motion hysteresis value
   
6.   * @retval          interface status (MANDATORY: return 0 -> no Error)
   ) X1 n, H" `) c0 _. E! n9 @" b. p
7.   *
   9 n- p: z# u* M
8.   */
   
9. uint8_t sths34pf80_motion_hysteresis_set(uint8_t add, uint8_t val)
   $ I( p' q$ R  r: H/ b3 b0 X: i! `
10. {
    ) I% ^% q# ?- n* h8 g' r* Q  ~
11.   sths34pf80_ctrl1_t ctrl1;
    7 \7 s% P/ i+ y* E/ X
12.   uint8_t odr;
    
13.   int32_t ret;
    ; H+ T- F$ T- r6 x
14. 
    + M: ~+ U0 @$ G' m* [6 M' L  a
15.   /* Save current odr and enter PD mode */
    
16.   ret = sths34pf80_read_reg(add, STHS34PF80_CTRL1, (uint8_t *)&ctrl1, 1);
    
17.   odr = ctrl1.odr;
    
18.   ret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, 0);
    , S6 }7 u" [3 L; `4 i) p( e
19. 
    
20.   ret += sths34pf80_func_cfg_write(add, STHS34PF80_HYST_MOTION, &val, 1);
    ( n& u0 _% h! w% g
21. 
    # G0 c, U. P8 k8 V
22.   ret += sths34pf80_algo_reset(add);
    
23. 
    # s; K0 ?. \! A5 C& g
24.   /* Set saved odr back */
    
25.   ret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, odr);
    
26. 
    
27.   return ret;
    
28. }

复制代码

" ?- y0 p9 ~/ M3 A5 X最开始读取CTRL1（20h）的数据，同时进行保存到odr变量中。

1.   /* Save current odr and enter PD mode */
   5 ]/ B7 X2 O5 P8 H- G! D
2.   ret = sths34pf80_read_reg(add, STHS34PF80_CTRL1, (uint8_t *)&ctrl1, 1);//STHS34PF80_CTRL1->0x20
   / ?+ c1 {3 k$ Y& A5 G9 P. q% N4 F" j" s
3.   odr = ctrl1.odr;

复制代码

6 ^4 J. ?, F) w9 s1 hret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, 0)这行代码用于在设置存在阈值之前，通过调用 sths34pf80_tmos_odr_check_safe_set 函数来确保在设置新的参数之前传感器的状态是稳定且安全的。
2 H9 f! z. `$ k) C2 d- N
: O/ v8 f+ n/ |紧接着将传入的数据保存到val数组中，然后执行sths34pf80_func_cfg_write将val数据传入到HYST_MOTION (26h)中。
& `5 T* c4 I4 _5 ]

1.   ret += sths34pf80_func_cfg_write(add, STHS34PF80_HYST_MOTION, &val, 1);

复制代码

在运动检测算法中，滞后指的是当从运动状态切换到静止状态时，需要等待的时间或条件，以防止在短时间内频繁地切换状态。

7 D, V& O' r- S0 b0 v, `0 T: v默认值： 预设的滞后值默认值是 32（0x32）。


. e- g; e9 J: c( ^' s- x2 Z
例如，如果 MOTION_THS 设置为 300，而 HYST_MOTION 设置为 32。当测量值超过 300 时，传感器会认为发生了运动。然后，要从运动状态切换到非运动状态，传感器必须降低测量值至少到达 300 - 32 = 268。只有当测量值降低到 268 以下时，传感器才会触发状态切换。
" @2 r% W7 o* ^8 e  g! h# ^
通过设置适当的运动滞后值，可以避免在测量值在运动状态附近波动时产生不必要的状态切换，从而提高运动检测的稳定性。这类似于存在检测中的概念，但针对的是运动状态。

$ D: f5 ^# K& K* B/ Q& o2 F( o接着执行sths34pf80_algo_reset函数，该函数主要对RESET_ALGO (2Ah)的ALGO_ENABLE_RESET 置为位1，执行算法重置操作。

& i  X& }* ~! O% `

1. ret += sths34pf80_algo_reset(add);

复制代码

! }0 N3 _7 P$ e% ^' {" {; E接着执行sths34pf80_tmos_odr_check_safe_set，将刚刚保存的ODR数据重新导入进入。
1 D4 ^# }; R% k) Z- z0 W- }

1.   /* Set saved odr back */
   
2.   ret += sths34pf80_tmos_odr_check_safe_set(add, ctrl1, odr);
   

复制代码

1 ?6 P8 g7 l# Z! p- E: m到此，sths34pf80_motion_hysteresis_set函数就已经执行完毕。

7 M: e# B$ k. L$ ~7 Y! X2 k主程序
初始化如下。

1.   /* USER CODE BEGIN 2 */
   
2.   sths34pf80_lpf_bandwidth_t lpf_m, lpf_p, lpf_p_m, lpf_a_t;  
   
3.   sths34pf80_tmos_drdy_status_t status;  
   - }% N- C* c) `3 N, g
4.   sths34pf80_tmos_func_status_t func_status;   
   & S& m& D5 r! Z8 A1 O
5.   
   
6.   HAL_Delay(200);  
   
7.   printf("123");
   
8.   uint8_t STHS34PF80_ID =STHS34PF80_getChipID(STHS34PF80_ADDRESS);
   
9.   printf("STHS34PF80_ID=0x%x\n",STHS34PF80_ID);  
   9 ?0 Y9 y# A$ X% u' b- y: I
10.   if (STHS34PF80_ID != 0xD3)
    % T9 `" J* h6 a6 y: \9 S
11.     while(1);
      R8 S1 w1 R" C& Z) ?% i4 r# T
12. /* Set averages (AVG_TAMB = 8, AVG_TMOS = 32) */
    
13.   sths34pf80_avg_tobject_num_set(STHS34PF80_ADDRESS, STHS34PF80_AVG_TMOS_32);
    ; D0 t: I* i8 z, R7 b7 Q
14.   sths34pf80_avg_tambient_num_set(STHS34PF80_ADDRESS, STHS34PF80_AVG_T_8);
    + g% D- }4 s, J' v5 Z$ |2 Z/ N5 b4 T
15. 
    
16.   /* read filters */
    
17.   sths34pf80_lpf_m_bandwidth_get(STHS34PF80_ADDRESS, &lpf_m);
    
18.   sths34pf80_lpf_p_bandwidth_get(STHS34PF80_ADDRESS, &lpf_p);
    7 z/ c; H, N; x- q0 }0 r' H; B
19.   sths34pf80_lpf_p_m_bandwidth_get(STHS34PF80_ADDRESS, &lpf_p_m);
    , ]% w3 r5 m( ^8 r+ Y) p0 ~, Y
20.   sths34pf80_lpf_a_t_bandwidth_get(STHS34PF80_ADDRESS, &lpf_a_t);
    ) ]  t; a9 N+ ], a4 E
21. 
    + T" Z+ [( n: w
22. printf("lpf_m: %02d, lpf_p: %02d, lpf_p_m: %02d, lpf_a_t: %02d\r\n", lpf_m, lpf_p, lpf_p_m, lpf_a_t);
    & L- l4 A! X, X: p
23.   
    
24.     /* Set BDU */
    1 z) s! V! [1 e# a5 b4 j; ^# {+ P, N+ z
25.   sths34pf80_block_data_update_set(STHS34PF80_ADDRESS, 1);
    5 J( p3 H0 B1 d$ d: O$ Y
26.   
    / b! [, @7 ?( M7 w- ^6 c. g2 p
27.   sths34pf80_presence_threshold_set(STHS34PF80_ADDRESS, 300);  //设置存在阈值。
    " e; @" S, R; p8 S, U: F, U
28.   sths34pf80_presence_hysteresis_set(STHS34PF80_ADDRESS, 20);//“存在滞后”（Presence Hysteresis）的函数
    
29.   sths34pf80_motion_threshold_set(STHS34PF80_ADDRESS, 300);//设置动作阈值
    ' y3 }- I' l2 _- T1 m8 f7 k
30.   sths34pf80_motion_hysteresis_set(STHS34PF80_ADDRESS, 30);  动作滞后”（Motion Hysteresis）的函数
    ' T" @. M2 d+ r% E! o+ s  H) V
31.   /* Set ODR */
    
32.   sths34pf80_tmos_odr_set(STHS34PF80_ADDRESS, STHS34PF80_TMOS_ODR_AT_30Hz);
    
33. 
    ! q- b2 ~1 o3 {
34.     int32_t cnt = 0;
    2 J- ^: f0 O, \- }" z8 I
35.   
    % `/ _1 u4 D6 `2 `  A0 G6 h2 g$ t
36.   /* USER CODE END 2 */

复制代码

' t4 n) F  k! z8 n4 Cmain函数如下所示。

1.   /* Infinite loop */
   
2.   /* USER CODE BEGIN WHILE */
   ' D: N5 R0 R- o. H% X& l1 m- P
3.   while (1)
   
4.   {
   
5.     sths34pf80_tmos_drdy_status_get(STHS34PF80_ADDRESS, &status);
   * K- T: g' B2 V9 a# C2 {
6.     if (status.drdy)
   8 T7 V) G- f  @6 I
7.     {
   + A, V! x; n* L- m$ _8 b0 \
8.       sths34pf80_tmos_func_status_get(STHS34PF80_ADDRESS, &func_status);
   % Y. V+ W/ }( C$ _* L5 [7 ?
9.       printf("-->环境温度冲击检测标志位 %d - 存在检测标志位 %d - 运动检测标志位 %d\r\n",func_status.tamb_shock_flag, func_status.pres_flag, func_status.mot_flag);
   
10.    }
    
11.       HAL_Delay(1000);
    
12. 
    
13.     /* USER CODE END WHILE */
    & z; \  @: m3 F3 z; k* X9 m/ F/ n
14. 
    . m$ _7 d6 i+ S& m$ {7 p# \
15.     /* USER CODE BEGIN 3 */
    * H, Q- H2 `7 s/ o# d% y
16.   }
    $ m- ]6 _) x, {# z
17.   /* USER CODE END 3 */
    8 P( {$ j# }9 G0 p/ u6 k/ n2 m% @2 I

复制代码

5 R7 t1 j7 \* W" v  Q6 m转载自：记帖
如有侵权请联系删除

1 b1 }9 Y8 I; V2 U. N: a& V9 k2 x