feat(firmware): support configurable SEN54 and SEN66 boards

Add the pinned Sensirion SEN66 driver, central sensor and board profiles, and a separate GPIO I2C bus for SEN66 with display. Preserve the original display layout and keep NOx and CO2 in InfluxDB. Include protocol tests, hardware workflow documentation and verified deployment results without credentials.
This commit is contained in:
root
2026-11-09 21:44:04 +00:00
parent 45b05d045a
commit 69bb47dda1
27 changed files with 2634 additions and 111 deletions
+1 -1
View File
@@ -2,4 +2,4 @@ file(GLOB_RECURSE SRC_FILES "*.c")
idf_component_register(SRCS ${SRC_FILES}
INCLUDE_DIRS "."
REQUIRES "esp_lcd" "driver" "esp_adc" "esp_lcd_jd9853" "esp_lcd_touch_axs5106" "fatfs" "nvs_flash" "lwip" "esp_wifi")
REQUIRES "hardware_config" "esp_lcd" "driver" "esp_adc" "esp_lcd_jd9853" "esp_lcd_touch_axs5106" "fatfs" "nvs_flash" "lwip" "esp_wifi")
+5 -3
View File
@@ -4,9 +4,11 @@
#include "driver/i2c_master.h"
#include "driver/gpio.h"
#define EXAMPLE_PIN_I2C_SDA GPIO_NUM_18
#define EXAMPLE_PIN_I2C_SCL GPIO_NUM_19
#define I2C_PORT_NUM 0
#include "hardware_config.h"
#define EXAMPLE_PIN_I2C_SDA NANOPSX_I2C_SDA
#define EXAMPLE_PIN_I2C_SCL NANOPSX_I2C_SCL
#define I2C_PORT_NUM NANOPSX_I2C_PORT
#ifdef __cplusplus
extern "C" {
+14 -3
View File
@@ -7,7 +7,7 @@
#include "esp_log.h"
#include "bsp_touch.h"
void bsp_touch_init(esp_lcd_touch_handle_t *touch_handle, i2c_master_bus_handle_t bus_handle, uint16_t xmax, uint16_t ymax, uint16_t rotation)
esp_err_t bsp_touch_init(esp_lcd_touch_handle_t *touch_handle, i2c_master_bus_handle_t bus_handle, uint16_t xmax, uint16_t ymax, uint16_t rotation)
{
static i2c_master_dev_handle_t dev_handle;
i2c_device_config_t dev_cfg = {
@@ -15,7 +15,9 @@ void bsp_touch_init(esp_lcd_touch_handle_t *touch_handle, i2c_master_bus_handle_
.device_address = ESP_LCD_TOUCH_IO_I2C_AXS5106_ADDRESS,
.scl_speed_hz = 400000,
};
ESP_ERROR_CHECK(i2c_master_bus_add_device(bus_handle, &dev_cfg, &dev_handle));
*touch_handle = NULL;
esp_err_t err = i2c_master_bus_add_device(bus_handle, &dev_cfg, &dev_handle);
if (err != ESP_OK) return err;
esp_lcd_touch_config_t tp_cfg = {};
tp_cfg.x_max = xmax < ymax ? xmax : ymax;
@@ -48,5 +50,14 @@ void bsp_touch_init(esp_lcd_touch_handle_t *touch_handle, i2c_master_bus_handle_
tp_cfg.flags.mirror_y = 0;
}
ESP_ERROR_CHECK(esp_lcd_touch_new_i2c_axs5106(dev_handle, &tp_cfg, touch_handle));
err = esp_lcd_touch_new_i2c_axs5106(dev_handle, &tp_cfg, touch_handle);
if (err == ESP_OK) {
err = i2c_master_probe(bus_handle, dev_cfg.device_address, 100);
if (err != ESP_OK) esp_lcd_touch_del(*touch_handle);
}
if (err != ESP_OK) {
i2c_master_bus_rm_device(dev_handle);
*touch_handle = NULL;
}
return err;
}
+1 -1
View File
@@ -13,7 +13,7 @@
extern "C" {
#endif
void bsp_touch_init(esp_lcd_touch_handle_t *touch_handle, i2c_master_bus_handle_t bus_handle, uint16_t xmax, uint16_t ymax, uint16_t rotation);
esp_err_t bsp_touch_init(esp_lcd_touch_handle_t *touch_handle, i2c_master_bus_handle_t bus_handle, uint16_t xmax, uint16_t ymax, uint16_t rotation);
#ifdef __cplusplus
}
#endif
@@ -0,0 +1 @@
idf_component_register(INCLUDE_DIRS ".")
@@ -0,0 +1,72 @@
#pragma once
/* Central build-time hardware selection. See firmware/HARDWARE.md.
* Select sensor and board independently; no credentials belong in this file.
*/
#define NANOPSX_SENSOR_SEN54 54
#define NANOPSX_SENSOR_SEN66 66
#define NANOPSX_BOARD_C6_DISPLAY_8MB 1
#define NANOPSX_BOARD_C6_DEVKIT_8MB 2
#ifndef NANOPSX_SENSOR
#define NANOPSX_SENSOR NANOPSX_SENSOR_SEN66
#endif
#ifndef NANOPSX_BOARD
#define NANOPSX_BOARD NANOPSX_BOARD_C6_DISPLAY_8MB
#endif
/* SEN66 retains its known GPIO7/8 wiring. With a display the sole HP I2C
* controller serves touch on GPIO18/19, so the sensor uses a GPIO bus.
* SEN54 retains the existing shared hardware-bus wiring.
*/
#if NANOPSX_SENSOR == NANOPSX_SENSOR_SEN66
#define NANOPSX_SENSOR_SDA 7
#define NANOPSX_SENSOR_SCL 8
#else
#define NANOPSX_SENSOR_SDA NANOPSX_I2C_SDA
#define NANOPSX_SENSOR_SCL NANOPSX_I2C_SCL
#endif
#define NANOPSX_SENSOR_SOFT_I2C \
(NANOPSX_SENSOR_SDA != NANOPSX_I2C_SDA || NANOPSX_SENSOR_SCL != NANOPSX_I2C_SCL)
#if NANOPSX_BOARD == NANOPSX_BOARD_C6_DISPLAY_8MB
#define NANOPSX_BOARD_NAME "ESP32-C6 display / 8 MB"
#define NANOPSX_HAS_DISPLAY 1
#define NANOPSX_I2C_SDA 18
#define NANOPSX_I2C_SCL 19
#elif NANOPSX_BOARD == NANOPSX_BOARD_C6_DEVKIT_8MB
#define NANOPSX_BOARD_NAME "ESP32-C6 devkit / 8 MB"
#define NANOPSX_HAS_DISPLAY 0
#define NANOPSX_I2C_SDA 7
#define NANOPSX_I2C_SCL 8
#else
#error "Unsupported NANOPSX_BOARD: add a reviewed board profile first"
#endif
#define NANOPSX_I2C_PORT 0
#define NANOPSX_FLASH_BYTES 8388608
#if NANOPSX_SENSOR == NANOPSX_SENSOR_SEN54
#define NANOPSX_SENSOR_NAME "SEN54"
#define NANOPSX_SENSOR_ADDRESS 0x69
#define NANOPSX_SENSOR_I2C_HZ 400000
#elif NANOPSX_SENSOR == NANOPSX_SENSOR_SEN66
#define NANOPSX_SENSOR_NAME "SEN66"
#define NANOPSX_SENSOR_ADDRESS 0x6b
#define NANOPSX_SENSOR_I2C_HZ 100000
#else
#error "Unsupported NANOPSX_SENSOR: use SEN54 or SEN66"
#endif
/* Board profiles describe wiring/peripherals, not a replacement for the
* PlatformIO chip, SDK configuration and partition-table selection.
*/
#ifdef ESP_PLATFORM
#include "sdkconfig.h"
#if !CONFIG_IDF_TARGET_ESP32C6
#error "These board profiles require ESP32-C6"
#endif
#if !CONFIG_ESPTOOLPY_FLASHSIZE_8MB
#error "These board profiles require the 8 MB SDK/partition configuration"
#endif
#endif
+5 -1
View File
@@ -1,11 +1,13 @@
idf_component_register(
SRCS
"sen5x_i2c.c"
"sen66_i2c.c"
"sensirion_common.c"
"sensirion_i2c.c"
"sensirion_i2c_hal.c"
"sensor_soft_i2c.c"
"i2cdev.c"
"sen5x_app.c"
"air_sensor_app.c"
INCLUDE_DIRS
"."
REQUIRES
@@ -14,4 +16,6 @@ idf_component_register(
log
net_influx
eez_gui
storage
hardware_config
)
@@ -0,0 +1,29 @@
BSD 3-Clause License
Copyright (c) 2026, Sensirion AG
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
3. Neither the name of the copyright holder nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
@@ -0,0 +1,19 @@
# Sensirion driver provenance
Source: https://github.com/Sensirion/embedded-i2c-sen66
Pinned commit: `31cae0dd5253d256e8e647408ea1c544eff5d1c2` (retrieved 2026-11-09).
Unmodified upstream files: `sen66_i2c.c`, `sen66_i2c.h`, `sensirion_common.c`,
`sensirion_common.h`, `sensirion_i2c.c`, `sensirion_i2c.h`, `sensirion_config.h`.
License: `LICENSE.sensirion` (BSD-3-Clause). The common helpers also provide the
API used by the existing SEN5x driver. `sensirion_i2c_hal.c` remains our ESP-IDF
port using the shared, mutex-protected i2cdev hardware bus when sensor and
board pins match. SEN66 with the display uses a separate local open-drain GPIO
I2C engine (`sensor_soft_i2c.c/.h`) on GPIO7/8; touch retains hardware I2C on
GPIO18/19. The GPIO engine has its own wire-level ACK/NACK/stretch/timeout tests.
No upstream example HAL is
compiled. The manufacturer driver files retain their original copyright text.
`sen5x_i2c.c/.h` are the existing SEN5x driver; `air_sensor_app.c` selects the
SEN54 or SEN66 command API at compile time using `hardware_config.h`.
@@ -1,6 +1,6 @@
// File: src/sen5x_app.c
// File: src/air_sensor_app.c
#include "sen5x_app.h"
#include "air_sensor_app.h"
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
@@ -9,7 +9,12 @@
#include "esp_log.h"
#include "sensirion_i2c_hal.h"
#include "sensirion_i2c_esp32_config.h"
#include "hardware_config.h"
#if NANOPSX_SENSOR == NANOPSX_SENSOR_SEN66
#include "sen66_i2c.h"
#else
#include "sen5x_i2c.h"
#endif
#include "net_influx.h"
#include "storage.h"
@@ -20,11 +25,11 @@
#include <math.h> // NAN, isfinite, lround
#include "vars.h"
static const char* TAG = "sen5x_app";
static const char* TAG = "air_sensor_app";
/* ====================== Konfiguration ====================== */
#define SEN5X_PROD_STACK 4096
#define SEN5X_PROD_PRIO 6 // Producer leicht höher priorisiert
#define AIR_SENSOR_PROD_STACK 4096
#define AIR_SENSOR_PROD_PRIO 6 // Producer leicht höher priorisiert
// Influx worker runtime (läuft in net_influx.c)
#define INFLUX_QUEUE_LEN 16
@@ -42,7 +47,7 @@ typedef struct {
uint16_t pm1p0, pm2p5, pm4p0, pm10p0; // Rohwerte (x10)
float temp_c, rh_pct; // skaliert
int16_t voc_idx, nox_idx; // Rohwerte (x10)
} sen5x_sample_t;
} air_sensor_sample_t;
static bool g_inited = false;
static bool g_run = false;
@@ -68,52 +73,54 @@ static char* g_device_tag = NULL; // z.B. "device=xyz"
} \
} while (0)
/* ====================== Lokale Float-Wrapper (optional) ====================== */
static int16_t sen5x_read_measured_values_float(float* pm1p0, float* pm2p5,
float* pm4p0, float* pm10p0,
float* rh, float* t,
float* voc, float* nox) {
uint16_t pm1_i=0, pm2_i=0, pm4_i=0, pm10_i=0;
int16_t rh_i=0, t_i=0, voc_i=0, nox_i=0;
int16_t err = sen5x_read_measured_values(&pm1_i, &pm2_i, &pm4_i, &pm10_i,
&rh_i, &t_i, &voc_i, &nox_i);
if (err) return err;
if (pm1p0) *pm1p0 = (pm1_i == 0xFFFF) ? NAN : pm1_i / 10.0f;
if (pm2p5) *pm2p5 = (pm2_i == 0xFFFF) ? NAN : pm2_i / 10.0f;
if (pm4p0) *pm4p0 = (pm4_i == 0xFFFF) ? NAN : pm4_i / 10.0f;
if (pm10p0) *pm10p0 = (pm10_i == 0xFFFF) ? NAN : pm10_i / 10.0f;
if (rh) *rh = (rh_i == 0x7FFF) ? NAN : rh_i / 100.0f;
if (t) *t = (t_i == 0x7FFF) ? NAN : t_i / 200.0f;
if (voc) *voc = (voc_i == 0x7FFF) ? NAN : voc_i / 10.0f;
if (nox) *nox = (nox_i == 0x7FFF) ? NAN : nox_i / 10.0f;
return 0;
/* One selected command set; shared HAL and presentation/Influx pipeline. */
static int16_t sensor_ready(bool *ready) {
#if NANOPSX_SENSOR == NANOPSX_SENSOR_SEN66
uint8_t padding;
return sen66_get_data_ready(&padding, ready);
#else
return sen5x_read_data_ready(ready);
#endif
}
static int16_t sen5x_read_measured_pm_values_float(float* pm1, float* pm2,
float* pm4, float* pm10,
float* n05, float* n10,
float* n25, float* n40,
float* n100, float* dtyp) {
uint16_t pm1_i=0, pm2_i=0, pm4_i=0, pm10_i=0, n05_i=0, n10_i=0, n25_i=0, n40_i=0, n100_i=0, dtyp_i=0;
int16_t err = sen5x_read_measured_pm_values(&pm1_i, &pm2_i, &pm4_i, &pm10_i,
&n05_i, &n10_i, &n25_i, &n40_i, &n100_i, &dtyp_i);
if (err) return err;
static int16_t sensor_read(uint16_t *pm1, uint16_t *pm2, uint16_t *pm4,
uint16_t *pm10, int16_t *rh, int16_t *temp,
int16_t *voc, int16_t *nox, uint16_t *co2) {
#if NANOPSX_SENSOR == NANOPSX_SENSOR_SEN66
return sen66_read_measured_values_as_integers(pm1, pm2, pm4, pm10,
rh, temp, voc, nox, co2);
#else
*co2 = UINT16_MAX; // SEN54 has no CO2 channel: never submit a fake zero.
return sen5x_read_measured_values(pm1, pm2, pm4, pm10, rh, temp, voc, nox);
#endif
}
if (pm1) *pm1 = (pm1_i == 0xFFFF) ? NAN : pm1_i / 10.0f;
if (pm2) *pm2 = (pm2_i == 0xFFFF) ? NAN : pm2_i / 10.0f;
if (pm4) *pm4 = (pm4_i == 0xFFFF) ? NAN : pm4_i / 10.0f;
if (pm10) *pm10 = (pm10_i == 0xFFFF) ? NAN : pm10_i / 10.0f;
static int16_t sensor_start(void) {
#if NANOPSX_SENSOR == NANOPSX_SENSOR_SEN66
sen66_init(NANOPSX_SENSOR_ADDRESS);
// A sensor can keep measuring across an ESP-only reset.
int16_t rc = sen66_stop_measurement();
if (rc) return rc;
int8_t product[32] = {0};
rc = sen66_get_product_name(product, sizeof(product) - 1);
if (rc) return rc;
if (strncmp((const char *)product, "SEN66", 5) != 0) {
ESP_LOGE(TAG, "Expected SEN66, product=%s", (char *)product);
return -1;
}
ESP_LOGI(TAG, "Sensor identified: %s", (char *)product);
return sen66_start_continuous_measurement();
#else
return sen5x_start_measurement();
#endif
}
if (n05) *n05 = (n05_i == 0xFFFF) ? NAN : n05_i / 10.0f;
if (n10) *n10 = (n10_i == 0xFFFF) ? NAN : n10_i / 10.0f;
if (n25) *n25 = (n25_i == 0xFFFF) ? NAN : n25_i / 10.0f;
if (n40) *n40 = (n40_i == 0xFFFF) ? NAN : n40_i / 10.0f;
if (n100) *n100 = (n100_i == 0xFFFF) ? NAN : n100_i / 10.0f;
if (dtyp) *dtyp = (dtyp_i == 0xFFFF) ? NAN : dtyp_i / 1000.0f; // µm
return 0;
static int16_t sensor_stop(void) {
#if NANOPSX_SENSOR == NANOPSX_SENSOR_SEN66
return sen66_stop_measurement();
#else
return sen5x_stop_measurement();
#endif
}
/* ====================== App-Context: Device Tag ====================== */
@@ -137,7 +144,7 @@ static esp_err_t make_device_tag_once(void) {
}
/* ====================== Producer-Task ====================== */
static void sen5x_task_producer(void* arg) {
static void air_sensor_task_producer(void* arg) {
(void)arg;
const TickType_t period = pdMS_TO_TICKS(1000); // exakt 1 Hz
@@ -147,26 +154,26 @@ static void sen5x_task_producer(void* arg) {
for (; g_run; ) {
bool ready = false;
int16_t rc = sen5x_read_data_ready(&ready);
int16_t rc = sensor_ready(&ready);
if (rc != 0) {
ESP_LOGW(TAG, "sen5x_read_data_ready error: %d", (int)rc);
ESP_LOGW(TAG, "sensor_ready error: %d", (int)rc);
} else if (ready) {
uint16_t pm1p0=0, pm2p5=0, pm4p0=0, pm10p0=0;
uint16_t pm1p0=0, pm2p5=0, pm4p0=0, pm10p0=0, co2_raw=UINT16_MAX;
int16_t rh_raw=0, t_raw=0, voc_idx=0, nox_idx=0;
rc = sen5x_read_measured_values(&pm1p0, &pm2p5, &pm4p0, &pm10p0,
&rh_raw, &t_raw, &voc_idx, &nox_idx);
rc = sensor_read(&pm1p0, &pm2p5, &pm4p0, &pm10p0,
&rh_raw, &t_raw, &voc_idx, &nox_idx, &co2_raw);
if (rc != 0) {
ESP_LOGW(TAG, "sen5x_read_measured_values error: %d", (int)rc);
ESP_LOGW(TAG, "sensor_read error: %d", (int)rc);
} else {
// Roh → Struct (wie bisher)
sen5x_sample_t s = {
air_sensor_sample_t s = {
.pm1p0 = pm1p0,
.pm2p5 = pm2p5,
.pm4p0 = pm4p0,
.pm10p0 = pm10p0,
.temp_c = ((float)t_raw) / 200.0f,
.rh_pct = ((float)rh_raw) / 100.0f,
.temp_c = (t_raw == INT16_MAX) ? NAN : ((float)t_raw) / 200.0f,
.rh_pct = (rh_raw == INT16_MAX) ? NAN : ((float)rh_raw) / 100.0f,
.voc_idx = voc_idx,
.nox_idx = nox_idx
};
@@ -212,6 +219,12 @@ static void sen5x_task_producer(void* arg) {
const double nox = (s.nox_idx == 0x7FFF) ? NAN : ((double)s.nox_idx / 10.0);
const double temp = (double)s.temp_c;
const double rh = (double)s.rh_pct;
const double co2 = (co2_raw == UINT16_MAX) ? NAN : (double)co2_raw;
static unsigned samples;
if (++samples % 10 == 0) {
ESP_LOGI(TAG, "%s sample: PM2.5=%.1f temp=%.2f rh=%.2f CO2=%.0f",
NANOPSX_SENSOR_NAME, pm2_5, temp, rh, co2);
}
net_influx_field_t f[] = {
{ .key="pm1", .type=NET_INFLUX_F_FLOAT, .precision=1, .v.f=pm1 },
@@ -222,6 +235,7 @@ static void sen5x_task_producer(void* arg) {
{ .key="rh", .type=NET_INFLUX_F_FLOAT, .precision=3, .v.f=rh },
{ .key="voc", .type=NET_INFLUX_F_FLOAT, .precision=1, .v.f=voc },
{ .key="nox", .type=NET_INFLUX_F_FLOAT, .precision=1, .v.f=nox },
{ .key="co2", .type=NET_INFLUX_F_FLOAT, .precision=0, .v.f=co2 },
};
net_influx_point_t p = {
@@ -245,14 +259,14 @@ static void sen5x_task_producer(void* arg) {
}
/* ====================== Öffentliche API ====================== */
esp_err_t sen5x_app_init(const sen5x_i2c_cfg_t* cfg) {
esp_err_t air_sensor_app_init(const air_sensor_i2c_cfg_t* cfg) {
if (g_inited) {
ESP_LOGW(TAG, "already initialized");
return ESP_OK;
}
if (!cfg) return ESP_ERR_INVALID_ARG;
ESP_LOGI(TAG, "Initializing SEN5x app...");
ESP_LOGI(TAG, "Initializing selected air sensor...");
// 1) I2C-Subsystem
@@ -274,7 +288,7 @@ esp_err_t sen5x_app_init(const sen5x_i2c_cfg_t* cfg) {
CHECK_ESP_OR_RET(sensirion_i2c_esp32_ok());
// 4) Messung starten
CHECK_SEN_OR_RET(sen5x_start_measurement());
CHECK_SEN_OR_RET(sensor_start());
ESP_LOGI(TAG, "Measurement started.");
// 5) Device Tag (App-Kontext)
@@ -299,7 +313,7 @@ esp_err_t sen5x_app_init(const sen5x_i2c_cfg_t* cfg) {
return ESP_OK;
}
void sen5x_app_deinit(void) {
void air_sensor_app_deinit(void) {
if (!g_inited) return;
ESP_LOGI(TAG, "Deinitializing SEN5x app...");
@@ -311,8 +325,8 @@ void sen5x_app_deinit(void) {
}
if (g_task_prod) {
ESP_LOGW(TAG, "Producer did not stop in time; skip sen5x_stop_measurement/HAL free");
// Hier NICHT sen5x_stop_measurement() / HAL free, weil Task evtl. noch I2C nutzt
ESP_LOGW(TAG, "Producer did not stop in time; skip sensor_stop/HAL free");
// Hier NICHT sensor_stop() / HAL free, weil Task evtl. noch I2C nutzt
return;
}
@@ -323,33 +337,33 @@ void sen5x_app_deinit(void) {
g_device_tag = NULL;
}
sen5x_stop_measurement();
sensor_stop();
sensirion_i2c_hal_free();
// i2cdev_done(); // NICHT hier, da Bus global genutzt wird
g_inited = false;
ESP_LOGI(TAG, "SEN5x app deinitialized.");
ESP_LOGI(TAG, "Air sensor app deinitialized.");
}
/**
* Kompatibilität zur bisherigen main.c:
* Diese Task fungiert nun als "Launcher": startet Producer und beendet sich dann.
* In main.c bleibt der Aufruf von xTaskCreate(sen5x_app_task, ...) unverändert.
* In main.c bleibt der Aufruf von xTaskCreate(air_sensor_app_task, ...) unverändert.
*/
void sen5x_app_task(void* arg) {
void air_sensor_app_task(void* arg) {
(void)arg;
if (!g_inited) {
ESP_LOGE(TAG, "sen5x_app_task called before sen5x_app_init()");
ESP_LOGE(TAG, "air_sensor_app_task called before air_sensor_app_init()");
vTaskDelete(NULL);
return;
}
// Producer starten
if (xTaskCreate(sen5x_task_producer, "sen5x_prod",
SEN5X_PROD_STACK, NULL, SEN5X_PROD_PRIO, &g_task_prod) != pdPASS) {
if (xTaskCreate(air_sensor_task_producer, "air_sensor_prod",
AIR_SENSOR_PROD_STACK, NULL, AIR_SENSOR_PROD_PRIO, &g_task_prod) != pdPASS) {
ESP_LOGE(TAG, "Failed to create producer task");
vTaskDelete(NULL);
return;
@@ -5,20 +5,20 @@
// Schlanke I2C/HAL-Konfiguration (wie zuvor genutzt)
typedef struct {
uint8_t addr; // 7-bit I2C-Adresse (0x69)
uint8_t addr; // selected sensor, 7-bit I2C address
int port; // I2C Port (0)
int sda; // GPIO SDA
int scl; // GPIO SCL
bool sda_pullup; // interne Pullups
bool scl_pullup; // interne Pullups
uint32_t freq; // I2C Takt (Hz, z.B. 400000)
} sen5x_i2c_cfg_t;
} air_sensor_i2c_cfg_t;
// Initialisiert I2C/Treiber/HAL und startet die Messung
esp_err_t sen5x_app_init(const sen5x_i2c_cfg_t* cfg);
esp_err_t air_sensor_app_init(const air_sensor_i2c_cfg_t* cfg);
// Endlosschleife (Pollt "data ready" und loggt Messwerte); als FreeRTOS-Task nutzbar
void sen5x_app_task(void* arg);
void air_sensor_app_task(void* arg);
// Stoppt Messung & gibt Ressourcen frei (optional aufzurufen z.B. bei Shutdown)
void sen5x_app_deinit(void);
void air_sensor_app_deinit(void);
+798
View File
@@ -0,0 +1,798 @@
/*
* THIS FILE IS AUTOMATICALLY GENERATED
*
* Generator: sensirion-driver-generator 1.7.0
* Product: sen66
* Model-Version: 1.7.3
*/
/*
* Copyright (c) 2026, Sensirion AG
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
*
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* * Neither the name of Sensirion AG nor the names of its
* contributors may be used to endorse or promote products derived from
* this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
#include "sen66_i2c.h"
#include "sensirion_common.h"
#include "sensirion_i2c.h"
#include "sensirion_i2c_hal.h"
#define sensirion_hal_sleep_us sensirion_i2c_hal_sleep_usec
static uint8_t communication_buffer[48] = {0};
static uint8_t _i2c_address;
void sen66_init(uint8_t i2c_address) {
_i2c_address = i2c_address;
}
int16_t sen66_get_voc_algorithm_tuning_parameters(
int16_t* index_offset, int16_t* learning_time_offset_hours,
int16_t* learning_time_gain_hours, int16_t* gating_max_duration_minutes,
int16_t* std_initial, int16_t* gain_factor) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset,
SEN66_GET_VOC_ALGORITHM_TUNING_PARAMETERS_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
local_error = sensirion_i2c_read_data_inplace(_i2c_address, buffer_ptr, 12);
if (local_error != NO_ERROR) {
return local_error;
}
*index_offset = sensirion_common_bytes_to_int16_t(&buffer_ptr[0]);
*learning_time_offset_hours =
sensirion_common_bytes_to_int16_t(&buffer_ptr[2]);
*learning_time_gain_hours =
sensirion_common_bytes_to_int16_t(&buffer_ptr[4]);
*gating_max_duration_minutes =
sensirion_common_bytes_to_int16_t(&buffer_ptr[6]);
*std_initial = sensirion_common_bytes_to_int16_t(&buffer_ptr[8]);
*gain_factor = sensirion_common_bytes_to_int16_t(&buffer_ptr[10]);
return local_error;
}
int16_t sen66_set_voc_algorithm_tuning_parameters(
int16_t index_offset, int16_t learning_time_offset_hours,
int16_t learning_time_gain_hours, int16_t gating_max_duration_minutes,
int16_t std_initial, int16_t gain_factor) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset,
SEN66_SET_VOC_ALGORITHM_TUNING_PARAMETERS_CMD_ID);
local_offset = sensirion_i2c_add_int16_t_to_buffer(buffer_ptr, local_offset,
index_offset);
local_offset = sensirion_i2c_add_int16_t_to_buffer(
buffer_ptr, local_offset, learning_time_offset_hours);
local_offset = sensirion_i2c_add_int16_t_to_buffer(
buffer_ptr, local_offset, learning_time_gain_hours);
local_offset = sensirion_i2c_add_int16_t_to_buffer(
buffer_ptr, local_offset, gating_max_duration_minutes);
local_offset = sensirion_i2c_add_int16_t_to_buffer(buffer_ptr, local_offset,
std_initial);
local_offset = sensirion_i2c_add_int16_t_to_buffer(buffer_ptr, local_offset,
gain_factor);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
return local_error;
}
int16_t sen66_get_voc_algorithm_state(uint8_t* state, uint16_t state_size) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_GET_VOC_ALGORITHM_STATE_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
local_error = sensirion_i2c_read_data_inplace(_i2c_address, buffer_ptr, 8);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_common_copy_bytes(&buffer_ptr[0], (uint8_t*)state, state_size);
return local_error;
}
int16_t sen66_set_voc_algorithm_state(const uint8_t* state,
uint16_t state_size) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_SET_VOC_ALGORITHM_STATE_CMD_ID);
local_offset = sensirion_i2c_add_bytes_to_buffer(buffer_ptr, local_offset,
state, state_size);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
return local_error;
}
int16_t sen66_get_nox_algorithm_tuning_parameters(
int16_t* index_offset, int16_t* learning_time_offset_hours,
int16_t* learning_time_gain_hours, int16_t* gating_max_duration_minutes,
int16_t* std_initial, int16_t* gain_factor) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset,
SEN66_GET_NOX_ALGORITHM_TUNING_PARAMETERS_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
local_error = sensirion_i2c_read_data_inplace(_i2c_address, buffer_ptr, 12);
if (local_error != NO_ERROR) {
return local_error;
}
*index_offset = sensirion_common_bytes_to_int16_t(&buffer_ptr[0]);
*learning_time_offset_hours =
sensirion_common_bytes_to_int16_t(&buffer_ptr[2]);
*learning_time_gain_hours =
sensirion_common_bytes_to_int16_t(&buffer_ptr[4]);
*gating_max_duration_minutes =
sensirion_common_bytes_to_int16_t(&buffer_ptr[6]);
*std_initial = sensirion_common_bytes_to_int16_t(&buffer_ptr[8]);
*gain_factor = sensirion_common_bytes_to_int16_t(&buffer_ptr[10]);
return local_error;
}
int16_t sen66_set_nox_algorithm_tuning_parameters(
int16_t index_offset, int16_t learning_time_offset_hours,
int16_t learning_time_gain_hours, int16_t gating_max_duration_minutes,
int16_t std_initial, int16_t gain_factor) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset,
SEN66_SET_NOX_ALGORITHM_TUNING_PARAMETERS_CMD_ID);
local_offset = sensirion_i2c_add_int16_t_to_buffer(buffer_ptr, local_offset,
index_offset);
local_offset = sensirion_i2c_add_int16_t_to_buffer(
buffer_ptr, local_offset, learning_time_offset_hours);
local_offset = sensirion_i2c_add_int16_t_to_buffer(
buffer_ptr, local_offset, learning_time_gain_hours);
local_offset = sensirion_i2c_add_int16_t_to_buffer(
buffer_ptr, local_offset, gating_max_duration_minutes);
local_offset = sensirion_i2c_add_int16_t_to_buffer(buffer_ptr, local_offset,
std_initial);
local_offset = sensirion_i2c_add_int16_t_to_buffer(buffer_ptr, local_offset,
gain_factor);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
return local_error;
}
int16_t
sen66_perform_forced_co2_recalibration(uint16_t target_co2_concentration,
uint16_t* correction) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset,
SEN66_PERFORM_FORCED_CO2_RECALIBRATION_CMD_ID);
local_offset = sensirion_i2c_add_uint16_t_to_buffer(
buffer_ptr, local_offset, target_co2_concentration);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(500 * 1000);
local_error = sensirion_i2c_read_data_inplace(_i2c_address, buffer_ptr, 2);
if (local_error != NO_ERROR) {
return local_error;
}
*correction = sensirion_common_bytes_to_uint16_t(&buffer_ptr[0]);
return local_error;
}
int16_t sen66_perform_co2_sensor_factory_reset(void) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset,
SEN66_PERFORM_CO2_SENSOR_FACTORY_RESET_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(1400 * 1000);
return local_error;
}
int16_t sen66_get_co2_sensor_automatic_self_calibration(uint8_t* padding,
bool* status) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset,
SEN66_GET_CO2_SENSOR_AUTOMATIC_SELF_CALIBRATION_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
local_error = sensirion_i2c_read_data_inplace(_i2c_address, buffer_ptr, 2);
if (local_error != NO_ERROR) {
return local_error;
}
*padding = (uint8_t)buffer_ptr[0];
*status = (bool)buffer_ptr[1];
return local_error;
}
int16_t sen66_set_co2_sensor_automatic_self_calibration(uint16_t status) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset,
SEN66_SET_CO2_SENSOR_AUTOMATIC_SELF_CALIBRATION_CMD_ID);
local_offset =
sensirion_i2c_add_uint16_t_to_buffer(buffer_ptr, local_offset, status);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
return local_error;
}
int16_t sen66_get_ambient_pressure(uint16_t* ambient_pressure) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_GET_AMBIENT_PRESSURE_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
local_error = sensirion_i2c_read_data_inplace(_i2c_address, buffer_ptr, 2);
if (local_error != NO_ERROR) {
return local_error;
}
*ambient_pressure = sensirion_common_bytes_to_uint16_t(&buffer_ptr[0]);
return local_error;
}
int16_t sen66_set_ambient_pressure(uint16_t ambient_pressure) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_SET_AMBIENT_PRESSURE_CMD_ID);
local_offset = sensirion_i2c_add_uint16_t_to_buffer(
buffer_ptr, local_offset, ambient_pressure);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
return local_error;
}
int16_t sen66_get_sensor_altitude(uint16_t* altitude) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_GET_SENSOR_ALTITUDE_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
local_error = sensirion_i2c_read_data_inplace(_i2c_address, buffer_ptr, 2);
if (local_error != NO_ERROR) {
return local_error;
}
*altitude = sensirion_common_bytes_to_uint16_t(&buffer_ptr[0]);
return local_error;
}
int16_t sen66_set_sensor_altitude(uint16_t altitude) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_SET_SENSOR_ALTITUDE_CMD_ID);
local_offset = sensirion_i2c_add_uint16_t_to_buffer(buffer_ptr,
local_offset, altitude);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
return local_error;
}
int16_t sen66_start_continuous_measurement(void) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_START_CONTINUOUS_MEASUREMENT_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(50 * 1000);
return local_error;
}
int16_t sen66_stop_measurement(void) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_STOP_MEASUREMENT_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(1400 * 1000);
return local_error;
}
int16_t sen66_get_data_ready(uint8_t* padding, bool* data_ready) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_GET_DATA_READY_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
local_error = sensirion_i2c_read_data_inplace(_i2c_address, buffer_ptr, 2);
if (local_error != NO_ERROR) {
return local_error;
}
*padding = (uint8_t)buffer_ptr[0];
*data_ready = (bool)buffer_ptr[1];
return local_error;
}
int16_t sen66_read_number_concentration_values_as_integers(
uint16_t* number_concentration_pm0p5, uint16_t* number_concentration_pm1p0,
uint16_t* number_concentration_pm2p5, uint16_t* number_concentration_pm4p0,
uint16_t* number_concentration_pm10p0) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset,
SEN66_READ_NUMBER_CONCENTRATION_VALUES_AS_INTEGERS_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
local_error = sensirion_i2c_read_data_inplace(_i2c_address, buffer_ptr, 10);
if (local_error != NO_ERROR) {
return local_error;
}
*number_concentration_pm0p5 =
sensirion_common_bytes_to_uint16_t(&buffer_ptr[0]);
*number_concentration_pm1p0 =
sensirion_common_bytes_to_uint16_t(&buffer_ptr[2]);
*number_concentration_pm2p5 =
sensirion_common_bytes_to_uint16_t(&buffer_ptr[4]);
*number_concentration_pm4p0 =
sensirion_common_bytes_to_uint16_t(&buffer_ptr[6]);
*number_concentration_pm10p0 =
sensirion_common_bytes_to_uint16_t(&buffer_ptr[8]);
return local_error;
}
int16_t sen66_set_temperature_offset_parameters(int16_t offset, int16_t slope,
uint16_t time_constant,
uint16_t slot) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset,
SEN66_SET_TEMPERATURE_OFFSET_PARAMETERS_CMD_ID);
local_offset =
sensirion_i2c_add_int16_t_to_buffer(buffer_ptr, local_offset, offset);
local_offset =
sensirion_i2c_add_int16_t_to_buffer(buffer_ptr, local_offset, slope);
local_offset = sensirion_i2c_add_uint16_t_to_buffer(
buffer_ptr, local_offset, time_constant);
local_offset =
sensirion_i2c_add_uint16_t_to_buffer(buffer_ptr, local_offset, slot);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
return local_error;
}
int16_t sen66_set_temperature_acceleration_parameters(uint16_t k, uint16_t p,
uint16_t t1,
uint16_t t2) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset,
SEN66_SET_TEMPERATURE_ACCELERATION_PARAMETERS_CMD_ID);
local_offset =
sensirion_i2c_add_uint16_t_to_buffer(buffer_ptr, local_offset, k);
local_offset =
sensirion_i2c_add_uint16_t_to_buffer(buffer_ptr, local_offset, p);
local_offset =
sensirion_i2c_add_uint16_t_to_buffer(buffer_ptr, local_offset, t1);
local_offset =
sensirion_i2c_add_uint16_t_to_buffer(buffer_ptr, local_offset, t2);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
return local_error;
}
int16_t sen66_get_product_type(int8_t* product_type,
uint16_t product_type_size) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_GET_PRODUCT_TYPE_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
local_error = sensirion_i2c_read_data_inplace(_i2c_address, buffer_ptr, 32);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_common_copy_bytes(&buffer_ptr[0], (uint8_t*)product_type,
product_type_size);
return local_error;
}
int16_t sen66_get_product_name(int8_t* product_name,
uint16_t product_name_size) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_GET_PRODUCT_NAME_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
local_error = sensirion_i2c_read_data_inplace(_i2c_address, buffer_ptr, 32);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_common_copy_bytes(&buffer_ptr[0], (uint8_t*)product_name,
product_name_size);
return local_error;
}
int16_t sen66_get_serial_number(int8_t* serial_number,
uint16_t serial_number_size) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_GET_SERIAL_NUMBER_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
local_error = sensirion_i2c_read_data_inplace(_i2c_address, buffer_ptr, 32);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_common_copy_bytes(&buffer_ptr[0], (uint8_t*)serial_number,
serial_number_size);
return local_error;
}
int16_t sen66_read_device_status(sen66_device_status* device_status) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_READ_DEVICE_STATUS_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
local_error = sensirion_i2c_read_data_inplace(_i2c_address, buffer_ptr, 4);
if (local_error != NO_ERROR) {
return local_error;
}
(*device_status).value = sensirion_common_bytes_to_uint32_t(&buffer_ptr[0]);
return local_error;
}
int16_t sen66_read_and_clear_device_status(sen66_device_status* device_status) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_READ_AND_CLEAR_DEVICE_STATUS_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
local_error = sensirion_i2c_read_data_inplace(_i2c_address, buffer_ptr, 4);
if (local_error != NO_ERROR) {
return local_error;
}
(*device_status).value = sensirion_common_bytes_to_uint32_t(&buffer_ptr[0]);
return local_error;
}
int16_t sen66_get_version(uint8_t* firmware_major, uint8_t* firmware_minor) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_GET_VERSION_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
local_error = sensirion_i2c_read_data_inplace(_i2c_address, buffer_ptr, 2);
if (local_error != NO_ERROR) {
return local_error;
}
*firmware_major = (uint8_t)buffer_ptr[0];
*firmware_minor = (uint8_t)buffer_ptr[1];
return local_error;
}
int16_t sen66_device_reset(void) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_DEVICE_RESET_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(1200 * 1000);
return local_error;
}
int16_t sen66_start_fan_cleaning(void) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_START_FAN_CLEANING_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
return local_error;
}
int16_t sen66_activate_sht_heater(void) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_ACTIVATE_SHT_HEATER_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
return local_error;
}
int16_t sen66_get_sht_heater_measurements(int16_t* sht_relative_humidity,
int16_t* sht_temperature) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_GET_SHT_HEATER_MEASUREMENTS_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
local_error = sensirion_i2c_read_data_inplace(_i2c_address, buffer_ptr, 4);
if (local_error != NO_ERROR) {
return local_error;
}
*sht_relative_humidity = sensirion_common_bytes_to_int16_t(&buffer_ptr[0]);
*sht_temperature = sensirion_common_bytes_to_int16_t(&buffer_ptr[2]);
return local_error;
}
int16_t sen66_read_measured_values_as_integers(
uint16_t* mass_concentration_pm1p0, uint16_t* mass_concentration_pm2p5,
uint16_t* mass_concentration_pm4p0, uint16_t* mass_concentration_pm10p0,
int16_t* ambient_humidity, int16_t* ambient_temperature, int16_t* voc_index,
int16_t* nox_index, uint16_t* co2) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset,
SEN66_READ_MEASURED_VALUES_AS_INTEGERS_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
local_error = sensirion_i2c_read_data_inplace(_i2c_address, buffer_ptr, 18);
if (local_error != NO_ERROR) {
return local_error;
}
*mass_concentration_pm1p0 =
sensirion_common_bytes_to_uint16_t(&buffer_ptr[0]);
*mass_concentration_pm2p5 =
sensirion_common_bytes_to_uint16_t(&buffer_ptr[2]);
*mass_concentration_pm4p0 =
sensirion_common_bytes_to_uint16_t(&buffer_ptr[4]);
*mass_concentration_pm10p0 =
sensirion_common_bytes_to_uint16_t(&buffer_ptr[6]);
*ambient_humidity = sensirion_common_bytes_to_int16_t(&buffer_ptr[8]);
*ambient_temperature = sensirion_common_bytes_to_int16_t(&buffer_ptr[10]);
*voc_index = sensirion_common_bytes_to_int16_t(&buffer_ptr[12]);
*nox_index = sensirion_common_bytes_to_int16_t(&buffer_ptr[14]);
*co2 = sensirion_common_bytes_to_uint16_t(&buffer_ptr[16]);
return local_error;
}
int16_t sen66_read_measured_raw_values(int16_t* raw_humidity,
int16_t* raw_temperature,
uint16_t* raw_voc, uint16_t* raw_nox,
uint16_t* raw_co2) {
int16_t local_error = NO_ERROR;
uint8_t* buffer_ptr = communication_buffer;
uint16_t local_offset = 0;
local_offset = sensirion_i2c_add_command16_to_buffer(
buffer_ptr, local_offset, SEN66_READ_MEASURED_RAW_VALUES_CMD_ID);
local_error =
sensirion_i2c_write_data(_i2c_address, buffer_ptr, local_offset);
if (local_error != NO_ERROR) {
return local_error;
}
sensirion_i2c_hal_sleep_usec(20 * 1000);
local_error = sensirion_i2c_read_data_inplace(_i2c_address, buffer_ptr, 10);
if (local_error != NO_ERROR) {
return local_error;
}
*raw_humidity = sensirion_common_bytes_to_int16_t(&buffer_ptr[0]);
*raw_temperature = sensirion_common_bytes_to_int16_t(&buffer_ptr[2]);
*raw_voc = sensirion_common_bytes_to_uint16_t(&buffer_ptr[4]);
*raw_nox = sensirion_common_bytes_to_uint16_t(&buffer_ptr[6]);
*raw_co2 = sensirion_common_bytes_to_uint16_t(&buffer_ptr[8]);
return local_error;
}
+899
View File
@@ -0,0 +1,899 @@
/*
* THIS FILE IS AUTOMATICALLY GENERATED
*
* Generator: sensirion-driver-generator 1.7.0
* Product: sen66
* Model-Version: 1.7.3
*/
/*
* Copyright (c) 2026, Sensirion AG
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
*
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* * Neither the name of Sensirion AG nor the names of its
* contributors may be used to endorse or promote products derived from
* this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
#ifndef SEN66_I2C_H
#define SEN66_I2C_H
#ifdef __cplusplus
extern "C" {
#endif
#include "sensirion_config.h"
#define SEN66_I2C_ADDR_6B 0x6b
typedef enum {
SEN66_GET_VOC_ALGORITHM_TUNING_PARAMETERS_CMD_ID = 0x60d0,
SEN66_SET_VOC_ALGORITHM_TUNING_PARAMETERS_CMD_ID = 0x60d0,
SEN66_GET_VOC_ALGORITHM_STATE_CMD_ID = 0x6181,
SEN66_SET_VOC_ALGORITHM_STATE_CMD_ID = 0x6181,
SEN66_GET_NOX_ALGORITHM_TUNING_PARAMETERS_CMD_ID = 0x60e1,
SEN66_SET_NOX_ALGORITHM_TUNING_PARAMETERS_CMD_ID = 0x60e1,
SEN66_PERFORM_FORCED_CO2_RECALIBRATION_CMD_ID = 0x6707,
SEN66_PERFORM_CO2_SENSOR_FACTORY_RESET_CMD_ID = 0x6754,
SEN66_GET_CO2_SENSOR_AUTOMATIC_SELF_CALIBRATION_CMD_ID = 0x6711,
SEN66_SET_CO2_SENSOR_AUTOMATIC_SELF_CALIBRATION_CMD_ID = 0x6711,
SEN66_GET_AMBIENT_PRESSURE_CMD_ID = 0x6720,
SEN66_SET_AMBIENT_PRESSURE_CMD_ID = 0x6720,
SEN66_GET_SENSOR_ALTITUDE_CMD_ID = 0x6736,
SEN66_SET_SENSOR_ALTITUDE_CMD_ID = 0x6736,
SEN66_START_CONTINUOUS_MEASUREMENT_CMD_ID = 0x21,
SEN66_STOP_MEASUREMENT_CMD_ID = 0x104,
SEN66_GET_DATA_READY_CMD_ID = 0x202,
SEN66_READ_NUMBER_CONCENTRATION_VALUES_AS_INTEGERS_CMD_ID = 0x316,
SEN66_SET_TEMPERATURE_OFFSET_PARAMETERS_CMD_ID = 0x60b2,
SEN66_SET_TEMPERATURE_ACCELERATION_PARAMETERS_CMD_ID = 0x6100,
SEN66_GET_PRODUCT_TYPE_CMD_ID = 0xd002,
SEN66_GET_PRODUCT_NAME_CMD_ID = 0xd014,
SEN66_GET_SERIAL_NUMBER_CMD_ID = 0xd033,
SEN66_READ_DEVICE_STATUS_CMD_ID = 0xd206,
SEN66_READ_AND_CLEAR_DEVICE_STATUS_CMD_ID = 0xd210,
SEN66_GET_VERSION_CMD_ID = 0xd100,
SEN66_DEVICE_RESET_CMD_ID = 0xd304,
SEN66_START_FAN_CLEANING_CMD_ID = 0x5607,
SEN66_ACTIVATE_SHT_HEATER_CMD_ID = 0x6765,
SEN66_GET_SHT_HEATER_MEASUREMENTS_CMD_ID = 0x6790,
SEN66_READ_MEASURED_VALUES_AS_INTEGERS_CMD_ID = 0x300,
SEN66_READ_MEASURED_RAW_VALUES_CMD_ID = 0x405,
} SEN66_CMD_ID;
typedef union {
struct {
uint32_t reserved1 : 4;
uint32_t fan_error : 1;
uint32_t reserved2 : 1;
uint32_t rht_error : 1;
uint32_t gas_error : 1;
uint32_t reserved3 : 1;
uint32_t co2_2_error : 1;
uint32_t hcho_error : 1;
uint32_t pm_error : 1;
uint32_t co2_1_error : 1;
uint32_t reserved4 : 8;
uint32_t fan_speed_warning : 1;
uint32_t reserved5 : 10;
};
uint32_t value;
} sen66_device_status;
/**
* @brief Initialize i2c address of driver
*
* @param[in] i2c_address Used i2c address
*
*/
void sen66_init(uint8_t i2c_address);
/**
* @brief sen66_get_voc_algorithm_tuning_parameters
*
* Gets the parameters to customize the VOC algorithm.
*
* @param[out] index_offset VOC index representing typical (average) conditions.
* @param[out] learning_time_offset_hours Time constant to estimate the VOC
* algorithm offset from the history in hours. Past events will be forgotten
* after about twice the learning time.
* @param[out] learning_time_gain_hours Time constant to estimate the VOC
* algorithm gain from the history in hours. Past events will be forgotten after
* about twice the learning time.
* @param[out] gating_max_duration_minutes Maximum duration of gating in minutes
* (freeze of estimator during high VOC index signal). Zero disables the gating.
* @param[out] std_initial Initial estimate for standard deviation. Lower value
* boosts events during initial learning period, but may result in larger
* device-to-device variations.
* @param[out] gain_factor Gain factor to amplify or to attenuate the VOC index
* output.
*
* @note This command is only available in idle mode.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_get_voc_algorithm_tuning_parameters(
int16_t* index_offset, int16_t* learning_time_offset_hours,
int16_t* learning_time_gain_hours, int16_t* gating_max_duration_minutes,
int16_t* std_initial, int16_t* gain_factor);
/**
* @brief sen66_set_voc_algorithm_tuning_parameters
*
* Sets the parameters to customize the VOC algorithm. This configuration is
* volatile, i.e. the parameters will be reverted to their default values after
* a device reset.
*
* @param[in] index_offset VOC index representing typical (average) conditions.
* Allowed values are in range 1..250. The default value is 100.
* @param[in] learning_time_offset_hours Time constant to estimate the VOC
* algorithm offset from the history in hours. Past events will be forgotten
* after about twice the learning time. Allowed values are in range 1..1000. The
* default value is 12 hours.
* @param[in] learning_time_gain_hours Time constant to estimate the VOC
* algorithm gain from the history in hours. Past events will be forgotten after
* about twice the learning time. Allowed values are in range 1..1000. The
* default value is 12 hours.
* @param[in] gating_max_duration_minutes Maximum duration of gating in minutes
* (freeze of estimator during high VOC index signal). Set to zero to disable
* the gating. Allowed values are in range 0..3000. The default value is 180
* minutes
* @param[in] std_initial Initial estimate for standard deviation. Lower value
* boosts events during initial learning period, but may result in larger
* device-to-device variations. Allowed values are in range 10..5000. The
* default value is 50.
* @param[in] gain_factor Gain factor to amplify or to attenuate the VOC index
* output. Allowed values are in range 1..1000. The default value is 230.
*
* @note This command is available only in idle mode. In measure mode, this
* command has no effect. In addition, it has no effect if at least one
* parameter is outside the specified range.
*
* @return error_code 0 on success, an error code otherwise.
*
* Example:
* --------
*
* @code{.c}
*
* int16_t local_error = 0;
*
* local_error = sen66_set_voc_algorithm_tuning_parameters(100, 12, 12, 180,
* 50, 230); if (local_error != NO_ERROR) { return local_error;
* }
*
* @endcode
*
*/
int16_t sen66_set_voc_algorithm_tuning_parameters(
int16_t index_offset, int16_t learning_time_offset_hours,
int16_t learning_time_gain_hours, int16_t gating_max_duration_minutes,
int16_t std_initial, int16_t gain_factor);
/**
* @brief sen66_get_voc_algorithm_state
*
* Gets the current VOC algorithm state. Allows to backup and restore the VOC
* algorithm state to resume operation after a power cycle or device reset,
* skipping initial learning phase. By default, the VOC Engine is reset and the
* algorithm state is retained if a measurement is stopped and started again.
* If the VOC algorithm state shall be reset, a device reset or a power cycle
* can be executed.
*
* @param[out] state Current VOC algorithm state.
*
* @note This command can be used either in measure mode or in idle mode (which
* will then return the state at the time when the measurement was stopped). In
* measure mode, the state can be read each measure interval to always have the
* latest state available, even in case of a sudden power loss.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_get_voc_algorithm_state(uint8_t* state, uint16_t state_size);
/**
* @brief sen66_set_voc_algorithm_state
*
* Sets the VOC algorithm state previously received with "Get VOC Algorithm
* State" command. Allows restoration of the VOC algorithm state to resume
* operation after a power cycle or device reset, skipping initial learning
* phase. By default, the VOC Engine is reset, and the algorithm state is
* retained if a measurement is stopped and started again. If the VOC algorithm
* state shall be reset, a device reset, or a power cycle can be executed.
*
* @param[in] state VOC algorithm state to restore.
*
* @note This command is only available in idle mode and the state will be
* applied only once when starting the next measurement. In measure mode, this
* command has no effect.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_set_voc_algorithm_state(const uint8_t* state,
uint16_t state_size);
/**
* @brief sen66_get_nox_algorithm_tuning_parameters
*
* Gets the parameters to customize the NOx algorithm.
*
* @param[out] index_offset NOx index representing typical (average) conditions.
* @param[out] learning_time_offset_hours Time constant to estimate the NOx
* algorithm offset from the history in hours. Past events will be forgotten
* after about twice the learning time.
* @param[out] learning_time_gain_hours The time constant to estimate the NOx
* algorithm gain from the history has no impact for NOx. This parameter is
* still in place for consistency reasons with the VOC tuning parameters
* command.
* @param[out] gating_max_duration_minutes Maximum duration of gating in minutes
* (freeze of estimator during high NOx index signal). Zero disables the gating.
* @param[out] std_initial The initial estimate for standard deviation has no
* impact for NOx. This parameter is still in place for consistency reasons with
* the VOC tuning parameters command.
* @param[out] gain_factor Gain factor to amplify or to attenuate the NOx index
* output.
*
* @note This command is available only in idle mode.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_get_nox_algorithm_tuning_parameters(
int16_t* index_offset, int16_t* learning_time_offset_hours,
int16_t* learning_time_gain_hours, int16_t* gating_max_duration_minutes,
int16_t* std_initial, int16_t* gain_factor);
/**
* @brief sen66_set_nox_algorithm_tuning_parameters
*
* Sets the parameters to customize the NOx algorithm. This configuration is
* volatile, i.e. the parameters will be reverted to their default values after
* a device reset.
*
* @param[in] index_offset NOx index representing typical (average) conditions.
* Allowed values are in range 1..250. The default value is 1.
* @param[in] learning_time_offset_hours Time constant to estimate the NOx
* algorithm offset from the history in hours. Past events will be forgotten
* after about twice the learning time. Allowed values are in range 1..1000. The
* default value is 12 hours.
* @param[in] learning_time_gain_hours The time constant to estimate the NOx
* algorithm gain from the history has no impact for NOx. This parameter is
* still in place for consistency reasons with the VOC tuning parameters
* command. This parameter must always be set to 12 hours.
* @param[in] gating_max_duration_minutes Maximum duration of gating in minutes
* (freeze of estimator during high NOx index signal). Set to zero to disable
* the gating. Allowed values are in range 0..3000. The default value is 720
* minutes.
* @param[in] std_initial The initial estimate for standard deviation parameter
* has no impact for NOx. This parameter is still in place for consistency
* reasons with the VOC tuning parameters command. This parameter must always be
* set to 50.
* @param[in] gain_factor Gain factor to amplify or to attenuate the NOx index
* output. Allowed values are in range 1..1000. The default value is 230.
*
* @note This command is available only in idle mode. In measure mode, this
* command has no effect. In addition, it has no effect if at least one
* parameter is outside the specified range.
*
* @return error_code 0 on success, an error code otherwise.
*
* Example:
* --------
*
* @code{.c}
*
* int16_t local_error = 0;
*
* local_error = sen66_set_nox_algorithm_tuning_parameters(1, 12, 12, 720,
* 50, 230); if (local_error != NO_ERROR) { return local_error;
* }
*
* @endcode
*
*/
int16_t sen66_set_nox_algorithm_tuning_parameters(
int16_t index_offset, int16_t learning_time_offset_hours,
int16_t learning_time_gain_hours, int16_t gating_max_duration_minutes,
int16_t std_initial, int16_t gain_factor);
/**
* @brief Perform Forced CO₂ Recalibration
*
* Execute the forced recalibration (FRC) of the CO₂. See the datasheet of the
* SCD4x sensor for details how the forced recalibration shall be used.
*
* @param[in] target_co2_concentration Target CO₂ concentration [ppm] of the
* test setup.
* @param[out] correction Correction value as received from the SCD [ppm CO₂].
* FRC correction [ppm CO₂] is calculated as follows: FRC = return_value -
* 0x8000 If the recalibration has failed this returned value is 0xFFFF.
*
* @note After power-on wait at least 1000 ms and after stopping a measurement
* 600 ms before sending this command. This command is not available in measure
* mode. The recalibration procedure will take about 500 ms to complete, during
* which time no other functions can be executed. This configuration is
* persistent, i.e. the parameters will be retained during a device reset or
* power cycle.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t
sen66_perform_forced_co2_recalibration(uint16_t target_co2_concentration,
uint16_t* correction);
/**
* @brief Perform CO₂ Sensor Factory Reset
*
* This command resets all CO₂ sensor configuration settings stored in the
* EEPROM and erases the FRC and ASC algorithm history of the CO₂ sensor. The
* configuration settings are CO₂ sensor temperature offset (cannot be modified
* over I2C interface), sensor altitude and the ASC enabled/disabled parameters
* which are by default stored in the volatile memory (RAM). This command is
* only available in idle mode.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_perform_co2_sensor_factory_reset(void);
/**
* @brief sen66_get_co2_sensor_automatic_self_calibration
*
* The CO₂ sensor supports automatic self calibration (ASC) for long-term
* stability of the CO₂ output. This feature can be enabled or disabled. By
* default it is enabled.
*
* @param[out] padding Padding byte, always 0x00.
* @param[out] status Is set true (0x01) if the automatic self calibration is
* enabled or false (0x00) if the automatic self calibration is disabled.
*
* @note This command is only available in idle mode. This configuration is
* persistent, i.e. the status will be retained during a device reset or power
* cycle.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_get_co2_sensor_automatic_self_calibration(uint8_t* padding,
bool* status);
/**
* @brief sen66_set_co2_sensor_automatic_self_calibration
*
* Sets the status of the CO₂ sensor automatic self-calibration (ASC). The CO₂
* sensor supports automatic self calibration (ASC) for long-term stability of
* the CO₂ output. This feature can be enabled or disabled. By default it is
* enabled.
*
* @param[in] status Set to true (0x0001) to enable or false (0x0000) to disable
* the automatic CO₂ measurement self calibration feature. High byte of uint16
* is padding and always 0x00.
*
* @note This command is only available in idle mode. This configuration is
* persistent, i.e. the status will be retained during a device reset or power
* cycle.
*
* @return error_code 0 on success, an error code otherwise.
*
* Example:
* --------
*
* @code{.c}
*
* int16_t local_error = 0;
*
* local_error = sen66_set_co2_sensor_automatic_self_calibration(0);
* if (local_error != NO_ERROR) {
* return local_error;
* }
*
* @endcode
*
*/
int16_t sen66_set_co2_sensor_automatic_self_calibration(uint16_t status);
/**
* @brief sen66_get_ambient_pressure
*
* Gets the ambient pressure value. The ambient pressure can be used for
* pressure compensation in the CO₂ sensor.
*
* @param[out] ambient_pressure Currently used ambient pressure [hPa] for
* pressure compensation.
*
* @note This command can be used in any state of the device, i.e. both in idle
* mode and in measure mode.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_get_ambient_pressure(uint16_t* ambient_pressure);
/**
* @brief sen66_set_ambient_pressure
*
* The ambient pressure can be used for pressure compensation in the CO₂ sensor.
* Setting an ambient pressure overrides any pressure compensation based on a
* previously set sensor altitude. Use of this command is recommended for
* applications experiencing significant ambient pressure changes to ensure CO₂
* sensor accuracy. Valid input values are between 700 to 1'200 hPa. The default
* value is 1013 hPa. This configuration is volatile, i.e. the parameter will be
* reverted to its default value after a device restart.
*
* @param[in] ambient_pressure Ambient pressure [hPa] to be used for pressure
* compensation.
*
* @note This command can be used in any state of the device, i.e. both in idle
* mode and in measure mode.
*
* @return error_code 0 on success, an error code otherwise.
*
* Example:
* --------
*
* @code{.c}
*
* int16_t local_error = 0;
*
* local_error = sen66_set_ambient_pressure(1013);
* if (local_error != NO_ERROR) {
* return local_error;
* }
*
* @endcode
*
*/
int16_t sen66_set_ambient_pressure(uint16_t ambient_pressure);
/**
* @brief sen66_get_sensor_altitude
*
* Gets the current sensor altitude. The sensor altitude can be used for
* pressure compensation in the CO₂ sensor.
*
* @param[out] altitude Current sensor altitude [m].
*
* @note This command is only available in idle mode.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_get_sensor_altitude(uint16_t* altitude);
/**
* @brief sen66_set_sensor_altitude
*
* The sensor altitude can be used for pressure compensation in the CO₂ sensor.
* The default sensor altitude value is set to 0 meters above sea level. Valid
* input values are between 0 and 3000m. This configuration is volatile, i.e.
* the parameter will be reverted to its default value after a device reset.
*
* @param[in] altitude Sensor altitude [m], valid input between 0 and 3000m.
*
* @return error_code 0 on success, an error code otherwise.
*
* Example:
* --------
*
* @code{.c}
*
* int16_t local_error = 0;
*
* local_error = sen66_set_sensor_altitude(0);
* if (local_error != NO_ERROR) {
* return local_error;
* }
*
* @endcode
*
*/
int16_t sen66_set_sensor_altitude(uint16_t altitude);
/**
* @brief Start a continuous measurement (interval 1s)
*
* Starts a continuous measurement. After starting the measurement, it takes
* some time (~1.1s) until the first measurement results are available. You
* could poll with the command "Get Data Ready" to check when the results are
* ready to read. This command is only available in idle mode. If the device is
* already in any measure mode, this command has no effect.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_start_continuous_measurement(void);
/**
* @brief Stop the continuous measurement
*
* Stops the measurement and returns to idle mode. After sending this command,
* wait at least 1000 ms before starting a new measurement. If the device is
* already in idle mode, this command has no effect.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_stop_measurement(void);
/**
* @brief Check if data is ready to be read out from the sensor
*
* This command can be used to check if new measurement results are ready to
* read. The data ready flag is automatically reset after reading the
* measurement values.
*
* @param[out] padding Padding byte, always 0x00.
* @param[out] data_ready True (0x01) if data is ready, False (0x00) if not.
* When no measurement is running, False will be returned.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_get_data_ready(uint8_t* padding, bool* data_ready);
/**
* @brief sen66_read_number_concentration_values_as_integers
*
* Returns the measured number concentration values. The command 0x0202 "Get
* Data Ready" can be used to check if new data is available since the last read
* operation. If no new data is available, the previous values will be returned
* again. If no data is available at all (e.g. measurement not running for at
* least one second), all values will be at their upper limit (0xFFFF for
* uint16).
*
* @param[out] number_concentration_pm0p5 Value is scaled with factor 10: PM0.5
* [particles/cm³] = value / 10. *Note: If this value is unknown, 0xFFFF is
* returned.*
* @param[out] number_concentration_pm1p0 Value is scaled with factor 10: PM1.0
* [particles/cm³] = value / 10. *Note: If this value is unknown, 0xFFFF is
* returned.*
* @param[out] number_concentration_pm2p5 Value is scaled with factor 10: PM2.5
* [particles/cm³] = value / 10. *Note: If this value is unknown, 0xFFFF is
* returned.*
* @param[out] number_concentration_pm4p0 Value is scaled with factor 10: PM4.0
* [particles/cm³] = value / 10. *Note: If this value is unknown, 0xFFFF is
* returned.*
* @param[out] number_concentration_pm10p0 Value is scaled with factor 10:
* PM10.0 [particles/cm³] = value / 10. *Note: If this value is unknown, 0xFFFF
* is returned.*
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_read_number_concentration_values_as_integers(
uint16_t* number_concentration_pm0p5, uint16_t* number_concentration_pm1p0,
uint16_t* number_concentration_pm2p5, uint16_t* number_concentration_pm4p0,
uint16_t* number_concentration_pm10p0);
/**
* @brief sen66_set_temperature_offset_parameters
*
* This command allows to compensate temperature effects of the design-in at
* customer side by applying custom temperature offsets to the ambient
* temperature.
*
* The compensated ambient temperature is calculated as follows:
*
*
* * T_Ambient_Compensated = T_Ambient + (slope * T_Ambient) + offset
* Where "slope" and "offset" are the values set with this command, smoothed
* with the specified time constant. All temperatures
* ("T_Ambient_Compensated", "T_Ambient" and "offset") are represented in
* °C. There are 5 temperature offset slots available that all contribute
* additively to "T_Ambient_Compensated". The default values for the
* temperature offset parameters are all zero, meaning that
* "T_Ambient_Compensated" is equal to "T_Ambient" by default. The
* parameters can be changed in any state of the device, i.e. both in idle mode
* and in measure mode.
*
* @param[in] offset Constant temperature offset scaled with factor 200 (T [°C]
* = value / 200).
* @param[in] slope Normalized temperature offset slope scaled with factor 10000
* (applied factor = value / 10000).
* @param[in] time_constant The time constant determines how fast the new slope
* and offset will be applied. After the specified value in seconds, 63% of the
* new slope and offset are applied. A time constant of zero means the new
* values will be applied immediately (within the next measure interval of 1
* second).
* @param[in] slot The temperature offset slot to be modified. Valid values are
* 0 .. 4. If the value is outside this range, the parameters will not be
* applied.
*
* @note This configuration is volatile, i.e. the parameters will be reverted to
* their default value of zero after a device reset.
*
* @return error_code 0 on success, an error code otherwise.
*
* Example:
* --------
*
* @code{.c}
*
* int16_t local_error = 0;
*
* local_error = sen66_set_temperature_offset_parameters(1, 10, 1, 0);
* if (local_error != NO_ERROR) {
* return local_error;
* }
*
* @endcode
*
*/
int16_t sen66_set_temperature_offset_parameters(int16_t offset, int16_t slope,
uint16_t time_constant,
uint16_t slot);
/**
* @brief sen66_set_temperature_acceleration_parameters
*
* This command allows to set custom temperature acceleration parameters of the
* RH/T engine. It overwrites the default temperature acceleration parameters of
* the RH/T engine with custom values. This configuration is volatile, i.e. the
* parameters will be reverted to their default values after a device reset.
*
* @param[in] k Filter constant K scaled with factor 10 (K = value / 10).
* @param[in] p Filter constant P scaled with factor 10 (P = value / 10).
* @param[in] t1 Time constant T1 scaled with factor 10 (T1 [s] = value / 10).
* @param[in] t2 Time constant T2 scaled with factor 10 (T2 [s] = value / 10).
*
* @note The command is only available in idle mode.
*
* @return error_code 0 on success, an error code otherwise.
*
* Example:
* --------
*
* @code{.c}
*
* int16_t local_error = 0;
*
* local_error = sen66_set_temperature_acceleration_parameters(1, 1, 1, 1);
* if (local_error != NO_ERROR) {
* return local_error;
* }
*
* @endcode
*
*/
int16_t sen66_set_temperature_acceleration_parameters(uint16_t k, uint16_t p,
uint16_t t1, uint16_t t2);
/**
* @brief sen66_get_product_type
*
* Gets the product type from the device.
*
* The following product types are expected: - SEN62: '00085800' - SEN63C:
* '00085700' - SEN65: '00085200' - SEN66: '00085300' - SEN68: '00085400' -
* SEN69C: '00085900'
*
* @param[out] product_type Null-terminated ASCII string containing the product
* type. Up to 32 characters can be read from the device.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_get_product_type(int8_t* product_type,
uint16_t product_type_size);
/**
* @brief sen66_get_product_name
*
* Gets the product name from the device.
*
* @param[out] product_name Null-terminated ASCII string containing the product
* name. Up to 32 characters can be read from the device.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_get_product_name(int8_t* product_name,
uint16_t product_name_size);
/**
* @brief sen66_get_serial_number
*
* Gets the serial number from the device.
*
* @param[out] serial_number Null-terminated ASCII string containing the serial
* number. Up to 32 characters can be read from the device.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_get_serial_number(int8_t* serial_number,
uint16_t serial_number_size);
/**
* @brief sen66_read_device_status
*
* Reads the current device status. Use this command to get detailed information
* about the device status. The device status is encoded in flags. Each device
* status flag represents a single bit in a 32-bit integer value. If more than
* one error is present, the device status register value is the sum of the
* corresponding flag values. For details about the available flags, refer to
* the device status flags documentation in the data sheet.
*
* @param[out] device_status Device status (32 flags as an integer value). For
* details, please refer to the device status flags documentation in the
* datasheet.
*
* @note The status flags of type "Error" are sticky, i.e. they are not cleared
* automatically even if the error condition no longer exists. So they can only
* be cleared manually with the command "Read And Clear Device Status" or with a
* device reset. All other flags are not sticky, i.e. they are cleared
* automatically if the trigger condition disappears.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_read_device_status(sen66_device_status* device_status);
/**
* @brief sen66_read_and_clear_device_status
*
* Reads the current device status (like command 0xD206 "Read Device Status")
* and afterwards clears all flags.
*
* @param[out] device_status Device status (32 flags as an integer value)
* **before** clearing it. For details, please refer to the device status flags
* documentation.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_read_and_clear_device_status(sen66_device_status* device_status);
/**
* @brief sen66_get_version
*
* Gets the version information for the firmware.
*
* @param[out] firmware_major Firmware major version number.
* @param[out] firmware_minor Firmware minor version number.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_get_version(uint8_t* firmware_major, uint8_t* firmware_minor);
/**
* @brief sen66_device_reset
*
* Executes a reset on the device. This has the same effect as a power cycle.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_device_reset(void);
/**
* @brief sen66_start_fan_cleaning
*
* This command triggers fan cleaning. The fan is set to the maximum speed for
* 10 seconds and then automatically stopped. Wait at least 10s after this
* command before starting a measurement.
*
* @note This command is only available in idle mode.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_start_fan_cleaning(void);
/**
* @brief Activate SHT Heater
*
* Activate the heater feature of the SHT4x sensor. This command allows to use
* the inbuilt heater in SHT sensor to decontaminate and reverse creep at high
* humidity. This command activates the SHT sensor heater with 200mW for 1s. The
* SHT heater measurement done just before deactivation can be read using the
* command "Get SHT Heater Measurements" after the duration of the heating
* feature as specified in the SHT4x datasheet. Wait at least 20s after this
* command before starting a measurement to get coherent temperature values
* (heating consequence to disappear).
*
* @note This command is only available in idle mode.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_activate_sht_heater(void);
/**
* @brief Get SHT Heater Measurements
*
* Get the measurement values when the SHT sensor heating is finished.
*
* @param[out] sht_relative_humidity If the sht heating is completed, this value
* indicates the scaled relative humidity of the SHT4x sensor. Value is scaled
* with factor 100: RH [%] = value / 100 *Note: If this value is not available,
* 0x7FFF is returned.*
* @param[out] sht_temperature If the sht heating is completed, this value
* indicates the scaled temperature of the SHT4x sensor. Value is scaled with
* factor 200: T [°C] = value / 200 *Note: If this value is not available,
* 0x7FFF is returned.*
*
* @note This command must be used after the "Activate SHT Heater" command.
* The get sht heater measurements command can be queried every 0.05s to get the
* measurements. This command is only available in idle mode.
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_get_sht_heater_measurements(int16_t* sht_relative_humidity,
int16_t* sht_temperature);
/**
* @brief Read measured values as integers.
*
* Returns the measured values. The command "Get Data Ready" can be used to
* check if new data is available since the last read operation. If no new data
* is available, the previous values will be returned again. If no data is
* available at all (e.g. measurement not running for at least one second), all
* values will be at their upper limit (0xFFFF for uint16, 0x7FFF for int16).
*
* @param[out] mass_concentration_pm1p0 Value is scaled with factor 10: PM1.0
* [µg/m³] = value / 10 *Note: If this value is unknown, 0xFFFF is returned.*
* @param[out] mass_concentration_pm2p5 Value is scaled with factor 10: PM2.5
* [µg/m³] = value / 10 *Note: If this value is unknown, 0xFFFF is returned.*
* @param[out] mass_concentration_pm4p0 Value is scaled with factor 10: PM4.0
* [µg/m³] = value / 10 *Note: If this value is unknown, 0xFFFF is returned.*
* @param[out] mass_concentration_pm10p0 Value is scaled with factor 10: PM10.0
* [µg/m³] = value / 10 *Note: If this value is unknown, 0xFFFF is returned.*
* @param[out] ambient_humidity Value is scaled with factor 100: RH [%] = value
* / 100 *Note: If this value is unknown, 0x7FFF is returned.*
* @param[out] ambient_temperature Value is scaled with factor 200: T [°C] =
* value / 200 *Note: If this value is unknown, 0x7FFF is returned.*
* @param[out] voc_index Value is scaled with factor 10: VOC Index = value / 10
* *Note: If this value is unknown, 0x7FFF is returned.*
* @param[out] nox_index Value is scaled with factor 10: NOx Index = value / 10
* *Note: If this value is unknown, 0x7FFF is returned. During the first 10..11
* seconds after power-on or device reset, this value will be 0x7FFF as well.*
* @param[out] co2 CO₂ concentration [ppm] *Note: If this value is unknown,
* 0xFFFF is returned. During the first 5..6 seconds after power-on or device
* reset, this value will be 0xFFFF as well.*
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_read_measured_values_as_integers(
uint16_t* mass_concentration_pm1p0, uint16_t* mass_concentration_pm2p5,
uint16_t* mass_concentration_pm4p0, uint16_t* mass_concentration_pm10p0,
int16_t* ambient_humidity, int16_t* ambient_temperature, int16_t* voc_index,
int16_t* nox_index, uint16_t* co2);
/**
* @brief sen66_read_measured_raw_values
*
* Returns the measured raw values. The command "Get Data Ready" can be used to
* check if new data is available since the last read operation. If no new data
* is available, the previous values will be returned again. If no data is
* available at all (e.g. measurement not running for at least one second), all
* values will be at their upper limit (0xFFFF for uint16, 0x7FFF for int16).
*
* @param[out] raw_humidity Value is scaled with factor 100: RH [%] = value /
* 100 *Note: If this value is unknown, 0x7FFF is returned.*
* @param[out] raw_temperature Value is scaled with factor 200: T [°C] = value /
* 200 *Note: If this value is unknown, 0x7FFF is returned.*
* @param[out] raw_voc Raw measured VOC ticks without scale factor. *Note: If
* this value is unknown, 0xFFFF is returned.*
* @param[out] raw_nox Raw measured NOx ticks without scale factor. *Note: If
* this value is unknown, 0xFFFF is returned. During the first 10..11 seconds
* after power-on or device reset, this value will be 0xFFFF as well.*
* @param[out] raw_co2 Not interpolated CO₂ concentration [ppm] updated every
* five seconds. *Note: If this value is unknown, 0xFFFF is returned. During the
* first 5..6 seconds after power-on or device reset, this value will be 0xFFFF
* as well.*
*
* @return error_code 0 on success, an error code otherwise.
*/
int16_t sen66_read_measured_raw_values(int16_t* raw_humidity,
int16_t* raw_temperature,
uint16_t* raw_voc, uint16_t* raw_nox,
uint16_t* raw_co2);
#ifdef __cplusplus
}
#endif
#endif // SEN66_I2C_H
+32 -13
View File
@@ -28,7 +28,7 @@
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
// File: src/sensirion_common.c
#include "sensirion_common.h"
#include "sensirion_config.h"
@@ -60,27 +60,27 @@ float sensirion_common_bytes_to_float(const uint8_t* bytes) {
}
void sensirion_common_uint32_t_to_bytes(const uint32_t value, uint8_t* bytes) {
bytes[0] = value >> 24;
bytes[1] = value >> 16;
bytes[2] = value >> 8;
bytes[3] = value;
bytes[0] = (uint8_t)(value >> 24);
bytes[1] = (uint8_t)(value >> 16);
bytes[2] = (uint8_t)(value >> 8);
bytes[3] = (uint8_t)(value);
}
void sensirion_common_uint16_t_to_bytes(const uint16_t value, uint8_t* bytes) {
bytes[0] = value >> 8;
bytes[1] = value;
bytes[0] = (uint8_t)(value >> 8);
bytes[1] = (uint8_t)value;
}
void sensirion_common_int32_t_to_bytes(const int32_t value, uint8_t* bytes) {
bytes[0] = value >> 24;
bytes[1] = value >> 16;
bytes[2] = value >> 8;
bytes[3] = value;
bytes[0] = (uint8_t)(value >> 24);
bytes[1] = (uint8_t)(value >> 16);
bytes[2] = (uint8_t)(value >> 8);
bytes[3] = (uint8_t)value;
}
void sensirion_common_int16_t_to_bytes(const int16_t value, uint8_t* bytes) {
bytes[0] = value >> 8;
bytes[1] = value;
bytes[0] = (uint8_t)(value >> 8);
bytes[1] = (uint8_t)value;
}
void sensirion_common_float_to_bytes(const float value, uint8_t* bytes) {
@@ -99,3 +99,22 @@ void sensirion_common_copy_bytes(const uint8_t* source, uint8_t* destination,
destination[i] = source[i];
}
}
void sensirion_common_to_integer(const uint8_t* source, uint8_t* destination,
INT_TYPE int_type, uint8_t data_length) {
if (data_length > int_type) {
data_length = 0; // we do not read at all if data_length is bigger than
// the provided integer!
}
// pad missing bytes
uint8_t offset = int_type - data_length;
for (uint8_t i = 0; i < offset; i++) {
destination[int_type - i - 1] = 0;
}
for (uint8_t i = 1; i <= data_length; i++) {
destination[int_type - offset - i] = source[i - 1];
}
}
@@ -50,6 +50,11 @@ extern "C" {
#define SENSIRION_NUM_WORDS(x) (sizeof(x) / SENSIRION_WORD_SIZE)
#define SENSIRION_MAX_BUFFER_WORDS 32
/**
* Enum to describe the type of an integer
*/
typedef enum { BYTE = 1, SHORT = 2, INTEGER = 4, LONG_INTEGER = 8 } INT_TYPE;
/**
* sensirion_common_bytes_to_int16_t() - Convert an array of bytes to an int16_t
*
@@ -174,6 +179,17 @@ void sensirion_common_float_to_bytes(const float value, uint8_t* bytes);
void sensirion_common_copy_bytes(const uint8_t* source, uint8_t* destination,
uint16_t data_length);
/**
* sensirion_common_to_integer() - Copy bytes from byte array to integer.
*
* @param source Array of bytes to be copied.
* @param int_value Pointer to integer of bytes to be copied to.
* @param int_type Type (size) of the integer to be copied.
* @param data_length Number of bytes to copy.
*/
void sensirion_common_to_integer(const uint8_t* source, uint8_t* destination,
INT_TYPE int_type, uint8_t data_length);
#ifdef __cplusplus
}
#endif
+14 -1
View File
@@ -28,7 +28,7 @@
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
// File: src/sensirion_i2c.c
#include "sensirion_i2c.h"
#include "sensirion_common.h"
#include "sensirion_config.h"
@@ -177,6 +177,19 @@ uint16_t sensirion_i2c_add_command_to_buffer(uint8_t* buffer, uint16_t offset,
return offset;
}
uint16_t sensirion_i2c_add_command16_to_buffer(uint8_t* buffer, uint16_t offset,
uint16_t command) {
buffer[offset++] = (uint8_t)((command & 0xFF00) >> 8);
buffer[offset++] = (uint8_t)((command & 0x00FF) >> 0);
return offset;
}
uint16_t sensirion_i2c_add_command8_to_buffer(uint8_t* buffer, uint16_t offset,
uint8_t command) {
buffer[offset++] = command;
return offset;
}
uint16_t sensirion_i2c_add_uint32_t_to_buffer(uint8_t* buffer, uint16_t offset,
uint32_t data) {
buffer[offset++] = (uint8_t)((data & 0xFF000000) >> 24);
+33
View File
@@ -181,6 +181,39 @@ int16_t sensirion_i2c_read_cmd(uint8_t address, uint16_t cmd,
uint16_t sensirion_i2c_add_command_to_buffer(uint8_t* buffer, uint16_t offset,
uint16_t command);
/**
* sensirion_i2c_add_command16_to_buffer() - Add a command to the buffer at
* the specified offset. This function is equivalent to the
* function sensirion_i2c_add_command_to_buffer().
*
* @param buffer Pointer to buffer in which the write frame will be prepared.
* Caller needs to make sure that there is enough space after
* offset left to write the data into the buffer.
* @param offset Offset of the next free byte in the buffer.
* @param command Command to be written into the buffer.
*
* @return Offset of next free byte in the buffer after writing the data.
*/
uint16_t sensirion_i2c_add_command16_to_buffer(uint8_t* buffer, uint16_t offset,
uint16_t command);
/**
* sensirion_i2c_add_command8_to_buffer() - Add a command to the buffer at
* offset. Adds one bytes command to the buffer.
* This is used for sensor that only take one command byte such as
* SHT.
*
* @param buffer Pointer to buffer in which the write frame will be prepared.
* Caller needs to make sure that there is enough space after
* offset left to write the data into the buffer.
* @param offset Offset of the next free byte in the buffer.
* @param command Command to be written into the buffer.
*
* @return Offset of next free byte in the buffer after writing the data.
*/
uint16_t sensirion_i2c_add_command8_to_buffer(uint8_t* buffer, uint16_t offset,
uint8_t command);
/**
* sensirion_i2c_add_uint32_t_to_buffer() - Add a uint32_t to the buffer at
* offset. Adds 6 bytes to the buffer.
@@ -11,6 +11,9 @@
#include <inttypes.h>
#include "sensirion_i2c_esp32_config.h"
#include "hardware_config.h"
#include "sensor_soft_i2c.h"
#include "esp_rom_sys.h"
static const char* TAG = "sensirion_i2c_hal";
@@ -31,6 +34,45 @@ static i2c_dev_t dev = {0};
static struct esp32_i2c_config i2c_cfg = {0};
static esp_err_t i2c_ok = ESP_OK;
#if NANOPSX_SENSOR_SOFT_I2C
static SemaphoreHandle_t soft_mutex;
static void soft_sda(void *ctx, int release) {
struct esp32_i2c_config *p = ctx;
gpio_set_level(p->sda, release);
}
static void soft_scl(void *ctx, int release) {
struct esp32_i2c_config *p = ctx;
gpio_set_level(p->scl, release);
}
static int soft_read_sda(void *ctx) {
return gpio_get_level(((struct esp32_i2c_config *)ctx)->sda);
}
static int soft_read_scl(void *ctx) {
return gpio_get_level(((struct esp32_i2c_config *)ctx)->scl);
}
static void soft_delay(void *ctx, unsigned us) {
(void)ctx;
esp_rom_delay_us(us);
}
static int8_t soft_transfer(uint8_t address, uint8_t *data, uint16_t count, bool read) {
if (!soft_mutex || !xSemaphoreTake(soft_mutex, pdMS_TO_TICKS(1000)))
return SENSIRION_I2C_HAL_ERROR;
const sensor_soft_i2c_t port = {
.context = &i2c_cfg, .sda = soft_sda, .scl = soft_scl,
.read_sda = soft_read_sda, .read_scl = soft_read_scl,
.delay_us = soft_delay,
.half_period_us = (1000000U + 2 * i2c_cfg.freq - 1) / (2 * i2c_cfg.freq),
.stretch_timeout_us = 5000,
};
int rc = sensor_soft_i2c_transfer(&port, address, data, count, read);
xSemaphoreGive(soft_mutex);
i2c_ok = rc == 0 ? ESP_OK : ESP_FAIL;
if (rc) ESP_LOGW(TAG, "GPIO I2C %s failed addr=0x%02x rc=%d",
read ? "read" : "write", address, rc);
return rc == 0 ? 0 : SENSIRION_I2C_HAL_ERROR;
}
#endif
static int8_t sensirion_map_esp_err(esp_err_t err) {
return (err == ESP_OK) ? (int8_t)NO_ERROR : SENSIRION_I2C_HAL_ERROR;
}
@@ -40,6 +82,9 @@ static int8_t sensirion_map_esp_err(esp_err_t err) {
* Optional for single-bus setups.
*/
int16_t sensirion_i2c_hal_select_bus(uint8_t bus_idx) {
#if NANOPSX_SENSOR_SOFT_I2C
return bus_idx == i2c_cfg.port ? NO_ERROR : SENSIRION_I2C_HAL_ERROR;
#endif
/*
* NOTE:
* - This only switches the I2C port number.
@@ -70,6 +115,30 @@ esp_err_t sensirion_i2c_esp32_ok(void) {
* communication.
*/
void sensirion_i2c_hal_init(void) {
#if NANOPSX_SENSOR_SOFT_I2C
if (!i2c_cfg.freq || i2c_cfg.freq > 100000 ||
!GPIO_IS_VALID_OUTPUT_GPIO(i2c_cfg.sda) || !GPIO_IS_VALID_OUTPUT_GPIO(i2c_cfg.scl) ||
i2c_cfg.sda == i2c_cfg.scl) {
i2c_ok = ESP_ERR_INVALID_ARG;
return;
}
gpio_set_level(i2c_cfg.sda, 1);
gpio_set_level(i2c_cfg.scl, 1);
gpio_config_t pins = {
.pin_bit_mask = (1ULL << i2c_cfg.sda) | (1ULL << i2c_cfg.scl),
.mode = GPIO_MODE_INPUT_OUTPUT_OD,
.pull_up_en = GPIO_PULLUP_ENABLE,
.pull_down_en = GPIO_PULLDOWN_DISABLE,
.intr_type = GPIO_INTR_DISABLE,
};
i2c_ok = gpio_config(&pins);
if (i2c_ok != ESP_OK) return;
soft_mutex = xSemaphoreCreateMutex();
if (!soft_mutex) { i2c_ok = ESP_ERR_NO_MEM; return; }
ESP_LOGI(TAG, "GPIO I2C ready SDA=%d SCL=%d target=%lu Hz; touch uses hardware I2C",
i2c_cfg.sda, i2c_cfg.scl, (unsigned long)i2c_cfg.freq);
return;
#endif
memset(&dev, 0, sizeof(dev));
// Minimal sanity check
@@ -111,6 +180,12 @@ void sensirion_i2c_hal_init(void) {
* Release all resources initialized by sensirion_i2c_hal_init().
*/
void sensirion_i2c_hal_free(void) {
#if NANOPSX_SENSOR_SOFT_I2C
gpio_set_level(i2c_cfg.sda, 1);
gpio_set_level(i2c_cfg.scl, 1);
if (soft_mutex) { vSemaphoreDelete(soft_mutex); soft_mutex = NULL; }
return;
#endif
esp_err_t err = i2c_dev_delete_mutex(&dev);
if (err != ESP_OK) {
ESP_LOGW(TAG, "i2c_dev_delete_mutex failed: %s", esp_err_to_name(err));
@@ -126,6 +201,9 @@ int8_t sensirion_i2c_hal_read(uint8_t address, uint8_t* data, uint16_t count) {
if (count > 0 && data == NULL) {
return SENSIRION_I2C_HAL_ERROR;
}
#if NANOPSX_SENSOR_SOFT_I2C
return soft_transfer(address, data, count, true);
#endif
dev.addr = address;
@@ -163,6 +241,9 @@ int8_t sensirion_i2c_hal_write(uint8_t address, const uint8_t* data, uint16_t co
if (count > 0 && data == NULL) {
return SENSIRION_I2C_HAL_ERROR;
}
#if NANOPSX_SENSOR_SOFT_I2C
return soft_transfer(address, (uint8_t *)data, count, false);
#endif
dev.addr = address;
@@ -0,0 +1,82 @@
#include "sensor_soft_i2c.h"
#include <stddef.h>
static void delay(const sensor_soft_i2c_t *p) {
p->delay_us(p->context, p->half_period_us);
}
static int high(const sensor_soft_i2c_t *p) {
p->scl(p->context, 1);
for (unsigned n = 0; n <= p->stretch_timeout_us; n++) {
if (p->read_scl(p->context)) {
delay(p);
return 0;
}
p->delay_us(p->context, 1);
}
return -1;
}
static int write_bit(const sensor_soft_i2c_t *p, int bit) {
p->sda(p->context, bit);
delay(p);
if (high(p)) return -1;
p->scl(p->context, 0);
return 0;
}
static int read_bit(const sensor_soft_i2c_t *p) {
p->sda(p->context, 1);
delay(p);
if (high(p)) return -1;
int bit = p->read_sda(p->context) != 0;
p->scl(p->context, 0);
return bit;
}
static int write_byte(const sensor_soft_i2c_t *p, uint8_t byte) {
for (int n = 7; n >= 0; n--)
if (write_bit(p, (byte >> n) & 1)) return -1;
return read_bit(p); // ACK=0, NACK=1, bus failure=-1.
}
int sensor_soft_i2c_transfer(const sensor_soft_i2c_t *p, uint8_t address,
uint8_t *data, uint16_t count, bool read) {
if (!p || !p->sda || !p->scl || !p->read_sda || !p->read_scl ||
!p->delay_us || !p->half_period_us || address > 127 || (count && !data))
return -1;
p->sda(p->context, 1);
if (high(p) || !p->read_sda(p->context)) {
p->sda(p->context, 1);
p->scl(p->context, 1);
return -1;
}
p->sda(p->context, 0); // START while clock is high.
delay(p);
p->scl(p->context, 0);
int error = write_byte(p, (uint8_t)((address << 1) | read));
for (uint16_t i = 0; i < count && !error; i++) {
if (!read) {
error = write_byte(p, data[i]);
continue;
}
uint8_t byte = 0;
for (unsigned n = 0; n < 8; n++) {
int bit = read_bit(p);
if (bit < 0) { error = -1; break; }
byte = (uint8_t)((byte << 1) | bit);
}
if (!error) {
data[i] = byte;
error = write_bit(p, i + 1 == count); // NACK only the final byte.
}
}
// STOP on both success and failure; leave neither line driven low.
p->scl(p->context, 0);
p->sda(p->context, 0);
delay(p);
int stop_error = high(p);
p->sda(p->context, 1);
delay(p);
return error ? error : stop_error;
}
@@ -0,0 +1,21 @@
#pragma once
#include <stdbool.h>
#include <stdint.h>
/* Single-master, open-drain GPIO bus. 1 means release, never drive high.
* Port callbacks make the wire protocol testable without ESP hardware.
*/
typedef struct {
void *context;
void (*sda)(void *, int);
void (*scl)(void *, int);
int (*read_sda)(void *);
int (*read_scl)(void *);
void (*delay_us)(void *, unsigned);
unsigned half_period_us;
unsigned stretch_timeout_us;
} sensor_soft_i2c_t;
/* 0 success, 1 NACK, -1 bus/argument error. Always releases lines on failure. */
int sensor_soft_i2c_transfer(const sensor_soft_i2c_t *io, uint8_t address,
uint8_t *data, uint16_t count, bool read);