Files
mellifera_firmware/drivers/sensor/hdc1080/hdc1080.c
2024-04-28 23:23:24 -06:00

228 lines
6.7 KiB
C

/*
* Copyright (c) 2021 Nordic Semiconductor ASA
* SPDX-License-Identifier: Apache-2.0
*/
#define DT_DRV_COMPAT ti_hdc1080
#include <zephyr/device.h>
#include <zephyr/drivers/i2c.h>
#include <zephyr/drivers/sensor.h>
#include <zephyr/sys/byteorder.h>
#include <zephyr/logging/log.h>
LOG_MODULE_REGISTER(hdc1080, CONFIG_SENSOR_LOG_LEVEL);
const uint8_t REG_TEMPERATURE = 0x00;
const uint8_t REG_HUMIDITY = 0x01;
const uint8_t REG_CONFIGURATION = 0x02;
const uint8_t REG_SERIAL_ID_0 = 0xFB;
const uint8_t REG_SERIAL_ID_1 = 0xFC;
const uint8_t REG_SERIAL_ID_2 = 0xFD;
const uint8_t REG_MANUFACTURER_ID = 0xFE;
const uint8_t REG_DEVICE_ID = 0xFF;
#define CONFIG_RST (1 << 15) ///< Software reset. This bit self clears
#define CONFIG_HEAT (1 << 13) ///< Enable heater
#define CONFIG_MODE_SEQUENTIAL (1 << 12) ///< Temperature and humidity measured in sequence, temperature first
#define CONFIG_BTST (1 << 11) ///< 1 = battery voltage < 2.8V
#define CONFIG_TRES_14BIT (0 << 10) ///< Temperature resolution
#define CONFIG_TRES_11BIT (1 << 10) ///< Temperature resolution
#define CONFIG_HRES_14BIT (0b00 << 8) ///< Humidity resolution
#define CONFIG_HRES_11BIT (0b01 << 8) ///< Humidity resolution
#define CONFIG_HRES_8BIT (0b10 << 8) ///< Humidity resolution
struct hdc1080_data
{
int16_t temperature;
uint16_t humidity;
};
struct hdc1080_config
{
struct i2c_dt_spec bus;
uint8_t temperature_bits;
uint8_t humidity_bits;
};
static int hdc1080_sample_fetch(const struct device *dev,
enum sensor_channel chan)
{
const struct hdc1080_config *config = dev->config;
struct hdc1080_data *data = dev->data;
int ret;
// Trigger measurement
uint8_t reg_addr = REG_TEMPERATURE;
i2c_write_dt(&config->bus, &reg_addr, 1);
// Wait for conversion
float temperature_conversion_time; ///< microseconds
switch (config->temperature_bits)
{
case 11:
temperature_conversion_time = 3650;
break;
case 14:
temperature_conversion_time = 6350;
break;
default:
temperature_conversion_time = 0;
break;
}
float humidity_conversion_time; ///< microseconds
switch (config->humidity_bits)
{
case 8:
humidity_conversion_time = 2500;
break;
case 11:
humidity_conversion_time = 3850;
break;
case 14:
humidity_conversion_time = 6500;
break;
default:
humidity_conversion_time = 0;
break;
}
k_busy_wait(temperature_conversion_time + humidity_conversion_time);
// Read data
uint8_t rdata[4];
ret = i2c_read_dt(&config->bus, rdata, sizeof(rdata));
if (ret < 0)
{
LOG_ERR("Failed to read temperature and humidity!");
return ret;
}
data->temperature = sys_get_be16(&rdata[0]);
data->humidity = sys_get_be16(&rdata[2]);
return 0;
}
static int hdc1080_channel_get(const struct device *dev,
enum sensor_channel chan,
struct sensor_value *val)
{
struct hdc1080_data *data = dev->data;
switch (chan)
{
case SENSOR_CHAN_AMBIENT_TEMP:
{
double temperature = data->temperature * 160.0 / (1 << 16) - 40;
val->val1 = temperature;
val->val2 = (temperature - val->val1) * 1e6;
break;
}
case SENSOR_CHAN_HUMIDITY:
{
double humidity = data->humidity * 100.0 / (1 << 16);
val->val1 = humidity;
val->val2 = (humidity - val->val1) * 1e6;
break;
}
default:
return -ENOTSUP;
}
return 0;
}
static const struct sensor_driver_api hdc1080_api = {
.sample_fetch = &hdc1080_sample_fetch,
.channel_get = &hdc1080_channel_get,
};
static int hdc1080_init(const struct device *dev)
{
const struct hdc1080_config *const config = dev->config;
int ret;
if (!device_is_ready(config->bus.bus))
{
LOG_ERR("I2C bus %s is not ready", config->bus.bus->name);
return -ENODEV;
}
uint8_t id[2];
ret = i2c_burst_read_dt(&config->bus, REG_MANUFACTURER_ID, id, sizeof(id));
if (ret < 0)
{
LOG_ERR("Failed to read manufacturer/device ID registers");
return ret;
}
uint16_t manufacturer_id = sys_get_be16(&id[0]);
const uint16_t MANUFACTURER_ID = 0x5449;
if (manufacturer_id != MANUFACTURER_ID)
{
LOG_ERR("Manufacturer ID read from %s incorrect. Read 0x%02X, expected 0x%02X", dev->name, manufacturer_id, MANUFACTURER_ID);
}
ret = i2c_burst_read_dt(&config->bus, REG_DEVICE_ID, id, sizeof(id));
if (ret < 0)
{
LOG_ERR("Failed to read manufacturer/device ID registers");
return ret;
}
uint16_t device_id = sys_get_be16(&id[0]);
const uint16_t DEVICE_ID = 0x1050;
if (device_id != DEVICE_ID)
{
LOG_ERR("Device ID read from %s incorrect. Read 0x%02X, expected 0x%02X", dev->name, device_id, DEVICE_ID);
}
// Write configuration
uint16_t cfg = 0;
switch (config->temperature_bits)
{
case 14:
cfg |= CONFIG_TRES_14BIT;
break;
case 11:
cfg |= CONFIG_TRES_11BIT;
break;
default:
LOG_ERR("Invalid temperature resolution: %d bits", config->temperature_bits);
return -1;
}
switch (config->humidity_bits)
{
case 14:
cfg |= CONFIG_HRES_14BIT;
break;
case 11:
cfg |= CONFIG_HRES_11BIT;
break;
case 8:
cfg |= CONFIG_HRES_8BIT;
break;
default:
LOG_ERR("Invalid humidity resolution: %d bits", config->humidity_bits);
return -1;
}
uint8_t wdata[2];
sys_put_be16(cfg, wdata);
i2c_burst_write_dt(&config->bus, REG_CONFIGURATION, wdata, sizeof(wdata));
return 0;
}
#define HDC1080_INIT(i) \
static struct hdc1080_data hdc1080_data_##i; \
\
static const struct hdc1080_config hdc1080_config_##i = { \
.bus = I2C_DT_SPEC_INST_GET(i), \
.temperature_bits = 14, \
.humidity_bits = 14, \
}; \
\
SENSOR_DEVICE_DT_INST_DEFINE(i, &hdc1080_init, NULL, \
&hdc1080_data_##i, \
&hdc1080_config_##i, POST_KERNEL, \
CONFIG_SENSOR_INIT_PRIORITY, &hdc1080_api);
DT_INST_FOREACH_STATUS_OKAY(HDC1080_INIT)