Skip to content

Commit 25981c9

Browse files
authored
Merge pull request #478 from arduino/martab1994-patch-1
Update use-as-mkr-shield.md
2 parents 897c2f4 + 65c53e8 commit 25981c9

File tree

1 file changed

+19
-19
lines changed

1 file changed

+19
-19
lines changed

content/hardware/05.nicla/boards/nicla-sense-me/tutorials/use-as-mkr-shield/use-as-mkr-shield.md

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -27,12 +27,12 @@ software:
2727

2828
![The Arduino Nicla Sense ME mounted on top of the MKR WiFi 1010](assets/hero.png)
2929

30-
The form factor of the Nicla Sense allows the board to be used as a MKR shield. In this tutorial we will walk you through converting the Nicla Sense Board into a shield to extend some of the functionalities of the MKR boards using the I<sup>2</sup>C communications and explain how this communication functions through an example sketch.
30+
The form factor of the Nicla Sense allows the board to be used as a MKR shield. In this tutorial, we will walk you through converting the Nicla Sense Board into a shield to extend some of the functionalities of the MKR boards, using the I<sup>2</sup>C communications, and explain how this communication functions through an example sketch.
3131

3232
## Goals.
3333

34-
- How to solder the headers on the Nicla Sense ME.
35-
- To establish an I<sup>2</sup>C communication between the MKR WiFi 1010 and the Nicla Sense
34+
- How to solder the headers on the Nicla Sense ME
35+
- How to establish an I<sup>2</sup>C communication between the MKR WiFi 1010 and the Nicla Sense
3636

3737
### Required Hardware and Software
3838

@@ -41,38 +41,38 @@ The form factor of the Nicla Sense allows the board to be used as a MKR shield.
4141
- [Nicla Sense ME](https://store.arduino.cc/products/nicla-sense-me)
4242
- 1x USB A Cable to Micro USB
4343
- 2x row of Male Headers (1x9 1x8)
44-
- Soldering tool and Stain.
45-
- Both libraries can be downloaded from the library manager
44+
- Soldering tool and Stain.
45+
- Libraries to be downloaded from the Library Manager
4646

4747

48-
***The following sketches can be found inside the Arduino_BHY2 and Arduino_BHY2Host libraries, available at the library manager, you will need to add the changes shown in this tutorial***
48+
***The following sketches can be found inside the Arduino_BHY2 and Arduino_BHY2Host libraries, available in the Library Manager. You will need to add the changes shown in this tutorial***
4949

5050
## Instructions
5151

5252
### 1. The Setup
53-
We will need the latest version of the mbed_portenta core to be able to install the needed drivers of the Nicla Sense ME (minimum v2.5.2). Install the **Arduino_BHY2** and **Arduino_BHY2Host** libraries from the library manager.
53+
You will need the latest version of the mbed_portenta core to be able to install the needed drivers for the Nicla Sense ME (minimum v2.5.2). Install the **Arduino_BHY2** and **Arduino_BHY2Host** libraries from the Library Manager.
5454

55-
To convert the Nicla Sense ME into a Shield, you will have to **solder** 2 rows of **headers** one side has 9 pins and the other 8 pins, the long side of the headers needs to be on the **battery connectors side**.
55+
To convert the Nicla Sense ME into a Shield, you will have to **solder** 2 rows of **headers**: one side has 9 pins and the other 8 pins, the long side of the headers needs to be on the **battery connectors side**.
5656

5757
<iframe width="100%" height="415" src="https://www.youtube.com/embed/3XwwYb5yFLk" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
5858

59-
Once the headers are soldered and the board plugged on top of the MKR, it will be possible to see the Nicla Sense ME LED and the Reset button, also to confirm the correct position you can see a white silk outline in the GND pin of the Nicla Sense ME, it needs to be aligned with the MKR GND pin. Have a look at the video to figure out the correct orientation of the board.
59+
Once the headers are soldered, you can plug the Nicla on top of the MKR, having the Nicla Sense ME LED and Reset button pointing upwards. Additionally, to further confirm the correct positioning, the white silk outline in the GND pin of the Nicla Sense ME needs to be aligned with the MKR GND pin. Have a look at the video to figure out the correct orientation of the board.
6060

6161

6262
![Assembly of the Nicla Sense ME in top of the MKR WiFi 1010](assets/NiclaSenseME-MKR-Shield.gif)
6363

64-
***This set-up works with the ESLOV cable as well.Also keep in mind female headers or raw cables can be used as well, make sure the connections of the pinout match with the MKR pinout (3V3, GND, SCL and SDA).***
64+
***This set-up works with the ESLOV cable as well. Keep in mind female headers or raw cables can be used as well, but make sure the connections of the pinout match with the MKR pinout (3V3, GND, SCL and SDA).***
6565

6666
### 2. Structure of the Communication
67-
The host (MKR WiFi 1010), will communicate through the **BHY2Host** library with the **Nicla Sense ME** (both devices communicate over I<sup>2</sup>C)
67+
The host (MKR WiFi 1010) will communicate through the **BHY2Host** library with the **Nicla Sense ME** (both devices communicate over I<sup>2</sup>C).
6868

6969
### 3. Host Communication of the MKR WiFi 1010
7070

71-
To make the host communicate with the Nicla Sense ME which is mounted as a shield you can modify one of the existing examples. Open the sketch under **Examples > Arduino_BHY2Host > Accelerometer** and modify the `setup` function.
71+
To make the host communicate with the Nicla Sense ME mounted as a shield, you can modify one of the existing examples. Open the sketch under **Examples > Arduino_BHY2Host > Accelerometer** and modify the `setup` function.
7272

7373
Add the following parameters to `BHY2Host.begin()`: `BHY2Host.begin(false, NICLA_AS_SHIELD);`
7474

75-
The first parameter defines if the data should be passed through the Serial connection. This allows to control the Nicla Sense ME from a PC when connected through a host board. You can use the `arduino-bhy` tool to control the Nicla Sense ME from either the PC command line or from a web page.
75+
The first parameter defines if the data should be passed through the Serial connection. This allows to control the Nicla Sense ME from a PC when connected through a host board. You can use the `arduino-bhy` tool to control the Nicla Sense ME from either the PC command line or from a webpage.
7676

7777
Full sketch:
7878

@@ -105,7 +105,7 @@ void loop()
105105
}
106106
```
107107

108-
### 4. Program of the Nicla Sense ME
108+
### 4. Program the Nicla Sense ME
109109

110110
Program the Nicla Sense ME with the **App.ino** sketch from the **BHY2** library. You can find it under **Examples > Arduino_BHY2 > App** . Modify it as follows:
111111

@@ -117,10 +117,10 @@ Navigate to the `setup` function and add two parameters to `BHY2.begin()`
117117
BHY2.begin(NICLA_I2C, NICLA_AS_SHIELD);
118118
```
119119

120-
***You may use `NICLA_I2C`, `NICLA_BLE`, `NICLA_BLE_AND_I2C` as the first parameter, and as the second one `NICLA_VIA_ESLOV` or `NICLA_AS_SHIELD`. Remember to use the corresponding settings on the HOST board.***
120+
***You may use `NICLA_I2C`, `NICLA_BLE`, `NICLA_BLE_AND_I2C` as first parameter, and as second one `NICLA_VIA_ESLOV` or `NICLA_AS_SHIELD`. Remember to use the corresponding settings on the HOST board.***
121121

122122

123-
These settings will internally adjust the communication parameters so it can communicate through the headers.
123+
These settings will internally adjust the communication parameters, so it can communicate through the headers.
124124

125125

126126
***We suggest to unplug the Nicla Sense ME from the host Arduino board while connecting the USB to the computer.***
@@ -157,15 +157,15 @@ The BHY2 Library encapsulates the I2C communication and therefore reduces the co
157157

158158

159159
## Troubleshooting
160-
Make sure you have the latest version of both libraries Arduino_BHY2 and Arduino_BHY2Host installed.
160+
Make sure you have installed the latest version of both libraries Arduino_BHY2 and Arduino_BHY2Host.
161161

162162

163-
If you don't see any output on the Serial monitor, make sure you have set the correct baud rate. In this example sketch we use 115200.
163+
If you do not see any output on the Serial Monitor, make sure you have set the correct baud rate. In this example sketch we use 115200.
164164

165165

166166
Make sure the pins are soldered on the correct side and the Nicla Sense ME is mounted with the correct orientation on the host board.
167167

168168

169169
### Next Steps
170170

171-
Using the Cloud dashboard to select which sensor you want to use and initialize, so you have all the control from there.
171+
Leverage the Arduino Cloud dashboard to select which sensor you want to use and initialize, so you can remotely control your application.

0 commit comments

Comments
 (0)