Skip to content

Commit 65f62ea

Browse files
committed
User Manual ready for review
1 parent a213642 commit 65f62ea

File tree

10 files changed

+73
-5
lines changed

10 files changed

+73
-5
lines changed

content/hardware/04.pro/shields/portenta-vision-shield/essentials.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,10 @@
11
<EssentialsColumn title="First Steps">
2-
<EssentialElement link="/tutorials/portenta-vision-shield/getting-started-camera" title="Quickstart Guide" type="getting-started">
3-
A quick guide to installing your shield with OpenMV IDE.
2+
<EssentialElement link="/tutorials/portenta-vision-shield/user-manual" title="User Manual" type="getting-started">
3+
A full guide to the basics of the Vision Shield.
44
</EssentialElement>
5-
5+
<EssentialElement link="/tutorials/portenta-vision-shield/getting-started-camera" title="Quickstart Guide" type="getting-started">
6+
A quick guide to testing your shield with Arduino IDE.
7+
</EssentialElement>
68
</EssentialsColumn>
79

810
<EssentialsColumn title="Suggested Libraries">

content/hardware/04.pro/shields/portenta-vision-shield/product.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Portenta Vision Shield
33
url_shop: https://store.arduino.cc/portenta-vision-shield
4-
url_guide: /tutorials/portenta-vision-shield/getting-started-camera
4+
url_guide: /tutorials/portenta-vision-shield/user-manual
55
core: arduino:mbed_portenta
66
certifications: [CE, REACH, RoHS, WEEE, UKCA, FCC, RCM]
77
---
360 KB
Loading
98.2 KB
Loading
282 KB
Loading
418 KB
Loading
272 KB
Loading
392 KB
Loading
216 KB
Loading

content/hardware/04.pro/shields/portenta-vision-shield/tutorials/user-manual/content.md

Lines changed: 67 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -683,7 +683,73 @@ Now, just say `yes` or `no` and you will see the inference result in the OpenMV
683683

684684
![Speech recognition example](assets/ml-inference.png)
685685

686-
## Machine Learning Tools
686+
## Machine Learning Tool
687+
688+
The main features of the Portenta Vision Shield are the audio and video capabilities. This makes it a perfect option for almost infinite machine-learning applications.
689+
690+
Creating this type of application has never been easier thanks to our Machine Learning Tool powered by Edge Impulse®, where we can easily create in a __No-Code__ environment, __Audio__, __Motion__, __Proximity__ and __Image__ processing models.
691+
692+
The first step to start creating awesome artificial intelligence and machine learning projects is to create an [Arduino Cloud](https://cloud.arduino.cc/home/) account.
693+
694+
There you will find a dedicated integration called __Machine Learning Tools__.
695+
696+
![Machine Learning Tools on Arduino Cloud](assets/ml-tools.png)
697+
698+
Once in, create a new project and give it a name.
699+
700+
![Creating a new project](assets/create-pro.png)
701+
702+
Enter your newly created project and the landing page will look like the following:
703+
704+
![Nicla Vision project page](assets/ei-landing.png)
705+
706+
### Edge Impulse® Environment Setup
707+
708+
Now, it is time to set up the __Edge Impulse®__ environment on your PC. For this, follow [these](https://docs.edgeimpulse.com/docs/tools/edge-impulse-cli/cli-installation) instructions to install the __Edge Impulse CLI__.
709+
710+
***For Windows users: make sure to install [Visual Studio Community](https://visualstudio.microsoft.com/downloads/) and [Visual Studio Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022).***
711+
712+
- Download and install the latest __Arduino CLI__ from [here](https://arduino.github.io/arduino-cli/0.35/installation/). ([Video Guide for Windows](https://www.youtube.com/watch?v=1jMWsFER-Bc))
713+
714+
- Download the [latest Edge Impulse® firmware](https://cdn.edgeimpulse.com/firmware/arduino-portenta-h7.zip) for the Portenta H7, and unzip the file.
715+
716+
- Open the flash script for your operating system (`flash_windows.bat`, `flash_mac.command` or `flash_linux.sh`) to flash the firmware.
717+
718+
- To test if the __Edge Impulse CLI__ was installed correctly, open the __Command Prompt__ or your favorite terminal and run:
719+
720+
`edge-impulse-daemon`
721+
722+
If everything goes okay, you should be asked for your Edge Impulse account credentials.
723+
724+
![Edge Impulse Daemon](assets/cmd.png)
725+
726+
- Enter your account username or e-mail address and your password.
727+
- Select the project you have created on the Arduino ML Tools, it will be listed.
728+
- Give your device a name and wait for it to connect to the platform.
729+
730+
![H7 + Vision Shield correctly connected to ML Tools](assets/cmd-connected.png)
731+
732+
### Uploading Sensor Data
733+
734+
The first thing to start developing a machine learning project is to create a _dataset_ for your model. This means, uploading _data_ to your model from the Vision Shield sensors.
735+
736+
To upload data from your Vision Shield on the Machine Learning Tools platform, navigate to __Data Acquisition__.
737+
738+
![Data Acquisition section](assets/ml-tools-upload.png)
739+
740+
In this section, you will be able to select the Vision Shield onboard sensors individually.
741+
742+
This is the supported sensors list:
743+
- Built-in microphone
744+
- Camera (320x240)
745+
- Camera (160x160)
746+
- Camera (128x96)
747+
748+
![Samples uploaded using the Vision Shield](assets/ml-tools-data.png)
749+
750+
Now you know how to start with our __Machine Learning Tools__ creating your dataset from scratch, you can get inspired by some of our ML projects listed below:
751+
752+
- [Image Classification with Edge Impulse®](https://docs.arduino.cc/tutorials/portenta-vision-shield/custom-machine-learning-model) (Article).
687753

688754
## Ethernet (ASX00021)
689755

0 commit comments

Comments
 (0)