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/06.nicla/boards/nicla-voice/tutorials/user-manual/content.md
+33-12Lines changed: 33 additions & 12 deletions
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ tags:
8
8
- Cheat sheet
9
9
- RGB
10
10
- Communication
11
-
author: 'Benjamin Dannegård and José Bagur'
11
+
author: 'José Bagur and Benjamin Dannegård'
12
12
hardware:
13
13
- hardware/06.nicla/boards/nicla-voice
14
14
software:
@@ -20,27 +20,27 @@ software:
20
20
21
21
## Overview
22
22
23
-
This user manual will provide you with a comprehensive overview of the Arduino Nicla Voice board, covering its main hardware and software features. With this user manual, you will also learn how to set up, configure and use these features.
23
+
This user manual will provide you with a comprehensive overview of the Arduino Nicla Voice board, covering its main hardware and software features. This user manualwill also show you how to set up, configure, and use these features.
-[Micro USB cable](https://store.arduino.cc/products/usb-2-0-cable-type-a-micro) (x1)
31
31
32
32
### Software Requirements
33
33
34
34
-[Arduino IDE 1.8.10+](https://www.arduino.cc/en/software), [Arduino IDE 2.0+](https://www.arduino.cc/en/software), or [Arduino Web Editor](https://create.arduino.cc/editor)
35
-
- To create custom Machine Learning models, the integrated Machine Learning Tools of the [Arduino Cloud](https://create.arduino.cc/iot/) are needed. In case you do not have an Arduino Cloud account, you will need to create one first.
35
+
- To create custom Machine Learning models, the integrated [Machine Learning Tools](https://cloud.arduino.cc/machine-learning-tools/) of the [Arduino Cloud](https://create.arduino.cc/iot/) are needed. In case you do not have an Arduino Cloud account, you will need to create one first.
36
36
37
37
## Product Overview
38
38
39
39
The Nicla Voice is an innovative and versatile development board designed by the Arduino team for sound-enabled projects and applications. This board has an onboard always-on speech recognition and sensor-fusion processor, advanced motion sensors, and wireless connectivity via Bluetooth® Low Energy. The Nicla Voice is an ideal solution for various applications, from ultra-low power predictive maintenance and gesture or voice recognition systems to contactless wireless applications.
40
40
41
41
### Board Architecture Overview
42
42
43
-
The Nicla Voice features a robust and efficient architecture that integrates various components to enable speech, sound, and motion projects and applications.
43
+
The Nicla Voice features a robust and efficient architecture integrating various components to enable speech, sound, and motion projects and applications.
44
44
45
45

46
46
@@ -96,18 +96,34 @@ The complete STEP files are available and downloadable from the link below:
96
96
The Nicla voice can be powered by:
97
97
98
98
- Using a Micro USB cable (not included).
99
-
- Using an external **5V power supply** connected to `VIN_BQ25120` pin (please, refer to the [board pinout section](#pinout) of the user manual).
99
+
- Using an external **5V power supply** connected to `VIN_BQ25120` pin (please refer to the [board pinout section](#pinout) of the user manual).
100
100
- Using a **3.7V Lithium Polymer (Li-Po) battery** connected to the board through the onboard battery connector; the manufacturer part number of the battery connector is BM03B-ACHSS and its matching receptacle manufacturer part number is ACHR-03V-S. The **recommended minimum battery capacity for the Nicla Voice is 200 mAh**. A Li-Po battery with an integrated NTC thermistor is also recommended for thermal protection.
101
101
- Using the onboard **ESLOV connector**, which has a dedicated 5V power line.
102
102
103
103

104
104
105
-
The onboard battery charger of your board is, by default, **disabled**. To enable it, you can use the `enableCharge()` function defined in the Nicla Voice board core:
105
+
***A 3.7V Li-Po battery can be also connected through the board's pins: `1 (NTC)`, `2 (VBAT)`, and `6 (GND)`. Please refer to the board's [pinout](#pinout) to locate those pins on your Nicla Voice board.***
106
+
107
+
#### Onboard Battery Charger
108
+
<br></br>
109
+
110
+
The onboard battery charger of your board is, by default, **disabled**. To enable it, you can use the `enableCharging()` function defined in the Nicla Voice board core:
111
+
112
+
```arduino
113
+
// Enable the onboard battery charger
114
+
// The function parameter defines the charging current in mA (between 5 mA and 300 mA)
115
+
nicla::enableCharging(100);
116
+
```
117
+
118
+
The desired charging current can be set to a value between 5 mA and 300 mA; the default value is 20 mA.
119
+
120
+
***A safe default charging current value that works for most common LiPo batteries is 0.5C, which means charging at a rate equal to half the battery's capacity. For example, a 200 mAh battery could be safely charged at 100 mA (0.1 A).***
121
+
122
+
To disable the onboard battery charger, you can use the `disableCharging()` function defined in the Nicla Voice board core:
106
123
107
124
```arduino
108
-
// Enabling the battery charger
109
-
// The function parameter defines the charging current in mA
110
-
nicla::enableCharge(100);
125
+
// Disable the onboard battery charger
126
+
nicla::disableCharging();
111
127
```
112
128
113
129
### NDP120 Processor Firmware Update
@@ -144,6 +160,7 @@ It is recommended to update the NDP120 processor firmware and the built-in speec
144
160
After uploading the three files, your board's firmware is updated to the latest release and ready to be used.
145
161
146
162
#### External Memory Format
163
+
<br></br>
147
164
148
165
Your board NDP120 processor files (firmware and models) are stored in your board's external Flash memory. It is recommended to **format your Nicla Voice external Flash memory** every time you are going to update the processor firmware or when you are going to update/add models to the external Flash memory.
149
166
@@ -691,7 +708,7 @@ Next, in the `setup()` function:
691
708
- The serial communication is initialized at a baud rate of 115200.
692
709
- The Nicla Voice board is initialized, and the LDO regulator (used for putting the board into power-saving mode) is disabled to avoid communication problems with the IMU.
693
710
- Error and event handlers are initialized.
694
-
- NDP processor is initialized; this process includes populating the external Flash memory of the board with the NDP processor's internal microcontroller firmware (`mcu_fw_120_v91.synpkg`), the NDP processor's internal DSP firmware (`dsp_firmware_v91.synpkg`), and the ML model (`ei_model.synpkg`).
711
+
- NDP processor is initialized; this process includes populating the external Flash memory of the board with the NDP processor's internal microcontroller firmware (`mcu_fw_120_v91.synpkg`), the NDP processor's internal DSP firmware (`dsp_firmware_v91.synpkg`), and the Machine Learning model (`ei_model.synpkg`).
695
712
- The BMI270 sensor is initialized; this includes a software reset, loading the sensor configuration, and setting it into normal power mode with the accelerometer and gyroscope operational.
696
713
697
714
Finally, in the `loop()` function:
@@ -912,7 +929,7 @@ Next, in the `setup()` function:
912
929
- The serial communication is initialized at a baud rate of 115200.
913
930
- The Nicla Voice board is initialized, and the LDO regulator (used for putting the board into power-saving mode) is disabled to avoid communication problems with the magnetometer.
914
931
- Error and event handlers are initialized.
915
-
- NDP processor is initialized; this process includes populating the external Flash memory of the board with the NDP processor's internal microcontroller firmware (`mcu_fw_120_v91.synpkg`), the NDP processor's internal DSP firmware (`dsp_firmware_v91.synpkg`), and the ML model (`ei_model.synpkg`).
932
+
- NDP processor is initialized; this process includes populating the external Flash memory of the board with the NDP processor's internal microcontroller firmware (`mcu_fw_120_v91.synpkg`), the NDP processor's internal DSP firmware (`dsp_firmware_v91.synpkg`), and the Machine Learning model (`ei_model.synpkg`).
916
933
- The BMM150 sensor is initialized; this includes setting it into normal operation with an output data rate (ODR) of 10 Hz.
917
934
918
935
Finally, in the `loop()` function:
@@ -1027,6 +1044,10 @@ In the example code above, a Machine Learning model is loaded into the Nicla Voi
1027
1044
- If an error occurs, the built-in RGB LED will blink red continuously.
1028
1045
- While an event is recognized, the built-in RGB LED is turned on green.
1029
1046
1047
+
To learn more about your Nicla Voice board Machine Learning capabilities, check out the following tutorial and learn how to create a simple motion detection application:
1048
+
1049
+
-[Motion Detection with Nicla Voice and Machine Learning Tools](https://docs.arduino.cc/tutorials/nicla-voice/motion-detection-ml)
0 commit comments