2 Microchip MPLAB® Harmony 3 Release Notes
Harmony Azure_RTOS Release v1.1.0 (August, 2023)
UPDATES FOR 1.1.0:
This release updates the networking applications that are now generated using MCC and the latest Harmony 3 repos.
The following table provides the list of the updated applications included in the release:
| Application | Platform | Description |
|---|---|---|
| azure_iot_demo_ethernet | SAME54 | Azure IoT hub connection example using an Ethernet connection |
| tcp_echo_server_ethernet | SAME54 | NetX Duo TCP server example using an Ethernet connection |
Software Dependencies
Before using Harmony Azure_RTOS, ensure that the following are installed:
- MPLAB® X IDE v6.10 or later
- MPLAB® XC32 C/C++ Compiler v4.20 or later
In order to regenerate source code for any of the applications, you will also need to use the following versions of the dependent modules (see azure_rtos/package.xml):
- Harmony core repository, v3.13.1
- Harmony bsp repository, v3.16.0
- Harmony csp repository, v3.17.0
- Harmony dev_packs repository, v3.17.0
- Harmony net repository, v3.10.1
- Microsoft ThreadX repository, v6.2.1_rel)
- Microsoft azure-sdk-for-c, 1.0.0
- Microsoft NetX Duo, v6.1.8_rel
- Microsoft FileX, v6.2.1_rel
- MPLAB Code Configurator (MCC), 5.3.7 or later
Development Kit Support
| Development kits |
|---|
| SAM E54 Xplained Pro Evaluation Kit |
Known Issues
The latest version of the netxduo package (v6.2.1_rel) results in build failures. The netxduo v6.1.8_rel has been used.
Harmony Azure_RTOS Release v1.0.0 (September, 2021)
ADDITIONS AND UPDATES FOR 1.0.0:
- New Microsoft Azure-RTOS support -This beta release introduces initial support for Azure-RTOS a Microsoft RTOS for connecting deeply embedded IoT devices.
- New part support -This release introduces initial Azure RTOS ThreadX support for Cortex-A7 family of 32-bit MPUs.
- New Applications
The following table provides the list of the new applications included in the release:
Application Platform Description azure_iot_demo_ethernet SAME54 Azure IoT hub connection example using an Ethernet connection azure_iot_demo_wifi SAME54 Azure IoT hub connection example using a Wi-Fi connection tcp_echo_server_ethernet SAME54 NetX Duo TCP server example using an Ethernet connection tcp_echo_server_wifi SAME54 NetX Duo TCP server example using a Wi-Fi connection - Updated Applications
The following table provides the list of the updated applications:
Application Platform Description basic_threadx SAMA7G5 Basic ThreadX demo showing threads and status
Software Dependencies
Before using MPLAB Harmony Net, ensure that the following are installed:
- MPLAB® X IDE v5.45 or later
- MPLAB® XC32 C/C++ Compiler v2.50 or later
In order to regenerate source code for any of the applications, you will also need to use the following versions of the dependent modules (see azure_rtos/package.xml):
- Harmony core repository, 3.9.2
- Harmony bsp repository, 3.9.0
- Harmony csp repository, 3.9.1
- Harmony dev_packs repository, 3.9.0
- Harmony net repository, v3.7.3
- Microsoft ThreadX repository, v6.1.8_rel
- Microsoft azure-sdk-for-c, 1.0.0
- Microsoft NetX Duo, v6.1.7_rel
- Microsoft FileX, v6.1.7_rel
- MPLAB Harmony Configurator (MHC) v.3.8.0 or later
- MPLAB® Harmony Configurator (MHC) plug-in, v3.6.3 or later
Development Kit Support
Known Issues
This is a beta release. The current known issues are as follows:
- The demo project builds fine with MPLABX IDE 5.45. There is a known issue with MPLABX5.5 that cause build errors. This issue will be fixed in future MPLAB X releases. If you are working with MPLAB X IDE 5.5, please follow the instructions as short-term workaround.
- Update SAME54_DFP to the latest from MPLAB X IDE -> Tools -> Packs. (At the time of writing this instruction, latest version is 3.6.99).
- Copy "SAME54_DFP" directory from 'C:\Program Files\Microchip\MPLABX\v5.50\packs\Microchip' to 'C:'
- Open Azure demo project in MPLAB X. Go to project properties.
- Select XC32 (Global Options) -> Override default device support -> set as 'Compiler Location'.
- At XC32 (Global Options) ->Additional options ->set the following
option:
-mdfp=C:/SAME54_DFP/x.x.xx -I "C:/Program Files/Microchip/MPLABX/v5.50/packs/arm/CMSIS/5.4.0/CMSIS/Core/Include"
For example, if SAME54 DFP is 3.6.99, the option is:
-mdfp=C:/SAME54_DFP/3.6.99 -I "C:/Program Files/Microchip/MPLABX/v5.50/packs/arm/CMSIS/5.4.0/CMSIS/Core/Include"
- Click 'Apply' and 'OK'. Then build the project.
- The demo project builds fine with XC32 v2.50. Using XC32 v3.1 can cause run time errors. This issue will be fixed in future MPLAB X releases.
Release Contents
This topic lists the contents of this release and identifies each module.
This table lists the contents of this release, including a brief description, and the release type (Alpha, Beta, Production, or Vendor).
| Folder | Description | Release Type |
|---|---|---|
| azure_rtos/apps/iot/azure_iot_demo_ethernet | Azure IoT hub connection over Ethernet | Beta |
| azure_rtos/apps/iot/azure_iot_demo_wifi | Azure IoT hub connection over Wi-Fi | Beta |
| azure_rtos/apps/netxduo/tcp_echo_server_ethernet | TCP server example over Ethernet | Beta |
| azure_rtos/apps/netxduo/tcp_echo_server_wifi | TCP server example over Wi-Fi | Beta |
| azure_rtos/apps/threadx/basic_threadx | Basic ThreadX demo showing threads and status | Beta |