MCC Melody 8-Bit MDFU Client Library

Overview

The MPLAB® Code Configurator Melody 8-Bit MDFU Client Library allows users to configure and generate code to more quickly and easily setup MCUs to utilize a device firmware update process.

Components

• 8-Bit MDFU Client Library in MCC Melody – Allows easy graphical configuration and code generation for bootloader client.
• pyfwimagebuilder - Converts hex files into DFU image format, ensuring compatibility with bootloader requirements for seamless firmware updates.
• pymdfu - Host Application to facilitate the transmission of DFU image to the bootloader client, streamlining the update process.

Features

• Supports UART Communication
• The main requirements for the generated bootloader code are:
  • Determine if a valid end-application is loaded
  • Communicate/Execute supported Commands
  • Erase/Rewrite the end-application memory space
  • Transfer control to the end application

Related Documentation

• Release Notes
• Getting Started Document, API Reference and Update Image Specification
• Known Issues List

GitHub Examples

• 8-Bit MDFU Bootloader Client Example for AVR128DA48
• 8-Bit MDFU Bootloader Client Example for PIC18F56Q24
• 8-Bit MDFU Bootloader Client Example for PIC16F18446

Changelog

All notable changes to this project will be documented in this file.

[1.4.0] - 2025-10-21

Bug Fixes

• M8BTL-4915 :- Fix FTP layer to pass correct buffer length to BL_BootCommandProcess

New Features and Improvements

• M8BTL-2848 :- Added documentation to provision public key in the secure element
• M8BTL-2847 :- Support for secure boot and secure DFU in 8-bit MDFU Client Library
• M8BTL-635 :- Support for CRC verification option at boot time

[1.3.0] - 2025-07-02

Bug Fixes

• M8BTL-4416 :- Bootloader core is checking the file version incorrectly

New Features and Improvements

• M8BTL-4137 :- Refactored linker option section to provide more streamlined experience
• M8BTL-3778 :- Updated the 8-bit MDFU Client Library to automatically align the app start address to the next page boundary
• M8BTL-2850 :- Updated the 8-bit MDFU Client library to support recovery using multiple images
• M8BTL-2849 :- Updated the 8-bit MDFU Client Library to support anti-rollback feature for the application version

[1.2.0] - 2024-12-19

New Features and Improvements

• M8BTL-3717 :- Added interrupt driven support for the communication protocols that require it
• M8BTL-3651 :- Documented the memory consumption details for each verification scheme
• M8BTL-3575 :- Updated the FTP to support all v1.0.0 optional error codes
• M8BTL-3574 :- Renamed the FTP static response enumerations
• M8BTL-3507 :- Updated the getting started guide to explain how to enable interrupts for MDFU Client library for various devices
• M8BTL-3506 :- Updated the getting started document to have steps for building the most optimal project configuration for customers
• M8BTL-3400 :- Updated use case examples section to include separate examples for AVR and PIC devices
• M8BTL-2828 :- Updated 8-bit MDFU Client library to support I2C communication interface