131 lines
5.1 KiB
C
131 lines
5.1 KiB
C
/**
|
|
* @copyright (C) 2017 Melexis N.V.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*
|
|
*/
|
|
#ifndef _MLX90640_API_H_
|
|
#define _MLX90640_API_H_
|
|
#include <stdint.h>
|
|
#define MLX90640_NO_ERROR 0
|
|
#define MLX90640_I2C_NACK_ERROR 1
|
|
#define MLX90640_I2C_WRITE_ERROR 2
|
|
#define MLX90640_BROKEN_PIXELS_NUM_ERROR 3
|
|
#define MLX90640_OUTLIER_PIXELS_NUM_ERROR 4
|
|
#define MLX90640_BAD_PIXELS_NUM_ERROR 5
|
|
#define MLX90640_ADJACENT_BAD_PIXELS_ERROR 6
|
|
#define MLX90640_EEPROM_DATA_ERROR 7
|
|
#define MLX90640_FRAME_DATA_ERROR 8
|
|
#define MLX90640_MEAS_TRIGGER_ERROR 9
|
|
|
|
#define BIT_MASK(x) (1UL << (x))
|
|
#define REG_MASK(sbit,nbits) ~((~(~0UL << (nbits))) << (sbit))
|
|
|
|
#define MLX90640_EEPROM_START_ADDRESS 0x2400
|
|
#define MLX90640_EEPROM_DUMP_NUM 832
|
|
#define MLX90640_PIXEL_DATA_START_ADDRESS 0x0400
|
|
#define MLX90640_PIXEL_NUM 768
|
|
#define MLX90640_LINE_NUM 24
|
|
#define MLX90640_COLUMN_NUM 32
|
|
#define MLX90640_LINE_SIZE 32
|
|
#define MLX90640_COLUMN_SIZE 24
|
|
#define MLX90640_AUX_DATA_START_ADDRESS 0x0700
|
|
#define MLX90640_AUX_NUM 64
|
|
#define MLX90640_STATUS_REG 0x8000
|
|
#define MLX90640_INIT_STATUS_VALUE 0x0030
|
|
#define MLX90640_STAT_FRAME_MASK BIT_MASK(0)
|
|
#define MLX90640_GET_FRAME(reg_value) (reg_value & MLX90640_STAT_FRAME_MASK)
|
|
#define MLX90640_STAT_DATA_READY_MASK BIT_MASK(3)
|
|
#define MLX90640_GET_DATA_READY(reg_value) (reg_value & MLX90640_STAT_DATA_READY_MASK)
|
|
|
|
#define MLX90640_CTRL_REG 0x800D
|
|
#define MLX90640_CTRL_TRIG_READY_MASK BIT_MASK(15)
|
|
#define MLX90640_CTRL_REFRESH_SHIFT 7
|
|
#define MLX90640_CTRL_REFRESH_MASK REG_MASK(MLX90640_CTRL_REFRESH_SHIFT,3)
|
|
#define MLX90640_CTRL_RESOLUTION_SHIFT 10
|
|
#define MLX90640_CTRL_RESOLUTION_MASK REG_MASK(MLX90640_CTRL_RESOLUTION_SHIFT,2)
|
|
#define MLX90640_CTRL_MEAS_MODE_SHIFT 12
|
|
#define MLX90640_CTRL_MEAS_MODE_MASK BIT_MASK(12)
|
|
|
|
#define MLX90640_MS_BYTE_SHIFT 8
|
|
#define MLX90640_MS_BYTE_MASK 0xFF00
|
|
#define MLX90640_LS_BYTE_MASK 0x00FF
|
|
#define MLX90640_MS_BYTE(reg16) ((reg16 & MLX90640_MS_BYTE_MASK) >> MLX90640_MS_BYTE_SHIFT)
|
|
#define MLX90640_LS_BYTE(reg16) (reg16 & MLX90640_LS_BYTE_MASK)
|
|
#define MLX90640_MSBITS_6_MASK 0xFC00
|
|
#define MLX90640_LSBITS_10_MASK 0x03FF
|
|
#define MLX90640_NIBBLE1_MASK 0x000F
|
|
#define MLX90640_NIBBLE2_MASK 0x00F0
|
|
#define MLX90640_NIBBLE3_MASK 0x0F00
|
|
#define MLX90640_NIBBLE4_MASK 0xF000
|
|
#define MLX90640_NIBBLE1(reg16) ((reg16 & MLX90640_NIBBLE1_MASK))
|
|
#define MLX90640_NIBBLE2(reg16) ((reg16 & MLX90640_NIBBLE2_MASK) >> 4)
|
|
#define MLX90640_NIBBLE3(reg16) ((reg16 & MLX90640_NIBBLE3_MASK) >> 8)
|
|
#define MLX90640_NIBBLE4(reg16) ((reg16 & MLX90640_NIBBLE4_MASK) >> 12)
|
|
|
|
#define POW2(x) pow(2, (double)x)
|
|
|
|
#define SCALEALPHA 0.000001
|
|
|
|
typedef struct
|
|
{
|
|
int16_t kVdd;
|
|
int16_t vdd25;
|
|
float KvPTAT;
|
|
float KtPTAT;
|
|
uint16_t vPTAT25;
|
|
float alphaPTAT;
|
|
int16_t gainEE;
|
|
float tgc;
|
|
float cpKv;
|
|
float cpKta;
|
|
uint8_t resolutionEE;
|
|
uint8_t calibrationModeEE;
|
|
float KsTa;
|
|
float ksTo[5];
|
|
int16_t ct[5];
|
|
uint16_t alpha[768];
|
|
uint8_t alphaScale;
|
|
int16_t offset[768];
|
|
int8_t kta[768];
|
|
uint8_t ktaScale;
|
|
int8_t kv[768];
|
|
uint8_t kvScale;
|
|
float cpAlpha[2];
|
|
int16_t cpOffset[2];
|
|
float ilChessC[3];
|
|
uint16_t brokenPixels[5];
|
|
uint16_t outlierPixels[5];
|
|
} paramsMLX90640;
|
|
|
|
int MLX90640_DumpEE(uint8_t slaveAddr, uint16_t *eeData);
|
|
int MLX90640_SynchFrame(uint8_t slaveAddr);
|
|
int MLX90640_TriggerMeasurement(uint8_t slaveAddr);
|
|
int MLX90640_GetFrameData(uint8_t slaveAddr, uint16_t *frameData);
|
|
int MLX90640_ExtractParameters(uint16_t *eeData, paramsMLX90640 *mlx90640);
|
|
float MLX90640_GetVdd(uint16_t *frameData, const paramsMLX90640 *params);
|
|
float MLX90640_GetTa(uint16_t *frameData, const paramsMLX90640 *params);
|
|
void MLX90640_GetImage(uint16_t *frameData, const paramsMLX90640 *params, float *result);
|
|
void MLX90640_CalculateTo(uint16_t *frameData, const paramsMLX90640 *params, float emissivity, float tr, float *result);
|
|
int MLX90640_SetResolution(uint8_t slaveAddr, uint8_t resolution);
|
|
int MLX90640_GetCurResolution(uint8_t slaveAddr);
|
|
int MLX90640_SetRefreshRate(uint8_t slaveAddr, uint8_t refreshRate);
|
|
int MLX90640_GetRefreshRate(uint8_t slaveAddr);
|
|
int MLX90640_GetSubPageNumber(uint16_t *frameData);
|
|
int MLX90640_GetCurMode(uint8_t slaveAddr);
|
|
int MLX90640_SetInterleavedMode(uint8_t slaveAddr);
|
|
int MLX90640_SetChessMode(uint8_t slaveAddr);
|
|
void MLX90640_BadPixelsCorrection(uint16_t *pixels, float *to, int mode, paramsMLX90640 *params);
|
|
|
|
#endif
|