Skip to content

Commit 4f3bb8d

Browse files
committed
Tutorial documentation update post testings
1 parent f679bde commit 4f3bb8d

File tree

1 file changed

+14
-2
lines changed
  • content/hardware/04.pro/boards/portenta-h7/tutorials/over-the-air-update

1 file changed

+14
-2
lines changed

content/hardware/04.pro/boards/portenta-h7/tutorials/over-the-air-update/content.md

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,9 @@ libraries:
1616
hardware:
1717
- hardware/04.pro/boards/portenta-h7
1818
- hardware/04.pro/boards/portenta-h7-lite-connected
19+
- hardware/06.nicla/boards/nicla-vision
20+
- hardware/07.opta/opta-family/opta
21+
- hardware/10.mega/boards/giga-r1-wifi
1922
software:
2023
- ide-v1
2124
- ide-v2
@@ -24,6 +27,7 @@ software:
2427
---
2528

2629
## Overview
30+
2731
In this tutorial, you will learn how to use and allow firmware updates via **OTA (Over-The-Air)** with the **Arduino Portenta H7**. With this tutorial, you will be able to create a binary file to be used with the OTA feature and use the internal **QSPI** or an external **SD card** to accomplish the OTA (Over-The-Air) process.
2832

2933
***To proceed with OTA using an SD Card, you will need to use a carrier or shield with an SD card slot, e.g., Portenta Breakout, Portenta Max Carrier, or Portenta Vision Shield.***
@@ -276,6 +280,8 @@ The complete script is as follows.
276280

277281
### QSPI Storage Mode
278282

283+
You can open this sketch from the Arduino IDE by going to **File > Examples > Arduino_Portenta_OTA > OTA_Qspi_Flash**.
284+
279285
```cpp
280286
/*
281287
* This example demonstrates how to update the firmware of the Arduino Portenta H7 using
@@ -418,6 +424,8 @@ void loop()
418424

419425
### SD Card Storage Mode
420426

427+
You can open this sketch from the Arduino IDE by going to **File > Examples > Arduino_Portenta_OTA > OTA_SD_Portenta**.
428+
421429
```cpp
422430
/*
423431
* This example demonstrates how to update the firmware of the Arduino Portenta H7 using
@@ -560,7 +568,7 @@ The standard OTA examples use a two-step process:
560568

561569
However, the `Arduino_Portenta_OTA` library also supports **on-the-fly decompression**, where the file is decompressed as it's being downloaded, which can be more efficient for certain use cases.
562570

563-
The following example shows both methods and allows you to compare their performance:
571+
You can open this sketch from the Arduino IDE by going to **File > Examples > Arduino_Portenta_OTA > LZSS**. The following example shows both methods and allows you to compare their performance:
564572

565573
```cpp
566574
/*
@@ -749,9 +757,13 @@ void decompress_on_the_fly_cbk(const char* buffer, uint32_t size) {
749757
void putc_file(const uint8_t c) {
750758
fwrite(&c, 1, 1, download_target);
751759
}
760+
```
752761
762+
## Conclusion
753763
754-
```
764+
In this tutorial, you learned how to set up and perform Over-The-Air (OTA) firmware updates on the Arduino Portenta H7 and compatible boards. You explored how to create OTA files from compiled binaries, configure both QSPI and SD card storage options, and successfully deploy wireless firmware updates. Additionally, you gained insight into LZSS compression methods and their performance characteristics for different use cases.
765+
766+
Thanks to the `Arduino_Portenta_OTA` library and its flexibility, you can remotely update your devices without physical access, choose between storage methods based on your hardware configuration, and select the decompression approach that best fits your performance requirements. It makes OTA updates a good capability for maintaining deployed IoT systems, prototyping advanced applications, and building production-ready solutions that can be updated over the network.
755767
756768
## Troubleshooting
757769

0 commit comments

Comments
 (0)