compatibilité vscode

setup-vscode-macos.sh

@@ -0,0 +1,572 @@
+#!/bin/bash
+# ==============================================================================
+# setup-vscode-macos.sh
+#
+# Rend un projet STM32CubeIDE (genere par STM32CubeMX, toolchain GCC/Makefile)
+# compilable, flashable et debogable depuis VS Code sur macOS.
+#
+# Reutilisable tel quel sur un autre projet STM32CubeIDE : copiez ce script a
+# la racine du projet (a cote du dossier "gcc/") et lancez-le.
+#
+# Ce qu'il fait :
+#   1. Verifie/installe la toolchain (arm-none-eabi-gcc, GNU make 4.x)
+#   2. Localise STM32CubeIDE et ses outils embarques (ST-LINK_gdbserver,
+#      STM32CubeProgrammer)
+#   3. Corrige les incompatibilites macOS connues dans les Makefiles/scripts
+#      de lien generes par CubeMX (mot-cle READONLY, rmdir BSD, --specs)
+#   4. Si le projet utilise TouchGFX : cree des wrappers Wine (via TouchGFX.app,
+#      qui embarque Wine) pour les outils imageconvert/fontconvert, qui n'ont
+#      pas de version macOS
+#   5. Signe arm-none-eabi-gdb avec les entitlements necessaires au debogage
+#      sur macOS (cree un certificat de signature de code auto-signe si besoin)
+#   6. Genere .vscode/tasks.json, c_cpp_properties.json et launch.json
+#   7. Lance une compilation de test pour valider
+#
+# Ce que ce script NE PEUT PAS deviner de maniere fiable (a vos yeux de
+# verifier si la compilation de test echoue) :
+#   - Des fichiers sources ajoutes au projet APRES la derniere generation du
+#     Makefile par CubeMX (ex: un driver BSP ajoute a la main) : le Makefile
+#     genere peut alors ne pas les lister, meme s'ils apparaissent bien dans
+#     le .cproject de STM32CubeIDE. Si la compilation de test echoue avec des
+#     "undefined reference" ou "No such file or directory", il faudra ajouter
+#     ces fichiers/chemins a la main dans gcc/makefile_<projet> (variables
+#     board_c_files += ... et board_include_paths += ...).
+#   - Le point d'acces SWD (access port) et la strategie de reset a utiliser
+#     pour le debogage : ce script utilise des valeurs par defaut modifiables
+#     en tete de script (DEBUG_ACCESS_PORT, DEBUG_RESET_STRATEGY). Pour un
+#     projet different, verifiez ces valeurs dans un fichier .launch existant
+#     de STM32CubeIDE (dossier STM32CubeIDE/**/*.launch), champs
+#     "com.st.stm32cube.ide.mcu.debug.launch.access_port_id" et
+#     "com.st.stm32cube.ide.mcu.debug.stlink.reset_strategy".
+#
+# ==============================================================================
+
+set -uo pipefail
+
+# ------------------------------------------------------------------------------
+# Parametres modifiables
+# ------------------------------------------------------------------------------
+DEBUG_GDB_PORT="61234"
+DEBUG_ACCESS_PORT="0"          # "-m <n>" pour ST-LINK_gdbserver. Mettre 1 si le
+                                # projet a une architecture boot+appli en memoire
+                                # externe (verifier le .launch existant, voir ci-dessus)
+DEBUG_CONNECT_UNDER_RESET="1"  # 1 = ajoute "-k" (connexion sous reset)
+GDB_SIGN_IDENTITY="gdb-cert"
+
+# ------------------------------------------------------------------------------
+# Utilitaires
+# ------------------------------------------------------------------------------
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$SCRIPT_DIR"
+STEP=0
+
+log()  { STEP=$((STEP+1)); echo ""; echo "[$STEP] $*"; }
+info() { echo "    $*"; }
+warn() { echo "    ATTENTION: $*" >&2; }
+die()  { echo "ERREUR: $*" >&2; exit 1; }
+
+# ==============================================================================
+log "Verification de la toolchain ARM"
+# ==============================================================================
+if ! command -v arm-none-eabi-gcc >/dev/null 2>&1; then
+    info "arm-none-eabi-gcc introuvable, installation via Homebrew..."
+    command -v brew >/dev/null 2>&1 || die "Homebrew n'est pas installe (https://brew.sh). Installez-le puis relancez ce script."
+    brew install --cask gcc-arm-embedded 2>/dev/null || brew install arm-none-eabi-gcc || die "Echec de l'installation d'arm-none-eabi-gcc"
+fi
+ARM_GCC_PATH="$(command -v arm-none-eabi-gcc)"
+info "arm-none-eabi-gcc : $ARM_GCC_PATH ($(arm-none-eabi-gcc --version | head -1))"
+
+ARM_GDB_PATH="$(command -v arm-none-eabi-gdb || true)"
+[ -z "$ARM_GDB_PATH" ] && die "arm-none-eabi-gdb introuvable (devrait etre installe avec arm-none-eabi-gcc)"
+info "arm-none-eabi-gdb : $ARM_GDB_PATH"
+
+# ==============================================================================
+log "Verification de GNU Make 4.x (celui d'Apple, 3.81, est trop ancien)"
+# ==============================================================================
+GNU_MAKE=""
+if make --version 2>/dev/null | head -1 | grep -qE "GNU Make (4|5|6|7|8|9)"; then
+    GNU_MAKE="$(command -v make)"
+else
+    for candidate in /usr/local/opt/make/libexec/gnubin/make /opt/homebrew/opt/make/libexec/gnubin/make; do
+        [ -x "$candidate" ] && GNU_MAKE="$candidate" && break
+    done
+    if [ -z "$GNU_MAKE" ]; then
+        info "GNU Make recent introuvable, installation via Homebrew (sera nomme 'gmake')..."
+        command -v brew >/dev/null 2>&1 || die "Homebrew n'est pas installe (https://brew.sh)."
+        brew install make || die "Echec de l'installation de make"
+        for candidate in /usr/local/opt/make/libexec/gnubin/make /opt/homebrew/opt/make/libexec/gnubin/make; do
+            [ -x "$candidate" ] && GNU_MAKE="$candidate" && break
+        done
+    fi
+fi
+[ -z "$GNU_MAKE" ] && die "Impossible de localiser un GNU Make >= 4.0 apres installation"
+info "GNU Make utilise : $GNU_MAKE ($("$GNU_MAKE" --version | head -1))"
+
+# ==============================================================================
+log "Localisation du dossier de build GCC du projet"
+# ==============================================================================
+GCC_DIR=""
+for d in "$PROJECT_ROOT/gcc" "$PROJECT_ROOT/GCC" "$PROJECT_ROOT/Gcc"; do
+    [ -d "$d" ] && GCC_DIR="$d" && break
+done
+[ -z "$GCC_DIR" ] && die "Dossier 'gcc/' introuvable a la racine du projet ($PROJECT_ROOT). Ce script attend un projet CubeMX genere avec la toolchain 'STM32CubeIDE / Makefile'."
+info "Dossier de build : $GCC_DIR"
+
+mapfile -t SUBMAKEFILES < <(find "$GCC_DIR" -maxdepth 1 -type f \( -iname "makefile_*" \) | sort)
+TOP_MAKEFILE="$GCC_DIR/Makefile"
+[ -f "$TOP_MAKEFILE" ] || die "Makefile principal introuvable dans $GCC_DIR"
+if [ "${#SUBMAKEFILES[@]}" -eq 0 ]; then
+    SUBMAKEFILES=("$TOP_MAKEFILE")
+fi
+info "Makefile(s) detecte(s) : ${SUBMAKEFILES[*]}"
+
+# ==============================================================================
+log "Localisation de STM32CubeIDE et de ses outils embarques"
+# ==============================================================================
+CUBEIDE_APP=""
+for d in "/Applications/STMicroelectronics/STM32CubeIDE.app" "/Applications/STM32CubeIDE.app"; do
+    [ -d "$d" ] && CUBEIDE_APP="$d" && break
+done
+[ -z "$CUBEIDE_APP" ] && CUBEIDE_APP="$(mdfind "kMDItemFSName == 'STM32CubeIDE.app'" 2>/dev/null | head -1)"
+[ -z "$CUBEIDE_APP" ] && die "STM32CubeIDE.app introuvable dans /Applications. Installez-le depuis st.com (necessaire pour le flash/debug via ST-Link)."
+info "STM32CubeIDE : $CUBEIDE_APP"
+
+GDBSERVER_BIN="$(find "$CUBEIDE_APP/Contents/Eclipse/plugins" -maxdepth 1 -iname "*stlink-gdb-server*" -type d 2>/dev/null | sort -V | tail -1)/tools/bin/ST-LINK_gdbserver"
+CUBEPROG_BIN_DIR="$(find "$CUBEIDE_APP/Contents/Eclipse/plugins" -maxdepth 1 -iname "*cubeprogrammer*" -type d 2>/dev/null | sort -V | tail -1)/tools/bin"
+CUBEPROG_CLI="$CUBEPROG_BIN_DIR/STM32_Programmer_CLI"
+
+[ -x "$GDBSERVER_BIN" ] || die "ST-LINK_gdbserver introuvable sous $CUBEIDE_APP"
+[ -x "$CUBEPROG_CLI" ] || die "STM32_Programmer_CLI introuvable sous $CUBEIDE_APP"
+info "ST-LINK_gdbserver   : $GDBSERVER_BIN"
+info "STM32_Programmer_CLI: $CUBEPROG_CLI"
+
+# ==============================================================================
+log "Recherche d'un chargeur de memoire externe (.stldr), si applicable"
+# ==============================================================================
+EXT_LOADER="$(find "$PROJECT_ROOT" -iname "*.stldr" -maxdepth 3 2>/dev/null | head -1)"
+if [ -n "$EXT_LOADER" ]; then
+    info "External loader trouve : $EXT_LOADER"
+    EXT_LOADER_ARGS_PROG=(-el "$EXT_LOADER")
+    EXT_LOADER_ARGS_GDB="-el \${workspaceFolder}/$(python3 -c "import os,sys; print(os.path.relpath(sys.argv[1], sys.argv[2]))" "$EXT_LOADER" "$PROJECT_ROOT" 2>/dev/null || echo "$EXT_LOADER")"
+else
+    info "Aucun external loader trouve (normal si le projet n'utilise pas de memoire externe XSPI/QSPI)."
+    EXT_LOADER_ARGS_PROG=()
+    EXT_LOADER_ARGS_GDB=""
+fi
+
+# ==============================================================================
+log "Correction des incompatibilites macOS dans les scripts de lien (.ld)"
+# ==============================================================================
+LD_FILES=$(find "$PROJECT_ROOT" -iname "*.ld" -not -path "*/STM32CubeIDE/*" 2>/dev/null)
+FIXED_LD=0
+for ld in $LD_FILES; do
+    if grep -q "(READONLY)" "$ld" 2>/dev/null; then
+        sed -i '' 's/ (READONLY)//' "$ld"
+        info "Corrige (mot-cle READONLY, GCC11+ uniquement) : $ld"
+        FIXED_LD=$((FIXED_LD+1))
+    fi
+done
+[ "$FIXED_LD" -eq 0 ] && info "Rien a corriger."
+
+# ==============================================================================
+log "Correction des incompatibilites macOS dans les Makefiles"
+# ==============================================================================
+for mk in "${SUBMAKEFILES[@]}" "$TOP_MAKEFILE"; do
+    [ -f "$mk" ] || continue
+
+    # rmdir --ignore-fail-on-non-empty n'existe pas sur macOS (BSD rmdir)
+    if grep -q -- "--ignore-fail-on-non-empty" "$mk" 2>/dev/null; then
+        sed -i '' -E 's/rmdir --ignore-fail-on-non-empty ([^ ]+)/rmdir \1 2>\/dev\/null || true/' "$mk"
+        info "Corrige (rmdir portable) : $mk"
+    fi
+
+    # --specs=nosys.specs sans --specs=nano.specs cause des symboles
+    # __sf_fake_stdin/stdout/stderr non resolus avec FreeRTOS
+    if grep -q -- "--specs=nosys.specs" "$mk" 2>/dev/null && ! grep -q -- "--specs=nano.specs" "$mk" 2>/dev/null; then
+        sed -i '' 's/--specs=nosys.specs/--specs=nosys.specs \\\n\t--specs=nano.specs/' "$mk"
+        info "Ajoute --specs=nano.specs au linker : $mk"
+    fi
+
+    # Ajout d'une branche Darwin pour imageconvert/fontconvert si TouchGFX est utilise
+    if grep -q "imageconvert_executable" "$mk" 2>/dev/null && ! grep -q "UNAME), Darwin" "$mk" 2>/dev/null; then
+        TOUCHGFX_WIN_IMG=$(grep -oE '[A-Za-z0-9_/.-]+/win/imageconvert\.out' "$mk" | head -1)
+        TOUCHGFX_WIN_FONT=$(grep -oE '[A-Za-z0-9_/.-]+/win/fontconvert\.out' "$mk" | head -1)
+        if [ -n "$TOUCHGFX_WIN_IMG" ]; then
+            info "TouchGFX detecte dans $mk - mise en place des wrappers Wine macOS"
+
+            TOUCHGFX_APP=""
+            for d in "/Applications/STMicroelectronics/TouchGFX.app" "/Applications/TouchGFX.app"; do
+                [ -d "$d" ] && TOUCHGFX_APP="$d" && break
+            done
+            [ -z "$TOUCHGFX_APP" ] && TOUCHGFX_APP="$(mdfind "kMDItemFSName == 'TouchGFX.app'" 2>/dev/null | head -1)"
+
+            if [ -z "$TOUCHGFX_APP" ] || [ ! -x "$TOUCHGFX_APP/Contents/SharedSupport/wine/bin/wine64" ]; then
+                warn "TouchGFX.app (Designer) introuvable ou non-Wineskin sous /Applications - impossible de generer les wrappers automatiquement."
+                warn "Installez TouchGFX Designer pour macOS depuis st.com, puis relancez ce script."
+            else
+                WRAP_DIR="$GCC_DIR/macos_wine_wrappers"
+                mkdir -p "$WRAP_DIR"
+                WINE64="$TOUCHGFX_APP/Contents/SharedSupport/wine/bin/wine64"
+                WINE_LIBS="$TOUCHGFX_APP/Contents/Frameworks:$TOUCHGFX_APP/Contents/SharedSupport/wine/lib"
+
+                for pair in "imageconvert:$TOUCHGFX_WIN_IMG" "fontconvert:$TOUCHGFX_WIN_FONT"; do
+                    name="${pair%%:*}"; relpath="${pair#*:}"
+                    [ -z "$relpath" ] && continue
+                    cat > "$WRAP_DIR/$name.sh" << EOF
+#!/bin/sh
+# Lance $name.out (Windows) via le Wine embarque dans TouchGFX.app
+export DYLD_FALLBACK_LIBRARY_PATH="$WINE_LIBS"
+exec "$WINE64" "$PROJECT_ROOT/$relpath" "\$@" 2>/dev/null
+EOF
+                    chmod +x "$WRAP_DIR/$name.sh"
+                    info "Wrapper cree : $WRAP_DIR/$name.sh"
+                done
+
+                # Insere une branche Darwin juste avant le "else" qui gere Windows/Linux
+                MK_REL_GCC=$(basename "$mk")
+                awk -v wrapdir="$(python3 -c "import os,sys; print(os.path.relpath(sys.argv[1], sys.argv[2]))" "$WRAP_DIR" "$PROJECT_ROOT" 2>/dev/null || echo "gcc/macos_wine_wrappers")" '
+                    /ifeq \(\$\(UNAME\), Linux\)/ { print; infile=1; next }
+                    infile && /^else$/ && !inserted {
+                        print "else ifeq ($(UNAME), Darwin)"
+                        print "imageconvert_executable := " wrapdir "/imageconvert.sh"
+                        print "fontconvert_executable := " wrapdir "/fontconvert.sh"
+                        inserted=1
+                    }
+                    { print }
+                ' "$mk" > "$mk.tmp" && mv "$mk.tmp" "$mk"
+                info "Branche Darwin ajoutee dans $mk"
+            fi
+        fi
+    fi
+done
+
+# ==============================================================================
+log "Compilation de test"
+# ==============================================================================
+( cd "$GCC_DIR" && "$GNU_MAKE" -j"$(sysctl -n hw.ncpu)" )
+BUILD_STATUS=$?
+if [ "$BUILD_STATUS" -ne 0 ]; then
+    warn "La compilation a echoue. Causes frequentes :"
+    warn "  - fichiers sources ajoutes au projet apres la derniere generation du"
+    warn "    Makefile (comparez avec STM32CubeIDE/*/. cproject) -> a ajouter a la main"
+    warn "    dans gcc/makefile_<projet> (board_c_files += / board_include_paths +=)"
+    warn "Les fichiers .vscode/ seront quand meme generes ; relancez juste le build"
+    warn "depuis VS Code une fois les corrections faites."
+else
+    info "Compilation reussie."
+fi
+
+# ==============================================================================
+log "Signature de code pour arm-none-eabi-gdb (necessaire pour deboguer sur macOS)"
+# ==============================================================================
+if codesign -dv "$ARM_GDB_PATH" 2>&1 | grep -q "com.apple.security.cs.debugger" 2>/dev/null; then
+    info "Deja signe correctement."
+elif security find-identity -v -p codesigning 2>/dev/null | grep -q "$GDB_SIGN_IDENTITY"; then
+    info "Certificat '$GDB_SIGN_IDENTITY' deja present, signature de gdb..."
+    cat > /tmp/gdb-entitlement.xml << 'EOF'
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>com.apple.security.cs.debugger</key>
+    <true/>
+    <key>com.apple.security.get-task-allow</key>
+    <true/>
+</dict>
+</plist>
+EOF
+    codesign --entitlements /tmp/gdb-entitlement.xml -fs "$GDB_SIGN_IDENTITY" "$ARM_GDB_PATH"
+else
+    info "Creation d'un certificat de signature de code auto-signe '$GDB_SIGN_IDENTITY'..."
+    info "(macOS va probablement demander votre mot de passe pour lui faire confiance)"
+    KEYCHAIN="$HOME/Library/Keychains/login.keychain-db"
+    openssl req -new -newkey rsa:2048 -x509 -days 3650 -nodes \
+        -keyout /tmp/gdb-cert.key -out /tmp/gdb-cert.crt \
+        -subj "/CN=$GDB_SIGN_IDENTITY" \
+        -addext "basicConstraints=critical,CA:true" \
+        -addext "keyUsage=critical,digitalSignature,keyCertSign" \
+        -addext "extendedKeyUsage=critical,codeSigning" >/dev/null 2>&1
+    openssl pkcs12 -export -out /tmp/gdb-cert.p12 -inkey /tmp/gdb-cert.key -in /tmp/gdb-cert.crt \
+        -passout pass:temp -legacy >/dev/null 2>&1
+    security import /tmp/gdb-cert.p12 -k "$KEYCHAIN" -P temp -T /usr/bin/codesign -T /usr/bin/security
+    security add-trusted-cert -p codeSign -k "$KEYCHAIN" /tmp/gdb-cert.crt
+    rm -f /tmp/gdb-cert.key /tmp/gdb-cert.crt /tmp/gdb-cert.p12
+
+    cat > /tmp/gdb-entitlement.xml << 'EOF'
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>com.apple.security.cs.debugger</key>
+    <true/>
+    <key>com.apple.security.get-task-allow</key>
+    <true/>
+</dict>
+</plist>
+EOF
+    codesign --entitlements /tmp/gdb-entitlement.xml -fs "$GDB_SIGN_IDENTITY" "$ARM_GDB_PATH" \
+        || warn "La signature a echoue - relancez ce script apres avoir accepte la demande de confiance macOS."
+fi
+
+# ==============================================================================
+log "Extraction des chemins d'include / defines (pour l'auto-completion VS Code)"
+# ==============================================================================
+MAIN_APP_MAKEFILE="${SUBMAKEFILES[-1]}"
+INCLUDE_PATHS_RAW=$("$GNU_MAKE" -f "$MAIN_APP_MAKEFILE" -C "$GCC_DIR" -p 2>/dev/null | grep -m1 "^include_paths " | sed 's/^include_paths[[:space:]]*:=[[:space:]]*//')
+DEFINES_RAW=$("$GNU_MAKE" -f "$MAIN_APP_MAKEFILE" -C "$GCC_DIR" -p 2>/dev/null | grep -m1 "^c_compiler_options " | grep -oE '\-D[A-Za-z0-9_]+' | sed 's/^-D//')
+
+INCLUDE_JSON=""
+for p in $INCLUDE_PATHS_RAW; do
+    INCLUDE_JSON="$INCLUDE_JSON        \"\${workspaceFolder}/$p\",\n"
+done
+DEFINES_JSON=""
+for d in $DEFINES_RAW; do
+    DEFINES_JSON="$DEFINES_JSON        \"$d\",\n"
+done
+info "$(echo -e "$INCLUDE_JSON" | grep -c workspaceFolder) chemins d'include et $(echo -e "$DEFINES_JSON" | grep -c '\".*\"') defines extraits."
+
+# ==============================================================================
+log "Detection de la structure du projet (mono-projet ou Boot+Appli)"
+# ==============================================================================
+BOOT_ELF=""
+APPLI_ELF=""
+if [ -d "$PROJECT_ROOT/Boot" ] && [ -d "$PROJECT_ROOT/Appli" ]; then
+    info "Structure Boot + Appli detectee (architecture avec bootloader externe)."
+    BOOT_ELF=$(find "$PROJECT_ROOT/Boot" -iname "target.elf" 2>/dev/null | head -1)
+    APPLI_ELF=$(find "$PROJECT_ROOT/Appli" -iname "target.elf" 2>/dev/null | head -1)
+else
+    info "Structure mono-projet detectee."
+    APPLI_ELF=$(find "$PROJECT_ROOT" -iname "target.elf" -not -path "*/STM32CubeIDE/*" 2>/dev/null | head -1)
+fi
+[ -z "$BOOT_ELF" ] && [ -d "$PROJECT_ROOT/Boot" ] && BOOT_ELF="Boot/TouchGFX/build/bin/target.elf"
+[ -z "$APPLI_ELF" ] && APPLI_ELF="$(find "$GCC_DIR/.." -iname "target.elf" -not -path "*/STM32CubeIDE/*" 2>/dev/null | head -1)"
+BOOT_ELF_REL=${BOOT_ELF#"$PROJECT_ROOT/"}
+APPLI_ELF_REL=${APPLI_ELF#"$PROJECT_ROOT/"}
+
+# ==============================================================================
+log "Generation des fichiers .vscode/"
+# ==============================================================================
+mkdir -p "$PROJECT_ROOT/.vscode"
+GCC_DIR_REL=${GCC_DIR#"$PROJECT_ROOT/"}
+
+# --- c_cpp_properties.json ---
+{
+  echo "{"
+  echo "  \"version\": 4,"
+  echo "  \"configurations\": ["
+  echo "    {"
+  echo "      \"name\": \"STM32\","
+  echo "      \"compilerPath\": \"$ARM_GCC_PATH\","
+  echo "      \"cStandard\": \"gnu11\","
+  echo "      \"cppStandard\": \"gnu++14\","
+  echo "      \"intelliSenseMode\": \"linux-gcc-arm\","
+  echo "      \"defines\": ["
+  echo -e "$DEFINES_JSON" | sed '$ s/,$//'
+  echo "      ],"
+  echo "      \"includePath\": ["
+  echo -e "$INCLUDE_JSON" | sed '$ s/,$//'
+  echo "      ]"
+  echo "    }"
+  echo "  ]"
+  echo "}"
+} > "$PROJECT_ROOT/.vscode/c_cpp_properties.json"
+info "Genere : .vscode/c_cpp_properties.json"
+
+# --- tasks.json ---
+RESET_FLAG=""
+[ "$DEBUG_CONNECT_UNDER_RESET" = "1" ] && RESET_FLAG='"-k",'
+EXT_LOADER_PROG_ARGS=""
+[ -n "$EXT_LOADER" ] && EXT_LOADER_PROG_ARGS="\"-el\", \"\${workspaceFolder}/${EXT_LOADER#"$PROJECT_ROOT/"}\","
+EXT_LOADER_GDB_ARGS=""
+[ -n "$EXT_LOADER" ] && EXT_LOADER_GDB_ARGS="-el \${workspaceFolder}/${EXT_LOADER#"$PROJECT_ROOT/"} "
+
+cat > "$PROJECT_ROOT/.vscode/tasks.json" << EOF
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Build",
+      "type": "shell",
+      "command": "$GNU_MAKE",
+      "args": ["-j8"],
+      "options": { "cwd": "\${workspaceFolder}/$GCC_DIR_REL" },
+      "group": { "kind": "build", "isDefault": true },
+      "problemMatcher": ["\$gcc"],
+      "presentation": { "reveal": "always", "panel": "shared", "clear": true }
+    },
+    {
+      "label": "Clean",
+      "type": "shell",
+      "command": "$GNU_MAKE",
+      "args": ["clean"],
+      "options": { "cwd": "\${workspaceFolder}/$GCC_DIR_REL" },
+      "group": "build",
+      "problemMatcher": []
+    },
+    {
+      "label": "Flash",
+      "type": "shell",
+      "command": "$CUBEPROG_CLI",
+      "args": [
+        "-c", "port=SWD",
+        $EXT_LOADER_PROG_ARGS
+        "-w", "\${workspaceFolder}/$APPLI_ELF_REL",
+        "-v",
+        "-rst"
+      ],
+      "group": "none",
+      "problemMatcher": []
+    },
+    {
+      "label": "Start ST-LINK GDB Server",
+      "type": "shell",
+      "command": "$GDBSERVER_BIN",
+      "args": [
+        "-p", "$DEBUG_GDB_PORT",
+        "-l", "1",
+        "-d",
+        "-cp", "$CUBEPROG_BIN_DIR",
+        $EXT_LOADER_PROG_ARGS
+        "-m", "$DEBUG_ACCESS_PORT",
+        $RESET_FLAG
+        "-e"
+      ],
+      "isBackground": true,
+      "problemMatcher": {
+        "pattern": { "regexp": "^(x)(x)\$" },
+        "background": {
+          "activeOnStart": true,
+          "beginsPattern": "^STMicroelectronics ST-LINK GDB server",
+          "endsPattern": "Waiting for debugger connection|Error in initializing ST-LINK device"
+        }
+      },
+      "presentation": { "reveal": "always", "panel": "dedicated" }
+    },
+    {
+      "label": "Stop ST-LINK GDB Server",
+      "type": "shell",
+      "command": "pkill -f ST-LINK_gdbserver || true",
+      "problemMatcher": [],
+      "presentation": { "reveal": "silent" }
+    }
+  ]
+}
+EOF
+# Nettoyage des eventuelles virgules trainantes (arguments optionnels vides)
+sed -i '' -E 's/,([[:space:]]*\])/\1/' "$PROJECT_ROOT/.vscode/tasks.json"
+info "Genere : .vscode/tasks.json"
+
+if [ -n "$BOOT_ELF_REL" ] && [ -d "$PROJECT_ROOT/Boot" ]; then
+    cat >> /dev/null << 'NOTE'
+Structure Boot+Appli : deux tasks de flash separees ajoutees ci-dessous en plus.
+NOTE
+    python3 - "$PROJECT_ROOT/.vscode/tasks.json" "$BOOT_ELF_REL" "$APPLI_ELF_REL" "$CUBEPROG_CLI" "$EXT_LOADER" <<'PYEOF'
+import json, sys
+path, boot_elf, appli_elf, cli, extloader = sys.argv[1:6]
+with open(path) as f:
+    data = json.load(f)
+extra_args = ["-c", "port=SWD"]
+if extloader:
+    extra_args += ["-el", "${workspaceFolder}/" + extloader.split("/", 1)[-1] if "/" in extloader else extloader]
+def flash_task(label, elf_rel):
+    hex_rel = elf_rel.rsplit(".elf", 1)[0] + ".hex"
+    return {
+        "label": label, "type": "shell", "command": cli,
+        "args": extra_args + ["-w", "${workspaceFolder}/" + hex_rel, "-v", "-rst"],
+        "group": "none", "problemMatcher": []
+    }
+data["tasks"] = [t for t in data["tasks"] if t["label"] != "Flash"]
+data["tasks"].insert(2, flash_task("Flash Boot", boot_elf))
+data["tasks"].insert(3, flash_task("Flash Appli", appli_elf))
+data["tasks"].append({"label": "Flash All (Boot + Appli)", "dependsOrder": "sequence", "dependsOn": ["Flash Boot", "Flash Appli"], "problemMatcher": []})
+with open(path, "w") as f:
+    json.dump(data, f, indent=2)
+PYEOF
+    info "tasks.json adapte pour la structure Boot+Appli (Flash Boot / Flash Appli separes)."
+fi
+
+# --- launch.json ---
+LAUNCH_CMDS_APPLI='"monitor halt", "load", "tbreak main"'
+LAUNCH_CMDS_SINGLE='"monitor halt", "load", "tbreak main", "monitor reset"'
+
+if [ -n "$BOOT_ELF_REL" ] && [ -d "$PROJECT_ROOT/Boot" ]; then
+cat > "$PROJECT_ROOT/.vscode/launch.json" << EOF
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Debug Boot",
+      "type": "cortex-debug",
+      "request": "launch",
+      "cwd": "\${workspaceFolder}",
+      "executable": "\${workspaceFolder}/$BOOT_ELF_REL",
+      "servertype": "external",
+      "gdbTarget": "localhost:$DEBUG_GDB_PORT",
+      "gdbPath": "$ARM_GDB_PATH",
+      "overrideLaunchCommands": [$LAUNCH_CMDS_SINGLE],
+      "preLaunchTask": "Start ST-LINK GDB Server",
+      "postDebugTask": "Stop ST-LINK GDB Server"
+    },
+    {
+      "name": "Debug Appli",
+      "type": "cortex-debug",
+      "request": "launch",
+      "cwd": "\${workspaceFolder}",
+      "executable": "\${workspaceFolder}/$APPLI_ELF_REL",
+      "servertype": "external",
+      "gdbTarget": "localhost:$DEBUG_GDB_PORT",
+      "gdbPath": "$ARM_GDB_PATH",
+      "overrideLaunchCommands": [$LAUNCH_CMDS_APPLI],
+      "preLaunchTask": "Start ST-LINK GDB Server",
+      "postDebugTask": "Stop ST-LINK GDB Server"
+    }
+  ]
+}
+EOF
+    info "NOTE : structure Boot+Appli detectee. Workflow de debogage :"
+    info "  1) Lancer 'Debug Boot', attendre le flash, arreter la session"
+    info "  2) Lancer 'Debug Appli', attendre l'arret sur main()"
+    info "  3) Appuyer sur le bouton NRST physique de la carte"
+    info "  4) Cliquer Continue"
+    info "  (verifiez ce comportement sur votre projet - certains projets mono-image n'en ont pas besoin)"
+else
+cat > "$PROJECT_ROOT/.vscode/launch.json" << EOF
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Debug",
+      "type": "cortex-debug",
+      "request": "launch",
+      "cwd": "\${workspaceFolder}",
+      "executable": "\${workspaceFolder}/$APPLI_ELF_REL",
+      "servertype": "external",
+      "gdbTarget": "localhost:$DEBUG_GDB_PORT",
+      "gdbPath": "$ARM_GDB_PATH",
+      "overrideLaunchCommands": [$LAUNCH_CMDS_SINGLE],
+      "preLaunchTask": "Start ST-LINK GDB Server",
+      "postDebugTask": "Stop ST-LINK GDB Server"
+    }
+  ]
+}
+EOF
+fi
+info "Genere : .vscode/launch.json"
+
+# ==============================================================================
+log "Termine"
+# ==============================================================================
+echo ""
+echo "Recapitulatif :"
+echo "  - Build      : Cmd+Shift+B dans VS Code, ou tache 'Build'"
+echo "  - Flash      : Terminal > Run Task > Flash (ou 'Flash Boot'/'Flash Appli')"
+echo "  - Debug      : panneau Run and Debug de VS Code"
+echo ""
+echo "Extensions VS Code requises (a installer manuellement si absentes) :"
+echo "  - C/C++ (ms-vscode.cpptools)"
+echo "  - Cortex-Debug (marus25.cortex-debug)"
+echo ""
+if [ "$BUILD_STATUS" -ne 0 ]; then
+    echo "ATTENTION : la compilation de test a echoue - voir les messages ci-dessus"
+    echo "avant de considerer la configuration comme terminee."
+fi