Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
39750e9
Bump actions/checkout from 4 to 5
dependabot[bot] Aug 12, 2025
8ecc962
Bump actions/setup-python from 5 to 6
dependabot[bot] Sep 8, 2025
c1c5279
Bump actions/stale from 9 to 10
dependabot[bot] Sep 8, 2025
ce0e1f4
Bump pyyaml from 6.0.2 to 6.0.3
dependabot[bot] Sep 30, 2025
cb3629b
Start updating Arm trademark.
katshann-raspberry Sep 30, 2025
8b64bf1
Update Arm trademarks
katshann-raspberry Sep 30, 2025
d10cc1c
Update for correct instruction set name
katshann-raspberry Oct 1, 2025
25e04c1
Merge pull request #4202 from raspberrypi/arm-arm
katshann-raspberry Oct 2, 2025
95a1233
Merge pull request #4199 from raspberrypi/dependabot/pip/develop/pyya…
katshann-raspberry Oct 2, 2025
efaeeda
Merge pull request #4176 from raspberrypi/dependabot/github_actions/d…
katshann-raspberry Oct 2, 2025
9481079
Merge pull request #4175 from raspberrypi/dependabot/github_actions/d…
katshann-raspberry Oct 2, 2025
71a2965
Merge branch 'develop' into dependabot/github_actions/develop/actions…
katshann-raspberry Oct 2, 2025
4d43c3f
Merge pull request #4153 from raspberrypi/dependabot/github_actions/d…
katshann-raspberry Oct 2, 2025
cd3a172
Update a couple of images
katshann-raspberry Oct 2, 2025
d20c54e
Update some screenshots and related words
katshann-raspberry Oct 2, 2025
a81ce28
Crop one image
katshann-raspberry Oct 2, 2025
8172f87
Fix broken link
katshann-raspberry Oct 2, 2025
0c63b16
Update documentation/asciidoc/computers/os/updating.adoc
katshann-raspberry Oct 6, 2025
ee89a7f
Update documentation/asciidoc/computers/remote-access/find-your-ip-ad…
katshann-raspberry Oct 6, 2025
cef2f3b
Update documentation/asciidoc/computers/remote-access/vnc.adoc
katshann-raspberry Oct 6, 2025
e1a6b95
Update documentation/asciidoc/computers/software-sources.adoc
katshann-raspberry Oct 6, 2025
382a85d
Add two more image changes
katshann-raspberry Oct 6, 2025
0853827
Updates from Andrew review!
katshann-raspberry Oct 6, 2025
6e4c577
Some quick accessibility wins
katshann-raspberry Oct 6, 2025
f1a6166
Accessibility tweak
katshann-raspberry Oct 6, 2025
12bcd32
Update nav header to h2. CSS tweak to retain size.
katshann-raspberry Oct 7, 2025
93c3553
Further CSS tweaks
katshann-raspberry Oct 7, 2025
81eebfd
Merge pull request #4204 from raspberrypi/trixie-followup
katshann-raspberry Oct 7, 2025
8ac282a
Merge pull request #4206 from raspberrypi/accessibility-tweaks
katshann-raspberry Oct 7, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .github/workflows/build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,8 @@ jobs:
echo "Pull requests based on master can only come from the develop branch of this repository"
echo "Please check your base branch as it should be develop by default"
exit 1
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
- uses: actions/checkout@v5
- uses: actions/setup-python@v6
with:
python-version: 3.9
- name: Install Python dependencies
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/stale.yml
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ jobs:
pull-requests: write

steps:
- uses: actions/stale@v9
- uses: actions/stale@v10
with:
repo-token: ${{ secrets.GITHUB_TOKEN }}
stale-issue-message: 'This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.'
Expand Down
Binary file modified documentation/asciidoc/accessories/build-hat/images/setting-up.png
100755 → 100644
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

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].

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.
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.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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.
Attach 9 mm 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.


video::images/fitting-build-hat.webm[width="80%"]

Expand All @@ -18,22 +18,22 @@ The following pins are used by the Build HAT itself and you should not connect a
[cols="^1,^1,^1", width="75%", options="header"]
|===
| GPIO| Use | Status
| GPIO0/1 | ID prom |
| GPIO4| Reset |
| GPIO14| Tx |
| GPIO15| Rx |
| GPIO0/1 | ID prom |
| GPIO4| Reset |
| GPIO14| Tx |
| GPIO15| Rx |
| GPIO16 | RTS | unused
| GPIO17 | CTS | unused
|===


=== Set up your Raspberry Pi

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".
Once the Raspberry Pi has booted, open the Control Centre tool by selecting the Raspberry Menu button and then selecting **Preferences > Control Centre**.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Once the Raspberry Pi has booted, open the Control Centre tool by selecting the Raspberry Menu button and then selecting **Preferences > Control Centre**.
After the Raspberry Pi has booted, open the Control Centre tool by selecting the Raspberry Menu button and then selecting **Preferences > Control Centre**.


Click on the "interfaces" tab and adjust the Serial settings as shown below:
Select the **Interfaces** tab and adjust the serial settings as shown in the following image:

image::images/setting-up.png[width="50%"]
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%"]

==== Use your Raspberry Pi headless

Expand Down
4 changes: 2 additions & 2 deletions documentation/asciidoc/accessories/display/display_intro.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ image::images/display.png[The Raspberry Pi 7-inch Touch Display, width="70%"]

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.

The display has the following key features:
The display has the following key features:

* 800×480px RGB LCD display
* 24-bit colour
Expand Down Expand Up @@ -79,7 +79,7 @@ Raspberry Pi OS _Bookworm_ and later include the Squeekboard on-screen keyboard

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.

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`.
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`.

TIP: In Raspberry Pi OS releases prior to _Bookworm_, use `matchbox-keyboard` instead. If you use the wayfire desktop compositor, use `wvkbd` instead.

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
28 changes: 14 additions & 14 deletions documentation/asciidoc/accessories/touch-display-2/about.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
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 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%"]
Expand Down Expand Up @@ -36,7 +36,7 @@ The Touch Display 2 is available in two sizes: 5-inch and 7-inch (measured diago
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.
* **24-bit RGB display.** Capable of showing over 16 million colours.
* **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.
Expand All @@ -62,7 +62,7 @@ image::images/touch-display-2-whats-in-the-booooox.jpg["Parts included in the To
The Touch Display 2 connects to a Raspberry Pi using:

- A **DSI connector** for video and touch data.
- The **GPIO header** for power.
- 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:

Expand All @@ -78,7 +78,7 @@ After determining the correct FFC for your Raspberry Pi model, you can connect y
.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%"]

IMPORTANT: Disconnect your Raspberry Pi from power before completing the following steps.
IMPORTANT: Disconnect your Raspberry Pi from power before completing the following steps.

=== Step 1. Connect FFC to Touch Display 2

Expand All @@ -90,16 +90,16 @@ IMPORTANT: Disconnect your Raspberry Pi from power before completing the followi

=== 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**, **CAM/DISP**, or **DISP**.
. 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**, **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 down 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].
. 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.

Expand All @@ -123,7 +123,7 @@ Raspberry Pi OS **Bookworm** and later already includes the **Squeekboard on-scr

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.
- **Raspberry Pi desktop interface:** From the Raspberry Pi menu, go to **Preferences > Control Centre > 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
Expand All @@ -135,7 +135,7 @@ You have four rotation options:
- **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.
- **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.

=== With a desktop
If you have the Raspberry Pi OS desktop running, you can rotate the display through the **Screen Configuration** tool:
Expand All @@ -160,14 +160,14 @@ 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 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`).

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`.
Expand Down Expand Up @@ -210,14 +210,14 @@ dtoverlay=vc4-kms-dsi-ili9881-7inch,invx,invy

== 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.
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 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.
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.

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:

- 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).
- Using a HAT EEPROM (if present).


12 changes: 6 additions & 6 deletions documentation/asciidoc/computers/config_txt/overclocking.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ WARNING: Setting any overclocking parameters to values other than those used by
| SDRAM phy voltage adjustment. [-16,8] equates to [0.8V,1.4V] with 0.025V steps. Not supported on Raspberry Pi 4 or later devices.

| force_turbo
| Forces turbo mode frequencies even when the ARM cores are not busy. Enabling this may set the warranty bit if `over_voltage_*` is also set.
| Forces turbo mode frequencies even when the Arm cores are not busy. Enabling this may set the warranty bit if `over_voltage_*` is also set.

| initial_turbo
| Enables https://forums.raspberrypi.com/viewtopic.php?f=29&t=6201&start=425#p180099[turbo mode from boot] for the given value in seconds, or until `cpufreq` sets a frequency. The maximum value is `60`. The November 2024 firmware update made the following changes:
Expand Down Expand Up @@ -339,17 +339,17 @@ NOTE: There is no need to use `hdmi_enable_4kp60` on Flagship models since Raspb

==== `force_turbo`

By default (`force_turbo=0`) the on-demand CPU frequency driver will raise clocks to their maximum frequencies when the ARM cores are busy, and will lower them to the minimum frequencies when the ARM cores are idle.
By default (`force_turbo=0`) the on-demand CPU frequency driver will raise clocks to their maximum frequencies when the Arm cores are busy, and will lower them to the minimum frequencies when the Arm cores are idle.

`force_turbo=1` overrides this behaviour and forces maximum frequencies even when the ARM cores are not busy.
`force_turbo=1` overrides this behaviour and forces maximum frequencies even when the Arm cores are not busy.

=== Clocks relationship

==== Raspberry Pi 4

The GPU core, CPU, SDRAM and GPU each have their own PLLs and can have unrelated frequencies. The h264, v3d and ISP blocks share a PLL.

To view the Raspberry Pi's current frequency in KHz, type: `cat /sys/devices/system/cpu/cpu0/cpufreq/scaling_cur_freq`. Divide the result by 1000 to find the value in MHz. Note that this frequency is the kernel _requested_ frequency, and it is possible that any throttling (for example at high temperatures) may mean the CPU is actually running more slowly than reported. An instantaneous measurement of the actual ARM CPU frequency can be retrieved using the vcgencmd `vcgencmd measure_clock arm`. This is displayed in Hertz.
To view the Raspberry Pi's current frequency in KHz, type: `cat /sys/devices/system/cpu/cpu0/cpufreq/scaling_cur_freq`. Divide the result by 1000 to find the value in MHz. Note that this frequency is the kernel _requested_ frequency, and it is possible that any throttling (for example at high temperatures) may mean the CPU is actually running more slowly than reported. An instantaneous measurement of the actual Arm CPU frequency can be retrieved using the vcgencmd `vcgencmd measure_clock arm`. This is displayed in Hertz.

=== Monitoring core temperature
[.whitepaper, title="Cooling a Raspberry Pi device", subtitle="", link=https://pip.raspberrypi.com/documents/RP-003608-WP-Cooling-a-Raspberry-Pi-device.pdf]
Expand All @@ -368,7 +368,7 @@ Divide the result by 1000 to find the value in degrees Celsius. Alternatively, y

Hitting the temperature limit is not harmful to the SoC, but it will cause the CPU to throttle. A heat sink can help to control the core temperature, and therefore performance. This is especially useful if the Raspberry Pi is running inside a case. Airflow over the heat sink will make cooling more efficient.

When the core temperature is between 80°C and 85°C, the ARM cores will be throttled back. If the temperature exceeds 85°C, the ARM cores and the GPU will be throttled back.
When the core temperature is between 80°C and 85°C, the Arm cores will be throttled back. If the temperature exceeds 85°C, the Arm cores and the GPU will be throttled back.

For the Raspberry Pi 3 Model B+, the PCB technology has been changed to provide better heat dissipation and increased thermal mass. In addition, a soft temperature limit has been introduced, with the goal of maximising the time for which a device can "sprint" before reaching the hard limit at 85°C. When the soft limit is reached, the clock speed is reduced from 1.4GHz to 1.2GHz, and the operating voltage is reduced slightly. This reduces the rate of temperature increase: we trade a short period at 1.4GHz for a longer period at 1.2GHz. By default, the soft limit is 60°C. This can be changed via the `temp_soft_limit` setting in `config.txt`.

Expand All @@ -378,7 +378,7 @@ It is essential to keep the supply voltage above 4.8V for reliable performance.

To monitor the Raspberry Pi's PSU voltage, you will need to use a multimeter to measure between the VCC and GND pins on the GPIO. More information is available in the xref:raspberry-pi.adoc#power-supply[power] section of the documentation.

If the voltage drops below 4.63V (±5%), the ARM cores and the GPU will be throttled back, and a message indicating the low voltage state will be added to the kernel log.
If the voltage drops below 4.63V (±5%), the Arm cores and the GPU will be throttled back, and a message indicating the low voltage state will be added to the kernel log.

The Raspberry Pi 5 PMIC has built in ADCs that allow the supply voltage to be measured. To view the current supply voltage, run the following command:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ NOTE: Starting with Raspberry Pi OS _Bookworm_, Network Manager is the default n

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.

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.
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.

image::images/wifi2.png[wifi2]

Expand Down
Loading