diff --git a/docs/EN/troubleshooting.md b/docs/EN/troubleshooting.md index d4ade43f..ca2d6e70 100644 --- a/docs/EN/troubleshooting.md +++ b/docs/EN/troubleshooting.md @@ -1,12 +1,13 @@ # Troubleshooting BSB-LAN tries to make accessing your heating system as easy as possible, but there are always things that can go wrong. If you still have a problem after reading this document as well as the [FAQ](faq.md), please [open up a bug report](https://github.com/fredlcore/BSB-LAN/issues/new?assignees=&labels=&projects=&template=bug_report.md&title=%5BBUG%5D) on the project's GitHub page and make sure that you provide us with all the necessary log files and further required details, especially from the Serial Monitor (or *SerMo* in short). -Before doing so, however, make sure that you install the most recent version of BSB-LAN from the master repository (not the release version), even if yours is "just" a few days old. Still, a lot could have happned since then :)! +Before doing so, however, make sure that you install **the most recent version of BSB-LAN from the master repository** (not the release version), even if yours is "just" a few days old. Still, a lot could have happned since then :)! ### Using the Serial Monitor - Access the Serial Monitor by going to ***Tools/Serial Monitor*** in the Arduino IDE. - Set the transmission speed to 115200 at the top right corner of the serial monitor window. - Make sure you copy the messages right from the moment your microcontroller boots (indicated by the `READY` message) until the moment you encounter the problem. -- Please do not send screenshots, only plain text files. +- Please **do not send screenshots**, only plain text files. +- Watch my short [tutorial video](https://youtu.be/DsYPhihl11o) in case you have questions. The Serial Monitor in the Arduino IDE currently has a bug that allows you to only copy those parts of the Serial Monitor messages that you can see on the screen. Although this means that copying larger portions of log messages is tedious, you still have to provide the complete log in order to get support. Increasing the size of the Serial Monitor window helps a little. diff --git a/docs/de/troubleshooting.md b/docs/de/troubleshooting.md index 74bc44e7..20c7492b 100644 --- a/docs/de/troubleshooting.md +++ b/docs/de/troubleshooting.md @@ -2,13 +2,14 @@ BSB-LAN versucht, den Zugriff auf dein Heizsystem so einfach wie möglich zu gestalten, aber es kann immer etwas schiefgehen. Wenn du nach dem Lesen dieses Dokuments und der [FAQ](faq.md) immer noch ein Problem hast, öffne bitte [einen Bug-Report](https://github.com/fredlcore/BSB-LAN/issues/new?assignees=&labels=&projects=&template=bug_report.md&title=%5BBUG%5D) auf der GitHub-Seite des Projekts und stelle sicher, dass du uns alle notwendigen Log-Dateien und weitere erforderliche Details, insbesondere vom Serial Monitor (oder kurz *SerMo*), zur Verfügung stellst. -Bevor du das tust, stelle jedoch sicher, dass du die neueste Version von BSB-LAN aus dem Master-Repository (nicht die Release-Version) installierst, auch wenn deine Version nur ein paar Tage alt ist. Trotzdem könnte seitdem eine Menge passiert sein :)! +Bevor du das tust, stelle jedoch sicher, dass du **die neueste Version von BSB-LAN aus dem Master-Repository** (nicht die Release-Version) installierst, auch wenn deine Version nur ein paar Tage alt ist. Trotzdem könnte seitdem eine Menge passiert sein :)! ### Verwendung des Serial Monitors - Öffne den Serial Monitor, indem du in der Arduino IDE zu ***Tools/Serial Monitor*** gehst. - Setze die Übertragungsgeschwindigkeit auf 115200 in der rechten oberen Ecke des Serial Monitor-Fensters. - Stelle sicher, dass du die Nachrichten direkt ab dem Moment kopierst, in dem dein Mikrocontroller bootet (angezeigt durch die Nachricht `READY`), bis zu dem Moment, in dem das Problem auftritt. -- Sende bitte keine Screenshots, sondern nur Textdateien. +- Sende bitte **keine Screenshots**, sondern **nur Textdateien**. +- Schau' Dir mein kurzes [Tutorial-Video](https://youtu.be/DsYPhihl11o) an, wenn Du Fragen hast. Der Serial Monitor in der Arduino IDE hat derzeit einen Bug, der es dir nur ermöglicht, die Teile der Serial Monitor-Nachrichten zu kopieren, die auf dem Bildschirm sichtbar sind. Auch wenn das bedeutet, dass das Kopieren größerer Teile der Log-Nachrichten mühsam ist, musst du trotzdem den kompletten Log bereitstellen, um Unterstützung zu erhalten. Es hilft ein wenig, die Größe des Serial Monitor-Fensters zu vergrößern.