Add placeholder image and update instructional text #3119
Conversation
Added whitepapers
|
@jehlers42 Can you create an Asana task to get the placeholder image redone by Design when they get a chance. Thanks. |
| The following image shows how to attach a Raspberry Pi to the back of the Touch Display using the included standoffs. It also shows the connections you need to make between Raspberry Pi and the display's PCB. You can also mount the touch display in a separate chassis if you have one available. The connections remain the same, though you may need longer cables depending on the chassis you use. | ||
|
|
||
| image::images/GPIO_power-500x333.jpg[DSI Display Connections] | ||
| image::images/GPIO_power-500x333.jpg[DSI Display pinout] |
There was a problem hiding this comment.
This image needs reshot by Brian. He has an Asana task to reshoot all (most) of the existing documentation imagery. So no need to nudge him about this one.
| === Connecting a Raspberry Pi | ||
|
|
||
| The following image shows how to attach the Raspberry Pi to the back of the Touch Display (if required), and how to connect both the data (ribbon cable) and power (red/black wires) from the Raspberry Pi to the display. If you are not attaching the Raspberry Pi to the back of the display, take extra care when attaching the ribbon cable to ensure it is the correct way round. The black and red power wires should be attached to the GND and 5v pins respectively. | ||
| The following image shows how to attach a Raspberry Pi to the back of the Touch Display using the included standoffs. It also shows the connections you need to make between Raspberry Pi and the display's PCB. You can also mount the touch display in a separate chassis if you have one available. The connections remain the same, though you may need longer cables depending on the chassis you use. |
There was a problem hiding this comment.
I think this needs properly expanding with several images that show this process step-by-step. Possibly we should go down the route of an animated GIF, e.g. see https://www.raspberrypi.com/documentation/accessories/build-hat.html#preparing-your-build-hat.
|
|
||
| ==== Powering the Touch Display | ||
|
|
||
| There are two options to power the Touch Display: using the Raspberry Pi's GPIO to send power, or powering the display directly with a separate micro USB cable. |
There was a problem hiding this comment.
Should sub-section, if there are two options there should be two separate sections.
| Make sure the Raspberry Pi is powered off and unplugged, then connect one end of the black jumper wire to pin six (GND) on the Raspberry Pi and one end of the red jumper wire to pin four (5V). Next, connect the other end of the black wire to the GND pin on the display and the other end of the red wire to the 5V pin on the display. | ||
|
|
||
| .Connect the red and black wires to 5V and GND | ||
| image::images/touch-GPIO.png[Illustration of display pins, width=250] |
There was a problem hiding this comment.
Don't use pixel widths, e.g. width=250. Instead use percentiles, e.g. width="50%"
|
It's a decent start, but was anticipating a bit more of an overhaul here. I'm not the greatest fan of FAQ-based documentation, I think it's a real failure of narrative. This page has both a "troubleshooting" and "tips and tricks" section. These really need to get integrated into the documentation proper. One thing to bear in mind is that this page has been fairly extensively modified on the |
|
Flipped it onto |
This value is 6s only in the legacy firmware stack, which is not functional in Bookworm. Signed-off-by: Naushir Patuck <naush@raspberrypi.com>
Remove xscreensaver instructions, as Wayfire comes with a built-in screensaver
X Windows -> desktop. Part of #3057
|
Closing this due to messing up during conflict resolution. New PR for redone branch is #3121; comments are being taken into account. |
|
What did you do? 😬 |
I made a rough placeholder image to illustrate the display's pins in the hopes of reducing confusion. If it's good enough, perfect. If not, I'll get someone to work up a better one.
I also updated the display article to remove (hopefully) the ambiguity of the original text. The new image plays a role. The warning text is cribbed from the display's product brief.
The initial comment in issue #2977 makes it seem like you could technically power the Pi using the display by plugging into the display while the GPIOs are connected with jumpers, but I didn't include that as an option because it doesn't seem like a great one (if it's even possible).
Closes issues #2977 and #3007.