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

$3

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

$3

- 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

$3

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

$3

- 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

$3

- 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