Add a working example for esp32_devkitc_v4

The driver in esp32 is not anymore working and will be replaced for all
driver packages. For now we provide a dedicated example for sen66 and
the device kit esp32_devkitc_v4.
The example can be built and executed using idf.py

Author: Rol-la

sample-implementations/esp32_devkitc_v4/.clang-format

@@ -0,0 +1,14 @@
+---
+Language: Cpp
+BasedOnStyle: LLVM
+IndentWidth: 4
+AlignAfterOpenBracket: Align
+AllowShortBlocksOnASingleLine: false
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: false
+IndentCaseLabels: true
+SpacesBeforeTrailingComments: 2
+PointerAlignment: Left
+AlignEscapedNewlines: Left
+ForEachMacros: ['TEST_GROUP', 'TEST']
+...

sample-implementations/esp32_devkitc_v4/.clangd

@@ -0,0 +1,3 @@
+CompileFlags:
+  Remove: [-m*, -f*]
+  CompilationDatabase: build

sample-implementations/esp32_devkitc_v4/CMakeLists.txt

@@ -0,0 +1,6 @@
+# The following lines of boilerplate have to be in your project's CMakeLists
+# in this exact order for cmake to work correctly
+cmake_minimum_required(VERSION 3.22)
+
+include($ENV{IDF_PATH}/tools/cmake/project.cmake)
+project(sen66_i2c_example_usage)

sample-implementations/esp32_devkitc_v4/dependencies.lock

@@ -0,0 +1,10 @@
+dependencies:
+  idf:
+    source:
+      type: idf
+    version: 6.0.0
+direct_dependencies:
+- idf
+manifest_hash: e44bf68eca6b7b264ddae08cd014cd3294c0473230381b6d6f88ed18ec879038
+target: esp32
+version: 2.0.0

sample-implementations/esp32_devkitc_v4/main/CMakeLists.txt

@@ -0,0 +1,2 @@
+idf_component_register(SRCS "sen66_i2c.c" "sen66_i2c_example_usage.c" "sensirion_common.c" "sensirion_i2c.c" "sensirion_i2c_hal.c"
+                       INCLUDE_DIRS ".")

sample-implementations/esp32_devkitc_v4/main/Kconfig.projbuild

@@ -0,0 +1,25 @@
+menu "Configuration Esp32 WROVER Kit I2C V4"
+
+    orsource "$IDF_PATH/examples/common_components/env_caps/$IDF_TARGET/Kconfig.env_caps"
+
+    config I2C_MASTER_SCL
+        int "SCL GPIO Num"
+        range ENV_GPIO_RANGE_MIN ENV_GPIO_OUT_RANGE_MAX
+        default 22
+        help
+            GPIO number for I2C Master clock line.
+
+    config I2C_MASTER_SDA
+        int "SDA GPIO Num"
+        range ENV_GPIO_RANGE_MIN ENV_GPIO_OUT_RANGE_MAX
+        default 21
+        help
+            GPIO number for I2C Master data line.
+
+    config I2C_MASTER_FREQUENCY
+        int "Master Frequency"
+        default 400000
+        help
+            I2C Speed of Master device.
+
+endmenu

sample-implementations/esp32_devkitc_v4/main/idf_component.yml

@@ -0,0 +1,5 @@
+## IDF Component Manager Manifest File
+dependencies:
+  ## Required IDF version
+  idf:
+    version: ">=4.1.0"

sample-implementations/esp32_devkitc_v4/main/sen66_i2c.c

@@ -0,0 +1 @@
+../../../sen66_i2c.c

sample-implementations/esp32_devkitc_v4/main/sen66_i2c.h

@@ -0,0 +1 @@
+../../../sen66_i2c.h

sample-implementations/esp32_devkitc_v4/main/sen66_i2c_example_usage.c

@@ -0,0 +1,107 @@
+/*
+ * THIS FILE IS AUTOMATICALLY GENERATED
+ *
+ * Generator:     sensirion-driver-generator 1.1.2
+ * Product:       sen66
+ * Model-Version: 1.6.0
+ */
+/*
+ * Copyright (c) 2025, 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_hal.h"
+#include <inttypes.h>  // PRIx64
+#include <stdio.h>     // printf
+
+#define sensirion_hal_sleep_us sensirion_i2c_hal_sleep_usec
+
+int app_main(void) {
+    int16_t error = NO_ERROR;
+    sensirion_i2c_hal_init();
+    sen66_init(SEN66_I2C_ADDR_6B);
+
+    error = sen66_device_reset();
+    if (error != NO_ERROR) {
+        printf("error executing device_reset(): %i\n", error);
+        return error;
+    }
+    sensirion_hal_sleep_us(1200000);
+    int8_t serial_number[32] = {0};
+    error = sen66_get_serial_number(serial_number, 32);
+    if (error != NO_ERROR) {
+        printf("error executing get_serial_number(): %i\n", error);
+        return error;
+    }
+    printf("serial_number: %s\n", serial_number);
+    error = sen66_start_continuous_measurement();
+    if (error != NO_ERROR) {
+        printf("error executing start_continuous_measurement(): %i\n", error);
+        return error;
+    }
+    uint16_t mass_concentration_pm1p0 = 0;
+    uint16_t mass_concentration_pm2p5 = 0;
+    uint16_t mass_concentration_pm4p0 = 0;
+    uint16_t mass_concentration_pm10p0 = 0;
+    int16_t ambient_humidity = 0;
+    int16_t ambient_temperature = 0;
+    int16_t voc_index = 0;
+    int16_t nox_index = 0;
+    uint16_t co2 = 0;
+    uint16_t repetition = 0;
+    for (repetition = 0; repetition < 100; repetition++) {
+        sensirion_hal_sleep_us(1000000);
+        error = sen66_read_measured_values_as_integers(
+            &mass_concentration_pm1p0, &mass_concentration_pm2p5,
+            &mass_concentration_pm4p0, &mass_concentration_pm10p0,
+            &ambient_humidity, &ambient_temperature, &voc_index, &nox_index,
+            &co2);
+        if (error != NO_ERROR) {
+            printf("error executing read_measured_values_as_integers(): %i\n",
+                   error);
+            continue;
+        }
+        printf("mass_concentration_pm1p0: %u ", mass_concentration_pm1p0);
+        printf("mass_concentration_pm2p5: %u ", mass_concentration_pm2p5);
+        printf("mass_concentration_pm4p0: %u ", mass_concentration_pm4p0);
+        printf("mass_concentration_pm10p0: %u ", mass_concentration_pm10p0);
+        printf("ambient_humidity: %i ", ambient_humidity);
+        printf("ambient_temperature: %i ", ambient_temperature);
+        printf("voc_index: %i ", voc_index);
+        printf("nox_index: %i ", nox_index);
+        printf("co2: %u\n", co2);
+    }
+
+    error = sen66_stop_measurement();
+    if (error != NO_ERROR) {
+        return error;
+    }
+    return NO_ERROR;
+}