Merge pull request #3934 from raspberrypi/develop

Release p2w

Author: nathan-contino

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

@@ -81,7 +81,7 @@ To set the screen orientation on a device that lacks a desktop environment, edit
 
 [source,ini]
 ----
-video=DSI-1:1280x720@60,rotate=<rotation-value>
+video=DSI-1:720x1280@60,rotate=<rotation-value>
 ----
 
 Replace the `<rotation-value>` placeholder with one of the following values, which correspond to the degree of rotation relative to the default on your display:
@@ -103,10 +103,10 @@ The `vc4-kms-dsi-ili9881-7inch` overlay supports the following options:
 | DT parameter | Action
 
 | `sizex`
-| Sets X resolution (default 1280)
+| Sets X resolution (default 720)
 
 | `sizey`
-| Sets Y resolution (default 720)
+| Sets Y resolution (default 1280)
 
 | `invx`
 | Invert X coordinates

documentation/asciidoc/computers/raspberry-pi/images/pico-2-w.png

@@ -365,6 +365,12 @@ a|
 .Raspberry Pi Pico 2
 image::images/pico-2.png[alt="Raspberry Pi Pico 2"]
 | xref:../microcontrollers/silicon.adoc#rp2350[RP2350] | 520KB | 4MB | two 20-pin GPIO headers (unpopulated) ^| none
+a|
+.Raspberry Pi Pico 2 W
+image::images/pico-2-w.png[alt="Raspberry Pi Pico 2 W"]
+| xref:../microcontrollers/silicon.adoc#rp2350[RP2350] | 520KB | 4MB | two 20-pin GPIO headers (unpopulated) a|
+* 2.4GHz single-band 802.11n Wi-Fi (10Mb/s)
+* Bluetooth 5.2, Bluetooth Low Energy (BLE)
 
 |===
 

documentation/asciidoc/computers/raspberry-pi/introduction.adoc

@@ -28,13 +28,17 @@ https://datasheets.raspberrypi.com/pico/pico-datasheet.pdf[Raspberry Pi Pico Dat
 
 https://datasheets.raspberrypi.com/pico/getting-started-with-pico.pdf[Getting started with Raspberry Pi Pico]:: C/{cpp} development with Raspberry Pi Pico and other RP2040-based microcontroller boards
 
+=== Raspberry Pi Pico 2 W
+
+https://datasheets.raspberrypi.com/picow/pico-2-w-datasheet.pdf[Raspberry Pi Pico 2 W Datasheet]:: An RP2350-based microcontroller board with wireless
+
+https://datasheets.raspberrypi.com/picow/connecting-to-the-internet-with-pico-w.pdf[Connecting to the Internet with Raspberry Pi Pico W-series]:: Getting Raspberry Pi Pico W-series devices online with C/{cpp} or MicroPython
+
 === Raspberry Pi Pico W
 
 https://datasheets.raspberrypi.com/picow/pico-w-datasheet.pdf[Raspberry Pi Pico W Datasheet]:: An RP2040-based microcontroller board with wireless
 
-https://datasheets.raspberrypi.com/picow/connecting-to-the-internet-with-pico-w.pdf[Connecting to the Internet with Raspberry Pi Pico W]:: Getting Raspberry Pi Pico W online with C/{cpp} or MicroPython
-
-NOTE: Documentation introducing working with Wi-Fi and Bluetooth on Raspberry Pi Pico W with C/{cpp} or MicroPython is presented in the https://datasheets.raspberrypi.com/picow/connecting-to-the-internet-with-pico-w.pdf[Connecting to the Internet with Raspberry Pi Pico W] book.
+https://datasheets.raspberrypi.com/picow/connecting-to-the-internet-with-pico-w.pdf[Connecting to the Internet with Raspberry Pi Pico W-series]:: Getting Raspberry Pi Pico W-series devices online with C/{cpp} or MicroPython
 
 === Software Development
 

documentation/asciidoc/microcontrollers/microcontroller_docs.adoc

@@ -51,6 +51,43 @@ image::images/pico-2-r4-pinout.svg[]
 
 NOTE: More information on Fritzing is available on the https://fritzing.org/[fritzing.org] website.
 
+[[pico2w-technical-specification]]
+=== Raspberry Pi Pico 2 W
+
+Raspberry Pi Pico 2 W adds on-board single-band 2.4GHz wireless interfaces (802.11n) using the Infineon CYW43439 to the Pico 2 hardware. The on-board 2.4GHz wireless interface has the following features:
+
+* Wireless (802.11n), single-band (2.4 GHz)
+* WPA3
+* Soft access point supporting up to four clients
+* Bluetooth 5.2
+** Support for Bluetooth LE Central and Peripheral roles
+** Support for Bluetooth Classic
+
+The onboard antenna is licensed from ABRACON (formerly ProAnt). The wireless interface is connected via
+SPI to the xref:silicon.adoc#rp2350[RP2350] microcontroller.
+
+Due to pin limitations, some of the wireless interface pins are shared. The CLK is shared with VSYS monitor, so only
+when there isn't an SPI transaction in progress can VSYS be read via the ADC. The Infineon CYW43439 DIN/DOUT and
+IRQ all share one pin on the RP2350. Only when an SPI transaction isn't in progress is it suitable to check for IRQs. The interface typically runs at 33MHz.
+
+For best wireless performance, position the antenna in free space. For instance, metal underneath or nearby the
+antenna can reduce performance both in terms of gain and bandwidth. Adding grounded metal to the sides of the
+antenna can improve the antenna's bandwidth.
+
+`libcyw43` is licensed for non-commercial use. However, Pico 2 W users, and anyone else who builds their product around RP2350 and CYW43439, benefit from a free https://github.com/georgerobotics/cyw43-driver/blob/195dfcc10bb6f379e3dea45147590db2203d3c7b/LICENSE.RP[commercial-use license].
+
+In addition to the https://github.com/bluekitchen/btstack/blob/master/LICENSE[standard BTstack licensing] terms, a https://github.com/raspberrypi/pico-sdk/blob/master/src/rp2_common/pico_btstack/LICENSE.RP[supplemental licence] covers commercial use of BTstack with Raspberry Pi Pico 2 W.
+
+==== Pinout and design files
+
+image::images/pico2w-pinout.svg[]
+
+* https://datasheets.raspberrypi.com/picow/pico-2-w-pinout.pdf[Pinout Diagram] (PDF)
+* https://datasheets.raspberrypi.com/picow/pico-2-w-schematic.pdf[Schematic]
+// TODO: add these when available
+// * Download https://datasheets.raspberrypi.com/pico2w/RPi-PicoW-PUBLIC-20220607.zip[Design Files] (Cadence Allegro)
+// * Download https://datasheets.raspberrypi.com/pico2w/PicoW-step.zip[STEP File]
+
 == Pico 1 family
 
 image::images/pico-1s.png[width="75%"]
@@ -103,7 +140,7 @@ Raspberry Pi Pico W adds on-board single-band 2.4GHz wireless interfaces (802.11
 ** Support for Bluetooth LE Central and Peripheral roles
 ** Support for Bluetooth Classic
 
-The antenna is an onboard antenna licensed from ABRACON (formerly ProAnt). The wireless interface is connected via
+The antenna is an onboard antenna licensed from ABRACON (formerly ProAnt). The CYW43439 wireless chip is connected via
 SPI to the xref:silicon.adoc#rp2040[RP2040] microcontroller.
 
 Due to pin limitations, some of the wireless interface pins are shared. The CLK is shared with VSYS monitor, so only
@@ -115,11 +152,9 @@ For best wireless performance, the antenna should be in free space. For instance
 antenna can reduce its performance both in terms of gain and bandwidth. Adding grounded metal to the sides of the
 antenna can improve the antenna's bandwidth.
 
-NOTE: The CYW43439 wireless chip is connected via SPI to the RP2040.The CYW43439 supports both 802.11 wireless and Bluetooth over this interface.
-
-IMPORTANT: By default `libcyw43` is licensed for non-commercial use, but Pico W users, and anyone else who builds their product around RP2040 and CYW43439, benefit from a free https://github.com/georgerobotics/cyw43-driver/blob/195dfcc10bb6f379e3dea45147590db2203d3c7b/LICENSE.RP[commercial-use license]. 
+`libcyw43` is licensed for non-commercial use. However, Pico W users, and anyone else who builds their product around RP2040 and CYW43439, benefit from a free https://github.com/georgerobotics/cyw43-driver/blob/195dfcc10bb6f379e3dea45147590db2203d3c7b/LICENSE.RP[commercial-use license].
 
-IMPORTANT: In addition to the https://github.com/bluekitchen/btstack/blob/master/LICENSE[standard BTstack licensing] terms, a https://github.com/raspberrypi/pico-sdk/blob/master/src/rp2_common/pico_btstack/LICENSE.RP[supplemental licence] which covers commercial use of BTstack with Raspberry Pi Pico W or Raspberry Pi Pico WH is provided.
+In addition to the https://github.com/bluekitchen/btstack/blob/master/LICENSE[standard BTstack licensing] terms, a https://github.com/raspberrypi/pico-sdk/blob/master/src/rp2_common/pico_btstack/LICENSE.RP[supplemental licence] covers commercial use of BTstack with Raspberry Pi Pico W or Raspberry Pi Pico WH.
 
 ==== Pinout and design files