You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: documentation/asciidoc/accessories/build-hat/preparing-build-hat.adoc
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
3
3
NOTE: Before starting to work with your Raspberry Pi Build HAT you should xref:../computers/getting-started.adoc#setting-up-your-raspberry-pi[set up] your Raspberry Pi, xref:../computers/getting-started.adoc#installing-the-operating-system[install] the latest version of the operating system using https://www.raspberrypi.com/downloads/[Raspberry Pi Imager].
4
4
5
-
Attach 9mm spacers to the bottom of the board. Seat the Raspberry Pi Build HAT onto your Raspberry Pi. Make sure you put it on the right way up. Unlike other HATs, all the components are on the bottom, leaving room for a breadboard or LEGO® elements on top.
5
+
Attach 9mm spacers to the bottom of the board. Seat the Raspberry Pi Build HAT onto your Raspberry Pi. Make sure you put it on the right way up. Unlike other HATs, all the components are on the bottom, leaving room for a breadboard or LEGO® elements on top.
6
6
7
7
video::images/fitting-build-hat.webm[width="80%"]
8
8
@@ -18,22 +18,22 @@ The following pins are used by the Build HAT itself and you should not connect a
18
18
[cols="^1,^1,^1", width="75%", options="header"]
19
19
|===
20
20
| GPIO| Use | Status
21
-
| GPIO0/1 | ID prom |
22
-
| GPIO4| Reset |
23
-
| GPIO14| Tx |
24
-
| GPIO15| Rx |
21
+
| GPIO0/1 | ID prom |
22
+
| GPIO4| Reset |
23
+
| GPIO14| Tx |
24
+
| GPIO15| Rx |
25
25
| GPIO16 | RTS | unused
26
26
| GPIO17 | CTS | unused
27
27
|===
28
28
29
29
30
30
=== Set up your Raspberry Pi
31
31
32
-
Once the Raspberry Pi has booted, open the Raspberry Pi Configuration tool by clicking on the Raspberry Menu button and then selecting "Preferences" and then "Raspberry Pi Configuration".
32
+
Once the Raspberry Pi has booted, open the Control Centre tool by selecting the Raspberry Menu button and then selecting **Preferences > Control Centre**.
33
33
34
-
Click on the "interfaces" tab and adjust the Serial settings as shown below:
34
+
Select the **Interfaces** tab and adjust the serial settings as shown in the following image:
35
35
36
-
image::images/setting-up.png[width="50%"]
36
+
image::images/setting-up.png["The Interfaces tab. SSH, VNC, and Serial Port are enabled. The rest of the options are not enabled.", width="50%"]
The Touch Display is compatible with all models of Raspberry Pi, except the Zero series and Keyboard series, which lack a DSI connector. The earliest Raspberry Pi models lack appropriate mounting holes, requiring additional mounting hardware to fit the stand-offs on the display PCB.
9
9
10
-
The display has the following key features:
10
+
The display has the following key features:
11
11
12
12
* 800×480px RGB LCD display
13
13
* 24-bit colour
@@ -79,7 +79,7 @@ Raspberry Pi OS _Bookworm_ and later include the Squeekboard on-screen keyboard
79
79
80
80
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.
81
81
82
-
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`.
82
+
You can also permanently show or hide the on-screen keyboard in the **Display** tab of Control Centre or the `Display` section of `raspi-config`.
83
83
84
84
TIP: In Raspberry Pi OS releases prior to _Bookworm_, use `matchbox-keyboard` instead. If you use the wayfire desktop compositor, use `wvkbd` instead.
Copy file name to clipboardExpand all lines: documentation/asciidoc/accessories/touch-display-2/about.adoc
+14-14Lines changed: 14 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
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.
1
+
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.
@@ -36,7 +36,7 @@ The Touch Display 2 is available in two sizes: 5-inch and 7-inch (measured diago
36
36
Touch Display 2 (both 5-inch and 7-inch) includes the following features:
37
37
38
38
* **720 x 1280 pixel resolution.** High-definition output.
39
-
* **24-bit RGB display.** Capable of showing over 16 million colours.
39
+
* **24-bit RGB display.** Capable of showing over 16 million colours.
40
40
* **Multitouch.** Supports up to five simultaneous touch points.
41
41
* **Mouse-equivalence.** Supports full desktop control without a physical mouse, for example, selecting, dragging, scrolling, and long-pressing for menus.
42
42
* **On-screen keyboard.** Supports a visual keyboard in place of a physical keyboard.
@@ -62,7 +62,7 @@ image::images/touch-display-2-whats-in-the-booooox.jpg["Parts included in the To
62
62
The Touch Display 2 connects to a Raspberry Pi using:
63
63
64
64
- A **DSI connector** for video and touch data.
65
-
- The **GPIO header** for power.
65
+
- The **GPIO header** for power.
66
66
67
67
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:
68
68
@@ -78,7 +78,7 @@ After determining the correct FFC for your Raspberry Pi model, you can connect y
78
78
.A Raspberry Pi 5 connected and mounted to the Touch Display 2
79
79
image::images/touch-display-2-installation-diagram.png["A Raspberry Pi 5 connected and mounted to the Touch Display 2", width="80%"]
80
80
81
-
IMPORTANT: Disconnect your Raspberry Pi from power before completing the following steps.
81
+
IMPORTANT: Disconnect your Raspberry Pi from power before completing the following steps.
82
82
83
83
=== Step 1. Connect FFC to Touch Display 2
84
84
@@ -90,16 +90,16 @@ IMPORTANT: Disconnect your Raspberry Pi from power before completing the followi
90
90
91
91
=== Step 2. Connect FFC to Raspberry Pi
92
92
93
-
. Slide the retaining clip upwards from both sides of the DSI connector of your Raspberry Pi.
94
-
- This port should be marked with some variation of the term **DISPLAY**, **CAM/DISP**, or **DISP**.
93
+
. Slide the retaining clip upwards from both sides of the DSI connector of your Raspberry Pi.
94
+
- This port should be marked with some variation of the term **DISPLAY**, **CAM/DISP**, or **DISP**.
95
95
- If your Raspberry Pi has multiple DSI connectors, we recommend using the port labelled **1**.
96
96
. Insert the other end of your FFC into the Raspberry Pi DSI connector, with the metal contacts facing the Ethernet and USB-A ports.
97
97
. 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.
98
98
99
99
=== Step 3. Connect the GPIO power cable
100
100
101
101
. Plug the smaller end of the GPIO power cable into the **J1** port on the Touch Display 2.
102
-
. Connect the three-pin end of the GPIO power cable to your xref:../computers/raspberry-pi.adoc#gpio[Raspberry Pi's GPIO].
102
+
. Connect the three-pin end of the GPIO power cable to your xref:../computers/raspberry-pi.adoc#gpio[Raspberry Pi's GPIO].
103
103
104
104
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.
105
105
@@ -123,7 +123,7 @@ Raspberry Pi OS **Bookworm** and later already includes the **Squeekboard on-scr
123
123
124
124
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.
125
125
126
-
- **Raspberry Pi desktop interface:** From the Raspberry Pi menu, go to **Preferences > Raspberry Pi Configuration > Display** and choose your on-screen keyboard setting.
126
+
- **Raspberry Pi desktop interface:** From the Raspberry Pi menu, go to **Preferences > Control Centre > Display** and choose your on-screen keyboard setting.
127
127
- **Command line:** Open a terminal and enter `sudo raspi-config`. Navigate to the **Display** section of `raspi-config` and then choose your keyboard setting.
128
128
129
129
== Change screen orientation
@@ -135,7 +135,7 @@ You have four rotation options:
135
135
- **0** maintains the default display position, which is a portrait orientation.
136
136
- **90** rotates the display 90 degrees to the right (clockwise), making it a landscape orientation.
137
137
- **180** rotates the display 180 degrees to the right (clockwise), which flips the display upside down.
138
-
- **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.
138
+
- **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.
139
139
140
140
=== With a desktop
141
141
If you have the Raspberry Pi OS desktop running, you can rotate the display through the **Screen Configuration** tool:
@@ -160,14 +160,14 @@ NOTE: You can't rotate the DSI display separately from the HDMI display with `cm
160
160
161
161
== Customise touchscreen settings
162
162
163
-
You can use the Device Tree overlay to tell Raspberry Pi OS how to configure the Touch Display 2 at boot.
163
+
You can use the Device Tree overlay to tell Raspberry Pi OS how to configure the Touch Display 2 at boot.
164
164
165
165
- For the 5-inch display, the overlay is called `vc4-kms-dsi-ili9881-5inch`.
166
166
- For the 7-inch display, the overlay is called `vc4-kms-dsi-ili9881-7inch`.
167
167
168
168
You can modify the Device Tree overlay in the boot configuration file (`/boot/firmware/config.txt`).
169
169
170
-
Open `/boot/firmware/config.txt` and then add the required Device Tree parameters to the `dtoverlay` line, separated by commas.
170
+
Open `/boot/firmware/config.txt` and then add the required Device Tree parameters to the `dtoverlay` line, separated by commas.
171
171
172
172
- Booleans (`invx`, `invy`, `swapxy`, and `disable_touch`) default to true if present, but you can set them to false using the suffix `=0`.
173
173
- Integers (`sizex` and `sizey`) require a number, for example, `sizey=240`.
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.
213
+
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.
214
214
215
-
This is because 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.
215
+
This is because 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.
216
216
217
217
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:
218
218
219
219
- 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].
220
220
- Using a custom base device tree file. This is an advanced method not covered in this online documentation.
Copy file name to clipboardExpand all lines: documentation/asciidoc/computers/configuration/configuring-networking.adoc
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,7 +10,7 @@ NOTE: Starting with Raspberry Pi OS _Bookworm_, Network Manager is the default n
10
10
11
11
Access Network Manager via the network icon at the right-hand end of the menu bar. If you are using a Raspberry Pi with built-in wireless connectivity, or if a wireless dongle is plugged in, click this icon to bring up a list of available wireless networks. If you see the message 'No APs found - scanning...', wait a few seconds, and Network Manager should find your network.
12
12
13
-
NOTE: Devices with dual-band wireless automatically disable networking until you assign a wireless LAN country. Flagship models since Raspberry Pi 3B+, Compute Modules since CM4, and Keyboard models support dual-band wireless. To set a wireless LAN country, open the Raspberry Pi Configuration application from the Preferences menu, select *Localisation* and select your country from the menu.
13
+
NOTE: Devices with dual-band wireless automatically disable networking until you assign a wireless LAN country. Flagship models since Raspberry Pi 3B+, Compute Modules since CM4, and Keyboard models support dual-band wireless. To set a wireless LAN country, open the Control Centre application from the **Preferences** menu, select *Localisation* and select your country from the menu.
0 commit comments