Skip to content

Commit c07cf5b

Browse files
Merge pull request #841 from arduino/jorgetrujilloroman/portentah7/ota-tutorial-addition
[PC-1116] Adding some information to the Portenta H7 over-the-air tutorial
2 parents fa5c892 + 8e0603d commit c07cf5b

File tree

1 file changed

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

1 file changed

+44
-0
lines changed

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

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -138,6 +138,50 @@ Convert your encoded file into `.ota` format
138138

139139
You can use `OTA_Usage_Portenta.ino.PORTENTA_H7_M7` as a sketch name for facilitated identification of the file. After this, you will have the `.ota` file of the sketch that you will use with the OTA process.
140140

141+
### Installing Python 3 On Linux
142+
143+
If you are using Linux, maybe you cannot run the **bin2ota.py** script. This may be because you need to install [Python 3](https://www.python.org/) and the necessary modules. To do it execute the next command on your **Linux terminal**:
144+
145+
```cpp
146+
sudo apt install python-is-python3
147+
``````
148+
149+
You will also need to install the **crccheck** module on python by following the next instructions:
150+
151+
Installing pip on python:
152+
```cpp
153+
//Necessary to install python modules:
154+
sudo apt install python3-pip
155+
```
156+
Installing the crccheck necessary module on python:
157+
158+
```cpp
159+
//Necessary to run the script:
160+
pip install crccheck
161+
```
162+
Once you have done it, you should be able to run the bin2ota.py script successfully.
163+
164+
### Uploading OTA file to the net ###
165+
166+
Now you can upload your .OTA file to an online reachable location, e.g. *OTA_Usage_Portenta.ino.PORTENTA_H7_M7.ota* has been uploaded to:
167+
168+
http://downloads.arduino.cc/ota/OTA_Usage_Portenta.ino.PORTENTA_H7_M7.ota
169+
170+
You can change the default file location on the code by modifying the next line on the ***"OTA_Qspi_Flash"** sketch or in the **"OTA_SD_Portenta"** sketch depending on which method are you going to follow:
171+
172+
```cpp
173+
static char const OTA_FILE_LOCATION[] = "Introduce here your online OTA file location";
174+
```
175+
It is important to know that if your OTA file is uploaded to an HTTPS website you will need to modify the next line in the code:
176+
177+
```cpp
178+
int const ota_download = ota.download(OTA_FILE_LOCATION, true /* is_https */);
179+
```
180+
This line is in **line 87** for the **"OTA_Qspi_Flash"** sketch or in **line 88** on the **"OTA_SD_Portenta"** sketch.
181+
182+
If you are going to use the example OTA file used in this tutorial you don't need to follow the steps in this section, just execute the sketch with the default file location.
183+
184+
141185
***Now you have two options to choose, use QSPI or use an SD Card to storage your OTA file. You can use the left side index to jump to the option that you may need.***
142186

143187
### QSPI Storage Mode

0 commit comments

Comments
 (0)