Merge pull request raspberrypi#2566 from raspberrypi/picow

Pico W changes

Author: Alasdair Allan

documentation/asciidoc/microcontrollers/c_sdk/images/Blink-an-LED-640x360-v2.gif

@@ -10,6 +10,18 @@ You can find documentation around the C/{cpp} SDK at;
 
 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
 
+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
+
 https://datasheets.raspberrypi.com/pico/raspberry-pi-pico-c-sdk.pdf[Raspberry Pi Pico C/{cpp} SDK]:: Libraries and tools for C/{cpp} development on RP2040 microcontrollers
 
 The API level Doxygen documentation for the Raspberry Pi Pico C/{cpp} SDK is also available https://rptl.io/pico-doxygen[as a micro-site].
+
+[NOTE]
+====
+If you are building applications with the C/{cpp} SDK and targeting boards other than the Raspberry Pi Pico, you will need to pass `-DPICO_BOARD=boardname` to CMake. Here `boardname` is the name of your board, e.g. for the Adafruit Feather RP2040 you should pass `-DPICO_BOARD=adafruit_feather_rp2040`. See the https://github.com/raspberrypi/pico-sdk/tree/master/src/boards[`boards/` directory] in the Raspberry Pi Pico SDK, and the https://forums.raspberrypi.com/viewtopic.php?f=147&t=304393[forums], for more information.
+====
+
+[NOTE]
+====
+If you are building applications with the C/{cpp} SDK for Raspberry Pi Pico W and, to connect to a network you will need to pass `-DPICO_BOARD=pico_w -DWIFI_SSID="Your Network" -DWIFI_PASSWORD="Your Password"` to CMake. 
+====

documentation/asciidoc/microcontrollers/c_sdk/images/Hello-World-640x360-v2.gif

@@ -4,7 +4,7 @@
 
 The first program anyone writes when using a new microcontroller is to blink an LED on and off. The Raspberry Pi Pico comes with a single LED on-board (connected to GPIO pin 25). 
 
-image:images/Blink-an-LED-640x360.gif[]
+image:images/Blink-an-LED-640x360-v2.gif[]
 
 You can blink this on and off by,
 
@@ -15,14 +15,13 @@ You can blink this on and off by,
 
 You should see the on-board LED blinking.
 
-* Download https://datasheets.raspberrypi.com/soft/blink.uf2[UF2 File]
-* See the code https://github.com/raspberrypi/pico-examples/blob/master/blink/blink.c[on Github]
+You can see the code https://github.com/raspberrypi/pico-examples/blob/master/blink/blink.c[on Github]
 
 === Say "Hello World"
 
 The next program anyone writes is to say 'Hello World' over a USB serial connection.
 
-image:images/Hello-World-640x360.gif[]
+image:images/Hello-World-640x360-v2.gif[]
 
 . Download the https://datasheets.raspberrypi.com/soft/hello_world.uf2['Hello World' UF2].
 . Push and hold the BOOTSEL button and plug your Pico into the USB port of your Raspberry Pi or other computer.
@@ -36,7 +35,6 @@ sudo apt install minicom
 minicom -b 115200 -o -D /dev/ttyACM0
 ------
 
-You should see 'Hello, world!' printed to the Terminal
+You should see 'Hello, world!' printed to the Terminal.
 
-* Download https://datasheets.raspberrypi.com/soft/hello_world.uf2[UF2 File]
-* See the code https://github.com/raspberrypi/pico-examples/blob/master/hello_world/usb/hello_usb.c[on Github]
+You can see the code https://github.com/raspberrypi/pico-examples/blob/master/hello_world/usb/hello_usb.c[on Github]

documentation/asciidoc/microcontrollers/c_sdk/official_sdk.adoc

@@ -18,15 +18,16 @@ https://datasheets.raspberrypi.com/pico/getting-started-with-pico.pdf[Getting st
 
 NOTE: While it is not officially supported there is a https://github.com/ndabas/pico-setup-windows[Pico Setup for Windows] installation tool which automates installation of the C/{cpp} SDK on Windows 10.
 
+=== 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
+
 === Software Development
 
 https://datasheets.raspberrypi.com/pico/raspberry-pi-pico-c-sdk.pdf[Raspberry Pi Pico C/{cpp} SDK]:: Libraries and tools for C/{cpp} development on RP2040 microcontrollers
 
 https://datasheets.raspberrypi.com/pico/raspberry-pi-pico-python-sdk.pdf[Raspberry Pi Pico Python SDK]:: A MicroPython environment for RP2040 microcontrollers
 
 The API level Doxygen documentation for the Raspberry Pi Pico C/{cpp} SDK is also available https://rptl.io/pico-doxygen[as a micro-site].
-
-[NOTE]
-====
-If you are building applications with the C/{cpp} SDK and targeting boards other than the Raspberry Pi Pico, you will need to pass `-DPICO_BOARD=boardname` to CMake. Here `boardname` is the name of your board, e.g. for the Adafruit Feather RP2040 you should pass `-DPICO_BOARD=adafruit_feather_rp2040`. See the https://github.com/raspberrypi/pico-sdk/tree/master/src/boards[`boards/` directory] in the Raspberry Pi Pico SDK, and the https://forums.raspberrypi.com/viewtopic.php?f=147&t=304393[forums], for more information.
-====

documentation/asciidoc/microcontrollers/c_sdk/your_first_binary.adoc

@@ -1,15 +1,23 @@
 == Drag-and-Drop MicroPython
 
-You can program your Pico by connecting it to a computer via USB, then dragging and dropping a file onto it, so we’ve put together a  https://micropython.org/download/rp2-pico/rp2-pico-latest.uf2[downloadable UF2] file to let you install MicroPython more easily.
+You can program your Pico by connecting it to a computer via USB, then dragging and dropping a file onto it so we’ve put together a downloadable UF2 file to let you install MicroPython more easily.
 
-image::images/MicroPython-640x360.gif[]
+image::images/MicroPython-640x360-v2.gif[]
 
-. Download the  https://micropython.org/download/rp2-pico/rp2-pico-latest.uf2[MicroPython UF2] file.
+Download the correct MicroPython UF2 file for your board:
+
+* https://micropython.org/download/rp2-pico/rp2-pico-latest.uf2[Raspberry Pi Pico] 
+
+* https://datasheets.raspberrypi.com/soft/micropython-firmware-pico-w-290622.uf2[Raspberry Pi Pico W] (with https://makeblock-micropython-api.readthedocs.io/en/latest/public_library/Third-party-libraries/urequests.html[urequests] and https://docs.micropython.org/en/latest/reference/packages.html[upip] preinstalled)
+
+Then go ahead and:
 
 . Push and hold the BOOTSEL button and plug your Pico into the USB port of your Raspberry Pi or other computer. Release the BOOTSEL button after your Pico is connected.
 
 . It will mount as a Mass Storage Device called RPI-RP2.
 
 . Drag and drop the MicroPython UF2 file onto the RPI-RP2 volume. Your Pico will reboot. You are now running MicroPython.
 
-. You can access the REPL via USB Serial. Our MicroPython documentation contains step-by-step instructions for connecting to your Pico and programming it in MicroPython.
+. You can access the REPL via USB Serial. 
+
+The https://datasheets.raspberrypi.com/pico/raspberry-pi-pico-python-sdk.pdf[Raspberry Pi Pico Python SDK] book contains step-by-step instructions for connecting to your Pico and programming it in MicroPython using both the command line and the https://thonny.org/[Thonny] IDE.

documentation/asciidoc/microcontrollers/microcontroller_docs.adoc

@@ -10,6 +10,7 @@ MicroPython is a full implementation of the Python 3 programming language that r
 You can find information on the MicroPython port to RP2040 at;
 
 https://datasheets.raspberrypi.com/pico/raspberry-pi-pico-python-sdk.pdf[Raspberry Pi Pico Python SDK]:: A MicroPython environment for RP2040 microcontrollers
+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
 https://docs.micropython.org/en/latest/rp2/quickref.html[RP2 Quick Reference]:: The official documentation around the RP2040 port of MicroPython
 https://docs.micropython.org/en/latest/library/rp2.html[RP2 Library]:: The official documentation about the `rp2` module in MicroPython
 

documentation/asciidoc/microcontrollers/micropython/drag-and-drop.adoc

@@ -1,11 +1,17 @@
-== Technical Specification
+== The Family
+
+image::images/three_picos.jpg[width="75%"]
+
+The Raspberry Pi Pico family consists of Raspberry Pi Pico (left), Pico H (middle), and Pico W (right).
+
+[[technical-specification]]
+== Raspberry Pi Pico and Pico H
 
 Raspberry Pi Pico is a low-cost, high-performance microcontroller board with flexible digital interfaces. Key features include:
 
 * xref:rp2040.adoc#welcome-to-rp2040[RP2040] microcontroller chip designed by Raspberry Pi in the United Kingdom
 * Dual-core Arm Cortex M0+ processor, flexible clock running up to 133 MHz
 * 264kB of SRAM, and 2MB of on-board Flash memory
-* Castellated module allows soldering direct to carrier boards
 * USB 1.1 with device and host support
 * Low-power sleep and dormant modes
 * Drag-and-drop programming using mass storage over USB
@@ -16,16 +22,46 @@ Raspberry Pi Pico is a low-cost, high-performance microcontroller board with fle
 * Accelerated floating-point libraries on-chip
 * 8 × Programmable I/O (PIO) state machines for custom peripheral support
 
-=== Pinout and Design Files
+The Raspberry Pi Pico comes as a castellated module allows soldering direct to carrier boards, while the Pico H comes with pre-soldered headers.
 
-image::images/Pico-R3-SDK11-Pinout.svg[]
+NOTE: Both boards have a three pin Serial Wire Debug (SWD) header. However, the Pico H has this broken out into a small, keyed, https://datasheets.raspberrypi.com/debug/debug-pin-connector-specification.pdf[3-pin connector] while the Pico has three castellated through-hole pins adjacent to the edge of the board.
 
-* Download the https://datasheets.raspberrypi.com/pico/Pico-R3-A4-Pinout.pdf[Pinout Diagram] (PDF)
+=== Pinout and Design Files
 
-=== Design Files
+image::images/pico-pinout.svg[]
 
+* Download the https://datasheets.raspberrypi.com/pico/Pico-R3-A4-Pinout.pdf[Pinout Diagram] (PDF)
 * Download https://datasheets.raspberrypi.com/pico/RPi-Pico-R3-PUBLIC-20200119.zip[Design Files] (Cadence Allegro)
 * Download https://datasheets.raspberrypi.com/pico/Pico-R3-step.zip[STEP File]
 * Download https://datasheets.raspberrypi.com/pico/Pico-R3-Fritzing.fzpz[Fritzing Part]
 
 NOTE: More information on Fritzing is available on the https://fritzing.org/[fritzing.org] web site.
+
+== Raspberry Pi Pico W
+
+Raspberry Pi Pico W adds on-board single-band 2.4GHz wireless interfaces (802.11n) using the Infineon CYW4343 while retaining the Pico form factor. 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 4 clients
+
+The antenna is an onboard antenna licensed from ABRACON (formerly ProAnt). The wireless interface is connected via
+SPI to the xref:rp2040.adoc#welcome-to-rp2040[RP2040] 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 RP2040. 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, the antenna should be in free space. For instance, putting metal under or close by the
+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.
+
+=== Pinout and Design Files
+
+image::images/picow-pinout.svg[]
+
+* Download the https://datasheets.raspberrypi.com/picow/PicoW-A4-Pinout.pdf[Pinout Diagram] (PDF)
+* Download https://datasheets.raspberrypi.com/picow/RPi-PicoW-PUBLIC-20220607.zip[Design Files] (Cadence Allegro)
+* Download https://datasheets.raspberrypi.com/picow/PicoW-step.zip[STEP File]
+* Download https://datasheets.raspberrypi.com/picow/PicoW-Fritzing.fzpz[Fritzing Part]