Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Seeed Studio S210x documentation #1252

Merged
merged 3 commits into from
Feb 21, 2024
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
59 changes: 59 additions & 0 deletions doc/content/devices/models/seeed-s210x/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
---
title: "Seeed Studio S210x Series"
description: ""
weight:
---

{{< figure src="s210x.png" alt="Generic Node Sensor Edition" class="float plain" width="80%">}}

The Seeed Studio [S210x Series](https://www.seeedstudio.com/SenseCAP-S2100-LoRaWAN-Data-Logger-p-5361.html) offers users’ industrial long-distance data acquisition via LoRaWAN. This series is suitable for a wide variety of different industries such as smart agriculture, smart buildings and industrial control.
LDannijs marked this conversation as resolved.
Show resolved Hide resolved

<!--more-->

## Sensor Setup

To acquire the provisioning information and properly setup the sensor you must download the **SenseCap Mate** App from the Play Store or the App Store on your phone.

After opening the app it will ask you to log in/create an account, but you can click on **Skip** in the top right if you don't wish to sign up.

Then click the device you wish to connect to (either the **S210x Sensor** or the **S2100 Data Logger**) and select configuration mode: **Advanced Configuration**.

The app then explains how to enter bluetooth pairing mode. **Press and hold the button under the device for 3 seconds and release when it starts to blink**. Once done click **Device is ready for configuration**. It will then proceed to scan for the device, and it should show up in the list. Click on **your device's serial number** to proceed.
LDannijs marked this conversation as resolved.
Show resolved Hide resolved

Once in the menu of the device select the tab **Settings**. After that click on the dropdown for **Platform**. Here you must select **The Things Network**. Make sure the **Frequency Plan** is correct as well. Finally, copy the **Device EUI, AppEUI and AppKey** and save them somewhere. We will need these for onboarding.
LDannijs marked this conversation as resolved.
Show resolved Hide resolved

{{< figure src="sensecap-app-settings.png" alt="Settings tab of the device." width="40%">}}

## Onboarding to {{% tts %}}

The device can be onboarded using the **Device Repository** or by **manually** entering the specific information.
LDannijs marked this conversation as resolved.
Show resolved Hide resolved

{{< note "The S210x does not support onboarding with a QR code." />}}

The [LoRaWAN® Device repository](https://github.com/TheThingsNetwork/lorawan-devices) comprises over 600 end-device profiles, including the Seeed Studio, which enables quick and easy registration with {{% tts %}}.

In the **End device type** section, under **Input method**, select either the **Select the end device in the LoRaWAN Device Repository** or **Enter end device specifics manually** option. The [Onboarding devices without QR codes]({{< ref "/devices/adding-devices/#onboarding-devices-without-qr-codes" >}}) section of the [Adding Devices]({{< ref "/devices/adding-devices/" >}}) guide explains this procedure in detail. Following details are S210x-specific:

- End device brand: **SenseCAP**
- Model: **S210x** *(replace the 'x' with whichever type you have)*
- Hardware Ver.: **1.0**
- Firmware Ver.: **1.0**

After configuring your device, select the **Register end device** button.

{{< figure src="s210x-prov-info-stack.png" alt="Settings for registration through device repository" >}}

If you prefer onboarding **manually**, in the **End device type** section, under **Input Method**, select the **Enter end device specifics manually** option. The [Manually adding devices]({{< ref "/devices/adding-devices/manual/" >}}) and [Over the Air Activation (OTAA)]({{< ref "/devices/adding-devices/manual/otaa/" >}}) guides explain this procedure in detail. Following details are specific to the S210x:

- LoRaWAN version: **LoRaWAN Specification 1.0.2**
- Regional parameters version: **RP001 Regional Parameters 1.0.2 revision B**

After configuring your device, select the **Register end device** button.

{{< figure src="manual-register.png" alt="Settings for manual registration" >}}

## Monitoring Live Data

When your device is registered, select the **Live Data** tab to view all messages exchanged between your end device and {{% tts %}}.

{{< figure src="s210x-live-data.png" alt="Live Data tab" >}}
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/content/devices/models/seeed-s210x/s210x.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading