Skip to content

Commit a213642

Browse files
committed
LoRa section finished
1 parent 7611076 commit a213642

File tree

2 files changed

+43
-9
lines changed
  • content/hardware/04.pro/shields/portenta-vision-shield/tutorials/user-manual

2 files changed

+43
-9
lines changed
488 KB
Loading

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

Lines changed: 43 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -541,7 +541,7 @@ When a person is in the field of view of the camera, you should see the inferenc
541541

542542
![Person detection example running](assets/person-detect.gif)
543543

544-
### Microphone
544+
## Microphone
545545

546546
The Portenta Vision Shield features two omnidirectional microphones, based on the MP34DT05 ultra-compact, low-power, and digital MEMS microphone.
547547

@@ -553,7 +553,7 @@ The Portenta Vision Shield features two omnidirectional microphones, based on th
553553
- Omnidirectional sensitivity
554554
- –26 dBFS ± 1 dB sensitivity
555555

556-
#### FFT Example
556+
### FFT Example
557557

558558
You can analyze frequencies present in sounds alongside their harmonic features using this example.
559559

@@ -636,7 +636,7 @@ With this script running you will be able to see the Fast Fourier Transform resu
636636

637637
![FFT example running](assets/fft.gif)
638638

639-
#### Speech Recognition Example
639+
### Speech Recognition Example
640640

641641
You can easily implement sound/voice recognition applications using Machine Learning on the edge, this means that the Portenta H7 plus the Vision Shield can run these algorithms locally.
642642

@@ -683,7 +683,9 @@ 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-
### Ethernet (ASX00021)
686+
## Machine Learning Tools
687+
688+
## Ethernet (ASX00021)
687689

688690
The **Portenta Vision Shield - Ethernet** gives you the possibility of connecting your Portenta H7 board to the internet using a wired connection.
689691

@@ -746,15 +748,17 @@ Run the script and the current date and time will be printed in the OpenMV IDE S
746748

747749
![Ethernet connection example script](assets/ntp.png)
748750

749-
### LoRa® (ASX00026)
751+
## LoRa® (ASX00026)
750752

751753
The **Vision Shield - LoRa®** can extend our project connectivity by leveraging it LoRa® module for long-range communication in remote areas with a lack of internet access. Powered by the Murata CMWX1ZZABZ module which contains an STM32L0 processor along with a Semtech SX1276 Radio.
752754

753755
![LoRa® antenna connection](assets/antenna.png)
754756

755-
First, connect the Vision Shield - LoRa® to the Portenta H7. Attach the LoRa® antenna to its respective connector. Now connect the USB-C® cable to the Portenta H7 and your computer.
757+
To test the LoRa® connectivity, first, connect the Vision Shield - LoRa® to the Portenta H7. Attach the LoRa® antenna to its respective connector. Now connect the USB-C® cable to the Portenta H7 and your computer.
758+
759+
***Follow this [guide](https://docs.arduino.cc/tutorials/portenta-vision-shield/things-network-openmv) to learn how to set up and create your __end device__ on The Things Network.***
756760

757-
Now you are ready to test the connectivity with the following Python script. This example lets you connect to The Things Network using LoRaWAN® and send a `Hello World` message to it.
761+
The following Python script lets you connect to The Things Network using LoRaWAN® and send a `Hello World` message to it.
758762

759763
```python
760764
from lora import *
@@ -804,14 +808,44 @@ while True:
804808
sleep_ms(1000)
805809
```
806810

807-
Find the frequency used in your country for The Things Network on this [list](https://www.thethingsnetwork.org/docs/lorawan/frequencies-by-country/) and modify the parameter in the script with the following function.
811+
Find the frequency used in your country for **The Things Network** on this [list](https://www.thethingsnetwork.org/docs/lorawan/frequencies-by-country/) and modify the parameter in the script within the following function.
808812

809813
```python
810814
lora = Lora(band=BAND_AU915, poll_ms=60000, debug=False) # change the band with yours e.g BAND_US915
811815
```
812-
Define your application `appEUI` and `appKey`.
816+
Define your application `appEUI` and `appKey` in the Python script so the messages are correctly authenticated by the network server.
813817

814818
```python
815819
appEui = "*****************" # now called JoinEUI
816820
appKey = "*****************************"
817821
```
822+
823+
After configuring your credentials and frequency band, you can run the script. You must be in an area with LoRaWAN® coverage, if not, you should receive an alert from the code advising you to move near a window.
824+
825+
![LoRaWAN® uplink received on TTN](assets/lora.png)
826+
827+
***You can set up your own LoRaWAN® network using our [LoRa® gateways](https://www.arduino.cc/pro/lora-gateways/)***
828+
829+
830+
## Support
831+
832+
If you encounter any issues or have questions while working with the Vision Shield, we provide various support resources to help you find answers and solutions.
833+
834+
### Help Center
835+
836+
Explore our [Help Center](https://support.arduino.cc/hc/en-us), which offers a comprehensive collection of articles and guides for the Vision Shield. The Arduino Help Center is designed to provide in-depth technical assistance and help you make the most of your device.
837+
838+
- [Vision Shield Help Center page](https://support.arduino.cc/hc/en-us/sections/360004767859-Portenta-Family)
839+
840+
### Forum
841+
842+
Join our community forum to connect with other Portenta Vision Shield users, share your experiences, and ask questions. The forum is an excellent place to learn from others, discuss issues, and discover new ideas and projects related to the Vision Shield.
843+
844+
- [Vision Shield category in the Arduino Forum](https://forum.arduino.cc/c/hardware/portenta/portenta-vision-shield/177)
845+
846+
### Contact Us
847+
848+
Please get in touch with our support team if you need personalized assistance or have questions not covered by the help and support resources described before. We're happy to help you with any issues or inquiries about the Vision Shield.
849+
850+
- [Contact us page](https://www.arduino.cc/en/contact-us/)
851+

0 commit comments

Comments
 (0)