此紫外线检测模块采用氮化家基材料的肖特基光电二极管，具有高的响应度和低的暗电流,板载LM358放大器对光电二极管输出的微弱信号进行放大，所有元器件采用1%精度元器件制造。应用于紫外线测试仪，紫外线手表，户外运动设备，手机移动电话等。
一、模块来源
采购链接：
S12SD 高灵敏UV紫外线传感器模块 太阳光照强度感应检测电路板
资料下载链接：
https://pan.baidu.com/s/1YuwoCsbiJPaYH-8TaHEwVg
提取码：8888
二、规格参数
工作电压：2.7-5V
工作电流：1mA
测量角度：130度
温飘：0.08%/℃
检测波长范围：240nm~370nm
输出方式: ADC
管脚数量：3 Pin
以上信息见厂家资料文件
三、移植过程
我们的目标是将例程移植至开发板上【能够测量紫外线强度】。首先要获取资料，查看数据手册应如何实现读取数据，再移植至我们的工程。
1、查看资料
电路图中，SIG引脚是经过放大模拟电压后进行模拟信号输出，采集到模拟量后将其转换为电压，根据下图电压与紫外线强度对照表，则可得知紫外线强度。
2、引脚选择
| VCC | 3V3 |
| GND | GND |
| SIG | P000 |
3、图形化配置
- 打开图形化界面：
- 设置
ADC：
Ctrl + S保存！- 点击右上角
Generate Project Content生成代码。
4、代码编写
新建两个文件 bsp_ultraviolet.c 和 bsp_ultraviolet.h，并且将头文件路径添加到编译器中。
在文件 bsp_ultraviolet.c 和 bsp_ultraviolet.h 中，编写如下代码。
c
/*
* 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
* 开发板官网：www.lckfb.com
* 文档网站：wiki.lckfb.com
* 技术支持常驻论坛，任何技术问题欢迎随时交流学习
* 嘉立创社区问答：https://www.jlc-bbs.com/lckfb
* 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
* 不靠卖板赚钱，以培养中国工程师为己任
*/
#ifndef BSP_CODE_BSP_ULTRAVIOLET_H_
#define BSP_CODE_BSP_ULTRAVIOLET_H_
#include "hal_data.h"
#include <stdio.h>
#ifndef delay_ms
#define delay_ms(x) R_BSP_SoftwareDelay(x, BSP_DELAY_UNITS_MILLISECONDS)
#endif
#ifndef delay_1ms
#define delay_1ms(x) R_BSP_SoftwareDelay(x, BSP_DELAY_UNITS_MILLISECONDS)
#endif
#ifndef delay_us
#define delay_us(x) R_BSP_SoftwareDelay(x, BSP_DELAY_UNITS_MICROSECONDS)
#endif
#ifndef delay_1us
#define delay_1us(x) R_BSP_SoftwareDelay(x, BSP_DELAY_UNITS_MICROSECONDS)
#endif
#ifndef u8
#define u8 uint8_t
#endif
#ifndef u16
#define u16 uint16_t
#endif
#ifndef u32
#define u32 uint32_t
#endif
#define BSP_ADC_CHANNEL ADC_CHANNEL_0
// 采样次数
#define SAMPLES 5
void S12SD_UV_GPIO_Init(void);
int Get_ADC_Value( void );
char Get_Ultraviolet_Intensity(uint16_t value);
#endif /* BSP_CODE_BSP_ULTRAVIOLET_H_ */c
/*
* 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
* 开发板官网：www.lckfb.com
* 文档网站：wiki.lckfb.com
* 技术支持常驻论坛，任何技术问题欢迎随时交流学习
* 嘉立创社区问答：https://www.jlc-bbs.com/lckfb
* 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
* 不靠卖板赚钱，以培养中国工程师为己任
*/
#include "bsp_ultraviolet.h"
// ADC Scan complete flag
volatile bool adc_flag = false;
/* ADC callback */
void adc_callback(adc_callback_args_t *p_args)
{
FSP_PARAMETER_NOT_USED(p_args);
adc_flag = true;
}
/**********************************************************
* 函 数 名 称：S12SD_UV_GPIO_Init
* 函 数 功 能：初始化紫外线传感器GPIO
* 传 入 参 数：无
* 函 数 返 回：无
* 作 者：LCKFB
* 备 注：LP
**********************************************************/
void S12SD_UV_GPIO_Init(void)
{
fsp_err_t err = FSP_SUCCESS;
// 打开ADC设备
err = R_ADC_Open(&g_adc0_ctrl, &g_adc0_cfg);
if (FSP_SUCCESS != err) {
printf("ADC Open Failed! \n");
return;
}
// 配置ADC扫描
err = R_ADC_ScanCfg(&g_adc0_ctrl, &g_adc0_channel_cfg);
if (FSP_SUCCESS != err) {
printf("ADC Scan Config Failed! \n");
R_ADC_Close(&g_adc0_ctrl); // 关闭已打开的ADC
return;
}
}
/**********************************************************
* 函 数 名 称：ADC_GET
* 函 数 功 能：读取一次ADC数据
* 传 入 参 数：无
* 函 数 返 回：无
* 作 者：LCKFB
* 备 注：LP
**********************************************************/
static int ADC_GET(void)
{
int gAdcResult = 0;
int timeOut = 1000;
fsp_err_t err = FSP_SUCCESS;
// 启动ADC扫描
err = R_ADC_ScanStart(&g_adc0_ctrl);
if (FSP_SUCCESS != err) {
printf("ADC扫描启动失败! \n");
return 9999; // 返回错误值
}
// 等待ADC总线处理完成
while(!adc_flag && timeOut--)
{
delay_us(1);
}
// 清除ADC采样完成标志位
adc_flag = false;
if(!timeOut)
{
printf("ADC_GET Failed!!!\r\n");
return 0;
}
// 读取ADC数据
err = R_ADC_Read(&g_adc0_ctrl, BSP_ADC_CHANNEL, (uint16_t *)&gAdcResult);
if (FSP_SUCCESS != err) {
printf("ADC Read Failed!\n");
return 9999; // 返回错误值
}
return gAdcResult;
}
/******************************************************************
* 函 数 名 称：Get_ADC_Value
* 函 数 说 明：对ADC值进行平均值计算后输出
* 函 数 形 参：无
* 函 数 返 回：对应扫描的ADC值
* 作 者：LCKFB
* 备 注：
******************************************************************/
int Get_ADC_Value( void )
{
int Data = 0;
int i;
for(i = 0; i < SAMPLES; i++)
{
Data += ADC_GET();
delay_ms(5);
}
Data = Data / SAMPLES;
return Data;
}
/******************************************************************
* 函 数 名 称：Get_Ultraviolet_Intensity
* 函 数 说 明：判断当前紫外线强度等级
* 函 数 形 参：value=ADC读取的值
* 函 数 返 回：0~11 紫外线强度等级由低到高，11最高
* 作 者：LCKFB
* 备 注：无
******************************************************************/
char Get_Ultraviolet_Intensity(uint16_t value)
{
char ret = 0;
if( value < 227 )//紫外线强度0级
{
ret = 0;
}
if( value >= 227 && value < 318 )//紫外线强度1级
{
ret = 1;
}
if( value >= 318 && value < 408 )//紫外线强度2级
{
ret = 2;
}
if( value >= 408 && value < 503 )//紫外线强度3级
{
ret = 3;
}
if( value >= 503 && value < 606 )//紫外线强度4级
{
ret = 4;
}
if( value >= 606 && value < 696 )//紫外线强度5级
{
ret = 5;
}
if( value >= 696 && value < 795 )//紫外线强度6级
{
ret = 6;
}
if( value >= 795 && value < 881 )//紫外线强度7级
{
ret = 7;
}
if( value >= 881 && value < 976 )//紫外线强度8级
{
ret = 8;
}
if( value >= 976 && value < 1079 )//紫外线强度9级
{
ret = 9;
}
if( value >= 1079 && value < 1170 )//紫外线强度10级
{
ret = 10;
}
if( value >= 1170 )//紫外线强度11级
{
ret = 11;
}
return ret;
}四、移植验证
在 src\Applay\app.c 中输入代码如下:
c
/*
* 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
* 开发板官网：www.lckfb.com
* 文档网站：wiki.lckfb.com
* 技术支持常驻论坛，任何技术问题欢迎随时交流学习
* 嘉立创社区问答：https://www.jlc-bbs.com/lckfb
* 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
* 不靠卖板赚钱，以培养中国工程师为己任
*/
#include "app.h"
#include "stdio.h"
#include "bsp_uart.h"
#include "bsp_ultraviolet.h"
/******************************************************************
* 函 数 名 称：led_blink
* 函 数 说 明：该函数用于控制LED灯的闪烁效果
* 运行时，LED灯每隔500毫秒闪烁一次
* 完整运行此函数需要1s时间
* 函 数 形 参：无
* 函 数 返 回：无
* 作 者：LC
* 备 注：无
******************************************************************/
static void led_blink(void)
{
/* Set the pin to low */
R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_04_PIN_02, BSP_IO_LEVEL_LOW);
/* Delay for 500 milliseconds */
R_BSP_SoftwareDelay(500, BSP_DELAY_UNITS_MILLISECONDS);
/* Set the pin to high */
R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_04_PIN_02, BSP_IO_LEVEL_HIGH);
/* Delay for another 500 milliseconds */
R_BSP_SoftwareDelay(500, BSP_DELAY_UNITS_MILLISECONDS);
}
/******************************************************************
* 函 数 名 称：Run
* 函 数 说 明：该函数是用户自定义的入口函数，等效于 main_app() 函数。
* 在此函数中可以编写用户的应用逻辑代码。
* 函 数 形 参：无
* 函 数 返 回：无
* 作 者：LC
* 备 注：无
******************************************************************/
void Run(void)
{
/* 初始化调试串口 */
/* | RX:P100 | TX:P101 | */
UART0_Debug_Init();
printf("\r\n= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =\r\n");
printf("\r\n=== Welcome to use the DQX-R7FA6E2BB3CNE development board ====\r\n");
printf("\r\n======================= www.lckfb.com =========================\r\n");
printf("\r\n======================= wiki.lckfb.com ========================\r\n");
printf("\r\n======================= [Debug Uart0] =========================\r\n");
printf("\r\n=================== | RX:P100 | TX:P101 | =====================\r\n");
printf("\r\n= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =\r\n");
/* initialize the S12SD UV sensor pin */
S12SD_UV_GPIO_Init();
printf("\r\nS12SD UV Sensor Test\r\n");
printf("ADC Channel 0 (P000) is used to detect UV intensity\r\n");
while(1)
{
int value = Get_ADC_Value();
printf("\n");
printf("S12SD Value = [ %d ]\r\n",value);
printf("S12SD Intensity = [ %d ]\r\n",Get_Ultraviolet_Intensity(value));
delay_1ms(500);
}
}编译烧录。
【代码下载】
- 跳转去下载模块移植代码：【点击跳转🚀】