Merge pull request #3908 from raspberrypi/usb-hub

Update Touch display and hub doc

Author: nathan-contino

documentation/asciidoc/accessories/display/display_intro.adoc

@@ -5,7 +5,7 @@ The https://www.raspberrypi.com/products/raspberry-pi-touch-display/[Raspberry P
 .The Raspberry Pi 7-inch Touch Display
 image::images/display.png[The Raspberry Pi 7-inch Touch Display, width="70%"]
 
-The Touch Display is compatible with all models of Raspberry Pi from Raspberry Pi 1B+ onwards, except Raspberry Pi Zero and Zero 2 W, 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 Touch Display is compatible with all models of Raspberry Pi, except Raspberry Pi Zero and Zero 2 W, 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: 
 
@@ -113,7 +113,7 @@ NOTE: It is not possible to rotate the DSI display separately from the HDMI disp
 
 WARNING: Rotating touch input via device tree can cause conflicts with your input library. Whenever possible, configure touch event rotation in your input library or desktop.
 
-Rotation of touch input is independent of the orientation of the display itself. To change this you need to manually add a `dtoverlay` instruction in xref:../computers/config_txt.adoc[`/boot/firmware/config.txt`]. Add the following line in `config.txt`:
+Rotation of touch input is independent of the orientation of the display itself. To change this you need to manually add a `dtoverlay` instruction in xref:../computers/config_txt.adoc[`/boot/firmware/config.txt`]. Add the following line at the end of `config.txt`:
 
 [source,ini]
 ----

documentation/asciidoc/accessories/touch-display-2/about.adoc

@@ -42,12 +42,12 @@ Once you have determined the correct FFC for your Raspberry Pi model, complete t
 
 . Disconnect your Raspberry Pi from power.
 . Lift the retaining clips on either side 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 copper contacts facing upwards, away from 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.
 +
 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 copper contacts facing towards the Ethernet and USB-A ports.
+. 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.
@@ -77,7 +77,7 @@ If you want to physically rotate the display, or mount it in a specific position
 
 ==== Rotate screen without a desktop
 
-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 line to `cmdline.txt`:
+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`:
 
 [source,ini]
 ----

documentation/asciidoc/accessories/usb-3-hub.adoc

@@ -0,0 +1 @@
+include::usb-3-hub/about.adoc[]

documentation/asciidoc/accessories/usb-3-hub/about.adoc

@@ -0,0 +1,17 @@
+== About
+
+The https://www.raspberrypi.com/products/usb-3-hub/[Raspberry Pi USB 3 Hub] provides extra connectivity for your devices, extending one USB-A port into four. An optional external USB-C power input supports high-power peripherals. You can use the USB 3 Hub to power low-power peripherals, such as most mice and keyboards, using no external power.
+
+.The Raspberry Pi USB 3.0 Hub
+image::images/usb-3-hub-hero.png[width="80%"]
+
+== Specification
+
+* 1× upstream USB 3.0 Type-A male connector on 8cm captive cable
+* 4× downstream USB 3.0 Type-A ports
+* Data transfer speeds up to 5Gbps
+* Power transfer up to 900 mA (4.5 W); optional external USB-C power input provides up to 5V @ 3A for high-power downstream peripherals
+* Compatible with USB 3.0 and USB 2.0 Type-A host ports
+
+.Physical specification
+image::images/usb-3-hub-physical-specification.png[]

documentation/asciidoc/accessories/usb-3-hub/images/usb-3-hub-hero.png

@@ -132,6 +132,12 @@
                     "image": "full-sized/Keyboard-and-Mouse.png",
                     "subpath": "keyboard-and-mouse.adoc"
                 },
+                {
+                    "title": "USB Hub",
+                    "description": "Official Raspberry Pi USB hub",
+                    "image": "full-sized/usb-3-hub.png",
+                    "subpath": "usb-3-hub.adoc"
+                },
                 {
                     "title": "Build HAT",
                     "description": "How to use the Build HAT",