DeviceOK
SearchDevice checks
Home / Fixes / Serial Port Access Denied or Busy

hardware · evidence-led troubleshooting

Serial Port Access Denied or Busy

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
Run Serial portSee fault tree ↓

What this symptom means

This symptom concerns the hardware path. Start with a neutral DeviceOK test where available so the next step is based on evidence rather than a generic reset sequence.

Diagnostic principleUSB-C connector shape does not tell you data speed, video capability or charging power. Separate device enumeration, transport/data rate, alternate-mode video and power delivery before buying replacement hardware.

Fault tree

USB / peripheral connection fault tree

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

1
Cable capability mismatch

Evidence: Charging works but video/data does not, or low-speed data works but high-bandwidth mode fails.

Next: Identify the cable's certified power/data capability and test a known-good full-featured cable.

2
Hub/dock topology

Evidence: Direct connection works but the same device fails through a hub/dock.

Next: Add the dock back only after a direct baseline succeeds; check power and bandwidth sharing.

3
Permission/API support

Evidence: OS sees the device but WebUSB/WebHID/Serial cannot open it.

Next: Confirm the device is actually supported by that browser API and not claimed by a protected OS driver.

4
Power budget

Evidence: Device resets, disconnects under load or works with externally powered hub.

Next: Check host/hub power and device requirements.

Interpret the result

Evidence matrix

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

ObservationWhat it supportsPrioritize next
Direct port worksThe device and host can establish a working path without the intermediate accessory.Hub, dock, cable topology or power sharing.
Charging onlyPower is present but this does not prove data or DisplayPort support.Cable data lanes, host port capability, device mode or adapter.
Browser API cannot see deviceEither the API is unsupported, the device class is excluded/protected, or the OS has not exposed it.Browser capability and OS-level detection before hardware diagnosis.
Disconnects under loadThe connection exists but stability/power/bandwidth is insufficient.Cable length/quality, hub power, port power, firmware or device fault.

Fast baseline

Rule out the simple causes first

  1. 1

    Close Arduino IDE, serial monitors, slicers, terminal programs, or other apps that may have the port open.

  2. 2

    Reconnect the device and select the correct port again.

  3. 3

    Check OS permission/policy restrictions.

Full sequence

Work from reversible checks to invasive ones

Avoid destructive resets, unofficial driver packages, firmware flashing, or replacing hardware before the simpler detection, permission, connection and configuration checks are exhausted.

  1. 1

    Only one process can often hold a serial port at a time.

  2. 2

    If DeviceOK opens the port after closing another app, the hardware path is likely usable.

  3. 3

    Do not change baud/protocol settings randomly when controlling real equipment.

Platform branches

Where the setting lives

USB-C

  • Treat power, data and video as separate capabilities
  • Check 60W/240W and data-rate markings on certified USB-C cables where present
  • Use direct host connection for the baseline

Browser APIs

  • Chromium-based support is broader for WebHID/WebUSB/Web Serial
  • Permission requires a user gesture and device selection
  • Some device classes are intentionally unavailable to websites

Docks

  • Check upstream port capability
  • Check dock power-delivery rating
  • Check display topology and shared bandwidth
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

A missing browser device must be compared with OS detection and API support before calling hardware failed. Compare the simplest direct connection and official diagnostic path before replacement.

Escalation threshold

When software troubleshooting has stopped being high value

  • Device not recognized on multiple hosts
  • Connector is physically loose/damaged
  • Cable/adapter gets abnormally hot
  • Electrical smell, arcing or visible damage
Safety
  • Stop using any cable, charger or port that becomes abnormally hot, sparks, smells burnt or shows melted insulation.
Changed one variable?After every meaningful change, repeat the same test under the same conditions and compare the result. Retest under the same condition so the result is comparable.
Retest Serial port