套件概述
) K) W; L( d/ @2 \7 E( SSTHS34PF80 是一款非冷却、工厂校准的红外运动和存在检测传感器，工作波长在 5 µm 至 20 µm 之间。STHS34PF80 传感器设计用于测量视野内物体发出的红外辐射量。该信息由 ASIC 进行数字处理，可以对其进行编程以监控运动、存在或过热状况。
1 V8 P2 o+ @9 @4 E" M' ~2 I# x
本章主要驱动STHS34PF80，进行人体检测。
4 r7 {4 t/ v& I* u/ x8 w. J! J



) |& K! x, U, T" |5 R, s  v引导
# |3 K/ }3 \9 X/ W( o& J在设备上电后，它会执行一个2.5毫秒的引导过程，将校准系数从嵌入式闪存下载到内部寄存器，并加载AVG_TRIM（10h）、CTRL0（17h）和SENS_DATA（1Dh）寄存器的默认内容。在引导时间内，设备的寄存器不可访问。
% Z" a  g& ]4 J' V8 t
' h4 m0 m( g& G" x; a7 j* ?9 S2 G引导完成后，设备会自动配置为电源关闭模式。

在上电后，可以通过将CTRL2（21h）寄存器的BOOT位设置为1，重新启动引导过程，以重新加载上述寄存器的默认值。不需要切换设备电源线。
& c3 Q% x/ J/ ]8 U
' J8 `% d1 w3 r7 T4 c4 p& p在重新启动时间内，设备的寄存器不可访问。重新启动完成后，设备会自动配置为之前的操作模式，并且BOOT位会自动清除为0。
) m8 e$ n( ?- w2 M$ w% A) @
$ S3 ]# j. A' @& T
1 c* o0 }' u: z: j1 ]
) E/ k4 ]9 U7 }: ^: S6 b
温度测量滤波方式
1 {6 X: d' L$ ]4 r+ g* c, Z/ M首先需要设置AVG_TRIM (10h) 寄存器用于配置温度平均值滤波的参数，以控制环境温度和目标温度测量的平滑度和稳定性。在温度测量中，可能会受到噪声和干扰的影响，这可能导致短期内测量值的波动。通过应用平均值滤波，可以平滑这些波动，从而得到更加稳定的温度数据。AVG_TRIM 寄存器中的设置会决定平均值滤波的级别，从而影响滤波的时间常数以及平滑度。

这里默认参数如下
5 m2 M3 F+ S6 r  l在AVG_TRIM（10h）寄存器中写入02h // AVG_T = 8，AVG_TMOS = 32
, f( h! {# J$ O" Y7 W在CTRL1（20h）寄存器中写入07h // ODR = 15 Hz
" `. E: O: D- [- D0 J

6 c! m& J. j( r

- Y. E4 f1 W) a: S! AAVG_T[1:0]: 这个设置位用于选择环境温度的平均值滤波样本数。
AVG_TMOS[2:0]: 这个设置位用于选择目标温度的平均值滤波样本数以及与之相关的噪声水平。
9 w& Z) E1 p9 d( E8 O& L
' F# `$ t$ P) D$ S1 u4 u$ w1 H
# d, w9 v7 _: E8 l# i( T, g* `

参考demo中将AVG_TMOS [2:0] 和AVG_T[1:0] 分为了2个函数进行操作。

  e3 z( _0 J' s. K5 F


  `9 C; e' i; t- @8 D
修改后操作如下所示。

1. /**
   ; G2 ~" l2 \. a' x1 l; Y
2.   * @brief  Select number of averages for object temperature.[set]
   5 @  P- v5 R9 a+ }7 }& p
3.   *
   ( A  r6 M$ F+ r' W& z; I5 o; n8 T
4.   * @param  ctx      read / write interface definitions
   
5.   * @param  val      AVG_TMOS_2, AVG_TMOS_8, AVG_TMOS_32, AVG_TMOS_128, AVG_TMOS_256, AVG_TMOS_512, AVG_TMOS_1024, AVG_TMOS_2048,
   
6.   * @retval          interface status (MANDATORY: return 0 -> no Error)
   & P- \4 H/ v, C1 _" S& ]
7.   *
   5 P, G9 n3 E* Z! B# B& u
8.   */
   , l/ Y1 L8 X& }9 j0 }
9. uint8_t sths34pf80_avg_tobject_num_set(uint8_t add, sths34pf80_avg_tobject_num_t val)
   5 D% R7 N* t3 i- I& D
10. {
    $ J+ B7 d3 L& m- t; C
11.   sths34pf80_avg_trim_t avg_trim;
    0 ]; N, u6 J0 B, d* B
12.   int32_t ret;
    
13.   ret = sths34pf80_read_reg(add, STHS34PF80_AVG_TRIM, (uint8_t *)&avg_trim, 1);
    0 N: X8 l+ e2 S
14. 
    4 t9 r: ~  C! h8 x( W
15.   if (ret == HAL_OK)
    
16.   {
    
17.     avg_trim.avg_tmos = ((uint8_t)val & 0x7U);
    
18.     ret = sths34pf80_write_reg(add, STHS34PF80_AVG_TRIM, (uint8_t *)&avg_trim, 1);
    4 M/ |7 w1 F& O5 N
19.   }
    
20. 
    8 M  f/ r( S/ _' ~
21.   return ret;
    
22. }
    
23. /**
    
24.   * @brief  Select number of averages for ambient temperature.[set]
    
25.   *
    
26.   * @param  ctx      read / write interface definitions
    
27.   * @param  val      AVG_T_8, AVG_T_4, AVG_T_2, AVG_T_1,
    ; g. Q: a: S* Y& J# r$ v. z, e
28.   * @retval          interface status (MANDATORY: return 0 -> no Error)
    
29.   *
    $ |0 k' V$ C0 [3 e
30.   */
    * l4 F* \" {: V% d5 r9 k2 {& l
31. uint8_t sths34pf80_avg_tambient_num_set(uint8_t add, sths34pf80_avg_tambient_num_t val)
    9 j1 r( R6 S4 o# [7 \
32. {
    " g+ q( b+ C" |4 M/ s
33.   sths34pf80_avg_trim_t avg_trim;
    
34.   int32_t ret;
    
35.   ret = sths34pf80_read_reg(add, STHS34PF80_AVG_TRIM, (uint8_t *)&avg_trim, 1);
    - Y' H3 {6 P1 ?' k- K
36.   if (ret == HAL_OK)
    
37.   {
    ) r& T! U  N/ ]$ J4 J6 J) h& l
38.     avg_trim.avg_t = ((uint8_t)val & 0x3U);
    ; ]3 t# x/ L3 e5 B
39.     ret = sths34pf80_write_reg(add, STHS34PF80_AVG_TRIM, (uint8_t *)&avg_trim, 1);   
    ( e* ?& K1 }2 J( o
40.   }   
    
41. 
    
42. 
    0 w+ n# t2 {6 q) T+ Z
43.   return ret;
    % E4 G! G2 U' ^6 o" h+ q- g9 C5 @
44. }
    

复制代码

, @% `& i7 {6 c3 a- V; g9 i使用如下所示，这里设置参数为STHS34PF80_AVG_TMOS_32和STHS34PF80_AVG_T_8。

1. /* Set averages (AVG_TAMB = 8, AVG_TMOS = 32) */
   4 H8 g% e) ?0 {! q. o: n- X
2.   sths34pf80_avg_tobject_num_set(STHS34PF80_ADDRESS, STHS34PF80_AVG_TMOS_32);
   4 w5 t3 y! U! ^& G8 }0 z, [
3.   sths34pf80_avg_tambient_num_set(STHS34PF80_ADDRESS, STHS34PF80_AVG_T_8);

复制代码

智能识别算法
( R. R. r1 ]% h# mSTHS34PF80嵌入了智能数字算法，以支持以下三种检测模式：
• 存在检测
# O, z$ j, k0 q; Z( e• 运动检测
$ u. _2 E% Q. V• 环境温度冲击检测
3 ~% i6 O* i- h; A2 R# j
这些算法分别使用不同的低通滤波器（LPF_P、LPF_M和LPF_A_T）。此外，存在和运动检测算法使用另一个共同的低通滤波器（LPF_P_M）。这些滤波器用于生成中间信号（TPRESENCE、TMOTION和TAMB_SHOCK），可以用于对算法本身进行微调。这些滤波器的截止频率值可以通过它们各自的位范围进行配置，这些位范围可以在LPF1（0Ch）和LPF2（0Dh）寄存器中找到，如下所示。
& n: o5 O3 x5 q$ d

  |+ j- V5 A$ B4 C3 t& [
寄存器LPF1 (0Ch)和LPF2 (0Dh)如下所示。
5 Z$ M9 t1 b3 D$ W0 A$ u$ _


+ c! B/ ^( ~2 G案例中只是对滤波器进行了读取以及打印。
) A5 n! E  y9 x5 j1 ]
' r9 E- }8 ?; I; `7 m4 [0 }
. Q3 }* d% K% B( e$ F
# ]8 X* F2 T1 w+ K, {) S. A修改后如下所示。

1. 
   ; }( V& j7 u9 }* t/ _% E# e

复制代码

1 T. k9 }" w0 k7 E1 a使用块数据更新（BDU）功能
$ M8 h: ?4 D% L% Z" @如果读取输出数据的时机与数据准备信号不同步，强烈建议在CTRL1（20h）寄存器中将BDU（块数据更新）位设置为1。
4 a! ?' {1 o: \7 e2 x2 S6 _$ k
+ }9 k! u4 `1 G$ F$ \/ m5 \& H此功能可以避免读取与不同采样相关的寄存器值（输出数据的最高和最低字节）。


  f2 q4 e! S$ l
, [3 B: n2 g( `0 y$ o7 z案例也是设置了BDU。
0 ~- O% K2 m+ |* A) m- X
+ ^' ]& W; q9 _2 B+ D+ m6 W  t% f

% ?  I( F' Y8 b; X  m8 D% XBDU在CTRL1 (20h)寄存器中。



, D' h# ?7 ^. V4 y# @" R# e9 B$ r修改后的操作如下所示。

1.     /* Set BDU */
   0 L4 w- s  s+ R- X
2.   sths34pf80_block_data_update_set(STHS34PF80_ADDRESS, 1);

复制代码

设置ODR速率
初始化完毕之后需要通过CTRL1（20h）寄存器中的ODR[3:0]位范围选择其中一种操作模式（连续模式），或者在CTRL2（21h）寄存器中将ONE_SHOT位设置为1（单次触发模式）。
8 x" U; M3 c& G/ b, R. ^
3 j9 _4 z7 }3 G3 @( V

当配置了寄存器LPF1 (0Ch)和LPF2 (0Dh) 的LPF_P、LPF_M和LPF_A_T、LPF_P_M滤波器之后，可以去设置ODR速率。
  O9 C' A8 W4 p: @* ], ^
  n" X9 j8 }. v
9 _( u7 g- z6 m8 G  H, d: M
这里设置速率为30HZ。
' v, v: A. X* A& h. h1 B

1. /* Set ODR */
   5 D$ p8 f2 y6 A* k$ Z+ g5 V
2.   sths34pf80_tmos_odr_set(STHS34PF80_ADDRESS, STHS34PF80_TMOS_ODR_AT_30Hz);

复制代码

+ V5 B1 A, P0 P! Y  ?状态寄存器
初始化完毕之后，可以通过状态寄存器STATUS (23h)获取DRDY标志位。数据就绪信号由STATUS寄存器的DRDY位表示。当新的数据可用时，此位被设置为1，并在读取FUNC_STATUS（25h）寄存器后被清除。

1 {0 a$ @* a# o3 |( |, ^+ S
7 K- |! v. b. ^
0 d6 G! S9 n# U) F3 g" S' d0 {' G主程序中会去获取改状态位，若为1，则代表数据已经准备完毕，可以进行获取和打印。



FUNC_STATUS（25h）主要检测三个标志位：PRES_FLAG、MOT_FLAG 和 TAMB_SHOCK_FLAG，这些标志位用于检测不同类型的事件。
9 R. p3 f# G& x
5 }/ O2 K; x. gPRES_FLAG是存在检测标志位。当存在检测到人员存在时，此位变为1。
0 K- _- B- K( U) q* ^( G% M
- x; m! P5 X! mMOT_FLAG：运动检测标志位。当检测到运动时，此位变为1。

: m2 h. D# d. f" R6 `TAMB_SHOCK_FLAG：环境温度冲击检测标志位。当检测到环境温度冲击时，此位变为1。



' l  Q9 g$ s' u& F修改完毕主程序如下所示。

1.   /* Infinite loop */
   
2.   /* USER CODE BEGIN WHILE */
   
3.   while (1)
   % N, G2 G7 N# h
4.   {
   
5.     sths34pf80_tmos_drdy_status_get(STHS34PF80_ADDRESS, &status);
   
6.     if (status.drdy)
   ) }/ B: }4 o1 t. b3 z) a$ M
7.     {
   % r$ i  f; a: t) `
8.       sths34pf80_tmos_func_status_get(STHS34PF80_ADDRESS, &func_status);
   
9.       printf("-->环境温度冲击检测标志位 %d - 存在检测标志位 %d - 运动检测标志位 %d\r\n",func_status.tamb_shock_flag, func_status.pres_flag, func_status.mot_flag);
   
10.    }
    8 l; l) Y( y7 w+ n: O
11.       HAL_Delay(1000);
    
12. 
    
13.     /* USER CODE END WHILE */
    
14. 
    - c, [  W) K2 u
15.     /* USER CODE BEGIN 3 */
    
16.   }
    
17.   /* USER CODE END 3 */
    - ~) s) V5 X, P- d+ Y# J+ W6 X8 h

复制代码

- c1 ^! Q* p. ?6 \5 ^main.c
2 M9 |7 E. W% J% X% M  H" _9 q

1.   /* USER CODE BEGIN 2 */
   6 J- d  E4 }4 ^; T& k# N# z
2.   sths34pf80_lpf_bandwidth_t lpf_m, lpf_p, lpf_p_m, lpf_a_t;  
   $ ^( W6 R! u; ~  e7 q
3.   sths34pf80_tmos_drdy_status_t status;  
   % \; N  [/ X9 T
4.   sths34pf80_tmos_func_status_t func_status;  
   5 q. Y! S8 g! Y& |# x4 F
5.   
   
6.   
   
7.   
   3 G. x0 A- A9 y8 ]8 w
8.   
   
9.       HAL_Delay(200);  
   - {* R: {3 F% k) u% b, ?$ P
10.   printf("123");
    
11.   uint8_t STHS34PF80_ID =STHS34PF80_getChipID(STHS34PF80_ADDRESS);
    : p1 p3 b8 `! e9 c* U' P: `( i
12.   printf("STHS34PF80_ID=0x%x\n",STHS34PF80_ID);  
    ' f% B; `4 C& Z  {3 x+ P
13.   if (STHS34PF80_ID != 0xD3)
    / N# N& D( e8 ?( V( ^* t0 ?$ V
14.     while(1);
    $ a0 W! ?/ h8 j1 l! R
15. /* Set averages (AVG_TAMB = 8, AVG_TMOS = 32) */
    
16.   sths34pf80_avg_tobject_num_set(STHS34PF80_ADDRESS, STHS34PF80_AVG_TMOS_2048);
    8 t5 z/ ]/ I3 \$ T
17.   sths34pf80_avg_tambient_num_set(STHS34PF80_ADDRESS, STHS34PF80_AVG_T_8);
    
18. 
    ; S; J4 Y, B/ ?7 l
19.   /* read filters */
    
20.   sths34pf80_lpf_m_bandwidth_get(STHS34PF80_ADDRESS, &lpf_m);
    1 E+ x# W3 l0 ~  r7 s  o0 V: V
21.   sths34pf80_lpf_p_bandwidth_get(STHS34PF80_ADDRESS, &lpf_p);
    " V( P4 E9 B7 U8 F
22.   sths34pf80_lpf_p_m_bandwidth_get(STHS34PF80_ADDRESS, &lpf_p_m);
    6 O3 R4 g1 C8 o7 `& T
23.   sths34pf80_lpf_a_t_bandwidth_get(STHS34PF80_ADDRESS, &lpf_a_t);
    % c: N1 L$ c5 `7 C
24. 
    
25. 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);
    ! X: D5 U1 g$ K2 N/ T3 \
26.   
    1 h9 C  c$ V! |! |1 T8 Z9 W2 ], h
27.     /* Set BDU */
    1 c- K: f$ `8 U6 H
28.   sths34pf80_block_data_update_set(STHS34PF80_ADDRESS, 1);
    
29. 
    1 \6 J3 S4 @. D' d
30.   /* Set ODR */
    
31.   sths34pf80_tmos_odr_set(STHS34PF80_ADDRESS, STHS34PF80_TMOS_ODR_AT_1Hz);
    
32. 
    
33.     int32_t cnt = 0;
    3 g! l" l7 Z3 n: k
34.   
    ' H# B  ]( A5 P$ Y' V7 {3 {
35.   /* USER CODE END 2 */
    5 l/ K0 r/ ]- U: }. s: h* V/ N
36. 
    
37.   /* Infinite loop */
    
38.   /* USER CODE BEGIN WHILE */
    
39.   while (1)
    8 l$ b: |; u/ E0 C, w8 y7 _
40.   {
    1 S2 J- a4 Y. W1 t, \- Z0 z6 P" G# X
41.     sths34pf80_tmos_drdy_status_get(STHS34PF80_ADDRESS, &status);
      F: ]& r; S) v
42.     if (status.drdy)
    
43.     {
    $ c4 A  f( m1 [. S. N& L8 d
44.       sths34pf80_tmos_func_status_get(STHS34PF80_ADDRESS, &func_status);
    
45.       printf("-->环境温度冲击检测标志位 %d - 存在检测标志位 %d - 运动检测标志位 %d\r\n",func_status.tamb_shock_flag, func_status.pres_flag, func_status.mot_flag);
    9 ^( P0 A$ }* e8 Y1 {! y$ g2 _
46.    }
    
47.       HAL_Delay(1000);
    7 Q8 n0 R1 l8 O$ J6 A# f# U
48. 
    
49.     /* USER CODE END WHILE */
    & x* y- T7 x" C9 L
50. 
    
51.     /* USER CODE BEGIN 3 */
    
52.   }
    * W) t3 \% _5 w( W/ q2 @+ N$ O0 r
53.   /* USER CODE END 3 */
    ( Q" s1 B; V( K7 Y' ?- f$ I4 N) N0 \! C2 _

复制代码

* p& M" g$ Y% @' F" R( [转载自：记帖
如有侵权请联系删除


( e2 K- P3 ]9 a5 `
  U. G% n9 n5 q5 U- B! c