From 06d775953a23a9ae31e1ca93d07d5dd799f44f83 Mon Sep 17 00:00:00 2001
From: Maximilian Gerhardt <maximilian.gerhardt@rub.de>
Date: Tue, 4 Feb 2025 20:31:53 +0100
Subject: [PATCH 1/2] Document PSRAM and Boot2 better

---
 docs/platformio.rst | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/docs/platformio.rst b/docs/platformio.rst
index 42e9ad5da..b0e0f7fdf 100644
--- a/docs/platformio.rst
+++ b/docs/platformio.rst
@@ -172,6 +172,37 @@ To learn more about PSRAM usage, see: :doc:`RP2350 PSRAM Support <psram>`
     ; PSRAM size: 4MB
     board_upload.psram_length = 4194304
 
+PSRAM chip select (CS)
+----------
+
+For RP2350 based boards, this controls what chip-select (also called: slave-select / SS) pin to use when wanting to talk to the PSRAM chip.
+
+Note that it's not needed to set this with a board that is known to have a PSRAM chip on-board, such as a "Sparkfun Thing Plus 2350". The ``pins_arduino.h`` of that variant already has the correct definition.
+
+To learn more about PSRAM usage, see: :doc:`RP2350 PSRAM Support <psram>` 
+
+.. code:: ini
+
+    ; PSRAM CS is at GP47
+    build_flags =
+      -DRP2350_PSRAM_CS=47
+
+
+Boot2 Source
+------------
+
+Boot2 is the second stage bootloader and predominantly used on the RP2040.
+Its main purpose is to configure the communication with the Flash at the highest, safest speed it can.
+All known boards have their correct value already configured. However, when choosing ``board = generic``,
+you can freely configure the Boot2 to be for a different flash. 
+
+For possible Boot2 filenames, `please see here <https://github.com/earlephilhower/arduino-pico/tree/master/boot2/rp2040>`__.
+
+.. code:: ini
+
+    ; expect an ISSI IS25LP080 flash, SPI frequency = CPU frequency divided by 2 
+    board_build.arduino.earlephilhower.boot2_source = boot2_is25lp080_2_padded_checksum.S
+
 CPU Speed
 ---------
 

From 4c13ccf92484696746a220fc70d2c5c308eb7790 Mon Sep 17 00:00:00 2001
From: "Earle F. Philhower, III" <earlephilhower@yahoo.com>
Date: Tue, 4 Feb 2025 12:01:26 -0800
Subject: [PATCH 2/2] Update platformio.rst

---
 docs/platformio.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/platformio.rst b/docs/platformio.rst
index b0e0f7fdf..0cc29eb8d 100644
--- a/docs/platformio.rst
+++ b/docs/platformio.rst
@@ -173,7 +173,7 @@ To learn more about PSRAM usage, see: :doc:`RP2350 PSRAM Support <psram>`
     board_upload.psram_length = 4194304
 
 PSRAM chip select (CS)
-----------
+----------------------
 
 For RP2350 based boards, this controls what chip-select (also called: slave-select / SS) pin to use when wanting to talk to the PSRAM chip.