Working With Hardware Tools in MPLAB® Xpress

Last modified by Microchip on 2025/03/27 14:24

The new MPLAB® Xpress supported hardware tools currently are:

Preparing to Use the USB Bridge Tool

To prepare to program your code using a hardware tool:

If you have been using MPLAB X IDE, close this application. Its drivers can interfere with bridge operation.

Back to Top


Ensure your MPLAB Xpress project builds without errors.

Back to Top


If you will be using one of the supported hardware tools, ensure the debugger is connected to a target.

Back to Top


Connect your hardware to the PC using a USB port.

Back to Top

Starting the USB Bridge Tool

MPLAB Xpress needs a program called USB Bridge to connect to your local USB port. This allows MPLAB Xpress to send a compiled HEX file to a supported hardware tool.

Open the Manage USB Bridge Window.

Click on the Project Properties Dashboard icon on the dashboard.

Click on your hardware tool under Debug Tool. Text and a link will appear below.

Click on the here link.

Project Properties window

Back to Top


Select the USB Bridge Installer.

Follow the instructions on the Manage USB Bridge window to download a ZIP file containing the USB Bridge installer.

Manage USB Bridge window

Back to Top


Run the USB Bridge Installer.

Unzip/extract the contents of the downloaded ZIP file. Then find and run the following file(s):

Linux®

run.sh *

Windows®

run.bat

macOS®

run.sh *

Extract from Zip - Windows

* We recommended running it with administrative privileges.

The running USB Bridge Tool application will appear as shown:

MPLAB Xpress USB Communications Bridge Application

Back to Top

Connecting to the USB Bridge Tool

To connect to the USB Bridge Tool, click on the Connect to USB Bridge Connect To Running Bridge App icon.

You can see that the tool is connected to the USB Bridge Tool application.

MPLAB Xpress USB Communications Bridge Application

Back to Top


The Connect to USB Bridge Connect To Running Bridge App icon will now show as connected.

Open the Project Properties dialog again to see that the specific debug tool is available.

Project Properties dialog

Back to top

Programming and Running Your Application

Select the MPLAB Xpress Make and Program Device program target icon icon.

Other Resources

For tips on connecting and debugging, click on the Hardware Debug Tips hareware tips icon icon on the toolbar.

Back to top