diff --git a/docs/hardware/accessoires/display.mdx b/docs/hardware/accessoires/display.mdx index 3b215d1..733b8ee 100644 --- a/docs/hardware/accessoires/display.mdx +++ b/docs/hardware/accessoires/display.mdx @@ -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. + ## Technische Informationen - "Plug-in-and-Go" senseBox kompatibel durch Breakout-Board mit JST-Anschluss diff --git a/docs/hardware/accessoires/rtc-modul.md b/docs/hardware/accessoires/rtc-modul.mdx similarity index 96% rename from docs/hardware/accessoires/rtc-modul.md rename to docs/hardware/accessoires/rtc-modul.mdx index e3625c1..a544760 100644 --- a/docs/hardware/accessoires/rtc-modul.md +++ b/docs/hardware/accessoires/rtc-modul.mdx @@ -4,6 +4,10 @@ title: RTC-Modul hide_title: false description: Mit dem RTC-Modul kann die Uhrzeit auch ohne Stromversorgung gespeichert werden. --- + +import TutorialPorts from '@site/src/components/TutorialPorts/TutorialPorts' + + # RTC-Modul Das RTC-Modul ermöglicht es dir, die Uhrzeit auch ohne Stromversorgung zu speichern. Dies kann besonders nützlich sein, wenn keine Internetverbindung verfügbar ist und Messwerte offline z.B. auf der SD Karte gespeichert werden sollen. Damit die Uhrzeit auch ohne Stromversorgung gespeichert werden kann, ist zudem eine Knopfzellenbatterie von Nöten. @@ -16,6 +20,8 @@ Das RTC-Modul ermöglicht es dir, die Uhrzeit auch ohne Stromversorgung zu speic Nachdem die Knopfzellenbatterie in die Halterung eingefügt wurde, wird das RTC-Modul an einen I2C Anschluss der senseBox angeschlossen. + + ## Uhrzeit einrichten diff --git a/docs/hardware/accessoires/solar_set.mdx b/docs/hardware/accessoires/solar_set.mdx new file mode 100644 index 0000000..93dc0ca --- /dev/null +++ b/docs/hardware/accessoires/solar_set.mdx @@ -0,0 +1,119 @@ +--- +sidebar_position: 25 +title: Solar-Set +hide_title: false +description: senseBox Solarmodul Erweiterung +--- + +import Admonition from "@theme/Admonition"; +import ImageWithText from '@site/src/components/ImageWithText/ImageWithText' +import solar from '@site/static/img/hardware-bilder/solar/solar.png' +import adapter from '@site/static/img/hardware-bilder/solar/solarcharger.png' +import TutorialPorts from '@site/src/components/TutorialPorts/TutorialPorts' + +# Solar-Set + +Das Solar-Set ermöglicht es, die senseBox autark mit Strom zu versorgen. +Das Set besteht aus einem Solarpanel, einem Laderegler (Powerbooster) und zwei LiPo-Akkus. Das Set ist ideal für den Einsatz im Freien, wo eine Stromversorgung über das Netz nicht möglich ist. + + + + +

+ Das Solar-Set ist nur mit der senseBox MCU kompatibel, nicht mit der senseBox MCU S2. +

+
+ +## Technische Informationen +- "Plug-in-and-Go" senseBox kompatibel +- Maße Solarpanel: 340mm x 235mm x 17mm +- Maße Powerbooster: 23mm x 45mm x 10mm +- Gewicht: ca. 1kg +- Maximale Leistung (Pm): 10W +- Klemmenspannung: 7.2V +- Spannung bei max. Leistung (Vm): 6V +- Kurzschlussstrom (Isc): 1.86A +- Zwei LiPo-Akkus mit je 3.7V und 3500mAh + +## Anschluss +Der Powerbooster wird mit einem JST-Kabel an den I2C-Steckplatz der senseBox angeschlossen. +Das Solarmodul wird mit einem Kabel an den Powerbooster angeschlossen. Die Akkus werden direkt in den Powerbooster gesteckt. + + + + +

+ LiPo-Akkus können bei falscher Handhabung explodieren oder giftige Gase freisetzen. Vor dem Anschließen der Akkus an den Powerbooster sollte sichergestellt werden, dass kein Kurzschluss vorliegt und die Akkus in gutem Zustand sind. + Die Akkus sollten niemals mit spitzen Gegenständen perforiert werden oder ins Feuer geworden werden. +

+
+ +## Laderegler (Powerbooster) +Der SolarCharger V1.0 sorgt durch integrierten Lade-Kreislauf dafür, dass die Solarzelle den Akku auflädt und der Akku seinerseits dann die senseBox betreibt. + + + + +

+ Der Powerbooster sollte am besten vor Nässe geschützt aufgebaut werden. Daher ist im Lieferumfang des Solar-Sets ein wasserdichtes Gehäuse enthalten, in dem der Powerbooster verbaut werden kann und soll. + Die Verwendung dieses Gehäuses ist empfehlenswert, um die Elektronik vor Witterungseinflüssen zu schützen. +

+
+ +## Programmierung (Arduino) + +Das Solar-Set kann in der senseBox Arduino IDE programmiert werden, um Informationen über den Ladezustand der Akkus und die Leistung der Solarzelle zu erhalten. +Allerdings ist es nicht zwingend notwendig, das Solar-Set zu programmieren, um es zu verwenden. Die senseBox ist so vorkonfiguriert, dass sie automatisch den Strom vom Powerbooster bezieht, sobald dieser angeschlossen ist. +Sollten die Akkus leer sein, wird die senseBox automatisch in den Energiesparmodus versetzt und verbraucht so wenig Strom wie möglich. Während dieser Zeit werden keine Messdaten erhoben. +Sobald die Akkus wieder aufgeladen sind, wird die senseBox automatisch wieder aktiviert. + +```cpp +#include +#include // only needer fo senseBox MCU + +SolarChargerSB041 charger; + +void setup() { + charger.begin(); + Serial.begin(9600); +} + +void loop() { + charger.update(); + + Serial.print("Charger Connected: "); + Serial.println(charger.isChargerConnected() ? "true" : "false"); + Serial.print("Solar Panel Voltage: "); + Serial.println(charger.getSolarPanelVoltage()); + Serial.print("Battery Voltage: "); + Serial.println(charger.getBatteryVoltage()); + Serial.print("Charging: "); + Serial.println(charger.isCharging() ? "true" : "false"); + Serial.print("Fast Charging: "); + Serial.println(charger.isFastCharging() ? "true" : "false"); + Serial.print("Battery Level: "); + Serial.println(charger.getBatteryLevel()); + Serial.print("Good Input Voltage: "); + Serial.println(charger.isGoodInputVoltage() ? "true" : "false"); + Serial.print("Battery Present: "); + Serial.println(charger.isBatteryPresent() ? "true" : "false"); + Serial.print("Battery Temperature: "); + Serial.println(charger.getBatteryTemperature()); + Serial.println(); + + delay(1000); +} +``` + +## Programmierung (Blockly) +In Blockly können Informationen über die Solarzelle und die Akkus über den Block `Solarladeregler` ausgelesen werden. Dieser Block ist im Bereich "Erweitert" zu finden. + +![](/img/blockly-bilder/solar/solarladeregler.svg) + +Außerdem ist es mit dem Block `Stromsparender Tiefschlaf und Neustart` möglich, den stromsparenden Tiefschlafmodus der senseBox zu kontrollieren und steuern. + +![](/img/blockly-bilder/solar/tiefschlaf.svg) + +## Weitere Informationen +> - [Shop](https://sensebox.kaufen/product/solar-set) +> - [SolarCharger V1.0 Datasheet](https://github.com/sensebox/solar-power-test/blob/master/senseBox_SolarCharger_V10.pdf) \ No newline at end of file diff --git a/docs/hardware/bee/lora-bee.mdx b/docs/hardware/bee/lora-bee.mdx index 5b87497..2cc507c 100644 --- a/docs/hardware/bee/lora-bee.mdx +++ b/docs/hardware/bee/lora-bee.mdx @@ -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). diff --git a/docs/hardware/sensors/niederschlag-rg15.mdx b/docs/hardware/sensors/niederschlag-rg15.mdx new file mode 100644 index 0000000..2f17361 --- /dev/null +++ b/docs/hardware/sensors/niederschlag-rg15.mdx @@ -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 ist ein präziser, wartungsfreier Niederschlagssensor, der mithilfe von Infrarottechnologie und einer speziellen Kunststofflinse die Niederschlagsmenge und -intensität erfasst. + + + +## 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 + + +## 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. + + + +## 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. senseBox:edu, kann alternativ `Serial1` oder `Serial2` verwendet werden. + +```cpp +#include // 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) diff --git a/docs/hardware/sensors/umweltsensor.mdx b/docs/hardware/sensors/umweltsensor.mdx index a0c75d7..0a7fac6 100644 --- a/docs/hardware/sensors/umweltsensor.mdx +++ b/docs/hardware/sensors/umweltsensor.mdx @@ -15,11 +15,11 @@ Mit dem Sensor BME680 kannst du eine verschiedene Auswahl an Phänomenen messen. -## 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 diff --git a/docusaurus.config.js b/docusaurus.config.js index c14126b..c8c50e6 100755 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -118,7 +118,7 @@ const config = { }, { label: 'openSenseMap', - to: 'https://opensensemap.org/impressum', + to: 'https://opensensemap.org/', }, { label: 'FAQ', diff --git a/i18n/en/docusaurus-plugin-content-docs/current.json b/i18n/en/docusaurus-plugin-content-docs/current.json index a5354ca..db56622 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current.json +++ b/i18n/en/docusaurus-plugin-content-docs/current.json @@ -55,13 +55,13 @@ "message": ":edu", "description": "The label for category :edu in sidebar senseBoxSidebar" }, - "sidebar.senseBoxSidebar.category.zusätzlich erwerbare Hardware": { + "sidebar.senseBoxSidebar.category.zusätzlich erwerbbare Hardware": { "message": "Additional Hardware", - "description": "The label for category zusätzlich erwerbare Hardware in sidebar senseBoxSidebar" + "description": "The label for category zusätzlich erwerbbare Hardware in sidebar senseBoxSidebar" }, - "sidebar.senseBoxSidebar.category.zusätzlich erwerbare Hardware.link.generated-index.title": { + "sidebar.senseBoxSidebar.category.zusätzlich erwerbbare Hardware.link.generated-index.title": { "message": "Additional Hardware", - "description": "The generated-index page title for category zusätzlich erwerbare Hardware in sidebar senseBoxSidebar" + "description": "The generated-index page title for category zusätzlich erwerbbare Hardware in sidebar senseBoxSidebar" }, "sidebar.senseBoxSidebar.category.:bike": { "message": ":bike", diff --git a/i18n/en/docusaurus-plugin-content-docs/current/hardware/accessoires/rtc-modul.md b/i18n/en/docusaurus-plugin-content-docs/current/hardware/accessoires/rtc-modul.mdx similarity index 96% rename from i18n/en/docusaurus-plugin-content-docs/current/hardware/accessoires/rtc-modul.md rename to i18n/en/docusaurus-plugin-content-docs/current/hardware/accessoires/rtc-modul.mdx index 7243ac8..24e3257 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/hardware/accessoires/rtc-modul.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/hardware/accessoires/rtc-modul.mdx @@ -4,6 +4,9 @@ title: RTC-Modul hide_title: false description: Mit dem RTC-Modul kann die Uhrzeit auch ohne Stromversorgung gespeichert werden. --- + +import TutorialPorts_en from '@site/src/components/TutorialPorts/TutorialPorts_en' + # RTC-Modul The RTC module allows you to save the time even without a power supply. This can be particularly useful if no internet connection is available and measured values are to be saved offline, e.g. on the SD card. A button cell battery is also required so that the time can also be saved without a power supply. @@ -14,6 +17,8 @@ The RTC module allows you to save the time even without a power supply. This can ## Connection After inserting the button cell battery has been inserted into the holder, the RTC module is connected to an I2C port on the senseBox + + ## Setting the time Before you use the RTC module, you must first set the initial time. This only needs to be done once, provided the battery is not disconnected from the module. In the following sketch, the time and date are set in the `setup` and output on the serial monitor in the `loop`. Remember to set the current time in the `setup` with the command `rtc.set(...)`. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/hardware/accessoires/solar_set.mdx b/i18n/en/docusaurus-plugin-content-docs/current/hardware/accessoires/solar_set.mdx new file mode 100644 index 0000000..e609357 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/hardware/accessoires/solar_set.mdx @@ -0,0 +1,113 @@ +--- +sidebar_position: 25 +title: Solar Set +hide_title: false +description: senseBox Solar Module Extension +--- + +import Admonition from "@theme/Admonition"; +import ImageWithText from '@site/src/components/ImageWithText/ImageWithText' +import solar from '@site/static/img/hardware-bilder/solar/solar.png' +import adapter from '@site/static/img/hardware-bilder/solar/solarcharger.png' +import TutorialPorts_en from '@site/src/components/TutorialPorts/TutorialPorts_en' + +# Solar Set + +The Solar Set enables autonomous power supply for the senseBox. +The set consists of a solar panel, a charge controller (power booster), and two LiPo batteries. The set is ideal for outdoor use where mains power supply is not available. + + + +## Technical Information +- "Plug-in-and-Go" senseBox compatible +- Solar panel dimensions: 340mm x 235mm x 17mm +- Power booster dimensions: 23mm x 45mm x 10mm +- Weight: approx. 1kg +- Maximum power (Pm): 10W +- Terminal voltage: 7.2V +- Voltage at max. power (Vm): 6V +- Short circuit current (Isc): 1.86A +- Two LiPo batteries with 3.7V and 3500mAh each + +## Connection +The power booster is connected to the I2C connector of the senseBox using a JST cable. +The solar module is connected to the power booster with a cable. The batteries are plugged directly into the power booster. + + + + +

+ LiPo batteries can explode or release toxic gases if handled incorrectly. Before connecting the batteries to the power booster, ensure that there is no short circuit and that the batteries are in good condition. + The batteries should never be punctured with sharp objects or thrown into fire. +

+
+ +## Charge Controller (Power Booster) +The SolarCharger V1.0 ensures through its integrated charging circuit that the solar cell charges the battery and the battery in turn powers the senseBox. + + + + +

+ The power booster should ideally be installed protected from moisture. Therefore, the Solar Set includes a waterproof housing in which the power booster can and should be installed. + Using this housing is recommended to protect the electronics from weather influences. +

+
+ +## Programming (Arduino) + +The Solar Set can be programmed in the senseBox Arduino IDE to obtain information about the battery charge status and solar cell performance. +However, it is not strictly necessary to program the Solar Set to use it. The senseBox is preconfigured to automatically draw power from the power booster as soon as it is connected. +If the batteries are empty, the senseBox will automatically enter energy-saving mode and consume as little power as possible. During this time, no measurement data will be collected. +Once the batteries are recharged, the senseBox will automatically be reactivated. + +```cpp +#include +#include // only needer fo senseBox MCU + +SolarChargerSB041 charger; + +void setup() { + charger.begin(); + Serial.begin(9600); +} + +void loop() { + charger.update(); + + Serial.print("Charger Connected: "); + Serial.println(charger.isChargerConnected() ? "true" : "false"); + Serial.print("Solar Panel Voltage: "); + Serial.println(charger.getSolarPanelVoltage()); + Serial.print("Battery Voltage: "); + Serial.println(charger.getBatteryVoltage()); + Serial.print("Charging: "); + Serial.println(charger.isCharging() ? "true" : "false"); + Serial.print("Fast Charging: "); + Serial.println(charger.isFastCharging() ? "true" : "false"); + Serial.print("Battery Level: "); + Serial.println(charger.getBatteryLevel()); + Serial.print("Good Input Voltage: "); + Serial.println(charger.isGoodInputVoltage() ? "true" : "false"); + Serial.print("Battery Present: "); + Serial.println(charger.isBatteryPresent() ? "true" : "false"); + Serial.print("Battery Temperature: "); + Serial.println(charger.getBatteryTemperature()); + Serial.println(); + + delay(1000); +} +``` + +## Programming (Blockly) +In Blockly, information about the solar cell and batteries can be read using the `Solar Charger` block. This block can be found in the "Advanced" section. + +![](/img/en/blockly-bilder/solar/solarladeregler.svg) + +Additionally, the `Power-saving Deep Sleep and Restart` block allows you to control and manage the power-saving deep sleep mode of the senseBox. + +![](/img/en/blockly-bilder/solar/tiefschlaf.svg) + +## Further Information +> - [Shop](https://sensebox.kaufen/product/solar-set) +> - [SolarCharger V1.0 Datasheet](https://github.com/sensebox/solar-power-test/blob/master/senseBox_SolarCharger_V10.pdf) \ No newline at end of file diff --git a/i18n/en/docusaurus-plugin-content-docs/current/hardware/sensors/feinstaub-sds011.mdx b/i18n/en/docusaurus-plugin-content-docs/current/hardware/sensors/feinstaub-sds011.mdx index e36aa8f..a0dfc0d 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/hardware/sensors/feinstaub-sds011.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/hardware/sensors/feinstaub-sds011.mdx @@ -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) \ No newline at end of file +>- [Datasheet NOVA SDS011](https://cdn-reichelt.de/documents/datenblatt/X200/SDS011-DATASHEET.pdf) \ No newline at end of file diff --git a/i18n/en/docusaurus-plugin-content-docs/current/hardware/sensors/niederschlag-rg15.mdx b/i18n/en/docusaurus-plugin-content-docs/current/hardware/sensors/niederschlag-rg15.mdx new file mode 100644 index 0000000..2d54d13 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/hardware/sensors/niederschlag-rg15.mdx @@ -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. + + + +## 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 + + +## 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). + + + +## 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 // 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) diff --git a/i18n/en/docusaurus-plugin-content-docs/current/hardware/sensors/temperatur-luftfeuchte.mdx b/i18n/en/docusaurus-plugin-content-docs/current/hardware/sensors/temperatur-luftfeuchte.mdx index cc5c416..7d22bc8 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/hardware/sensors/temperatur-luftfeuchte.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/hardware/sensors/temperatur-luftfeuchte.mdx @@ -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) diff --git a/sidebars/eduS2Sidebar.js b/sidebars/eduS2Sidebar.js index 5f62ccb..8c477e8 100755 --- a/sidebars/eduS2Sidebar.js +++ b/sidebars/eduS2Sidebar.js @@ -57,6 +57,27 @@ const eduS2Sidebar = { 'hardware/accessoires/cable_overview', ], }, + { + type: 'category', + label: 'zusätzlich erwerbbare Hardware', + link: { + type: 'generated-index', + title: 'zusätzlich erwerbbare Hardware', + }, + items: [ + 'hardware/sensors/feinstaub-sds011', + 'hardware/sensors/feinstaub-sps30', + 'hardware/bee/lora-bee', + 'hardware/sensors/co2', + 'hardware/sensors/truebner', + 'hardware/sensors/umweltsensor', + 'hardware/sensors/niederschlag-rg15', + 'hardware/bee/ethernet-bee', + 'hardware/accessoires/gps', + 'hardware/sensors/niederschlag-rg15', + 'hardware/sensors/wassertemperatur', + ], + }, ], }, { diff --git a/sidebars/eduSidebar.js b/sidebars/eduSidebar.js index 9ced924..2091a9b 100644 --- a/sidebars/eduSidebar.js +++ b/sidebars/eduSidebar.js @@ -46,7 +46,7 @@ const eduSidebar = { }, { type: 'category', - label: 'zusätzlich erwerbare Hardware', + label: 'zusätzlich erwerbbare Hardware', link: { type: 'generated-index', title: 'zusätzlich erwerbbare Hardware', @@ -58,9 +58,11 @@ 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', + 'hardware/sensors/niederschlag-rg15', 'hardware/accessoires/multiplexer', ], }, diff --git a/sidebars/glossarSidebar.js b/sidebars/glossarSidebar.js index c59505a..1a61804 100644 --- a/sidebars/glossarSidebar.js +++ b/sidebars/glossarSidebar.js @@ -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', @@ -36,6 +37,7 @@ const glossarSidebar = { 'hardware/accessoires/rgb-led-esp32', 'hardware/accessoires/rgb-led', 'hardware/accessoires/rtc-modul', + 'hardware/accessoires/solar_set', ] } diff --git a/sidebars/homeSidebar.js b/sidebars/homeSidebar.js index a2db178..8770a5c 100644 --- a/sidebars/homeSidebar.js +++ b/sidebars/homeSidebar.js @@ -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', @@ -66,7 +67,7 @@ const homeSidebar = { }, items: [ 'products/home/erweiterungen/home-erweiterung-LoRa', - 'products/home/erweiterungen/home-erweiterung-solar', + 'hardware/accessoires/solar_set', 'products/home/erweiterungen/circuitpython', ], }, diff --git a/sidebars/miniSidebar.js b/sidebars/miniSidebar.js index 6f33cd6..aef5e93 100644 --- a/sidebars/miniSidebar.js +++ b/sidebars/miniSidebar.js @@ -27,12 +27,13 @@ const miniSidebar = { 'hardware/sensors/umweltsensor', 'hardware/accessoires/display', 'hardware/accessoires/rgb-led', + 'hardware/sensors/niederschlag-rg15', 'hardware/accessoires/cable_overview', ], }, { type: 'category', - label: 'zusätzlich erwerbare Hardware', + label: 'zusätzlich erwerbbare Hardware', link: { type: 'generated-index', title: 'zusätzlich erwerbbare Hardware', @@ -42,6 +43,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', diff --git a/static/img/blockly-bilder/solar/solarladeregler.svg b/static/img/blockly-bilder/solar/solarladeregler.svg new file mode 100644 index 0000000..a92e64d --- /dev/null +++ b/static/img/blockly-bilder/solar/solarladeregler.svg @@ -0,0 +1,40 @@ + + + + + + + + + + Solarladeregler (SB-041) + + + Messwert: + + + + Spannung des Solarmoduls in V + + + + \ No newline at end of file diff --git a/static/img/blockly-bilder/solar/tiefschlaf.svg b/static/img/blockly-bilder/solar/tiefschlaf.svg new file mode 100644 index 0000000..9a63871 --- /dev/null +++ b/static/img/blockly-bilder/solar/tiefschlaf.svg @@ -0,0 +1,84 @@ + + + + + + + + + + +Stromsparender Tiefschlaf und Neustart + + +Schlafenszeit: + + + +30 + + + +Minuten + + +Aufwachzeit: + + + +30 + + +Sekunden + + +Anschlüsse zum deaktivieren: + + +I2C + + + + + + +, UART + + + + + + +, XB + + + + + + + + \ No newline at end of file diff --git a/static/img/en/blockly-bilder/solar/solarladeregler.svg b/static/img/en/blockly-bilder/solar/solarladeregler.svg new file mode 100644 index 0000000..e9e5c9d --- /dev/null +++ b/static/img/en/blockly-bilder/solar/solarladeregler.svg @@ -0,0 +1,40 @@ + + + + + + + + + + Solar Charger (SB-041) + + + Value: + + + + Solar panel voltage in V + + + + \ No newline at end of file diff --git a/static/img/en/blockly-bilder/solar/tiefschlaf.svg b/static/img/en/blockly-bilder/solar/tiefschlaf.svg new file mode 100644 index 0000000..f3943a5 --- /dev/null +++ b/static/img/en/blockly-bilder/solar/tiefschlaf.svg @@ -0,0 +1,84 @@ + + + + + + + + + + +Power-saving deep sleep and restart after + + +Sleeping time: + + + +30 + + + +minutes + + +Wake time: + + + +30 + + +seconds + + +Connections to deactivate: + + +I2C + + + + + + +, UART + + + + + + +, XB + + + + + + + + \ No newline at end of file diff --git a/static/img/hardware-bilder/niederschlag/adapterplatine_rg15.png b/static/img/hardware-bilder/niederschlag/adapterplatine_rg15.png new file mode 100644 index 0000000..f8a3a14 Binary files /dev/null and b/static/img/hardware-bilder/niederschlag/adapterplatine_rg15.png differ diff --git a/static/img/hardware-bilder/niederschlag/niederschlag-blockly.svg b/static/img/hardware-bilder/niederschlag/niederschlag-blockly.svg new file mode 100644 index 0000000..51e4853 --- /dev/null +++ b/static/img/hardware-bilder/niederschlag/niederschlag-blockly.svg @@ -0,0 +1,47 @@ + + + + + + + + + + Rainsensor (RG-15) + + + Serial Port: + + + + Serial0 + + + value: + + + + total Accumulation in mm + + + diff --git a/static/img/hardware-bilder/niederschlag/sensor_niederschlag_rg15.png b/static/img/hardware-bilder/niederschlag/sensor_niederschlag_rg15.png new file mode 100644 index 0000000..6db8158 Binary files /dev/null and b/static/img/hardware-bilder/niederschlag/sensor_niederschlag_rg15.png differ diff --git a/static/img/hardware-bilder/solar/solar.png b/static/img/hardware-bilder/solar/solar.png new file mode 100644 index 0000000..78f56c5 Binary files /dev/null and b/static/img/hardware-bilder/solar/solar.png differ diff --git a/static/img/hardware-bilder/solar/solarcharger.png b/static/img/hardware-bilder/solar/solarcharger.png new file mode 100644 index 0000000..6ff94c4 Binary files /dev/null and b/static/img/hardware-bilder/solar/solarcharger.png differ