This is 90632 example driver with virtual i2c read/write functions. There will
be some mapping needed with MCU's own i2c read/write procedures, but the core
calculations should remain the same. Functions that need to be implemented for
each individual MCU are listed in mlx90632_depends.h file.
Since there is one source and two header files they can be built also just as normal source files. They are dependent on mathlib and errno so appropriate flags are required. For ease of development and unit-testing Makefile was added with following targets:
# All targets can take `CC=clang` variable, otherwise default compiler is GCC. If
# you need to cross-compile just feed `CROSS_COMPILE` variable to Makefile
make libs # builds library with single file. Include inc/ for header definitions
make doxy # builds doxygen documentation in build/html/
make utest # builds and runs unit test program mlx90632 (dependent on ceedling)
make all # builds unit tests, doxygen documentation, coverage information and library
make coverage # builds coverage information
make clean # cleans the crap make has made
make uncrustify # style fixup of the source, header and test files
Documentation
Compiled documentation is available on melexis.github.io/mlx90632-library. Datasheet is available in Melexis documentation.
Example program flow
You can either include library directly or object file. Definitions are found
in library inc/ folder and you need to point your compiler -I flag there.
After you have your environment set you need to enter below flow to your program.
/* Before include, make sure you have BITS_PER_LONG defined. This is a CPU
* specific value which is used to generate bit masks. You can also use -D
* to input definition to compiler via command line
*/
#include "mlx90632.h"
/* Declare and implement here functions you find in mlx90632_depends.h */
/* You can use global or local storage for EEPROM register values so declare
* them whereever you want. Do not forget to declare ambient_new_raw,
* ambient_old_raw, object_new_raw, object_old_raw
*/
int main(void)
{
int32_t ret = 0; /**< Variable will store return values */
double ambient; /**< Ambient temperature in degrees Celsius */
double object; /**< Object temperature in degrees Celsius */
/* Read sensor EEPROM registers needed for calcualtions */
/* Now we read current ambient and object temperature */
ret = mlx90632_read_temp_raw(&ambient_new_raw, &ambient_old_raw,
&object_new_raw, &object_old_raw);
if(ret < 0)
/* Something went wrong - abort */
return ret;
/* Now start calculations (no more i2c accesses) */
/* Calculate ambient temperature */
ambient = mlx90632_calc_temp_ambient(ambient_new_raw, ambient_old_raw,
P_T, P_R, P_G, P_O, Gb);
/* Get preprocessed temperatures needed for object temperature calculation */
double pre_ambient = mlx90632_preprocess_temp_ambient(ambient_new_raw,
ambient_old_raw, Gb);
double pre_object = mlx90632_preprocess_temp_object(object_new_raw, object_old_raw,
ambient_new_raw, ambient_old_raw,
Ka);
/* Calculate object temperature */
object = mlx90632_calc_temp_object(pre_object, pre_ambient, Ea, Eb, Ga, Fa, Fb, Ha, Hb);
}Example program flow for extended mode
You can either include library directly or object file. Definitions are found
in library inc/ folder and you need to point your compiler -I flag there.
After you have your environment set you need to enter below flow to your program.
/* Before include, make sure you have BITS_PER_LONG defined. This is a CPU
* specific value which is used to generate bit masks. You can also use -D
* to input definition to compiler via command line
*/
#include "mlx90632.h"
/* Declare and implement here functions you find in mlx90632_depends.h */
/* You can use global or local storage for EEPROM register values so declare
* them whereever you want. Do not forget to declare ambient_new_raw,
* ambient_old_raw, object_new_raw, object_old_raw
*/
int main(void)
{
int32_t ret = 0; /**< Variable will store return values */
double ambient; /**< Ambient temperature in degrees Celsius */
double object; /**< Object temperature in degrees Celsius */
/* Read sensor EEPROM registers needed for calcualtions */
/* You can check if the device supports extended measurement mode */
ret = mlx90632_init();
if(status == ERANGE)
{
/* Extended mode is supported */
}
/* Set MLX90632 in extended mode */
ret = mlx90632_set_meas_type(MLX90632_MTYP_EXTENDED)
if(ret < 0)
/* Something went wrong - abort */
return ret;
/* Now we read current ambient and object temperature */
ret = mlx90632_read_temp_raw_extended(&ambient_new_raw, &ambient_old_raw, &object_new_raw);
if(ret < 0)
/* Something went wrong - abort */
return ret;
/* Now start calculations (no more i2c accesses) */
/* Calculate ambient temperature */
ambient = mlx90632_calc_temp_ambient_extended(ambient_new_raw, ambient_old_raw,
PT, PR, PG, PO, Gb);
/* Get preprocessed temperatures needed for object temperature calculation */
double pre_ambient = mlx90632_preprocess_temp_ambient_extended(ambient_new_raw,
ambient_old_raw, Gb);
double pre_object = mlx90632_preprocess_temp_object_extended(object_new_raw, ambient_new_raw,
ambient_old_raw, Ka);
/* Calculate object temperature assuming the reflected temperature equals ambient*/
object = mlx90632_calc_temp_object_extended(pre_object, pre_ambient, ambient, Ea, Eb, Ga, Fa, Fb, Ha, Hb);
}Example program flow for burst mode
You can either include library directly or object file. Definitions are found
in library inc/ folder and you need to point your compiler -I flag there.
After you have your environment set you need to enter below flow to your program.
/* Before include, make sure you have BITS_PER_LONG defined. This is a CPU
* specific value which is used to generate bit masks. You can also use -D
* to input definition to compiler via command line
*/
#include "mlx90632.h"
/* Declare and implement here functions you find in mlx90632_depends.h */
/* You can use global or local storage for EEPROM register values so declare
* them whereever you want. Do not forget to declare ambient_new_raw,
* ambient_old_raw, object_new_raw, object_old_raw
*/
int main(void)
{
int32_t ret = 0; /**< Variable will store return values */
double ambient; /**< Ambient temperature in degrees Celsius */
double object; /**< Object temperature in degrees Celsius */
/* Read sensor EEPROM registers needed for calcualtions */
/* Set MLX90632 in burst mode */
ret = mlx90632_set_meas_type(MLX90632_MTYP_MEDICAL_BURST)
if(ret < 0)
/* Something went wrong - abort */
return ret;
/* Now we read current ambient and object temperature */
ret = mlx90632_read_temp_raw_burst(&ambient_new_raw, &ambient_old_raw,
&object_new_raw, &object_old_raw);
if(ret < 0)
/* Something went wrong - abort */
return ret;
/* Now start calculations (no more i2c accesses) */
/* Calculate ambient temperature */
ambient = mlx90632_calc_temp_ambient(ambient_new_raw, ambient_old_raw,
P_T, P_R, P_G, P_O, Gb);
/* Get preprocessed temperatures needed for object temperature calculation */
double pre_ambient = mlx90632_preprocess_temp_ambient(ambient_new_raw,
ambient_old_raw, Gb);
double pre_object = mlx90632_preprocess_temp_object(object_new_raw, object_old_raw,
ambient_new_raw, ambient_old_raw,
Ka);
/* Calculate object temperature assuming the reflected temperature equals ambient*/
object = mlx90632_calc_temp_object_reflected(pre_object, pre_ambient,ambient, Ea, Eb, Ga, Fa, Fb, Ha, Hb);
}Example program flow for extended burst mode
You can either include library directly or object file. Definitions are found
in library inc/ folder and you need to point your compiler -I flag there.
After you have your environment set you need to enter below flow to your program.
/* Before include, make sure you have BITS_PER_LONG defined. This is a CPU
* specific value which is used to generate bit masks. You can also use -D
* to input definition to compiler via command line
*/
#include "mlx90632.h"
/* Declare and implement here functions you find in mlx90632_depends.h */
/* You can use global or local storage for EEPROM register values so declare
* them whereever you want. Do not forget to declare ambient_new_raw,
* ambient_old_raw, object_new_raw, object_old_raw
*/
int main(void)
{
int32_t ret = 0; /**< Variable will store return values */
double ambient; /**< Ambient temperature in degrees Celsius */
double object; /**< Object temperature in degrees Celsius */
/* Read sensor EEPROM registers needed for calcualtions */
/* You can check if the device supports extended measurement mode */
ret = mlx90632_init();
if(status == ERANGE)
{
/* Extended mode is supported */
}
/* Set MLX90632 in extended burst mode */
ret = mlx90632_set_meas_type(MLX90632_MTYP_EXTENDED_BURST)
if(ret < 0)
/* Something went wrong - abort */
return ret;
/* Now we read current ambient and object temperature */
ret = mlx90632_read_temp_raw_extended_burst(&ambient_new_raw, &ambient_old_raw, &object_new_raw);
if(ret < 0)
/* Something went wrong - abort */
return ret;
/* Now start calculations (no more i2c accesses) */
/* Calculate ambient temperature */
ambient = mlx90632_calc_temp_ambient_extended(ambient_new_raw, ambient_old_raw,
PT, PR, PG, PO, Gb);
/* Get preprocessed temperatures needed for object temperature calculation */
double pre_ambient = mlx90632_preprocess_temp_ambient_extended(ambient_new_raw,
ambient_old_raw, Gb);
double pre_object = mlx90632_preprocess_temp_object_extended(object_new_raw, ambient_new_raw,
ambient_old_raw, Ka);
/* Calculate object temperature assuming the reflected temperature equals ambient*/
object = mlx90632_calc_temp_object_extended(pre_object, pre_ambient, ambient, Ea, Eb, Ga, Fa, Fb, Ha, Hb);
}Dependencies for library unit-testing
Because of increased functionality and code size unit test, mocking and building
framework Ceedling was picked to ease
and validate development. It is an established open-source framework that brings
in additional dependency to ruby and rake (see .gitlab-ci file), but it allowed
faster development with automatic mocking (CMock)
and wider range of unit test macros (Unity).
Because of it, cloning repository requires adding a --recursive flag
(so git clone --recursive <url> <destination>) or initialization of submodules
afterwards using git submodule update --init --recursive.