Skip to content

docs(dragon/q6a): add troubleshooting for 8-inch DSI overlay boot failure issue#1591

Open
tangzz-radxa wants to merge 3 commits intoradxa-docs:mainfrom
tangzz-radxa:support/dragon-q6a-dsi-issue-1355-clean
Open

docs(dragon/q6a): add troubleshooting for 8-inch DSI overlay boot failure issue#1591
tangzz-radxa wants to merge 3 commits intoradxa-docs:mainfrom
tangzz-radxa:support/dragon-q6a-dsi-issue-1355-clean

Conversation

@tangzz-radxa
Copy link
Copy Markdown
Contributor

Summary

Add troubleshooting documentation for Dragon Q6A 8-inch DSI overlay boot failure issue (#1355).

Why

Users reported boot failure (blue light stays on then blinks, no display output) after enabling Radxa Display 8 HD DSI overlay on Dragon Q6A. This is a known compatibility issue with specific kernel versions (linux-image-6.18.2-3-qcom and earlier).

The documentation was missing guidance on:

  1. How to check the current kernel version
  2. The solution (updating to linux-image-6.18.2-4-qcom when available)
  3. Workarounds if the issue persists

Changes

  1. Added FAQ section in Dragon Q6A documentation:

    • Explains the known compatibility issue
    • Provides steps to check kernel version and update system
    • Links to linux-qualcomm repository for fix updates
    • Notes that only DSI overlay for Display 8 HD is affected
  2. Added note in MIPI DSI documentation:

    • Includes known issues and solutions section
    • Provides clear troubleshooting steps
    • Differentiates between Display 8 HD and Display 10 FHD
  3. Created English translations:

    • Added English FAQ with DSI overlay troubleshooting
    • Added English MIPI DSI documentation
    • Ensured bilingual documentation consistency

Verification

  1. The changes are minimal and focused on the reported issue
  2. Documentation now provides actionable steps for users
  3. Bilingual check passes (both Chinese and English versions updated)
  4. References the correct linux-qualcomm repository for updates

Fixes #1355

…lure issue

- Add FAQ section explaining known compatibility issue with linux-image-6.18.2-3-qcom
- Add note in MIPI DSI documentation with affected versions and solutions
- Provide steps to check kernel version and update system
- Reference linux-qcom repository for fix updates

Addresses issue radxa-docs#1355 where enabling Radxa Display 8 HD overlay causes
boot failure with blue light blinking and no display output.
…oting

- Create English FAQ with DSI overlay boot failure section
- Create English MIPI DSI documentation with known issues
- Ensure bilingual documentation consistency
- Addresses issue radxa-docs#1355
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug] Dragon Q6A - Enabling 8 inch DSI Overlay causes Boot Failure / Blue Light

1 participant