add build_docker.sh. support pico-sdk 2.3.0

Author: elehobica

.github/actions/build-and-rename/action.yml

@@ -28,7 +28,7 @@ runs:
   using: 'composite'
   steps:
     - name: Build
-      uses: elehobica/build-pico@v1
+      uses: elehobica/build-pico@2.3.0
       with:
         path: ${{ inputs.path }}
         build: ${{ inputs.build }}

.gitignore

@@ -1 +1,3 @@
-build/
+build/
+CLAUDE.md
+.claude/

CHANGELOG.md

@@ -5,6 +5,10 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased]
+### Added
+* Add build_docker.sh
+### Changed
+* Support pico-sdk 2.3.0
 
 ## [1.0.2] - 2025-04-28
 ### Added

README.md

@@ -38,18 +38,19 @@ The frontend analog circuit should be needed.
 [pico_level_meter.pdf](doc/pico_level_meter.pdf)
 
 ## How to build
+* This project targets rp2350 (Raspberry Pi Pico 2) only
 * See ["Getting started with Raspberry Pi Pico"](https://datasheets.raspberrypi.org/pico/getting-started-with-pico.pdf)
 * Put "pico-sdk", "pico-examples" and "pico-extras" on the same level with this project folder.
 * Set environmental variables for PICO_SDK_PATH, PICO_EXTRAS_PATH and PICO_EXAMPLES_PATH
-* Confirmed with Pico SDK 2.1.1
+* Confirmed with Pico SDK 2.3.0
 ```
-> git clone -b 2.1.1 https://github.com/raspberrypi/pico-sdk.git
+> git clone -b 2.3.0 https://github.com/raspberrypi/pico-sdk.git
 > cd pico-sdk
 > git submodule update -i
 > cd ..
-> git clone -b sdk-2.1.1 https://github.com/raspberrypi/pico-examples.git
+> git clone -b sdk-2.3.0 https://github.com/raspberrypi/pico-examples.git
 >
-> git clone -b sdk-2.1.1 https://github.com/raspberrypi/pico-extras.git
+> git clone -b sdk-2.3.0 https://github.com/raspberrypi/pico-extras.git
 > 
 > git clone -b main https://github.com/elehobica/pico_level_meter.git
 > cd pico_level_meter
@@ -61,51 +62,38 @@ The frontend analog circuit should be needed.
 * Confirmed with cmake-3.27.2-windows-x86_64 and gcc-arm-none-eabi-10.3-2021.10-win32
 * Lanuch "Developer Command Prompt for VS 2022"
 ```
+> git clone -b main https://github.com/elehobica/pico_level_meter.git
 > cd pico_level_meter
 > mkdir build && cd build
+> git submodule update -i
 > cmake -G "NMake Makefiles" ..
 > nmake
 ```
-* Put "pico_level_meter.uf2" on RPI-RP2 drive
+* Put "pico_level_meter.uf2" on RP2350 drive
 ### Linux
-* Build is confirmed with [pico-sdk-dev-docker:sdk-2.1.1-1.0.0]( https://hub.docker.com/r/elehobica/pico-sdk-dev-docker)
+* Build is confirmed with [pico-sdk-dev-docker:sdk-2.3.0](https://hub.docker.com/r/elehobica/pico-sdk-dev-docker)
 * Confirmed with cmake-3.22.1 and arm-none-eabi-gcc (15:10.3-2021.07-4) 10.3.1
 ```
+$ git clone -b main https://github.com/elehobica/pico_level_meter.git
 $ cd pico_level_meter
+$ git submodule update -i
 $ mkdir build && cd build
 $ cmake ..
 $ make -j4
 ```
-* Download "pico_level_meter.uf2" on RPI-RP2 drive
-
-
-
-* See ["Getting started with Raspberry Pi Pico"](https://datasheets.raspberrypi.org/pico/getting-started-with-pico.pdf)
-* Put "pico-sdk", "pico-examples" and "pico-extras" on the same level with this project folder.
-* Set environmental variables for PICO_SDK_PATH, PICO_EXTRAS_PATH and PICO_EXAMPLES_PATH
-* Build is confirmed in Developer Command Prompt for VS 2022 and Visual Studio Code on Windows enviroment
-* Confirmed with Pico SDK 1.5.1, cmake-3.27.2-windows-x86_64 and gcc-arm-none-eabi-10.3-2021.10-win32
+* Download "pico_level_meter.uf2" on RP2350 drive
+### Local build with Docker (build_docker.sh)
+* `build_docker.sh` builds this project inside the same SDK image as CI ([pico-sdk-dev-docker:sdk-2.3.0](https://hub.docker.com/r/elehobica/pico-sdk-dev-docker)), so no local Pico SDK installation is required
+* Requirements: Docker, and submodules initialized (`git submodule update -i`)
+* No need to set PICO_SDK_PATH / PICO_EXTRAS_PATH / PICO_EXAMPLES_PATH (provided by the image)
 ```
-> git clone -b master https://github.com/raspberrypi/pico-sdk.git
-> cd pico-sdk
-> git submodule update -i
-> cd ..
-> git clone -b master https://github.com/raspberrypi/pico-examples.git
-> 
-> git clone -b main https://github.com/elehobica/pico_level_meter.git
-> cd pico_level_meter
-> git submodule update -i
-> cd ..
-```
-* Lanuch "Developer Command Prompt for VS 2022"
-```
-> cd pico_level_meter
-> mkdir build
-> cd build
-> cmake -G "NMake Makefiles" ..
-> nmake
+$ git clone -b main https://github.com/elehobica/pico_level_meter.git
+$ cd pico_level_meter
+$ git submodule update -i
+$ ./build_docker.sh          # build for Raspberry Pi Pico 2 (rp2350)  -> build/
+$ ./build_docker.sh -k       # incremental build (keep build directory contents)
 ```
-* Put "pico_level_meter.uf2" on RPI-RP2 drive
+* Download "pico_level_meter.uf2" from `build/` on RP2350 drive
 
 ### Serial interface usage
 * type ' ' to display current settings

build_docker.sh

@@ -0,0 +1,100 @@
+#!/bin/bash
+#------------------------------------------------------
+# Copyright (c) 2026, Elehobica
+# Released under the BSD-2-Clause
+# refer to https://opensource.org/licenses/BSD-2-Clause
+#------------------------------------------------------
+#
+# Local Docker build script that mirrors .github/workflows/build-binaries.yml.
+# Uses the same SDK image as CI (elehobica/pico-sdk-dev-docker:sdk-2.3.0)
+# and runs cmake/make inside the container.
+#
+# This project targets rp2350 (Raspberry Pi Pico 2) only; the platform/board
+# are fixed in CMakeLists.txt, so no target selection is needed.
+#
+# Run it from anywhere; it builds this repository (the folder containing this
+# script), e.g.:
+#   ./build_docker.sh          # rp2350 build -> build/
+#   ./build_docker.sh -k       # incremental build (keep build/)
+
+set -e
+
+IMAGE="elehobica/pico-sdk-dev-docker:sdk-2.3.0"
+SDK_PATH_IN_IMAGE="/home/rp2dev/pico/pico-sdk"   # PICO_SDK_PATH inside the container
+PROJECT_ROOT="$(cd "$(dirname "$0")" && pwd)"    # repository root (has CMakeLists.txt)
+PROJECT_NAME="$(basename "$PROJECT_ROOT")"
+
+# Read the Pico SDK version from pico_sdk_version.cmake inside the container.
+sdk_version() {
+  docker run --rm "$IMAGE" bash -c '
+    f="'"$SDK_PATH_IN_IMAGE"'/pico_sdk_version.cmake"
+    maj=$(sed -n "s/^[[:space:]]*set(PICO_SDK_VERSION_MAJOR \([0-9]*\)).*/\1/p" "$f")
+    min=$(sed -n "s/^[[:space:]]*set(PICO_SDK_VERSION_MINOR \([0-9]*\)).*/\1/p" "$f")
+    rev=$(sed -n "s/^[[:space:]]*set(PICO_SDK_VERSION_REVISION \([0-9]*\)).*/\1/p" "$f")
+    if [[ -n "$maj$min$rev" ]]; then echo "${maj}.${min}.${rev}"; else echo "unknown"; fi
+  '
+}
+
+usage() {
+  cat <<EOF
+Usage: ./$(basename "$0") [options]
+
+Builds this repository ($PROJECT_NAME) for rp2350 (Raspberry Pi Pico 2)
+inside the SDK Docker container. Output: build/
+
+Options:
+  -h, --help     Show this help
+  -k, --keep     Keep build directory contents (incremental build)
+EOF
+}
+
+KEEP=0
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -h|--help)      usage; exit 0 ;;
+    -k|--keep)      KEEP=1 ;;
+    *) echo "Unknown option: $1" >&2; usage; exit 1 ;;
+  esac
+  shift
+done
+
+if [[ ! -f "$PROJECT_ROOT/CMakeLists.txt" ]]; then
+  echo "error: CMakeLists.txt not found at $PROJECT_ROOT" >&2
+  exit 1
+fi
+
+echo "Project: $PROJECT_NAME"
+echo "Pico SDK version: $(sdk_version) (from $SDK_PATH_IN_IMAGE)"
+
+# Run cmake/make inside the SDK container.
+# Args: $1=build_dir  $2=extra cmake options (may be empty)
+run_build() {
+  local build_dir="$1"
+  local cmake_extra="$2"
+
+  if [[ "$KEEP" -eq 0 ]]; then
+    rm -rf "$PROJECT_ROOT/$build_dir"
+  fi
+  mkdir -p "$PROJECT_ROOT/$build_dir"
+
+  docker run --rm \
+    --user "$(id -u):$(id -g)" \
+    -e HOME=/tmp \
+    -e PICO_SDK_PATH="$SDK_PATH_IN_IMAGE" \
+    -e PICO_EXTRAS_PATH=/home/rp2dev/pico/pico-extras \
+    -e PICO_EXAMPLES_PATH=/home/rp2dev/pico/pico-examples \
+    -v "$PROJECT_ROOT":/workspace \
+    -w "/workspace/$build_dir" \
+    "$IMAGE" \
+    bash -c "cmake $cmake_extra /workspace && make -j\$(nproc)"
+}
+
+echo "===== Build Pico 2 (rp2350) ====="
+run_build build ""
+
+echo ""
+echo "===== Output ====="
+for uf2 in "$PROJECT_ROOT/build"/*.uf2; do
+  [[ -f "$uf2" ]] && echo "  build/$(basename "$uf2")"
+done