使用MLX90640自制红外热像仪(二)：API函数的使用

最新推荐文章于 2024-09-13 21:39:44 发布
最新推荐文章于 2024-09-13 21:39:44 发布
阅读量7.1k 收藏 116
点赞数 17
分类专栏： 器件&传感器 MCU 文章标签： MLX90640 红外热成像
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qlexcel/article/details/119419826
版权
MCU 同时被 2 个专栏收录
179 篇文章 191 订阅
订阅专栏
器件&传感器
99 篇文章 116 订阅
订阅专栏

  前面一篇文章介绍了MLX90640的相关信息和API库的移植，接下来介绍一下API库中的函数，和使用方法。
  首先给出API函数的调用顺序，再对每个用到的API函数做说明：

#define  FPS2HZ   0x02
#define  FPS4HZ   0x03
#define  FPS8HZ   0x04
#define  FPS16HZ  0x05
#define  FPS32HZ  0x06

#define  MLX90640_ADDR 0x33
#define	 RefreshRate FPS4HZ 
#define  TA_SHIFT 8 //Default shift for MLX90640 in open air

static uint16_t eeMLX90640[832];  
static float mlx90640To[768];
uint16_t frame[834];
float emissivity=0.95;
int status;

int main(void)
{
	HAL_Init();
	
	SystemClock_Config();
	
	MX_GPIO_Init();
	MX_USART1_UART_Init();
	MLX90640_I2CInit();
	
	MLX90640_SetRefreshRate(MLX90640_ADDR, RefreshRate);  //设置帧率
	MLX90640_SetChessMode(MLX90640_ADDR);                 //棋盘模式   
	paramsMLX90640 mlx90640;
	status = MLX90640_DumpEE(MLX90640_ADDR, eeMLX90640);  //读取像素校正参数 
	if (status != 0) printf("\r\nload system parameters error with code:%d\r\n",status);
	status = MLX90640_ExtractParameters(eeMLX90640, &mlx90640);  //解析校正参数
	if (status != 0) printf("\r\nParameter extraction failed with error code:%d\r\n",status);

	while (1)
	{
			int status = MLX90640_GetFrameData(MLX90640_ADDR, frame);  //读取一帧原始数据
			if (status < 0)
			{
				//printf("GetFrame Error: %d\r\n",status);
			}
			float vdd = MLX90640_GetVdd(frame, &mlx90640);  //计算 Vdd（这句可有可无）
			float Ta = MLX90640_GetTa(frame, &mlx90640);    //计算实时外壳温度

			float tr = Ta - TA_SHIFT; //Reflected temperature based on the sensor ambient temperature
			//printf("vdd:  %f Tr: %f\r\n",vdd,tr);
			MLX90640_CalculateTo(frame, &mlx90640, emissivity , tr, mlx90640To);            //计算像素点温度
			MLX90640_BadPixelsCorrection(mlx90640.brokenPixels, mlx90640To, 1, &mlx90640);  //坏点处理
			MLX90640_BadPixelsCorrection(mlx90640.outlierPixels, mlx90640To, 1, &mlx90640); //坏点处理
			
			printf("\r\n==========================IAMLIUBO MLX90640 WITH STM32 SWI2C EXAMPLE Github:github.com/imliubo==========================\r\n");
			for(int i = 0; i < 768; i++){
				if(i%32 == 0 && i != 0){
					printf("\r\n");
				}
				printf("%2.2f ",mlx90640To[i]);
			}
			printf("\r\n==========================IAMLIUB0 MLX90640 WITH STM32 SWI2C EXAMPLE Github:github.com/imliubo==========================\r\n");
	}
}

API函数介绍

1. 设置测量分辨率函数

int MLX90640_SetResolution(uint8_t slaveAddr, uint8_t resolution)
此函数用于设置 MLX90640 的测量分辨率值（0~3 表示分辨率为 16~19 位）。需要注意的是在下次重新上电时，此函数修改的值会自动恢复为默认值（即：此函数修改后不会保存，掉电即失）。返回 0 表示设置成功， -1 表示设备未应答， -2 表示重新读取后发现不是预期的值。
例如：
设置分辨率为 19 位： MLX90640_SetResolution(0x33,0x03);

2. 读取测量分辨率函数

int MLX90640_GetCurResolution (uint8_t slaveAddr)
此函数用于读取当前的测量分辨率（0~3），若此函数返回了-1 则表示读取失败。

3. 设置测量速率函数

int MLX90640_SetRefreshRate (uint8_t slaveAddr,uint8_t refreshRate)
此函数用于设置 MLX90640 的测量速率（即：每秒测量几帧数据），参数值可以是 0~7 代表 0.5、1、 2、 4、 8、 16、 32 和 64Hz。返回 0 表示设置成功， -1 表示设备未应答， -2 表示重新读取后发现不是预期的值。
例如：
设置为每秒测量 16 帧： MLX90640_SetRefreshRate (0x33,0x05);//5 的意思就是 16Hz

4. 读取测量分辨率函数

int MLX90640_GetRefreshRate (uint8_t slaveAddr)
此函数用于读取当前的测量速率值（0~7），若此函数返回了-1 则表示读取失败。

5. 读取完整实时数据

int MLX90640_GetSubPageNumber (uint16_t *frameData)
此函数用于读取一次完整的测量数据（832 个字），返回值表示当前帧是哪个子页（0 或 1）。
例如：

static int mlx90640Frame[834];
int subPage;
subPage = MLX90640_GetSubPageNumber(mlx90640Frame);

6. 设置子页模式为 TV

int MLX90640_SetInterleavedMode (uint8_t slaveAddr)
此函数用于设置测量分布模式为 TV 模式（行交错模式）。 返回 0 表示设置成功， -1 表示设备未应答， -2 表示重新读取后发现不是预期的值。

7. 设置子页模式为棋盘

int MLX90640_SetChessMode (uint8_t slaveAddr)
此函数用于设置测量分布模式为棋盘模式（像素交错模式）。 返回 0 表示设置成功， -1 表示设备未应答， -2 表示重新读取后发现不是预期的值。

8. 读取子页测量模式

int MLX90640_GetCurMode (uint8_t slaveAddr)
此函数用于读取当前的测量分布模式，返回 0 表示工作于 TV 模式，返回 1 表示工作于棋盘模式。

9. 读取全部校正参数

int MLX90640_DumpEE(uint8_t slaveAddr, uint16_t *eeData)
此函数用于读取保存于EEPROM内的全部832个字的温度计算校准数据，保存于eeData数组内。
例如：

static uint16_t eeMLX90640[832];
int status;
status = MLX90640_DumpEE (0x33, eeMLX90640); //eeMLX90640 数组内是读取得到的EEPROM 参数数据

10. 解析校正参数为计算参数

int MLX90640_ExtractParameters(uint16_t * eeData,paramsMLX90640 *mlx90640)
此函数用来将MLX90640_DumpEE函数读取的所有 EEPROM 数据解析到定义于 MLX90640_API.h 中的自定义结构体变量中，此变量特别重要，是完成各种计算的必需参数（以下简称“计算参数” ）。当解析完成后，原来的 EEPROM 数据基本再没有意义了（可以根据需要释放，也可以不管）。此函数返回-7 表示提供的 EEPROM 参数错误。
例如：

static uint16_t eeMLX90640[832];
paramsMLX90640 mlx90640;
int status;
status = MLX90640_DumpEE (0x33, eeMLX90640);//将 EEPROM 数据读取到 eeMLX90640 数组中
status = MLX90640_ExtractParameters(eeMLX90640, &mlx90640);//将 eeMLX90640 数组中的数据解析计算参数变量中

11. 读取一帧计算用实时数据

int MLX90640_GetFrameData(uint8_t slaveAddr, uint16_t *frameData)
此函数用于读取完整的一帧实时测量数据。计算所需要的完整的一帧数据为 834 个字（包括 832个字 RAM 数据+控制寄存器+状态寄存器）。如果返回-1 表示 MLX90640 未应答， -8 表示读取异常（最可能的情况是读取速率太低了），若返回 0 或者 1 则表示读取到了刚刚测量完成的子页 0 或者子页 1（读取成功），此时参数 frameData 数组内即是 834 个字的实时数据。
例如：

static uint16_t mlx90640Frame[834];
int status;
status = MLX90640_GetFrameData (0x33, mlx90640Frame);

12. 计算 Vdd

float MLX90640_GetVdd(uint16_t *frameData,const paramsMLX90640 *params)
此函数用于计算并返回 Vdd 电压值。需要的参数说明如下：

  • uint16_t *frameData：读取到的完整的一帧实时数据（MLX90640_GetFrameData得到的 834 个字的数组）
  • const paramsMLX90640 *params：由EEPROM解析得到的自定义结构体变量（MLX90640_ExtractParameters函数计算得到的“计算参数” ）

此函数的返回值是浮点数，单位为 V。若不是 3.3V 左右，则说明发生了较为严重的问题。
Vdd 在计算点阵温度时用做参考电压， 故此计算结果必须为实际电压， 否则无法得到正确的温度值。（Vdd 的值在MLX90640_CalculateTo 函数体中会用到）
例如：
为了得到 Vdd 电压值，需要如下步骤：

float vdd;
uint8_t slaveAddress;
static int eeMLX90640[832];
static int mlx90640Frame[834];
paramsMLX90640 mlx90640;
int status;
status = MLX90640_DumpEE (slaveAddress, eeMLX90640); //读取 EEPROM
status = MLX90640_ExtractParameters(eeMLX90640, &mlx90640); //由 EEPROM 计算得到计算参数
status = MLX90640_GetFrameData (0x33, mlx90640Frame); //读取一帧实时数据
vdd = MLX90640_GetVdd(mlx90640Frame, &mlx90640); //由计算参数和实时数据计算得到 Vdd

13. 计算 Ta

float MLX90640_GetTa(uint16_t *frameData,const paramsMLX90640 *params)
此函数计算得到 Ta（MLX90640 外壳温度）。
所需要的参数与 12 相同。
此函数的返回值是浮点数，单位为℃。若与环境温度相差甚远，则说明发生了较为严重的问题。
例如：
为了得到 Ta 温度值，需要如下步骤：

float Ta;
uint8_t slaveAddress;
static int eeMLX90640[832];
static int mlx90640Frame[834];
paramsMLX90640 mlx90640;
int status;
status = MLX90640_DumpEE (slaveAddress, eeMLX90640); //读取 EEPROM
status = MLX90640_ExtractParameters(eeMLX90640, &mlx90640); //由 EEPROM 计算得到计算参数
status = MLX90640_GetFrameData (0x33, mlx90640Frame); //读取一帧实时数据
Ta = MLX90640_GetTa(mlx90640Frame, &mlx90640); //由计算参数和实时数据计算得到 Ta

14. 计算物体绝对温度数据

void MLX90640_CalculateTo(uint16_t *frameData,const paramsMLX90640 *params,float emissivity, float tr,float *result)
此函数计算一帧温度值（768 像素点）。计算结果为浮点型，保存于 result 数组内。参数说明如下：

  • uint16_t *frameData：读取到的一帧实时数据
  • const paramsMLX90640 *params：由 EEPROM 计算得到的计算参数
  • float emissivity：被测物体的辐射率（人体为 0.95，其它材料的辐射率请上网查）
  • float tr：校正温度，一般取 Ta-8
  • float *result：计算结果， 768 个浮点数

例如：
计算一帧刚刚读取到的实时数据为温度值，假设被测物体的辐射率为 0.95。

float emissivity = 0.95;
float Ta,tr;
unsigned char slaveAddress;
static uint16_t eeMLX90640[832];
static uint16_t mlx90640Frame[834];
paramsMLX90640 mlx90640;
static float mlx90640To[768];
int status;
status = MLX90640_DumpEE (slaveAddress, eeMLX90640);
status = MLX90640_ExtractParameters(eeMLX90640, &mlx90640);
status = MLX90640_GetFrameData (0x33, mlx90640Frame);
Ta= MLX90640_GetTa(mlx90640Frame, &mlx90640);
tr = Ta-8.0;
MLX90640_CalculateTo(mlx90640Frame, &mlx90640, emissivity, tr, mlx90640To)

计算完成后， mlx90640To 数组中保存的即是 768 个单位为℃温度值。

15. 计算热图像数据

void MLX90640_GetImage(uint16_t *frameData,const paramsMLX90640 *params,float *result)
此函数的功能与上一节计算温度几乎完全相同，不同点仅为计算结果中的数值没有规划为温度单位，而是一些仅有数值大小意义的数值，用这些数值大小来绘图是足够的，这个函数的优点就是速度要比计算温度要快很多（仅需要绘图而不关心绝对温度值时可以使用这个函数来计算完成）。
例如：

static uint16_t eeMLX90640[832];
static uint16_t mlx90640Frame[834];
paramsMLX90640 mlx90640;
static float mlx90640Image[768];
int status;
status = MLX90640_DumpEE (0x33, eeMLX90640);
status = MLX90640_ExtractParameters(eeMLX90640, &mlx90640);
status = MLX90640_GetFrameData (0x33, mlx90640Frame);
MLX90640_GetImage(mlx90640Frame, &mlx90640, mlx90640Image);

发射率(emissivity)

发射率(emissivity)，这是物体的一种属性，根据材料的不同而不同，一般非金属（如塑料、油漆、皮革、纸张等）发射率通常为 0.95，常见物体发射率可以参考下图：
在这里插入图片描述

【ql君】qlexcel
关注
专栏目录
热像仪：使用 ESP32 和 MLX90640 传感器设计您自己的红外成像设备
DT程序员的博客
11-07 828
在这个项目中，我们将通过使用更便宜的可用组件制作 DIY 热像仪来找到一些解决方案。
MLX90640.zip
03-04
MLX90640BAA/BAB32*24 点阵红外温度传感器，源码可直接使用，已经用在同类的测温系统中。
MLX90640开发笔记（三）工作流程和操作MLX90640的一般步骤
xulikai的专栏
10-10 1万+
默认参数时，MLX90640的工作流程如下： （1）上电，内部初始化（约40ms） （2）读取工作参数到控制和状态寄存器 （3）开始以2Hz的速率测量实时数据并更新到RAM，自动更新状态寄存器。 测量帧解释： MLX90640共有768个测量像素点，每次测量其中的一半，称为1帧，故此完成768像素需要测量2帧，用帧0和帧1来表示。即：所谓的1帧数据其实是完整像素的一半。 可...
MLX90640 开源项目常见问题解决方案
最新发布
gitblog_09354的博客
09-13 327
MLX90640 开源项目常见问题解决方案 mlx90640-library MLX90640 library functions 项目地址: https://gitcode.com/gh_mirrors/ml/mlx90640-...
MLX90640库函数安装与配置指南
gitblog_09353的博客
09-13 327
MLX90640库函数安装与配置指南 mlx90640-library MLX90640 library functions 项目地址: https://gitcode.com/gh_mirrors/ml/mlx90640-lib...
使用MLX90640自制红外热像仪(一)：MLX90640介绍与API库移植
热门推荐
qlexcel的专栏
08-12 3万+
  平时工作的时候会遇到如下场景： 新焊接好的板子，通电后发现电流异常，需要看下板子上哪里发热异常。 需要监控某个器件（比如三极管、MOS）的温度，以防过热烧掉。 测量温升。   因此需要一个红外热像仪，可是网上看了一下都要2000左右了，虽然分辨率很高，可是我并不需要那么好的性能，于是干脆自己做一个。AMG8833的像素点是8x8的，感觉太低了，于是选用了32x24像素点的MLX90640。 MLX90640介绍 特性和优点 小尺寸，低功耗， 32*24 像素红外阵列 方便集成 标准的 TO39 封
mlx90640驱动库API（C语言）已验证可用
10-09
这个库MLX网站之前的可用版本，现在下载最新的发现结构体定义错误，和Excel举例的数据也不一致，所以在这里上传一下备份，也方便大家使用。
MLX90640综合读写测试程序(STC单片机)
10-10
MLX90640红外阵列传感器的底层驱动程序测试演示，是个完整的Keil工程，包含了EEPROM、寄存器和RAM的读写过程
MLX90640开发笔记（二）API移植-I2C和关键接口函数
xulikai的专栏
10-10 7929
API说明文件里面有官方的移植指导，但我觉得可以把重点放在与MLX90640具体操作有关的几个函数上，而与标准I2C相关的函数和文件结构还是按照自己习惯的套路实现。这样更符合我们开发人员的可控性的习惯。步骤如下： （1）建立标准I2C文件IIC.h和IIC.c，用自己的方法实现如下几个函数（硬件也好，GPIO模拟也好），函数名称用下面建议的。 void IIC_Init(void);...
STM32驱动MLX90640红外测温模块
优信电子的博客
07-26 1484
GYMCU90640 是一款低成本非接触红外点阵测温模块。其工作原理，是黑体辐射定律， 物体的温度越高，所发出的红外辐射 能力越强，经过芯片处理得到温度数据。此模块，有两种方式读取数据，即 串口（TTL 电平）或者 I2C（芯片本身）通信方式。
mlx90640.rar
06-04
调试温度传感器资料开发包mlx90640驱动部分（drivier+dts）+hardware的HAL部分+ frameworks的JNI部分。
MX90640_STM32_HAL移植_hal库_stm32测温_MLX90640_mlx90640hal库_snowcem_源
09-11
1. **MX90640**：这是一款热像仪传感器，由Melexis公司生产，型号为MLX90640。它是一个非接触式的红外阵列传感器，用于测量环境或物体表面的温度。该传感器具有较高的分辨率（32x24像素），并提供精确的温度读数。 ...
MLX90640官方驱动
11-06
MLX90640官方驱动和文档资料 含温度补偿算法
mlx90640源码.zip
03-13
MLX90640 最新程序 API接口使用说明 API移植-I2C和关键接口函数 工作流程和操作MLX90640的一般步骤 损坏和不良像素的处理
mlx90640_code.zip
02-22
mlx90640是一款红外热像仪模块32×24 像素， I2C 接口通信，兼容 3.3V/5V 电平。采用 MLX90640 远红外热传感器阵列，可精确检测特定区域和温度范围内的目标物体，尺寸小巧，可方便集成到各种工业或智能控制应用中。本驱动跟测试案例是在rk3288 7.1平台上面验证过可行，可以正常获取温度的参考代码
STM32-Driver-MLX90640-IR-Sensor-master.zip
02-20
MLX90640热成像传感器,官方STM32驱动,用STM32通过软件模拟IIC来读取MLX90640数据, 并通过串口发送出来
mlx90640-library:MLX90640库函数
05-03
MLX90640库函数是专为MLX90640红外热像仪设计的C++编程工具，它允许开发者有效地读取和处理该传感器的数据。MLX90640是一款高分辨率的热成像传感器，广泛应用于工业、科研和消费电子领域，如无人机、自动驾驶、智能...
mlx90640驱动调试
baidu_37552881的博客
04-25 363
QQ交流入群 712288614 个人QQ 459722549 mlx90640 驱动调试。
MLX90640 红外热成像仪测温传感器模块
zhaocundang's blog
03-10 993
（2）将本设备插入计算机 USB 接口，计算机右下角弹出发现新设备以及设备安装成功的提示信息，右键点击“我的电脑-属性-设备管理器”，在“端口（COM 和 LPT）”中查看是否有“USBSERIAL CH340(COMx)”， COMx 表示红外成像仪对应的端口名称。（1） 双击“驱动程序 CH341SER”文件夹内的 SETUP.exe 文件弹出“驱动安装” 对话框，点击【安装】按钮，稍候弹出“驱动安装成功” 提示框，表示驱动安装完成， 点击【确定】关闭驱动安装窗口。（例如：人体的辐射率为 0.95）
评论 12
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

【ql君】qlexcel

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值