From b80376906be1d12b2258934f47e9fbabba1ad640 Mon Sep 17 00:00:00 2001 From: Jeunese Date: Wed, 13 Aug 2025 13:20:32 +0100 Subject: [PATCH 01/24] Added 5-inch info and updated structure and content of the Touch Display 2 page. --- .gitignore | 1 + .../accessories/touch-display-2/about.adoc | 225 ++++++++++++------ 2 files changed, 157 insertions(+), 69 deletions(-) diff --git a/.gitignore b/.gitignore index 1d7ee958d..11aa32a47 100644 --- a/.gitignore +++ b/.gitignore @@ -5,3 +5,4 @@ build-pico-sdk-docs documentation/html documentation/asciidoc/pico-sdk .venv +.env diff --git a/documentation/asciidoc/accessories/touch-display-2/about.adoc b/documentation/asciidoc/accessories/touch-display-2/about.adoc index ed4014991..329080bed 100644 --- a/documentation/asciidoc/accessories/touch-display-2/about.adoc +++ b/documentation/asciidoc/accessories/touch-display-2/about.adoc @@ -1,136 +1,223 @@ -== About - -The https://www.raspberrypi.com/products/touch-display-2/[Raspberry Pi Touch Display 2] is a portrait orientation touchscreen LCD display designed for interactive projects like tablets, entertainment systems, and information dashboards. +The https://www.raspberrypi.com/products/touch-display-2/[Raspberry Pi Touch Display 2] is a portrait orientation (with rotation options) touchscreen LCD designed for interactive projects like tablets, entertainment systems, and information dashboards. .The Raspberry Pi Touch Display 2 image::images/touch-display-2-hero.jpg[width="80%"] -The Touch Display 2 connects to a Raspberry Pi using a DSI connector and GPIO connector. Raspberry Pi OS provides touchscreen drivers with support for five-finger multitouch and an on-screen keyboard, providing full functionality without the need to connect a keyboard or mouse. - == Specifications -* 1280×720px resolution, 24-bit RGB display -* 155×88mm active area -* 7" diagonal -* powered directly by the host Raspberry Pi, requiring no separate power supply -* supports up to five points of simultaneous multi-touch +The Touch Display 2 comes in two sizes, and supports five-point multitouch and an on-screen keyboard, providing full input functionality without the need to connect a keyboard or mouse. This section describes the physical characteristics and capabilities of Touch Display 2, including dimensions, features, and hardware. -The Touch Display 2 is compatible with all models of Raspberry Pi from Raspberry Pi 1B+ onwards, except the Zero series and Keyboard series, which lack a DSI connector. +=== Dimensions + +The Touch Display 2 comes in two sizes: 5-inch and 7-inch (measured diagonally). Aside from the physical size, these two displays have identical features and functionality. The following table summarises the dimensions of these two displays: + +[cols="1,1,1"] +|=== +| +|*5-inch display* +|*7-inch display* + +|*Depth* +|15 mm +|16 mm + +|*Viewing area* +|111 x 63 mm +|155 x 88 mm + +|*Active area* +|110 x 62 mm +|155 x 87 mm +|=== + +=== Features +The Touch Display 2 (both 5-inch and 7-inch) includes the following features: + +* **Resolution.** 720 x 1280 pixel resolution. +* **Colour depth.** 24-bit RGB display, capable of showing over 16 million colours. +* **Multitouch.** Supports up to five simultaneous touch points and an on-screen keyboard. +* **Mouse-equivalence.** Supports full desktop control without a physical mouse, for example, selecting, dragging, scrolling, and long-pressing for menus. +* **On-screen keyboard.** Supports a visual keyboard in place of a physical keyboard. +* **Integrated power.** Powered directly by the host Raspberry Pi, requiring no separate power supply. -The Touch Display 2 box contains the following parts (in left to right, top to bottom order in the image below): +=== Hardware -* Touch Display 2 -* eight M2.5 screws -* 15-way to 15-way FFC -* 22-way to 15-way FFC for Raspberry Pi 5 -* GPIO connector cable +The Touch Display 2 box contains the following parts: + +- A Touch Display 2 +- Eight M2.5 screws +- A 15-way to 15-way FFC +- A 22-way to 15-way FFC for Raspberry Pi 5 +- A GPIO connector cable + +The following image shows these items from top to bottom, left to right. .Parts included in the Touch Display 2 box image::images/touch-display-2-whats-in-the-booooox.jpg["Parts included in the Touch Display 2 box", width="80%"] -== Install +=== Connectors + +The Touch Display 2 connects to a Raspberry Pi using: + +- A **DSI connector** for video and touch data. +- The **GPIO header** for power. + +To make the DSI connection, use a **Flat Flexible Cable (FFC)** included with your display. The type of FFC you need depends on your Raspberry Pi model: + +- For **Raspberry Pi 5**, use the **22-way to 15-way FFC**. +- For all other Raspberry Pi models, use the **15-way to 15-way FFC**. + +The Touch Display 2 is compatible with all models of Raspberry Pi from Raspberry Pi 1B+ onwards, except the Zero series and Keyboard series, which lack a DSI connector. + +== Connect to Raspberry Pi + +After determining the correct FFC for your Raspberry Pi model, you can connect your Touch Display 2 to your Raspberry Pi. After completing the following steps, you can reconnect your Raspberry Pi to power. It can take up to one minute to initialise the Touch Display 2 connection and begin displaying to the screen. .A Raspberry Pi 5 connected and mounted to the Touch Display 2 image::images/touch-display-2-installation-diagram.png["A Raspberry Pi 5 connected and mounted to the Touch Display 2", width="80%"] -To connect a Touch Display 2 to a Raspberry Pi, use a Flat Flexible Cable (FFC) and a GPIO connector. The FFC you'll use depends upon your Raspberry Pi model: - -* for Raspberry Pi 5, use the included 22-way to 15-way FFC -* for any other Raspberry Pi model, use the included 15-way to 15-way FFC +IMPORTANT: Disconnect your Raspberry Pi from power before completing the following steps. -Once you have determined the correct FFC for your Raspberry Pi model, complete the following steps to connect your Touch Display 2 to your Raspberry Pi: +=== Step 1. Connect FFC to Touch Display 2 -. Disconnect your Raspberry Pi from power. -. Lift the retaining clips on either side of the FFC connector on the Touch Display 2. +. Slide the retaining clip outwards from both sides of the FFC connector on the Touch Display 2 to secure the cable. . Insert one 15-way end of your FFC into the Touch Display 2 FFC connector, with the metal contacts facing upwards, away from the Touch Display 2. -+ -TIP: If you use the 22-way to 15-way FFC, the 22-way end is the _smaller_ end of the cable. Insert the _larger_ end of the cable into the Touch Display 2. -. While holding the FFC firmly in place, simultaneously push both retaining clips down on the FFC connector of the Touch Display 2. -. Lift the retaining clips on either side of the DSI connector of your Raspberry Pi. This port should be marked with some variation of the term `DISPLAY` or `DISP`. If your Raspberry Pi has multiple DSI connectors, prefer the port labelled `1`. -. Insert the other end of your FFC into the Raspberry Pi DSI connector, with the metal contacts facing towards the Ethernet and USB-A ports. -. While holding the FFC firmly in place, simultaneously push both retaining clips down on the DSI connector of the Raspberry Pi. -. Plug the GPIO connector cable into the port marked `J1` on the Touch Display 2. -. Connect the other (three-pin) end of the GPIO connector cable to pins 2, 4, and 6 of the xref:../computers/raspberry-pi.adoc#gpio[Raspberry Pi's GPIO]. Connect the red cable (5V power) to pin 2, and the black cable (ground) to pin 6. Viewed from above, with the Ethernet and USB-A ports facing down, these pins are located at the top right of the board, with pin 2 in the top right-most position. -+ + - If you're connecting to a Raspberry Pi 5, and therefore using the **22-way to 15-way FFC**, the 22-way end is the smaller end of the cable. Insert the larger end of the cable into the Touch Display 2. + - If you're using the **15-way to 15-way FFC**, insert either end of the cable into the Touch Display 2 FFC connector. +. Hold the FFC firmly in place and simultaneously push the retaining clip back in to the Touch Display 2 FFC connector from both sides. + +=== Step 2. Connect FFC to Raspberry Pi + +. Slide the retaining clip upwards from both sides of the DSI connector of your Raspberry Pi. + - This port should be marked with some variation of the term **DISPLAY** or **DISP**. + - If your Raspberry Pi has multiple DSI connectors, we recommend using the port labelled **1**. +. Insert the other end of your FFC into the Raspberry Pi DSI connector, with the metal contacts facing the Ethernet and USB-A ports. +. Hold the FFC firmly in place and simultaneously push the retaining clip back in on the FFC connector of the Raspberry Pi to secure the cable. + +=== Step 3. Connect the GPIO power cable + +. Plug the smaller end of the GPIO power cable into the **J1** port on the Touch Display 2. +. Connect the three-pin end of the GPIO power cable to your xref:../computers/raspberry-pi.adoc#gpio[Raspberry Pi's GPIO]. + +This connects the red cable (5 V power) to pin 2 and the black cable (ground) to pin 6. Viewed from above, with the Ethernet and USB-A ports facing down, these pins are located in the top-right corner of the board, with pin 2 in the top right-most position. + .The GPIO connection to the Touch Display 2 image::images/touch-display-2-gpio-connection.png[The GPIO connection to the Touch Display 2, width="40%"] -+ -TIP: If pin 6 isn't available, you can use any other open `GND` pin to connect the black wire. If pin 2 isn't available, you can use any other 5V pin to connect the red wire, such as pin 4. -. Optionally, use the included M2.5 screws to mount your Raspberry Pi to the back of the Touch Display 2. -.. Align the four corner stand-offs of your Raspberry Pi with the four mount points that surround the FFC connector and `J1` port on the back of the Touch Display 2, taking special care not to pinch the FFC. -.. Insert the screws into the four corner stand-offs and tighten until your Raspberry Pi is secure. -. Reconnect your Raspberry Pi to power. It may take up to one minute to initialise the Touch Display 2 connection and begin displaying to the screen. -=== Use an on-screen keyboard +=== Step 4. Mount your Touch Display 2 (optional) + +Optionally, use the included M2.5 screws to mount your Raspberry Pi to the back of your Touch Display 2. + +. Align the four corner stand-offs of your Raspberry Pi with the four mount points that surround the FFC connector and J1 port on the back of the Touch Display 2. +. Insert the M2.5 screws (included) into the four corner stand-offs and tighten until your Raspberry Pi is secure. + +Take care not to pinch the FFC. + +== Use an on-screen keyboard + +A Raspberry Pi with OS **Bookworm** or later already includes the **Squeakboard on-screen keyboard**. With a Touch Display 2 is attached, the keyboard automatically appears when you can enter text, and automatically disappears when you can't. -Raspberry Pi OS _Bookworm_ and later include the Squeekboard on-screen keyboard by default. When a touch display is attached, the on-screen keyboard should automatically show when it is possible to enter text and automatically hide when it is not possible to enter text. +For applications that don't support text entry detection, you can manually show or hide the keyboard using the keyboard icon at the right side of the taskbar. You can also permanently show or hide the on-screen keyboard using the Raspberry Pi graphical interface or the command line: -For applications which do not support text entry detection, use the keyboard icon at the right end of the taskbar to manually show and hide the keyboard. +- **Raspberry Pi desktop interface.** From the Raspberry Pi menu, go to **Preferences > Raspberry Pi Configuration > Display** and choose your on-screen keyboard setting. +- **Command line.** Open a terminal and enter `sudo raspi-config`. Navigate to the **Display** section or `raspi-config` and then choose your keyboard setting. -You can also permanently show or hide the on-screen keyboard in the Display tab of Raspberry Pi Configuration or the `Display` section of `raspi-config`. +== Change screen orientation -TIP: In Raspberry Pi OS releases prior to _Bookworm_, use `matchbox-keyboard` instead. If you use the wayfire desktop compositor, use `wvkbd` instead. +You can change the orientation and coordinate behaviour of the Touch Display 2, both in a desktop environment and without a desktop (“headless”). This is useful if you want to physically rotate the screen or mount it in a landscape position. +You have four rotation options: -=== Change screen orientation +- **0** maintains the default display position, which is a portrait orientation. +- **90** rotates the display 90 degrees to the right (clockwise), making it a landscape orientation. +- **180** rotates the display 180 degrees to the right (clockwise), which flips the display upside down. +- **270** rotates the display 270 degrees to the right (clockwise), which is the same as rotating the display 90 degrees to the left (counterclockwise), making it a landscape orientation. -If you want to physically rotate the display, or mount it in a specific position, select **Screen Configuration** from the **Preferences** menu. Right-click on the touch display rectangle (likely DSI-1) in the layout editor, select **Orientation**, then pick the best option to fit your needs. +=== In a desktop environment -==== Rotate screen without a desktop +If you have the Raspberry Pi OS desktop running, you can rotate the display through the **Screen Configuration** tool: -To set the screen orientation on a device that lacks a desktop environment, edit the `/boot/firmware/cmdline.txt` configuration file to pass an orientation to the system. Add the following entry to the end of `cmdline.txt`: +. Go to **Preferences > Screen Configuration**. This opens the layout editor where you can see your connected displays. +. Right-click the rectangle in the layout editor that represents your Touch Display 2 (likely labelled `DSI-1`). +. Select **Orientation**. +. Choose a rotation: *0°*, *90°*, *180°*, or *270°*. This rotates the display by the specified degrees to the right. + +=== In a headless environment + +To rotate the display without a desktop, edit the `/boot/firmware/cmdline.txt` file, which contains parameters that the system reads when it boots. Add the following to the end of `cmdline.txt`, replacing `` with a degree of rotation (`0`, `90`, `180`, or `270`): [source,ini] ---- video=DSI-1:720x1280@60,rotate= ---- -Replace the `` placeholder with one of the following values, which correspond to the degree of rotation relative to the default on your display: +You can replace `DSI-1` with the appropriate label if using a different DSI connector. + +You can't rotate the DSI display separately from the HDMI display with `cmdline.txt`. When you use DSI and HDMI simultaneously, they share the same rotation value. + +== Customise settings + +You can use the Device Tree overlay to tell Raspberry Pi how to configure the Touch Display 2 at boot. + +- For the 5-inch display, the overlay is called `vc4-kms-dsi-ili9881-5inch`. +- For the 7-inch display, the overlay is called `vc4-kms-dsi-ili9881-7inch`. -* `0` -* `90` -* `180` -* `270` +You can modify the device tree overlay in the boot configuration file (`/boot/firmware/configuration.txt`). This is a more flexible way to control rotation, resolution, and touch behaviour, compared to editing `cmdline.txt`` alone. -For example, a rotation value of `90` rotates the display 90 degrees to the right. `180` rotates the display 180 degrees, or upside-down. +Open `/boot/firmware/configuration.txt` and then add the required device tree parameters to the `dtverlay` line, separated by commas. -NOTE: It is not possible to rotate the DSI display separately from the HDMI display with `cmdline.txt`. When you use DSI and HDMI simultaneously, they share the same rotation value. +- Booleans (`invx`, `invy`, `swapxy`, and `disable_touch`) default to true if present, but you can set them to false using the suffix `=0`. +- Integers (`sizex` and `sizey`) require a number, for example, `sizey=240`. -==== Touch Display 2 device tree option reference +See the table below for details. -The `vc4-kms-dsi-ili9881-7inch` overlay supports the following options: +=== Device Tree options |=== -| DT parameter | Action +| Parameter | Action | `sizex` -| Sets X resolution (default 720) +| Sets the horizontal resolution (default 720) | `sizey` -| Sets Y resolution (default 1280) +| Sets the vertical resolution (default 1280) | `invx` -| Invert X coordinates +| Inverts the X-axis (left/right) | `invy` -| Invert Y coordinates +| Inverts the Y-axis (up/down) | `swapxy` -| Swap X and Y coordinates +| Swaps the X and Y axes (rotate 90° logically) | `disable_touch` -| Disables the touch overlay totally +| Turns off the touchscreen functionality |=== -To specify these options, add them, separated by commas, to your `dtoverlay` line in `/boot/firmware/config.txt`. Boolean values default to true when present, but you can set them to false using the suffix "=0". Integer values require a value, e.g. `sizey=240`. For instance, to set the X resolution to 400 pixels and invert both X and Y coordinates, use the following line: +=== Example + +To set X resolution to 400 and invert both axes: [source,ini] ---- dtoverlay=vc4-kms-dsi-ili9881-7inch,sizex=400,invx,invy ---- -=== Installation and software setup on Compute Module based devices. +In the above example: +- `sizex=400` sets the horizontal resolution to 400. +- `invx` flips the X axis. +- `invy` flips the Y axis. + +== Connect to a Compute Module + +Unlike Raspberry Pi single board computers (SBC), which automatically detect the official Raspberry Pi Touch displays, Raspberry Pi Compute Modules don't automatically detect connected devices; you must tell it what display is attached. + +This is because the DSI connector on a Raspberry Pi is fixed and the system knows what hardware is connected; auto-detection ensures that the correct Device Tree settings are passed to the Linux kernel, so the display works without additional configuration. + +Compute Modules, intended for industrial and custom applications, expose all GPIOs and interfaces. This provides greater flexibility for connecting hardware, but means that a Compute Module can't automatically detect devices like the Touch Display 2. This means that, for Compute Modules, the Device Tree fragments, which tell the kernel how to interact with the display, must be manually specified. You can do this in three ways: -All Raspberry Pi SBCs auto-detect the official Touch Displays as the circuitry connected to the DSI connector on the Raspberry Pi board is fixed; this autodetection ensures the correct Device Tree entries are passed to the kernel. However, Compute Modules are intended for industrial applications where the integrator can use any and all GPIOs and interfaces for whatever purposes they require. Autodetection is therefore not feasible, and hence is disabled on Compute Module devices. This means that the Device Tree fragments required to set up the display need to be loaded via some other mechanism, which can be either with a dtoverlay entry in config.txt, via a custom base DT file, or if present, a HAT EEPROM. +- By adding an overlay entry in `config.txt`. This is the simplest option. For configuration instructions, see the xref:../computers/compute-module.adoc#attaching-the-touch-display-2-lcd-panel[Compute Module hardware documentation]. +- Using a custom base device tree file. This is an advanced method not covered in this online documentation. +- Using a HAT EEPROM (if present). -Creating a custom base Device tree file is beyond the scope of this documentation, however, it is simple to add an appropriate device tree entry via `config.txt`. See this xref:../computers/compute-module.adoc#attaching-the-touch-display-2-lcd-panel[page] for configuration details. From 2257439b49ec26749a7b0cddfc8c23b0ba1b6507 Mon Sep 17 00:00:00 2001 From: Jeunese Date: Wed, 13 Aug 2025 15:08:13 +0100 Subject: [PATCH 02/24] Formatting of table; parallel phrasing for Feature list. --- .../accessories/touch-display-2/about.adoc | 30 ++++++++++--------- 1 file changed, 16 insertions(+), 14 deletions(-) diff --git a/documentation/asciidoc/accessories/touch-display-2/about.adoc b/documentation/asciidoc/accessories/touch-display-2/about.adoc index 329080bed..fd4d9f4b9 100644 --- a/documentation/asciidoc/accessories/touch-display-2/about.adoc +++ b/documentation/asciidoc/accessories/touch-display-2/about.adoc @@ -11,30 +11,32 @@ The Touch Display 2 comes in two sizes, and supports five-point multitouch and a The Touch Display 2 comes in two sizes: 5-inch and 7-inch (measured diagonally). Aside from the physical size, these two displays have identical features and functionality. The following table summarises the dimensions of these two displays: -[cols="1,1,1"] +[cols="1,1,1,1,1"] |=== | -|*5-inch display* -|*7-inch display* - |*Depth* -|15 mm -|16 mm - +|*Outline dimensions* |*Viewing area* -|111 x 63 mm -|155 x 88 mm - |*Active area* -|110 x 62 mm -|155 x 87 mm + +|*5-inch display* +|16 mm +|143.5 x 91.5 mm +|111.5 x 63 mm +|110.5 x 62 mm + +|*7-inch display* +|15 mm +|189.5 x 120 mm +|155.5 x 88 mm +|154.5 x 87 mm |=== === Features The Touch Display 2 (both 5-inch and 7-inch) includes the following features: -* **Resolution.** 720 x 1280 pixel resolution. -* **Colour depth.** 24-bit RGB display, capable of showing over 16 million colours. +* **720 x 1280 pixel resolution.** High-definition output. +* **24-bit RGB display.** Capable of showing over 16 million colours. * **Multitouch.** Supports up to five simultaneous touch points and an on-screen keyboard. * **Mouse-equivalence.** Supports full desktop control without a physical mouse, for example, selecting, dragging, scrolling, and long-pressing for menus. * **On-screen keyboard.** Supports a visual keyboard in place of a physical keyboard. From 7fa8314738f7320848a1cc12b1fd283e4923186d Mon Sep 17 00:00:00 2001 From: Jeunese Date: Wed, 13 Aug 2025 17:59:28 +0100 Subject: [PATCH 03/24] Dealing with @lurch and @6by9 comments --- .../accessories/touch-display-2/about.adoc | 70 +++++++++---------- 1 file changed, 33 insertions(+), 37 deletions(-) diff --git a/documentation/asciidoc/accessories/touch-display-2/about.adoc b/documentation/asciidoc/accessories/touch-display-2/about.adoc index fd4d9f4b9..1844ec516 100644 --- a/documentation/asciidoc/accessories/touch-display-2/about.adoc +++ b/documentation/asciidoc/accessories/touch-display-2/about.adoc @@ -5,11 +5,11 @@ image::images/touch-display-2-hero.jpg[width="80%"] == Specifications -The Touch Display 2 comes in two sizes, and supports five-point multitouch and an on-screen keyboard, providing full input functionality without the need to connect a keyboard or mouse. This section describes the physical characteristics and capabilities of Touch Display 2, including dimensions, features, and hardware. +This section describes the physical characteristics and capabilities of Touch Display 2, including dimensions, features, and hardware. === Dimensions -The Touch Display 2 comes in two sizes: 5-inch and 7-inch (measured diagonally). Aside from the physical size, these two displays have identical features and functionality. The following table summarises the dimensions of these two displays: +The Touch Display 2 is available in two sizes: 5-inch and 7-inch (measured diagonally). Aside from the physical size, these two displays have identical features and functionality. The following table summarises the dimensions of these two displays: [cols="1,1,1,1,1"] |=== @@ -33,7 +33,7 @@ The Touch Display 2 comes in two sizes: 5-inch and 7-inch (measured diagonally) |=== === Features -The Touch Display 2 (both 5-inch and 7-inch) includes the following features: +Touch Display 2 (both 5-inch and 7-inch) includes the following features: * **720 x 1280 pixel resolution.** High-definition output. * **24-bit RGB display.** Capable of showing over 16 million colours. @@ -50,7 +50,7 @@ The Touch Display 2 box contains the following parts: - Eight M2.5 screws - A 15-way to 15-way FFC - A 22-way to 15-way FFC for Raspberry Pi 5 -- A GPIO connector cable +- A GPIO power cable The following image shows these items from top to bottom, left to right. @@ -73,7 +73,7 @@ The Touch Display 2 is compatible with all models of Raspberry Pi from Raspberry == Connect to Raspberry Pi -After determining the correct FFC for your Raspberry Pi model, you can connect your Touch Display 2 to your Raspberry Pi. After completing the following steps, you can reconnect your Raspberry Pi to power. It can take up to one minute to initialise the Touch Display 2 connection and begin displaying to the screen. +After determining the correct FFC for your Raspberry Pi model, you can connect your Touch Display 2 to your Raspberry Pi. After completing the following steps, you can reconnect your Raspberry Pi to power. It can take up to one minute for Raspberry Pi OS to start displaying output to the Touch Display 2 screen. .A Raspberry Pi 5 connected and mounted to the Touch Display 2 image::images/touch-display-2-installation-diagram.png["A Raspberry Pi 5 connected and mounted to the Touch Display 2", width="80%"] @@ -84,14 +84,14 @@ IMPORTANT: Disconnect your Raspberry Pi from power before completing the followi . Slide the retaining clip outwards from both sides of the FFC connector on the Touch Display 2 to secure the cable. . Insert one 15-way end of your FFC into the Touch Display 2 FFC connector, with the metal contacts facing upwards, away from the Touch Display 2. - - If you're connecting to a Raspberry Pi 5, and therefore using the **22-way to 15-way FFC**, the 22-way end is the smaller end of the cable. Insert the larger end of the cable into the Touch Display 2. + - If you're connecting to a Raspberry Pi 5, and therefore using the **22-way to 15-way FFC**, the 22-way end is the smaller end of the cable. Insert the larger end of the cable into the Touch Display 2 FFC connector. - If you're using the **15-way to 15-way FFC**, insert either end of the cable into the Touch Display 2 FFC connector. . Hold the FFC firmly in place and simultaneously push the retaining clip back in to the Touch Display 2 FFC connector from both sides. === Step 2. Connect FFC to Raspberry Pi . Slide the retaining clip upwards from both sides of the DSI connector of your Raspberry Pi. - - This port should be marked with some variation of the term **DISPLAY** or **DISP**. + - This port should be marked with some variation of the term **DISPLAY**, **CAM/DISP**, or **DISP**. - If your Raspberry Pi has multiple DSI connectors, we recommend using the port labelled **1**. . Insert the other end of your FFC into the Raspberry Pi DSI connector, with the metal contacts facing the Ethernet and USB-A ports. . Hold the FFC firmly in place and simultaneously push the retaining clip back in on the FFC connector of the Raspberry Pi to secure the cable. @@ -106,27 +106,30 @@ This connects the red cable (5 V power) to pin 2 and the black cable (ground) to .The GPIO connection to the Touch Display 2 image::images/touch-display-2-gpio-connection.png[The GPIO connection to the Touch Display 2, width="40%"] +WARNING:Incorrect connection of power might cause damage to the display. + === Step 4. Mount your Touch Display 2 (optional) Optionally, use the included M2.5 screws to mount your Raspberry Pi to the back of your Touch Display 2. -. Align the four corner stand-offs of your Raspberry Pi with the four mount points that surround the FFC connector and J1 port on the back of the Touch Display 2. +. Align the four corner stand-offs of your Raspberry Pi with the four mounting points that surround the FFC connector and J1 port on the back of the Touch Display 2. . Insert the M2.5 screws (included) into the four corner stand-offs and tighten until your Raspberry Pi is secure. Take care not to pinch the FFC. == Use an on-screen keyboard -A Raspberry Pi with OS **Bookworm** or later already includes the **Squeakboard on-screen keyboard**. With a Touch Display 2 is attached, the keyboard automatically appears when you can enter text, and automatically disappears when you can't. +A Raspberry Pi with OS **Bookworm** or later already includes the **Squeakboard on-screen keyboard**. With a Touch Display 2 attached, the keyboard automatically appears when you can enter text, and automatically disappears when you can't. -For applications that don't support text entry detection, you can manually show or hide the keyboard using the keyboard icon at the right side of the taskbar. You can also permanently show or hide the on-screen keyboard using the Raspberry Pi graphical interface or the command line: +For applications that don't support text entry detection, you can manually show or hide the keyboard using the keyboard icon at the right side of the taskbar. You can also permanently show or hide the on-screen keyboard using the Raspberry Pi graphical interface or the command line. -- **Raspberry Pi desktop interface.** From the Raspberry Pi menu, go to **Preferences > Raspberry Pi Configuration > Display** and choose your on-screen keyboard setting. -- **Command line.** Open a terminal and enter `sudo raspi-config`. Navigate to the **Display** section or `raspi-config` and then choose your keyboard setting. +- **Raspberry Pi desktop interface:** From the Raspberry Pi menu, go to **Preferences > Raspberry Pi Configuration > Display** and choose your on-screen keyboard setting. +- **Command line:** Open a terminal and enter `sudo raspi-config`. Navigate to the **Display** section of `raspi-config` and then choose your keyboard setting. == Change screen orientation -You can change the orientation and coordinate behaviour of the Touch Display 2, both in a desktop environment and without a desktop (“headless”). This is useful if you want to physically rotate the screen or mount it in a landscape position. +You can change the orientation behaviour of the Touch Display 2, both with a desktop and without a desktop. This is useful if you want to physically rotate the screen or mount it in a landscape position. + You have four rotation options: - **0** maintains the default display position, which is a portrait orientation. @@ -134,38 +137,35 @@ You have four rotation options: - **180** rotates the display 180 degrees to the right (clockwise), which flips the display upside down. - **270** rotates the display 270 degrees to the right (clockwise), which is the same as rotating the display 90 degrees to the left (counterclockwise), making it a landscape orientation. -=== In a desktop environment - +=== With a desktop If you have the Raspberry Pi OS desktop running, you can rotate the display through the **Screen Configuration** tool: . Go to **Preferences > Screen Configuration**. This opens the layout editor where you can see your connected displays. . Right-click the rectangle in the layout editor that represents your Touch Display 2 (likely labelled `DSI-1`). . Select **Orientation**. -. Choose a rotation: *0°*, *90°*, *180°*, or *270°*. This rotates the display by the specified degrees to the right. +. Choose a rotation: *0°*, *90°*, *180°*, or *270°*. This rotates the display by the specified number of degrees to the right. -=== In a headless environment +=== Without a desktop -To rotate the display without a desktop, edit the `/boot/firmware/cmdline.txt` file, which contains parameters that the system reads when it boots. Add the following to the end of `cmdline.txt`, replacing `` with a degree of rotation (`0`, `90`, `180`, or `270`): +To rotate the display without a desktop, edit the `/boot/firmware/cmdline.txt` file, which contains parameters that the Raspberry Pi OS reads when it boots. Add the following to the end of `cmdline.txt`, replacing `` with the number of degrees to rotate by (`0`, `90`, `180`, or `270`): [source,ini] ---- video=DSI-1:720x1280@60,rotate= ---- -You can replace `DSI-1` with the appropriate label if using a different DSI connector. - -You can't rotate the DSI display separately from the HDMI display with `cmdline.txt`. When you use DSI and HDMI simultaneously, they share the same rotation value. +NOTE: You can't rotate the DSI display separately from the HDMI display with `cmdline.txt`. When you use DSI and HDMI simultaneously, they share the same rotation value. == Customise settings -You can use the Device Tree overlay to tell Raspberry Pi how to configure the Touch Display 2 at boot. +You can use the Device Tree overlay to tell the Raspberry Pi OS how to configure the Touch Display 2 at boot. - For the 5-inch display, the overlay is called `vc4-kms-dsi-ili9881-5inch`. - For the 7-inch display, the overlay is called `vc4-kms-dsi-ili9881-7inch`. -You can modify the device tree overlay in the boot configuration file (`/boot/firmware/configuration.txt`). This is a more flexible way to control rotation, resolution, and touch behaviour, compared to editing `cmdline.txt`` alone. +You can modify the device tree overlay in the boot configuration file (`/boot/firmware/config.txt`). This is a more flexible way to control rotation, resolution, and touch behaviour, compared to editing `cmdline.txt` alone. -Open `/boot/firmware/configuration.txt` and then add the required device tree parameters to the `dtverlay` line, separated by commas. +Open `/boot/firmware/config.txt` and then add the required device tree parameters to the `dtoverlay` line, separated by commas. - Booleans (`invx`, `invy`, `swapxy`, and `disable_touch`) default to true if present, but you can set them to false using the suffix `=0`. - Integers (`sizex` and `sizey`) require a number, for example, `sizey=240`. @@ -178,43 +178,39 @@ See the table below for details. | Parameter | Action | `sizex` -| Sets the horizontal resolution (default 720) +| Sets the touch horizontal resolution (default 720) | `sizey` -| Sets the vertical resolution (default 1280) +| Sets the touch vertical resolution (default 1280) | `invx` -| Inverts the X-axis (left/right) +| Inverts the touch X-axis (left/right) | `invy` -| Inverts the Y-axis (up/down) +| Inverts the touch Y-axis (up/down) | `swapxy` -| Swaps the X and Y axes (rotate 90° logically) +| Swaps the touch X and Y axes (rotate 90° logically) | `disable_touch` -| Turns off the touchscreen functionality +| Disables the touchscreen functionality |=== === Example -To set X resolution to 400 and invert both axes: +In the following example, `invx` flips the X axis, and `invy` flips the Y axis: [source,ini] ---- -dtoverlay=vc4-kms-dsi-ili9881-7inch,sizex=400,invx,invy +dtoverlay=vc4-kms-dsi-ili9881-7inch,invx,invy ---- -In the above example: -- `sizex=400` sets the horizontal resolution to 400. -- `invx` flips the X axis. -- `invy` flips the Y axis. == Connect to a Compute Module Unlike Raspberry Pi single board computers (SBC), which automatically detect the official Raspberry Pi Touch displays, Raspberry Pi Compute Modules don't automatically detect connected devices; you must tell it what display is attached. -This is because the DSI connector on a Raspberry Pi is fixed and the system knows what hardware is connected; auto-detection ensures that the correct Device Tree settings are passed to the Linux kernel, so the display works without additional configuration. +This is because the the connections between the SoC and DSI connectors on a Raspberry Pi are fixed and the system knows what hardware is connected; auto-detection ensures that the correct Device Tree settings are passed to the Linux kernel, so the display works without additional configuration. Compute Modules, intended for industrial and custom applications, expose all GPIOs and interfaces. This provides greater flexibility for connecting hardware, but means that a Compute Module can't automatically detect devices like the Touch Display 2. This means that, for Compute Modules, the Device Tree fragments, which tell the kernel how to interact with the display, must be manually specified. You can do this in three ways: From 0d53fc4279e474e721e43d6ee13d4f4aeb80ea80 Mon Sep 17 00:00:00 2001 From: Jeunese Date: Wed, 13 Aug 2025 18:30:26 +0100 Subject: [PATCH 04/24] Dealing with more review comments --- .../asciidoc/accessories/touch-display-2/about.adoc | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/documentation/asciidoc/accessories/touch-display-2/about.adoc b/documentation/asciidoc/accessories/touch-display-2/about.adoc index 1844ec516..10b4d3c19 100644 --- a/documentation/asciidoc/accessories/touch-display-2/about.adoc +++ b/documentation/asciidoc/accessories/touch-display-2/about.adoc @@ -106,7 +106,7 @@ This connects the red cable (5 V power) to pin 2 and the black cable (ground) to .The GPIO connection to the Touch Display 2 image::images/touch-display-2-gpio-connection.png[The GPIO connection to the Touch Display 2, width="40%"] -WARNING:Incorrect connection of power might cause damage to the display. +WARNING: Correcting the power cable incorrectly might cause damage to the display. === Step 4. Mount your Touch Display 2 (optional) @@ -147,7 +147,7 @@ If you have the Raspberry Pi OS desktop running, you can rotate the display thro === Without a desktop -To rotate the display without a desktop, edit the `/boot/firmware/cmdline.txt` file, which contains parameters that the Raspberry Pi OS reads when it boots. Add the following to the end of `cmdline.txt`, replacing `` with the number of degrees to rotate by (`0`, `90`, `180`, or `270`): +To rotate the display without a desktop, edit the `/boot/firmware/cmdline.txt` file, which contains parameters that Raspberry Pi OS reads when it boots. Add the following to the end of `cmdline.txt`, replacing `` with the number of degrees to rotate by (`0`, `90`, `180`, or `270`): [source,ini] ---- @@ -156,16 +156,16 @@ video=DSI-1:720x1280@60,rotate= NOTE: You can't rotate the DSI display separately from the HDMI display with `cmdline.txt`. When you use DSI and HDMI simultaneously, they share the same rotation value. -== Customise settings +== Customise touchscreen settings You can use the Device Tree overlay to tell the Raspberry Pi OS how to configure the Touch Display 2 at boot. - For the 5-inch display, the overlay is called `vc4-kms-dsi-ili9881-5inch`. - For the 7-inch display, the overlay is called `vc4-kms-dsi-ili9881-7inch`. -You can modify the device tree overlay in the boot configuration file (`/boot/firmware/config.txt`). This is a more flexible way to control rotation, resolution, and touch behaviour, compared to editing `cmdline.txt` alone. +You can modify the Device Tree overlay in the boot configuration file (`/boot/firmware/config.txt`). -Open `/boot/firmware/config.txt` and then add the required device tree parameters to the `dtoverlay` line, separated by commas. +Open `/boot/firmware/config.txt` and then add the required Device Tree parameters to the `dtoverlay` line, separated by commas. - Booleans (`invx`, `invy`, `swapxy`, and `disable_touch`) default to true if present, but you can set them to false using the suffix `=0`. - Integers (`sizex` and `sizey`) require a number, for example, `sizey=240`. @@ -198,7 +198,7 @@ See the table below for details. === Example -In the following example, `invx` flips the X axis, and `invy` flips the Y axis: +In the following example, `invx` flips the X axis, and `invy` flips the Y axis for the 7-inch Touch Display 2: [source,ini] ---- From 4469a773c4ff6721521f9e779f98492264a72c38 Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 13:10:07 +0100 Subject: [PATCH 05/24] Update documentation/asciidoc/accessories/touch-display-2/about.adoc Co-authored-by: Andrew Scheller --- documentation/asciidoc/accessories/touch-display-2/about.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/accessories/touch-display-2/about.adoc b/documentation/asciidoc/accessories/touch-display-2/about.adoc index 10b4d3c19..443cc48a6 100644 --- a/documentation/asciidoc/accessories/touch-display-2/about.adoc +++ b/documentation/asciidoc/accessories/touch-display-2/about.adoc @@ -37,7 +37,7 @@ Touch Display 2 (both 5-inch and 7-inch) includes the following features: * **720 x 1280 pixel resolution.** High-definition output. * **24-bit RGB display.** Capable of showing over 16 million colours. -* **Multitouch.** Supports up to five simultaneous touch points and an on-screen keyboard. +* **Multitouch.** Supports up to five simultaneous touch points. * **Mouse-equivalence.** Supports full desktop control without a physical mouse, for example, selecting, dragging, scrolling, and long-pressing for menus. * **On-screen keyboard.** Supports a visual keyboard in place of a physical keyboard. * **Integrated power.** Powered directly by the host Raspberry Pi, requiring no separate power supply. From 1d5d7526ea60d1df6194a11f320a93151e4db698 Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 13:11:27 +0100 Subject: [PATCH 06/24] Update documentation/asciidoc/accessories/touch-display-2/about.adoc Co-authored-by: Andrew Scheller --- documentation/asciidoc/accessories/touch-display-2/about.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/accessories/touch-display-2/about.adoc b/documentation/asciidoc/accessories/touch-display-2/about.adoc index 443cc48a6..c644d718d 100644 --- a/documentation/asciidoc/accessories/touch-display-2/about.adoc +++ b/documentation/asciidoc/accessories/touch-display-2/about.adoc @@ -158,7 +158,7 @@ NOTE: You can't rotate the DSI display separately from the HDMI display with `cm == Customise touchscreen settings -You can use the Device Tree overlay to tell the Raspberry Pi OS how to configure the Touch Display 2 at boot. +You can use the Device Tree overlay to tell Raspberry Pi OS how to configure the Touch Display 2 at boot. - For the 5-inch display, the overlay is called `vc4-kms-dsi-ili9881-5inch`. - For the 7-inch display, the overlay is called `vc4-kms-dsi-ili9881-7inch`. From 987cf7f2d6a581d4124df7fc5cf3ac2d5fffc7d3 Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 13:17:41 +0100 Subject: [PATCH 07/24] Dealing with more comments from @lurch --- .../asciidoc/accessories/touch-display-2/about.adoc | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/documentation/asciidoc/accessories/touch-display-2/about.adoc b/documentation/asciidoc/accessories/touch-display-2/about.adoc index c644d718d..2870f2de2 100644 --- a/documentation/asciidoc/accessories/touch-display-2/about.adoc +++ b/documentation/asciidoc/accessories/touch-display-2/about.adoc @@ -37,7 +37,7 @@ Touch Display 2 (both 5-inch and 7-inch) includes the following features: * **720 x 1280 pixel resolution.** High-definition output. * **24-bit RGB display.** Capable of showing over 16 million colours. -* **Multitouch.** Supports up to five simultaneous touch points. +* **Multitouch.** Supports up to five simultaneous touch points and an on-screen keyboard. * **Mouse-equivalence.** Supports full desktop control without a physical mouse, for example, selecting, dragging, scrolling, and long-pressing for menus. * **On-screen keyboard.** Supports a visual keyboard in place of a physical keyboard. * **Integrated power.** Powered directly by the host Raspberry Pi, requiring no separate power supply. @@ -106,7 +106,7 @@ This connects the red cable (5 V power) to pin 2 and the black cable (ground) to .The GPIO connection to the Touch Display 2 image::images/touch-display-2-gpio-connection.png[The GPIO connection to the Touch Display 2, width="40%"] -WARNING: Correcting the power cable incorrectly might cause damage to the display. +WARNING: Connecting the power cable incorrectly might cause damage to the display. === Step 4. Mount your Touch Display 2 (optional) @@ -119,7 +119,7 @@ Take care not to pinch the FFC. == Use an on-screen keyboard -A Raspberry Pi with OS **Bookworm** or later already includes the **Squeakboard on-screen keyboard**. With a Touch Display 2 attached, the keyboard automatically appears when you can enter text, and automatically disappears when you can't. +Raspberry Pi OS **Bookworm** and later already includes the **Squeakboard on-screen keyboard**. With a Touch Display 2 attached, the keyboard automatically appears when you can enter text, and automatically disappears when you can't. For applications that don't support text entry detection, you can manually show or hide the keyboard using the keyboard icon at the right side of the taskbar. You can also permanently show or hide the on-screen keyboard using the Raspberry Pi graphical interface or the command line. @@ -158,7 +158,7 @@ NOTE: You can't rotate the DSI display separately from the HDMI display with `cm == Customise touchscreen settings -You can use the Device Tree overlay to tell Raspberry Pi OS how to configure the Touch Display 2 at boot. +You can use the Device Tree overlay to tell the Raspberry Pi OS how to configure the Touch Display 2 at boot. - For the 5-inch display, the overlay is called `vc4-kms-dsi-ili9881-5inch`. - For the 7-inch display, the overlay is called `vc4-kms-dsi-ili9881-7inch`. @@ -198,7 +198,7 @@ See the table below for details. === Example -In the following example, `invx` flips the X axis, and `invy` flips the Y axis for the 7-inch Touch Display 2: +In the following example, `invx` flips the X axis and `invy` flips the Y axis for a 7-inch Touch Display 2: [source,ini] ---- From cd417542ece5b965a8a9eaac6dc223b66eaf0e83 Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 13:26:20 +0100 Subject: [PATCH 08/24] Two changes per @lurch advice --- documentation/asciidoc/accessories/touch-display-2/about.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/asciidoc/accessories/touch-display-2/about.adoc b/documentation/asciidoc/accessories/touch-display-2/about.adoc index 2870f2de2..f008b3513 100644 --- a/documentation/asciidoc/accessories/touch-display-2/about.adoc +++ b/documentation/asciidoc/accessories/touch-display-2/about.adoc @@ -37,7 +37,7 @@ Touch Display 2 (both 5-inch and 7-inch) includes the following features: * **720 x 1280 pixel resolution.** High-definition output. * **24-bit RGB display.** Capable of showing over 16 million colours. -* **Multitouch.** Supports up to five simultaneous touch points and an on-screen keyboard. +* **Multitouch.** Supports up to five simultaneous touch points. * **Mouse-equivalence.** Supports full desktop control without a physical mouse, for example, selecting, dragging, scrolling, and long-pressing for menus. * **On-screen keyboard.** Supports a visual keyboard in place of a physical keyboard. * **Integrated power.** Powered directly by the host Raspberry Pi, requiring no separate power supply. @@ -158,7 +158,7 @@ NOTE: You can't rotate the DSI display separately from the HDMI display with `cm == Customise touchscreen settings -You can use the Device Tree overlay to tell the Raspberry Pi OS how to configure the Touch Display 2 at boot. +You can use the Device Tree overlay to tell Raspberry Pi OS how to configure the Touch Display 2 at boot. - For the 5-inch display, the overlay is called `vc4-kms-dsi-ili9881-5inch`. - For the 7-inch display, the overlay is called `vc4-kms-dsi-ili9881-7inch`. From 1086cd0ab17ea5a9ff51b80780b7a21770381fbc Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 14:15:10 +0100 Subject: [PATCH 09/24] Added more info about 5-inch display --- .../compute-module/cmio-display.adoc | 64 ++++++++----------- 1 file changed, 28 insertions(+), 36 deletions(-) diff --git a/documentation/asciidoc/computers/compute-module/cmio-display.adoc b/documentation/asciidoc/computers/compute-module/cmio-display.adoc index 747eb41bf..59804d201 100644 --- a/documentation/asciidoc/computers/compute-module/cmio-display.adoc +++ b/documentation/asciidoc/computers/compute-module/cmio-display.adoc @@ -1,27 +1,24 @@ == Attaching the Touch Display LCD panel -Update your system software and firmware to the latest version before starting. -Compute Modules mostly use the same process, but sometimes physical differences force changes for a particular model. +Update your system software and firmware to the latest version before starting. Compute Modules mostly use the same process, but sometimes physical differences force changes for a particular model. === Connect a display to DISP1/DSI1 -NOTE: The Raspberry Pi Zero camera cable cannot be used as an alternative to the RPI-DISPLAY adapter. The two cables have distinct wiring. +NOTE: The Raspberry Pi Zero camera cable can't be used as an alternative to the RPI-DISPLAY adapter. The two cables have distinct wiring. To connect a display to DISP1/DSI1: . Disconnect the Compute Module from power. . Connect the display to the DISP1/DSI1 port on the Compute Module IO board through the 22W to 15W display adapter. -. _(CM1, CM3, CM3+, and CM4S only)_: Connect the following GPIO pins with jumper cables: - * `0` to `CD1_SDA` - * `1` to `CD1_SCL` -. _(CM5)_ On the Compute Module 5 IO board, add the appropriate jumpers to J6, as indicated on the silkscreen. +. Complete the appropriate jumper connections: + - For *CM1*, *CM3*, *CM3+*, and *CM4S*, connect the following GPIO pins with jumper cables: + * `0` to `CD1_SDA` + * `1` to `CD1_SCL` + - For *CM5*, on the Compute Module 5 IO board, add the appropriate jumpers to J6, as indicated on the silkscreen. . Reconnect the Compute Module to power. -. Add the following line to xref:../computers/config_txt.adoc#what-is-config-txt[`/boot/firmware/config.txt`]: -+ -[source,ini] ----- -dtoverlay=vc4-kms-dsi-7inch ----- +. Depending on whether you're using a 5-inch or 7-inch display, add the one of the following line to xref:../computers/config_txt.adoc#what-is-config-txt[`/boot/firmware/config.txt`]: + - *5-inch.* `dtoverlay=vc4-kms-dsi-5inch` + - *7-inch.* `dtoverlay=vc4-kms-dsi-7inch` . Reboot your Compute Module with `sudo reboot`. Your device should detect and begin displaying output to your display. === Connect a display to DISP0/DSI0 @@ -29,19 +26,15 @@ dtoverlay=vc4-kms-dsi-7inch To connect a display to DISP0/DSI0 on CM1, CM3 and CM4 IO boards: . Connect the display to the DISP0/DSI0 port on the Compute Module IO board through the 22W to 15W display adapter. -. _(CM1, CM3, CM3+, and CM4S only)_: Connect the following GPIO pins with jumper cables: - * `28` to `CD0_SDA` - * `29` to `CD0_SCL` - - . _(CM4 only)_ On the Compute Module 4 IO board, add the appropriate jumpers to J6, as indicated on the silkscreen. - +. Complete the appropriate jumper connections: + - For *CM1*, *CM3*, *CM3+*, and *CM4S*, connect the following GPIO pins with jumper cables: + * `28` to `CD0_SDA` + * `29` to `CD0_SCL` + - For *CM4*, on the Compute Module 4 IO board, add the appropriate jumpers to J6, as indicated on the silkscreen. . Reconnect the Compute Module to power. -. Add the following line to `/boot/firmware/config.txt`: -+ -[source,ini] ----- -dtoverlay=vc4-kms-dsi-7inch ----- +. Depending on whether you're using a 5-inch or 7-inch display, add one of the following lines to `/boot/firmware/config.txt`: + - *5-inch.* `dtoverlay=vc4-kms-dsi-5inch` + - *7-inch.* `dtoverlay=vc4-kms-dsi-7inch` . Reboot your Compute Module with `sudo reboot`. Your device should detect and begin displaying output to your display. === Disable touchscreen @@ -66,18 +59,17 @@ ignore_lcd=1 == Attaching the Touch Display 2 LCD panel -Touch Display 2 is a 720x1280 7" LCD display designed specifically for Raspberry Pi devices (see https://www.raspberrypi.com/products/touch-display-2/). It connects in the same way as the original touch display, but the software setup on Compute Modules is slightly different as it uses a different display driver. See xref:../accessories/touch-display-2.adoc[Touch Display 2] for connection details. +Touch Display 2 is an LCD display designed specifically for Raspberry Pi devices (see https://www.raspberrypi.com/products/touch-display-2/). It's available in two sizes: 5 inches or 7 inches (diagonally). For more information about these options, see *Specifications* in xref:../accessories/touch-display-2.adoc[Touch Display 2]. -Edit the /boot/firmware/config.txt file and add the following to enable Touch Display 2 on DISP1/DSI1. You will also need to add jumpers to J6 as indicated on the silkscreen. +Regardless of the size that you use, Touch Display 2 connects in the same way as the original Touch Display, but the software setup on Compute Modules is slightly different because it uses a different display driver. For connection details, see *Connectors* in xref:../accessories/touch-display-2.adoc[Touch Display 2]. -[source,ini] ----- -dtoverlay=vc4-kms-dsi-ili9881-7inch ----- +Edit the `/boot/firmware/config.txt` file and add the following to enable Touch Display 2 on `DISP1/DSI1`. You must also add jumpers to J6 as indicated on the silkscreen. -To use DISP0/DSI0, use the following: +- For the *7-inch* display: `dtoverlay=vc4-kms-dsi-ili9881-7inch` +- For the *5-inch* display: `dtoverlay=vc4-kms-dsi-ili9881-5inch` + +To use `DISP0/DSI0`, append `,dsi0`` to the overlay name. + +- For the *7-inch* display: `dtoverlay=vc4-kms-dsi-ili9881-7inch,dsi0` +- For the *5-inch* display: `dtoverlay=vc4-kms-dsi-ili9881-5inch,dsi0` -[source,ini] ----- -dtoverlay=vc4-kms-dsi-ili9881-7inch,dsi0 ----- From 5ef24d8301a0890df90ebc606732a64d8744147c Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 14:20:17 +0100 Subject: [PATCH 10/24] Formatting for clarity and consistency --- .../computers/compute-module/cmio-display.adoc | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/documentation/asciidoc/computers/compute-module/cmio-display.adoc b/documentation/asciidoc/computers/compute-module/cmio-display.adoc index 59804d201..9107c6cd4 100644 --- a/documentation/asciidoc/computers/compute-module/cmio-display.adoc +++ b/documentation/asciidoc/computers/compute-module/cmio-display.adoc @@ -17,8 +17,8 @@ To connect a display to DISP1/DSI1: - For *CM5*, on the Compute Module 5 IO board, add the appropriate jumpers to J6, as indicated on the silkscreen. . Reconnect the Compute Module to power. . Depending on whether you're using a 5-inch or 7-inch display, add the one of the following line to xref:../computers/config_txt.adoc#what-is-config-txt[`/boot/firmware/config.txt`]: - - *5-inch.* `dtoverlay=vc4-kms-dsi-5inch` - - *7-inch.* `dtoverlay=vc4-kms-dsi-7inch` + - For the *5-inch* display: `dtoverlay=vc4-kms-dsi-5inch` + - For the *5-inch* display: `dtoverlay=vc4-kms-dsi-7inch` . Reboot your Compute Module with `sudo reboot`. Your device should detect and begin displaying output to your display. === Connect a display to DISP0/DSI0 @@ -33,8 +33,8 @@ To connect a display to DISP0/DSI0 on CM1, CM3 and CM4 IO boards: - For *CM4*, on the Compute Module 4 IO board, add the appropriate jumpers to J6, as indicated on the silkscreen. . Reconnect the Compute Module to power. . Depending on whether you're using a 5-inch or 7-inch display, add one of the following lines to `/boot/firmware/config.txt`: - - *5-inch.* `dtoverlay=vc4-kms-dsi-5inch` - - *7-inch.* `dtoverlay=vc4-kms-dsi-7inch` + - For the *5-inch* display: `dtoverlay=vc4-kms-dsi-5inch` + - For the *7-inch* display: `dtoverlay=vc4-kms-dsi-7inch` . Reboot your Compute Module with `sudo reboot`. Your device should detect and begin displaying output to your display. === Disable touchscreen @@ -65,11 +65,11 @@ Regardless of the size that you use, Touch Display 2 connects in the same way as Edit the `/boot/firmware/config.txt` file and add the following to enable Touch Display 2 on `DISP1/DSI1`. You must also add jumpers to J6 as indicated on the silkscreen. -- For the *7-inch* display: `dtoverlay=vc4-kms-dsi-ili9881-7inch` - For the *5-inch* display: `dtoverlay=vc4-kms-dsi-ili9881-5inch` +- For the *7-inch* display: `dtoverlay=vc4-kms-dsi-ili9881-7inch` To use `DISP0/DSI0`, append `,dsi0`` to the overlay name. -- For the *7-inch* display: `dtoverlay=vc4-kms-dsi-ili9881-7inch,dsi0` - For the *5-inch* display: `dtoverlay=vc4-kms-dsi-ili9881-5inch,dsi0` +- For the *7-inch* display: `dtoverlay=vc4-kms-dsi-ili9881-7inch,dsi0` From b08a7f662ef58a10af8404566a1d5091fc08d4e4 Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 14:21:45 +0100 Subject: [PATCH 11/24] Typo --- .../asciidoc/computers/compute-module/cmio-display.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/computers/compute-module/cmio-display.adoc b/documentation/asciidoc/computers/compute-module/cmio-display.adoc index 9107c6cd4..41b9c4685 100644 --- a/documentation/asciidoc/computers/compute-module/cmio-display.adoc +++ b/documentation/asciidoc/computers/compute-module/cmio-display.adoc @@ -18,7 +18,7 @@ To connect a display to DISP1/DSI1: . Reconnect the Compute Module to power. . Depending on whether you're using a 5-inch or 7-inch display, add the one of the following line to xref:../computers/config_txt.adoc#what-is-config-txt[`/boot/firmware/config.txt`]: - For the *5-inch* display: `dtoverlay=vc4-kms-dsi-5inch` - - For the *5-inch* display: `dtoverlay=vc4-kms-dsi-7inch` + - For the *7-inch* display: `dtoverlay=vc4-kms-dsi-7inch` . Reboot your Compute Module with `sudo reboot`. Your device should detect and begin displaying output to your display. === Connect a display to DISP0/DSI0 From 0c4ce4eb8dc2b6009c6d5ff9851b0e791670ec16 Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 14:22:32 +0100 Subject: [PATCH 12/24] Typo 2 --- .../asciidoc/computers/compute-module/cmio-display.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/computers/compute-module/cmio-display.adoc b/documentation/asciidoc/computers/compute-module/cmio-display.adoc index 41b9c4685..b36e96e2d 100644 --- a/documentation/asciidoc/computers/compute-module/cmio-display.adoc +++ b/documentation/asciidoc/computers/compute-module/cmio-display.adoc @@ -16,7 +16,7 @@ To connect a display to DISP1/DSI1: * `1` to `CD1_SCL` - For *CM5*, on the Compute Module 5 IO board, add the appropriate jumpers to J6, as indicated on the silkscreen. . Reconnect the Compute Module to power. -. Depending on whether you're using a 5-inch or 7-inch display, add the one of the following line to xref:../computers/config_txt.adoc#what-is-config-txt[`/boot/firmware/config.txt`]: +. Depending on whether you're using a 5-inch or 7-inch display, add one of the following lines to xref:../computers/config_txt.adoc#what-is-config-txt[`/boot/firmware/config.txt`]: - For the *5-inch* display: `dtoverlay=vc4-kms-dsi-5inch` - For the *7-inch* display: `dtoverlay=vc4-kms-dsi-7inch` . Reboot your Compute Module with `sudo reboot`. Your device should detect and begin displaying output to your display. From 14023f4b9b2368b72a24a6245fd2beeb1aba3c00 Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 14:33:01 +0100 Subject: [PATCH 13/24] Fixing confusion between TD1 and TD2. --- .../asciidoc/computers/compute-module/cmio-display.adoc | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/documentation/asciidoc/computers/compute-module/cmio-display.adoc b/documentation/asciidoc/computers/compute-module/cmio-display.adoc index b36e96e2d..af05ed943 100644 --- a/documentation/asciidoc/computers/compute-module/cmio-display.adoc +++ b/documentation/asciidoc/computers/compute-module/cmio-display.adoc @@ -16,9 +16,7 @@ To connect a display to DISP1/DSI1: * `1` to `CD1_SCL` - For *CM5*, on the Compute Module 5 IO board, add the appropriate jumpers to J6, as indicated on the silkscreen. . Reconnect the Compute Module to power. -. Depending on whether you're using a 5-inch or 7-inch display, add one of the following lines to xref:../computers/config_txt.adoc#what-is-config-txt[`/boot/firmware/config.txt`]: - - For the *5-inch* display: `dtoverlay=vc4-kms-dsi-5inch` - - For the *7-inch* display: `dtoverlay=vc4-kms-dsi-7inch` +. Add `dtoverlay=vc4-kms-dsi-7inch` to xref:../computers/config_txt.adoc#what-is-config-txt[`/boot/firmware/config.txt`]: . Reboot your Compute Module with `sudo reboot`. Your device should detect and begin displaying output to your display. === Connect a display to DISP0/DSI0 @@ -32,9 +30,7 @@ To connect a display to DISP0/DSI0 on CM1, CM3 and CM4 IO boards: * `29` to `CD0_SCL` - For *CM4*, on the Compute Module 4 IO board, add the appropriate jumpers to J6, as indicated on the silkscreen. . Reconnect the Compute Module to power. -. Depending on whether you're using a 5-inch or 7-inch display, add one of the following lines to `/boot/firmware/config.txt`: - - For the *5-inch* display: `dtoverlay=vc4-kms-dsi-5inch` - - For the *7-inch* display: `dtoverlay=vc4-kms-dsi-7inch` +. Add `dtoverlay=vc4-kms-dsi-7inch` to `/boot/firmware/config.txt`: . Reboot your Compute Module with `sudo reboot`. Your device should detect and begin displaying output to your display. === Disable touchscreen From c23507969a435d4d46f90f4fda165ccc20dd0c1a Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 14:40:14 +0100 Subject: [PATCH 14/24] Minor style edits plus corrections in grammar. --- .../computers/compute-module/cmio-display.adoc | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/documentation/asciidoc/computers/compute-module/cmio-display.adoc b/documentation/asciidoc/computers/compute-module/cmio-display.adoc index af05ed943..3154960dd 100644 --- a/documentation/asciidoc/computers/compute-module/cmio-display.adoc +++ b/documentation/asciidoc/computers/compute-module/cmio-display.adoc @@ -6,36 +6,36 @@ Update your system software and firmware to the latest version before starting. NOTE: The Raspberry Pi Zero camera cable can't be used as an alternative to the RPI-DISPLAY adapter. The two cables have distinct wiring. -To connect a display to DISP1/DSI1: +To connect a display to `DISP1/DSI1``: . Disconnect the Compute Module from power. -. Connect the display to the DISP1/DSI1 port on the Compute Module IO board through the 22W to 15W display adapter. +. Connect the display to the `DISP1/DSI1`` port on the Compute Module IO board through the 22W to 15W display adapter. . Complete the appropriate jumper connections: - For *CM1*, *CM3*, *CM3+*, and *CM4S*, connect the following GPIO pins with jumper cables: * `0` to `CD1_SDA` * `1` to `CD1_SCL` - For *CM5*, on the Compute Module 5 IO board, add the appropriate jumpers to J6, as indicated on the silkscreen. . Reconnect the Compute Module to power. -. Add `dtoverlay=vc4-kms-dsi-7inch` to xref:../computers/config_txt.adoc#what-is-config-txt[`/boot/firmware/config.txt`]: +. Add `dtoverlay=vc4-kms-dsi-7inch` to xref:../computers/config_txt.adoc#what-is-config-txt[`/boot/firmware/config.txt`]. . Reboot your Compute Module with `sudo reboot`. Your device should detect and begin displaying output to your display. === Connect a display to DISP0/DSI0 -To connect a display to DISP0/DSI0 on CM1, CM3 and CM4 IO boards: +To connect a display to `DISP0/DSI0`` on CM1, CM3, and CM4 IO boards: -. Connect the display to the DISP0/DSI0 port on the Compute Module IO board through the 22W to 15W display adapter. +. Connect the display to the `DISP0/DSI0`` port on the Compute Module IO board through the 22W to 15W display adapter. . Complete the appropriate jumper connections: - For *CM1*, *CM3*, *CM3+*, and *CM4S*, connect the following GPIO pins with jumper cables: * `28` to `CD0_SDA` * `29` to `CD0_SCL` - For *CM4*, on the Compute Module 4 IO board, add the appropriate jumpers to J6, as indicated on the silkscreen. . Reconnect the Compute Module to power. -. Add `dtoverlay=vc4-kms-dsi-7inch` to `/boot/firmware/config.txt`: +. Add `dtoverlay=vc4-kms-dsi-7inch` to `/boot/firmware/config.txt`. . Reboot your Compute Module with `sudo reboot`. Your device should detect and begin displaying output to your display. === Disable touchscreen -The touchscreen requires no additional configuration. Connect it to your Compute Module, and both the touchscreen element and display should work once successfully detected. +The touchscreen requires no additional configuration. Connect it to your Compute Module; both the touchscreen element and display work when successfully detected. To disable the touchscreen element, but still use the display, add the following line to `/boot/firmware/config.txt`: @@ -55,11 +55,11 @@ ignore_lcd=1 == Attaching the Touch Display 2 LCD panel -Touch Display 2 is an LCD display designed specifically for Raspberry Pi devices (see https://www.raspberrypi.com/products/touch-display-2/). It's available in two sizes: 5 inches or 7 inches (diagonally). For more information about these options, see *Specifications* in xref:../accessories/touch-display-2.adoc[Touch Display 2]. +Touch Display 2 is an LCD display designed for Raspberry Pi devices (see https://www.raspberrypi.com/products/touch-display-2/). It's available in two sizes: 5 inches or 7 inches (diagonally). For more information about these options, see *Specifications* in xref:../accessories/touch-display-2.adoc[Touch Display 2]. Regardless of the size that you use, Touch Display 2 connects in the same way as the original Touch Display, but the software setup on Compute Modules is slightly different because it uses a different display driver. For connection details, see *Connectors* in xref:../accessories/touch-display-2.adoc[Touch Display 2]. -Edit the `/boot/firmware/config.txt` file and add the following to enable Touch Display 2 on `DISP1/DSI1`. You must also add jumpers to J6 as indicated on the silkscreen. +To enable Touch Display 2 on `DISP1/DSI1`, edit the `/boot/firmware/config.txt` file to add the following. You must also add jumpers to J6 as indicated on the silkscreen. - For the *5-inch* display: `dtoverlay=vc4-kms-dsi-ili9881-5inch` - For the *7-inch* display: `dtoverlay=vc4-kms-dsi-ili9881-7inch` From 6aad3fe0b794a156b518f6859d050055284fc0b6 Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 17:55:44 +0100 Subject: [PATCH 15/24] Update documentation/asciidoc/accessories/touch-display-2/about.adoc Co-authored-by: Andrew Scheller --- documentation/asciidoc/accessories/touch-display-2/about.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/accessories/touch-display-2/about.adoc b/documentation/asciidoc/accessories/touch-display-2/about.adoc index f008b3513..83efa2943 100644 --- a/documentation/asciidoc/accessories/touch-display-2/about.adoc +++ b/documentation/asciidoc/accessories/touch-display-2/about.adoc @@ -1,4 +1,4 @@ -The https://www.raspberrypi.com/products/touch-display-2/[Raspberry Pi Touch Display 2] is a portrait orientation (with rotation options) touchscreen LCD designed for interactive projects like tablets, entertainment systems, and information dashboards. +The https://www.raspberrypi.com/products/touch-display-2/[Raspberry Pi Touch Display 2] is a portrait orientation touchscreen LCD (with rotation options) designed for interactive projects like tablets, entertainment systems, and information dashboards. .The Raspberry Pi Touch Display 2 image::images/touch-display-2-hero.jpg[width="80%"] From 4151d68fdef174e83d39fad6b880dcbb9e091dc8 Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 17:57:30 +0100 Subject: [PATCH 16/24] Update documentation/asciidoc/computers/compute-module/cmio-display.adoc Co-authored-by: Andrew Scheller --- .../asciidoc/computers/compute-module/cmio-display.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/computers/compute-module/cmio-display.adoc b/documentation/asciidoc/computers/compute-module/cmio-display.adoc index 3154960dd..e04a64c3a 100644 --- a/documentation/asciidoc/computers/compute-module/cmio-display.adoc +++ b/documentation/asciidoc/computers/compute-module/cmio-display.adoc @@ -6,7 +6,7 @@ Update your system software and firmware to the latest version before starting. NOTE: The Raspberry Pi Zero camera cable can't be used as an alternative to the RPI-DISPLAY adapter. The two cables have distinct wiring. -To connect a display to `DISP1/DSI1``: +To connect a display to `DISP1/DSI1`: . Disconnect the Compute Module from power. . Connect the display to the `DISP1/DSI1`` port on the Compute Module IO board through the 22W to 15W display adapter. From c1c7ba59d19fa0d07899da0ed4ad6e631afb38cb Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 17:57:47 +0100 Subject: [PATCH 17/24] Update documentation/asciidoc/computers/compute-module/cmio-display.adoc Co-authored-by: Andrew Scheller --- .../asciidoc/computers/compute-module/cmio-display.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/computers/compute-module/cmio-display.adoc b/documentation/asciidoc/computers/compute-module/cmio-display.adoc index e04a64c3a..7a82e7975 100644 --- a/documentation/asciidoc/computers/compute-module/cmio-display.adoc +++ b/documentation/asciidoc/computers/compute-module/cmio-display.adoc @@ -21,7 +21,7 @@ To connect a display to `DISP1/DSI1`: === Connect a display to DISP0/DSI0 -To connect a display to `DISP0/DSI0`` on CM1, CM3, and CM4 IO boards: +To connect a display to `DISP0/DSI0` on CM1, CM3, and CM4 IO boards: . Connect the display to the `DISP0/DSI0`` port on the Compute Module IO board through the 22W to 15W display adapter. . Complete the appropriate jumper connections: From fbc8cb921dbac0d9c177530f18115badcd3d1c65 Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 17:58:00 +0100 Subject: [PATCH 18/24] Update documentation/asciidoc/computers/compute-module/cmio-display.adoc Co-authored-by: Andrew Scheller --- .../asciidoc/computers/compute-module/cmio-display.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/computers/compute-module/cmio-display.adoc b/documentation/asciidoc/computers/compute-module/cmio-display.adoc index 7a82e7975..53391798b 100644 --- a/documentation/asciidoc/computers/compute-module/cmio-display.adoc +++ b/documentation/asciidoc/computers/compute-module/cmio-display.adoc @@ -23,7 +23,7 @@ To connect a display to `DISP1/DSI1`: To connect a display to `DISP0/DSI0` on CM1, CM3, and CM4 IO boards: -. Connect the display to the `DISP0/DSI0`` port on the Compute Module IO board through the 22W to 15W display adapter. +. Connect the display to the `DISP0/DSI0` port on the Compute Module IO board through the 22W to 15W display adapter. . Complete the appropriate jumper connections: - For *CM1*, *CM3*, *CM3+*, and *CM4S*, connect the following GPIO pins with jumper cables: * `28` to `CD0_SDA` From eecba792777ac0ce835623c31e9ca430bd65c3ae Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 18:01:31 +0100 Subject: [PATCH 19/24] Update documentation/asciidoc/accessories/touch-display-2/about.adoc Co-authored-by: Andrew Scheller --- documentation/asciidoc/accessories/touch-display-2/about.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/accessories/touch-display-2/about.adoc b/documentation/asciidoc/accessories/touch-display-2/about.adoc index 83efa2943..779294893 100644 --- a/documentation/asciidoc/accessories/touch-display-2/about.adoc +++ b/documentation/asciidoc/accessories/touch-display-2/about.adoc @@ -94,7 +94,7 @@ IMPORTANT: Disconnect your Raspberry Pi from power before completing the followi - This port should be marked with some variation of the term **DISPLAY**, **CAM/DISP**, or **DISP**. - If your Raspberry Pi has multiple DSI connectors, we recommend using the port labelled **1**. . Insert the other end of your FFC into the Raspberry Pi DSI connector, with the metal contacts facing the Ethernet and USB-A ports. -. Hold the FFC firmly in place and simultaneously push the retaining clip back in on the FFC connector of the Raspberry Pi to secure the cable. +. Hold the FFC firmly in place and simultaneously push the retaining clip back down on the FFC connector of the Raspberry Pi to secure the cable. === Step 3. Connect the GPIO power cable From db1ab2a42d4970a17a793365017a10e84678ac91 Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 18:01:51 +0100 Subject: [PATCH 20/24] Update documentation/asciidoc/accessories/touch-display-2/about.adoc Co-authored-by: Andrew Scheller --- documentation/asciidoc/accessories/touch-display-2/about.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/accessories/touch-display-2/about.adoc b/documentation/asciidoc/accessories/touch-display-2/about.adoc index 779294893..32252fae0 100644 --- a/documentation/asciidoc/accessories/touch-display-2/about.adoc +++ b/documentation/asciidoc/accessories/touch-display-2/about.adoc @@ -108,7 +108,7 @@ image::images/touch-display-2-gpio-connection.png[The GPIO connection to the Tou WARNING: Connecting the power cable incorrectly might cause damage to the display. -=== Step 4. Mount your Touch Display 2 (optional) +=== Step 4. Mount your Raspberry Pi to the Touch Display 2 (optional) Optionally, use the included M2.5 screws to mount your Raspberry Pi to the back of your Touch Display 2. From c045726b8a78dc9855591cdf19589fd612a4eb84 Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 18:02:04 +0100 Subject: [PATCH 21/24] Update documentation/asciidoc/accessories/touch-display-2/about.adoc Co-authored-by: Andrew Scheller --- documentation/asciidoc/accessories/touch-display-2/about.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/accessories/touch-display-2/about.adoc b/documentation/asciidoc/accessories/touch-display-2/about.adoc index 32252fae0..536183cb6 100644 --- a/documentation/asciidoc/accessories/touch-display-2/about.adoc +++ b/documentation/asciidoc/accessories/touch-display-2/about.adoc @@ -119,7 +119,7 @@ Take care not to pinch the FFC. == Use an on-screen keyboard -Raspberry Pi OS **Bookworm** and later already includes the **Squeakboard on-screen keyboard**. With a Touch Display 2 attached, the keyboard automatically appears when you can enter text, and automatically disappears when you can't. +Raspberry Pi OS **Bookworm** and later already includes the **Squeekboard on-screen keyboard**. With a Touch Display 2 attached, the keyboard automatically appears when you can enter text, and automatically disappears when you can't. For applications that don't support text entry detection, you can manually show or hide the keyboard using the keyboard icon at the right side of the taskbar. You can also permanently show or hide the on-screen keyboard using the Raspberry Pi graphical interface or the command line. From 220221e172b731a5fd3256da4518dda810849fc8 Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 18:02:25 +0100 Subject: [PATCH 22/24] Update documentation/asciidoc/computers/compute-module/cmio-display.adoc Co-authored-by: Andrew Scheller --- .../asciidoc/computers/compute-module/cmio-display.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/computers/compute-module/cmio-display.adoc b/documentation/asciidoc/computers/compute-module/cmio-display.adoc index 53391798b..ab4b9eb02 100644 --- a/documentation/asciidoc/computers/compute-module/cmio-display.adoc +++ b/documentation/asciidoc/computers/compute-module/cmio-display.adoc @@ -64,7 +64,7 @@ To enable Touch Display 2 on `DISP1/DSI1`, edit the `/boot/firmware/config.txt` - For the *5-inch* display: `dtoverlay=vc4-kms-dsi-ili9881-5inch` - For the *7-inch* display: `dtoverlay=vc4-kms-dsi-ili9881-7inch` -To use `DISP0/DSI0`, append `,dsi0`` to the overlay name. +To use `DISP0/DSI0`, append `,dsi0` to the overlay name. - For the *5-inch* display: `dtoverlay=vc4-kms-dsi-ili9881-5inch,dsi0` - For the *7-inch* display: `dtoverlay=vc4-kms-dsi-ili9881-7inch,dsi0` From 142dff61ac1d297884bef30bb12634722ab71f62 Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 18:02:45 +0100 Subject: [PATCH 23/24] Update documentation/asciidoc/computers/compute-module/cmio-display.adoc Co-authored-by: Andrew Scheller --- .../asciidoc/computers/compute-module/cmio-display.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/computers/compute-module/cmio-display.adoc b/documentation/asciidoc/computers/compute-module/cmio-display.adoc index ab4b9eb02..118a24dea 100644 --- a/documentation/asciidoc/computers/compute-module/cmio-display.adoc +++ b/documentation/asciidoc/computers/compute-module/cmio-display.adoc @@ -9,7 +9,7 @@ NOTE: The Raspberry Pi Zero camera cable can't be used as an alternative to the To connect a display to `DISP1/DSI1`: . Disconnect the Compute Module from power. -. Connect the display to the `DISP1/DSI1`` port on the Compute Module IO board through the 22W to 15W display adapter. +. Connect the display to the `DISP1/DSI1` port on the Compute Module IO board through the 22W to 15W display adapter. . Complete the appropriate jumper connections: - For *CM1*, *CM3*, *CM3+*, and *CM4S*, connect the following GPIO pins with jumper cables: * `0` to `CD1_SDA` From 865e55ee2892f170e10b7d514d5b5947ed2175ad Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 14 Aug 2025 18:04:51 +0100 Subject: [PATCH 24/24] Removed incorrect statement --- documentation/asciidoc/accessories/touch-display-2/about.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/accessories/touch-display-2/about.adoc b/documentation/asciidoc/accessories/touch-display-2/about.adoc index 536183cb6..11a9356bd 100644 --- a/documentation/asciidoc/accessories/touch-display-2/about.adoc +++ b/documentation/asciidoc/accessories/touch-display-2/about.adoc @@ -82,7 +82,7 @@ IMPORTANT: Disconnect your Raspberry Pi from power before completing the followi === Step 1. Connect FFC to Touch Display 2 -. Slide the retaining clip outwards from both sides of the FFC connector on the Touch Display 2 to secure the cable. +. Slide the retaining clip outwards from both sides of the FFC connector on the Touch Display 2. . Insert one 15-way end of your FFC into the Touch Display 2 FFC connector, with the metal contacts facing upwards, away from the Touch Display 2. - If you're connecting to a Raspberry Pi 5, and therefore using the **22-way to 15-way FFC**, the 22-way end is the smaller end of the cable. Insert the larger end of the cable into the Touch Display 2 FFC connector. - If you're using the **15-way to 15-way FFC**, insert either end of the cable into the Touch Display 2 FFC connector.