Merge pull request #3890 from raspberrypi/ai

Add documentation for SSDs and SSD Kits; improve SD card documentation for parallelism

Author: nathan-contino

documentation/asciidoc/accessories/sd-cards/about.adoc

@@ -1,9 +1,9 @@
 == About
 
-.A 64GB Raspberry Pi SD Card
-image::images/sd-cards.jpg[width="80%"]
+.A Raspberry Pi SD Card inserted into a Raspberry Pi 5
+image::images/sd-hero.jpg[width="80%"]
 
-SD card quality is a critical factor in determining the overall user experience for a Raspberry Pi computer. Slow bus speeds and lack of command queueing can reduce the performance of even the most powerful Raspberry Pi models.
+SD card quality is a critical factor in determining the overall user experience for a Raspberry Pi. Slow bus speeds and lack of command queueing can reduce the performance of even the most powerful Raspberry Pi models.
 
 Raspberry Pi's official microSD cards support DDR50 and SDR104 bus speeds. Additionally, Raspberry Pi SD cards support the command queueing (CQ) extension, which permits some pipelining of random read operations, ensuring optimal performance.
 
@@ -17,20 +17,21 @@ Raspberry Pi SD cards are available in the following sizes:
 
 == Specifications
 
-Raspberry Pi SD cards have the following specifications:
+.A 128GB Raspberry Pi SD Card
+image::images/sd-cards.png[width="80%"]
 
-Speed Class: C10, U3, V30, A2
+Raspberry Pi SD cards use the SD6.1 SD specification.
 
-Random 4KB read performance:
+Raspberry Pi SD cards use the microSDHC/microSDXC form factor.
 
-* 3,200 IOPS on Raspberry Pi 4 (DDR50)
-* 5,000 IOPS on Raspberry Pi 5 (SDR104)
+Raspberry Pi SD cards have the following Speed Class ratings: C10, U3, V30, A2.
 
-Random 4KB write performance:
+The following table describes the read and write speeds of Raspberry Pi SD cards using 4KB of random data:
 
-* 1,200 IOPS on Raspberry Pi 4 (DDR50)
-* 2,000 IOPS on Raspberry Pi 5 (SDR104)
+|===
+| Raspberry Pi Model | Interface | Read Speed | Write Speed
 
-Form factor: microSDHC/microSDXC
+| 4 | DDR50  | 3,200 IOPS | 1,200 IOPS
+| 5 | SDR104 | 5,000 IOPS | 2,000 IOPS
+|===
 
-SD specification: SD6.1

documentation/asciidoc/accessories/sd-cards/images/sd-cards.jpg

@@ -0,0 +1 @@
+include::ssd-kit/about.adoc[]

documentation/asciidoc/accessories/sd-cards/images/sd-cards.png

@@ -0,0 +1,13 @@
+== About
+
+.A 512GB Raspberry Pi SSD Kit
+image::images/ssd-kit.png[width="80%"]
+
+The Raspberry Pi SSD Kit bundles a xref:../accessories/m2-hat-plus.adoc[Raspberry Pi M.2 HAT+] with a xref:../accessories/ssds.adoc[Raspberry Pi SSD].
+
+The Raspberry Pi SSD Kit includes a 16mm stacking header, spacers, and
+screws to enable fitting on Raspberry Pi 5 alongside a Raspberry Pi Active Cooler.
+
+== Install
+
+To install the Raspberry Pi SSD Kit, follow the xref:../accessories/m2-hat-plus.adoc#m2-hat-plus-installation[installation instructions for the Raspberry Pi M.2 HAT+].

documentation/asciidoc/accessories/sd-cards/images/sd-hero.jpg

@@ -0,0 +1 @@
+include::ssds/about.adoc[]

documentation/asciidoc/accessories/ssd-kit.adoc

@@ -0,0 +1,32 @@
+== About
+
+.A 512GB Raspberry Pi SSD
+image::images/ssd.png[width="80%"]
+
+SSD quality is a critical factor in determining the overall user experience for a Raspberry Pi.
+Raspberry Pi provides official SSDs that are tested to ensure compatibility with Raspberry Pi models and peripherals.
+
+Raspberry Pi SSDs are available in the following sizes:
+
+* 256GB
+* 512GB
+
+To use an SSD with your Raspberry Pi, you need a Raspberry Pi 5-compatible M.2 adapter, such as the xref:../accessories/m2-hat-plus.adoc[Raspberry Pi M.2 HAT+].
+
+== Specifications
+
+Raspberry Pi SSDs are PCIe Gen 3-compliant.
+
+Raspberry Pi SSDs use the NVMe 1.4 register interface and command set.
+
+Raspberry Pi SSDs use the M.2 2230 from factor.
+
+The following table describes the read and write speeds of Raspberry Pi SSDs using 4KB of random data:
+
+[cols="1,2,2"]
+|===
+| Size | Read Speed | Write Speed
+
+| 256GB | 40,000 IOPS | 70,000 IOPS
+| 512GB | 50,000 IOPS | 90,000 IOPS
+|===