chinglee-iot
diff --git a/‎.github/lexicon.txt
+26-1 b/‎.github/lexicon.txt
+26-1
diff --git a/‎.github/workflows/auto-release.yml
+20-4 b/‎.github/workflows/auto-release.yml
+20-4
diff --git a/‎CMakeLists.txt
+9-10 b/‎CMakeLists.txt
+9-10
diff --git a/‎History.txt
+111 b/‎History.txt
+111
diff --git a/‎README.md
+2-1 b/‎README.md
+2-1
@@ -1,3 +1,4 @@
+  GNU nano 5.9                     .github/lexicon.txt                     Modified
 aa
 aaaa
 aarch
@@ -317,6 +318,7 @@ coproc
 coprocessor
 coprocessors
 coreid
+coroutinehandle
 coverity
 covfs
 cp
@@ -344,10 +346,16 @@ cpu
 cr
 crc
 crcb
+crcoroutine
+crdelay
 creadonlyarray
 creadwritearray
 createevent
+crend
 crgint
+croutine
+crqueue
+crstart
 crt
 crtv
 crxedchar
@@ -1526,18 +1534,21 @@ prvcheckforrunstatechange
 prvcheckinterfaces
 prvchecktaskswaitingtermination
 prvcopydatatoqueue
+prvcoroutineflashtask
+prvcoroutineflashworktask
 prvdeletetcb
 prvexitfunction
 prvgettimens
 prvheapinit
 prvidletask
+prvinitialisecoroutinelists
 prvinitialisemutex
 prvinitialisenewstreambuffer
 prvinitialisenewtimer
 prvinsertblockintofreelist
 prvlockqueue
-prvnotifyqueuesetcontainer
 prvminimalidletask
+prvnotifyqueuesetcontainer
 prvportmalloc
 prvportresetpic
 prvprocesssimulatedinterrupts
@@ -1647,11 +1658,15 @@ pxblocktoinsert
 pxcallbackfunction
 pxcode
 pxcontainer
+pxcoroutinecode
+pxcoroutinewoken
 pxcrcb
 pxcreatedtask
+pxcurrentcoroutine
 pxcurrenttcb
 pxcurrenttcbconst
 pxcurrenttimerlist
+pxdelayedcoroutinelist
 pxdelayedtasklist
 pxend
 pxendofstack
@@ -1686,6 +1701,7 @@ pxnextfreeblock
 pxnexttcb
 pxoriginalsp
 pxoriginaltos
+pxoverflowdelayedcoroutinelist
 pxoverflowdelayedtasklist
 pxowner
 pxportinitialisestack
@@ -1695,6 +1711,7 @@ pxqueue
 pxqueuebuffer
 pxqueuesetcontainer
 pxramstack
+pxreadycoroutinelists
 pxreadytaskslists
 pxreceivecompletedcallback
 pxregions
@@ -2444,6 +2461,7 @@ uxprevschedulersuspended
 uxpriority
 uxprioritytouse
 uxqueue
+uxqueuegetqueueitemsize
 uxqueuelength
 uxqueuemessageswaiting
 uxqueuespacesavailable
@@ -2474,6 +2492,7 @@ uxtopreadypriority
 uxtopusedpriority
 uxvariabletoincrement
 uxwantedbytes
+vacoroutine
 vadifferenttask
 vafunction
 val
@@ -2504,6 +2523,7 @@ vbr
 vbufferisr
 vcallbackfunction
 vclearinterruptmask
+vcoroutineschedule
 vddcore
 vec
 vectactive
@@ -2513,6 +2533,7 @@ ver
 veventgroupclearbitscallback
 veventgroupdelete
 veventgroupsetbitscallback
+vflashcoroutine
 vfp
 vfunction
 vic
@@ -2575,12 +2596,14 @@ vqueuedelete
 vqueueunregisterqueue
 vr
 vraiseprivilege
+vreceivingcoroutine
 vreg
 vresetprivilege
 vrestorecontextoffirsttask
 vrpm
 vsemaphorecreatebinary
 vsemaphoredelete
+vsendingcoroutine
 vsetbacklightstate
 vsoftwareinterruptentry
 vstartfirsttask
@@ -2734,6 +2757,7 @@ xdd
 xdddd
 xdeadbeef
 xdelay
+xdelayedcoroutinelist
 xdelayedtasklist
 xdelaytime
 xe
@@ -2888,6 +2912,7 @@ xpar
 xparameters
 xpendedcounts
 xpendedticks
+xpendingreadycoroutinelist
 xpendingreadylist
 xperiod
 xportgetcoreid
 
@@ -25,7 +25,6 @@ jobs:
       - name: Tool Setup
         uses: actions/setup-python@v2
         with:
-          python-version: 3.7.10
           architecture:   x64
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -51,7 +50,18 @@ jobs:
 
       - name: create a new branch that references commit id
         working-directory: ./local_kernel
-        run: git checkout -b ${{ github.event.inputs.version_number }} ${{ github.event.inputs.commit_id }}
+        run: |
+          git checkout -b ${{ github.event.inputs.version_number }} ${{ github.event.inputs.commit_id }}
+          echo "COMMIT_SHA_1=$(git rev-parse HEAD)" >> $GITHUB_ENV
+
+      - name: Update source files with version info
+        run: |
+          # Install deps and run
+          pip install -r ./tools/.github/scripts/release-requirements.txt
+          ./tools/.github/scripts/update_src_version.py FreeRTOS --kernel-repo-path=local_kernel --kernel-commit=${{ env.COMMIT_SHA_1 }} --new-kernel-version=${{ github.event.inputs.version_number }} --new-kernel-main-br-version=${{ github.event.inputs.main_br_version }}
+          exit $?
+        env:
+            GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Generate SBOM
         uses: FreeRTOS/CI-CD-Github-Actions/sbom-generator@main
@@ -65,13 +75,19 @@ jobs:
           git add .
           git commit -m 'Update SBOM'
           git push -u origin ${{ github.event.inputs.version_number }}
-          echo "COMMIT_SHA=$(git rev-parse HEAD)" >> $GITHUB_ENV
+          echo "COMMIT_SHA_2=$(git rev-parse HEAD)" >> $GITHUB_ENV
 
       - name: Release
         run: |
           # Install deps and run
           pip install -r ./tools/.github/scripts/release-requirements.txt
-          ./tools/.github/scripts/release.py FreeRTOS --kernel-repo-path=local_kernel --kernel-commit=${{ env.COMMIT_SHA }} --new-kernel-version=${{ github.event.inputs.version_number }} --new-kernel-main-br-version=${{ github.event.inputs.main_br_version }}
+          ./tools/.github/scripts/release.py FreeRTOS --kernel-repo-path=local_kernel --kernel-commit=${{ env.COMMIT_SHA_2 }} --new-kernel-version=${{ github.event.inputs.version_number }} --new-kernel-main-br-version=${{ github.event.inputs.main_br_version }}
           exit $?
         env:
             GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Cleanup
+        working-directory: ./local_kernel
+        run: |
+          # Delete the branch created for Tag by SBOM generator
+          git push -u origin --delete ${{ github.event.inputs.version_number }}
@@ -225,9 +225,12 @@ elseif((FREERTOS_PORT STREQUAL "A_CUSTOM_PORT") AND (NOT TARGET freertos_kernel_
     "      .)\n"
     "   target_link_libraries(freertos_kernel_port\n"
     "     PRIVATE\n"
-    "       freertos_kernel)")
+    "       freertos_kernel_include)")
 endif()
 
+
+add_library(freertos_kernel STATIC)
+
 ########################################################################
 # Overall Compile Options
 # Note the compile option strategy is to error on everything and then
@@ -248,7 +251,7 @@ endif()
 #   MSVC        | MSVC # Note only for MinGW?
 #   Renesas     | ?TBD?
 
-add_compile_options(
+target_compile_options(freertos_kernel PRIVATE
     ### Gnu/Clang C Options
     $<$<COMPILE_LANG_AND_ID:C,GNU>:-fdiagnostics-color=always>
     $<$<COMPILE_LANG_AND_ID:C,Clang>:-fcolor-diagnostics>
@@ -264,9 +267,11 @@ add_compile_options(
 
 
 ########################################################################
+add_subdirectory(include)
 add_subdirectory(portable)
 
-add_library(freertos_kernel STATIC
+target_sources(freertos_kernel PRIVATE
+    croutine.c
     event_groups.c
     list.c
     queue.c
@@ -278,17 +283,11 @@ add_library(freertos_kernel STATIC
     $<IF:$<BOOL:$<FILTER:${FREERTOS_HEAP},EXCLUDE,^[1-5]$>>,${FREERTOS_HEAP},portable/MemMang/heap_${FREERTOS_HEAP}.c>
 )
 
-target_include_directories(freertos_kernel
-    PUBLIC
-        include
-        # Note: DEPRECATED but still supported, may be removed in a future release.
-        $<$<NOT:$<TARGET_EXISTS:freertos_config>>:${FREERTOS_CONFIG_FILE_DIRECTORY}>
-)
 
 target_link_libraries(freertos_kernel
     PUBLIC
-        $<$<TARGET_EXISTS:freertos_config>:freertos_config>
         freertos_kernel_port
+        freertos_kernel_include
 )
 
 ########################################################################
@@ -1,5 +1,116 @@
 Documentation and download available at https://www.FreeRTOS.org/
 
+Changes between FreeRTOS V10.5.1 and FreeRTOS 10.6.0 released July 13, 2023
+
+	+ Add a new MPU wrapper that places additional restrictions on unprivileged
+	  tasks. The following is the list of changes introduced with the new MPU
+	  wrapper:
+
+	  1. Opaque and indirectly verifiable integers for kernel object handles:
+	     All the kernel object handles (for example, queue handles) are now
+	     opaque integers. Previously object handles were raw pointers.
+	  2. Save the task context in Task Control Block (TCB): When a task is
+	     swapped out by the scheduler, the task's context is now saved in its
+	     TCB. Previously the task's context was saved on its stack.
+	  3. Execute system calls on a separate privileged only stack: FreeRTOS
+	     system calls, which execute with elevated privilege, now use a
+	     separate privileged only stack. Previously system calls used the
+	     calling task's stack. The application writer can control the size of
+	     the system call stack using new configSYSTEM_CALL_STACK_SIZE config
+	     macro.
+	  4. Memory bounds checks: FreeRTOS system calls which accept a pointer
+	     and de-reference it, now verify that the calling task has required
+	     permissions to access the memory location referenced by the pointer.
+	  5. System calls restrictions: The following system calls are no longer
+	     available to unprivileged tasks:
+	      - vQueueDelete
+	      - xQueueCreateMutex
+	      - xQueueCreateMutexStatic
+	      - xQueueCreateCountingSemaphore
+	      - xQueueCreateCountingSemaphoreStatic
+	      - xQueueGenericCreate
+	      - xQueueGenericCreateStatic
+	      - xQueueCreateSet
+	      - xQueueRemoveFromSet
+	      - xQueueGenericReset
+	      - xTaskCreate
+	      - xTaskCreateStatic
+	      - vTaskDelete
+	      - vTaskPrioritySet
+	      - vTaskSuspendAll
+	      - xTaskResumeAll
+	      - xTaskGetHandle
+	      - xTaskCallApplicationTaskHook
+	      - vTaskList
+	      - vTaskGetRunTimeStats
+	      - xTaskCatchUpTicks
+	      - xEventGroupCreate
+	      - xEventGroupCreateStatic
+	      - vEventGroupDelete
+	      - xStreamBufferGenericCreate
+	      - xStreamBufferGenericCreateStatic
+	      - vStreamBufferDelete
+	      - xStreamBufferReset
+	     Also, an unprivileged task can no longer use vTaskSuspend to suspend
+	     any task other than itself.
+
+	  We thank the following people for their inputs in these enhancements:
+	    - David Reiss of Meta Platforms, Inc.
+	    - Lan Luo, Xinhui Shao, Yumeng Wei, Zixia Liu, Huaiyu Yan and Zhen Ling
+	      of School of Computer Science and Engineering, Southeast University,
+	      China.
+	    - Xinwen Fu of Department of Computer Science, University of
+	      Massachusetts Lowell, USA.
+	    - Yueqi Chen, Zicheng Wang, Minghao Lin of University of Colorado
+	      Boulder, USA.
+	+ Add Cortex-M35P port. Contributed by @urutva.
+	+ Add embedded extension (RV32E) support to the IAR RISC-V port.
+	+ Add ulTaskGetRunTimeCounter and ulTaskGetRunTimePercent APIs. Contributed by
+	  @chrisnc.
+	+ Add APIs to get the application supplied buffers from statically
+	  created kernel objects. The following new APIs are added:
+	  - xTaskGetStaticBuffers
+	  - xQueueGetStaticBuffers
+	  - xQueueGenericGetStaticBuffers
+	  - xSemaphoreGetStaticBuffer
+	  - xEventGroupGetStaticBuffer
+	  - xStreamBufferGetStaticBuffers
+	  - xMessageBufferGetStaticBuffers
+	  These APIs enable the application writer to obtain static buffers from
+	  the kernel object and free/reuse them at the time of deletion. Earlier
+	  the application writer had to maintain the association of static buffers
+	  and the kernel object in the application. Contributed by @Dazza0.
+	+ Add Thread Local Storage (TLS) support using picolibc function. Contributed
+	  by @keith-packard.
+	+ Add configTICK_TYPE_WIDTH_IN_BITS to configure TickType_t data type. As a result,
+	  the number of bits in an event group also increases with big data type. Contributed
+	  by @Hadatko.
+	+ Update eTaskGetState and uxTaskGetSystemState to return eReady for pending ready
+	  tasks. Contributed by @Dazza0.
+	+ Update heap_4 and heap_5 to add padding only if the resulting block is not
+	  already aligned.
+	+ Fix the scheduler logic in a couple of places to not preempt a task when an
+	  equal priority task becomes ready.
+	+ Add macros used in FreeRTOS-Plus libraries. Contributed by @Holden.
+	+ Fix clang compiler warnings. Contributed by @phelter.
+	+ Add assertions to ARMv8-M ports to detect when FreeRTOS APIs are called from
+	  interrupts with priority higher than the configMAX_SYSCALL_INTERRUPT_PRIORITY.
+	  Contributed by @urutva.
+	+ Add xPortIsInsideInterrupt API to ARM_CM0 ports.
+	+ Fix build warning in MSP430X port when large data model is used.
+	+ Add the ability to use Cortex-R5 port on the parts without FPU.
+	+ Fix build warning in heap implementations on PIC24/dsPIC.
+	+ Update interrupt priority asserts for Cortex-M ports so that these do not fire
+	  on QEMU which does not implement PRIO bits.
+	+ Update ARMv7-M ports to ensure that kernel interrupts run at the lowest priority.
+	  configKERNEL_INTERRUPT_PRIORITY is now obsolete for ARMv7-M ports and brings
+	  these ports inline with the newer ARMv8-M ports. Contributed by @chrisnc.
+	+ Fix build issue in POSIX GCC port on Windows Subsystem for Linux (WSL). Contributed
+	  by @jacky309.
+	+ Add portMEMORY_BARRIER to Microblaze port. Contributed by @bbain.
+	+ Add portPOINTER_SIZE_TYPE definition for ATmega port. Contributed by @jputcu.
+	+ Multiple improvements in the CMake support. Contributed by @phelte and @cookpate.
+
 Changes between FreeRTOS V10.5.0 and FreeRTOS V10.5.1 released November 16 2022
 	+ Updated the kernel version in manifest and SBOM
 
 
@@ -70,7 +70,8 @@ git clone [email protected]:FreeRTOS/FreeRTOS-Kernel.git
 ## Repository structure
 - The root of this repository contains the three files that are common to
 every port - list.c, queue.c and tasks.c.  The kernel is contained within these
-three files.
+three files.  croutine.c implements the optional co-routine functionality - which
+is normally only used on very memory limited systems.
 
 - The ```./portable``` directory contains the files that are specific to a particular microcontroller and/or compiler.
 See the readme file in the ```./portable``` directory for more information.