STM32CubeMX学习教程之硬件I2C读取光照度

使用STM32 HAL库读写环境光照度传感器（BH1750）

本文将教大家如何快速使用STM32HAL库读取光照度数据。

实现功能：通过App实时监测光照度数据。

程序下载路径：demo程序。

一.使用STM32CubeMX创建一个新工程

1.如下图创建一个新工程：

2.如下图选择自己现有的STM32开发板进行开发：

3.配置时钟源

如果选择使用外部高速时钟（HSE），则需要在System Core中配置RCC；

如果使用默认内部时钟（HSI），这一步可以略过；

下面工程我使用的是内部时钟，因此这一步是不需要的。

4.配置串口

NUCLEO-L476RG板载ST-Link并且虚拟了一个串口，原理图如下：

使PC的串口与USART2之间连接。（打印日志口，同时也作为程序下载口）

接下来开始如下图配置USART2：

使用串口1和涂鸦模组WB3S通信（单片机和WB3S串口通信，采用透传的模式），串口1配置如下图所示：

5.配置IIC口

为了采集光照度数据（BH1750)，单片机采用I2C协议和光照度模块进行通信，采用I2C1，配置如下图所示：

6.配置时钟树

STM32L4的最高主频到80M，所以配置PLL，最后使HCLK=80Mhz即可：

7.生产工程设置

8.代码生成设置

最后设置生成独立的初始化文件：

9.生成代码

点击GENERATE CODE即可生成MDK-V5工程如下:

10.用KEIL5打开生成的代码，然后开始添加自己要实现的功能函数。

二.BH1750驱动程序设计

1.硬件设计

BH1750 照度检测模块搭载一个BH1750FVI，BH1750FVI是两线式串行总线接口（IIC）的16位数字输出型环境光强度传感器，利用它的高分辨率可以探测较大范围内的光照强度变化（1lx - 65535lx）。

• BH1750的实物图如下：

• BH1750的原理图如下：

管脚介绍

名称	VCC	GND	SCL	SDA	ADDR
功能描述	3~5V供电	参考地	IIC时钟线	IIC数据线	地址线

2.软件设计

参考BH1750FVI数据手册进行编程。

• BH1750的器件地址由ADDR端口的高低电平决定。

• 驱动程序底层使用 HAL 库的 IIC 初始化文件，包含如下头文件：

• 发送命令的函数如下：

• 接收光照强度数据的函数如下：

• 根据数据手册中给出的公式，编写将从BH1750读出的两个字节数据转换为对应强度值的函数（数据转换函数）：

驱动程序设计完成之后就可以开始进行联网功能的设计了。

三.平台产品创建

  进入涂鸦智能IoT平台点击“创建产品”。这里不用纠结产品品类的选择，重点是为了拿到MCU-SDK文件，实际使用时可以根据具体的产品修改sdk内部的pid即可适配自己的产品。

例如：点击创建产品，选择标准类目>电工>开关。（当时为了测试用，所以选择一个标准类目，也可以在平台上选择其它品类去创建也是可以的）

• 选择自定义方案，输入产品名称，选择通讯协议为WIFI+蓝牙，点击创建产品。

• 根据要实现的设备功能，创建好DP功能点。

  

• 创建好DP点之后，点击设备面板，选择自由配置面板，方便开发调试，也可以选择其它的面板。

  

  

面板创建好之后，点击硬件开发，对接方式选择“涂鸦标准模组MCU SDK开发”，模组选择WB3S Wi-Fi&Bluetooth模组（在实际开发过程中可选择手上已有的涂鸦模组即可），固件选择通用固件。

四.MCU SDK移植

平台产品创建完之后，我们会获取到一个MCU SDK包，之后就可以快速移植到MCU了。

• 在解压后的文件夹中找到mcu_sdk相关源文件和头文件，全部拷贝到我们创建好的工程模板里的MCU_SDK文件夹里；打开上面创建好的工程，将mcu_sdk的源文件添加进对应组里，同时添加include paths：

• 点击编译，会崩出几个error，接下来就需要按照出error的地方注释提示一步步修改代码。

• uart_receive_input()为串口接收数据处理接口，只需将它放进串口中断即可，这里我们以串口1作为与模组通讯串口，调试中把串口2作为日志口，首先在main函数中添加串口1和串口2初始化代码，并使能接收中断（接收使能中断已在串口初始化函数中体现）：

• 然后在stm32l4xx_it.c文件中添加中断处理函数，然后包含 mcu_api.h文件并将uart_receive_input()接口添加进去，添加完成后，删除error注释即可：

  

• 再来看下一个errror，由于我们上一步已经通过中断接收的形式实现了串口数据接收处理了，这个多字节处理我们可以不用，直接把error注释删除即可。

• 下一个errror：

• 按照提示将该接口放在main函数的while循环内即可，别忘了在 main.c 中包含 wifi.h 头文件。

• 再来看下一个error:

• 同样的，按照提示将该函数放到main函数开头部分即可。

• 然后是串口发送相关：

• 这里只需实现串口1的数据发送函数然后放进去即可。使用STM32 HAL库里面的串口单字节发送函数，以阻塞方式发送数据量，添加代码如下：

• 然后是DP数据点上报相关的：

这里我们可以直接注释掉error提示，在实际开发过程中再实现该功能即可。

• 以下在主函数里面，添加光照度上报的数据。这里可以改成自己想要上报传感器的数据。

• 最后是产测相关的：

一般开发者不涉及生产测试的话直接删除注释不用管就行。

下图这个红色标出的函数是进行配网的，通过NUCLEO-L476开发板上的用户按键进行配网连接。

修改完上述几处地方后，再次编译，显示error全部消除，至此涂鸦MCU SDK就已移植完毕，后续可使用涂鸦模组调试助手进行测试。涂鸦模组调试助手的使用方法可参考调试助手文档。

五.实验样机测试展示

通过之前配置好的面板，通过涂鸦智能APP进行配网实时采集光照度传感器的数据。