Added documenation for 15-pin and 22-pin Camera Connectors. #3155 #4105
Conversation
philipaxer
force-pushed
the
feature/camera_connector_pinning
branch
from
fe5b321 to
a1bac26
Compare
philipaxer
force-pushed
the
feature/camera_connector_pinning
branch
4 times, most recently
from
f35900f to
5ecfc0e
Compare
philipaxer
force-pushed
the
feature/camera_connector_pinning
branch
from
5ecfc0e to
1fd2ca9
Compare
…ypi#3155 Signed-off-by: Philip Axer <philip@axonne.com>
philipaxer
force-pushed
the
feature/camera_connector_pinning
branch
from
1fd2ca9 to
0510938
Compare
|
While authoring this section, i realize that the pinout is not so straight forward as it seems. It depends on which side the connector contacts the FFC and which FFC type is in use. I tried to add a couple of clarifying statments that i would like to have known upfront. |
philipaxer
force-pushed
the
feature/camera_connector_pinning
branch
2 times, most recently
from
ed4de54 to
1ddd303
Compare
| @@ -274,8 +274,11 @@ Other available schematics; | |||
| This is the pinout of the 15-pin Camera Serial Interface (CSI) connector used on flagship Raspberry Pi models prior to the Raspberry Pi 5. | |||
| The connector type is an Amphenol SFW15R-2STE1LF or a compatible equivalent. | |||
|
|
|||
| NOTE: Most official Camera Modules have a reversed pinout to accommodate 15-pin Type A / Type 1 FFC cables. This means Pin 1 on the Raspberry Pi connects to Pin 15 on the Camera Module, and vice versa. | |||
| Direction is given from the perspective of the Raspberry Pi. | |||
| NOTE: Camera Modules that use the same 15-pin connector feature a reversed pinout to support 15-pin Type A / Type 1 FFC cables. | |||
There was a problem hiding this comment.
Thanks for the update, but IMHO this still needs additional tweaks. As I mentioned earlier, all of the official Raspberry Pi Camera Modules feature a 15-pin CSI connector, and so it doesn't make sense to talk about "Camera Modules that use...". The official Raspberry Pi documentation only covers the official Raspberry Pi accessories 🙂 (If any 3rd-party products work differently, it's up to that 3rd-party to document how to use their product safely with a Raspberry Pi)
I think this ought to be something like "NOTE: The 15-pin connector on the Raspberry Pi features a reversed pinout to the 15-pin connector on the Raspberry Pi Camera Modules."
There was a problem hiding this comment.
Ok that is something i was not aware of. I wanted to phrase this as generic as possible so that users of the Pi are aware what is going on and open source users/vendors are able to design their own modules which are interoperable. I was very confused when i ran across (obviously non-Pi) modules that on first glance looked incompatible but later turned out to use different connector styles.
There was a problem hiding this comment.
Sorry to take "a hard line" but if the official Raspberry Pi documentation made any attempt to list / document / explain compatibility with 3rd-party hardware / accessories, it'd be a never-ending game of catch up 😅 Which is why we've taken the policy we have.
| @@ -305,7 +308,10 @@ The function and direction of the GPIO lines depend on the specific Camera Modul | |||
| This is the pinout of the 22-pin Camera Serial Interface (CSI) connector used on the Raspberry Pi Zero series, the Compute Module IO boards, and flagship models since the Raspberry Pi 5. | |||
| The connector type is an Amphenol F32Q-1A7H1-11022 or a compatible equivalent. | |||
|
|
|||
| NOTE: Most official Camera Modules have a reversed pinout to accommodate https://www.raspberrypi.com/products/camera-cable/[22-pin Type A / Type 1 FFC cables]. This means Pin 1 on the Raspberry Pi connects to Pin 22 on the Camera Module, and vice versa. | |||
| NOTE: Camera Modules that use the same 22-pin connector feature a reversed pinout to accommodate https://www.raspberrypi.com/products/camera-cable/[22-pin Type A / Type 1 FFC cables]. | |||
There was a problem hiding this comment.
See above comment - we don't make any camera modules with a 22-pin connector, it's the Pi itself that has the 22-pin connector.
There was a problem hiding this comment.
I am not saying that you make such modules. The text just says that if there was one, it had flipped pinning.
There was a problem hiding this comment.
Again, it's up to 3rd-parties to document their hardware and which models of Raspberry Pi it works with, not us.
| NOTE: Most official Camera Modules have a reversed pinout to accommodate https://www.raspberrypi.com/products/camera-cable/[22-pin Type A / Type 1 FFC cables]. This means Pin 1 on the Raspberry Pi connects to Pin 22 on the Camera Module, and vice versa. | ||
| NOTE: Camera Modules that use the same 22-pin connector feature a reversed pinout to accommodate https://www.raspberrypi.com/products/camera-cable/[22-pin Type A / Type 1 FFC cables]. | ||
| As a result, Pin 1 on the Raspberry Pi connects to Pin 22 on the camera module, and vice versa. | ||
| When using third-party connectors or extension boards, be cautious - some connectors expose the opposite side of the FFC cable, effectively reversing the pin order again. |
There was a problem hiding this comment.
As it's the cable that converts from the 22-pin connector on the Raspberry Pi to the 15-pin connector on the Camera Module, IMHO this also ought to emphasise that any 3rd-party connectors / extension boards / cables also need to be compatible with https://www.raspberrypi.com/products/camera-cable/
For example you can't use https://www.raspberrypi.com/products/display-cable/ to connect a Camera Module to a Pi 5, and I've seen at least one report of somebody trying to use a 3rd-party 22-pin -> 15-pin CSI cable which didn't work because it was wired differently to the official Raspberry Pi Camera Cable.
There was a problem hiding this comment.
For example you can't use https://www.raspberrypi.com/products/display-cable/ to connect a Camera Module to a Pi 5, and I've seen at least one report of somebody trying to use a 3rd-party 22-pin -> 15-pin CSI cable which didn't work because it was wired differently to the official Raspberry Pi Camera Cable.
I think this is a good example. The documenation is not enabling people to judge what fits together and what doesnt. My original idea was to give some technical reasoning to enable people. Your approach is to state that "inside the Raspberry Pi Ecosusystem it us plug-and-play" - I guess that is fair. Let me remove this NOTE altogether then.
There was a problem hiding this comment.
Your approach is to state that "inside the Raspberry Pi Ecosusystem it us plug-and-play" - I guess that is fair.
Yeah; we're not sticking our heads in the sand and trying to pretend that 3rd-party products don't exist - they obviously do and they're a large part of the Raspberry Pi ecosystem.
We simply can't anticipate what any of those 3rd-party products do or don't do though, or how they might connect to a Raspberry Pi (which is why I'm reluctant to mention them in the official documentation), all we can do is document the available interfaces as clearly as possible.
Signed-off-by: Philip Axer <philip@axonne.com>
philipaxer
force-pushed
the
feature/camera_connector_pinning
branch
from
1ddd303 to
6ef9976
Compare
|
@lurch I removed the NOTEs. This should address your concerns. Please check. |
Yup, thank you. The wording looks fine to me, but I won't approve or merge this PR until Dominic has had a chance to review the technical details. |
This is an attempt to solve #3155 by adding documenation for the 15-pin and 22-pin Camera connectors.