ESPHome 2026.3.0-dev
Loading...
Searching...
No Matches
i2c_sensirion.h
Go to the documentation of this file.
1#pragma once
4
5#include <vector>
6
7namespace esphome {
8namespace sensirion_common {
9
18static const uint8_t CRC_POLYNOMIAL = 0x31; // default for Sensirion
19
21 public:
22 enum CommandLen : uint8_t { ADDR_8_BIT = 1, ADDR_16_BIT = 2 };
23
28 static inline const char *sensirion_convert_to_string_in_place(uint16_t *array, size_t length) {
29 for (size_t i = 0; i < length; i++) {
30 array[i] = convert_big_endian(array[i]);
31 }
32 return reinterpret_cast<const char *>(array);
33 }
34
41 bool read_data(uint16_t *data, uint8_t len);
42
47 bool read_data(uint16_t &data) { return this->read_data(&data, 1); }
48
57 bool get_register(uint16_t command, uint16_t *data, uint8_t len, uint8_t delay = 0) {
58 return get_register_(command, ADDR_16_BIT, data, len, delay);
59 }
66 bool get_register(uint16_t i2c_register, uint16_t &data, uint8_t delay = 0) {
67 return this->get_register_(i2c_register, ADDR_16_BIT, &data, 1, delay);
68 }
69
78 bool get_8bit_register(uint8_t i2c_register, uint16_t *data, uint8_t len, uint8_t delay = 0) {
79 return get_register_(i2c_register, ADDR_8_BIT, data, len, delay);
80 }
81
88 bool get_8bit_register(uint8_t i2c_register, uint16_t &data, uint8_t delay = 0) {
89 return this->get_register_(i2c_register, ADDR_8_BIT, &data, 1, delay);
90 }
91
96 template<class T> bool write_command(T i2c_register) { return write_command(i2c_register, nullptr, 0); }
97
103 template<class T> bool write_command(T i2c_register, uint16_t data) { return write_command(i2c_register, &data, 1); }
104
110 template<class T> bool write_command(T i2c_register, const std::vector<uint16_t> &data) {
111 return write_command_(i2c_register, sizeof(T), data.data(), data.size());
112 }
113
120 template<class T> bool write_command(T i2c_register, const uint16_t *data, uint8_t len) {
121 // limit to 8 or 16 bit only
122 static_assert(sizeof(i2c_register) == 1 || sizeof(i2c_register) == 2, "Only 8 or 16 bit command types supported");
123 return write_command_(i2c_register, CommandLen(sizeof(T)), data, len);
124 }
125
126 protected:
134 bool write_command_(uint16_t command, CommandLen command_len, const uint16_t *data, uint8_t data_len);
135
145 bool get_register_(uint16_t reg, CommandLen command_len, uint16_t *data, uint8_t len, uint8_t delay);
146
150};
151
152} // namespace sensirion_common
153} // namespace esphome
This Class provides the methods to read/write bytes from/to an i2c device.
Definition i2c.h:132
I2CRegister reg(uint8_t a_register)
calls the I2CRegister constructor
Definition i2c.h:152
bool get_register_(uint16_t reg, CommandLen command_len, uint16_t *data, uint8_t len, uint8_t delay)
get data words from I2C register.
i2c::ErrorCode last_error_
last error code from I2C operation
bool write_command(T i2c_register, const std::vector< uint16_t > &data)
Write a command with arguments as words.
bool get_8bit_register(uint8_t i2c_register, uint16_t *data, uint8_t len, uint8_t delay=0)
get data words from I2C register.
bool get_register(uint16_t command, uint16_t *data, uint8_t len, uint8_t delay=0)
get data words from I2C register.
bool get_8bit_register(uint8_t i2c_register, uint16_t &data, uint8_t delay=0)
Read 1 data word from 8 bit I2C register.
bool write_command(T i2c_register, uint16_t data)
Write a command and one data word to the I2C device .
bool get_register(uint16_t i2c_register, uint16_t &data, uint8_t delay=0)
Read 1 data word from 16 bit I2C register.
bool write_command(T i2c_register)
Write a command to the I2C device.
bool read_data(uint16_t *data, uint8_t len)
Read data words from I2C device.
bool read_data(uint16_t &data)
Read 1 data word from I2C device.
bool write_command_(uint16_t command, CommandLen command_len, const uint16_t *data, uint8_t data_len)
Write a command with arguments as words.
bool write_command(T i2c_register, const uint16_t *data, uint8_t len)
Write a command with arguments as words.
static const char * sensirion_convert_to_string_in_place(uint16_t *array, size_t length)
This function performs an in-place conversion of the provided buffer from uint16_t values to big endi...
ErrorCode
Error codes returned by I2CBus and I2CDevice methods.
Definition i2c_bus.h:12
Providing packet encoding functions for exchanging data with a remote host.
Definition a01nyub.cpp:7
constexpr T convert_big_endian(T val)
Convert a value between host byte order and big endian (most significant byte first) order.
Definition helpers.h:709
std::string size_t len
Definition helpers.h:817
void HOT delay(uint32_t ms)
Definition core.cpp:27
uint16_t length
Definition tt21100.cpp:0