RTOS Demonstrations. MPLAB Harmony Integrated Software Framework. Copyright (c) Microchip Technology Inc. All rights reserved.

Transcription

1 RTOS Demonstrations MPLAB Harmony Integrated Software Framework Copyright (c) Microchip Technology Inc. All rights reserved.

2 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: 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 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. Important! The Micriµm µc/os-ii and µc/os-iii source code that is distributed with MPLAB Harmony is for FREE 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 ( 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: 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: Express Logic ThreadX Demonstrations This section provides descriptions of the Express Logic ThreadX RTOS demonstrations Microchip Technology Inc. MPLAB Harmony v

3 RTOS Demonstrations Express Logic ThreadX Demonstrations usb basic 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: 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. ThreadX Basic Demonstration. To build this project, you must open the basic_threadx.x project in MPLAB X IDE, and then select the desired configuration. <install-dir>/apps/rtos/threadx/basic. Project basic_threadx.x <install-dir>/apps/rtos/threadx/basic 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, pic32mx_eth_sk, and pic32mx_eth_sk2 This configuration runs on PIC32MX-based starter kits: PIC32 Ethernet Starter Kit, PIC32 Ethernet Starter Kit II, PIC32 USB Starter Kit II, PIC32 USB Starter Kit III. usb Microchip Technology Inc. MPLAB Harmony v

4 RTOS Demonstrations FreeRTOS Demonstrations basic 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: 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. Express Logic ThreadX and MPLAB Harmony Graphics plus USB Library Demonstration. To build this project, you must open the usb_threadx.x project in MPLAB X IDE, and then select the desired configuration. <install-dir>/apps/rtos/threadx/usb. Project usb_threadx.x <install-dir>/apps/rtos/threadx/usb 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 The demonstration blinks the three user LEDs on a starter kit to show the RTOS threads that are running and to indicate status. FreeRTOS Basic Demonstration. To build this project, you must open the basic_freertos.x project in MPLAB X IDE, and then select the desired configuration Microchip Technology Inc. MPLAB Harmony v

5 RTOS Demonstrations FreeRTOS Demonstrations cdc_com_port_dual <install-dir>/apps/rtos/freertos. Project basic_freertos.x <install-dir>/apps/rtos/freertos/basic BSP(s) Used pic32mx_sk pic32mx_usb_sk2, pic32mx_usb_sk3, pic32mx_eth_sk, and pic32mx_eth_sk2 pic32mx_sk_mips16 pic32mx_usb_sk2, pic32mx_usb_sk3, pic32mx_eth_sk, and pic32mx_eth_sk2 This configuration runs on PIC32MX-based starter kits: PIC32 Ethernet Starter Kit, PIC32 Ethernet Starter Kit II, PIC32 USB Starter Kit II, PIC32 USB Starter Kit III. This configuration runs on PIC32MX-based starter kits in MIPS16 mode: PIC32 Ethernet Starter Kit, PIC32 Ethernet Starter Kit II, PIC32 USB Starter Kit II, PIC32 USB Starter Kit III. pic32mz_sk pic32mz_ec_sk This configuration runs on the PIC32MZ EC Starter Kit. 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. cdc_com_port_dual This RTOS based demonstration application creates a USB CDC Device that enumerates as two serial ports on the USB Host personal computer. This application demonstrates the ability of the MPLAB Harmony USB Stack to operate in an Real-Time Operating System (this example uses FreeRTOS) and to support multiple instances of the same device class. This section identifies the MPLAB X IDE project name and location and lists and describes the available configurations for this demonstration application. To build this project, you must open the cdc_com_port_dual.x project in MPLAB X IDE, and then select the desired configuration. <install-dir>/apps/rtos/freertos/cdc_com_port_dual Microchip Technology Inc. MPLAB Harmony v

6 RTOS Demonstrations FreeRTOS Demonstrations tcpip_client_server Project cdc_com_port_dual.x <install-dir>/apps/rtos/freertos/cdc_com_port_dual/firmware./firmware/src/system_config. pic32mx_usb_sk2_int_dyn pic32mx_usb_sk2 Select this configuration to run the demonstration application on the PIC32 USB Starter Kit II in Interrupt mode and dynamic operation. pic32mz_ef_sk_int_dyn pic32mz_ef_sk Select this configuration to run the demonstration application on the PIC32MZ Embedded Connectivity with Floating Point Unit (EF) Starter Kit in Interrupt mode and dynamic operation. cdc_msd_basic This section identifies the MPLAB X IDE project name and location and lists and describes the available configurations for this demonstration application. To build this project, you must open the cdc_msd_basic.x project in MPLAB X IDE, and then select the desired configuration. <install-dir>/apps/rtos/freertos/cdc_msd_basic. Project cdc_msd_basic.x <install-dir>/apps/rtos/freertos/cdc_msd_basic/firmware./firmware/src/system_config. pic32mx_usb_sk2_int_dyn pic32mx_usb_sk2 Select this configuration to run the demonstration application on the PIC32 USB Starter Kit II in Interrupt mode and dynamic operation. pic32mz_ec_sk_int_dyn pic32mz_ec_sk Select this MPLAB X IDE project configuration to run the demonstration on the PIC32MZ Embedded Connectivity (EC) Starter Kit configured for Interrupt mode and dynamic operation Microchip Technology Inc. MPLAB Harmony v

7 RTOS Demonstrations Micrium uc_os_ii Demonstrations basic tcpip_client_server The TCP/IP Client Server application, tcpip_client_server, demonstrates how to run multiple TCP and UDP servers and clients using the TCP/IP Stack in an RTOS environment. The demonstration also has the HTTP Web server running using the Non-Volatile Memory (NVM) Microchip Proprietary File System (MPFS) to store the web pages in the internal PIC32 Flash. FreeRTOS and MPLAB Harmony TCP/IP Demonstration. To build this project, you must open the tcpip_client_server.x project in MPLAB X IDE, and then select the desired configuration. <install-dir>/apps/rtos/freertos. Project tcpip_client_server.x <install-dir>/apps/rtos/freertos/tcpip_client_server/firmware./firmware/src/system_config. Project Configuration pic32mz_ef_sk pic32mz_ef_sk This configuration runs on the PIC32MZ EF Starter Kit and the Starter Kit I/O Expansion Board. pic32mx_eth_sk pic32mx_eth_sk This configuration runs on the PIC32 Ethernet Starter Kit and the Starter Kit I/O Expansion Board. Micrium uc_os_ii Demonstrations This section provides descriptions of the Micriµm µc/os-ii RTOS demonstrations. basic The demonstration blinks a user LED on a starter kit to show the RTOS threads that are running and to indicate status. Legal Disclaimer The source code for this demonstration is not freely distributed. To obtain the proper licensing agreement go to the Micriµm Microchip Technology Inc. MPLAB Harmony v

8 RTOS Demonstrations Micrium uc/os-iii Demonstrations basic website: The Micriµm µc/os-ii source has been installed in the following location, <install_dir>/third_party/rtos/micriumosii/software, so that the applicable MPLAB Harmony demonstrations can work. Micriµm µc/os-ii Basic Demonstration. To build this project, you must open the basic_ucos_ii.x project in MPLAB X IDE, and then select the desired configuration. <install-dir>/apps/rtos/uc_os_ii. Project basic_ucos_ii.x <install-dir>/apps/rtos/uc_os_ii/basic pic32mx_sk pic32mx_usb_sk2 This configuration runs on the PIC32 USB Starter Kit II. pic32mz_sk pic32mz_ec_sk This configuration runs on the PIC32MZ EC Starter Kit. 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. Micrium uc/os-iii Demonstrations This section provides descriptions of the Micriµm µc/os-iii RTOS demonstrations. basic The demonstration blinks a user LED on a starter kit to show the RTOS threads that are running and to indicate status. Legal Disclaimer The source code for this demonstration is not freely distributed. To obtain the proper licensing agreement go to the Micriµm website: The Micriµm µc/os-iii source has been installed in the following location, <install_dir>/third_party/rtos/micriumosiii/software, so that the applicable MPLAB Harmony demonstrations can work Microchip Technology Inc. MPLAB Harmony v

9 RTOS Demonstrations Micrium uc/os-iii Demonstrations usb Micriµm µc/os-iii Basic Demonstration. To build this project, you must open the basic_ucos_iii.x project in MPLAB X IDE, and then select the desired configuration. <install-dir>/apps/rtos/uc_os_iii. Project basic_ucos_iii.x <install-dir>/apps/rtos/uc_os_iii/basic pic32mx_sk pic32mx_usb_sk2 This configuration runs on the PIC32 USB Starter Kit II. pic32mz_sk pic32mz_ec_sk This configuration runs on the PIC32MZ EC Starter Kit. pic32mz_ef_sk pic32mz_ef_sk This configuration runs on the PIC32MZ EF Starter Kit. pic32mx_sk_mips16 pic32mx_usb_sk2 This configuration runs on the PIC32 USB Starter Kit II in MIPS16 mode. pic32mz_ef_sk_micromips pic32mz_ef_sk This configuration runs on the PIC32MZ EF Starter Kit in micromips mode usb Legal Disclaimer The source code for this demonstration is not freely distributed. To obtain the proper licensing agreement go to the Micriµm website: The Micriµm µc/os-iii source has been installed in the following location, <install_dir>/third_party/rtos/micriumosiii/software, so that the applicable MPLAB Harmony demonstrations can work. Micriµm µc/os-iii and MPLAB Harmony Graphics plus USB Library Demonstration. To build this project, you must open the usb_ucos_iii.x project in MPLAB X IDE, and then select the desired configuration Microchip Technology Inc. MPLAB Harmony v

10 RTOS Demonstrations OPENRTOS Demonstrations basic <install-dir>/apps/rtos/uc_os_iii/usb. Project usb_ucos_iii.x <install-dir>/apps/rtos/uc_os_iii/usb 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. OPENRTOS Demonstrations This section provides descriptions of the OPENRTOS RTOS demonstrations. basic The demonstration blinks the three user LEDs on a starter kit to show the RTOS threads that are running and to indicate status. OPENRTOS Basic Demonstration. To build this project, you must open the basic_openrtos.x project in MPLAB X IDE, and then select the desired configuration. <install-dir>/apps/rtos/openrtos/basic. Project basic_openrtos.x <install-dir>/apps/rtos/openrtos/basic./firmware/src/system_config. Project Configuration pic32mz_sk pic32mz_ec_sk This configuration runs on the PIC32MZ EC Starter Kit Microchip Technology Inc. MPLAB Harmony v

11 RTOS Demonstrations OPENRTOS Demonstrations cdc_msd_basic pic32mx_sk pic32mx_usb_sk2, pic32mx_usb_sk3, pic32mx_eth_sk, and pic32mx_eth_sk2 This configuration runs on PIC32MX-based starter kits: PIC32 Ethernet Starter Kit, PIC32 Ethernet Starter Kit II, PIC32 USB Starter Kit II, and PIC32 USB Starter Kit III. cdc_com_port_dual This RTOS based demonstration application creates a USB CDC Device that enumerates as two serial ports on the USB Host personal computer. This application demonstrates the ability of the MPLAB Harmony USB Stack to operate in an Real-Time Operating System (this example uses OPENRTOS) and to support multiple instances of the same device class. This section identifies the MPLAB X IDE project name and location and lists and describes the available configurations for this demonstration application. To build this project, you must open the cdc_com_port_dual.x project in MPLAB X IDE, and then select the desired configuration. <install-dir>/apps/rtos/openrtos/cdc_com_port_dual. Project cdc_com_port_dual.x <install-dir>/apps/rtos/openrtos/cdc_com_port_dual/firmware./firmware/src/system_config. pic32mx_usb_sk2_int_dyn pic32mx_usb_sk2 Select this configuration to run the demonstration application on the PIC32 USB Starter Kit II in Interrupt mode and dynamic operation. pic32mz_ef_sk_int_dyn pic32mz_ef_sk Select this configuration to run the demonstration application on the PIC32MZ Embedded Connectivity with Floating Point Unit (EF) Starter Kit in Interrupt mode and dynamic operation. cdc_msd_basic Demonstrates host support for a composite USB Device in a RTOS application. This demonstration application creates a USB Host application that demonstrates operation of composite USB Device. The Host application enumerates the CDC and MSD interfaces on the attached composite devices and then operates these in one application. The demonstration application uses a RTOS to create thread that manage the CDC and MSD aspects of the Host application Microchip Technology Inc. MPLAB Harmony v

12 RTOS Demonstrations SEGGER embos Demonstrations basic This section identifies the MPLAB X IDE project name and location and lists and describes the available configurations for this demonstration application. To build this project, you must open the cdc_msd_basic.x project in MPLAB X IDE, and then select the desired configuration. <install-dir>/apps/rtos/openrtos/cdc_msd_basic. Project cdc_msd_basic.x <install-dir>/apps/rtos/openrtos/cdc_msd_basic/firmware./firmware/src/system_config. pic32mx_usb_sk2_int_dyn pic32mx_usb_sk2 Select this configuration to run the demonstration application on the PIC32 USB Starter Kit II in Interrupt mode and dynamic operation. SEGGER embos Demonstrations This section provides descriptions of the SEGGER embos RTOS demonstrations. basic The demonstration blinks the LED1 on a starter kit to show the RTOS threads are running and to indicate status. Legal Disclaimer The source code for this SEGGER embos RTOS demonstration is not freely distributed. To obtain source code and the proper licensing agreement visit the SEGGER embos website: SEGGER embos Basic Demonstration. To build this project, you must open the basic_embos.x project in MPLAB X IDE, and then select the desired configuration. <install-dir>/apps/rtos/embos/basic. Note: The floating point options used may depend on the libraries shared by SEGGER. The default libraries shared with MPLAB Harmony uses the soft floating point (mfloat-abi=softfp) option Microchip Technology Inc. MPLAB Harmony v

13 RTOS Demonstrations SEGGER embos Demonstrations usb Project basic_embos.x <install-dir>/apps/rtos/embos/basic/firmware pic32mx_usb_sk2 pic32mx_usb_sk2 This configuration runs on the PIC32 USB Starter Kit II. pic32mx_usb_sk2_mips16 pic32mx_usb_sk2 This configuration runs on the PIC32 USB Starter Kit II in MIPS16 mode. 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. usb Legal Disclaimer The source code for this SEGGER embos RTOS demonstration is not freely distributed. To obtain source code and the proper licensing agreement visit the SEGGER embos website: SEGGER embos and MPLAB Harmony Graphics plus USB Library Demonstration. To build this project, you must open the usb_embos.x project in MPLAB X IDE, and then select the desired configuration. <install-dir>/apps/rtos/embos/usb. Project usb_embos.x <install-dir>/apps/rtos/embos/usb/firmware pic32mz_ef_sk pic32mz_ef_sk This configuration runs on the PIC32MZ EF Starter Kit Microchip Technology Inc. MPLAB Harmony v

14 RTOS Demonstrations SEGGER embos Demonstrations usb pic32mx_usb_sk2 pic32mx_usb_sk2 This configuration runs on the PIC32 USB Starter Kit II Microchip Technology Inc. MPLAB Harmony v

15 Index Index B basic 3, 4, 7, 8, 10, 12 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13 C cdc_com_port_dual 5, 11 cdc_msd_basic 6, 11 E Express Logic ThreadX Demonstrations 2 F FreeRTOS Demonstrations 4 I Introduction 2 M Micrium uc/os-iii Demonstrations 8 Micrium uc_os_ii Demonstrations 7 O OPENRTOS Demonstrations 10 R RTOS Demonstrations 2 S SEGGER embos Demonstrations 12 T tcpip_client_server 7 U usb 3, 9, Microchip Technology Inc. MPLAB Harmony v