Getting started with the Grove Mesh Kit¶
This guide describes how to start working with the Grove Mesh Kit in just a few minutes.
Included in the Box¶
Your Grove Mesh Kit box includes the following parts:
- nRF52840 Micro Development Kit
- Base Dock (Grove Compatible)
- Grove - Button
- Grove - Light Sensor
- Grove Rotary Angle Sensor
- Grove - Sound Sensor
- Grove - Temperature Sensor
- Grove - Touch Sensor
- USB 3.1 Type-C Cable
- M3 Screws & Plastic Spacers
Assemble the hardware¶
Place the nRF52840-MDK board onto the Base Dock
Connect the Grove modules to the Base Dock
Attach the four plastic spacers supplied in your box to act as legs for the Base Dock
Insert an AA battery into the holder the right way around as marked on the board
AA battery is NOT included in the kit. The Energizer® Ultimate Lithium™ AA battery is recommended to stay powered longer.
Clone the repository¶
grove-mesh-kit repository from GitHub:
git clone --recursive https://github.com/makerdiary/grove-mesh-kit
This repository provides documents and examples that you can run on your kit to ensure that everything is set up correctly.
Run the Grove CLI example¶
To quickly explore the modules, run the Grove CLI example provided with the Grove Mesh Kit.
Flash the nRF52840-MDK¶
Follow these steps to flash the Grove CLI pre-built firmware.
- Connect the nRF52840-MDK board to your PC using the USB-C cable.
- Open a file explorer. Confirm that the board has appeared as a removable drive named DAPLINK. This allows you to program the nRF52840 chip.
- Drag and drop the pre-built firmware into DAPLINK. The Grove CLI pre-built firmware is located in
Explore the Grove modules¶
You can explore the Grove modules using a serial terminal like
screen or PuTTY.
In Terminal, run:
screen /dev/cu.usbmodem846fa1a9d0de1 115200
If you are using Windows OS, run the PuTTY application instead:
Replace the serial port name
COM16 with yours.
For your convenience, our Web Device CLI provides a Web Command Line Interface using Web Bluetooth. Here, we use the Web Device CLI to demonstrate the Grove CLI example. The commands should work similarly in your serial terminal.
Upon powering up the board with the USB or AA battery, the GREEN LED starts blinking. The device is advertising as Grove CLI.
Start the Web Device CLI by clicking the following link:
Click the Connect button and pair the Grove CLI device.
groveand press the Enter button to see the hints.
Read the Grove - Rotary Angle Sensor connected to PORT#2 by running:
grove angle -p 2
You will see the result like this:
grove_cli:~$ grove angle -p 2 ADC RAW: 629 Angle: 201[degree] grove_cli:~$
Read the Grove - Light Sensor connected to PORT#3 by running:
grove light -p 3
The CLI outputs like this:
grove_cli:~$ grove light -p 3 ADC RAW: 27 Voltage: 94[mV] grove_cli:~$
Read the Grove - Sound Sensor connected to PORT#4 by running:
grove sound -p 4
You will get the sound level:
grove_cli:~$ grove sound -p 4 Sound Level: 47[dB] grove_cli:~$
Read the Grove - Temperature Sensor connected to PORT#2 by running:
grove temp -p 2
You can get the ambient temperature:
grove_cli:~$ grove temp -p 2 ADC RAW: 493 Temperature: 23.50[degreeC] grove_cli:~$
Connnect the Grove - Button to PORT#1, then run:
grove button enable -p 1
Press and release the button. The CLI outputs like this:
grove_cli:~$ grove button enable -p 1 Grove Button on Port1 Enabled grove_cli:~$ Button on Port1: Pressed Button on Port1: Released
Connect the Grove - Touch Sensor to PORT#2, and run:
grove touch enable -p 2
Touch and release the touch pad. The CLI outputs like this:
grove_cli:~$ grove touch enable -p 2 Grove Touch on Port2 Enabled grove_cli:~$ Touch on Port2: Touched Touch on Port2: Released
Congratulations! You may find your way around:
Head to the nRF5 SDK Tutorial Page for building an nRF5 SDK example like Grove CLI
Check out the Mesh networking tutorials including:
Many more details about the kit hardware can be found here:
Create an Issue¶
Interested in contributing to this project? Want to report a bug? Feel free to click here: