Document source: 5a7a75c321ea; code reference: 5a7a75c321ea. zh_CN. Source language: en; requested: en; actual: en; translation: original.

Source documentation does not establish software or physical hardware qualification. See the support and qualification records for their exact scope.

Wait correctly and shut down an explicit owner

Use this guide for applications selecting an optional Native, FreeRTOS or ThreadX adapter. The application owns tasks, stacks, notifications, queues and execution progress. Baremetal has no scheduler. Platform start never starts a kernel. The OS contract remains authoritative.

Avoid lost completion and unbounded waits

Use the request’s latched predicate as truth. Check the completion predicate, arm the notification sequence, recheck, wait with the same absolute monotonic deadline, then recheck again. Wakes are hints and may be coalesced or unrelated. On timeout, perform the contract’s final predicate observation. Do not restart a relative budget after each hint and do not block the only executor that must make progress.

FIG-08 shows the current wait/wake responsibilities. A provider IRQ sink must respect the selected kernel syscall ceiling; an unqualified priority cannot call an ISR kernel API. ThreadX has its own reviewed M4/Native subset and masking policy, not the FreeRTOS port or tickless/isolation capability set.

Shut down in dependency order

1. Close client admission and reject new work without borrowing it.

2. Keep the resource owner/executor running. Request cancellation using stable slots and matching epochs; cancellation does not release accepted storage.

3. Drain transfers and block loans. Acquire-observe SETTLED and read results. A failed drain retains QUARANTINED storage and explicit recovery responsibility.

4. Join producers and detach/join control observers before slot or request reuse.

5. Stop and join the owner. Quiesce hardware IRQ publishers before destroying their notification, queue, guard, stack or TCB storage.

6. Stop platform providers only when their selected lifetime and kernel clock/Tick ownership permit it. A running scheduler is not stopped by ordinary I/O teardown.

A returning adapter task parks until its one external lifecycle owner joins it. Returning from an entry function does not allow stack/TCB reclamation. Raw queues and closable queues have different lifecycle contracts; close is not destruction. Keep all storage on the failure path and retry cleanup only through its real owner.

Execute maintained software fixtures

From the repository root:

python tools/dev/dev.py configure --preset native-debug
python tools/dev/dev.py build --preset native-debug --parallel 4     --target nexus_os_wait_test nexus_uart_owner_mock_test
build/native-debug/bin/nexus_os_wait_test
build/native-debug/bin/nexus_uart_owner_mock_test

Both binaries must execute nonempty passing cases. This targeted development scope does not replace the complete TDD gate. The external UART owner application in nexus-examples supplies product workers; its pin/revision must be recorded before claiming consumer execution.

Physical scheduler context, IRQ ceiling, FP/MVE retention, stack peaks and wake latency require real station evidence. Do not inherit POSIX behavior as MCU timing.