MPLAB® Hexmate User Interface

Welcome to the early access program. You are using an early version of this software. We are diligently enhancing your experience and deeply value your patience and support during this period. Please note that features and functionalities are actively being developed and may change without prior notice. As early adopters, your feedback is invaluable to us. Please report any bugs or suggestions for enhancements.

📘 About Hexmate

The Hexmate application is a post-link utility that can merge multiple Intel HEX files into one, reformat HEX files, as well as insert useful data into these files after they have been generated by a compiler.

Hexmate User Guide has information on the tasks that Hexmate can perform and the command-line options that control the application.

✨ Features

MPLAB Hexmate Plugin provides a User interface to run various Hexmate command
The Plugin is designed to generate and run commands on Hexmate
The Plugin allows to save and restore hexmate commands using hexmate workspace
The plugin allows invoking Hexmate based on the workspace without populating the User Interface (UI)

🏃‍♀️ Getting started

Install MPLAB XC8 Compiler
To install the MPLAB Hexmate Plugin, open the Extensions view using Ctrl + Shift + X or Cmd + Shift + X on macOS, search for MPLAB Hexmate User Interface, and click Install.
Invoke the command palette using the command Ctrl + Shift + P and invoke Hexmate using the command MPLAB: Hexmate.
Create a new Hexmate workspace by providing Workspace location, Target device and the hex file.

Initial Hexmate setup

Configure options passed to Hexmate by modifying global, input, operations and output settings.
To execute hexmate, click on 'Run Hexmate'.

Hexmate Execution

💬 Supported commands

Using Command Palette (CMD/CTRL + Shift + P)

Open the MPLAB Hexmate User Interface (UI)

> MPLAB: Hexmate

Run Hexmate based on workspace without populating User Interface

> MPLAB: Hexmate Run

Known Issues

Number of input hex file that Hexmate can process is limited to 3, and number of operations (Checksum, Fill, Find, etc.) it can perform is limited to 2 operations each (MPLABNG-3681).

📦 Requirements

MPLAB Services

🐞 Go to mplabfeedback.microchip.com to report issues and suggest enhancements

📝 License Information

The MPLAB® Extensions for Visual Studio Code are distributed under a non-exclusive software license agreement provided by Microchip Technology Inc. To review the complete terms and conditions governing the use of this software, please consult the "license" file included with this package.