midi · evidence-led troubleshooting

One MIDI Key or Pad Is Not Working

Use a focused DeviceOK test first, then follow the evidence from browser/device state before changing drivers, firmware, or hardware.

Reviewed 2026-08-113 diagnostic steps1 official sources

What this symptom means

MIDI is event data, not audio. A controller can send correct MIDI messages while a DAW still stays silent because instrument, track, routing or device settings are wrong.

Diagnostic principleSeparate USB/device detection from MIDI message flow and DAW mapping. A keyboard can be powered and visible while notes/CC/sustain messages are not reaching the software path you expect.

Fault tree

MIDI fault tree

Use the observation that best matches what you can reproduce. Do not treat every cause as equally likely.

1
Port/device selection

Evidence: Device is visible but no messages appear from the intended port.

Next: Select the correct MIDI input and compare note/CC/sustain events in DeviceOK.

2
DAW mapping/channel

Evidence: DeviceOK receives messages but the DAW/instrument does not respond.

Next: Check MIDI channel, track input, monitor/arm state and mapping.

3
USB connection

Evidence: Device disappears or messages stop when the cable/hub is moved.

Next: Test direct USB, known-good cable and power path.

4
Firmware/device mode

Evidence: Specific controls are missing across apps.

Next: Check official firmware/editor and hardware mode.

Interpret the result

Evidence matrix

A test result is useful only if it changes the next troubleshooting branch.

ObservationWhat it supportsPrioritize next
Note messages appearThe browser is receiving MIDI note data from the selected port.DAW track/channel/instrument mapping if music software is silent.
Notes work, sustain/knob does notThe device path exists but a specific control/message is missing.Control assignment, MIDI CC, hardware mode or pedal polarity.
Device listed, no messagesEnumeration succeeded but data is not flowing from the chosen port/control.Port selection, device mode, cable/firmware.
Device not listedThe Web MIDI/OS path is unavailable.Browser support, OS recognition, USB connection and driver.

Fast baseline

Rule out the simple causes first

  1. 1

    Run the MIDI keyboard test and press the problem key several times.

  2. 2

    Compare neighboring keys/pads and velocity values.

  3. 3

    Check controller octave/layer/pad-bank modes that may remap the control.

Full sequence

Work from reversible checks to invasive ones

Do not troubleshoot speakers or audio drivers as the first step when the missing evidence is MIDI input itself.

  1. 1

    If one physical control never sends a message while others do, a control-specific hardware/configuration issue becomes more likely.

  2. 2

    If the control sends a valid note here, focus on DAW mapping, scale filters, MIDI channel, or instrument range.

  3. 3

    Use the controller manufacturer's own diagnostics/firmware utility before considering repair.

Platform branches

Where the setting lives

DAW

  • Check track input and monitor/record-arm
  • Check MIDI channel/all channels
  • Temporarily bypass control-surface scripts

Browser

  • Use a browser with Web MIDI support
  • Grant MIDI permission when prompted
  • Select the exact input port

Hardware

  • Direct USB before hubs
  • Check sustain pedal polarity/mode
  • Use manufacturer editor only after raw messages are tested
If it works in DeviceOK

If the matching DeviceOK test succeeds, prioritize the affected app, browser policy, operating-system setting, or configuration before assuming complete hardware failure.

If it also fails here

No messages across supported apps shifts attention to connection, driver/firmware or controller mode. Compare the simplest direct connection and official diagnostic path before replacement.

Escalation threshold

When software troubleshooting has stopped being high value

  • Specific keys/controls fail in multiple MIDI monitors
  • USB connection is unstable across hosts
  • Visible port damage
  • Official firmware/editor cannot communicate with the device
Changed one variable?The DeviceOK MIDI monitor should show the expected note/control messages before you move into DAW-specific routing. Retest under the same condition so the result is comparable.
Retest MIDI keyboard