Feature: Hazard3 example SoC on Icebreaker support

.clang-tidy

@@ -1,5 +1,5 @@
 ---
-Checks: 'bugprone-*,cert-*,clang-analyzer-*,misc-*,modernize-*,portability-*,performance-*,readability-*,-readability-magic-numbers,-readability-braces-around-statements,-clang-analyzer-security.insecureAPI.DeprecatedOrUnsafeBufferHandling,-modernize-macro-to-enum,-bugprone-easily-swappable-parameters,-misc-include-cleaner,-misc-no-recursion,-misc-header-include-cycle'
+Checks: 'bugprone-*,cert-*,clang-analyzer-*,misc-*,modernize-*,portability-*,performance-*,readability-*,-readability-magic-numbers,-readability-braces-around-statements,-clang-analyzer-security.insecureAPI.DeprecatedOrUnsafeBufferHandling,-modernize-macro-to-enum,-bugprone-easily-swappable-parameters,-misc-include-cleaner,-misc-no-recursion,-misc-header-include-cycle,-clang-analyzer-core.FixedAddressDereference'
 FormatStyle: 'none'
 HeaderFilterRegex: '(src|upgrade)/.+'
 #AnalyzeTemporaryDtors: false

.codeberg/ci/build-firmware.yml

@@ -0,0 +1,55 @@
+# SPDX-License-Identifier: MIT OR Apache-2.0
+# SPDX-FileCopyrightText: 2026 1BitSquared <info@1bitsquared.com>
+# SPDX-FileContributor: Written by Rachel Mant <git@dragonmux.network>
+
+# Controls when the workflow will run
+when:
+  # Triggers the workflow on pull request events
+  - event: pull_request
+  # Triggers the workflow on push events, but only for the main branch
+  - event: push
+    branch: main
+  # Allows us to trigger the workflow manually from in Woodpecker for any branch
+  - event: manual
+
+matrix:
+  # Define a matrix of all the probe platforms to get full build coverage for all the firmware possibilities
+  BMD_PROBE:
+    - '96b_carbon'
+    - 'blackpill-f401cc'
+    - 'blackpill-f401ce'
+    - 'blackpill-f411ce'
+    - 'bluepill'
+    - 'bmp-v3'
+    - 'ctxlink'
+    - 'f072'
+    - 'f3'
+    - 'f4discovery'
+    - 'hydrabus'
+    - 'launchpad-icdi'
+    - 'bmp-v2'
+    - 'bmp-v2-uncommon'
+    - 'bmp-v2-st-clones'
+    - 'bmp-v2-riscv'
+    - 'bmp-v2-remote'
+    - 'stlink'
+    - 'stlinkv3'
+    - 'swlink'
+
+steps:
+  # Build the firmware for a given probe platform w/ `-Werror` so warnings are errors
+  - name: build
+    image: codeberg.org/blackmagic-debug/blackmagic-ci-images/blackmagic-c
+    pull: true
+    commands: |
+      export PATH="$$HOME/arm-gnu-toolchain-15.2.rel1-x86_64-arm-none-eabi/bin:$$PATH"
+      apt update
+      apt install -y libftdi1-dev libhidapi-dev libusb-1.0-0-dev
+
+      cc --version
+      arm-none-eabi-gcc --version
+      meson --version
+      ninja --version
+
+      meson setup build --cross-file cross-file/${BMD_PROBE}.ini --werror
+      meson compile -C build

.codeberg/ci/build-linux.yml

@@ -0,0 +1,34 @@
+# SPDX-License-Identifier: MIT OR Apache-2.0
+# SPDX-FileCopyrightText: 2026 1BitSquared <info@1bitsquared.com>
+# SPDX-FileContributor: Written by Rachel Mant <git@dragonmux.network>
+
+# Controls when the workflow will run
+when:
+  # Triggers the workflow on pull request events
+  - event: pull_request
+  # Triggers the workflow on push events, but only for the main branch
+  - event: push
+    branch: main
+  # Allows us to trigger the workflow manually from in Woodpecker for any branch
+  - event: manual
+
+matrix:
+  # Define a matrix of compilers to build BMDA with
+  C_COMPILER:
+    - gcc
+    - clang
+
+steps:
+  # Build BMDA with a given compiler from the matrix w/ `-Werror` so warnings are errors
+  - name: build
+    image: codeberg.org/blackmagic-debug/blackmagic-ci-images/blackmagic-c
+    pull: true
+    commands: |
+      export CC="${C_COMPILER}"
+
+      $$CC --version
+      meson --version
+      ninja --version
+
+      meson setup build -Db_lto=true
+      meson compile -C build

.codeberg/ci/build-windows.yml

@@ -0,0 +1,26 @@
+# SPDX-License-Identifier: MIT OR Apache-2.0
+# SPDX-FileCopyrightText: 2026 1BitSquared <info@1bitsquared.com>
+# SPDX-FileContributor: Written by Rachel Mant <git@dragonmux.network>
+
+# Controls when the workflow will run
+when:
+  # Triggers the workflow on pull request events
+  - event: pull_request
+  # Triggers the workflow on push events, but only for the main branch
+  - event: push
+    branch: main
+  # Allows us to trigger the workflow manually from in Woodpecker for any branch
+  - event: manual
+
+steps:
+  # Build BMDA with a Meson config for Windows cross-builds w/ `-Werror` so warnings are errors
+  - name: build
+    image: codeberg.org/blackmagic-debug/blackmagic-ci-images/blackmagic-c
+    pull: true
+    commands: |
+      x86_64-w64-mingw32ucrt-gcc --version
+      meson --version
+      ninja --version
+
+      meson setup build --cross-file .codeberg/ci/x86_64-pc-windows-mingw-ucrt64.ini -Db_lto=true
+      meson compile -C build

.codeberg/ci/lint.yml

@@ -0,0 +1,25 @@
+# SPDX-License-Identifier: MIT OR Apache-2.0
+# SPDX-FileCopyrightText: 2026 1BitSquared <info@1bitsquared.com>
+# SPDX-FileContributor: Written by Rachel Mant <git@dragonmux.network>
+
+# Controls when the workflow will run
+when:
+  # Triggers the workflow on pull request events
+  - event: pull_request
+  # Allows us to trigger the workflow manually from in Woodpecker for any branch
+  - event: manual
+
+steps:
+  - name: lint
+    image: debian:trixie
+    pull: true
+    commands: |
+      # Get Python installed
+      apt update
+      apt install -y python3 python3-venv git
+      # Create a Python venv for pre-commit to be run from and activate it
+      python3 -m venv --upgrade-deps env
+      . env/bin/activate
+      # Now install pre-commit and run it for BMD
+      pip install pre-commit
+      pre-commit run --show-diff-on-failure --color=always --all-files

.codeberg/ci/x86_64-pc-windows-mingw-ucrt64.ini

@@ -0,0 +1,34 @@
+[constants]
+compileFlags = ['--sysroot', '/usr/x86_64-w64-mingw32ucrt']
+linkFlags = ['--sysroot', '/usr/x86_64-w64-mingw32ucrt']
+
+[binaries]
+c = 'x86_64-w64-mingw32ucrt-gcc'
+cpp = 'x86_64-w64-mingw32ucrt-g++'
+# c_ld = 'x86_64-w64-mingw32ucrt-ld.bdf'
+# cpp_ld = 'x86_64-w64-mingw32ucrt-ld.bdf'
+ar = 'x86_64-w64-mingw32ucrt-ar'
+as = 'x86_64-w64-mingw32ucrt-as'
+rc = 'x86_64-w64-mingw32ucrt-rc'
+windres = 'x86_64-w64-mingw32ucrt-windres'
+strip = 'x86_64-w64-mingw32ucrt-strip'
+objcopy = 'x86_64-w64-mingw32ucrt-objcopy'
+objdump = 'x86_64-w64-mingw32ucrt-objdump'
+size = 'x86_64-w64-mingw32ucrt-size'
+cmake = 'false'
+exe_wrapper = 'wine'
+
+[properties]
+needs_exe_wrapper = true
+
+[built-in options]
+c_args = compileFlags
+cpp_args = compileFlags
+c_link_args = linkFlags
+cpp_link_args = linkFlags
+
+[host_machine]
+system = 'windows'
+cpu_family = 'x86_64'
+cpu = 'amd64'
+endian = 'little'

.github/PULL_REQUEST_TEMPLATE.md

@@ -13,10 +13,10 @@ Information embedded in the description part of the commits doesn't count.
 
 ## Your checklist for this pull request
 
-* [ ] I've read the [Code of Conduct](https://github.com/blackmagic-debug/blackmagic/blob/main/CODE_OF_CONDUCT.md)
-* [ ] I've read the [guidelines for contributing](https://github.com/blackmagic-debug/blackmagic/blob/main/CONTRIBUTING.md) to this repository
-* [ ] It builds for hardware native (see [Building the firmware](https://github.com/blackmagic-debug/blackmagic?tab=readme-ov-file#building-black-magic-debug-firmware))
-* [ ] It builds as BMDA (see [Building the BMDA](https://github.com/blackmagic-debug/blackmagic?tab=readme-ov-file#building-black-magic-debug-app))
+* [ ] I've read the [Code of Conduct](https://codeberg.org/blackmagic-debug/blackmagic/src/CODE_OF_CONDUCT.md)
+* [ ] I've read the [guidelines for contributing](https://codeberg.org/blackmagic-debug/blackmagic/src/CONTRIBUTING.md) to this repository
+* [ ] It builds for hardware native (see [Building the firmware](https://codeberg.org/blackmagic-debug/blackmagic?tab=readme-ov-file#building-the-firmware))
+* [ ] It builds as BMDA (see [Building the BMDA](https://codeberg.org/blackmagic-debug/blackmagic?tab=readme-ov-file#building-black-magic-debug-app))
 * [ ] I've tested it to the best of my ability
 * [ ] My commit messages provide a useful short description of what the commits do
 

.github/workflows/build-and-upload.yml

@@ -32,24 +32,25 @@ jobs:
         os:
           - {id: ubuntu-24.04, name: noble}
         compiler:
-          - '14.3.Rel1'
+          - '15.2.Rel1'
         probe:
           - '96b_carbon'
           - 'blackpill-f401cc'
           - 'blackpill-f401ce'
           - 'blackpill-f411ce'
           - 'bluepill'
+          - 'bmp-v3'
           - 'ctxlink'
           - 'f072'
           - 'f3'
           - 'f4discovery'
           - 'hydrabus'
           - 'launchpad-icdi'
-          - 'native'
-          - 'native-uncommon'
-          - 'native-st-clones'
-          - 'native-riscv'
-          - 'native-remote'
+          - 'bmp-v2'
+          - 'bmp-v2-uncommon'
+          - 'bmp-v2-st-clones'
+          - 'bmp-v2-riscv'
+          - 'bmp-v2-remote'
           - 'stlink'
           - 'stlinkv3'
           - 'swlink'
@@ -90,7 +91,7 @@ jobs:
 
       # Checkout the repository and branch to build under the default location
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
           fetch-tags: true
@@ -103,7 +104,7 @@ jobs:
           meson compile -C build
           mkdir src/artefacts
           case "${{ matrix.probe }}" in
-            native-*)
+            bmp-v2-*)
               mv build/blackmagic_native_firmware.elf build/blackmagic_${{ matrix.probe }}_firmware.elf
               mv build/blackmagic_native_firmware.bin build/blackmagic_${{ matrix.probe }}_firmware.bin
               ;;
@@ -112,7 +113,7 @@ jobs:
 
       # Package up the artefacts and upload them
       - name: Archive
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         with:
           name: blackmagic_firmware-${{ matrix.probe }}
           path: src/artefacts/*
@@ -121,7 +122,7 @@ jobs:
       # Package and upload logs if the build fails so we can dissect why
       - name: Upload failure logs
         if: failure()
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         with:
           name: logs-firmware-${{ matrix.probe }}
           path: ${{ github.workspace }}/build/meson-logs/*
@@ -132,7 +133,7 @@ jobs:
     needs: build-firmware
     steps:
       - name: Merge firmware artefacts
-        uses: actions/upload-artifact/merge@v4
+        uses: actions/upload-artifact/merge@v6
         with:
           name: blackmagic_firmware
           pattern: blackmagic_firmware-*
@@ -150,9 +151,9 @@ jobs:
           - {id: ubuntu-24.04, name: noble}
         compiler:
           - 'clang-17' # Native Clang compiler for the CI image
-          - 'clang-20' # Latest Clang compiler from the apt mirror
+          - 'clang-21' # Latest Clang compiler from the apt mirror
           - 'gcc-12' # Native GCC compiler for the CI image
-          - 'gcc-13' # Latest GCC compiler from the toolchain PPA
+          - 'gcc-14' # Latest GCC compiler from the toolchain PPA
       fail-fast: false
 
     # Steps represent a sequence of tasks that will be executed as part of the job
@@ -172,7 +173,7 @@ jobs:
         shell: bash
         run: |
           CXX=${CC/#gcc/g++}
-          sudo apt-add-repository ppa:ubuntu-toolchain-r/test
+          sudo apt-add-repository ppa:ubuntu-toolchain-r/ppa
           sudo apt-get update
           sudo apt-get install $CC $CXX
           echo "CC=$CC" >> $GITHUB_ENV
@@ -219,7 +220,7 @@ jobs:
 
       # Checkout the repository and branch to build under the default location
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
           fetch-tags: true
@@ -235,7 +236,7 @@ jobs:
 
       # Package up the artefact and upload it
       - name: Archive
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         with:
           name: blackmagic_linux-${{ matrix.os.id }}-${{ matrix.compiler }}
           path: src/artefacts/*
@@ -244,7 +245,7 @@ jobs:
       # Package and upload logs if the build fails so we can dissect why
       - name: Upload failure logs
         if: failure()
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         with:
           name: logs-linux-${{ matrix.os.id }}-${{ matrix.compiler }}
           path: ${{ github.workspace }}/build/meson-logs/*
@@ -266,7 +267,7 @@ jobs:
     strategy:
       matrix:
         os:
-          - windows-2022
+          - windows-2025
         sys:
           - {abi: ucrt64, env: ucrt-x86_64, compiler: gcc}
       fail-fast: false
@@ -319,7 +320,7 @@ jobs:
 
       # Checkout the repository and branch to build under the default location
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
           fetch-tags: true
@@ -336,7 +337,7 @@ jobs:
 
       # Package up all the artefacts and upload them
       - name: Archive firmware build artefacts as a zip
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         with:
           name: blackmagic_${{ matrix.os }}-${{ matrix.sys.abi }}-${{ matrix.sys.compiler }}
           path: src/artefacts/*
@@ -345,7 +346,7 @@ jobs:
       # Package and upload logs if the build fails so we can dissect why
       - name: Upload failure logs
         if: failure()
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         with:
           name: logs-${{ matrix.os }}-${{ matrix.sys.abi }}-${{ matrix.sys.compiler }}
           path: ${{ github.workspace }}/build/meson-logs/*
@@ -368,8 +369,9 @@ jobs:
     strategy:
       matrix:
         os:
-          - {id: macos-13, name: '13'}
           - {id: macos-14, name: '14'}
+          - {id: macos-15, name: '15'}
+          - {id: macos-26, name: '26'}
       fail-fast: false
 
     # Steps represent a sequence of tasks that will be executed as part of the job
@@ -397,7 +399,7 @@ jobs:
 
       # Checkout the repository and branch to build under the default location
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
           fetch-tags: true
@@ -413,7 +415,7 @@ jobs:
 
       # Package up the artefact and upload it
       - name: Archive
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         with:
           name: blackmagic_macos-${{ matrix.os.name }}
           path: src/artefacts/*
@@ -422,7 +424,7 @@ jobs:
       # Package and upload logs if the build fails so we can dissect why
       - name: Upload failure logs
         if: failure()
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         with:
           name: logs-macos-${{ matrix.os.name }}
           path: ${{ github.workspace }}/build/meson-logs/*