Common Issues

This guide covers the most frequently encountered problems during Matter device installation and provides quick diagnostic steps and solutions.

Quick Diagnostic Flowchart

START
  │
  ▼
Is device powered on?
  │
  ├─ NO → Check power supply, wiring, circuit breaker
  │
  └─ YES
       │
       ▼
   Is device pulsing/blinking?
       │
       ├─ NO → Device already commissioned → Factory reset needed
       │
       └─ YES
            │
            ▼
        Can app discover device?
            │
            ├─ NO → Network/mDNS issue → See Network Problems
            │
            └─ YES
                 │
                 ▼
             Commissioning succeeds?
                 │
                 ├─ NO → See Commissioning Failures
                 │
                 └─ YES → Device responding? → See Performance Issues

Top 10 Most Common Problems

  1. Device not discovered during setup
  2. Commissioning timeout errors
  3. Device connects but is unresponsive
  4. Intermittent connectivity/disconnections
  5. App crashes during device setup
  6. “Device already claimed” error messages
  7. Slow response times after setup
  8. Device disappears from network
  9. Control commands not executed
  10. Factory reset not working

Issue: Device Not Discovered

Symptoms

  • App doesn’t show the device during scanning
  • Device is pulsing but not appearing in setup screen
  • “No devices found” message displayed

Quick Fixes

  1. Verify device state

    • Ensure device is pulsing (factory reset state)
    • If not pulsing, perform factory reset first

  2. Check network basics

    • Smartphone and hub on same Wi-Fi network
    • Bluetooth enabled on smartphone
    • Wi-Fi 2.4GHz band available (required for Thread)

  3. Proximity check

    • Move smartphone closer to device (< 2 meters)
    • Move hub closer to device during commissioning

  4. mDNS verification

    • Ensure mDNS/multicast is enabled on router
    • Disable AP isolation if enabled

Issue: Device Won’t Connect

Symptoms

  • Device found but commissioning fails
  • Connection timeout errors
  • “Unable to add device” messages

Quick Fixes

  1. Verify QR code

    • Use the QR code on the device or packaging
    • Ensure code is not damaged or obscured
    • Try manual code entry if available

  2. Network requirements

    • Disable IGMP snooping on your router
    • Ensure no MAC filtering blocks the device
    • Check firewall allows Matter traffic (port 5540)

  3. Power cycle sequence

    • Power off device for 10 seconds
    • Power back on and retry immediately
    • Attempt commissioning within 60 seconds of power-on

Issue: Device Connects But Unresponsive

Symptoms

  • Device appears in app but won’t respond to commands
  • Status shows “Offline” or “Unreachable”
  • Controls don’t affect device state

Quick Fixes

  1. Signal strength check

    • Verify Wi-Fi/Thread signal at device location
    • Consider adding a border router or repeater
    • Reduce distance to hub or access point

  2. App and hub restart

    • Close and reopen the app completely
    • Power cycle the hub (unplug 10 seconds)
    • Wait 2 minutes for network stabilization

  3. Device power cycle

    • Turn off device for 30 seconds
    • Turn back on and wait for reconnection
    • Check if device responds after 60 seconds

Issue: Intermittent Connectivity

Symptoms

  • Device randomly goes offline
  • Commands sometimes fail
  • Inconsistent response times

Quick Fixes

  1. Interference check

    • Identify sources of 2.4GHz interference
    • Move device away from microwaves, baby monitors
    • Change Wi-Fi channel to less congested option

  2. Network stability

    • Check router logs for connection drops
    • Verify DHCP lease times are adequate (24h+)
    • Ensure static IP or reserved DHCP for hub

  3. Environmental factors

    • Check for metal obstacles between device and hub
    • Verify device isn’t in a faraday cage-like environment
    • Consider mesh network expansion

Issue: App Crashes During Setup

Symptoms

  • App closes unexpectedly during commissioning
  • Setup process restarts from beginning
  • Error messages before crash

Quick Fixes

  1. App troubleshooting

    • Update app to latest version
    • Clear app cache and data
    • Reinstall app if issues persist

  2. Device-side preparation

    • Factory reset the device before retrying
    • Ensure stable internet connection
    • Disable VPN during setup

  3. Platform-specific

    • iOS: Check Home app permissions
    • Android: Verify Bluetooth and location permissions
    • Restart smartphone if crashes continue

When to Escalate to Support

Contact Prolicht support when:

  • Multiple factory resets don’t resolve the issue
  • Device exhibits hardware failure signs (no power, burning smell)
  • Problem persists across different networks
  • Error codes indicate firmware corruption
  • Installation environment violates requirements

Support Contact

Email: [email protected]
Phone: +43 660 6504656 (Emergency Hotline)

Information to prepare:

  • Device model and serial number
  • Hub/platform being used
  • Steps already attempted
  • Network configuration details
  • Photos/videos of the issue