fix: Separate AVR and ESP platforms from the test pipeline. Reintroduce ESP-Webserver to the test compilation

Author: milesburton

.github/workflows/README.md

@@ -0,0 +1,146 @@
+# 📂 GitHub Workflows for Arduino Temperature Control Library
+
+[![Workflow Status](https://github.com/your-username/your-repo/actions/workflows/arduino-ci.yml/badge.svg)](https://github.com/your-username/your-repo/actions/workflows/arduino-ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/your-username/your-repo/blob/main/LICENSE)
+[![GitHub Releases](https://img.shields.io/github/release/your-username/your-repo.svg?maxAge=3600)](https://github.com/your-username/your-repo/releases)
+
+Automate testing, compilation, and validation of the Arduino Temperature Control Library across multiple platforms using GitHub Actions.
+
+## 🛠️ Workflows Overview
+
+### 1. 📦 Arduino CI Workflow
+
+**Purpose:**  
+Compiles the library and its examples for both AVR and ESP8266 platforms.
+
+**Trigger:**  
+Runs on every `push` and `pull_request`.
+
+**Key Features:**
+- **AVR Compilation:** Compiles all examples for the AVR platform (e.g., Arduino Uno).
+- **ESP8266 Compilation:** Compiles all examples for the ESP8266 platform (e.g., NodeMCU v2).
+- **Selective Compilation:** Skips ESP-specific examples (e.g., ESP-WebServer) when compiling for AVR.
+- **Unit Testing:** Executes unit tests using the `arduino_ci` framework.
+
+### 2. 🔄 Why Separate AVR and ESP Platforms?
+
+The library supports both AVR-based boards (e.g., Arduino Uno) and ESP8266-based boards (e.g., NodeMCU). Some examples utilize ESP-specific libraries like `ESP8266WiFi.h`, which are incompatible with AVR platforms. Separating the compilation ensures:
+
+- **AVR Compatibility:** Skips ESP-specific examples to prevent compilation errors.
+- **ESP Compatibility:** Compiles all examples, including ESP-specific ones, for the ESP8266 platform.
+
+### 3. ⚙️ Workflow Steps
+
+The workflow follows these steps:
+
+1. **Setup Environment:**
+   - Installs dependencies (e.g., `gcc-avr`, `avr-libc`).
+   - Configures the Arduino CLI and installs required cores (`arduino:avr` and `esp8266:esp8266`).
+
+2. **Install Libraries:**
+   - Installs the OneWire library.
+   - Applies a custom CRC implementation.
+
+3. **Run Unit Tests:**
+   - Executes unit tests using the `arduino_ci` framework for the AVR platform.
+
+4. **Compile Examples for AVR:**
+   - Compiles all examples (excluding ESP-specific ones) for the AVR platform.
+
+5. **Compile Examples for ESP8266:**
+   - Compiles all examples (including ESP-specific ones) for the ESP8266 platform.
+
+### 4. 📁 File Structure
+
+Understanding the project’s file structure is crucial for effective navigation and contribution. Below is an overview of the key files and directories:
+
+- **`Gemfile`**
+  - **Description:**  
+    Manages Ruby dependencies required for the project. It ensures that the correct versions of gems (like `arduino_ci`) are used.
+  - **Usage:**  
+    Run `bundle install` to install the necessary gems.
+
+- **`.arduino-ci.yml`**
+  - **Description:**  
+    Configuration file for the `arduino_ci` tool. It defines how the Arduino CI should run tests and compile sketches.
+  - **Key Configurations:**
+    - Specifies which boards to target.
+    - Defines libraries and dependencies needed for testing.
+    - Sets up compilation and testing parameters.
+
+- **`.arduino_ci/`**
+  - **Description:**  
+    Contains supporting files and configurations for the `arduino_ci.rb` tool.
+  - **Contents:**
+    - **`config.rb`:**  
+      Custom configuration settings for the Arduino CI.
+    - **`helpers.rb`:**  
+      Helper methods and utilities used by the CI scripts.
+    - **Other supporting scripts and assets.**
+
+- **`arduino-ci.yml`**
+  - **Description:**  
+    GitHub Actions workflow file that defines the CI pipeline for the project.
+  - **Key Sections:**
+    - **Jobs:**  
+      Defines the sequence of steps for setting up the environment, installing dependencies, running tests, and compiling examples.
+    - **Triggers:**  
+      Specifies when the workflow should run (e.g., on push or pull request).
+
+- **`examples/`**
+  - **Description:**  
+    Contains example sketches demonstrating how to use the Arduino Temperature Control Library.
+  - **Structure:**
+    - **`ESP-WebServer/`**  
+      ESP-specific examples that utilize libraries like `ESP8266WiFi.h`.
+
+- **`LICENSE`**
+  - **Description:**  
+    Contains the MIT License under which the project is released.
+
+- **Other Files and Directories:**
+  - **`.github/`**
+    - Contains GitHub-specific configurations, issues templates, and additional workflows.
+  - **`src/`**
+    - Contains the source code of the Arduino Temperature Control Library.
+
+### 5. 🔧 Workflow Configuration
+
+The workflow is defined in the `arduino-ci.yml` file. Key configurations include:
+
+- **Cores Installed:**
+  ```yaml
+  arduino-cli core install arduino:avr
+  arduino-cli core install esp8266:esp8266
+  ```
+
+- **Skipping ESP-Specific Examples:**
+  ```yaml
+  export ARDUINO_CI_SKIP_EXAMPLES="ESP-WebServer"
+  ```
+
+- **Compiling for AVR and ESP Platforms:**
+  ```yaml
+  arduino-cli compile --fqbn arduino:avr:uno "$sketch"
+  arduino-cli compile --fqbn esp8266:esp8266:nodemcuv2 "$sketch"
+  ```
+
+### 6. 🤝 Contributing
+
+If you’re contributing to the workflows, please ensure that:
+
+- **Compatibility:** New examples are compatible with both AVR and ESP platforms (if applicable).
+- **Organization:** ESP-specific examples are placed in a clearly labeled directory (e.g., `examples/ESP-WebServer`).
+- **Testing:** Unit tests are added or updated as needed.
+
+### 7. 🐞 Troubleshooting
+
+If the workflow fails:
+
+1. **Check Logs:** Navigate to the Actions tab in GitHub for detailed logs.
+2. **Local Replication:** Try to replicate the issue locally using the dev container.
+3. **Dependencies:** Ensure all dependencies are installed correctly.
+
+## 📄 License
+
+This workflow configuration and scripts are released under the [MIT License](LICENSE).

.github/workflows/arduino-ci.yml

@@ -72,11 +72,22 @@ jobs:
         run: |
           ls -R
 
-      - name: Remove Blacklisted Example Sketches
+      - name: Run tests (skip example compilation)
         run: |
-          echo "Removing blacklisted example sketches..."
-          rm -f examples/ESP-WebServer/ESP-WebServer.ino
+          # Run arduino_ci for unit tests only (skip example compilation)
+          export ARDUINO_CI_SELECTED_BOARD="arduino:avr:uno"
+          bundle exec arduino_ci.rb --skip-examples-compilation
 
-      - name: Run tests
+      - name: Compile all sketches for AVR platform
         run: |
-          bundle exec arduino_ci.rb
+          # Compile all sketches for AVR platform (Arduino Uno), excluding ESP-WebServer
+          for sketch in $(find examples -name "*.ino" ! -path "*/ESP-WebServer/*"); do
+            arduino-cli compile --fqbn arduino:avr:uno $sketch
+          done
+
+      - name: Compile all sketches for ESP8266 platform
+        run: |
+          # Compile all sketches for ESP8266 platform (NodeMCU v2)
+          for sketch in $(find examples -name "*.ino"); do
+            arduino-cli compile --fqbn esp8266:esp8266:nodemcuv2 $sketch
+          done

test/unit_test_001.cpp

@@ -0,0 +1,76 @@
+//    FILE: unit_test_001.cpp
+//  AUTHOR: Miles Burton / Rob Tillaart
+//    DATE: 2021-01-10
+// PURPOSE: unit tests for the Arduino-Temperature-Control-Library
+//          https://github.com/MilesBurton/Arduino-Temperature-Control-Library
+
+
+#include <ArduinoUnitTests.h>
+#include <Arduino.h>
+#include <OneWire.h>
+#include <DallasTemperature.h>
+
+// Mock pin for testing
+#define ONE_WIRE_BUS 2
+
+unittest_setup() {
+    fprintf(stderr, "VERSION: %s\n", DALLASTEMPLIBVERSION);
+}
+
+unittest_teardown() {
+    fprintf(stderr, "\n");
+}
+
+// Test constants defined in the library
+unittest(test_models) {
+    assertEqual(0x10, DS18S20MODEL);
+    assertEqual(0x28, DS18B20MODEL);
+    assertEqual(0x22, DS1822MODEL);
+    assertEqual(0x3B, DS1825MODEL);
+    assertEqual(0x42, DS28EA00MODEL);
+}
+
+// Test error codes defined in the library
+unittest(test_error_code) {
+    assertEqual(DEVICE_DISCONNECTED_C, -127);
+    assertEqual(DEVICE_DISCONNECTED_F, -196.6);
+    assertEqual(DEVICE_DISCONNECTED_RAW, -7040);
+
+    assertEqual(DEVICE_FAULT_OPEN_C, -254);
+    assertEqualFloat(DEVICE_FAULT_OPEN_F, -425.2, 0.1);
+    assertEqual(DEVICE_FAULT_OPEN_RAW, -32512);
+
+    assertEqual(DEVICE_FAULT_SHORTGND_C, -253);
+    assertEqualFloat(DEVICE_FAULT_SHORTGND_F, -423.4, 0.1);
+    assertEqual(DEVICE_FAULT_SHORTGND_RAW, -32384);
+
+    assertEqual(DEVICE_FAULT_SHORTVDD_C, -252);
+    assertEqualFloat(DEVICE_FAULT_SHORTVDD_F, -421.6, 0.1);
+    assertEqual(DEVICE_FAULT_SHORTVDD_RAW, -32256);
+}
+
+// Test basic initialization and functionality of the DallasTemperature library
+unittest(test_initialization) {
+    OneWire oneWire(ONE_WIRE_BUS);
+    DallasTemperature sensors(&oneWire);
+
+    sensors.begin();
+
+    // Initially, there should be no devices detected
+    assertEqual(0, sensors.getDeviceCount());
+    assertFalse(sensors.isParasitePowerMode());
+}
+
+// Simulate a basic temperature read (mocked)
+unittest(test_temperature_read) {
+    OneWire oneWire(ONE_WIRE_BUS);
+    DallasTemperature sensors(&oneWire);
+
+    sensors.begin();
+
+    // Mock reading temperature
+    float tempC = sensors.getTempCByIndex(0);
+    assertEqual(DEVICE_DISCONNECTED_C, tempC); // Simulated no device connected
+}
+
+unittest_main()