光敏传感器实验
1 \4 Y* D; ]: [) A本章，我们将学习使用MiniPRO STM32H750开发板板载的一个光敏传感器。我们还是要使用到ADC采集，通过ADC采集电压，获取光敏传感器的电阻变化，从而得出环境光线的变化，并在TFTLCD上面显示出来。
' a. n* O( M  k  h) r& o1 ^  R! E/ B
33.1 光敏传感器简介
光敏传感器是最常见的传感器之一，它的种类繁多，主要有：光电管、光电倍增管、光敏电阻、光敏三极管、太阳能电池、红外线传感器、紫外线传感器、光纤式光电传感器、色彩传感器、CCD和CMOS图像传感器等。光传感器是目前产量最多、应用最广的传感器之一，它在自动控制和非电量电测技术中占有非常重要的地位。
5 [; j; J7 P' b1 W) K$ _4 n光敏传感器是利用光敏元件将光信号转换为电信号的传感器，它的敏感波长在可见光波长附近，包括红外线波长和紫外线波长。光传感器不只局限于对光的探测，它还可以作为探测元件组成其它传感器，对许多非电量进行检测，只要将这些非电量转换为光信号的变化即可。
MiniPRO STM32H750开发板板载了一个光敏二极管（光敏电阻），作为光敏传感器，它对光的变化非常敏感。光敏二极管也叫光电二极管。光敏二极管与半导体二极管在结构上是类似的，其管芯是一个具有光敏特征的PN结，具有单向导电性，因此工作时需加上反向电压。无光照时，有很小的饱和反向漏电流，即暗电流，此时光敏二极管截止。当受到光照时，饱和反向漏电流大大增加，形成光电流，它随入射光强度的变化而变化。当光线照射PN结时，可以使PN结中产生电子一空穴对，使少数载流子的密度增加。这些载流子在反向电压下漂移，使反向电流增加。因此可以利用光照强弱来改变电路中的电流。
利用这个电流变化，我们串接一个电阻，就可以转换成电压的变化，从而通过ADC读取电压值，判断外部光线的强弱。
本实验利用ADC3的通道11（PC1）来读取光敏二极管电压的变化，从而得到环境光线的变化，并将得到的光线强度，显示在TFTLCD上面。关于ADC的介绍，前面已经有详细介绍了，这里我们就不再细说了。
33.2 硬件设计
. O# @6 F! V/ G1 \0 r8 }& e1.例程功能
通过ADC3的通道11（PC1）读取光敏传感器（LS1）的电压值，并转换为0~100的光线强度值，显示在LCD模块上面。光线越亮，值越大；光线越暗，值越小。大家可以用手指遮挡LS1和用手电筒照射LS1，来查看光强变化。LED0闪烁用于提示程序正在运行。
2.硬件资源
+ x4 o- ?" j, R+ E5 B7 D1）RGB灯
RED : LED0 - PB4
8 |# i3 x3 i, Q, e0 ?+ X2）串口1(PA9/PA10连接在板载USB转串口芯片CH340上面)
  Y* @: {( i( Q# n3）正点原子2.8/3.5/4.3/7/10寸TFTLCD模块(仅限MCU屏，16位8080并口驱动)
, U3 B2 I/ E) n4）ADC3 ：通道11 - PC1
% Q; L( S8 g4 i: q5）光敏传感器 - PC1
8 p7 V7 G6 |% R+ y* R3.原理图
我们主要来看看光敏传感器和开发板的连接，如下图所示：
. [' I4 v# t* }. q) A
) m5 U; j: z9 x; }, j$ F

/ I8 d5 ?. I4 z1 q. P9 F; H图33.2.1 光敏传感器与开发板连接示意图
图中，LS1是光敏二极管（实物在开发板5V排针（VOUT2）上面），R28为其提供反向电压，当环境光线变化时，LS1两端的电压也会随之改变，从而通过ADC3_IN11通道，读取LIGHT_SENSOR（PC1）上面的电压，即可得到环境光线的强弱。光线越强，电压越低，光线越暗，电压越高。

33.3 程序设计
33.3.1 ADC的HAL库驱动
0 t! Y, j1 H- U  N本实验用到的ADC的HAL库API函数前面都介绍过，具体调用情况请看程序解析部分。下面介绍读取光敏传感器ADC值的配置步骤。
3 J* V/ T  h2 u& p2 T2 _读取光敏传感器ADC值配置步骤
1）开启ADCx和ADC通道对应的IO时钟，并配置该IO为模拟功能
7 S* m; y2 R4 t' P( W0 M首先开启ADCx的时钟，然后配置GPIO为模拟模式。本实验我们默认用到ADC3通道11，对应IO是PC1，它们的时钟开启方法如下：
__HAL_RCC_ADC3_CLK_ENABLE (); /* 使能ADC3时钟 /
__HAL_RCC_GPIOC_CLK_ENABLE(); / 开启GPIOC时钟 */
6 F# u- m) H' ]5 X) O# \. U7 P; ~2）设置ADC3，开启内部温度传感器
调用HAL_ADC_Init函数来设置ADC3时钟分频系数、分辨率、模式、扫描方式、对齐方式等信息。
注意：该函数会调用：HAL_ADC_MspInit回调函数来完成对ADC底层的初始化，包括：ADC3时钟使能、ADC3时钟源的选择等。
3）配置ADC通道并启动AD转换器
" r' ?: K0 M) B1 y2 P调用HAL_ADC_ConfigChannel()函数配置ADC3通道11，根据需求设置通道、序列、采样时间和校准配置单端输入模式或差分输入模式等。然后通过HAL_ADC_Start函数启动AD转换器。
% Y3 y( N7 Y7 E! R( @3 M) O/ z4）读取ADC值，转换为光线强度值
这里选择查询方式读取，在读取ADC值之前需要调用HAL_ADC_PollForConversion等待上一次转换结束。然后就可以通过HAL_ADC_GetValue来读取ADC值。最后把得到的ADC值转换为0~100的光线强度值。
33.3.2 程序流程图
8 H$ z% T* w* G2 ]+ f0 u8 s

3 }/ w: b! B# P" f' h% o  N
, {: E2 A$ Y7 z图33.3.2.1 光敏传感器实验程序流程图

+ f3 o- }% v5 Q9 q( R6 }& r+ |33.3.3 程序解析
1.LSENS驱动代码
+ g! c, y" H4 Q  L这里我们只讲解核心代码，详细的源码请大家参考光盘本实验对应源码。LSENS驱动源码包括两个文件：lsens.c和lsens.h。本实验还要用到adc3.c和adc3.h文件的驱动代码。adc3.c和adc3.h文件前面已经介绍过了，就不再赘述。
lsens.h头文件定义了一些宏定义和一些函数的声明，该宏定义如下：
6 h0 M, w! n& I3 l

1. /*****************************************************************************/
   
2. /* 光敏传感器对应ADC3的输入引脚和通道 定义 */
   / r: G4 V; q& W3 Y
3. #define LSENS_ADC3_CHX_GPIO_PORT            GPIOC
   # I, i  [  Y! c' Y
4. #define LSENS_ADC3_CHX_GPIO_PIN             GPIO_PIN_1
   
5. #define LSENS_ADC3_CHX_GPIO_CLK_ENABLE()   
   
6. do{ __HAL_RCC_GPIOC_CLK_ENABLE(); }while(0)  /* PC口时钟使能 */
   
7. #define LSENS_ADC3_CHX           ADC_CHANNEL_11         /* 通道Y,  0 <= Y <= 19 */
   
8. /*****************************************************************************/
   
9. 这些宏定义分别是PC1及其时钟使能的宏定义，还有ADC通道11的宏定义。
   
10. 下面介绍lsens.c的函数，首先是光敏传感器初始化函数，其定义如下：
    6 u& Y8 X& ?! G9 U9 B
11. /**
    ; |( N' ^6 L$ Z2 L$ X1 x
12. * @brief       初始化光敏传感器
    
13. * @param       无
    
14. * @retval      无
    
15. */
    
16. void lsens_init(void)
    
17. {
    
18.     GPIO_InitTypeDef gpio_init_struct;
    ( o3 p% r  G$ E: x
19.     LSENS_ADC3_CHX_GPIO_CLK_ENABLE ();                            /* 使能对应IO时钟 */
    ! X- N# a. v8 Y
20.     gpio_init_struct.Pin = LSENS_ADC3_CHX_GPIO_PIN;         /* PC1 */
    
21.     gpio_init_struct.Mode = GPIO_MODE_ANALOG;                /* 模拟 */
      a/ R% A! {# k/ p  \" [
22.     HAL_GPIO_Init(LSENS_ADC3_CHX_GPIO_PORT, &gpio_init_struct);
    
23.     adc3_init();    /* 初始化ADC3 */
    
24. }

复制代码

. k6 {' y! H! \; }该函数初始化PC1为模拟功能，然后通过adc3_init函数初始化ADC3。
9 w* N# ]8 K8 C* G( A* j最后是读取光敏传感器值，函数定义如下：
/ T, O4 b; W6 l& T8 F  Y8 n
4 g2 f. S) v4 H- P

1. /**
   
2. * @brief       读取光敏传感器值
   
3. * @param       无
   $ h( v% z, F+ i- }! Y
4. * @retval      0~100:0,最暗;100,最亮
   , Z; u& z6 D* O) |- d1 G
5. */
   
6. uint8_t lsens_get_val(void)
   7 f  o4 @' K# Z7 w& Y% I
7. {
   4 P! J9 A. d. S; z
8. uint32_t temp_val = 0;
   ) ^9 e  L& S& q$ Q; _. o
9. /* 读取平均值 */
   
10.     temp_val = adc3_get_result_average(g_adc3_handle, LSENS_ADC3_CHX, 10);
    6 P6 Q, N: |0 g8 D7 q
11.     temp_val /= 655;
    
12.     if (temp_val > 100)temp_val = 100;
    
13.     return (uint8_t)(100 - temp_val);
    0 P* }& B" x  K* y* h, `* S" B
14. }

复制代码

6 W2 T1 a, {! p2 Alsens_get_val函数用于获取当前光照强度，该函数通过adc3_get_result_average函数得到通道11转换的电压值，经过简单量化后，处理成0~100的光强值。0对应最暗，100对应最亮。
2. main.c代码
在main.c里面编写如下代码：
; v) z/ o7 a7 ^" _, m# v- M
7 h7 O- S4 L# B+ a

1. int main(void)
   
2. {
   ; O% u1 A$ `+ D8 W+ E$ t" I: b  D
3.     short adcx;
   
4.     sys_cache_enable();                             /* 打开L1-Cache */
   ( a5 C$ l+ L* G" n- s
5.     HAL_Init();                                      /* 初始化HAL库 */
   
6.     sys_stm32_clock_init(240, 2, 2, 4);         /* 设置时钟, 480Mhz */
   ! d& Y% l2 `4 k0 A* N7 n
7.     delay_init(480);                                /* 延时初始化 */
   & @; u" t& m( f8 x7 V; e4 k+ H& |2 @
8.     usart_init(115200);                            /* 串口初始化为115200 */
   7 P+ J( d7 C7 K* E
9.     mpu_memory_protection();                      /* 保护相关存储区域 */
   
10.     led_init();                                             /* 初始化LED */
    
11.     lcd_init();                                             /* 初始化LCD */
    8 E/ R4 s: p8 H" l/ x+ U3 S
12. lsens_init();                                           /* 初始化光敏传感器 */
    
13. 
    
14.     lcd_show_string(30, 50, 200, 16, 16, "STM32", RED);
    
15.     lcd_show_string(30, 70, 200, 16, 16, "LSENS TEST", RED);
    + Q& y8 ]+ A. W) m) n; T
16.     lcd_show_string(30, 90, 200, 16, 16, "ATOM@ALIENTEK", RED);
    ! T0 M# ]: a) T9 p9 n( i
17. lcd_show_string(30, 110, 200, 16, 16, "LSENS_VAL:", BLUE);
    % k5 ^! l3 n( v; G
18.     while (1)
    5 w4 X0 H# C+ k! y
19.     {
    0 r, o( B$ u, B3 e
20.         adcx = lsens_get_val();
    % g( K4 R" F' M5 @3 {4 o& j: G
21.         lcd_show_xnum(30 + 10 * 8, 110, adcx, 3, 16, 0, BLUE); /* 显示光线强度值 */
    
22.         LED0_TOGGLE();  /* LED0闪烁,提示程序运行 */
    . o& L  o* k% u( i4 m1 X4 x
23.         delay_ms(250);
    / ]) w1 M/ b- c# p+ w" z: u, I
24.     }
    
25. }

复制代码

该部分的代码逻辑很简单，初始化各个外设之后，进入死循环，通过lsens_get_val获取光敏传感器得到的光强值（0~100），并显示在TFTLCD上面。

- A8 S! ]. r! f. w" I& N33.4 下载验证
- N- H7 [2 R2 P3 l5 ]  S) f将程序下载到开发板后，可以看到LED0不停的闪烁，提示程序已经在运行了。LCD显示的内容如图33.4.1所示：



# K* z# ^& m# l* L. I: s" F图33.4.1 光敏传感器实验测试图
我们可以通过给LS1不同的光照强度，来观察LSENS_VAL值的变化，光照越强，该值越大，光照越弱，该值越小，LSENS_VAL值的范围是0~100。
————————————————
3 L* b8 L" G& e版权声明：正点原子
+ Y( M6 J. ], W/ R- n) D9 b

+ [4 j& `& J+ d, x5 d