FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

Add CMock+Unity unit tests for FreeRTOS-Kernel PR #1418 by chinglee-iot · Pull Request #1414 · FreeRTOS/FreeRTOS · GitHub

/ FreeRTOS Public

Add CMock+Unity unit tests for FreeRTOS-Kernel PR #1418 - #1414

Open
chinglee-iot wants to merge 2 commits into
FreeRTOS:mainfrom
chinglee-iot:smp-unit-test/pr-1418
ConversationCommits (2)ChecksFiles changed
Open

Add CMock+Unity unit tests for FreeRTOS-Kernel PR #1418#1414
chinglee-iot wants to merge 2 commits into
FreeRTOS:mainfrom
chinglee-iot:smp-unit-test/pr-1418

Conversation

chinglee-iot commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Description

This pull request adds CMock + Unity unit tests for the changes introduced
in FreeRTOS-Kernel PR #1418,
which adds the vTaskSetSchedulerCoreMask() and uxTaskGetSchedulerCoreMask()
APIs for per-core scheduler masking in SMP builds.

Kernel PR: FreeRTOS/FreeRTOS-Kernel#1418

New test suite: FreeRTOS/Test/CMock/smp/scheduler_core_mask/

Functional test plan

The following scenarios are verified end-to-end via the public API:

Test Scenario
test_vTaskSetSchedulerCoreMask_before_scheduler_starts Mask is stored correctly when called before the scheduler starts; no yield is issued
test_uxTaskGetSchedulerCoreMask_returns_current_mask Round-trip: Set then Get returns the identical value
test_uxTaskGetSchedulerCoreMask_while_scheduler_running Getter takes the critical-section path when the scheduler is running
test_vTaskSetSchedulerCoreMask_all_cores_enabled Re-applying the same all-enabled mask leaves all tasks running and issues no yields
test_vTaskSetSchedulerCoreMask_disable_core_running_nonidle Disabling a core that runs a non-idle task triggers a yield; the idle task takes over that core
test_vTaskSetSchedulerCoreMask_enable_previously_disabled_core Re-enabling a previously disabled core triggers a yield; a user task is dispatched back to it

Coverage test plan

The following branch conditions not reachable via the public API are covered
by the coverage test file:

Test Branch covered
test_coverage_vTaskSetSchedulerCoreMask_invalid_mask configASSERT false-branch (tasks.c:3150) — out-of-range mask
test_coverage_vTaskSetSchedulerCoreMask_disable_core_idle_task Disabled core already running idle task → prvYieldCore NOT called (tasks.c:3181 branch 1)
test_coverage_vTaskSetSchedulerCoreMask_disable_current_core prvYieldCore same-core path → xYieldPendings set instead of portYIELD_CORE (tasks.c:3183 branch 0)
test_coverage_vTaskSetSchedulerCoreMask_enable_current_core Re-enable current core → xYieldPendings path (tasks.c:3188 branch 0)
test_coverage_prvSelectHighestPriorityTask_preemption_disabled_core Non-idle task excluded as preemption target for disabled core (tasks.c:960–961)
test_coverage_prvSelectHighestPriorityTask_disabled_core_not_running NOT_RUNNING non-idle task not assigned to disabled core (tasks.c:1117 branch 1)
test_coverage_prvSelectHighestPriorityTask_disabled_core_already_running Already-running non-idle task not continued on disabled core (tasks.c:1141 branch 1)

Test results

  • Tests passed : 273 (0 regressions in existing SMP suites)
  • Tests failed : 0
  • Changed-line coverage : 100%

Test Steps

  1. Clone the FreeRTOS repository and initialise submodules: 
    git clone https://github.com/FreeRTOS/FreeRTOS.git
cd FreeRTOS
git submodule update --init FreeRTOS/Source FreeRTOS/Test/CMock/CMock
  2. Run the new test suite: 
    cd FreeRTOS/Test/CMock
make -C smp/scheduler_core_mask
  3. Verify no regressions in the full SMP suite: 
    make -C smp

Checklist:

  • I have tested my changes. No regression in existing tests.
  • I have modified and/or added unit-tests to cover the code changes in this Pull Request.

Related Issue

FreeRTOS-Kernel PR #1418: FreeRTOS/FreeRTOS-Kernel#1418

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

chinglee-iot and others added 2 commits June 23, 2026 09:57
Add CMock+Unity unit tests for FreeRTOS-Kernel PR FreeRTOS#1418
e41d10f 
Adds a new SMP test suite scheduler_core_mask covering the
vTaskSetSchedulerCoreMask() and uxTaskGetSchedulerCoreMask() APIs
introduced by FreeRTOS-Kernel PR FreeRTOS#1418, plus the scheduler-mask
guard branches in prvSelectHighestPriorityTask.

12 tests (6 functional + 6 coverage), 100% line coverage of
PR-changed lines in tasks.c.
Merge branch 'main' into smp-unit-test/pr-1418
eb18953
chinglee-iot mentioned this pull request Jun 23, 2026
Open
2 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
Show hidden characters
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

Back | FazBrowse Home | New Git URL