Align formatter baseline with esptoolkit-template

.clang-format

@@ -0,0 +1,11 @@
+BasedOnStyle: LLVM
+ColumnLimit: 100
+BinPackArguments: false
+BinPackParameters: false
+AllowAllArgumentsOnNextLine: false
+AlignAfterOpenBracket: BlockIndent
+UseTab: ForIndentation
+IndentWidth: 4
+TabWidth: 4
+ContinuationIndentWidth: 4
+AllowShortFunctionsOnASingleLine: None

.editorconfig

@@ -0,0 +1,11 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+charset = utf-8
+
+[*.{c,cc,cpp,h,hpp,ino}]
+indent_style = tab
+indent_size = tab
+tab_width = 4

.gitignore

@@ -1,4 +1,3 @@
 .venv
 build/
 build_prev_runner/
-.vscode

.vscode/bin/clang-format

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+if command -v clang-format >/dev/null 2>&1; then
+    exec clang-format "$@"
+fi
+
+_home_dir="${HOME:-}"
+if [ -n "$_home_dir" ]; then
+    _candidate="$(ls -1d "$_home_dir"/.vscode/extensions/ms-vscode.cpptools-*-linux-x64/LLVM/bin/clang-format 2>/dev/null | tail -n 1 || true)"
+    if [ -n "$_candidate" ] && [ -x "$_candidate" ]; then
+        exec "$_candidate" "$@"
+    fi
+fi
+
+echo "clang-format executable not found." >&2
+echo "Install clang-format system-wide or install/update ms-vscode.cpptools." >&2
+exit 127

.vscode/extensions.json

@@ -0,0 +1,9 @@
+{
+    "recommendations": [
+        "pioarduino.pioarduino-ide",
+        "xaver.clang-format"
+    ],
+    "unwantedRecommendations": [
+        "ms-vscode.cpptools-extension-pack"
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,30 @@
+{
+    "files.associations": {
+        "*.ino": "cpp"
+    },
+    "editor.defaultFormatter": "xaver.clang-format",
+    "C_Cpp.formatting": "Disabled",
+    "clang-format.style": "file",
+    "clang-format.executable": "${workspaceRoot}/.vscode/bin/clang-format",
+    "[cpp]": {
+        "editor.defaultFormatter": "xaver.clang-format",
+        "editor.detectIndentation": false,
+        "editor.insertSpaces": false,
+        "editor.tabSize": 4,
+        "editor.formatOnSave": true
+    },
+    "[c]": {
+        "editor.defaultFormatter": "xaver.clang-format",
+        "editor.detectIndentation": false,
+        "editor.insertSpaces": false,
+        "editor.tabSize": 4,
+        "editor.formatOnSave": true
+    },
+    "[arduino]": {
+        "editor.defaultFormatter": "xaver.clang-format",
+        "editor.detectIndentation": false,
+        "editor.insertSpaces": false,
+        "editor.tabSize": 4,
+        "editor.formatOnSave": true
+    }
+}

.vscode/tasks.json

@@ -0,0 +1,12 @@
+{
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "Format Firmware Sources",
+            "type": "shell",
+            "command": "bash ${workspaceFolder}/scripts/format_cpp.sh",
+            "group": "build",
+            "problemMatcher": []
+        }
+    ]
+}

README.md

@@ -339,6 +339,13 @@ Example sketches in this repo:
 - Host-side CTest is intentionally skipped because the scheduler relies on ESP32 FreeRTOS and ESPDate wall-clock helpers.
 - CI also compiles all examples through PlatformIO and Arduino CLI across ESP32, S3, C3, and P4 boards.
 
+## Formatting Baseline
+
+This repository follows the firmware formatting baseline from `esptoolkit-template`:
+- `.clang-format` is the source of truth for C/C++/INO layout.
+- `.editorconfig` enforces tabs (`tab_width = 4`), LF endings, and final newline.
+- Format all tracked firmware sources with `bash scripts/format_cpp.sh`.
+
 ## License
 MIT — see `LICENSE.md`.
 

examples/custom_fields/custom_fields.ino

@@ -18,19 +18,15 @@ void setup() {
 
 	int weekdays[] = {1, 3, 5}; // Mon, Wed, Fri (0 = Sun)
 	Schedule custom = Schedule::custom(
-		ScheduleField::every(5),		 // every 5 minutes
-		ScheduleField::range(9, 17),	 // during hours 9..17
-		ScheduleField::any(),			 // any day of month
-		ScheduleField::any(),			 // any month
-		ScheduleField::list(weekdays, 3) // selected weekdays
+	    ScheduleField::every(5),         // every 5 minutes
+	    ScheduleField::range(9, 17),     // during hours 9..17
+	    ScheduleField::any(),            // any day of month
+	    ScheduleField::any(),            // any month
+	    ScheduleField::list(weekdays, 3) // selected weekdays
 	);
 
-	scheduler.addJob(
-		custom,
-		SchedulerJobMode::Inline,
-		&customInline,
-		(void *)"MWF 9-17 every 5min"
-  );
+	scheduler
+	    .addJob(custom, SchedulerJobMode::Inline, &customInline, (void *)"MWF 9-17 every 5min");
 }
 
 void loop() {

examples/inline_astronomical/inline_astronomical.ino

@@ -28,29 +28,25 @@ void setup() {
 
 	scheduler.setMinValidUtc(date.fromUtc(2020, 1, 1, 0, 0, 0));
 
+	scheduler
+	    .addJob(Schedule::sunrise(), SchedulerJobMode::Inline, &astroCallback, (void *)"sunrise");
 	scheduler.addJob(
-		Schedule::sunrise(),
-		SchedulerJobMode::Inline,
-		&astroCallback,
-		(void *)"sunrise"
+	    Schedule::sunset(15),
+	    SchedulerJobMode::Inline,
+	    &astroCallback,
+	    (void *)"sunset +15m"
 	);
 	scheduler.addJob(
-		Schedule::sunset(15),
-		SchedulerJobMode::Inline,
-		&astroCallback,
-		(void *)"sunset +15m"
+	    Schedule::moonPhase(MoonPhaseName::LastQuarter, 2),
+	    SchedulerJobMode::Inline,
+	    &astroCallback,
+	    (void *)"last quarter"
 	);
 	scheduler.addJob(
-		Schedule::moonPhase(MoonPhaseName::LastQuarter, 2),
-		SchedulerJobMode::Inline,
-		&astroCallback,
-		(void *)"last quarter"
-	);
-	scheduler.addJob(
-		Schedule::moonIlluminationPercent(75.0, 0.5),
-		SchedulerJobMode::Inline,
-		&astroCallback,
-		(void *)"illumination 75%"
+	    Schedule::moonIlluminationPercent(75.0, 0.5),
+	    SchedulerJobMode::Inline,
+	    &astroCallback,
+	    (void *)"illumination 75%"
 	);
 }
 

examples/inline_every_15_minutes_work_hours/inline_every_15_minutes_work_hours.ino

@@ -17,12 +17,12 @@ void setup() {
 
 	// Useful for periodic checks while staff is active.
 	Schedule schedule = Schedule::custom(
-		ScheduleField::every(15), // minute: 0,15,30,45
-		ScheduleField::range(9, 17),
-		ScheduleField::any(),
-		ScheduleField::any(),
-		ScheduleField::any()
-  );
+	    ScheduleField::every(15), // minute: 0,15,30,45
+	    ScheduleField::range(9, 17),
+	    ScheduleField::any(),
+	    ScheduleField::any(),
+	    ScheduleField::any()
+	);
 
 	scheduler.addJob(schedule, SchedulerJobMode::Inline, &workHoursPulse, nullptr);
 }

examples/inline_every_hour/inline_every_hour.ino

@@ -17,12 +17,12 @@ void setup() {
 
 	// Fires at HH:00 every day.
 	Schedule schedule = Schedule::custom(
-		ScheduleField::only(0), // minute
-		ScheduleField::any(),	  // hour
-		ScheduleField::any(),	  // day of month
-		ScheduleField::any(),	  // month
-		ScheduleField::any()    // day of week
-  );
+	    ScheduleField::only(0), // minute
+	    ScheduleField::any(),   // hour
+	    ScheduleField::any(),   // day of month
+	    ScheduleField::any(),   // month
+	    ScheduleField::any()    // day of week
+	);
 
 	scheduler.addJob(schedule, SchedulerJobMode::Inline, &everyHour, nullptr);
 }

examples/inline_every_hour_selected_days/inline_every_hour_selected_days.ino

@@ -17,11 +17,11 @@ void setup() {
 
 	int selectedDays[] = {2, 4, 6}; // Tue, Thu, Sat
 	Schedule schedule = Schedule::custom(
-		ScheduleField::only(0),				 // minute
-		ScheduleField::any(),				 // hour
-		ScheduleField::any(),				 // day of month
-		ScheduleField::any(),				 // month
-		ScheduleField::list(selectedDays, 3) // day of week
+	    ScheduleField::only(0),              // minute
+	    ScheduleField::any(),                // hour
+	    ScheduleField::any(),                // day of month
+	    ScheduleField::any(),                // month
+	    ScheduleField::list(selectedDays, 3) // day of week
 	);
 
 	scheduler.addJob(schedule, SchedulerJobMode::Inline, &hourOnSelectedDays, nullptr);

examples/inline_every_minute/inline_every_minute.ino

@@ -16,12 +16,12 @@ void setup() {
 	Serial.println("ESPScheduler inline every-minute example");
 
 	Schedule schedule = Schedule::custom(
-		ScheduleField::every(1),  // minute
-		ScheduleField::any(),	    // hour
-		ScheduleField::any(),	    // day of month
-		ScheduleField::any(),	    // month
-		ScheduleField::any()      // day of week
-  );
+	    ScheduleField::every(1), // minute
+	    ScheduleField::any(),    // hour
+	    ScheduleField::any(),    // day of month
+	    ScheduleField::any(),    // month
+	    ScheduleField::any()     // day of week
+	);
 
 	scheduler.addJob(schedule, SchedulerJobMode::Inline, &everyMinute, nullptr);
 }

examples/inline_every_minute_selected_days/inline_every_minute_selected_days.ino

@@ -17,11 +17,11 @@ void setup() {
 
 	int selectedDays[] = {1, 3, 5}; // 0=Sun, 1=Mon, ... 6=Sat
 	Schedule schedule = Schedule::custom(
-		ScheduleField::every(1),			        // minute
-		ScheduleField::any(),				          // hour
-		ScheduleField::any(),				          // day of month
-		ScheduleField::any(),				          // month
-		ScheduleField::list(selectedDays, 3)  // day of week
+	    ScheduleField::every(1),             // minute
+	    ScheduleField::any(),                // hour
+	    ScheduleField::any(),                // day of month
+	    ScheduleField::any(),                // month
+	    ScheduleField::list(selectedDays, 3) // day of week
 	);
 
 	scheduler.addJob(schedule, SchedulerJobMode::Inline, &minuteOnSelectedDays, nullptr);

examples/inline_pause_resume/inline_pause_resume.ino

@@ -19,12 +19,12 @@ void setup() {
 
 	// Every minute (all hours/days) using custom cron fields
 	Schedule everyMinute = Schedule::custom(
-		ScheduleField::every(1),  // minute
-		ScheduleField::any(),	    // hour
-		ScheduleField::any(),	    // day of month
-		ScheduleField::any(),	    // month
-		ScheduleField::any()      // day of week
-  );
+	    ScheduleField::every(1), // minute
+	    ScheduleField::any(),    // hour
+	    ScheduleField::any(),    // day of month
+	    ScheduleField::any(),    // month
+	    ScheduleField::any()     // day of week
+	);
 
 	jobId = scheduler.addJob(everyMinute, SchedulerJobMode::Inline, &recurringInline, nullptr);
 }

examples/worker_weekly/worker_weekly.ino

@@ -26,12 +26,12 @@ void setup() {
 	cfg.usePsramStack = true;
 
 	scheduler.addJob(
-		Schedule::weeklyAtLocal(weekdaysMask, 18, 30),
-		SchedulerJobMode::WorkerTask,
-		&weeklyReport,
-		nullptr,
-		&cfg
-  );
+	    Schedule::weeklyAtLocal(weekdaysMask, 18, 30),
+	    SchedulerJobMode::WorkerTask,
+	    &weeklyReport,
+	    nullptr,
+	    &cfg
+	);
 }
 
 void loop() {

scripts/format_cpp.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+_repo_root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+_clang_format="${_repo_root}/.vscode/bin/clang-format"
+
+if [ ! -x "${_clang_format}" ]; then
+    echo "clang-format wrapper not found: ${_clang_format}" >&2
+    exit 1
+fi
+
+mapfile -d '' _format_files < <(
+    git -C "${_repo_root}" ls-files -z -- '*.c' '*.cc' '*.cpp' '*.h' '*.hpp' '*.ino'
+)
+
+if [ "${#_format_files[@]}" -eq 0 ]; then
+    echo "No tracked C/C++/INO files found to format."
+    exit 0
+fi
+
+"${_clang_format}" -i --style=file "${_format_files[@]}"
+
+echo "Formatted ${#_format_files[@]} files."