RTOS Demonstrations MPLAB Harmony Integrated Software Framework Copyright (c) 2013-2017 Microchip Technology Inc. All rights reserved. RTOS Demonstrations Express Logic ThreadX Demonstrations basic RTOS Demonstrations This section provides descriptions of the RTOS demonstrations. MPLAB Harmony is available for download from the Microchip website by visiting: http://www.microchip.com/mplabharmony. Once you are on the site, click the Downloads tab to access the appropriate download for your operating system. For additional information on this demonstration, refer to the “Applications Help” section in the MPLAB Harmony Help. Introduction RTOS Demonstration Applications Help Description This distribution package contains a variety of RTOS-based firmware projects that demonstrate the capabilities of the MPLAB Harmony services and stacks integrated with RTOS running on PIC32 devices. This section describes the hardware requirement and procedures to run these firmware projects on Microchip demonstration and development boards. To learn more about MPLAB Harmony stacks and libraries refer to the related documentation in Volume V: MPLAB Harmony Framework Reference. Source Code Disclaimers OPENRTOS The OPENRTOS demonstrations provided in MPLAB Harmony use the OPENRTOS evaluation license, which is meant for demonstration purposes only. Customers desiring development and production on OPENRTOS must procure a suitable license. Please refer to one of the following documents, which are located in the third-party folder of the MPLAB Harmony installation, for information on obtaining an evaluation license for your device: • OpenRTOS Click Thru Eval License PIC32MXxx.pdf • OpenRTOS Click Thru Eval License PIC32MZxx.pdf Micriµm All µC/OS-III demonstrations have added the crt0.S "C" run-time library start-up file to the project. The demonstration sets the linker option "do not link startup code". This is necessary for µC/OS-III to work correctly with PIC32 devices as the general exception vector is located in crt0.S. µC/OS-III overrides this interrupt source (general exception handler) to perform OS-specific functionality. If the user wants to implement their own application using µC/OS-III and a PIC32 device, they must add the crt0.S file to their project and override the general exception interrupt vector. See the current RTOS examples for this implementation. A crt0.S template file can be found in the MPLAB XC32 C/C++ Compiler installation directory: ..\Microchip\xc32\<version>\pic32-libs\libpic32. The Micriµm µC/OS-II and µC/OS-III source code that is distributed with MPLAB Harmony is for FREE Important! short-term evaluation, for educational use, or peaceful research. If you plan or intend to use µC/OS-II and µC/OS-III in a commercial application/product, you need to contact Micriµm to properly license µC/OS-II and µC/OS-III for its use in your application/product. The source code is provided for your convenience and to help you experience µC/OS-II and µC/OS-III. The fact the source is provided does NOT mean that you can use it commercially without paying a licensing fee. Knowledge of the source code may NOT be used to develop a similar product. If you are unsure about whether you need to obtain a license for your application, please contact Micriµm and discuss the intended use with a sales representative (www.micrium.com). Express Logic ThreadX The source code for the ThreadX RTOS is not freely distributed. To obtain source code and the proper licensing agreement go to the Express Logic ThreadX website: http://rtos.com/products/threadx/. SEGGER embOS The SEGGER embOS libraries provided with MPLAB Harmony use the SEGGER evaluation license, which is meant for demonstration purposes only. Customers desiring development must procure a suitable license from SEGGER. To obtain source code and the proper licensing agreement visit the SEGGER embOS website: https://www.segger.com/license-models.html. Express Logic ThreadX Demonstrations This section provides descriptions of the Express Logic ThreadX RTOS demonstrations. © 2013-2018 Microchip Technology Inc. MPLAB Harmony v2.05.01 2 RTOS Demonstrations Express Logic ThreadX Demonstrations usb basic This section provides information on the supported demonstration boards, how to configure the hardware (if needed), and how to run the demonstration. Description Source Code Disclaimer The source code for this ThreadX RTOS demonstration is not freely distributed. To obtain source code and the proper licensing agreement go to the Express Logic ThreadX website: http://rtos.com/products/threadx/. So that ThreadX can work with the applicable MPLAB Harmony demonstrations, install the source in the following location: <install-dir>/third_party/rtos/ThreadX/. The demonstrations will not compile unless the source code is provided and installed in the correct location. Building the Application This section identifies the MPLAB X IDE project name and location and lists and describes the available configurations for the ThreadX Basic Demonstration. Description To build this project, you must open the basic_threadx.X project in MPLAB X IDE, and then select the desired configuration. The following tables list and describe the project and supported configurations. The parent folder for these files is <install-dir>/apps/rtos/threadx/basic. MPLAB X IDE Project This table lists the name and location of the MPLAB X IDE project folder for the demonstration. Project Name Location basic_threadx.X <install-dir>/apps/rtos/threadx/basic MPLAB X IDE Project Configurations This table lists and describes the supported configurations of the demonstration, which are located within ./src/system_config. Project Configuration BSP Used Description Name pic32mz_ef_sk pic32mz_ef_sk This configuration runs on the PIC32MZ EF Starter Kit. pic32mz_ef_sk_microMIPS pic32mz_ef_sk This configuration runs on the PIC32MZ EF Starter Kit in microMIPS mode. pic32mx_sk_mips16 pic32mx_usb_sk2 This configuration runs on the PIC32 USB Starter Kit II. pic32mx_sk pic32mx_usb_sk2, pic32mx_usb_sk3, This configuration runs on PIC32MX-based starter pic32mx_eth_sk, and pic32mx_eth_sk2 kits: PIC32 Ethernet Starter Kit, PIC32 Ethernet Starter Kit II, PIC32 USB Starter Kit II, PIC32 USB Starter Kit III. usb This section provides information on the supported demonstration boards, how to configure the hardware (if needed), and how to run the demonstration. © 2013-2018 Microchip Technology Inc. MPLAB Harmony v2.05.01 3 RTOS Demonstrations FreeRTOS Demonstrations basic Description Source Code Disclaimer The source code for this ThreadX RTOS demonstration is not freely distributed. To obtain source code and the proper licensing agreement go to the Express Logic ThreadX website: http://rtos.com/products/threadx/. So that ThreadX can work with the applicable MPLAB Harmony demonstrations, install the source in the following location: <install-dir>/third_party/rtos/ThreadX/. The demonstrations will not compile unless the source code is provided and installed in the correct location. Building the Application This section identifies the MPLAB X IDE project name and location and lists and describes the available configurations for the Express Logic ThreadX and MPLAB Harmony Graphics plus USB Library Demonstration. Description To build this project, you must open the usb_threadx.X project in MPLAB X IDE, and then select the desired configuration. The following tables list and describe the project and supported configurations. The parent folder for these files is <install-dir>/apps/rtos/threadx/usb. MPLAB X IDE Project This table lists the name and location of the MPLAB X IDE project folder for the demonstration. Project Name Location usb_threadx.X <install-dir>/apps/rtos/threadx/usb MPLAB X IDE Project Configurations This table lists and describes the supported configurations of the demonstration, which are located within ./src/system_config. Project Configuration BSP Used Description Name pic32mz_ef_sk pic32mz_ef_sk This configuration runs on the PIC32MZ EF Starter Kit. pic32mx_usb_sk2 pic32mx_usb_sk2 This configuration runs on the PIC32 USB Starter Kit II. FreeRTOS Demonstrations This section provides descriptions of the FreeRTOS RTOS demonstrations. basic This section provides information on the supported demonstration boards, how to configure the hardware (if needed), and how to run the demonstration. Description The demonstration blinks the three user LEDs on a starter kit to show the RTOS threads that are running and to indicate status. Building the Application This section identifies the MPLAB X IDE project name and location and lists and describes the available configurations for the FreeRTOS Basic Demonstration. Description To build this project, you must open the basic_freertos.X project in MPLAB X IDE, and then select the desired configuration. © 2013-2018 Microchip Technology Inc. MPLAB Harmony v2.05.01 4 RTOS Demonstrations FreeRTOS Demonstrations cdc_com_port_dual The following tables list and describe the project and supported configurations. The parent folder for these files is <install-dir>/apps/rtos/freertos. MPLAB X IDE Project This table lists the name and location of the MPLAB X IDE project folder for the demonstration. Project Name Location basic_freertos.X <install-dir>/apps/rtos/freertos/basic MPLAB X IDE Project Configurations This table lists and describes the supported configurations of the demonstration, which are located within ./src/system_config. Project Configuration BSP(s) Used Description Name pic32mx_sk pic32mx_usb_sk2, pic32mx_usb_sk3,