Add placeholder image and update instructional text

documentation/asciidoc/accessories/audio/configuration.adoc

@@ -6,13 +6,13 @@ image::images/gui.png[]
 
 There are a number of third-party audio software applications available for Raspberry Pi that will support the plug-and-play feature of our audio boards. Often these are used headless. They can be controlled via a PC or Mac application, or by a web server installed on Raspberry Pi, with interaction through a webpage.
 
-If you need to configure Raspberry Pi OS yourself, perhaps if you're running a headless system of your own and don't have the option of control via the GUI, you will need to make your Raspberry Pi audio board the primary audio device in Raspberry Pi OS, disabling the Raspberry Pi’s on-board audio device. This is done by editing the `/boot/config.txt` file. Using a Terminal session connected to your Raspberry Pi via SSH, run the following command to edit the file:
+If you need to configure Raspberry Pi OS yourself, perhaps if you're running a headless system of your own and don't have the option of control via the GUI, you will need to make your Raspberry Pi audio board the primary audio device in Raspberry Pi OS, disabling the Raspberry Pi’s on-board audio device. This is done by editing the xref:../computers/config_txt.adoc#what-is-config-txt[`/boot/firmware/config.txt`] file. Using a Terminal session connected to your Raspberry Pi via SSH, run the following command to edit the file:
 
 ----
-$ sudo nano /boot/config.txt
+$ sudo nano /boot/firmware/config.txt
 ----
 
-Find the `dtparam=audio=on` line in the file and comment it out by placing a # symbol at the start of the line. Anything written after the # symbol in any given line will be disregarded by the program. Your ``/boot/config.txt`` file should now have the following entry:
+Find the `dtparam=audio=on` line in the file and comment it out by placing a # symbol at the start of the line. Anything written after the # symbol in any given line will be disregarded by the program. Your `/boot/firmware/config.txt` file should now contain the following entry:
 
 ----
 #dtparam=audio=on
@@ -24,7 +24,7 @@ Press CTRL+X, then Y and Enter to save, followed by a reboot of your Raspberry P
 $ sudo reboot
 ----
 
-Alternatively, the `/boot/config.txt` file can be edited directly onto the Raspberry Pi's microSD card, inserted into your usual computer. Using the default file manager, open the `boot` volume on the card and edit the `config.txt` file using an appropriate text editor, then save the file, eject the microSD card and reinsert it back into your Raspberry Pi.
+Alternatively, the `/boot/firmware/config.txt` file can be edited directly onto the Raspberry Pi's microSD card, inserted into your usual computer. Using the default file manager, open the `/boot/firmware/` volume on the card and edit the `config.txt` file using an appropriate text editor, then save the file, eject the microSD card and reinsert it back into your Raspberry Pi.
 
 === Attaching the HAT
 

documentation/asciidoc/accessories/audio/getting_started.adoc

@@ -18,7 +18,9 @@ Use a small flat-head screwdriver to attach your speaker to the screw terminals.
 
 === Setting up your Raspberry Pi
 
-In this example, we are using Raspberry Pi OS Lite. Our guides on https://www.raspberrypi.com/documentation/computers/getting-started.html#installing-the-operating-system[Getting started] cover this topic in great detail. Make sure that you update your operating system before proceeding and follow the instructions provided for Codec Zero configuration, including the commands to enable the on-board microphone and speaker output.
+In this example, we are using Raspberry Pi OS Lite. Refer to our guide on xref:../computers/getting-started.adoc#installing-the-operating-system[installing Raspberry Pi OS] for more details.
+
+Make sure that you update your operating system before proceeding and follow the instructions provided for Codec Zero configuration, including the commands to enable the on-board microphone and speaker output.
 
 === Programming your Raspberry Pi
 

documentation/asciidoc/accessories/audio/hardware-info.adoc

@@ -70,16 +70,6 @@ To restore a saved file:
 $ sudo alsactl restore -f /home/pi/usecase.state
 ----
 
-=== Using external USB devices
-
-If you want to enable 1.2 amp USB support (to allow USB hard disks to power up when
-accessory boards are in use), you may also want to add the following line to your `/boot/config.txt`
-file:
-
-----
-max_usb_current=1
-----
-
 === MPD-based audio with volume control
 
 To allow Music Player Daemon (MPD)-based audio software to control the audio board’s built in volume, the file

documentation/asciidoc/accessories/build-hat/py-installing-software.adoc

@@ -6,7 +6,7 @@ Install the Build HAT Python library. Open a Terminal window and type,
 
 [source]
 ----
-$ pip3 install buildhat 
+$ sudo apt install python3-buildhat 
 ----
 
 For more information about the Build HAT Python Library see https://buildhat.readthedocs.io/[ReadTheDocs].

documentation/asciidoc/accessories/camera/camera_hardware.adoc

@@ -190,7 +190,7 @@ Then, please follow the relevant setup instructions for the xref:../computers/ca
 | Depends on lens
 
 | Maximum exposure times (seconds)
-| 6 (legacy) / 0.97 (libcamera)
+| 0.97
 | 11.76
 | 112
 | 112

documentation/asciidoc/accessories/camera/synchronous_cameras.adoc

@@ -18,7 +18,7 @@ Connect the XVS wires to the 1.65V potential divider pull up.
 
 ==== Boot up both Raspberry Pis
 
-The file `/sys/module/imx477/parameters/trigger_mode` determines which board outputs pulses, or waits to recieve pulses (source and sink).
+The file `/sys/module/imx477/parameters/trigger_mode` determines which board outputs pulses, or waits to receive pulses (source and sink).
 This parameter can only be altered in superuser mode.
 
 On the sink, run:
@@ -57,7 +57,7 @@ This ensures that no frames are created or lost upon startup. The source whilst
 
 === Using the GS Camera
 
-NOTE: The Global Shutter (GS) camera can also be operated in a synchonous mode. However, the source camera will record one extra frame. A much better alternative method to ensure that both cameras capture the same amount of frames is to use the xref:camera.adoc#external-trigger-on-the-gs-camera[external trigger method].
+NOTE: The Global Shutter (GS) camera can also be operated in a synchronous mode. However, the source camera will record one extra frame. A much better alternative method to ensure that both cameras capture the same amount of frames is to use the xref:camera.adoc#external-trigger-on-the-gs-camera[external trigger method].
 
 To operate as source and sink together, the Global Shutter Cameras also require connection of the XHS (horizontal sync) pins together. However, these do not need connection to a pullup resistor.
 

documentation/asciidoc/accessories/display/display_intro.adoc

@@ -1,36 +1,47 @@
 == Raspberry Pi Touch Display
 
-The Raspberry Pi Touch Display is an LCD display which connects to the Raspberry Pi through the DSI connector. In some situations, it allows for the use of both the HDMI and LCD displays at the same time (this requires software support).
+The https://www.raspberrypi.com/products/raspberry-pi-touch-display/[Raspberry Pi Touch Display] is an LCD display which connects to the Raspberry Pi through the DSI connector. In recent versions of Raspberry Pi OS, both the HDMI and LCD display outputs can be used at the same time.
 
 === Board Support
 
 The DSI display is designed to work with all models of Raspberry Pi, however early models that do not have mounting holes (the Raspberry Pi 1 Model A and B) will require additional mounting hardware to fit the HAT-dimensioned stand-offs on the display PCB.
 
-=== Physical Installation
+=== Connecting a Raspberry Pi
 
-The following image shows how to attach the Raspberry Pi to the back of the Touch Display (if required), and how to connect both the data (ribbon cable) and power (red/black wires) from the Raspberry Pi to the display. If you are not attaching the Raspberry Pi to the back of the display, take extra care when attaching the ribbon cable to ensure it is the correct way round. The black and red power wires should be attached to the GND and 5v pins respectively.
+The following image shows how to attach a Raspberry Pi to the back of the Touch Display using the included standoffs. It also shows the connections you need to make between Raspberry Pi and the display's PCB. You can also mount the touch display in a separate chassis if you have one available. The connections remain the same, though you may need longer cables depending on the chassis you use.
 
-image::images/GPIO_power-500x333.jpg[DSI Display Connections]
+image::images/GPIO_power-500x333.jpg[DSI Display pinout]
 
-The other three pins should be left disconnected, unless connecting the display to an original Raspberry Pi 1 Model A or B. See the section on xref:display.adoc#legacy-support[legacy support] for more information on connecting the display to an original Raspberry Pi.
+Connect one end of the ribbon cable to the `RPI-DISPLAY` port on the Touch Display PCB (make sure the blue stripe faces the PCB) and then connect the other end to the `DISPLAY` port on the Raspberry Pi (the blue stripe should face outwards).
+
+==== Powering the Touch Display
+
+There are two options to power the Touch Display: using the Raspberry Pi's GPIO to send power, or powering the display directly with a separate micro USB cable. 
+
+WARNING: If you use a micro USB cable to power the display it must be mounted inside a chassis to reduce the risk of electrocution. The chassis also must block access to the display's PCB while its in use.
+
+The following instructions are only relevant if you're using the Raspberry Pi for power. Do not make these connections when powering the display through its micro USB port.
+
+Make sure the Raspberry Pi is powered off and unplugged, then connect one end of the black jumper wire to pin six (GND) on the Raspberry Pi and one end of the red jumper wire to pin four (5V). Next, connect the other end of the black wire to the GND pin on the display and the other end of the red wire to the 5V pin on the display.
+
+.Connect the red and black wires to 5V and GND
+image::images/touch-GPIO.png[Illustration of display pins, width=250]
+
+The other three pins on the Touch Display are used to connect the display to an original Raspberry Pi 1 Model A or B. Refer to our documentation on xref:display.adoc#legacy-support[legacy support] for more information.
 
 NOTE: An original Raspberry Pi can be easily identified from other models, it is the only model with a 26-pin rather than 40-pin GPIO header connector.
 
 === Screen Orientation
 
 LCD displays have an optimum viewing angle, and depending on how the screen is mounted it may be necessary to change the orientation of the display to give the best results. By default, the Raspberry Pi Touch Display and Raspberry Pi are set up to work best when viewed from slightly above, for example on a desktop. If viewing from below, you can physically rotate the display, and then tell the system software to compensate by running the screen upside down.
 
-==== KMS and FKMS Mode
-
-KMS and FKMS modes are used by default on the Raspberry Pi 4B. KMS and FKMS use the DRM/MESA libraries to provide graphics and 3D acceleration.
-
 To set screen orientation when running the graphical desktop, select the `Screen Configuration` option from the `Preferences` menu. Right click on the DSI display rectangle in the layout editor, select Orientation then the required option.
 
 To set screen orientation when in console mode, you will need to edit the kernel command line to pass the required orientation to the system.
 
 [,bash]
 ----
-sudo nano /boot/cmdline.txt
+sudo nano /boot/firmware/cmdline.txt
 ----
 
 To rotate by 90 degrees clockwise, add the following to the cmdline, making sure everything is on the same line, do not add any carriage returns. Possible rotation values are 0, 90, 180 and 270.
@@ -39,47 +50,7 @@ To rotate by 90 degrees clockwise, add the following to the cmdline, making sure
 video=DSI-1:800x480@60,rotate=90
 ----
 
-NOTE: In console mode it is not possible to rotate the DSI display separately to the HDMI display, so if you have both attached they must both be set to the same value.
-
-==== Legacy Graphics Mode
-
-Legacy graphics mode is used by default on all Raspberry Pi models prior to the Raspberry Pi 4B, and can also be used on the Raspberry Pi 4B if required, by disabling KMS and FKMS modes by commenting out the KMS or FKMS line in `config.txt`. 
-
-NOTE: Legacy mode on the Raspberry Pi 4B has no 3D acceleration so it should only be used if you have a specific reason for needing it.
-
-To flip the display, add the following line to the file `/boot/config.txt`:
-
-`lcd_rotate=2`
-
-This will vertically flip the LCD and the touch screen, compensating for the physical orientation of the display.
-
-You can also rotate the display by adding the following to the `config.txt` file.
-
-* `display_lcd_rotate=x`, where `x` can be one of the following:
-
-|===
-| display_lcd_rotate | result
-
-| 0
-| no rotation
-
-| 1
-| rotate 90 degrees clockwise
-
-| 2
-| rotate 180 degrees clockwise
-
-| 3
-| rotate 270 degrees clockwise
-
-| 0x10000
-| horizontal flip
-
-| 0x20000
-| vertical flip
-|===
-
-NOTE: The 90 and 270 degree rotation options require additional memory on the GPU, so these will not work with the 16MB GPU split.
+NOTE: In console mode it is not possible to rotate the DSI display separately to the HDMI display, so if you have both attached they must both be set to the same rotation value.
 
 === Touchscreen Orientation
 
@@ -136,4 +107,4 @@ Read our troubleshooting steps, tips, and tricks here: xref:display.adoc#trouble
 
 * Outer dimensions: 192.96 × 110.76mm
 * Viewable area: 154.08 × 85.92mm
-* https://datasheets.raspberrypi.com/display/7-inch-display-mechanical-drawing.pdf[Download mechanical drawing (PDF)]
+* https://datasheets.raspberrypi.com/display/7-inch-display-mechanical-drawing.pdf[Download mechanical drawing (PDF)]

documentation/asciidoc/accessories/display/legacy.adoc

@@ -8,10 +8,9 @@ Using the jumper cables, connect SCL/SDA on the GPIO header to the horizontal pi
 
 For the GPIO header pinout, see http://pinout.xyz/[this diagram].
 
-DSI display autodetection is disabled by default on these boards. To enable detection, add the following line to `/boot/config.txt`:
+DSI display autodetection is disabled by default on these boards. To enable detection, add the following line to the xref:../computers/config_txt.adoc#what-is-config-txt[`/boot/firmware/config.txt`] file:
 
 `ignore_lcd=0`
 
 Power the setup via the `PWR IN` micro-USB connector on the display board. Do not power the setup via the Raspberry Pi's micro-USB port: the input polyfuse's maximum current rating will be exceeded as the display consumes approximately 400mA.
 
-NOTE: With the display connected to the GPIO I2C pins, the GPU will assume control of the respective I2C bus. The host operating system should not access this I2C bus, as simultaneous use of the bus by both the GPU and Linux will result in sporadic crashes.