9. Troubleshooting - Mac OS

Guides on how to diagnose and troubleshoot issues on Mac OS

1. Mac - "Controller Not Connected" message

The MP MIDI has a separate hardware module for MIDI.
This hardware is seen on the Mac’s System Report as C1-xMP1.

The "Controller not connected" message refers to the C1-xMP1 hardware device.

First, ensure that you have the MIDI port connected to the computer:

image.png

Like all USB devices, the C1-xMP1 must be initialized by the Mac and it will be displayed in the System Report of the Mac. 

If a USB device is not listed under the USB tree of the System Report, the device is either not connected to the Mac or it has a hardware/connection problem. 

If the C1-xMP1 device is listed in the System Report but you still get the message "Controller not connected" then it is a software related issue. See step 2 of the troubleshooting steps below. If the device is listed and displays [Safe Mode] it is ok and it does not affect the function of the device. 

Note that the System Report does not update automatically. You need to close it and reopen it after a change has been made to ensure you are seeing the latest System Report.

Steps to Troubleshoot

  1. Check in the System Report that the C1-xMP1 shows up.
    (Not to be confused with MP Touch screen hardware)

If it does not show up, there is a connection issue. Connect the cable provided directly from the MIDI port of the controller, to the computer’s USB A port (not USB-C port). 

If don't have a USB-A port of your Mac connect it via a USB-C docking station like this that has USB 2.0 and USB 3.0 ports.

        

If it still does not show up in the System Report, See this article

  1. If it does show up in the System Report, then make sure that it shows up and that it is active and online in MAC’s MIDI Studio. (Do not rename the C1-xMP1 in MIDI Studio on the Mac) as shown in the screenshot below. 

If you have more than one C1-xMP1, delete the additional one.

If the C1-xMP1 does not show up in the MIDI Studio, try Refresh MIDI Setup from the top bar menu option.

and try pressing the Rescan MIDI button

IMPORTANT: If you have UPDD installed and the C1-xMP1 is listed in the System Report but not found in the Mac MIDI Studio, it is possible that some setting/selection in UPDD is causing this.

Uninstall UPDD and reboot the Mac. Check the MIDI Studio if C1-xMP1 is listed.

Please note, UPDD does not need any hardware selection setting to be done manually. It should work without any manual configuration.

  1. Disable the MIDI In/Out of the C1-xMP1 in the DAW as instructed here. The controller should now be found by the MPH plugin shown on the left bottom of the MPH plugin window.

2. Mac - License not Found

The “License not found” will appear if the file mph.license and/or hardware.id files are missing from the /MP/Host folder.

Or if using a Mac OS older than MacOS Mojave.

First, ensure you have both files in the MP Host folder as shown here:

The hardware.id file is generated automatically when you run the MP Host plugin.
The mph.license file should be downloaded from the user portal.

Do not rename the hardware.id and mph.license files. 
If the filenames are not exactly as shown above, you will get the error "License not found"

Hardware.id file is not being copied to the Mac's Desktop

If you are using the MP Controller for the first time on a Mac and the hardware.id file is not being copied to your Desktop when you click on the STEP 1 button in the license registration, open the following folder in Finder 
~/Library/Application\ Support/MP/Host
(In the Finder on your Mac, choose Go > Go to Folder)
and see if the hardware.id file present in the folder. If it is not present, strict permissions by MacOS may be the issue.
Paste the following in a terminal:
sudo chmod 777 ~/Library/Application\ Support/MP/Host
It will ask for your password and then enter.

The terminal should not produce any output. If it produces a message then there may something wrong with the command provided. Take a screenshot of the message and send it to us via email.

Then try opening the MPH again and follow the steps to complete the license generation/verification process.

Additionally, it is a good practice to add the DAW in System Settings > Privacy and Security > Full Disk Access.

Note that without the mph.license file, then it will not allow the hardware controller to be connected to the MP Host software.

3. Mac - Model 1A: Troubleshooting the Touch Function

UPDD needed for Mac OS Catalina and Onwards

The touchscreen works as mouse input, therefore when you touch the screen it gets the mouse cursor. If you touch and drag, it behaves in the same way as clicking and dragging with the mouse. 

In Mac OSX Catalina 10.15.4, Apple replaced the way hardware interacts with the OS.  It introduced the new Driverkit and replaced the traditional Kexts with Dexts.

You can get the Mac OS software from https://touch-base.com/controllerbyte and you can also download a demo to try it prior to purchasing. 

There are 2 possibilities for why the touch screen is not working on the Mac (while video is being displayed and the monitor is ON):

1. Is a software issue with the UPDD software on the Mac. (Usually this is due to permissions) OR

2. A connection issue.

To find out what is going on,  first check under USB in the System Report: Multi-Touch by G2TSP (the touchscreen hardware. The C1x-MP1 is the MIDI Controller hardware.

The two devices (G2TSP and C1-xMP1) work independently and are not related to each other. The C1-xMP1 does not need to be connected for the touch screen to work.

This test app was created for convenience, it just detects the G2TSP touch hardware and displays it, just as it would on the System Report. Therefore, opening the System Report or the test app is the same.

If you can't see the Multi-Touch G2TSP in the test app or the MacOS System Report, then it means that there is a connection or hardware problem.  The System Report will display Multi-Touch G2TSP even if UPDD is not installed.

The only port on the MP MIDI Controller that affects the touch function is the Display Port on the Controller. The only cable that affects the touch function is the USB cable connected to the Display Port and on the Mac computer on the other end.

If connected via a usb hub, try to connect it directly on the Mac.

Use the 1m cables provided with the controller.

If your controller came with 2m cables, the best cable to use from the market is the 1m Amazon Basics Cable USB 3.1 Gen 2.
Here are links for: USA, UK, Germany

If you see the G2TSP in the test app or system report, then run the diagnostic from Touch Base and email it to their support address.

If you have it connected on the Mac with the 1m USB cable (USB-C or USB-A) and the Multi-Touch by G2TSP does not show up in the System Report (after you get a disconnection message from UPDD) then the next thing to check is the ports on the enclosure which may be causing the problem. These can be bypassed and connect directly on the LCD panel, however, to get to the port of the display the unit must be disassembled by removing the bottom cover.

4. Mac - Model 1A+/2A : Troubleshooting the Touchscreen

You need Mac OS Mojave or above for the touch function to work.

UPDD does not have to be installed for the Mac OS to detect the Touchscreen hardware.

First, we need to check if  the Mac OS finds the Touch hardware. 

Follow these steps:

1. Connect USB-C to USB-A cable directly to the Mac’s USB port without going through a hub or the Y-cable or any other middleware. 

2. Then connect the HDMI for video signal (if there is no video signal the monitor will power off).

Alternatively to the hdmi, you can try a Thunderbolt (USB-C to USB-C) cable directly on the Mac, but the best method to test is with the provided USB-A cables.

3. Open the System Report of the Mac and check under the USB Tree, it should display

----------------------------------------------------------------

MP Touchscreen

Manufacturer: MP Controller Touch Display

----------------------------------------------------------------

Alternatively to opening the System Report (needs to reopened every time you unplug a USB device), you can download 'this' small utility app (right click and click "save link as..." to download it) which when you run it, it shows if the MP Controller’s touch software is properly connected and found by Mac OS. 

Please note that the cursor of the mouse must be on the MP Controller for the touch function to work properly . If it located on your main monitor and when you touch the screen it will move the mouse in the main screen. UPDD transfers the touch on the MP Controller screen area automatically, regardless of the position of the mouse.

For further information on UPDD see this article

5. Mac - Model 1A+/2A - Display powers ON but goes to sleep - Power Saving and No Signal

If the display powers on and shows the logo but short after powers off (sleep mode), this confirms that the display of the controller receives power, however

This is a standard behavior on all monitors connected to computers when they don't receive video signal.

If the display restarts constantly, then the problem is not enough power provided to the MP Controller display port,
see this article

If the display does not power ON at all see this article (no MP MIDI logo on startup)

Connection Options

Connect the cable to the Display port (Video, Touch Power), by following one of the 2 connection options,

See the connection diagrams on the initial setup guide.

This port should always be connected, either with USB-C to USB-A when using HDMI, or USB-C to USB-C when using thunderbolt.

Not all USB-C ports are the same on newer Macs. USB-C ports on some models placed in the front panel of the Mac are plain USB ports which do not provide a video signal. Ensure you are using Thunderbolt ports (usually at the back).

For Apple Silicon Macs models made after 2022, to connect via Thunderbolt (For Video, Touch, Power) we recommend purchasing a 1m Thunderbolt 4 cable, for example 
Amazon Basics USB-C to USB-C 4 Fast Charger Cable, 40 Gbps, 8K Video, 240W, USB-IF Cert, Thunderbolt 4/3 Compatible

(Note that, the MIDI port connection is still needed for MIDI communication)

Note: The "Display additional power" port will not transfer video signal when connected and it should only be used to provide additional power. If you connect only this port, the display of the controller will go into power saving and display the "No Signal" message


Changing the Refresh Rate

If the display of the controller is shown after connection in the System Settings > Displays, the monitor frequency should be automatically set to 60Hz. 


In some cases, the Mac OS may set it to 75Hz and this will cause the display of the MP Controller to go to sleep.
The refresh rate settings on MacOS are hidden — In Display Settings, be sure to hold the Option key when clicking "Scaled" to see the refresh rate option.

See video how to change the refresh rate on MacOS Sonoma

The resolution of the monitor should be set to 1920 x 1080,.

Set the monitor as external display in Displays on the Mac. (not mirror)

If you are connecting the controller's display using USB-C thunderbolt and it does not show as an additional display in the System Settings > Displays, then it means the Mac OS cannot recognize the display. This may be due to a number of factors depending on Mac model and thunderbolt generation. In this case connect the display using HDMI as shown in the next section.

Also see: MacOS 13.4 Ventura - External Monitor no longer detected. Worked until the update to 13.4 https://discussions.apple.com/thread/254875167?sortBy=best

Mac not able to provide video signal via Thunderbolt

If using the USB-C Thunderbolt port on your Mac and it is unable to provide video signal to the MP Controller which consequentially the display goes to sleep, then connect it using HDMI and USB-A as shown below.

If your Mac is unable to provide video to the display using USB-C thunderbolt, you may still be able to use USB-C to USB-C for touch/power and HDMI for video.

If you don't have an HDMI port and USB ports available on your Mac, you should use a USB-C powered docking station. See some suggestions here

If you have multiple displays connected to your Mac, ensure that your Mac has the ability to provide video signal to the number of displays you have connected including the MP Controller. For example, the Mac Mini M1 can only use 2 displays. You can extend (add more) the number of displays on a Mac by using a Wavlink USB adapter.

Changing the video input on the display

Although the input is selected automatically when detected (HDMI or Thunderbolt via USB-C), when you connect the Display port and the MP MIDI logo comes on, before it goes to Power Saving mode, use the remote control to select the correct input, HDMI or TYPE-C.

Note that the remote control must be pointed to the remote receiver on the controller.

6. Mac - The MP Host Window appears on another display

Ensure you are using the latest MP Host plugin. The method that the target display is chosen has been updated in the 11/2024 version of the MP Host.

On the Mac it is a good practise to go in Mission Control, disable the option “Displays have separate spaces”.  This will also remove the Mac OS top menu bar from appearing on top of the MP Host window.

Please note that the target monitor needs to be set once for each: MP Host, MIDI App, Ableton MPH as they are using different setting files.

To select the target monitor see here

7. Mac - Installed Plugins not shown in the Plugin List

The MP host will scan 

scanning will read and display just the filenames at first, and fully scan a plugin once you choose to load/use the plugin

If the VST3 plugins are not shown in the MP Host list, navigate to the host.properties folder and rename it or delete it.

Close any MP Host instances you have running.

Then reset the permissions on the VST3 folder by running in the Mac terminal:

sudo chmod -R 777 /Library/Audio/Plug-Ins/VST3/
enter your password and hit enter. It should not produce any output on the terminal.
Then
sudo chmod -R 777 /Library/Audio/Plug-Ins/VST3/*.vst3

enter your password and hit enter. It should not produce any output on the terminal.

Then reopen the MP Host Audio FX plugin and you will need to choose the target monitor from the right click menu. Then open the Plugin List and choose Quickscan. It should show all the VST3 plugins in the plugin list.

As you may have noticed it has generated a new host.properties file.

For more information please see this article on how the MP Host scans and finds plugins.

Plugins also may be removed from the plugin list (after you scan or try to try to load them once) if they are not universal binaries (Apple Silicon ARM and x86). You can find if a plugin is built for both architectures by running lipo -info PLUGIN_PATH in a terminal

For example: lipo -info /Library/Audio/Plug-Ins/VST3/reverbA.vst3

MacOS Plugins in ~/Library/ and /Library/ 

It is possible to have the plugins in the user Library as well.

This may result in duplicate plugins.

Check this location:  ~/Library/Audio/Plug-Ins/
if you have plugins here delete them.
The correct location is /Library/Audio/Plug-Ins/
Force Ableton Live to find new plugins on MacOS and Windows

If you have a large number of plugins and Ableton does not show the new version of the MP Host try the following methods:

1. Rescan Plugins in Ableton Live:
2. Clear Plugin Cache Manually:

Inside these directories, locate and delete the file PluginScanV2 (this file holds cache data for your plugins).

3. Rescan AU/VST if Using macOS (for Audio Units only):

This will force the macOS to reload the list of installed AU plugins.

After these steps, Ableton Live should detect the new versions of your VST plugins properly.

8. Mac - Troubleshooting in depth the C1-xMP1 MIDI Controller

The C1-xMP1 is the midi device of the MP Controller.

If it does show up in the System Report but it still does not found by the MP Host plugin then try the following.

Create a new configuration in Mac's MIDI Studio 

Click on the dropdown:

Then select New Configuration. This will reset the MIDI studio

You will see the connected MIDI devices 

Double click on the C1-xMP1 and you should see that the device is online


Using the Console to diagnose

The Mac has a build-in Console that shows logs of when hardware connects to the computer.

Open the Console

Type in the search area: icdd, hit enter and then click on Start

Disconnect the C1-xMP1 cable from the Mac and then connect it again (always on a USB-A port). You should see the following data being populated on the Console.

If you don't see this data then click Pause, then on Clear and then on Errors and Faults

Disconnect the C1-xMP1 and click on Start. Then connect the C1-xMP1.

Check if there are any errors related to C1-xMP1 that appear on the Console.

If there are errors it means there is an issue with the connection. If you are connecting via USB-A and it is still producing errors, you can try using a USB Hub or USB-C docking station that has USB-A ports.

9. Mac - "Invalid mph.license" message

If you get a message on the left bottom corner of the MP Host that the license is invalid it means that the mph.license file was not generated for that computer.

If you have copied the hardware.id or the mph.license file from another computer (perhaps using the Mac Time Machine) delete both the mph.license and hardware.id files and run the MP Host in the DAW to create a new hardware.id file.

Unload any instances of the MP Host and then load one MP Host in the DAW to create the hardware.id file.

Then, log on your user portal account (see email when you purchased the MP Controller) and upload the hardware.id file to generate a new mph.license.

The hardware.id and mph.license files should have these 2 exact names.

See these 2 related articles:
21. Activating the MP Controller on other computers
22. Get the mph.license from the user portal

Note that you can get to the MP/Host folder using the right click menu. See here

 

10. Mac - C1-xMP1 not showing up in the System Report

The MIDI port of the MP Controller should be connected with a USB-A interface on the Mac and does not require any drivers to be installed as it is a USB MIDI class compliant device.

If you have Windows computer available connect the MIDI port of the MP Controller directly on a USB port and check the device manager for C1-xMP1

If it does not show up in the Device Manager, proceed to the next step.

If it shows up in the Device Manager, the problem could be with a connection method on the Mac and you can try the next step to eliminate any connectivity issues.

If you are connecting to a USB-A port directly to the Mac and C1-xMP1 still does not show up in the System Report, first check using another cable.

System Report > USB Tree

If you are certain the problem is not with the cable you need to check the internal micro-USB bridge port cable that connects on the MIDI board. 

Close and reopen the System Report. If it is still not showing in the System Report try to bypass the internal microUSB to USB-C bridge port as described in the next step.

Bypassing the internal USB Port (Bridge port)

The problem may be with the bridge port.
The bridge port cable connects the MIDI board to the port mounted on the enclosure.
You can try to bypass the bridge internal port of the C1-xMP1 and connect it directly using a microUSB to USB-A DATA cable as shown below.

Please note that not all microUSB cables are data cables. Many are just charging cables and these will not work. Ensure you are using a data cable. 

Amazon Basics cables are recommended.



If these steps do not solve the issue then the problem is with the MIDI board and needs to be replaced send us an email at support@mpmidi.com explaining in detail all the steps you have tried and we can advise further on how to proceed.