Loading...
Searching...
No Matches
lm75.h
Go to the documentation of this file.
1/*
2 * SPDX-FileCopyrightText: 2021 ML!PA Consulting GmbH
3 * SPDX-License-Identifier: LGPL-2.1-only
4 */
5
6#pragma once
7
18
24
25#include <stdbool.h>
26#include "periph/i2c.h"
27#include "periph/gpio.h"
28
29#ifdef __cplusplus
30extern "C" {
31#endif
32
36enum {
37 LM75_SUCCESS = 0,
38 LM75_ERROR_I2C,
39 LM75_ERROR
40};
41
45typedef struct lm75_properties {
46 uint16_t os_res;
47 uint16_t os_mult;
48 uint16_t temp_res;
49 uint16_t temp_mult;
50 uint8_t os_shift;
51 uint8_t temp_shift;
53
56
60typedef struct lm75_params {
62 uint16_t conv_rate;
63 gpio_t gpio_alarm;
65 uint8_t i2c_addr;
66 uint8_t shutdown_mode;
67 uint8_t tm_mode;
68 uint8_t polarity;
69 uint8_t fault_q;
70 /* only configurable for the TMP1075 */
71 uint8_t conv_rate_reg;
73
80
93int lm75_init(lm75_t *dev, const lm75_params_t *params);
94
110int lm75_get_temperature_raw(lm75_t *dev, int *temperature);
111
124int lm75_get_temperature(lm75_t *dev, int *temperature);
125
141int lm75_set_temp_limits(lm75_t *dev, int temp_hyst, int temp_os, gpio_cb_t cb, void *arg);
142
154int lm75_get_os_temp(lm75_t *dev, int *temperature);
155
167int lm75_get_hyst_temp(lm75_t *dev, int *temperature);
168
182int lm75_get_os_pin(lm75_t *dev, bool *os_pin_state);
183
193
203
216
235int lm75_low_power_mode(lm75_t *dev, uint16_t interval);
236
237#ifdef __cplusplus
238}
239#endif
240
Low-level GPIO peripheral driver interface definitions.
void(* gpio_cb_t)(void *arg)
Signature of event callback functions triggered from interrupts.
Definition gpio.h:143
uint_fast8_t i2c_t
Default i2c_t type definition.
Definition i2c.h:155
Low-level I2C peripheral driver interface definition.
int lm75_get_hyst_temp(lm75_t *dev, int *temperature)
Hysteresis temperature value of LM75 sensor.
int tmp1075_one_shot(lm75_t *dev)
Activates one shot conversion mode.
struct lm75_properties lm75_properties_t
temperature reading properties/resolutions struct of the LM75 sensors
lm75_properties_t tmp1075_properties
declaration present in lm75.c
int lm75_poweron(lm75_t *dev)
Deactivate the LM75 sensor shutdown mode.
int lm75_low_power_mode(lm75_t *dev, uint16_t interval)
Activates low power mode operation.
int lm75_get_os_pin(lm75_t *dev, bool *os_pin_state)
Read the current state of the OS pin to see if it's active.
int lm75_get_temperature_raw(lm75_t *dev, int *temperature)
Temperature values of LM75 sensor.
int lm75_get_temperature(lm75_t *dev, int *temperature)
Temperature values of LM75 sensor.
struct lm75 lm75_t
lm75 device descriptor
int lm75_init(lm75_t *dev, const lm75_params_t *params)
Initialization of the LM75 sensor.
lm75_properties_t lm75a_properties
declaration present in lm75.c
int lm75_poweroff(lm75_t *dev)
Activate the LM75 sensor shutdown mode.
struct lm75_params lm75_params_t
params required for initialization
int lm75_get_os_temp(lm75_t *dev, int *temperature)
Overshutdown temperature value of LM75 sensor.
int lm75_set_temp_limits(lm75_t *dev, int temp_hyst, int temp_os, gpio_cb_t cb, void *arg)
Sets the values for Overtemperature shutdown(OS) and Hysteresis temperature(HYST).
params required for initialization
Definition lm75.h:60
uint8_t shutdown_mode
Shutdown mode register.
Definition lm75.h:66
const lm75_properties_t * res
Temperature resolutions.
Definition lm75.h:61
gpio_t gpio_alarm
Over-temperature alarm.
Definition lm75.h:63
uint8_t fault_q
Fault Queue register.
Definition lm75.h:69
uint8_t conv_rate_reg
Device Conversion rate register.
Definition lm75.h:71
i2c_t i2c_bus
I2C Bus used.
Definition lm75.h:64
uint8_t i2c_addr
i2c address
Definition lm75.h:65
uint8_t polarity
OS polarity register.
Definition lm75.h:68
uint16_t conv_rate
Conversion rate in ms.
Definition lm75.h:62
uint8_t tm_mode
Thermistor Mode.
Definition lm75.h:67
temperature reading properties/resolutions struct of the LM75 sensors
Definition lm75.h:45
uint8_t os_shift
how many bits need to be shifted (2 bytes - any unused bits)
Definition lm75.h:50
uint16_t temp_mult
multiplier required for getting the temperature into ºC
Definition lm75.h:49
uint8_t temp_shift
how many bits need to be shifted (2 bytes - any unused bits)
Definition lm75.h:51
uint16_t os_res
resolution of the OS and HYST registers
Definition lm75.h:46
uint16_t os_mult
multiplier required for getting the OS and HYST into ºC
Definition lm75.h:47
uint16_t temp_res
resolution of the temperature register
Definition lm75.h:48
lm75 device descriptor
Definition lm75.h:77
lm75_params_t lm75_params
Configuration Parameters.
Definition lm75.h:78