Skip to content

Created docs for Hydreon RG-15 #82

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

Open
wants to merge 9 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all 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
1 change: 1 addition & 0 deletions docs/hardware/accessoires/display.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ import TutorialPorts from '@site/src/components/TutorialPorts/TutorialPorts'
Mit dem senseBox OLED Display lassen sich auf 128x64 Pixeln Messwerte, Statusmeldungen und vieles mehr anzeigen.

<ImageWithText src={display} alt="OLED Display" title="OLED Display" />

## Technische Informationen

- "Plug-in-and-Go" senseBox kompatibel durch Breakout-Board mit JST-Anschluss
Expand Down
2 changes: 1 addition & 1 deletion docs/hardware/bee/lora-bee.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ Dies ist auf der [Karte](https://www.thethingsnetwork.org/community#list-communi

## Benutzung

Ein ausführliches Tutorials wie du das LoRa Bee in Verbindung mit der senseBoxMCU und dem [TheThingsNetwork](https://thethingsnetwork.org) verwenden kannst findest du [hier](/products/home/erweiterungen/home-erweiterung-LoRa).
Ein ausführliches Tutorials wie du das LoRa Bee in Verbindung mit der senseBoxMCU und dem [TheThingsNetwork](https://thethingsnetwork.org) verwenden kannst findest du [hier](/products/home/erweiterungen/home-erweiterung-lora/).

Das Blockly Tutorial zur LoRa Verwendung findest du [hier](/docs/editors/blockly/blocks/lora).

Expand Down
102 changes: 102 additions & 0 deletions docs/hardware/sensors/niederschlag-rg15.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,102 @@
---
sidebar_position: 0
title: Niederschlagssensor
hide_title: false
description: Niederschlagssensor (RG15)
---

import ImageWithText from '@site/src/components/ImageWithText/ImageWithText'
import precipationSensor from '@site/static/img/hardware-bilder/niederschlag/sensor_niederschlag_rg15.png'
import adapter from '@site/static/img/hardware-bilder/niederschlag/adapterplatine_rg15.png'
import TutorialPorts from '@site/src/components/TutorialPorts/TutorialPorts'
import { useBoardStore } from '@site/src/lib/stores/store'

# Niederschlagssensor

Der Hydreon RG-15 misst Niederschlagsmenge und -intensität präzise und wartungsfrei mit Infrarottechnik und einer runden Kunststofflinse.

<ImageWithText
src={precipationSensor}
alt="Niederschlagssensor"
title="Niederschlagssensor"
/>

## Technische Information
- "Plug-in-and-Go" senseBox kompatibel
- Maße: 121mm x 71mm x 56mm
- Abweichung bei Messungen von ±10%
- Messungen bei Temperaturen von -40°C bis +60°C (-40°F bis +140°F)
- Nominelle Stromzufuhr von 110 μA und 2-4 mA bei Niederschlag
- Betriebsspannung 5V oder 3.3V
- Serielle Schnittstelle (UART)

## Anschluss
<TutorialPorts port="uart" />

## Adapterplatine

Der RG-15 Sensor kann auf Grund unterschiedlicher Betriebsspannungen nicht direkt an die senseBox angeschlossen werden.
Daher ist eine Adapterplatine notwendig, die den Sensor mit der senseBox verbindet.
Diese Adapterplatine ist im Lieferumfang des Sensors enthalten und wird je nach senseBox Modell mit einem unterschiedlichen Kabel verbunden:

- senseBox MCU S2, bzw. senseBox:edu S2: Die Adapterplatine wird mit einem [QWIIC Kabel SB-074](https://sensebox.kaufen/product/qwiic-kabel-500mm) verbunden.
- senseBox MCU, bzw. senseBox:edu: Die Adapterplatine wird mit einem [senseBox Kabel SB-057](https://sensebox.kaufen/product/sensebox-kabel-jst-jst-500mm) verbunden.

<ImageWithText
src={adapter}
alt="Adapterplatine"
title="Adapterplatine"
/>

## Programmierung (Arduino)

### Software Bibliothek

Um den Sensor in Arduino zu Programmieren musst du die Software Bibliothek [RG15-Arduino](https://github.com/sensebox/rg15-arduino-lib) installieren.

### Code

Dieser Code gibt die Niederschlagsintensität im Seriellen Monitor aus. Über die Variablen `getEventAccumulation` und `getTotalAccumulation` kannst du auf die anderen Messwerte zugreifen. Die Variable `getAccumulation` gibt die Niederschlagsmenge seit der letzten Messung an.
Der Sensor wird im Beispiel über `Serial0` initialisiert, was der Standardport auf der senseBox MCU S2, bzw. senseBox:edu S2, ist. Auf der senseBox MCU, bzw. seseBox:edu, kann alternativ `Serial1` oder `Serial2` verwendet werden.

```cpp
#include <RG15.h> // https://github.com/sensebox/rg15-arduino-lib

// Initialise the RG15 through the serial port
RG15 rg15_Serial0(Serial0);

void setup(){
Serial.begin(9600);
delay(2000);
rg15_Serial0.begin();
rg15_Serial0.resetAccumulation();
}

void loop(){
rg15_Serial0.poll();
float intensity = rg15_Serial0.getRainfallIntensity();
Serial.print("Niederschlagsintensität: ");
Serial.print(intensity);
Serial.println(" mm/h");

delay(1000);
}
```

## Programmierung (Blockly)

In Blockly kann der Sensor über folgenden Block ausgelesen werden:

![](/img/hardware-bilder/niederschlag/niederschlag-blockly.svg)

Im Block kannst du zwischen den verschiedenen Parametern des Umweltsensors auswählen:
- Niederschlagsintensität in mm/h
- Niederschlagsmenge seit der letzten Messung in mm
- Gesamte Niederschlagsmenge in mm
- Niederschlag pro Event in mm

Zusätzlich kann dort der Serielle Port ausgewählt werden, an dem der Sensor angeschlossen ist.

## Extras
> - [Shop](https://sensebox.kaufen/product/hydreon-rg-15-regensensor)
> - [Hydreon RG-15 Datenblatt](https://rainsensors.com/wp-content/uploads/sites/3/2022/07/2022.07.18-rev-1.000-rg-15_instructions.pdf)
4 changes: 2 additions & 2 deletions docs/hardware/sensors/umweltsensor.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,11 @@ Mit dem Sensor BME680 kannst du eine verschiedene Auswahl an Phänomenen messen.

<ImageWithText src={umweltsensor} title="BME680 Umweltsensor" />

## Technische Details
## Technische Informationen

- Schnelle Reaktionszeit von weniger als 10 Sekunden
- "Plug-in-and-Go" senseBox kompatibel
- Abweichung bei Gasmessungen von +-15%
- Abweichung bei Gasmessungen von ±15%

## Anschluss

Expand Down
2 changes: 1 addition & 1 deletion docusaurus.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -118,7 +118,7 @@ const config = {
},
{
label: 'openSenseMap',
to: 'https://opensensemap.org/impressum',
to: 'https://opensensemap.org/',
},
{
label: 'FAQ',
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -78,4 +78,4 @@ Select the port to which you have connected the sensor and the measurement value
- PM10: Particulate matter fraction below 10 µg/m^3

>- [Shop](https://sensebox.kaufen/product/feinstaub-sds011)
>- [Datenblatt NOVA SDS011](https://cdn-reichelt.de/documents/datenblatt/X200/SDS011-DATASHEET.pdf)
>- [Datasheet NOVA SDS011](https://cdn-reichelt.de/documents/datenblatt/X200/SDS011-DATASHEET.pdf)
Original file line number Diff line number Diff line change
@@ -0,0 +1,103 @@
---
sidebar_position: 0
title: Precipation Sensor
hide_title: false
description: Precipation Sensor (RG15)
---

import ImageWithText from '@site/src/components/ImageWithText/ImageWithText'
import precipationSensor from '@site/static/img/hardware-bilder/niederschlag/sensor_niederschlag_rg15.png'
import adapter from '@site/static/img/hardware-bilder/niederschlag/adapterplatine_rg15.png'
import TutorialPorts_en from '@site/src/components/TutorialPorts/TutorialPorts_en'
import { useBoardStore } from '@site/src/lib/stores/store'

# Precipation Sensor

The Hydreon RG-15 measures precipitation amount and intensity precisely and maintenance-free using infrared technology and a round plastic lens.

<ImageWithText
src={precipationSensor}
alt="Precipation Sensor"
title="Precipation Sensor"
/>

## Technical Information
- "Plug-in-and-Go" compatible with senseBox
- Dimensions: 121mm x 71mm x 56mm
- Measurement deviation of ±10%
- Operating temperature range from -40°C to +60°C (-40°F to +140°F)
- Nominal current supply of 110 μA and 2-4 mA during precipitation
- Operating voltage 5V or 3.3V
- Serial interface (UART)

## Connection
<TutorialPorts_en port="uart" />

## Adapter Board

The RG-15 sensor cannot be directly connected to the senseBox due to different operating voltages.
Therefore, an adapter board is required to connect the sensor to the senseBox.
This adapter board is included in the sensor's package and is connected with a different cable depending on the senseBox model:

- senseBox MCU S2 or senseBox:edu S2: The adapter board is connected using a [QWIIC cable SB-074](https://sensebox.kaufen/product/qwiic-kabel-500mm).
- senseBox MCU or senseBox:edu: The adapter board is connected using a [senseBox cable SB-057](https://sensebox.kaufen/product/sensebox-kabel-jst-jst-500mm).

<ImageWithText
src={adapter}
alt="Adapter Board"
title="Adapter Board"
/>

## Programming (Arduino)

### Software Library

To program the sensor in Arduino, you need to install the software library [RG15-Arduino](https://github.com/sensebox/rg15-arduino-lib).

### Code

This code outputs the rainfall intensity to the Serial Monitor. You can access other measurements using the variables `getEventAccumulation` and `getTotalAccumulation`. The variable `getAccumulation` provides the rainfall amount since the last measurement.
In the example, the sensor is initialized via `Serial0`, which is the default port on the senseBox MCU S2 or senseBox:edu S2. On the senseBox MCU or senseBox:edu, you can alternatively use `Serial1` or `Serial2`.


```cpp
#include <RG15.h> // https://github.com/sensebox/rg15-arduino-lib

// Initialise the RG15 through the serial port
RG15 rg15_Serial0(Serial0);

void setup(){
Serial.begin(9600);
delay(2000);
rg15_Serial0.begin();
rg15_Serial0.resetAccumulation();
}

void loop(){
rg15_Serial0.poll();
float intensity = rg15_Serial0.getRainfallIntensity();
Serial.print("Niederschlagsintensität: ");
Serial.print(intensity);
Serial.println(" mm/h");

delay(1000);
}
```

## Programming (Blockly)

In Blockly, the sensor can be read using the following block:

![](/img/hardware-bilder/niederschlag/niederschlag-blockly.svg)

In the block, you can select between the different parameters of the environmental sensor:
- Rainfall intensity in mm/h
- Rainfall amount since the last measurement in mm
- Total rainfall amount in mm
- Rainfall per event in mm

Additionally, you can select the serial port to which the sensor is connected.

## Extras
> - [Shop](https://sensebox.kaufen/product/hydreon-rg-15-regensensor)
> - [Hydreon RG-15 Datasheet](https://rainsensors.com/wp-content/uploads/sites/3/2022/07/2022.07.18-rev-1.000-rg-15_instructions.pdf)
Original file line number Diff line number Diff line change
Expand Up @@ -78,4 +78,4 @@ In the block, you can select between the different parameters of the temperature
## Extras

> - [Shop](https://sensebox.kaufen/product/temperatur-luftfeuchte)
> - [TI HDC1080 Datenblatt](https://www.ti.com/lit/ds/symlink/hdc1080.pdf)
> - [TI HDC1080 Datasheet](https://www.ti.com/lit/ds/symlink/hdc1080.pdf)
1 change: 1 addition & 0 deletions sidebars/eduSidebar.js
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,7 @@ const eduSidebar = {
'hardware/sensors/co2',
'hardware/sensors/truebner',
'hardware/sensors/umweltsensor',
'hardware/sensors/niederschlag-rg15',
'hardware/bee/ethernet-bee',
'hardware/accessoires/gps',
'hardware/sensors/wassertemperatur',
Expand Down
1 change: 1 addition & 0 deletions sidebars/glossarSidebar.js
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@ const glossarSidebar = {
'hardware/sensors/tof',
'hardware/sensors/truebner',
'hardware/sensors/umweltsensor',
'hardware/sensors/niederschlag-rg15',
'hardware/bee/bluetooth-bee',
'hardware/bee/ethernet-bee',
'hardware/bee/lora-bee',
Expand Down
1 change: 1 addition & 0 deletions sidebars/homeSidebar.js
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,7 @@ const homeSidebar = {
'hardware/sensors/co2',
'hardware/sensors/truebner',
'hardware/sensors/umweltsensor',
'hardware/sensors/niederschlag-rg15',
'hardware/bee/ethernet-bee',
'hardware/accessoires/gps',
'hardware/accessoires/multiplexer',
Expand Down
1 change: 1 addition & 0 deletions sidebars/miniSidebar.js
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,7 @@ const miniSidebar = {
'hardware/sensors/feinstaub-sps30',
'hardware/sensors/co2',
'hardware/sensors/truebner',
'hardware/sensors/niederschlag-rg15',
'hardware/bee/ethernet-bee',
'hardware/accessoires/gps',
'hardware/sensors/wassertemperatur',
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
47 changes: 47 additions & 0 deletions static/img/hardware-bilder/niederschlag/niederschlag-blockly.svg
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.