diff --git a/components/rp2040.rst b/components/rp2040.rst
index 6adcb8f6f..94387f906 100644
--- a/components/rp2040.rst
+++ b/components/rp2040.rst
@@ -18,6 +18,19 @@ This component contains platform-specific options for the RP2040 platform.
     rp2040:
       board: rpipicow
 
+.. note::
+
+    For now, you need the following added to the config or you will get compile errors and board not found:
+
+.. code-block:: yaml
+
+    # Example configuration entry
+    rp2040:
+      board: rpipicow
+      framework:
+        platform_version: https://github.com/maxgerhardt/platform-raspberrypi.git
+
+
 Configuration variables:
 ------------------------