Link Search Menu Expand Document

Microchip MPLAB® Harmony 3 Release Notes

Reference Applications Release v1.2.0 (January 2021)

New Applications

Application Description MCU Development Board/Kit
pic32cm_mc_curiosity_getting_started Getting Started using Harmony v3 Peripheral Libraries PIC32CM MC00 PIC32CM MC Curiosity Pro Development Board
pic32cmmc_getting_started Getting Started using Harmony v3 Peripheral Libraries PIC32CM MC00 PIC32CM MC00 Curiosity Nano Evaluation Kit
pic32cmmc_temp_based_fan_control_oled_c Temperature based Fan Speed Control with OLED C click display PIC32CM MC00 PIC32CM MC00 Curiosity Nano Evaluation Kit
getting_started_drivers_middleware Getting Started with Drivers and Middleware SAM E70 SAM E70 Xplained Evaluation Kit
same54c_getting_started Getting Started using Harmony v3 Peripheral Libraries SAM E54 SAM E54 Curiosity Ultra Development Board
samd21_getting_started_freertos Getting Started with Harmony v3 Drivers using FreeRTOS SAM D21 SAM D21 Xplained Pro Evaluation Kit
same51n_low_power_with_oled_c_click Low Power Application with OLED C Click SAME 51 SAM E51 Curiosity Nano Evaluation Kit

Updated Applications

Application Description MCU Development Board/Kit Comment
snake_game Snake Game PIC32MZ EF Curiosity PIC32MZ EF 2.0 Development Board Fixed image view issue in documentation
ack_bootloader Amazon Alexa Connect Kit (ACK) OTA Bootloader SAM D21 SAM D21 Curiosity Nano Evaluation Kit Updated to support ACK SDK v3.2
ack_helloworld Amazon Alexa Connect Kit (ACK) Hello World SAM D21 SAM D21 Curiosity Nano Evaluation Kit Updated to support ACK SDK v3.2
ack_microwave Amazon Alexa Connect Kit (ACK) Microwave SAM D21 SAM D21 Curiosity Nano Evaluation Kit Updated to support ACK SDK v3.2
ack_smartlight Amazon Alexa Connect Kit (ACK) SmartLight SAM D21 SAM D21 Curiosity Nano Evaluation Kit Updated to support ACK SDK v3.2
ack_dashreplenishment Amazon Alexa Connect Kit (ACK) DashReplenishment SAM D21 SAM D21 Curiosity Nano Evaluation Kit Updated to support ACK SDK v3.2
google_cloud_iot_core Google Cloud IoT Core SAM D21 SAM-IoT WG Development Board Update demo to support 32 character length password and SSID to support single space character
snake_game Snake Game PIC32MZ EF Curiosity PIC32MZ EF 2.0 Development Board Fixed image view issue in documentation
sdadc_conversion_interrupt SDADC Conversion Interrupt Mode SAM C21N SAM C21N Xplained Pro Evaluation Kit Updated documentation with reference application note link
sdadc_conversion_polling SDADC Conversion Polling Mode SAM C21N SAM C21N Xplained Pro Evaluation Kit Updated documentation with reference application note link

Known Issues

  1. The application “sam_d21_iot/google_cloud_iot_core” is developed by applying a patch (available in folder “google_cloud_iot_core/firmware/app_patch”) to MPLAB Harmony v3. If you need to reconfigure or regenerate this demo using MHC, please refer the “Notes.txt” file under “google_cloud_iot_core/firmware/app_patch” folder.
    The patch is applied due to a known issue in the application. This issue is expected to be fixed in a future release of “reference_apps” repository.
  2. The application “pic32mz_ef_curiosity_v2/wifi_rgb_easy_configuration” is developed by applying a patch (available in folder “wifi_rgb_easy_configuration/firmware/wifi_repo_patch”) to MPLAB Harmony v3. If you need to reconfigure or regenerate this demo using MHC, please refer the “Notes.txt” file under “wifi_rgb_easy_configuration/firmware/wifi_repo_patch” folder. The patch is applied due to a known issue in “wireless” repo. This issue is expected to be fixed in a future release of “wireless” repo.
  3. The application demo “pic32mz_ef_sk_meb2/audio_player/audio_player_lab5” is developed using Aria Graphics library. From gfx v3.9.0 onwards Aria Graphics support is deprecated and archived in a separate gfx_aria v3.7.1 repo. If you wish to regenerate this demo, follow the notes mentioned in “Software/Tools Used” section in readme for audio_player_lab5.

Development Tools

  • Refer demo specific documentation in folder “docs” to know the tools and Harmony 3 packages used.

Reference Applications Release v1.1.0 (September 2020)

New Applications

Application Description MCU Development Board/Kit
google_cloud_iot_core Google Cloud IoT Core SAM D21 SAM-IoT WG Development Board
same51n_getting_started Getting Started using Harmony v3 Peripheral Libraries SAME 51 SAM E51 Curiosity Nano Evaluation Kit
ble_fitness_tracker BLE Fitness Tracker SAME 51 SAM E51 Curiosity Nano Evaluation Kit
pic32mzda_getting_started Getting Started using Harmony v3 Peripheral Libraries PIC32MZ DA Curiosity PIC32MZ DA Development Board
pic32mzda_sdcard_usb_audio_player SD Card USB Audio Player PIC32MZ DA Curiosity PIC32MZ DA Development Board
ack_bootloader Amazon Alexa Connect Kit (ACK) OTA Bootloader SAM D21 SAM D21 Curiosity Nano Evaluation Kit
ack_helloworld Amazon Alexa Connect Kit (ACK) Hello World SAM D21 SAM D21 Curiosity Nano Evaluation Kit
ack_microwave Amazon Alexa Connect Kit (ACK) Microwave SAM D21 SAM D21 Curiosity Nano Evaluation Kit
ack_smartlight Amazon Alexa Connect Kit (ACK) SmartLight SAM D21 SAM D21 Curiosity Nano Evaluation Kit
ack_dashreplenishment Amazon Alexa Connect Kit (ACK) DashReplenishment SAM D21 SAM D21 Curiosity Nano Evaluation Kit
pic18f_to_samd21_migration Application migration from 8-bit PIC18F to 32-bit SAM D21 SAMD 21 SAM D21 Curiosity Nano Evaluation Kit
atmega4809_to_samd21_migration Application migration from 8-bit PIC18F to 32-bit SAM D21 SAMD 21 SAM D21 Curiosity Nano Evaluation Kit
wifi_rgb_easy_configuration WiFi based RGB LED Control PIC32MZ EF Curiosity PIC32MZ EF 2.0 Development Board
snake_game Snake Game PIC32MZ EF Curiosity PIC32MZ EF 2.0 Development Board
same54_vending_machine Vending Machine SAM E54 SAM E54 Xplained Pro Evaluation Kit
same54_low_power Low Power SAM E54 SAM E54 Xplained Pro Evaluation Kit
samd21_ac_sleepwalk_singleshot_gcc AC Sleepwalking Application built with GCC Toolchain SAM D21 SAM D21 Xplained Pro Evaluation Kit
sdadc_conversion_interrupt SDADC Conversion Interrupt Mode SAM C21N SAM C21N Xplained Pro Evaluation Kit
sdadc_conversion_polling SDADC Conversion Polling Mode SAM C21N SAM C21N Xplained Pro Evaluation Kit
same54_sdcard_usb_audio_player SD Card USB Audio Player SAM E54 SAM E54 Curiosity Ultra Development Board
same54_uart_live_update Live Update SAM E54 SAM E54 Curiosity Ultra Development Board
saml11_trustzone_getting_started TrustZone Getting Started SAM L11 SAML11 Xplained Pro Evaluation Kit

Updated Applications

- NA -

Known Issues

  1. The application “sam_d21_iot/google_cloud_iot_core” is developed by applying a patch (available in folder “google_cloud_iot_core/firmware/app_patch”) to MPLAB Harmony v3. If you need to reconfigure or regenerate this demo using MHC, please refer the “Notes.txt” file under “google_cloud_iot_core/firmware/app_patch” folder.
    The patch is applied due to a known issue in the application. This issue is expected to be fixed in a future release of “reference_apps” repository.
  2. The application “sam_d21_cnano/ble_weather_station” is developed by applying a patch (available in folder “ble_weather_station/firmware/app_patch”) to MPLAB Harmony v3. If you need to reconfigure or regenerate this demo using MHC, please refer the “Notes.txt” file under “ble_weather_station/firmware/app_patch” folder.
    The patch is applied due to a known issue in “bt” repo and in the application. This issue is expected to be fixed in a future release of “reference_apps” repository and “bt” repository.
  3. The application “sam_e51_cnano/ble_weather_station” is developed by applying a patch (available in folder “ble_fitness_tracker/firmware/app_patch”) to MPLAB Harmony v3. If you need to reconfigure or regenerate this demo using MHC, please refer the “Notes.txt” file under “ble_fitness_tracker/firmware/app_patch” folder.
    The patch is applied due to a known issue in “bt” repo and in the application. This issue is expected to be fixed in a future release of “reference_apps” repository and “bt” repository.
  4. The application “pic32mz_ef_curiosity_v2/snake_game” is developed by applying a patch (available in folder “snake_game/firmware/gfx_ssd_driver_patch”) to MPLAB Harmony v3 “gfx” repository. If you need to reconfigure or regenerate this demo using MHC, please refer the “Notes.txt” file under “snake_game/firmware/gfx_ssd_driver_patch” folder. The patch is applied due to a known issue in “gfx” repo v3.7.0. This issue is expected to be fixed in a future release of “gfx” repository.
  5. The application demos “pic32mz_ef_curiosity_v2/snake_game”, “pic32mz_da_curiosity/pic32mzda_sdcard_usb_audio_player”, “sam_e54_cult/same54_sdcard_usb_audio_player” and “pic32mz_ef_sk_meb2/audio_player/audio_player_lab5” having Graphics features are developed using Graphics library “gfx” v3.7.0. These demos could version incompatibility when regenerated with a higher version of “gfx” repo. This limitation is expected to be fixed in a future release of “reference_apps” repository.

Development Tools

  • Refer demo specific documentation in folder “docs” to know the tools and Harmony 3 packages used.

Reference Applications Release v1.0.0 (June 2020)

New Applications

The following table provides the list of new applications:

Application Description MCU Development Board/Kit
samd21n_getting_started Getting Started using Harmony v3 Peripheral Libraries SAMD 21 SAM D21 Curiosity Nano Evaluation Kit
fitness_tracker Fitness Tracker using Curiosity Nano Base for click boards, Heart Rate 3 click and EINK CLICK BUNDLE SAMD 21 SAM D21 Curiosity Nano Evaluation Kit
location_sos Location Tagged SOS using Curiosity Nano Base for click boards and GSM-GPS click SAMD 21 SAM D21 Curiosity Nano Evaluation Kit
ble_weather_station BLE based Weather Station and Motion Sensor Application on SAM D21 Curiosity Nano and Nano Base for Click boards SAMD 21 SAM D21 Curiosity Nano Evaluation Kit
pic32mzef_getting_started Getting Started using Harmony v3 Peripheral Libraries PIC32MZ EF Curiosity PIC32MZ EF 2.0 Development Board
getting_started_ext Getting Started Extended using Harmony v3 Peripheral Libraries PIC32MZ EF Curiosity PIC32MZ EF 2.0 Development Board
getting_started_middleware Getting Started Application using Harmony v3 Drivers, System Services, Middleware and FreeRTOS PIC32MZ EF Curiosity PIC32MZ EF 2.0 Development Board
msd_multiple_luns USB MSD with Multiple Drives PIC32MZ EF Curiosity PIC32MZ EF 2.0 Development Board
sdcard_player SD Card Audio Player PIC32MZ EF Curiosity PIC32MZ EF 2.0 Development Board
saml10_getting_started Getting Started using Harmony v3 Peripheral Libraries SAM L10 SAM L10 Xplained Pro Evaluation Kit
saml10_low_power Low Power SAM L10 SAM L10 Xplained Pro Evaluation Kit
saml21_low_power Low Power SAM L21 SAM L21 Xplained Pro Evaluation Kit
samc21_low_power Low Power SAM C21 SAM C21 Xplained Pro Evaluation Kit
same70_getting_started Getting Started using Harmony v3 Peripheral Libraries SAM E70 SAM E70 Xplained Ultra Evaluation Kit
getting_started_drv Getting Started using Harmony v3 Drivers SAM E70 SAM E70 Xplained Ultra Evaluation Kit
getting_started_freertos Getting Started using Harmony v3 Drivers and FreeRTOS SAM E70 SAM E70 Xplained Ultra Evaluation Kit
qspi_xdmac_read_write XDMAC with QSPI SAM E70 SAM E70 Xplained Ultra Evaluation Kit
ftp_bootloader Ethernet bootloader - File Transfer Protocol SAM E70 SAM E70 Xplained Ultra Evaluation Kit
same54_getting_started Getting Started using Harmony v3 Peripheral Libraries SAM E54 SAM E54 Xplained Pro Evaluation Kit
sleepwalking SleepWalking SAM E54 SAM E54 Xplained Pro Evaluation Kit
samd21_getting_started Getting Started using Harmony v3 Peripheral Libraries SAM D21 SAM D21 Xplained Pro Evaluation Kit
samc21n_getting_started Getting Started using Harmony v3 Peripheral Libraries SAM C21N SAM C21N Xplained Pro Evaluation Kit
pic32mk_getting_started Getting Started using Harmony v3 Peripheral Libraries PIC32MK PIC32MK General Purpose (GP) Development Board
pic32mx470_getting_started Getting Started using Harmony v3 Peripheral Libraries PIC32MX Curiosity PIC32MX470 Development Board
audio_player_lab1 Audio-Tone using a Lookup Table PIC32MZ EF PIC32MZ Embedded Connectivity with FPU Starter Kit + Multimedia Expansion Board II
audio_player_lab2 Audio-Tone Application by reading the tone from a text file stored in an SD card PIC32MZ EF PIC32MZ Embedded Connectivity with FPU Starter Kit + Multimedia Expansion Board II
audio_player_lab3 SD Card Reader and Audio-Tone Application by reading the tone from a text file stored in an SD card PIC32MZ EF PIC32MZ Embedded Connectivity with FPU Starter Kit + Multimedia Expansion Board II
audio_player_lab4 SD Card Reader “.wav” Audio player PIC32MZ EF PIC32MZ Embedded Connectivity with FPU Starter Kit + Multimedia Expansion Board II
audio_player_lab5 SD Card Audio Player/Reader with Aria Graphics PIC32MZ EF PIC32MZ Embedded Connectivity with FPU Starter Kit + Multimedia Expansion Board II
pic32mz_uart_live_update Live update on PIC32MZ PIC32MZ EF PIC32MZ Embedded Connectivity with FPU Starter Kit

Updated Applications

- NA -

Known Issues

  1. The demo “pic32mz_ef_sk_meb2/audio_player/audio_player_lab5” is developed by applying a patch (available in folder “audio_player_lab5/firmware/gfx_repo_patch”) to the MPLAB Harmony v3 “gfx” repository. If you need to reconfigure or regenerate this demo using the MHC, please refer the “Notes.txt” file under audio_player_lab5/firmware/gfx_repo_patch” folder.
    The patch is applied due to a known issue with MHC v3.5.0 for Aria GAC Code Generation. This issue is expected to be fixed in gfx release v3.7.0.
  2. The application “pic32mz_ef_curiosity_v2/msd_multiple_luns” is developed by by applying a patch (available in folder “msd_multiple_luns/firmware/usb_repo_patch”) to MPLAB Harmony v3 “usb” repository. If you need to reconfigure or regenerate this demo using MHC, please refer the “Notes.txt” file under “msd_multiple_luns/firmware/usb_repo_patch” folder.
    The patch is applied due to a known issue with MHC v3.5.0 for USB Code Generation for this demo application. This issue is expected to be fixed in a future release of “usb” repository.

Development Tools

  • Refer demo specific documentation in folder “docs” to know the tools and Harmony 3 packages used.


Copyright © 2020 Microchip Technology.