docs(troubleshooting): add a camera-not-detected entry - #1419
Open
FabienDanieau wants to merge 1 commit into
Open
FabienDanieau wants to merge 1 commit into
FabienDanieau wants to merge 1 commit into
Conversation
A loose or upside-down camera ribbon cable makes every app fail to start while head movements keep working, and nothing in the visible error mentions the camera. The microphone has two entries covering exactly this failure; the camera had none. Add one entry in Vision & Audio with the cable check and the two commands that actually discriminate, and point at it from "My app crashes silently or doesn't start", which is where users with this symptom land. Both commands were run on a Wireless: `rpicam-hello --list-cameras` lists imx708_wide, `dmesg | grep "camera module ID"` prints the sensor line, and dmesg needs no sudo. The note about `failed to read chip id 708` matters: the CM4's unused second CSI port always logs that probe failure, so an imx708 error line in dmesg is not a symptom. Fixes #771 Assisted-by: Claude:claude-opus-5
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
A loose or upside-down camera ribbon cable makes every app fail to start while head and body movements keep working, and the visible error is a refused connection that says nothing about the camera. #771 lost days to this. The microphone already has two troubleshooting entries covering the same failure mode; the camera had none.
Adds one entry in Vision & Audio, and a one-line pointer from "My app crashes silently or doesn't start", which is where someone with this symptom actually looks.
Both commands were run on a Wireless before documenting them:
rpicam-hello --list-cameraslistsimx708_wide(andlibcamera-hellono longer exists on the image)dmesg | grep "camera module ID"printsimx708 0-001a: camera module ID 0x0302, and dmesg needs no sudoThe note in the entry is the important part: the CM4 exposes two CSI ports and we only use one, so a healthy robot always logs
imx708 10-001a: failed to read chip id 708, with error -5for the unused port. Any diagnostic that greps dmesg for imx708 errors will therefore fire on every working robot, which is what the recommendations attached to the issue proposed doing.Fixes #771
🤖 Generated with Claude Code