BEDIENUNGSANLEITUNG WICONTROL FÜR DIE CONNECT BOX VON UPC - XBLOCK.CH
←
→
Transkription von Seiteninhalten
Wenn Ihr Browser die Seite nicht korrekt rendert, bitte, lesen Sie den Inhalt der Seite unten
Bedienungsanleitung WiControlForUpcConnectBox Bedienungsanleitung WiControl für die Connect Box von UPC Allgemeine Angaben zum Dokument Bedienungsanleitung WiControl für die Dokument Connect Box von UPC Bedienungsanleitung Dateiname WiControlForUpcConnectBox v1.0.0.7.docx Verfasser Michael Grünenwald Version 1.0.0.7 Erstelldatum 25.2.2018 Version 1.0.0.7 www.xblock.ch Seite 1/26
Bedienungsanleitung WiControlForUpcConnectBox 1. Über das Dokument 1.1. Versionen Version Autor Bemerkung Datum Michael 1.0.0.5 Erste offizielle Version des Dokumentes 02.12.2017 Grünenwald Michael 1.0.0.5-2 Fehlerbild 6.3.5 hinzugefügt 10.12.2017 Grünenwald Michael Ergänzungen im Kapitel 4.2, Kapitel 7 1.0.0.7 25.02.2018 Grünenwald neu eingefügt Version 1.0.0.7 www.xblock.ch Seite 2/26
Bedienungsanleitung WiControlForUpcConnectBox 2. Inhaltsverzeichnis 1. Über das Dokument ................................................................................... 2 1.1. Versionen ......................................................................................... 2 2. Inhaltsverzeichnis ...................................................................................... 3 3. Lieferumfang ............................................................................................. 4 4. Einrichtung ............................................................................................... 5 4.1. USB-Stick vorbereiten ........................................................................ 5 4.1.1. Vorhandene Dateien ..................................................................... 5 4.1.1. Konfiguration anpassen ................................................................ 6 4.1.1.1. Auflistung der Schlüssel ............................................................. 6 4.1.1.2. Zugangsdaten eintragen ............................................................ 8 4.1.1.3. Verhalten beim Ein- und Ausstecken des USB-Sticks ..................... 9 4.1.1.4. Zeitplan hinterlegen ................................................................ 10 4.2. Raspberry Pi 3 anschliessen .............................................................. 12 5. Bedienung .............................................................................................. 13 5.1. WLAN ausschalten ........................................................................... 13 5.2. WLAN einschalten ............................................................................ 13 6. Fehlersuche ............................................................................................ 14 6.1. Fehlersuche mit Monitor ................................................................... 14 6.2. Fehlersuche mit PuTTY ..................................................................... 14 6.2.1. PuTTY besorgen ......................................................................... 14 6.2.2. IP-Adresse des Raspberry Pi 3 herausfinden .................................. 15 6.2.3. PuTTY starten ............................................................................ 17 6.2.4. Mit SSH anmelden ..................................................................... 18 6.2.5. Logdatei anzeigen ...................................................................... 19 6.3. Fehlerbilder .................................................................................... 20 6.3.1. Ungültige IP-Adresse .................................................................. 20 6.3.2. Leeres Passwort ........................................................................ 21 6.3.3. Inkorrektes Passwort.................................................................. 22 6.3.4. Fehler im Zeitplan ...................................................................... 23 6.3.5. Anmeldung am Router schlägt fehl ............................................... 24 7. Häufig gestellte Fragen............................................................................. 25 7.1. Der Raspberry Pi 3 verfügt über Bluetooth und WLAN. Muss ich mit einer zusätzlichen elektromagnetischen Strahlung rechnen? .................................... 25 7.2. Wie hoch ist der Stromverbrauch des Raspberry Pi 3? .......................... 25 7.3. Muss ein Bildschirm am Raspberry Pi 3 angeschlossen werden? ............ 25 7.4. Kann WiControl auch das Wi-Free der UPC steuern? ............................ 25 7.5. Was passiert bei einem Stromausfall? Werden die Daten auf der SD-Karte nicht korrumpiert? ...................................................................................... 25 8. Verzeichnisse .......................................................................................... 26 8.1. Abbildungsverzeichnis ...................................................................... 26 8.2. Tabellenverzeichnis ......................................................................... 26 Version 1.0.0.7 www.xblock.ch Seite 3/26
Bedienungsanleitung WiControlForUpcConnectBox 3. Lieferumfang Der Lieferumfang besteht aus: # Stück Bezeichnung 1 1 Raspberry Pi 3 mit Gehäuse 2 1 Netzteil für Raspberry Pi 3 3 1 Netzwerkkabel 2m 4 1 8GB SD-Speicherkarte mit Betriebssystem und der Software 5 1 USB-Stick Version 1.0.0.7 www.xblock.ch Seite 4/26
Bedienungsanleitung WiControlForUpcConnectBox 4. Einrichtung 4.1. USB-Stick vorbereiten 4.1.1. Vorhandene Dateien Auf dem USB-Stick sind zwei Dateien vorhanden: Abbildung 1: Dateien auf USB-Stick Die Datei «key.txt» darf nicht gelöscht oder verändert werden. Bei der Datei «config.txt» handelt es um die Konfigurationsdatei. In dieser Datei sind alle benutzerspezifischen Daten abgelegt. Diese müssen vor der Inbetriebnahme angepasst werden. Version 1.0.0.7 www.xblock.ch Seite 5/26
Bedienungsanleitung WiControlForUpcConnectBox 4.1.1. Konfiguration anpassen Um die Konfiguration anzupassen, ist die Datei «config.txt» vom USB-Stick mit einem Texteditor (z.B. Notepad) zu bearbeiten. 4.1.1.1. Auflistung der Schlüssel Die Konfiguration wird über sogenannte Schlüssel realisiert. Momentan werden 11 verschiedene Schlüssel unterstützt. Ein Schlüssel besteht immer aus einem Schlüsselnamen und einem oder mehreren Schlüsselwerten. Mehrere Schlüsselwerte werden mit einem Semikolon getrennt: schlüsselname=schlüsselwert1;schlüsselwert2;schlüsselwert3;… Die Tabelle beinhaltet alle verfügbaren Schlüssel: # Schlüsselname Schlüsselwert(e) Erklärung Vorgabe Zugangsdaten Webinterface 1* router_ip IP-Adresse der Connect Box 192.168.0.1 Passwort der Connect Box; wurde 2* login_passwort vom Benutzer bei der Einrichtung des Routers vergeben Verhalten beim Ein- und Ausstecken des USB-Sticks Legt das Verhalten fest, wenn der 3* stick_einstecken e USB-Stick eingesteckt wird Legt das Verhalten fest, wenn der 4* stick_ausstecken a USB-Stick ausgesteckt wird Zeitplan Definiert, um welche Uhrzeit 5 mo ; montags das WLAN wie gesteuert werden soll Definiert, um welche Uhrzeit 6 di ; dienstags das WLAN wie gesteuert werden soll Definiert, um welche Uhrzeit 7 mi ; mittwochs das WLAN wie gesteuert werden soll Definiert, um welche Uhrzeit 8 do ; donnerstags das WLAN wie gesteuert werden soll Definiert, um welche Uhrzeit 9 fr ; freitags das WLAN wie gesteuert werden soll Definiert, um welche Uhrzeit 10 sa ; samstags das WLAN wie gesteuert werden soll Definiert, um welche Uhrzeit 11 so ; sonntags das WLAN wie gesteuert werden soll Tabelle 1: Liste der Schlüssel *Die Angabe dieser Schlüssel ist zwingend. Version 1.0.0.7 www.xblock.ch Seite 6/26
Bedienungsanleitung WiControlForUpcConnectBox Nähere Erläuterung der Schlüsselwerte: # Schlüsselwert Erläuterung Lautet fast immer 192.168.0.1 und muss nur in Ausnahmefällen angepasst 1 werden 2 Darf nicht leer sein Die folgenden Schalter sind zulässig und dürfen beliebig kombiniert werden: a = 2.4 GHz und 5 GHz WLAN aus a2 = 2.4 GHz WLAN aus a5 = 5 GHz WLAN aus e = 2.4 GHz und 5GHz WLAN ein e2 = 2.4 GHz WLAN ein e5 = 5GHz WLAN ein 3 Beispiel 1: 2.4 GHz aus, 5 GHz aus → a Beispiel 2: 2.4 GHz aus, 5 GHz aus → a2;a5 (entspricht dem Beispiel 1) Beispiel 3: 2.4 GHz ein, 5 GHz aus → e2;a5 Beispiel 4: 2.4 GHz aus, 5 GHz ein → a2;e5 Beispiel 5: 2.4 GHz ein, 5 GHz ein → e Beispiel 6: 2.4 GHz ein, 5 GHz ein → e2;e5 (entspricht dem Beispiel 5) Uhrzeit (hh=Stunden, mm=Minuten) Zulässiger hh-Wertebereich: 00 bis 23 Zulässiger mm-Wertebereich: 00 bis 59 4 Beispiel 1: 23:19 Beispiel 2: 02:01 Tabelle 2: Format der Schlüsselwerte Ein paar Beispiele von Schlüsseln, wie sie in der Konfiguration vorkommen können: # Schlüssel Kommentar Zugangsdaten Webinterface 1 router_ip=192.168.0.1 2 login_passwort=mein-geheimes-Passwort Verhalten beim Ein- und Ausstecken des USB-Sticks 3 stick_einstecken=e Standardverhalten 4 stick_ausstecken=a Standardverhalten Zeitplan 5 mo=06:00;e 2.4 GHz- und 5 GHz-Signale ein 6 mo=21:55;a 2.4 GHz- und 5 GHz-Signale aus 7 sa=12:00;e2;a5 2.4 GHz-Signal ein und 5 GHz-Signal aus 8 sa=14:00;a2;e5 2.4 GHz-Signal aus und 5 GHz-Signal ein Tabelle 3: Beispiele von Schlüsseln Version 1.0.0.7 www.xblock.ch Seite 7/26
Bedienungsanleitung WiControlForUpcConnectBox 4.1.1.2. Zugangsdaten eintragen WiControl benötigt die Zugangsdaten des Routers. Für die Connect Box sind es diese zwei Angaben: • IP-Adresse des Routers • Passwort für die Anmeldung am Router In 99% aller Fälle wurde die IP-Adresse nicht geändert, d.h. die Adresse wird 192.168.0.1 lauten. Das aktuelle Passwort wird ebenfalls benötigt, welches bei der Einrichtung der Connect Box vom Benutzer gesetzt wurde. Das aufgedruckte Standard-Passwort auf der Etikette (siehe Boden der Connect Box) gilt nur nach einem Zurücksetzen auf die Werkseinstellungen. Die IP-Adresse und das Passwort müssen nun unter 1 und 2 eingetragen werden: Abbildung 2: Konfiguration der Zugangsdaten Version 1.0.0.7 www.xblock.ch Seite 8/26
Bedienungsanleitung WiControlForUpcConnectBox 4.1.1.3. Verhalten beim Ein- und Ausstecken des USB- Sticks Die WLAN-Schalter unter 3 und 4 müssen praktisch nie angepasst werden. Wird der USB-Stick eingesteckt, werden beide WLAN-Signale (2.4 GHz und 5 GHz) aktiviert. Beim Ausstecken werden die beiden Signale deaktiviert. Wer ein anderes Verhalten wünscht, kann die Schalter gemäss seinen Wünschen einstellen. Die Schalter sind unter 4.1.1.1 erklärt: Abbildung 3: Verhalten des USB-Sticks Version 1.0.0.7 www.xblock.ch Seite 9/26
Bedienungsanleitung WiControlForUpcConnectBox 4.1.1.4. Zeitplan hinterlegen Wer das WLAN mit einem Zeitplan steuern möchte, muss die Konfiguration entsprechend anpassen. Der Zeitplan ist standardmässig ausgeschaltet und sieht so aus: Abbildung 4: Auskommentierter Zeitplan Vor allen Wochentagen befindet sich ein Gartenhag-Zeichen (das «#»-Zeichen), d.h. diese Zeilen sind alle auskommentiert und ohne Wirkung. Version 1.0.0.7 www.xblock.ch Seite 10/26
Bedienungsanleitung WiControlForUpcConnectBox Ein Zeitplan lässt sich einfach einrichten. Vor den Wochentagen muss der Gartenhag entfernt, die Uhrzeit und die WLAN-Schalter eingesetzt werden Die WLAN-Schalter sind unter 4.1.1.1 erklärt. Soll das WLAN beispielsweise unter der Woche von 06:00 bis 23:00 ein sein und am Wochenende zwischen 10:00 und 22:00, dann würde der Zeitplan so aussehen: Abbildung 5: Beispiel eines Zeitplans Es dürfen Tage ausgelassen werden. Ebenfalls sind pro Tag beliebig viele Schaltungen möglich, nicht nur zwei wie im obigen Beispiel. Version 1.0.0.7 www.xblock.ch Seite 11/26
Bedienungsanleitung WiControlForUpcConnectBox 4.2. Raspberry Pi 3 anschliessen Zuerst kontrollieren, ob die SD-Karte auch wirklich gesteckt ist. Die SD-Karte befindet sich im Einschub auf der Hinterseite knapp oberhalb des Bodens (siehe 1 im Bild). Den USB-Stick, falls vorhanden, entfernen. Abbildung 6: Anschlüsse Rasperry Pi 3 Dann das beiliegende Ethernetkabel anschliessen, d.h. das eine Ende in die Buchse des Raspberry Pi 3 (siehe roter Rahmen 2 im Bild) und das andere Ende in die Connect Box auf der Rückseite in eine der gelben Buchsen stecken. Falls die Connect Box nicht läuft, diese jetzt einschalten und ca. 10 Minuten warten. Als nächstes den Mini-USB-Stecker des mitgelieferten Netzteils in die Buchse (siehe roter Rahmen 3 im Bild) stecken. Dann das Netzteil in die 230V-Steckdose stecken. Anschliessend fünf Minuten warten, bis WiControl bereit ist. Version 1.0.0.7 www.xblock.ch Seite 12/26
Bedienungsanleitung WiControlForUpcConnectBox 5. Bedienung Die Bedienung von WiControl ist simpel. Das WLAN kann über einen Zeitplan oder auf Verlangen des Benutzers gesteuert werden. 5.1. WLAN ausschalten Will der Benutzer das WLAN ausserplanmässig, d.h. sofort ausschalten, muss der USB-Stick einfach aus dem Raspberry Pi 3 entfernt werden. Ist der USB-Stick ausgesteckt, wird auch ein allfälliger Zeitplan deaktiviert und das WLAN bleibt ausgeschaltet. 5.2. WLAN einschalten Eingeschaltet wird das WLAN, indem der USB-Stick in den Raspberry Pi 3 eingesteckt wird (egal welcher Port, siehe roter Rahmen 4 auf Abbildung 6). Ein allfälliger Zeitplan, der auf dem USB-Stick hinterlegt wurde, wird aktiviert. Falls das WLAN via Zeitplan ausgeschaltet wurde (d.h. der USB-Stick ist gesteckt), den USB-Stick für 10 Sekunden entfernen und anschliessend wieder einstecken. Version 1.0.0.7 www.xblock.ch Seite 13/26
Bedienungsanleitung WiControlForUpcConnectBox 6. Fehlersuche Falls WiControl nicht wie erwartet funktioniert, kann die Ursache mehrere Gründe haben. In fast allen Fällen sind die Fehler in der Konfiguration zu finden. WiControl schreibt sämtliche Fehler und Ereignisse in eine Logdatei. Zusätzlich werden die Logeinträge auch über die HDMI-Schnittstelle (Bildschirm) ausgegeben. Die Fehlerbilder sind im Kapitel 6.3 ersichtlich und gelten für die Fehlersuche mit Monitor und mit PuTTY. 6.1. Fehlersuche mit Monitor Die Logausgaben können mit einem angeschlossenen Monitor verfolgt werden. Hierzu den Raspberry Pi 3 vom Strom trennen, den Monitor an das HDMI-Interface anschliessen und den Raspberry Pi 3 wieder mit dem Strom verbinden. Dann einige Sekunden warten. 6.2. Fehlersuche mit PuTTY Die zweite Möglichkeit die Logausgaben mitzulesen ist die Verwendung des Programmes «PuTTY». Um diese Variante zu nutzen, wird ein Computer benötigt, der mit der Connect Box über ein Netzwerkkabel verbunden ist. 6.2.1. PuTTY besorgen «PuTTY» ist ein Terminalprogramm, das gratis aus dem Internet heruntergeladen werden kann: http://www.putty.org/. Ich empfehle, den MSI-Installer zu verwenden. Version 1.0.0.7 www.xblock.ch Seite 14/26
Bedienungsanleitung WiControlForUpcConnectBox 6.2.2. IP-Adresse des Raspberry Pi 3 herausfinden Die IP-Adresse des Raspberry Pi 3 lässt sich über die Weboberfläche der Connect Box in Erfahrung bringen. Dazu muss ein Browser geöffnet und in der Adresszeile die IP-Adresse der Connect Box eingetragen werden (meistens http://192.168.0.1, siehe Schritt 1). Dann das Passwort eintragen (Schritt 2, siehe auch Kapitel 4.1.1.2) und anschliessend auf «Weiter» (Schritt 3) klicken: Abbildung 7: Anmeldung am Router Als nächstes auf «Verbundene Geräte» (Schritt 4) klicken: Abbildung 8: Willkommen-Seite Version 1.0.0.7 www.xblock.ch Seite 15/26
Bedienungsanleitung WiControlForUpcConnectBox Zuerst die Liste aktualisieren, d.h. auf den Knopf «Aktualisieren» (Schritt 5) klicken. Nun die IP-Adresse des Raspberry Pi 3 in der Liste suchen. Dazu in der Spalte «MAC- Adresse» eine Adresse suchen, die mit B8:27:EB beginnt. Rechts davon steht die IP-Adresse (6), die wir benötigen. In diesem Beispiel lautet die Adresse 192.168.0.17. Der Gerätename sollte «wicontrol» heissen: Abbildung 9: Liste der verbundenen Geräte Version 1.0.0.7 www.xblock.ch Seite 16/26
Bedienungsanleitung WiControlForUpcConnectBox 6.2.3. PuTTY starten Nun «PuTTY» starten und im Textfeld «Host Name (or IP address)» (Schritt 7) die IP-Adresse des Raspberry Pi 3 einsetzen. Dann auf den Knopf «Open» (Schritt 8) drücken: Abbildung 10: PuTTY Konfiguration Die Sicherheitsabfrage mit «Ja» (Schritt 9) bestätigen: Abbildung 11: Sicherheitsabfrage Version 1.0.0.7 www.xblock.ch Seite 17/26
Bedienungsanleitung WiControlForUpcConnectBox 6.2.4. Mit SSH anmelden Dann öffnet sich das Terminalfenster. Hier eingeben: login as=pi (Schritt 10) password=wicontrol0 (Schritt 11) Abbildung 12: SSH-Anmeldung Version 1.0.0.7 www.xblock.ch Seite 18/26
Bedienungsanleitung WiControlForUpcConnectBox 6.2.5. Logdatei anzeigen Anschliessend im Terminal folgenden Befehl eintippen (Schritt 12): tail -f -n +1 /tmp/wicontrol.log Abbildung 13: Anzeigen der Logeinträge Version 1.0.0.7 www.xblock.ch Seite 19/26
Bedienungsanleitung WiControlForUpcConnectBox 6.3. Fehlerbilder Viele Fehler werden von WiControl erkannt und auch entsprechend ausgewiesen. Mit den Logausgaben kann festgestellt werden, wo die Ursache liegt. Die untenstehenden Beispiele sind nicht vollzählig. Es werden nur die wichtigsten gezeigt. 6.3.1. Ungültige IP-Adresse Abbildung 14: Ungültige IP-Adresse Version 1.0.0.7 www.xblock.ch Seite 20/26
Bedienungsanleitung WiControlForUpcConnectBox 6.3.2. Leeres Passwort Abbildung 15: Leeres Passwort Version 1.0.0.7 www.xblock.ch Seite 21/26
Bedienungsanleitung WiControlForUpcConnectBox 6.3.3. Inkorrektes Passwort Bei diesem Beispiel wurde in der Konfiguration das Passwort falsch gesetzt. Das Fehlerbild sieht so aus: Abbildung 16: Inkorrektes Passwort Version 1.0.0.7 www.xblock.ch Seite 22/26
Bedienungsanleitung WiControlForUpcConnectBox 6.3.4. Fehler im Zeitplan Hier wurde im Zeitplan zweimal der gleiche Zeitstempel verwendet: Abbildung 17: Fehler im Zeitplan Version 1.0.0.7 www.xblock.ch Seite 23/26
Bedienungsanleitung WiControlForUpcConnectBox 6.3.5. Anmeldung am Router schlägt fehl Normalerweise ruft man die Weboberfläche des Routers auf, loggt sich ein und meldet sich anschliessend wieder ab. Wer sich aber nicht korrekt abmeldet, d.h. einfach den Browser schliesst, riskiert, dass eine erneute Anmeldung fehlschlägt. Die Connect Box lässt nämlich nur eine gewisse Anzahl aktiver Verbindungen zu. Die Logausgaben sehen in einem solchen Fall so aus: Abbildung 18: Anmeldung am Router funktioniert nicht Um das Problem aus der Welt zu schaffen, gibt es zwei Möglichkeiten: 15 bis 60 Minuten warten oder kurz die Stromversorgung des Routers unterbrechen (Neustart). Version 1.0.0.7 www.xblock.ch Seite 24/26
Bedienungsanleitung WiControlForUpcConnectBox 7. Häufig gestellte Fragen 7.1. Der Raspberry Pi 3 verfügt über Bluetooth und WLAN. Muss ich mit einer zusätzlichen elektromagnetischen Strahlung rechnen? Nein. Bluetooth und WLAN werden nicht verwendet und beide Funksignale wurden dauerhaft deaktiviert. 7.2. Wie hoch ist der Stromverbrauch des Raspberry Pi 3? Der Raspberry Pi 3 verbraucht sehr wenig Strom, ungefähr 3 Watt. 7.3. Muss ein Bildschirm am Raspberry Pi 3 angeschlossen werden? Nein, der Raspberry Pi 3 läuft ohne Bildschirm. 7.4. Kann WiControl auch das Wi-Free der UPC steuern? Nein. Das Wi-Free muss entweder über das My UPC Login deaktiviert oder via UPC- Support abgeschaltet werden. 7.5. Was passiert bei einem Stromausfall? Werden die Daten auf der SD-Karte nicht korrumpiert? Nein. Die Daten auf der SD-Karte werden bei einem Stromausfall oder plötzlichem Stromunterbruch nicht beschädigt. Der Grund ist, dass die SD-Karte nur lesend eingebunden wird. Version 1.0.0.7 www.xblock.ch Seite 25/26
Bedienungsanleitung WiControlForUpcConnectBox 8. Verzeichnisse 8.1. Abbildungsverzeichnis Abbildung 1: Dateien auf USB-Stick ................................................................... 5 Abbildung 2: Konfiguration der Zugangsdaten..................................................... 8 Abbildung 3: Verhalten des USB-Sticks .............................................................. 9 Abbildung 4: Auskommentierter Zeitplan.......................................................... 10 Abbildung 5: Beispiel eines Zeitplans ............................................................... 11 Abbildung 6: Anschlüsse Rasperry Pi 3 ............................................................. 12 Abbildung 7: Anmeldung am Router ................................................................ 15 Abbildung 8: Willkommen-Seite ...................................................................... 15 Abbildung 9: Liste der verbundenen Geräte ...................................................... 16 Abbildung 10: PuTTY Konfiguration .................................................................. 17 Abbildung 11: Sicherheitsabfrage .................................................................... 17 Abbildung 12: SSH-Anmeldung ....................................................................... 18 Abbildung 13: Anzeigen der Logeinträge .......................................................... 19 Abbildung 14: Ungültige IP-Adresse................................................................. 20 Abbildung 15: Leeres Passwort ....................................................................... 21 Abbildung 16: Inkorrektes Passwort ................................................................ 22 Abbildung 17: Fehler im Zeitplan ..................................................................... 23 Abbildung 18: Anmeldung am Router funktioniert nicht ...................................... 24 8.2. Tabellenverzeichnis Tabelle 1: Liste der Schlüssel ............................................................................ 6 Tabelle 2: Format der Schlüsselwerte ................................................................ 7 Tabelle 3: Beispiele von Schlüsseln.................................................................... 7 Version 1.0.0.7 www.xblock.ch Seite 26/26
Sie können auch lesen