diff --git a/.github/workflows/compile-examples.yml b/.github/workflows/compile-examples.yml index 1977579..c9f4b39 100644 --- a/.github/workflows/compile-examples.yml +++ b/.github/workflows/compile-examples.yml @@ -49,6 +49,15 @@ jobs: sketch-paths: | - examples/OTA_Qspi_Flash - examples/OTA_Usage_Portenta + - fqbn: arduino:mbed_opta:opta + platforms: | + - name: arduino:mbed_opta + libraries: | + - name: Arduino_DebugUtils + sketch-paths: | + - examples/OTA_Qspi_Flash + - examples/OTA_Qspi_Flash_Ethernet + - examples/OTA_Usage_Portenta steps: - name: Checkout diff --git a/examples/OTA_Qspi_Flash_Ethernet/OTA_Qspi_Flash_Ethernet.ino b/examples/OTA_Qspi_Flash_Ethernet/OTA_Qspi_Flash_Ethernet.ino new file mode 100644 index 0000000..b17fb29 --- /dev/null +++ b/examples/OTA_Qspi_Flash_Ethernet/OTA_Qspi_Flash_Ethernet.ino @@ -0,0 +1,113 @@ +/* + * This example demonstrates how to use to update the firmware of the Arduino Portenta H7 using + * a firmware image stored on the QSPI. + * + * Steps: + * 1) Create a sketch for the Portenta H7 and verify + * that it both compiles and works on a board. + * 2) In the IDE select: Sketch -> Export compiled Binary. + * 3) Create an OTA update file utilising the tools 'lzss.py' and 'bin2ota.py' stored in + * https://github.com/arduino-libraries/ArduinoIoTCloud/tree/master/extras/tools . + * A) ./lzss.py --encode SKETCH.bin SKETCH.lzss + * B) ./bin2ota.py PORTENTA_H7_M7 SKETCH.lzss SKETCH.ota + * 4) Upload the OTA file to a network reachable location, e.g. OTA_Usage_Portenta.ino.PORTENTA_H7_M7.ota + * has been uploaded to: http://downloads.arduino.cc/ota/OTA_Usage_Portenta.ino.PORTENTA_H7_M7.ota + * 5) Perform an OTA update via steps outlined below. + */ + +/****************************************************************************** + * INCLUDE + ******************************************************************************/ + +#include + +#include + +/****************************************************************************** + * CONSTANT + ******************************************************************************/ +#if defined(ARDUINO_OPTA) +static char const OTA_FILE_LOCATION[] = "http://downloads.arduino.cc/ota/OTA_Usage_Portenta.ino.OPTA.ota"; +#elif defined(ARDUINO_PORTENTA_H7_M7) +static char const OTA_FILE_LOCATION[] = "http://downloads.arduino.cc/ota/OTA_Usage_Portenta.ino.PORTENTA_H7_M7.ota"; +#else +#error "Board not supported" +#endif + +/****************************************************************************** + * SETUP/LOOP + ******************************************************************************/ + +void setup() +{ + Serial.begin(115200); + while (!Serial) {} + + while (Ethernet.linkStatus() == LinkOFF) + { + Serial.println("Attempting to connect to the network ..."); + Ethernet.begin(); + } + Serial.println("Connected"); + + Arduino_Portenta_OTA_QSPI ota(QSPI_FLASH_FATFS_MBR, 2); + Arduino_Portenta_OTA::Error ota_err = Arduino_Portenta_OTA::Error::None; + + if (!ota.isOtaCapable()) + { + Serial.println("Higher version bootloader required to perform OTA."); + Serial.println("Please update the bootloader."); + Serial.println("File -> Examples -> STM32H747_System -> STM32H747_manageBootloader"); + return; + } + + Serial.println("Initializing OTA storage"); + if ((ota_err = ota.begin()) != Arduino_Portenta_OTA::Error::None) + { + Serial.print ("Arduino_Portenta_OTA::begin() failed with error code "); + Serial.println((int)ota_err); + return; + } + + Serial.println("Starting download to QSPI ..."); + int const ota_download = ota.download(OTA_FILE_LOCATION, false /* is_https */); + if (ota_download <= 0) + { + Serial.print ("Arduino_Portenta_OTA_QSPI::download failed with error code "); + Serial.println(ota_download); + return; + } + Serial.print (ota_download); + Serial.println(" bytes stored."); + + + Serial.println("Decompressing LZSS compressed file ..."); + int const ota_decompress = ota.decompress(); + if (ota_decompress < 0) + { + Serial.print("Arduino_Portenta_OTA_QSPI::decompress() failed with error code"); + Serial.println(ota_decompress); + return; + } + Serial.print(ota_decompress); + Serial.println(" bytes decompressed."); + + + Serial.println("Storing parameters for firmware update in bootloader accessible non-volatile memory ..."); + if ((ota_err = ota.update()) != Arduino_Portenta_OTA::Error::None) + { + Serial.print ("ota.update() failed with error code "); + Serial.println((int)ota_err); + return; + } + + Serial.println("Performing a reset after which the bootloader will update the firmware."); + Serial.println("Hint: Board LED will blink Red-Blue-Green."); + delay(1000); /* Make sure the serial message gets out before the reset. */ + ota.reset(); +} + +void loop() +{ + +} diff --git a/library.properties b/library.properties index ee8aff2..39ba184 100644 --- a/library.properties +++ b/library.properties @@ -6,5 +6,5 @@ sentence=Firmware update for the Portenta H7. paragraph=This library allows performing a firmware update on the Arduino Portenta H7. The firmware can be stored in various different locations such as within the microcontroller's flash, on an external SD card or on the QSPI flash chip. category=Communication url=https://github.com/arduino-libraries/Arduino_Portenta_OTA -architectures=mbed,mbed_portenta,mbed_nicla +architectures=mbed,mbed_portenta,mbed_nicla,mbed_opta includes=Arduino_Portenta_OTA.h diff --git a/src/Arduino_Portenta_OTA_Config.h b/src/Arduino_Portenta_OTA_Config.h index 1d7b214..bdfab4b 100644 --- a/src/Arduino_Portenta_OTA_Config.h +++ b/src/Arduino_Portenta_OTA_Config.h @@ -35,4 +35,9 @@ #define ARDUINO_PORTENTA_OTA_QSPI_SUPPORT #endif +#if defined(ARDUINO_OPTA) + #define ARDUINO_PORTENTA_OTA_MAGIC 0x23410064 + #define ARDUINO_PORTENTA_OTA_QSPI_SUPPORT +#endif + #endif /* ARDUINO_PORTENTA_OTA_CONFIG_H_ */