MP Pack Tool

This document introduces the functionalities and usage of the MP Pack Tool, supporting chips including RTL8762C, RTL8762D, RTL8762E, RTL8762G_VA, RTL8762G_VB, and RTL8752H. The MP Pack Tool is used to merge subfiles and generate data packet files such as MP, OTA, or CFU.

  • MP Packet: Used for mass production. It can be flashed into the device using the MP Tool.

  • OTA Packet: Used for Over-The-Air updates. It can be upgraded via Android/iOS OTA apps.

  • CFU Packet: Used for Component Firmware Updates. It can be upgraded using the CFU Tool.

Download the MP Pack Tool from the RealMCU platform.

Packaging Steps

../../_images/Pack_Guide.png

MP Pack Packaging Process

  1. Select Packaging Mode

    Choose from three modes. This example uses MP mode; OTA and CFU packaging follow similar steps.

    • ForMP

    • ForOTA

    • ForCFU

  2. Import flash map.ini

    • The flash map defines the flash layout. For details, refer to Flash Map Generate Tool.

  3. Import Other Files

    • Click Browse to select files, then click Open to import.

    • The tool validates imported files (MD5 checks, IC verification, etc.). Valid files appear in the list (Step 4).

  4. Imported File List

    • Displays: File Name, Path, Address, Size, and Version.

  5. Remove Files (if required)

    • Select a file and click Remove to delete it.

    • Click Remove All to clear all files.

    • Removal resets the 'File Path', 'Size', and 'Version' fields, and sets the 'Address' to default.

  6. Import User Data (Optional)

  7. Modify Save Path and Filename (Optional)

    • Check Save Path and click ... to choose a directory (default: MP Pack Tool root).

    • Check File Name to rename the output file (default: ImgPacketFile-MD5.bin).

  8. Generate Packaged File

    • Click Confirm to generate the file at the specified location.

  9. Log Window

    • Displays prompts and error messages.

MP Packaging

MP packets are used for mass production and can be flashed via the MP Tool.

../../_images/PackTool_MP.png

MP Packaging Interface

Check ForMP to generate an MP packet for mass production.

Adding User Data

MP mode supports custom User Data. Follow these steps:

../../_images/User_Data1.png

Adding User Data in MP Mode

  1. Click User Data to open the User Data window.

  2. Click Browse to select User Data files.

  3. Use Remove or Remove All to delete files.

  4. Manually adjust the User Data address to avoid conflicts. Overlaps trigger an error: Overlapping Exists!

  5. Click Confirm to finalize.

  6. After the above steps are completed, the User Data checkbox will be automatically checked, indicating that User Data will be packaged.

Note

  • Ensure User Data does not overlap with other files.

  • A WithUserData file is generated alongside the standard MP packet.

MP Raw Data

Check Raw Data to generate a Raw Data packet:

../../_images/MP_RawData_Setting.png

MP Raw Data Packet

This generates two files:

../../_images/MP_RawData.png

MP Raw Data Format

OTA Packaging

OTA packets enable Over-The-Air updates via Android/iOS apps.

../../_images/PackTool_OTA.png

OTA Packaging Interface

Check ForOTA to generate an OTA packet.

Adding User Data

For RTL8762C, RTL8762G_VB, and RTL8752H, User Data can be added as shown below. Other ICs do not support User Data in OTA.

../../_images/User_Data2.png

Adding User Data in OTA Mode

Note

User Data must include MP Header and Image Header for OTA compatibility.

OTA Raw Data

Check Raw Data to generate Raw Data packets:

../../_images/OTA_RawData_Setting.png

OTA Raw Data Packet

Output files vary by bank configuration, the files generated are shown below:

  • Single Bank:

    • Standard OTA package

    • Raw OTA data package

  • Dual Bank:

    • Standard OTA package

    • Bank0 OTA raw data package

    • Bank1 OTA raw data package

    • Full bank OTA raw data package

The format of OTA Raw Data packet is shown in the figure below.

../../_images/OTA_RawData.png

OTA Raw Data Format

Compress Mode

Enable Compress to compress images larger than flash map.ini's OTA_TMP_SIZE:

../../_images/OTA_Compress_Setting.png

OTA Compress Mode

CFU Packaging

CFU packets enable Component Firmware Updates via the CFU Tool.

../../_images/PackTool_CFU.png

CFU Packaging Interface

Check ForCFU to generate a CFU packet.

Note

There are two CFU packaging formats:

  • V1: Multiple Images are packaged into a single .payload file and .offer file.

  • V2: Each Image is packaged into its own .payload file and .offer file.

Users can switch between them by clicking V1 and V2. Consult your FAE to determine which format to use.

Memory Layout Visualization

The tool displays memory layout to check overlaps. Click Show Detail/Hide to toggle the layout dialog:

../../_images/Layout.png

File Memory Layout

Note

Overlaps block packaging. Ensure no overlaps in the flash map.

Unpacking

Unpack MP/OTA packets (Raw Data unsupported).

Click UnPack, select a packet file. Unpacked files are saved to a folder matching the packet name:

../../_images/Unpack.png

Unpacking