You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/hardware/04.pro/boards/portenta-x8/tutorials/01.user-manual/content.md
+39-39Lines changed: 39 additions & 39 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -136,7 +136,7 @@ It is recommended that you check every now and then to see if your Portenta X8 i
136
136
There are four ways to update your Portenta X8 are described:
137
137
138
138
*[Update for OS release V.399](https://docs.arduino.cc/tutorials/portenta-x8/image-flashing/#update-for-os-release-v399)
139
-
*[Update through Out-of-the-box experience](https://docs.arduino.cc/tutorials/portenta-x8/image-flashing/#update-through-out-of-the-box-experience)
139
+
*[Update through Arduino Linux Wizard experience](https://docs.arduino.cc/tutorials/portenta-x8/image-flashing/#update-through-arduino-linux-wizard-experience)
140
140
*[Update through Portenta X8 Manager in your Arduino Cloud for Business account (available for all OS releases)](https://docs.arduino.cc/tutorials/portenta-x8/image-flashing/#update-with-portenta-x8-board-manager)
141
141
*[Update using the `uuu` tool (compatible with custom images)](https://docs.arduino.cc/tutorials/portenta-x8/image-flashing/#update-using-uuu-tool)
142
142
@@ -190,53 +190,53 @@ Now click on **START CONFIGURATION**. The tool will install all the required add
190
190
191
191
You can now proceed to the setup of the board connectivity by clicking **OK, GOT IT**.

194
194
195
195
***If you face any issue with this flow or prefer to interact directly with your Portenta X8 through the command line, please refer to [this section](#working-with-linux) to learn how to connect with the board leveraging ADB service.***
196
196
197
-
Once the setup is ready, let's open the Out-of-the-box page. Use the command line window and launch the TCP port forwarding setup command:
197
+
Once the setup is ready, let's open the Arduino Linux Wizard page. Use the command line window and launch the TCP port forwarding setup command:
198
198
199
199
```bash
200
200
adb forward tcp:8080 tcp:80
201
201
```
202
202
203
-
Now open your browser, go to [http://localhost:8080](http://localhost:8080), and the Out-of-the-box dashboard will appear.
203
+
Now open your browser, go to [http://localhost:8080](http://localhost:8080), and the Arduino Linux Wizard dashboard will appear.
204
204
205
-

205
+

206
206
207
-
On the Out-of-the-box page, the **SYSTEM INFO** button is located at the bottom left.
207
+
On the Arduino Linux Wizard page, the **SYSTEM INFO** button is located at the bottom left.
208
208
209
-

209
+

210
210
211
211
It will show you different types of information about the Portenta X8, including hardware/software information, network status, and active containers.
212
212
213
213
#### Wi-Fi® Configuration
214
214
215
215
Click **Wi-Fi® Connection** to start configuring your network connectivity. Otherwise, you can connect your Portenta X8 to the Internet through an Ethernet cable using a USB-C® hub with an RJ45 port or a Portenta Carrier. In this tutorial, Wi-Fi® connectivity will be used.

258
258
259
259
This shell is running in a Python-Alpine container embedded in Portenta X8. You will find multiple examples under the directory `/root/examples` in this shell. Additionally, you can either add your own package through the command `apk add <packagename>` or start exploring the packages available online at [this link](https://pkgs.alpinelinux.org/packages).

262
262
263
263
## Portenta X8 with Arduino Cloud
264
264
@@ -268,23 +268,23 @@ Making Portenta X8 compatible with Arduino Cloud means opening many new applicat
268
268
269
269
***Check all the available Arduino Cloud plans [here](https://cloud.arduino.cc/plans#business) and create your Arduino Cloud account in a couple of steps (see the dedicated documentation at [this link](https://docs.arduino.cc/arduino-cloud/)).***
270
270
271
-
With the Out-of-the-box experience, your Portenta X8 can be securely self-provisioned in Arduino Cloud; you need to create API keys, and the Python container running on X8 will do the rest. When provisioned, you can start directly interacting with an example Thing and Dashboard that will be automatically generated to guide you in this new journey.
271
+
With the Arduino Linux Wizard experience, your Portenta X8 can be securely self-provisioned in Arduino Cloud; you need to create API keys, and the Python container running on X8 will do the rest. When provisioned, you can start directly interacting with an example Thing and Dashboard that will be automatically generated to guide you in this new journey.
272
272
273
273
Click the **Arduino Cloud** button to start provisioning your Portenta X8 in Arduino Cloud.

276
276
277
277
Start setting up the device name for your Portenta X8 (in this case, *portenta-x8-test*) and click on **CONTINUE**. The same device name will be used and visualized in your Arduino Cloud space, but you can freely change it in the future.

280
280
281
281
At this point, you will be asked to insert your API Key credentials and Organization ID. Organization ID is optional and should be filled in only if you use a Shared Space in Arduino Cloud for Business.
282
282
283
-

283
+

284
284
285
285
To get API keys, log into your Arduino Cloud account and select the Space you would like your X8 to be provisioned into.
286
286
287
-
Thus, click on **GENERATE API KEY** in your Out-of-the-box dashboard. A new window in your web browser will allow you to log in to your Arduino Cloud space.
287
+
Thus, click on **GENERATE API KEY** in your Arduino Linux Wizard dashboard. A new window in your web browser will allow you to log in to your Arduino Cloud space.
288
288
289
289
***If you want to learn more about what API keys are and how they work, please take a look at the dedicated documentation available at [this link](https://docs.arduino.cc/arduino-cloud/getting-started/arduino-iot-api).***
290
290
@@ -314,35 +314,35 @@ Keep this file safely stored; otherwise, your API credentials cannot be recovere
314
314
315
315

316
316
317
-
The PDF file will look like the image below and include the credentials you need to copy and paste into the Out-of-the-box page.
317
+
The PDF file will look like the image below and include the credentials you need to copy and paste into the Arduino Linux Wizard page.
318
318
319
319

320
320
321
-
Thus, copy the **Client ID** and the **Client Secret** credentials and paste them into your Out-of-the-box dashboard as shown below.
321
+
Thus, copy the **Client ID** and the **Client Secret** credentials and paste them into your Arduino Linux Wizard dashboard as shown below.
322
322
323
-

323
+

324
324
325
325
If you are using an Arduino Cloud for Business account with Shared Spaces. In that case, you also need to add the Organization ID you would like your Portenta X8 to be provisioned into by clicking on **ADD ORGANIZATION**.

328
328
329
329
To recover the Organization ID, known as Space ID, of your Shared Space on Arduino Cloud for Business, open your Arduino Cloud homepage and navigate to **Space Settings > General** in the sidebar on the left.
330
330
331
331

332
332
333
-
At this point, you can copy the **Space ID** of your Shared Space and paste it into your Out-of-the-box dashboard together with your API keys.
333
+
At this point, you can copy the **Space ID** of your Shared Space and paste it into your Arduino Linux Wizard dashboard together with your API keys.
334
334
335
335

336
336
337
337
Click on **SETUP DEVICE**, and you are ready to go, your Portenta X8 is now provisioned into your Arduino Cloud space.

340
340
341
-
Once provisioned, the Portenta X8 will be automatically linked to an example [Thing](https://create.arduino.cc/iot/things) and [Dashboard](https://create.arduino.cc/iot/dashboards). You can freely check them by clicking on the corresponding links embedded in the Out-of-the-box.
341
+
Once provisioned, the Portenta X8 will be automatically linked to an example [Thing](https://create.arduino.cc/iot/things) and [Dashboard](https://create.arduino.cc/iot/dashboards). You can freely check them by clicking on the corresponding links embedded in the Arduino Linux Wizard.
342
342
343
343

344
344
345
-
As mentioned, Arduino provides an example dashboard that will automatically set up and be visible live after your Portenta X8 has been provisioned. To make this dashboard update its data automatically, you need to go back to your Out-of-the-box and launch the example.
345
+
As mentioned, Arduino provides an example dashboard that will automatically set up and be visible live after your Portenta X8 has been provisioned. To make this dashboard update its data automatically, you need to go back to your Arduino Linux Wizard and launch the example.
346
346
347
347
To do so, copying the shown code:
348
348
@@ -390,23 +390,23 @@ Your FoundriesFactory is correctly set up. As you can see, the Factory does not
390
390
391
391

392
392
393
-
To provision your Portenta X8, go back to your Out-of-the-box webpage and click on the **Portenta X8 Manager** button.
393
+
To provision your Portenta X8, go back to your Arduino Linux Wizard webpage and click on the **Portenta X8 Manager** button.

396
396
397
397
Enter the Factory name you have just registered, in this case, *user-test*, and assign a Board Name to your Portenta X8. This Board Name will be used to correctly identify your Portenta X8 in your FoundriesFactory. You can now click on **REGISTER**.
398
398
399
-

399
+

400
400
401
-
To complete the registration of the Board with the FoundriesFactory, copy the code that appeared in your Out-of-the-box.
401
+
To complete the registration of the Board with the FoundriesFactory, copy the code that appeared in your Arduino Linux Wizard.

404
404
405
405
Click on **COMPLETE REGISTRATION** to be re-directed to the *Foundries.io* activation page.
406
406
407
407
Paste your token in the text box and press **Next**.
408
408
409
-
***The token code is valid for __15 minutes__. If you do not use it in this time span, you will have to repeat all the above registration steps in your Out-of-the-box to generate a new code.***
409
+
***The token code is valid for __15 minutes__. If you do not use it in this time span, you will have to repeat all the above registration steps in your Arduino Linux Wizard to generate a new code.***

434
434
435
435
***If you want to learn more about Portenta X8 Manager features, check the dedicated section of this user manual called [Working with Portenta X8 Board Manager](#working-with-portenta-x8-board-manager).***
436
436
@@ -456,7 +456,7 @@ With this command, ADB allows you to forward the requests of your computer's `80
456
456
457
457
Now you can open your browser, go to [http://localhost:8080](http://localhost:8080) and the same Arduino Linux Wizard dashboard will appear to allow you to configure your Portenta X8.

460
460
461
461
Now, you can type `adb shell` to start communicating with your Portenta X8.
462
462
@@ -631,7 +631,7 @@ To customize the Portenta X8, you can develop and deploy Docker containers. Star
631
631
632
632
Once ready, you can customize Portenta X8, for example, Thing and Dashboard. This can be done by writing your own Python script leveraging the [Arduino IoT Cloud Python library](https://github.com/arduino/arduino-iot-cloud-py). Check the documentation and the examples inside the library to learn more about creating your own Python application.
633
633
634
-
When your Python script is ready, you have to create a dedicated Dockerfile to integrate your new script. The Dockerfile needs the Out-of-the-box Python container (i.e., `arduino-ootb-python-devel`) to interact with your Arduino Cloud account correctly.
634
+
When your Python script is ready, you have to create a dedicated Dockerfile to integrate your new script. The Dockerfile needs the Arduino Linux Wizard Python container (i.e., `arduino-ootb-python-devel`) to interact with your Arduino Cloud account correctly.
635
635
636
636
So, open a terminal window and create a Dockerfile integrating the following code with your Python script:
0 commit comments