Skip to content

Commit c877fc7

Browse files
authored
Merge branch 'master' into typo
2 parents 1c6a409 + 9f527a3 commit c877fc7

File tree

800 files changed

+7192
-7989
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

800 files changed

+7192
-7989
lines changed

README.md

+12-16
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
1-
# Azure RTOS ThreadX
1+
# Eclipse ThreadX RTOS
22

3-
This advanced real-time operating system (RTOS) is designed specifically for deeply embedded applications. Among the multiple benefits it provides are advanced scheduling facilities, message passing, interrupt management, and messaging services. Azure RTOS ThreadX has many advanced features, including picokernel architecture, preemption threshold, event chaining, and a rich set of system services.
3+
This advanced real-time operating system (RTOS) is designed specifically for deeply embedded applications. Among the multiple benefits it provides are advanced scheduling facilities, message passing, interrupt management, and messaging services. Eclipse ThreadX RTOS has many advanced features, including picokernel architecture, preemption threshold, event chaining, and a rich set of system services.
44

55
Here are the key features and modules of ThreadX:
66

77
![ThreadX Key Features](./docs/threadx-features.png)
88

99
## Getting Started
1010

11-
Azure RTOS has been integrated to the semiconductor's SDKs and development environment. You can develop using the tools of choice from [STMicroelectronics](https://www.st.com/content/st_com/en/campaigns/x-cube-azrtos-azure-rtos-stm32.html), [NXP](https://www.nxp.com/design/software/embedded-software/azure-rtos-for-nxp-microcontrollers:AZURE-RTOS), [Renesas](https://github.com/renesas/azure-rtos) and [Microchip](https://mu.microchip.com/get-started-simplifying-your-iot-design-with-azure-rtos).
11+
Eclipse ThreadX has been integrated to the semiconductor's SDKs and development environment. You can develop using the tools of choice from [STMicroelectronics](https://www.st.com/content/st_com/en/campaigns/x-cube-azrtos-azure-rtos-stm32.html), [NXP](https://www.nxp.com/design/software/embedded-software/azure-rtos-for-nxp-microcontrollers:AZURE-RTOS), [Renesas](https://github.com/renesas/azure-rtos) and [Microchip](https://mu.microchip.com/get-started-simplifying-your-iot-design-with-azure-rtos).
1212

13-
We also provide [getting started guide](https://github.com/eclipse-threadx/getting-started) and [samples](https://github.com/eclipse-threadx/samples) using hero development boards from semiconductors you can build and test with.
13+
We also provide [getting started guide](https://github.com/eclipse-threadx/getting-started) and [samples](https://github.com/eclipse-threadx/samples) using development boards from semiconductors you can build and test with.
1414

15-
See [Overview of Azure RTOS ThreadX](https://learn.microsoft.com/en-us/azure/rtos/threadx/overview-threadx) for the high-level overview, and all documentation and APIs can be found in: [Azure RTOS ThreadX documentation](https://learn.microsoft.com/en-us/azure/rtos/threadx/).
15+
See [Overview of Eclipse ThreadX RTOS](https://github.com/eclipse-threadx/rtos-docs/blob/main/rtos-docs/threadx/overview-threadx.md) for the high-level overview.
1616

1717
## Repository Structure and Usage
1818
### Directory layout
@@ -118,7 +118,7 @@ xtensa cortex_a65ae
118118
```
119119

120120
### ThreadX Modules
121-
[Azure RTOS ThreadX Modules](https://learn.microsoft.com/azure/rtos/threadx-modules/chapter1) component provides an infrastructure for applications to dynamically load modules that are built separately from the resident portion of the application.
121+
[Eclipse ThreadX Modules](https://github.com/eclipse-threadx/rtos-docs/blob/main/rtos-docs/threadx-modules/chapter1.md) component provides an infrastructure for applications to dynamically load modules that are built separately from the resident portion of the application.
122122
```
123123
cortex_a35
124124
cortex_a35_smp
@@ -134,7 +134,7 @@ rxv2
134134
```
135135

136136
### ThreadX SMP
137-
[Azure RTOS ThreadX SMP](https://learn.microsoft.com/azure/rtos/threadx/threadx-smp/chapter1) is a high-performance real-time SMP kernel designed specifically for embedded applications.
137+
[Eclipse ThreadX SMP](https://github.com/eclipse-threadx/rtos-docs/blob/main/rtos-docs/threadx/threadx-smp/chapter1.md) is a high-performance real-time SMP kernel designed specifically for embedded applications.
138138
```
139139
arc_hs_smp
140140
cortex_a34_smp
@@ -160,7 +160,7 @@ linux
160160

161161
## Adaptation layer for ThreadX
162162

163-
ThreadX is an advanced real-time operating system (RTOS) designed specifically for deeply embedded applications. To help ease application migration to ThreadX RTOS, ThreadX provides [adaption layers](https://github.com/eclipse-threadx/threadx/tree/master/utility/rtos_compatibility_layers) for various legacy RTOS APIs (FreeRTOS, POSIX, OSEK, etc.).
163+
ThreadX is an advanced real-time operating system (RTOS) designed specifically for deeply embedded applications. To help ease application migration to ThreadX RTOS, Eclipse ThreadX provides [adaption layers](https://github.com/eclipse-threadx/threadx/tree/master/utility/rtos_compatibility_layers) for various legacy RTOS APIs (FreeRTOS, POSIX, OSEK, etc.).
164164

165165
## Component dependencies
166166

@@ -207,25 +207,21 @@ Instruction for building the ThreadX as static library using Arm GNU Toolchain a
207207

208208
## Licensing
209209

210-
License terms for using ThreadX RTOS are defined in the LICENSE.txt file of this repo. Please refer to this file for all definitive licensing information. No additional license fees are required for deploying ThreadX RTOS on hardware defined in the LICENSED-HARDWARE.txt file. If you are using hardware not defined in the LICENSED-HARDWARE.txt file or have licensing questions in general, please contact Microsoft directly at https://aka.ms/azrtos-license.
210+
License terms for using Eclipse ThreadX are defined in the LICENSE.txt file of this repo. Please refer to this file for all definitive licensing information.
211211

212212
## Resources
213213

214214
The following are references to additional ThreadX RTOS resources:
215215

216-
- **Product introduction and white papers**: https://azure.com/rtos
217-
- **General technical questions**: https://aka.ms/QnA/azure-rtos
216+
- **Product introduction**: https://github.com/eclipse-threadx/rtos-docs
218217
- **Product issues and bugs, or feature requests**: https://github.com/eclipse-threadx/threadx/issues
219-
- **Licensing and sales questions**: https://aka.ms/azrtos-license
220-
- **Product roadmap and support policy**: https://aka.ms/azrtos/lts
221-
- **Blogs and videos**: http://msiotblog.com and https://aka.ms/iotshow
222-
- **Azure RTOS TraceX Installer**: https://aka.ms/azrtos-tracex-installer
218+
- **TraceX Installer**: https://aka.ms/azrtos-tracex-installer
223219

224220
You can also check [previous questions](https://stackoverflow.com/questions/tagged/threadx-rtos+threadx) or ask new ones on StackOverflow using the `threadx-rtos` and `threadx` tags.
225221

226222
## Security
227223

228-
ThreadX RTOS provides OEMs with components to secure communication and to create code and data isolation using underlying MCU/MPU hardware protection mechanisms. It is ultimately the responsibility of the device builder to ensure the device fully meets the evolving security requirements associated with its specific use case.
224+
Eclipse ThreadX provides OEMs with components to secure communication and to create code and data isolation using underlying MCU/MPU hardware protection mechanisms. It is ultimately the responsibility of the device builder to ensure the device fully meets the evolving security requirements associated with its specific use case.
229225

230226
## Contribution
231227

docs/threadx-features.png

40.5 KB
Loading

ports/arc_em/metaware/example_build/sample_threadx/tx_initialize_low_level.s

+9-10
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,12 @@
1-
;/**************************************************************************/
2-
;/* */
3-
;/* Copyright (c) 2024 Microsoft Corporation. */
4-
;/* */
5-
;/* This software is licensed under the Microsoft Software License */
6-
;/* Terms for Microsoft Azure RTOS. Full text of the license can be */
7-
;/* found in the LICENSE file at https://aka.ms/AzureRTOS_EULA */
8-
;/* and in the root directory of this software. */
9-
;/* */
10-
;/**************************************************************************/
1+
;/***************************************************************************
2+
; * Copyright (c) 2024 Microsoft Corporation
3+
; *
4+
; * This program and the accompanying materials are made available under the
5+
; * terms of the MIT License which is available at
6+
; * https://opensource.org/licenses/MIT.
7+
; *
8+
; * SPDX-License-Identifier: MIT
9+
; **************************************************************************/
1110

1211
;/**************************************************************************/
1312
;/**************************************************************************/

ports/arc_em/metaware/src/tx_thread_context_restore.s

+9-10
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,12 @@
1-
;/**************************************************************************/
2-
;/* */
3-
;/* Copyright (c) 2024 Microsoft Corporation. */
4-
;/* */
5-
;/* This software is licensed under the Microsoft Software License */
6-
;/* Terms for Microsoft Azure RTOS. Full text of the license can be */
7-
;/* found in the LICENSE file at https://aka.ms/AzureRTOS_EULA */
8-
;/* and in the root directory of this software. */
9-
;/* */
10-
;/**************************************************************************/
1+
;/***************************************************************************
2+
; * Copyright (c) 2024 Microsoft Corporation
3+
; *
4+
; * This program and the accompanying materials are made available under the
5+
; * terms of the MIT License which is available at
6+
; * https://opensource.org/licenses/MIT.
7+
; *
8+
; * SPDX-License-Identifier: MIT
9+
; **************************************************************************/
1110

1211
;/**************************************************************************/
1312
;/**************************************************************************/

ports/arc_em/metaware/src/tx_thread_context_save.s

+9-10
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,12 @@
1-
;/**************************************************************************/
2-
;/* */
3-
;/* Copyright (c) 2024 Microsoft Corporation. */
4-
;/* */
5-
;/* This software is licensed under the Microsoft Software License */
6-
;/* Terms for Microsoft Azure RTOS. Full text of the license can be */
7-
;/* found in the LICENSE file at https://aka.ms/AzureRTOS_EULA */
8-
;/* and in the root directory of this software. */
9-
;/* */
10-
;/**************************************************************************/
1+
;/***************************************************************************
2+
; * Copyright (c) 2024 Microsoft Corporation
3+
; *
4+
; * This program and the accompanying materials are made available under the
5+
; * terms of the MIT License which is available at
6+
; * https://opensource.org/licenses/MIT.
7+
; *
8+
; * SPDX-License-Identifier: MIT
9+
; **************************************************************************/
1110

1211
;/**************************************************************************/
1312
;/**************************************************************************/

ports/arc_em/metaware/src/tx_thread_interrupt_control.s

+9-10
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,12 @@
1-
;/**************************************************************************/
2-
;/* */
3-
;/* Copyright (c) 2024 Microsoft Corporation. */
4-
;/* */
5-
;/* This software is licensed under the Microsoft Software License */
6-
;/* Terms for Microsoft Azure RTOS. Full text of the license can be */
7-
;/* found in the LICENSE file at https://aka.ms/AzureRTOS_EULA */
8-
;/* and in the root directory of this software. */
9-
;/* */
10-
;/**************************************************************************/
1+
;/***************************************************************************
2+
; * Copyright (c) 2024 Microsoft Corporation
3+
; *
4+
; * This program and the accompanying materials are made available under the
5+
; * terms of the MIT License which is available at
6+
; * https://opensource.org/licenses/MIT.
7+
; *
8+
; * SPDX-License-Identifier: MIT
9+
; **************************************************************************/
1110

1211
;/**************************************************************************/
1312
;/**************************************************************************/

ports/arc_em/metaware/src/tx_thread_schedule.s

+9-10
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,12 @@
1-
;/**************************************************************************/
2-
;/* */
3-
;/* Copyright (c) 2024 Microsoft Corporation. */
4-
;/* */
5-
;/* This software is licensed under the Microsoft Software License */
6-
;/* Terms for Microsoft Azure RTOS. Full text of the license can be */
7-
;/* found in the LICENSE file at https://aka.ms/AzureRTOS_EULA */
8-
;/* and in the root directory of this software. */
9-
;/* */
10-
;/**************************************************************************/
1+
;/***************************************************************************
2+
; * Copyright (c) 2024 Microsoft Corporation
3+
; *
4+
; * This program and the accompanying materials are made available under the
5+
; * terms of the MIT License which is available at
6+
; * https://opensource.org/licenses/MIT.
7+
; *
8+
; * SPDX-License-Identifier: MIT
9+
; **************************************************************************/
1110

1211
;/**************************************************************************/
1312
;/**************************************************************************/

ports/arc_em/metaware/src/tx_thread_stack_build.s

+9-10
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,12 @@
1-
;/**************************************************************************/
2-
;/* */
3-
;/* Copyright (c) 2024 Microsoft Corporation. */
4-
;/* */
5-
;/* This software is licensed under the Microsoft Software License */
6-
;/* Terms for Microsoft Azure RTOS. Full text of the license can be */
7-
;/* found in the LICENSE file at https://aka.ms/AzureRTOS_EULA */
8-
;/* and in the root directory of this software. */
9-
;/* */
10-
;/**************************************************************************/
1+
;/***************************************************************************
2+
; * Copyright (c) 2024 Microsoft Corporation
3+
; *
4+
; * This program and the accompanying materials are made available under the
5+
; * terms of the MIT License which is available at
6+
; * https://opensource.org/licenses/MIT.
7+
; *
8+
; * SPDX-License-Identifier: MIT
9+
; **************************************************************************/
1110

1211
;/**************************************************************************/
1312
;/**************************************************************************/

ports/arc_em/metaware/src/tx_thread_system_return.s

+9-10
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,12 @@
1-
;/**************************************************************************/
2-
;/* */
3-
;/* Copyright (c) 2024 Microsoft Corporation. */
4-
;/* */
5-
;/* This software is licensed under the Microsoft Software License */
6-
;/* Terms for Microsoft Azure RTOS. Full text of the license can be */
7-
;/* found in the LICENSE file at https://aka.ms/AzureRTOS_EULA */
8-
;/* and in the root directory of this software. */
9-
;/* */
10-
;/**************************************************************************/
1+
;/***************************************************************************
2+
; * Copyright (c) 2024 Microsoft Corporation
3+
; *
4+
; * This program and the accompanying materials are made available under the
5+
; * terms of the MIT License which is available at
6+
; * https://opensource.org/licenses/MIT.
7+
; *
8+
; * SPDX-License-Identifier: MIT
9+
; **************************************************************************/
1110

1211
;/**************************************************************************/
1312
;/**************************************************************************/

ports/arc_em/metaware/src/tx_timer_interrupt.s

+9-10
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,12 @@
1-
;/**************************************************************************/
2-
;/* */
3-
;/* Copyright (c) 2024 Microsoft Corporation. */
4-
;/* */
5-
;/* This software is licensed under the Microsoft Software License */
6-
;/* Terms for Microsoft Azure RTOS. Full text of the license can be */
7-
;/* found in the LICENSE file at https://aka.ms/AzureRTOS_EULA */
8-
;/* and in the root directory of this software. */
9-
;/* */
10-
;/**************************************************************************/
1+
;/***************************************************************************
2+
; * Copyright (c) 2024 Microsoft Corporation
3+
; *
4+
; * This program and the accompanying materials are made available under the
5+
; * terms of the MIT License which is available at
6+
; * https://opensource.org/licenses/MIT.
7+
; *
8+
; * SPDX-License-Identifier: MIT
9+
; **************************************************************************/
1110

1211
;/**************************************************************************/
1312
;/**************************************************************************/

ports/arc_hs/metaware/example_build/sample_threadx/tx_initialize_low_level.s

+9-10
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,12 @@
1-
;/**************************************************************************/
2-
;/* */
3-
;/* Copyright (c) 2024 Microsoft Corporation. */
4-
;/* */
5-
;/* This software is licensed under the Microsoft Software License */
6-
;/* Terms for Microsoft Azure RTOS. Full text of the license can be */
7-
;/* found in the LICENSE file at https://aka.ms/AzureRTOS_EULA */
8-
;/* and in the root directory of this software. */
9-
;/* */
10-
;/**************************************************************************/
1+
;/***************************************************************************
2+
; * Copyright (c) 2024 Microsoft Corporation
3+
; *
4+
; * This program and the accompanying materials are made available under the
5+
; * terms of the MIT License which is available at
6+
; * https://opensource.org/licenses/MIT.
7+
; *
8+
; * SPDX-License-Identifier: MIT
9+
; **************************************************************************/
1110

1211
;/**************************************************************************/
1312
;/**************************************************************************/

0 commit comments

Comments
 (0)