From 433c0a66ea306a3130c4efb0f47975bb2db0cfb0 Mon Sep 17 00:00:00 2001
From: Asklv <boironic@gmail.com>
Date: Thu, 19 Feb 2026 09:00:00 +0000
Subject: [PATCH] feat: add ESP-IDF setup and build helper scripts

Signed-off-by: Asklv <boironic@gmail.com>
---
 scripts/build_ubuntu.sh     | 21 +++++++++++++++++++
 scripts/setup_idf_ubuntu.sh | 42 +++++++++++++++++++++++++++++++++++++
 2 files changed, 63 insertions(+)
 create mode 100755 scripts/build_ubuntu.sh
 create mode 100755 scripts/setup_idf_ubuntu.sh

diff --git a/scripts/build_ubuntu.sh b/scripts/build_ubuntu.sh
new file mode 100755
index 0000000..6e38ce0
--- /dev/null
+++ b/scripts/build_ubuntu.sh
@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+IDF_VERSION="${IDF_VERSION:-v5.5.2}"
+ESP_ROOT="${ESP_ROOT:-$HOME/.espressif}"
+DEFAULT_IDF_DIR="$ESP_ROOT/esp-idf-$IDF_VERSION"
+IDF_DIR="${IDF_DIR:-${IDF_PATH:-$DEFAULT_IDF_DIR}}"
+
+if [[ ! -f "$IDF_DIR/export.sh" ]]; then
+  echo "ESP-IDF not found at: $IDF_DIR" >&2
+  echo "Run scripts/setup_idf_ubuntu.sh first, or set IDF_DIR/IDF_PATH." >&2
+  exit 1
+fi
+
+# shellcheck source=/dev/null
+. "$IDF_DIR/export.sh"
+
+cd "$PROJECT_ROOT"
+idf.py set-target esp32s3
+idf.py build
diff --git a/scripts/setup_idf_ubuntu.sh b/scripts/setup_idf_ubuntu.sh
new file mode 100755
index 0000000..8a4142a
--- /dev/null
+++ b/scripts/setup_idf_ubuntu.sh
@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ "${OSTYPE:-}" != "linux-gnu"* ]]; then
+  echo "This setup script currently supports Ubuntu/Debian only." >&2
+  exit 1
+fi
+
+IDF_VERSION="${IDF_VERSION:-v5.5.2}"
+ESP_ROOT="${ESP_ROOT:-$HOME/.espressif}"
+IDF_DIR="${IDF_DIR:-$ESP_ROOT/esp-idf-$IDF_VERSION}"
+
+if [[ -f /etc/os-release ]]; then
+  . /etc/os-release
+  if [[ "${ID:-}" != "ubuntu" && "${ID_LIKE:-}" != *"debian"* ]]; then
+    echo "Detected ${PRETTY_NAME:-unknown}. Continuing, but package installation assumes apt." >&2
+  fi
+fi
+
+sudo apt-get update
+sudo apt-get install -y \
+  git wget flex bison gperf python3 python3-pip python3-venv \
+  cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0
+
+mkdir -p "$ESP_ROOT"
+if [[ ! -d "$IDF_DIR/.git" ]]; then
+  git clone --depth 1 --branch "$IDF_VERSION" --recursive \
+    https://github.com/espressif/esp-idf.git "$IDF_DIR"
+else
+  git -C "$IDF_DIR" fetch --tags --depth 1 origin "$IDF_VERSION"
+  git -C "$IDF_DIR" checkout "$IDF_VERSION"
+  git -C "$IDF_DIR" submodule update --init --recursive
+fi
+
+"$IDF_DIR/install.sh" esp32s3
+
+echo
+echo "ESP-IDF installed. For current shell run:"
+echo "  . \"$IDF_DIR/export.sh\""
+echo "Then run from project root:"
+echo "  idf.py set-target esp32s3"
+echo "  idf.py build"