Merge branch 'main' into fix/smp-preemption-disable-yield-pending

Author: Xyerophyte

.github/.cSpellWords.txt

@@ -433,6 +433,7 @@ LDRAS
 ldrb
 ldrbs
 LDRBS
+ldrex
 LDRNE
 ldsr
 ldxr

.github/scripts/kernel_checker.py

@@ -2,6 +2,7 @@
 #/*
 # * FreeRTOS Kernel <DEVELOPMENT BRANCH>
 # * Copyright (C) 2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+# * Copyright 2026 Arm Limited and/or its affiliates <open-source-office@arm.com>
 # *
 # * SPDX-License-Identifier: MIT
 # *
@@ -157,9 +158,10 @@
 
 
 FREERTOS_COPYRIGHT_REGEX = r"^(;|#)?( *(\/\*|\*|#|\/\/))? Copyright \(C\) 20\d\d Amazon.com, Inc. or its affiliates. All Rights Reserved\.( \*\/)?$"
+ARM_COLLAB_YEAR_REGEX = r"20\d\d(?:-20\d\d|, 20\d\d)?"
 
 FREERTOS_ARM_COLLAB_COPYRIGHT_REGEX = r"(^(;|#)?( *(\/\*|\*|#|\/\/))? Copyright \(C\) 20\d\d Amazon.com, Inc. or its affiliates. All Rights Reserved\.( \*\/)?$)|" + \
-                                      r"(^(;|#)?( *(\/\*|\*|#|\/\/))? Copyright 20\d\d(-20\d\d)? Arm Limited and/or its affiliates( +<open-source-office@arm\.com>)?( \*\/)?$)|" + \
+                                      rf"(^(;|#)?( *(\/\*|\*|#|\/\/))? Copyright { ARM_COLLAB_YEAR_REGEX } Arm Limited and/or its affiliates( +<open-source-office@arm\.com>)?( \*\/)?$)|" + \
                                       r"(^(;|#)?( *(\/\*|\*|#|\/\/))? Copyright \(c\) 20\d\d(-20\d\d)? Arm Technology \(China\) Co., Ltd.All Rights Reserved\.( \*\/)?$)|" + \
                                       r"(^(;|#)?( *(\/\*|\*|#|\/\/))? <open-source-office@arm\.com>( \*\/)?$)"
 

.github/workflows/auto-release.yml

@@ -19,6 +19,8 @@ on:
 jobs:
   release-packager:
     permissions:
+      contents: write
+      pull-requests: write
       id-token: write
     name: Release Packager
     runs-on: ubuntu-latest
@@ -31,6 +33,16 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
+      - name: Install GitHub CLI
+        run: |
+          command -v gh >/dev/null 2>&1 || {
+            curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
+            sudo chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg
+            echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
+            sudo apt update
+            sudo apt install gh
+          }
+
       # Currently FreeRTOS/.github/scripts houses the release script. Download it for upcoming usage
       - name: Checkout FreeRTOS Release Tools
         uses: actions/checkout@v4.1.1
@@ -52,15 +64,23 @@ jobs:
           git config --global user.name "$ACTOR"
           git config --global user.email "$ACTOR"@users.noreply.github.com
 
-      - name: create a new branch that references commit id
+      - name: Create version branch
         env:
           VERSION_NUMBER: ${{ github.event.inputs.version_number }}
           COMMIT_ID: ${{ github.event.inputs.commit_id }}
         working-directory: ./local_kernel
         run: |
           git checkout -b "$VERSION_NUMBER" "$COMMIT_ID"
+          git push -u origin "$VERSION_NUMBER"
           echo "COMMIT_SHA_1=$(git rev-parse HEAD)" >> $GITHUB_ENV
 
+      - name: Create release preparation branch
+        env:
+          VERSION_NUMBER: ${{ github.event.inputs.version_number }}
+        working-directory: ./local_kernel
+        run: |
+          git checkout -b "release-prep-$VERSION_NUMBER"
+
       - name: Update source files with version info
         env:
           VERSION_NUMBER: ${{ github.event.inputs.version_number }}
@@ -73,37 +93,100 @@ jobs:
           ./tools/.github/scripts/update_src_version.py FreeRTOS --kernel-repo-path=local_kernel --kernel-commit="$COMMIT_SHA_1" --new-kernel-version="$VERSION_NUMBER" --new-kernel-main-br-version="$MAIN_BR_VERSION_NUMBER"
           exit $?
 
-      - name : Update version number in manifest.yml
+      - name: Update version number in manifest.yml
         env:
           VERSION_NUMBER: ${{ github.event.inputs.version_number }}
         working-directory: ./local_kernel
         run: |
           ./.github/scripts/manifest_updater.py -v "$VERSION_NUMBER"
           exit $?
 
-      - name : Commit version number change in manifest.yml
+      - name: Commit and push release preparation branch
         env:
           VERSION_NUMBER: ${{ github.event.inputs.version_number }}
         working-directory: ./local_kernel
         run: |
+          # The update_src_version.py script detaches HEAD by checking out a SHA.
+          # Re-attach HEAD to the release prep branch, keeping all commits.
+          git branch -f "release-prep-$VERSION_NUMBER" HEAD
+          git checkout "release-prep-$VERSION_NUMBER"
+
           git add .
-          git commit -m '[AUTO][RELEASE]: Update version number in manifest.yml'
-          git push -u origin "$VERSION_NUMBER"
+          if git diff --cached --quiet; then
+            echo "No new changes to commit — source files and manifest already up to date."
+          else
+            git commit -m '[AUTO][RELEASE]: Update version number in manifest.yml and source files'
+          fi
+          git push -u origin "release-prep-$VERSION_NUMBER"
+
+      - name: Create pull request
+        env:
+          VERSION_NUMBER: ${{ github.event.inputs.version_number }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          REPO_FULL_NAME: ${{ github.repository }}
+        working-directory: ./local_kernel
+        run: |
+          PR_URL=$(gh pr create \
+            --repo "$REPO_FULL_NAME" \
+            --base "$VERSION_NUMBER" \
+            --head "release-prep-$VERSION_NUMBER" \
+            --title "[AUTO][RELEASE]: Release $VERSION_NUMBER" \
+            --body "Automated release preparation for $VERSION_NUMBER. Updates version numbers in source files and manifest.yml.")
+          echo "PR_URL=$PR_URL" >> $GITHUB_ENV
+
+      - name: Wait for PR to be merged
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          REPO_FULL_NAME: ${{ github.repository }}
+        working-directory: ./local_kernel
+        run: |
+          PR_NUMBER=$(echo "$PR_URL" | grep -oE '[0-9]+$')
+          while true; do
+            STATE=$(gh pr view "$PR_NUMBER" --repo "$REPO_FULL_NAME" --json state --jq .state)
+            if [ "$STATE" = "MERGED" ]; then
+              echo "PR merged successfully"
+              break
+            elif [ "$STATE" = "CLOSED" ]; then
+              echo "Error: PR was closed without merging"
+              exit 1
+            fi
+            echo "Waiting for PR to be merged... (current state: $STATE)"
+            sleep 30
+          done
+
+      - name: Re-checkout after merge
+        uses: actions/checkout@v4.1.1
+        with:
+          path: local_kernel
+          ref: ${{ github.event.inputs.version_number }}
+          fetch-depth: 0
 
       - name: Generate SBOM
         uses: FreeRTOS/CI-CD-Github-Actions/sbom-generator@main
         with:
-          repo_path: ./local_kernel
-          source_path: ./
+          directory: ./local_kernel
+          distribution-type: repository
+          creator: Amazon Web Services, Inc.
+          download-location: git+https://github.com/${{ github.repository_owner }}/${{ github.event.repository.name }}.git@${{ github.event.inputs.version_number }}
+          homepage: https://github.com/${{ github.repository_owner }}/${{ github.event.repository.name }}
+          namespace-prefix: https://github.com/${{ github.repository_owner }}/${{ github.event.repository.name }}/releases/download/V${{ github.event.inputs.version_number }}/
+          include-file-hashes: true
 
-      - name: commit SBOM file
+      - name: Commit SBOM file
         env:
           VERSION_NUMBER: ${{ github.event.inputs.version_number }}
-        working-directory: ./local_kernel
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
+          # SBOM generator writes files to the workspace root — copy them into the repo
+          cp *SPDX* ./local_kernel/ 2>/dev/null || cp *spdx* ./local_kernel/ 2>/dev/null || true
+          cd ./local_kernel
           git add .
-          git commit -m '[AUTO][RELEASE]: Update SBOM'
-          git push -u origin "$VERSION_NUMBER"
+          if git diff --cached --quiet; then
+            echo "No SBOM changes to commit."
+          else
+            git commit -m '[AUTO][RELEASE]: Update SBOM'
+            git push -u origin "$VERSION_NUMBER"
+          fi
           echo "COMMIT_SHA_2=$(git rev-parse HEAD)" >> $GITHUB_ENV
 
       - name: Release
@@ -125,12 +208,19 @@ jobs:
           # This is dependent on the release script putting this zip file
           # in this exact location.
           artifact_path: ./FreeRTOS-KernelV${{ github.event.inputs.version_number }}.zip
-          release_tag: ${{ github.event.inputs.version_number }}
+          release_tag: V${{ github.event.inputs.version_number }}
 
-      - name: Cleanup
+      - name: Delete release preparation branch
+        if: always()
         env:
           VERSION_NUMBER: ${{ github.event.inputs.version_number }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         working-directory: ./local_kernel
         run: |
-          # Delete the branch created for Tag by SBOM generator
-          git push -u origin --delete "$VERSION_NUMBER"
+          # Only delete release-prep branch if the PR was already merged
+          PR_STATE=$(gh pr list --repo "${{ github.repository }}" --head "release-prep-$VERSION_NUMBER" --json state --jq '.[0].state' 2>/dev/null || echo "")
+          if [ "$PR_STATE" = "MERGED" ] || [ -z "$PR_STATE" ]; then
+            git push origin --delete "release-prep-$VERSION_NUMBER" || true
+          else
+            echo "Skipping release-prep branch deletion — PR is still open (state: $PR_STATE)"
+          fi

History.txt

@@ -1,5 +1,120 @@
 Documentation and download available at https://www.FreeRTOS.org/
 
+Changes between FreeRTOS V11.2.0 and FreeRTOS V11.3.0 released March 2026
+
+    + Correct minor mistakes in code comments in event_groups.c, include/queue.h,
+      and include/task.h. We thank @wirelinker for their contribution.
+    + Add Arm China STAR-MC3 port support. We thank @cpussw01 for their
+      contribution.
+    + Add Memory Protection Unit (MPU) support to the ARM Cortex-R82 port. We
+      thank @AhmedIsmail02 for their contribution.
+    + Add ARM Cortex-M52 port support for GCC and IAR compilers. We thank
+      @Armchina_JidongMei for their contribution.
+    + Add ARM Cortex-R82 non-MPU port for ARMv8-R AArch64 with SMP support. We
+      thank @AhmedIsmail02 for their contribution.
+    + Add Floating Point Unit (FPU) context save support to the RISC-V port.
+      We thank @cubidesj for their contribution.
+    + Add Vector context save support to the RISC-V port. We thank @cubidesj
+      for their contribution.
+    + Add xPortIsInsideInterrupt API to the RP2040 port to match other ARM
+      ports. We thank @graham-sanderson for their contribution.
+    + Add catch up behavior documentation to xTaskDelayUntil API to explain
+      frequency breaks when catching up for past events.
+    + Add asserts to check for stack overflow at task creation time.
+    + Add assert to check for overflow in xStreamBufferSendFromISR API.
+    + Add assert to check for overflow of recursive mutex counter. We thank
+      @InnerSteff for their contribution.
+    + Add CFI frame unwind information in portable/IAR/RXv2/port_asm.s to
+      enable debugger callstack display beyond __interrupt_27. We thank
+      @bernd-edlinger for their contribution.
+    + Update xTaskDelayUntil to be the preferred delay function in the
+      FreeRTOSConfig.h template.
+    + Update RISC-V port to use saved mstatus for FPU/VPU state determination
+      instead of re-reading after writes, addressing specification-compliant
+      implementations where FS field may change to Dirty.
+    + Update RISC-V port to refine vector context layout on stack for proper
+      register ordering. We thank @Saiiijchan for their contribution.
+    + Update RISC-V port to refine FPU register context offset calculation. We
+      thank @Saiiijchan for their contribution.
+    + Update RISC-V port to use UBaseType_t for ullMachineTimerCompareRegisterBase
+      to resolve warnings on 32-bit platforms.
+    + Update FreeRTOS MPU to remove the assertion and runtime check enforcing
+      matching between configTOTAL_MPU_REGIONS and physical MPU regions,
+      allowing applications to manage a subset of available regions. We thank
+      @ErickReyesR for their contribution.
+    + Update ARM_CRx_No_GIC port to set Data endianness bit in SPSR register
+      for big-endian compilation. We thank @maximdeclercq00 for their
+      contribution.
+    + Update Win32 port to guard timeapi.h include for MinGW compatibility and
+      add compiler-specific headers for cross-compiler support. We thank
+      @nordync for their contribution.
+    + Update Win32 port to move Windows headers to port.c to prevent inclusion
+      of windows.h in all header files and avoid macro conflicts. We thank
+      @creiter64 for their contribution.
+    + Update POSIX port to delete thread key on process exit instead of in
+      xPortStartScheduler to ensure proper cleanup of thread-specific memory.
+    + Update POSIX port to fix race condition in vPortEndScheduler by moving
+      scheduler thread signal after FreeRTOS thread check. We thank
+      @arctic-alpaca for their contribution.
+    + Update RP2040 port to fix use of deprecated volatile semantics for C++20
+      compatibility. We thank @mathiasgredal for their contribution.
+    + Update RP2040 port to propagate PICO_SDK_VERSION_* to parent scope in
+      CMake. We thank @shengtai25 for their contribution.
+    + Update RP2040 port to remove unused code and preprocessor directives. We
+      thank @pascalr for their contribution.
+    + Update RL78 port to fix incorrect register image for pvParameters in FAR
+      data model for IAR compiler. We thank @sauleThsQuin for their
+      contribution.
+    + Update RL78 port to fix compilation failure on portasm.s file due to
+      indentation on ASM macro. We thank @5iBri for their contribution.
+    + Update ARM_CRx_MPU port to add LLVM assembler compatibility by
+      explicitly specifying section flags. We thank @malsyned for their
+      contribution.
+    + Update Cortex-M ports to rename ulStackFrameSize to
+      ulHardwareSavedExceptionFrameSize for improved readability. We thank
+      @AhmedIsmail02 for their contribution.
+    + Update MPLAB PIC32MZ-EF port to add assert to catch register overflow.
+      We thank @mrluzeiro for their contribution.
+    + Update comments related to taskYIELD in queue.h. We thank @Saiiijchan
+      for their contribution.
+    + Fix priority disinheritance in vTaskPriorityDisinheritAfterTimeout to
+      reset the correct priority when the task disinheriting timeout was the
+      only task at that priority.
+    + Fix event groups to remove direct mapping of xEventGroupClearBitsFromISR
+      and xEventGroupSetBitsFromISR to xTimerPendFunctionCallFromISR,
+      resolving redefinition warnings. We thank @AhmedIsmail02 for their
+      contribution.
+    + Fix datatype of queue item length macros from uint8_t to UBaseType_t to
+      match API parameter types.
+    + Fix possible NULL pointer dereference after configASSERT() calls in
+      queue.c and stream_buffer.c. We thank @Florian.LaRoche for their
+      contribution.
+    + Fix Win32 port to prevent SetWaitableTimer() call from being ignored
+      when configASSERT expands to nothing. We thank @kim-schwaner for their
+      contribution.
+    + Fix compiler warnings from gcc -Wconversion. We thank @Florian.LaRoche
+      for their contribution.
+    + Fix compiler warning about gcc -Wwrite-strings in POSIX port. We thank
+      @Florian.LaRoche for their contribution.
+    + Fix set but unused variable warning in pxPortInitialiseStack. We thank
+      @razrbro for their contribution.
+    + Fix missing include to resolve compile error. We thank @mike919192 for
+      their contribution.
+    + Fix missing cast to BaseType_t.
+    + Fix cast in stack allocation for task creation for negative
+      portSTACK_GROWTH. We thank @sidharthseela for their contribution.
+    + Fix missing macro guards in task.h to prevent unintended API access. We
+      thank @SoniHarsh1 for their contribution.
+    + Fix CMake build for GCC_ARM_CRx_MPU by adding to mpu_wrappers patterns.
+      We thank @malsyned for their contribution.
+    + Fix initialization of size_t-type variable by changing macro from
+      portMAX_DELAY to SIZE_MAX. We thank @duyicheng741 for their
+      contribution.
+    + Define configENABLE_PAC and configENABLE_BTI before including portable.h
+      to prevent "used before definition" warnings.
+    + Remove stray semicolon from gcc-ARM_CRx_MPU port.c. We thank
+      @Florian.LaRoche for their contribution.
+
 Changes between FreeRTOS V11.1.0 and FreeRTOS V11.2.0 released March 04, 2025
 
     + Add CC-RH port for Renesas F1Kx devices. We thank @TrongNguyenR for their

README.md

@@ -130,7 +130,7 @@ See the readme file in the ```./portable``` directory for more information.
 
 - The ```./include``` directory contains the real time kernel header files.
 
-- The ```./template_configuration``` directory contains a sample `FreeRTOSConfig.h` to help jumpstart a new project.
+- The ```./examples/template_configuration``` directory contains a sample `FreeRTOSConfig.h` to help jumpstart a new project.
 See the [FreeRTOSConfig.h](examples/template_configuration/FreeRTOSConfig.h) file for instructions.
 
 ### Code Formatting