Add Pico W examples

Author: kilograham

CMakeLists.txt

@@ -41,6 +41,7 @@ add_subdirectory(i2c)
 add_subdirectory(interp)
 add_subdirectory(multicore)
 add_subdirectory(picoboard)
+add_subdirectory(pico_w)
 add_subdirectory(pio)
 add_subdirectory(pwm)
 add_subdirectory(reset)

README.md

@@ -108,6 +108,32 @@ App|Description
 [blinky](picoboard/blinky)| Blink "hello, world" in Morse code on Pico's LED
 [button](picoboard/button)| Use Pico's BOOTSEL button as a regular button input, by temporarily suspending flash access.
 
+### Pico W Networking
+
+These eaxmples are for the Pico W, and are only available for `PICO_BOARD=pico_w`
+
+App|Description
+---|---
+[picow_access_point](pico_w/picow_access_point)| Starts a WiFi access point, and fields DHCP requests.
+[picow_blink](pico_w/picow_blink)| Blinks the on-board LED (which is connected via the WiFi chip).
+[picow_iperf_server](pico_w/picow_iperf)| Runs an "iperf" server for WiFi speed testing.
+[picow_ntp_client](pico_w/picow_ntp_client)| Connects to an NTP server to fetch and display the current time.
+[picow_tcp_client](pico_w/picow_tcp_client)| A simple TCP client. You can run [python_test_tcp_server.py](pico_w/python_test_tcp/python_test_tcp_server.py) for it to connect to.
+[picow_tcp_server](pico_w/picow_tcp_server)| A simple TCP server. You can use [python_test_tcp_client.py](pico_w/python_test_tcp/python_test_tcp_client.py) to connect to it.
+[picow_wifi_scan](pico_w/picow_wifi_scan)| Scans for WiFi networks and prints the results.
+
+#### FreeRTOS examples
+
+These are examples of integrating Pico W networking under FreeRTOS, and require you to set the `FREERTOS_KERNEL_PATH`
+to point to the FreeRTOS Kernel.
+
+App|Description
+---|---
+[picow_freertos_iperf_server_nosys](pico_w/freertos/picow_iperf)| Runs an "iperf" server for WiFi speed testing under FreeRTOS in NO_SYS=1 mode. The LED is blinked in another task
+[picow_freertos_iperf_server_sys](pico_w/freertos/picow_iperf)| Runs an "iperf" server for WiFi speed testing under FreeRTOS in NO_SYS=0 (i.e. full FreeRTOS integration) mode. The LED is blinked in another task
+[picow_freertos_ping_nosys](pico_w/freertos/ping)| Runs the lwip-contrib/apps/ping test app under FreeRTOS in NO_SYS=1 mode.
+[picow_freertos_iperf_server_sys](pico_w/freertos/picow_iperf)| Runs the lwip-contrib/apps/ping test app under FreeRTOS in NO_SYS=0 (i.e. full FreeRTOS integration) mode. The test app uses the lwIP \em socket API in this case. 
+
 ### PIO
 
 App|Description

pico_w/CMakeLists.txt

@@ -0,0 +1,26 @@
+cmake_minimum_required(VERSION 3.12)
+
+if (PICO_CYW43_SUPPORTED) # set by BOARD=pico-w
+    if (NOT TARGET pico_cyw43_arch)
+        message("Skipping Pico W examples as support is not available")
+    else()
+        set(WIFI_SSID "${WIFI_SSID}" CACHE INTERNAL "WiFi SSID for examples")
+        set(WIFI_PASSWORD "${WIFI_PASSWORD}" CACHE INTERNAL "WiFi password for examples")
+
+        add_subdirectory(blink)
+        add_subdirectory(wifi_scan)
+        add_subdirectory(access_point)
+
+        if ("${WIFI_SSID}" STREQUAL "")
+            message("Skipping some Pico W examples as WIFI_SSID is not defined")
+        elseif ("${WIFI_PASSWORD}" STREQUAL "")
+            message("Skipping some Pico W examples as WIFI_PASSWORD is not defined")
+        else()
+            add_subdirectory(iperf)
+            add_subdirectory(ntp_client)
+            add_subdirectory(tcp_client)
+            add_subdirectory(tcp_server)
+            add_subdirectory(freertos)
+        endif()
+    endif()
+endif()

pico_w/access_point/CMakeLists.txt

@@ -0,0 +1,33 @@
+add_executable(picow_access_point_background
+        picow_access_point.c
+        dhcpserver/dhcpserver.c
+        )
+
+target_include_directories(picow_access_point_background PRIVATE
+        ${CMAKE_CURRENT_LIST_DIR}
+        ${CMAKE_CURRENT_LIST_DIR}/.. # for our common lwipopts
+        ${CMAKE_CURRENT_LIST_DIR}/dhcpserver
+        )
+
+target_link_libraries(picow_access_point_background
+        pico_cyw43_arch_lwip_threadsafe_background
+        pico_stdlib
+        )
+
+pico_add_extra_outputs(picow_access_point_background)
+
+add_executable(picow_access_point_poll
+        picow_access_point.c
+        dhcpserver/dhcpserver.c
+        )
+target_include_directories(picow_access_point_poll PRIVATE
+        ${CMAKE_CURRENT_LIST_DIR}
+        ${CMAKE_CURRENT_LIST_DIR}/.. # for our common lwipopts
+        ${CMAKE_CURRENT_LIST_DIR}/dhcpserver
+        )
+target_link_libraries(picow_access_point_poll
+        pico_cyw43_arch_lwip_poll
+        pico_stdlib
+        )
+pico_add_extra_outputs(picow_access_point_poll)
+

pico_w/access_point/dhcpserver/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2013-2022 Damien P. George
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.