Skip to content

Latest commit

 

History

History
871 lines (593 loc) · 53.3 KB

release_notes.md

File metadata and controls

871 lines (593 loc) · 53.3 KB

Microchip logo Harmony logo small

Microchip MPLAB Harmony 3 Release Notes

USB Release v3.15.0

NEW FEATURES

  • Harmony USB support for:
    • PIC32CM-GC/SG family of devices
    • PIC32CX-BZ6 and WBZ653 family of devices (previously released as an engineering version)
    • PIC32CZ-CA70 family of devices
  • The help documentation for each USB component can now be accessed directly from MCC.
  • Implemented USB Device Test Mode support for the UDPHS Driver.
  • Added a new USB Host layer event, USB_HOST_EVENT_DEVICE_DETACHED, which occurs when an unsupported device that was attached is now detached.
  • USB device and host demos for:
    • PIC32CM-GC Curiosity Pro Board.
    • WBZ653 Curiosity Board.
    • PIC32CZ CA70 Curiosity Ultra Board.
    • SAM9X75 Curiosity board.(Additional demos)
  • Added USB printer device demo for SAMA7D65 Early Access Curiosity Board.

Bug fixes

  • The MSD Function driver has been updated to avoid calling the media driver API's from an interrupt context. It is now only called from the task context.
  • The UDPHS Driver has been updated to handle Zero Length Packets (ZLP) without making use of the USB DMA.

Known Issues

  • All Harmony USB projects for SAMA5 and SAMA7 family products must be compiled to generate ARM instructions. The XC32 compiler switch -marm must be used. Thumb instructions are not supported yet.
  • All Harmony USB projects for PIC32CM GC/SG family products will fail if compiled with -Os optimisation level.
  • All Harmony USB Device projects for SAMA7 family products will fail if compiled with -Os optimisation level.

Development Tools

USB Release v3.15.0-E1

NEW FEATURES

  • Added USB support for WBZ653 family of devices.
  • USB demos for WBZ653 Curiosity Board.

Bug fixes

  • None

Known Issues

  • All Harmony USB projects for SAMA5 family products must be compiled to generate ARM instructions. The XC32 compiler switch -marm must be used. Thumb instructions are not supported yet.

Development Tools

USB Release v3.14.0 (June, 2024)

NEW FEATURES

  • Added USB support for SAMA7D65 device.
  • USB demos for SAMA7D65 Early Access Curiosity Board.

Bug fixes

  • None

Known Issues

  • All Harmony USB projects for SAMA5 family products must be compiled to generate ARM instructions. The XC32 compiler switch -marm must be used. Thumb instructions are not supported yet.

Development Tools

USB Release v3.13.0 (June, 2024)

NEW FEATURES

  • Added USB support for PIC32MZ2051-W1 devices.
  • USB demos for SAMA5D29 Curiosity Development Board.
  • USB demos for SAM9X75 Curiosity Development Board

Bug fixes

  • Implemented fixes for several MISRA C 2012 required violations.
  • Enabled user configuration for the Attach Debounce Timer in the USB Full Speed Driver component in the MCC Project Graph. The timer value is no more hard coded to 500 milliseconds.
  • Improved USBFSV1 (USB Full Speed) Host mode driver to prevent deadlock during frequent USB device connect and disconnect scenarios.
  • The USBFS Device mode Driver has been updated to rectify an issue where it was incorrectly generating a Resume event immediately following a Suspend event.
  • The USBFS Host mode driver now disables the 1ms timer after completing detach debounce.
  • The USB Device code generation script has been updated to resolve the an issue in the MCC-generated Microsoft OS string descriptor.
  • The USB Device configuration symbol 'Max Power (mA)' has been enhanced to accommodate up to 500 mA for PIC32CZ CA80/CA90. Previously, this symbol permitted only up to 250mA.
  • USB library documentation has been updated.
  • The MCC code generation scripts have been updated to activate USB Full-Speed peripheral (USB) interrupts for PIC32CK devices.

Known Issues

  • All Harmony USB projects for SAMA5 family products must be compiled to generate ARM instructions. The XC32 compiler switch -marm must be used. Thumb instructions are not supported yet.

Development Tools

USB Release v3.12.0

NEW FEATURES

  • MISRA-C 2012 mandatory and required rules compliance for all USB Middleware and driver components.
  • Added Harmony USB support for LAN9255 Devices.

Bug fixes

  • None.

Known Issues

  • All Harmony USB projects for SAMA5 family products must be compiled to generate ARM instructions. The XC32 compiler switch -marm must be used. Thumb instructions are not supported yet.
  • The USBFSV1 driver USB Host mode attach debounce timer is not user configurable. The value is hardcoded to 500m Seconds.

Development Tools

USB Release v3.11.0

NEW FEATURES

  • Added USB Host Generic Driver Framework.
  • USB Device Audio v1.0 function driver has been updated to add support for Asynch Isochronous Endpoints.

Bug fixes

  • The USB Device MSD Function driver initialize data code generation script has been updated to resolve a buffer overflow issue.
  • USB Device Mode Driver for MPU products (UDPHS Module) has been updated to resolve an exception by checking for a NULL pointer in the ISR.
  • USB configuration scripts for MCC have been updated to resolve multiple issues.
  • USB Device Mode Driver for PIC32CZ products has been updated to resolve the issue with the remote wakeup feature.

Known Issues

  • All Harmony USB projects for SAMA5 family products must be compiled to generate ARM instructions. The XC32 compiler switch -marm must be used. Thumb instructions are not supported yet.

Development Tools

USB Release v3.11.0-E2

NEW FEATURES

  • This engineering release adds support for the PIC32CK-GC01 family of devices:

Bug fixes

  • Resolved an issue in the USBHS driver for PIC32CZ CA80 family devices.

Known Issues

  • The USB stack is not tested with USBHS and USBFS drivers added together in the same project for the PIC32CK-GC01 family of devices.

Development Tools

USB Release v3.11.0-E1

NEW FEATURES

  • This engineering release adds support for the PIC32CZ-CA family of devices:

Bug fixes

  • The USB Device layer has been updated to exit suspend mode when an SOF event is received from the USB driver.

Known Issues

  • Same as v3.10.0

Development Tools

USB Release v3.10.0

NEW FEATURES

  • Added support for a new product.

Bug fixes

  • Updated the USB Device mode driver for MPUs (UDPHS) to flush any pending transaction before performing a STALL clear.
  • Updated the USB Device mode code generator scripts to generate a 12 character serial number string descriptor as default.
  • Updated the USB Device mode code generator user interface to input Power consumption in milliAmperes.
  • Updated the USB Host OHCI driver to use an updated macro from the Device Family Packs (DFP).

Known Issues

  • IAR projects for SAM MCUs and MPUs builds with warning messages.
  • The USB_DEVICE_CDC_SerialStateNotificationSend() function does not support queuing.

Development Tools

USB Release v3.9.0

NEW FEATURES

  • DMA support is enabled in the USB Device Mode driver for MPUs. The driver uses the dedicated DMA available with the UDPHS peripheral.

Bug fixes

  • Fixed issues in the USB Code generation scripts.
  • Updated the USB Full Speed (USBFS) driver Device mode operation to disable all the USB interrupts except the attach interrupt when the Device is detached from the Host.

Known Issues

  • Harmony USB applications for MPUs do not work with XC32 v4.00. All Harmony USB applications for MPUs should be built with XC32 v3.01.
  • IAR projects for SAM MCUs and MPUs builds with warning messages.
  • The USB_DEVICE_CDC_SerialStateNotificationSend() function does not support queuing.

Development Tools

USB Release v3.8.1

NEW FEATURES

Bug fixes

  • Fixed issues in USB MHC scripts.

Known Issues

  • IAR projects for SAM MCUs and MPUs builds with warning messages.
  • The USB_DEVICE_CDC_SerialStateNotificationSend() function does not support queuing.

Development Tools

USB Release v3.8.0

NEW FEATURES

  • This release does not contain any new features or new parts support.

Bug fixes

  • Resolved double mutex lock issue in UDPHS Driver.
  • Resolved incorrect structure selection in the USB_DEVICE_CDC_SerialStateNotificationSend() function.
  • Updated USBFSV1 Device mode driver to support Remote wakeup feature.
  • Fixed issues in USB MHC scripts.

Known Issues

  • IAR projects for SAM MCUs and MPUs build with warning messages.
  • The USB_DEVICE_CDC_SerialStateNotificationSend() function does not support queuing.

Development Tools

USB Release v3.7.2

NEW FEATURES

  • New part support - N/A

  • New Features and Enhancements - MPLAB® Harmony USB Host and Device stack firmware has been updated to operate with MPLAB® XC32 v3.x Compiler.

  • Development kit and demo application support - N/A

Bug fixes

  • Updated USB Host HID and Hub client drivers to fix compiler warnings.
  • Updated USBFS Driver to fix compiler warnings.
  • Updated USBHSV1 Driver to fix compiler warnings.
  • Resolved HID Report descriptor generation issue for PIC32MZ W1 Devives.
  • Added volatile keyword in PIC32MZ USBHS PLIB function.

Known Issues

  • IAR projects for SAM MCUs and MPUs build with warning messages.

Development Tools

USB Release v3.7.1

NEW FEATURES

  • New part support - N/A

  • New Features and Enhancements - N/A

  • Development kit and demo application support - All the application examples from USB repos have been moved to separate repositories that are specific to their funtionality. Following Table gives the details of the repos.

Repository USB functionality
usb_apps_device Application examples for USB Device functionality
usb_apps_dual_role Application examples for USB Dual Role functionality
usb_apps_host Application examples for for USB Host functionality
usb_apps_multi_controller Application examples for for USB Multi Controller functionality

Bug fixes

  • Resolved incorrect QTD Page Buffer Address assignment logic in EHCI Driver.

Known Issues

  • Same as USB v3.7.0.

Development Tools

  • Same as USB v3.7.0.

USB Release v3.7.0

NEW FEATURES

  • New part support - N/A

  • New Features and Enhancements

    • Isochronous transfer support is added for USBFSV1 and USB Device Port drivers. Isochronous transfer support enables creating USB Device Audio applications for SAME5/D5/D2/L2x/D11/G55 Controllers.
    • Hardware periodic scheduler enabled for EHCI and OHCI Drivers.
    • USB Middleware and Drivers have been updated to build successfully with additional XC32 compiler switches.
    • Added USB Host hub_msd demo for SAMD21 Xplained Pro Evaluation kit.

  • Development kit and demo application support - The following table provides number of demo applications available for different development kits newly added in this release.

    Development Kits Number of applications
    SAM D21 Xplained Pro Evaluation Kit 1

Bug fixes

  • Resolved an issue with USBHS Host mode IRP Cancel function.
  • Resolved few issues with USB Code generation scripts.

Known Issues

The current known issues are as follows:

  • Isochronous transfers are not supported for SAM9X60 and SAMA5D2 MPUs both in Device mode and Host mode operations.

  • IAR projects for SAM MCUs and MPUs build with warning messages.

Development Tools

USB Release v3.6.1

NEW FEATURES

  • New part support - N/A

  • New Features and Enhancements

    • Dual Channel USB to UART application for ATSAMD21 Xplained Pro Evaluation kit.
    • USB Host Hub demo for SAM9X60 and SAMA5D25 Microcprocessors.

  • Development kit and demo application support - The following table provides number of demo applications available for different development kits newly added in this release.

    Development Kits Number of applications
    SAM D21 Xplained Pro Evaluation Kit 1
    ATSAM9X60-EK 2
    SAMA5D2 Xplained Ultra Evaluation Kit 2

Bug fixes

  • Added High Speed Hub support for USB Host EHCI Driver.

Known Issues

The current known issues are as follows:

  • Isochronous transfers are not supported with USB Host Port Driver(EHCI/OHCI) for SAMA5D2/SAM9X60 MCUs. The issue will be fixed in an upcoming release.

  • USB Host Port High-Speed Driver for SAMA5D2/SAM9X60 MCUs supports only High Speed USB Hubs. Full speed Hubs are not supported. Only High Speed USB Devices could be attached to the Host. The issue will be fixed in an upcoming release.

  • USB keyboard Host demonstration application on the SAMG55x microcontroller does not toggle the keyboard LED. This issue will be fixed in an upcoming release.

  • Detaching a USB device from a SAMG55x Host when the enumeration is in progress causes the affects Plug N'Play operation. This issue will be fixed in an upcoming release.

  • Isochronous tranfers are not tested with USB Device Port High Speed Driver(UDPHS) Driver. The issue will be fixed in an upcoming release.

  • Interactive help using the Show User Manual Entry in the Right-click menu for configuration options provided by this module is not yet available from within the MPLAB Harmony Configurator (MHC). Please see the "Configuring the Library" section in the help documentation in the doc folder for this module instead. Help is available in both CHM and PDF formats.

  • In a case where an MPLAB Harmony USB Device Project requires multiple Function Driver instances in the project, the MPLAB Harmony Configurator(MHC) may generate incorrect USB descriptors if a USB Device function driver component is added and then removed from the MHC Project Graph. Removing all the USB components from the project graph and starting over fixes this issue. The issue will be fixed in an upcoming release.

  • IAR projects for SAM MCUs and MPUs build with warning messages. The issue will be fixed in an upcoming release.

  • The following USB Host Stack functions are not implemented:

    • USB_HOST_BusResume
    • USB_HOST_DeviceSuspend
    • USB_HOST_DeviceResume

  • The USB Host Layer does not check for the Hub Tier Level. This feature will be available in a future release of MPLAB Harmony.

  • The USB Host Layer will only enable the first configuration when there are multiple configurations. If there are no interface matches in the first configuration, this causes the device to become inoperative. Multiple configuration enabling will be activated in a future release.

  • The MSD Host Client Driver has not been tested with Multi-LUN Mass Storage Device and USB Card Readers.

  • The USB Host SCSI Block Driver, the CDC Client Driver, and the Audio Host Client Driver only support single-client operation. Multi-client operation will be enabled in a future release of MPLAB Harmony.

  • USB HID Host Client driver has not been tested with multiple usage devices. Sending of output or feature report has not been tested.

  • The USB Audio Host Client driver does not provide an implementation for the following functions:

    • USB_HOST_AUDIO_V1_DeviceObjHandleGet
    • USB_HOST_AUDIO_V1_FeatureUnitChannelVolumeRangeGet
    • USB_HOST_AUDIO_V1_FeatureUnitChannelVolumeSubRangeNumbersGet
    • USB_HOST_AUDIO_V1_StreamSamplingFrequencyGet
    • USB_HOST_AUDIO_V1_TerminalIDGet

  • USB Host Stack has been tested only limited numbers of USB Flash drives.

Development Tools

USB Release v3.6.0

NEW FEATURES

  • New part support - N/A

  • New Features and Enhancements

    • USB Device stack support for SAMG55 Microcontrollers.
    • USB Device applications for SAMG55 Microcontrollers.
    • USB Host transfer scheduler for SAMD2x/E5x/D5x/L21 Microcontroller families.
    • USB Device MSD application with SD Card as media.
    • USB Device Composite demo with CDC and MSD SD Card.

  • All FreeRTOS based applications are tested with the CMSIS-FreeRTOS v10.3.0.

  • Development kit and demo application support - The following table provides number of demo applications available for different development kits newly added in this release.

    Development Kits Number of applications
    SAM D21 Xplained Pro Evaluation Kit 2
    SAM E54 Xplained Pro Evaluation Kit 1
    SAM E70 Xplained Ultra Evaluation Kit 1
    SAM G55 Xplained Pro Evaluation Kit 3
    ATSAM9X60-EK 2

Bug fixes

  • Resolved Async transfer scheduling issues with USB Host EHCI Driver.

Known Issues

The current known issues are as follows:

  • Isochronous transfers are not supported with USB Host Port Driver(EHCI/OHCI) for SAMA5D2/SAM9X60 MCUs. The issue will be fixed in an upcoming release.

  • USB Host Port High-Speed Driver for SAMA5D2/SAM9X60 MCUs does not support USB Hub. The issue will be fixed in an upcoming release.

  • USB keyboard Host demonstration application on the SAMG55x microcontroller does not toggle the keyboard LED. This issue will be fixed in an upcoming release.

  • Detaching a USB device from a SAMG55x Host when the enumeration is in progress causes the affects Plug N'Play operation. This issue will be fixed in an upcoming release.

  • Isochronous tranfers are not tested with USB Device Port High Speed Driver(UDPHS) Driver. The issue will be fixed in an upcoming release.

  • Interactive help using the Show User Manual Entry in the Right-click menu for configuration options provided by this module is not yet available from within the MPLAB Harmony Configurator (MHC). Please see the "Configuring the Library" section in the help documentation in the doc folder for this module instead. Help is available in both CHM and PDF formats.

  • In a case where an MPLAB Harmony USB Device Project requires multiple Function Driver instances in the project, the MPLAB Harmony Configurator(MHC) may generate incorrect USB descriptors if a USB Device function driver component is added and then removed from the MHC Project Graph. Removing all the USB components from the project graph and starting over fixes this issue. The issue will be fixed in an upcoming release.

  • IAR projects for SAM MCUs and MPUs build with warning messages. The issue will be fixed in an upcoming release.

  • The following USB Host Stack functions are not implemented:

    • USB_HOST_BusResume
    • USB_HOST_DeviceSuspend
    • USB_HOST_DeviceResume

  • The USB Host Layer does not check for the Hub Tier Level. This feature will be available in a future release of MPLAB Harmony.

  • The USB Host Layer will only enable the first configuration when there are multiple configurations. If there are no interface matches in the first configuration, this causes the device to become inoperative. Multiple configuration enabling will be activated in a future release.

  • The MSD Host Client Driver has not been tested with Multi-LUN Mass Storage Device and USB Card Readers.

  • The USB Host SCSI Block Driver, the CDC Client Driver, and the Audio Host Client Driver only support single-client operation. Multi-client operation will be enabled in a future release of MPLAB Harmony.

  • USB HID Host Client driver has not been tested with multiple usage devices. Sending of output or feature report has not been tested.

  • The USB Audio Host Client driver does not provide an implementation for the following functions:

    • USB_HOST_AUDIO_V1_DeviceObjHandleGet
    • USB_HOST_AUDIO_V1_FeatureUnitChannelVolumeRangeGet
    • USB_HOST_AUDIO_V1_FeatureUnitChannelVolumeSubRangeNumbersGet
    • USB_HOST_AUDIO_V1_StreamSamplingFrequencyGet
    • USB_HOST_AUDIO_V1_TerminalIDGet

  • USB Host Stack has been tested only limited numbers of USB Flash drives.

Development Tools

USB Release v3.5.0

NEW FEATURES

Known Issues

The current known issues are as follows:

  • Isochronous are not supported with USB Host Port Driver(EHCI/OHCI) on SAMA5D2. The issue will be fixed in an upcoming release.

  • USB Host Port High Speed Driver on SAMA5D2 does not support USB Hub. The issue will be fixed in an upcoming release.

  • Isochronous tranfers are not tested with USB Device Port High Speed Driver(UDPHS) Driver. The issue will be fixed in an upcoming release.

  • Interactive help using the Show User Manual Entry in the Right-click menu for configuration options provided by this module is not yet available from within the MPLAB Harmony Configurator (MHC). Please see the "Configuring the Library" section in the help documentation in the doc folder for this module instead. Help is available in both CHM and PDF formats.

  • In a case where a MPLAB Harmony USB Device Project requires multiple Function Driver instances in the project, the MPLAB Harmony Configurator(MHC) may generate incorrect USB descriptors if a USB Device function driver component is added and then removed from the MHC Project Graph. Removing all the USB components from project graph and starting over fixes this issue. The issue will be fixed in an upcoming release.

  • IAR projects for SAM MCUs and MPUs builds with warning messages. The issue will be fixed in an upcoming release.

  • The following USB Host Stack functions are not implemented:

    • USB_HOST_BusResume
    • USB_HOST_DeviceSuspend
    • USB_HOST_DeviceResume

  • The USB Host Layer does not check for the Hub Tier Level. This feature will be available in a future release of MPLAB Harmony.

  • The USB Host Layer will only enable the first configuration when there are multiple configurations. If there are no interface matches in the first configuration, this causes the device to be become inoperative. Multiple configuration enabling will be activated in a future release of the of MPLAB Harmony.

  • The MSD Host Client Driver has not been tested with Multi-LUN Mass Storage Device and USB Card Readers.

  • The USB Host SCSI Block Driver, the CDC Client Driver, and the Audio Host Client Driver only support single-client operation. Multi-client operation will be enabled in a future release of MPLAB Harmony.

  • USB HID Host Client driver has not been tested with multiple usage devices. Sending of output or feature report has not been tested.

  • The USB Audio Host Client driver does not provide implementation for the following functions:

    • USB_HOST_AUDIO_V1_DeviceObjHandleGet
    • USB_HOST_AUDIO_V1_FeatureUnitChannelVolumeRangeGet
    • USB_HOST_AUDIO_V1_FeatureUnitChannelVolumeSubRangeNumbersGet
    • USB_HOST_AUDIO_V1_StreamSamplingFrequencyGet
    • USB_HOST_AUDIO_V1_TerminalIDGet

  • USB Host Stack has been tested only limited numbers of USB Flash drives.

Development Tools

USB Release v3.4.0

NEW FEATURES

Known Issues

The current known issues are as follows:

  • Isochronous are not supported with USB Host Port Driver(EHCI/OHCI) on SAMA5D2. The issue will be fixed in an upcoming release.

  • USB Host Port High SPeed Driver on SAMA5D2 does not support USB Hub. The issue will be fixed in an upcoming release.

  • Isochronous tranfers are not tested with USB Device Port High Speed Driver(UDPHS) Driver. The issue will be fixed in an upcoming release.

  • Interactive help using the Show User Manual Entry in the Right-click menu for configuration options provided by this module is not yet available from within the MPLAB Harmony Configurator (MHC). Please see the "Configuring the Library" section in the help documentation in the doc folder for this module instead. Help is available in both CHM and PDF formats.

  • In a case where a MPLAB Harmony USB Device Project requires multiple Function Driver instances in the project, the MPLAB Harmony Configurator(MHC) may generate incorrect USB descriptors if a USB Device function driver component is added and then removed from the MHC Project Graph. Removing all the USB components from project graph and starting over fixes this issue. The issue will be fixed in an upcoming release.

  • ATSAMA5D2C and SAM9X60 demo applications build with warning messages. The issue will be fixed in an upcoming release.

  • The following USB Host Stack functions are not implemented:

    • USB_HOST_BusResume
    • USB_HOST_DeviceSuspend
    • USB_HOST_DeviceResume

  • The USB Host Layer does not check for the Hub Tier Level. This feature will be available in a future release of MPLAB Harmony.

  • The USB Host Layer will only enable the first configuration when there are multiple configurations. If there are no interface matches in the first configuration, this causes the device to be become inoperative. Multiple configuration enabling will be activated in a future release of the of MPLAB Harmony.

  • The MSD Host Client Driver has not been tested with Multi-LUN Mass Storage Device and USB Card Readers.

  • The USB Host SCSI Block Driver, the CDC Client Driver, and the Audio Host Client Driver only support single-client operation. Multi-client operation will be enabled in a future release of MPLAB Harmony.

  • USB HID Host Client driver has not been tested with multiple usage devices. Sending of output or feature report has not been tested.

  • The USB Audio Host Client driver does not provide implementation for the following functions:

    • USB_HOST_AUDIO_V1_DeviceObjHandleGet
    • USB_HOST_AUDIO_V1_FeatureUnitChannelVolumeRangeGet
    • USB_HOST_AUDIO_V1_FeatureUnitChannelVolumeSubRangeNumbersGet
    • USB_HOST_AUDIO_V1_StreamSamplingFrequencyGet
    • USB_HOST_AUDIO_V1_TerminalIDGet

  • USB Host Stack has been tested only limited numbers of USB Flash drives.

Development Tools

USB Release v3.3.0

NEW FEATURES

Known Issues

The current known issues are as follows:

  • Periodic transfers (Isochronous/Interrupt) are not supported with USB Host Port Driver(EHCI/OHCI) on SAMA5D2. The issue will be fixed in an upcoming release.

  • USB Host Port High SPeed Driver on SAMA5D2 does not support USB Hub. The issue will be fixed in an upcoming release.

  • Isochronous tranfers are not tested with USB Device Port High Speed Driver(UDPHS) Driver. The issue will be fixed in an upcoming release.

  • Interactive help using the Show User Manual Entry in the Right-click menu for configuration options provided by this module is not yet available from within the MPLAB Harmony Configurator (MHC). Please see the "Configuring the Library" section in the help documentation in the doc folder for this module instead. Help is available in both CHM and PDF formats.

  • USB Host Layer does not reset data toggle after sending an ENDPOINT_HALT Clear Feature. Certain USB Devices may not work due to this issue. The issue will be fixed in an upcoming release.

  • In a case where a MPLAB Harmony USB Device Project requires multiple Function Driver instances in the project, the MPLAB Harmony Configurator(MHC) may generate incorrect USB descriptors if a USB Device function driver component is added and then removed from the MHC Project Graph. Removing all the USB components from project graph and starting over fixes this issue. The issue will be fixed in an upcoming release.

  • ATSAMA5D2C demo applications build with warning messages. The issue will be fixed in an upcoming release.

  • MPLAB Harmony Configurator can be used to configure only USB1 peripheral on the PIC32 microcontroller. USB2 Peripheral is not supported by MHC. The issue will be fixed in an upcoming release.

  • The following USB Host Stack functions are not implemented:

    • USB_HOST_BusResume
    • USB_HOST_DeviceSuspend
    • USB_HOST_DeviceResume

  • The USB Host Layer does not check for the Hub Tier Level. This feature will be available in a future release of MPLAB Harmony.

  • The USB Host Layer will only enable the first configuration when there are multiple configurations. If there are no interface matches in the first configuration, this causes the device to be become inoperative. Multiple configuration enabling will be activated in a future release of the of MPLAB Harmony.

  • The MSD Host Client Driver has not been tested with Multi-LUN Mass Storage Device and USB Card Readers.

  • The USB Host SCSI Block Driver, the CDC Client Driver, and the Audio Host Client Driver only support single-client operation. Multi-client operation will be enabled in a future release of MPLAB Harmony.

  • USB HID Host Client driver has not been tested with multiple usage devices. Sending of output or feature report has not been tested.

  • The USB Audio Host Client driver does not provide implementation for the following functions:

    • USB_HOST_AUDIO_V1_DeviceObjHandleGet
    • USB_HOST_AUDIO_V1_FeatureUnitChannelVolumeRangeGet
    • USB_HOST_AUDIO_V1_FeatureUnitChannelVolumeSubRangeNumbersGet
    • USB_HOST_AUDIO_V1_StreamSamplingFrequencyGet
    • USB_HOST_AUDIO_V1_TerminalIDGet

  • USB Host Stack has been tested only limited numbers of USB Flash drives.

Development Tools

USB Release v3.2.2

NEW FEATURES

  • USB Device Printer Function Driver - This release adds USB Device printer function driver library. This release also adds Genric Text Only USB printer demo for SAM E54 Xplained Pro Evaluation Kit.

Known Issues

The current known issues are as follows:

  • Programming and debugging through PKOB is not yet supported for PIC32MZ DA, need to use external debugger (ICD4)

  • PIC32MZ DA(S) device family will be supported by next coming XC32 release.

  • The ICD4 loads the reset line of the SAM V71 Xplained Ultra board. Do not press reset button on the Xplained Ultra board while ICD4 is connected to the board.

  • Interactive help using the Show User Manual Entry in the Right-click menu for configuration options provided by this module is not yet available from within the MPLAB Harmony Configurator (MHC). Please see the "Configuring the Library" section in the help documentation in the doc folder for this module instead. Help is available in both CHM and PDF formats.

  • USB HS Host Port Driver for SAMA5D2 will freeze its operation if the attached USB device responds with a STALL. Many USB Devices will not work due to this issue. This will be fixed in future releases.

  • USB Host Layer does not reset data toggle after sending an ENDPOINT_HALT Clear Feature. Certain USB Devices may not work due to this issue.

  • USB Host Mass Storage Client Driver for SAME70/V71/S70 will freeze its operation if the attached USB Mass Storage device responds with a STALL during a SCSI MODE_SENSE command. Few USB Devices will not work due to this issue. This will be fixed in future releases.

  • In a case where a MPLAB Harmony USB Device Project requires multiple Function Driver instances in the project, the MPLAB Harmony Configurator(MHC) may generate incorrect USB descriptors if a USB Device function driver component is added and then removed from the MHC Project Graph. Removing all the USB components from project graph and starting over fixes this issue. The issue will be fixed in an upcoming release.

Development Tools

USB Release v3.2.1

NEW FEATURES

  • New part support - This release introduces initial support for SAMA5D2 family of 32-bit microprocessors.

| Development kits | Applications | | --- | --- | --- | | ATSAMA5D2C-XULT | 4 |4|

Known Issues

The current known issues are as follows:

  • Programming and debugging through PKOB is not yet supported for PIC32MZ DA, need to use external debugger (ICD4)

  • PIC32MZ DA(S) device family will be supported by next coming XC32 release.

  • The ICD4 loads the reset line of the SAM V71 Xplained Ultra board. Do not press reset button on the Xplained Ultra board while ICD4 is connected to the board.

  • Interactive help using the Show User Manual Entry in the Right-click menu for configuration options provided by this module is not yet available from within the MPLAB Harmony Configurator (MHC). Please see the "Configuring the Library" section in the help documentation in the doc folder for this module instead. Help is available in both CHM and PDF formats.

  • USB HS Host Port Driver for SAMA5D2 will freeze its operation if the attached USB device responds with a STALL. Many USB Devices will not work due to this issue. This will be fixed in future releases.

  • USB Host Layer does not reset data toggle after sending an ENDPOINT_HALT Clear Feature. Certain USB Devices may not work due to this issue.

Development Tools

USB Release v3.2.0

NEW FEATURES

  • New part support - This release introduces initial support for PIC32MZ DA, PIC32MZ EF, SAM E54, families of 32-bit microcontrollers.

  • Development kit and demo application support - The following table provides number of demo application available for different development kits newly added in this release.

| Development kits | Applications | | --- | --- | --- | | PIC32MZ Embedded Graphics with Stacked DRAM (DA) Starter Kit (Crypto) | 2 | | PIC32MZ Embedded Connectivity with FPU(EF) Starter Kit | 11 | | SAM E54 Xplained Pro Evaluation Kit | 7 |

Known Issues

The current known issues are as follows:

  • Programming and debugging through PKOB is not yet supported for PIC32MZ DA, need to use external debugger (ICD4)

  • PIC32MZ DA(S) device family will be supported by next coming XC32 release.

  • The ICD4 loads the reset line of the SAM V71 Xplained Ultra board. Do not press reset button on the Xplained Ultra board while ICD4 is connected to the board.

  • Interactive help using the Show User Manual Entry in the Right-click menu for configuration options provided by this module is not yet available from within the MPLAB Harmony Configurator (MHC). Please see the "Configuring the Library" section in the help documentation in the doc folder for this module instead. Help is available in both CHM and PDF formats.

  • USB Host MSD (apps\host\msd_basic) demo has been tested only with limited number of pen drives. The list of tested pen drives are provided in the USB Help doc section "USB MSD Host USB Pen Drive Tests"

Development Tools

USB Release v3.1.0

NEW FEATURES

  • New part support - This release introduces initial support for SAM D20/D21, SAM S70, SAM E70, SAM V70/V71 families of 32-bit microcontrollers.

  • USB Library - The following table provides the list of USB Library components and Applications.

Type Module Name Module Caption
Driver DRV_USBHSV1 USB High Speed Driver [Host and Device] for [SAMV70/V71/S70/E70] families of 32-bit microcontrollers
Driver DRV_USBFSV1 USB Full Speed Driver [Host and Device] for SAM D20/D21 families of 32-bit microcontrollers
Middleware USB Device Layer USB Device Layer Library
Middleware USB Audio v1.0 Function Driver USB Audio 1.0 Device Library
Middleware USB CDC Function Driver USB CDC Device Library
Middleware USB HID Function Driver USB HID Device Library
Middleware USB MSD Function Driver USB MSD Device Library
Middleware USB Host Layer USB Host Layer Library
Middleware USB Audio v1.0 Client Driver USB Audio 1.0 Host Library
Middleware USB CDC Client Driver USB CDC Host Library
Middleware USB HID Client Driver USB HID Host Library
Middleware USB MSD Client Driver USB MSD Host Library
USB Device App cdc_com_port_dual CDC Dual Serial COM Ports Emulation Demonstration
USB Device App cdc_com_port_single CDC Single Serial COM Port Emulation Demonstration
USB Device App cdc_serial_emulator CDC Serial Emulation Demonstration
USB Device App hid_basic Basic USB Human Interface Device (HID) Demonstration
USB Device App hid_keyboard USB HID Class Keyboard Device Demonstration
USB Device App hid_mouse USB HID Class Mouse Device Demonstration
USB Device App msd_basic USB Device Mass Storage Device (MSD) Demonstration
USB Host App cdc_basic USB Host CDC Basic Demonstration
USB Host App cdc_msd USB Host CDC + MSD Basic Demonstration
USB Host App hid_basic_keyboard USB HID Host Keyboard Demonstration
USB Host App msd_basic USB MSD Host Simple Thumb Drive Demonstration
  • Development kit and demo application support - The following table provides number of bare-metal and RTOS demo application available for different development kits.
Development kits Bare-metal applications RTOS applications
SAM E70 Xplained Ultra Evaluation Kit 11 9
SAM V71 Xplained Ultra Evaluation Kit 1 3
SAM D21 Xplained Pro Evaluation Kit 3 0

KNOWN ISSUES

The current known issues are as follows:

  • The device does not run after programming the device through EDBG. The user needs to reset the device manually using the reset button on the Xplained boards to run the firmware.

  • Programming and debugging through EDBG is not supported. The ICD4 needs to be used for programming and debugging.

  • The ICD4 loads the reset line of the SAM V71 Xplained Ultra board. Do not press reset button on the Xplained Ultra board while ICD4 is connected to the board.

  • Interactive help using the Show User Manual Entry in the Right-click menu for configuration options provided by this module is not yet available from within the MPLAB Harmony Configurator (MHC). Please see the "Configuring the Library" section in the help documentation in the doc folder for this module instead. Help is available in both CHM and PDF formats.

DEVELOPMENT TOOLS