Update readmes

Author: maxgerhardt

examples/arduino-ota/README.md

@@ -8,7 +8,7 @@ How to build PlatformIO based project
 
 ```shell
 # Change directory to example
-$ cd platform-raspberrypi/examples/arduino-blink
+$ cd platform-raspberrypi/examples/arduino-ota
 
 # Build project
 $ pio run
@@ -22,8 +22,12 @@ $ pio run --target clean
 
 ## Notes
 
-For Raspberry Pi Pico devices, two Arduino cores exist:
-* https://github.com/arduino/ArduinoCore-mbed
-* https://github.com/earlephilhower/arduino-pico
+This examples showcases the usage of Over-The-Air (OTA) updates with the Raspberry Pi Pico W.
 
-This examples showcases how to use both of these cores in the `platformio.ini`.
+For more details, see the [documentation](https://arduino-pico.readthedocs.io/en/latest/ota.html).
+
+For the initial firmware update, use the `rpipicow_via_usb` environment.
+
+Then, open the serial monitor and note down the IP of the Pico that it outputs.
+
+Use this IP as the `upload_port` in the `rpipicow_via_ota` environment and use the "Upload" project task there.

examples/arduino-signed-ota/README.md

@@ -8,7 +8,7 @@ How to build PlatformIO based project
 
 ```shell
 # Change directory to example
-$ cd platform-raspberrypi/examples/arduino-blink
+$ cd platform-raspberrypi/examples/arduino-signed-ota
 
 # Build project
 $ pio run
@@ -22,8 +22,16 @@ $ pio run --target clean
 
 ## Notes
 
-For Raspberry Pi Pico devices, two Arduino cores exist:
-* https://github.com/arduino/ArduinoCore-mbed
-* https://github.com/earlephilhower/arduino-pico
+This examples showcases the usage of **signed** Over-The-Air (OTA) updates with the Raspberry Pi Pico W.
 
-This examples showcases how to use both of these cores in the `platformio.ini`.
+The difference to regular OTA updates is that update binaries are signed using the `private.key` to produce a `firmware.bin.signed` file.
+
+The firmware then uses the `public.key` file to verify the signature on the binary it receives in an OTA update. It will reject OTA update binaries that were not properly signed.
+
+For more details, see the [documentation](https://arduino-pico.readthedocs.io/en/latest/ota.html).
+
+For the initial firmware update, use the `rpipicow_via_usb` environment.
+
+Then, open the serial monitor and note down the IP of the Pico that it outputs.
+
+Use this IP as the `upload_port` in the `rpipicow_via_ota` environment and use the "Upload" project task there.