Feature: senseboxbike add troubleshooting guide

docs/products/bike/app/setup.mdx

@@ -1,3 +1,44 @@
 ---
-title: Installation 
+title: Ersteinrichtung der senseBox:bike 
 ---
+
+Folgen Sie diesen Schritten für eine reibungslose Ersteinrichtung:
+
+## senseBox:bike auspacken und vorbereiten
+
+- Ausführliche Schritt-für-Schritt-Anleitungen finden Sie [hier](https://docs.sensebox.de/docs/products/bike/halterung/installation/).
+
+## Gerät aufladen und einschalten
+
+- Laden Sie die senseBox:bike vor Ihrer ersten Fahrt vollständig mit dem beiliegenden USB-Kabel auf. Eine vollständige Ladung sorgt für eine optimale Akkulaufzeit (in der Regel 4–8 Stunden Betrieb).
+- Drücken Sie den Ein-/Ausschalter, um die senseBox:bike einzuschalten.
+- Das Gerät signalisiert seine Einsatzbereitschaft, sobald der QR-Code auf dem LED-Display erscheint.
+
+## senseBox:bike App installieren
+
+- Laden Sie die senseBox:bike App aus dem [Google Play Store](https://play.google.com/store/apps/details?id=de.hochschuletrier.bikeapp) oder [Apple App Store](https://apps.apple.com/de/app/bikeapp/id1530130134) herunter.
+- Öffnen Sie die App, stellen Sie sicher, dass Bluetooth auf Ihrem Smartphone aktiviert ist, und gewähren Sie der App alle angeforderten Berechtigungen.
+
+## 5*. Ihr openSenseMap-Konto verknüpfen
+
+- Registrieren Sie ein neues openSenseMap-Konto oder melden Sie sich mit einem bestehenden Konto an.
+- Legen Sie eine neue Box an und stellen Sie sicher, dass sie ausgewählt ist. Achten Sie darauf, den richtigen Box-Typ und ggf. die richtige Kampagne auszuwählen, falls Sie an einer teilnehmen.
+
+:::info
+Hinweis: Die Verwaltung von Boxen und openSenseMap-Konten ist derzeit nur über die [Website](https://opensensemap.org/) möglich.
+:::
+
+## App mit dem Gerät verbinden
+
+- Klicken Sie in der App auf die Schaltfläche „Verbinden“ und wählen Sie Ihre senseBox aus der Liste aus.
+- Nach der Kopplung werden die Live-Sensordaten in der App angezeigt.
+
+## Beginn der Datenerfassung
+
+- Klicken Sie auf die Schaltfläche „Start“ und beginnen Sie Ihre Fahrt!
+
+:::info
+Hinweis: Aus Datenschutzgründen können Sie in der App Privacy Zones einrichten, in denen keine Daten erfasst oder hochgeladen werden (z. B. rund um Ihr Zuhause oder Büro). Sie können Ihre Privacy Zones im Einstellungsmenü der App festlegen.
+:::
+
+Wenn während der Einrichtung Probleme auftreten, finden Sie in der offiziellen [senseBox:bike Dokumentation](https://docs.sensebox.de/docs/products/bike/app/troubleshooting/) zur Fehlerbehebung Hilfe oder [kontaktieren Sie uns](email:[email protected]).

docs/products/bike/app/troubleshooting.mdx

@@ -0,0 +1,59 @@
+---
+title: Fehlerbehebung
+---
+
+# Allgemeine Empfehlungen
+
+Wenn beim Sammeln von Daten mit der senseBox Probleme auftreten, können Sie die folgenden allgemeinen Schritte zur Fehlerbehebung befolgen:
+ - Aktivieren Sie die automatische App-Aktualisierung, um stets die neueste Version der senseBox:bike-App zu verwenden.
+ - Erteilen Sie die erforderlichen Berechtigungen der App (Standort, Bluetooth, Benachrichtigungen).
+ - Starten Sie die senseBox:bike neu: Drücken Sie kurz den Ein-/Ausschalter, um das Gerät auszuschalten. Warten Sie einige Sekunden und drücken Sie dann erneut, um es wieder einzuschalten.
+ - Starten Sie die „senseBox:bike“-App auf Ihrem Smartphone neu.
+ - Starten Sie Ihr Smartphone neu.
+
+Sollte keine dieser Maßnahmen helfen, kontaktieren Sie uns bitte unter [email protected]. Bitte geben Sie bei Support-Anfragen folgende Informationen an:
+ - Name und Version Ihres mobilen Betriebssystems. Bei Android bitte auch den Hersteller und das Modell des Geräts angeben.
+ - Die verwendete App-Version (senseBox:bike-App > Einstellungen > Info).
+ - Eine genaue Fehlerbeschreibung inklusive des Zeitpunkts, zu dem das Problem erstmals auftrat.
+
+# Mögliche Probleme und Lösungen
+
+<details>
+    <summary>App kann keine Verbindung zur senseBox:bike herstellen</summary>
+    - Stellen Sie sicher, dass die senseBox:bike eingeschaltet und vollständig geladen ist.
+    - Prüfen Sie, ob Bluetooth auf Ihrem Smartphone aktiviert ist und die App die erforderlichen Berechtigungen hat.
+    - Starten Sie die App neu.
+    - Melden Sie sich in der App von Ihrem openSenseMap-Konto ab und wieder an.
+
+    Wenn Sie ein iPhone besitzen und die senseBox in der senseBox:bike-App nicht sehen können, obwohl Sie die oben genannten Schritte durchgeführt haben, führen Sie bitte die folgenden Schritte aus:
+    - Installieren Sie [nRF Connect](https://apps.apple.com/de/app/nrf-connect-for-mobile/id1054362403).
+    - Öffnen Sie nRF Connect, suchen Sie die senseBox, verbinden Sie sich mit ihr und trennen Sie anschließend die Verbindung.
+
+    Sie sollten die Box anschließend wieder in der „senseBox:bike“-App sehen können.
+</details>
+<details>
+    <summary>App startet keine Track-Aufzeichnung (keine Sensordaten und kein Track auf der Karte)</summary>
+    - Starten Sie die senseBox:bike neu.
+    - Starten Sie Ihr Smartphone neu.
+    - Öffnen Sie die App und verbinden Sie sich mit der senseBox:bike.
+    - Starten Sie die Aufzeichnung und stellen Sie sicher, dass Sie sich währenddessen bewegen.
+</details>
+<details>
+    <summary>Die App zeichnet den Track lokal auf, lädt ihn aber nicht auf openSenseMap hoch</summary>
+    Workaround: Sie können die aufgezeichnete Strecke als CSV-Datei im openSenseMap-kompatiblen Format exportieren und manuell auf der openSenseMap-Website hochladen.
+    - Starten Sie die App neu und prüfen Sie, ob die Sensordaten gelesen werden.
+    - Stellen Sie außerdem sicher, dass Ihre Internetverbindung stabil ist und sich die senseBox:bike in Reichweite Ihres Smartphones befindet.
+    - Deaktivieren Sie den Energiesparmodus Ihres Smartphones.
+    - Prüfen Sie, ob Sie in der App mit Ihrem openSenseMap-Konto angemeldet sind.
+    - Starten Sie die Aufzeichnung und fahren Sie einige Meter.
+    - Melden Sie sich bei openSenseMap an und prüfen Sie, ob neue Daten erscheinen.
+</details>
+<details>
+    <summary>Nicht alle Sensordaten werden aufgezeichnet</summary>
+    - Starten Sie die App neu und prüfen Sie, ob alle Sensordaten gelesen werden.
+    - Stellen Sie sicher, dass Ihre Internetverbindung stabil ist und sich die senseBox:bike in Reichweite Ihres Smartphones befindet.
+    - Deaktivieren Sie den Energiesparmodus Ihres Smartphones.
+    - Stellen Sie sicher, dass nur die senseBox:bike via Bluetooth mit Ihrem Smartphone verbunden ist.
+    - Starten Sie die Aufzeichnung, fahren Sie eine kurze Strecke und stoppen Sie dann.
+    - Überprüfen Sie, ob Sie für alle Sensoren (z. B. Geschwindigkeit und Temperatur) die gleiche Anzahl an Datenpunkten gespeichert haben.
+ </details>

i18n/en/docusaurus-plugin-content-docs/current/products/bike/app/setup.mdx

@@ -1,3 +1,44 @@
 ---
-title: Installation 
+title: Initial Setup of the senseBox:bike 
 ---
+
+Follow these steps for a smooth initial setup:
+
+## Unpack and Prepare Your senseBox:bike
+
+- You can find detailed step-by-step instructions on how to do that [here](https://docs.sensebox.de/en/docs/products/bike/halterung/installation).
+
+## Charge and Power On the Device
+
+- Before your first ride, fully charge the senseBox:bike using the included USB cable. A full charge ensures optimal battery life (typically 4–8 hours of operation).
+- Press the power button to turn on the senseBox:bike.
+- The device will indicate it is ready when you see the QR code on the LED display.
+
+## Install the senseBox:bike App
+
+- Download the senseBox:bike app from the [Google Play Store](https://play.google.com/store/apps/details?id=de.hochschuletrier.bikeapp) or [Apple App Store](https://apps.apple.com/de/app/bikeapp/id1530130134). 
+- Open the app, ensure Bluetooth is enabled on your smartphone and grant app all the reqeusted permissions.
+
+## 5*. Link your openSenseMap account
+
+- Register a new openSenseMap account or log in to an existing one.
+- Create a new box and make sure it's selected. Please make sure that you use the correct box type and campaign if you are part of one.
+
+:::info
+Note: At the moment box and openSenseMap account management is only available over [website](https://opensensemap.org/).
+:::
+
+## Connect the App to Your Device
+
+- In the app, click the "Connect" button and select your senseBox from the list.
+- Once paired, you’ll see live sensor data displayed in the app.
+
+## Start Gathering Data
+
+- Click the "Start" button and begin your ride!
+
+:::info
+Note: For privacy, you can set up Privacy Zone(s) in the app where no data will be collected or uploaded (e.g., around your home or office). You can set up your Privacy Zone(s) on the Settings screen.
+:::
+
+If you encounter any issues during setup, refer to the official [senseBox:bike documentation for troubleshooting](https://docs.sensebox.de/en/docs/products/bike/app/troubleshooting/) or [contact us](email:[email protected]).

i18n/en/docusaurus-plugin-content-docs/current/products/bike/app/troubleshooting.mdx

@@ -0,0 +1,62 @@
+---
+title: Troubleshooting Guide
+---
+
+# General recommendations
+
+If you encounter any issues when collecting data from the senseBox device, you can follow these general troubleshooting steps:
+ - Enable automatic updates for the senseBox:bike app to ensure you are always using the latest version.
+ - Gran app necessary permissions (location, Bluetooth, notifications).
+ - Restart the senseBox:bike. To do this, briefly press the power button to turn the device off. Wait a few seconds, then press the button again to turn it on.
+ - Restart the senseBox:bike app on your phone.
+ - Restart your phone.
+
+If none of these steps help, please email us at [[email protected]](email:[email protected]). When contacting support, please provide the following information:
+ - Your mobile OS name and version. If you use Android, also provide your phone’s make and model.
+ - The version of the app you are using (senseBox:bike app > Settings > About).
+ - A detailed description of the issue, including when you first noticed it.
+
+# Known issues and their solutions
+
+<details>
+    <summary>App cannot connect to senseBox</summary>
+    - Ensure the senseBox:bike is powered on and fully charged.
+    - Make sure that Bluetooth is enabled on your phone and that the app has permission to use it.
+    - Restart the app.
+
+    If you have an iPhone and you cannot see the senseBox in the senseBox:bike app even though you have taken the above steps, please take the following steps:
+    - Install [nRF Connect](https://apps.apple.com/de/app/nrf-connect-for-mobile/id1054362403).
+    - Open nRF Connect, find the senseBox, connect to it, then disconnect.
+
+    You should then be able to see the box in the senseBox:bike app again.
+</details>
+
+<details>
+    <summary>The app does not start track recording (there is no sensor data or tracks on the map)</summary>
+    - Restart the senseBox:bike.
+    - Restart your phone.
+    - Open the app and connect to the senseBox:bike.
+    - Start recording and make sure you are moving during the recording.
+</details>
+
+<details>
+    <summary>The app records tracks locally, but does not upload them to openSenseMap</summary>
+    Workaround: You can export the recorded track as a CSV file in an openSenseMap-compatible format and upload it manually to the openSenseMap website.
+
+    - Restart the app and check that the sensor data is being read.
+    - Ensure that your internet connection is stable and that the senseBox:bike is close to your phone.
+    - Disable battery-saving mode on your phone.
+    - Make sure you are logged into your openSenseMap account in the app.
+    - Start recording and move several metres.
+    - Log in to openSenseMap and check that the new data has appeared in your account.
+</details>
+
+<details>
+    <summary>Not all sensor data is being recorded</summary>
+    - Restart the app and check that all sensor data is being read.
+    - Ensure that your internet connection is stable and that the senseBox:bike is close to your phone.
+    - Disable battery-saving mode on your phone.
+    - Ensure that only the senseBox:bike is connected to your phone via Bluetooth.
+    - Start recording, take a short ride and then stop.
+    - Check that you have the same number of data points for all sensors (e.g. speed and temperature).
+</details>