Skip to content

Feature: senseboxbike add troubleshooting guide #83

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 3 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
59 changes: 59 additions & 0 deletions docs/products/bike/app/troubleshooting.mdx
Original file line number Diff line number Diff line change
@@ -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 kontakt@reedu.de. 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>
Original file line number Diff line number Diff line change
@@ -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 [kontakt@reedu.de](email:kontakt@reedu.de). 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>