Added Ceedling and Mocking based example as Lab4

Author: Bharathgopal

.github/workflows/test_coverage.yml

@@ -11,9 +11,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
-      - name: Install dependencies
-        run: sudo apt-get update && sudo apt-get install -y make gcc gcovr build-essential
-      - name: Install Renode
-        run: ./Lab3/install_tools.sh
+      - name: Setup Environment
+        run: ./install_tools.sh
       - name: Run renode based code coverage analysis
         run: make coverage -C Lab3
+      - name: Lab4 code coverage analysis
+        run: make coverage_summary -C Lab4

.gitignore

@@ -61,4 +61,6 @@ dkms.conf
 # Lab1 build artifacts and reports
 Lab1/Lab1
 Lab1/coverage_checksum.txt
-Lab1/*.gcov
+Lab1/*.gcov
+
+*build*

Lab3/Makefile

@@ -41,7 +41,7 @@ coverage: run
 			msg = sprintf("\nTotal Coverage: %.2f%% (%d/%d lines hit)\n", percent, hit, found); \
 			print msg; \
 			if (ENVIRON["GITHUB_STEP_SUMMARY"] != "") { \
-				printf "### 📊 Coverage Report\n- **Status:** %s\n- **Percentage:** %.2f%%\n- **Details:** %d out of %d lines executed\n", (percent == 100 ? "✅ Pass" : "⚠️ Partial"), percent, hit, found >> ENVIRON["GITHUB_STEP_SUMMARY"]; \
+				printf "### 📊 Coverage Report\n\n---\n\n## Lab3 - Renode Coverage\n- **Status:** %s\n- **Percentage:** %.2f%%\n- **Details:** %d out of %d lines executed\n", (percent == 100 ? "✅ Pass" : "⚠️ Partial"), percent, hit, found >> ENVIRON["GITHUB_STEP_SUMMARY"]; \
 			} \
 		}'
 

Lab3/install_tools.sh

@@ -0,0 +1,12 @@
+coverage:
+	ceedling gcov:all
+
+mock_test:
+	ceedling test:all
+
+coverage_summary: coverage
+	@python3 -m gcovr build/gcov/out --json-summary-pretty -o build/coverage.json
+	@python3 scripts/coverage_summary.py
+
+clean:
+	rm -rf build

Lab4/Makefile

@@ -0,0 +1,18 @@
+# Mocking Hardware APIs using CMock
+* This Lab demonstrates how embedded firmware can be tested without hardware by mocking ADC dependencies.
+
+## Learning Outcomes
+1. Understand hardware abstraction.
+2. Generate mocks using CMock.
+3. Validate business logic independent of hardware.
+4. Measure code coverage.
+5. Prepare firmware for CI/CD integration.
+
+Execution Environment:
+Host PC (Linux/Windows/macOS)
+
+Tools:
+- Unity
+- CMock
+- GCC
+- gcov

Lab4/README.MD

@@ -0,0 +1,22 @@
+:project:
+  :build_root: build
+  :test_file_prefix: test_
+
+:paths:
+  :source:
+    - src
+  :include:
+    - src
+  :test:
+    - test
+
+:cmock:
+  :mock_prefix: Mock
+
+:plugins:
+  :enabled:
+    - gcov
+
+:gcov:
+  :reports:
+    - HtmlDetailed

Lab4/project.yml

@@ -0,0 +1,27 @@
+import json
+import os
+
+with open("build/coverage.json") as f:
+    d = json.load(f)
+
+p = d["line_percent"]
+h = d["line_covered"]
+t = d["line_total"]
+
+status = "✅ Pass" if p == 100 else "⚠️ Partial"
+
+print("\n📊 Coverage Report")
+print(f"Status: {status}")
+print(f"Percentage: {p:.2f}%")
+print(f"Details: {h} out of {t} lines executed\n")
+
+summary = os.getenv("GITHUB_STEP_SUMMARY")
+if summary:
+    with open(summary, "a") as f:
+        f.write(
+            f"\n---\n\n"
+            f"## Lab4 - Unit Test Coverage\n"
+            f"- **Status:** {status}\n"
+            f"- **Percentage:** {p:.2f}%\n"
+            f"- **Details:** {h} out of {t} lines executed\n"
+        )

Lab4/scripts/coverage_summary.py

@@ -0,0 +1,12 @@
+#include "adc.h"
+
+/**
+ * @brief Read ADC value and convert to millivolts.
+ *
+ * In real firmware this function would read
+ * from ADC hardware registers and convert to mv.
+ */
+uint16_t adc_read_battery_mv(void)
+{
+    return 3700;
+}

Lab4/src/adc.c

@@ -0,0 +1,13 @@
+#ifndef ADC_H
+#define ADC_H
+
+#include <stdint.h>
+
+/**
+ * @brief Read battery voltage from ADC.
+ *
+ * @return Battery voltage in millivolts.
+ */
+uint16_t adc_read_battery_mv(void);
+
+#endif /* ADC_H */