smartVISU
09:39 v3.3.1

Grundlagen - Config-Seite

Über den letzten Button (Zahnräder) im horizontalen Menu von smartVISU gelangt man ins Systemmenü. Der erste Menüpunkt dort führt zur Config-Seite. Diese Seite stellt zentral alle Einstellungsmöglichkeiten zur Verfügung.

Das Menü verfügt über 3 Reiter: 'Global', 'Seite' und 'Gerät'. Die Einstelloptionen sind immer gleich, werden aber unterschiedlich abgespeichert:
  • global: config.ini im Root-Verzeichnis der Smartvisu
  • Seite: config.ini im Root-Verzeichnis der eingestellten Seiten.
  • Gerät: Cookie auf dem jeweiligen Gerät.

    • Die Menüs sind in verschiedene Sprachen übersetzt und verfügen über Hilfetexte zu den einzelnen Einstellungen.

    Interface / Benutzeroberfläche:

    Ist zuständig für die "Optik" der Visu. Es kann neben den einzelnen Pages auch das Design gewählt werden.
    • Seiten = Auswahlmöglichkeit für die individuelle Visu im 'pages'-Verzeichnis
    • Design = Auswahlmöglichkeit für die verschiedenen Design-Stile der Visu
    • Titel = Eingabefeld für einen individuellen Namen, der dann u.a. in der Browserleiste angezeigt wird
    • Sprache = Auswahlmöglichkeit für die Sprache
    • Cache = Einschalten des Seitenspeichers, um kürzere Ladezeiten zu erreichen. (empfohlen = on)
      Die Option wird nur dann angezeigt, wenn das Cache-Verzeichnis schreibbar ist. Während der Entwicklung neuer Seiten sollte der Cache ausgeschaltet sein, da sonst die Änderungen nicht angezeigt werden.
    • Leeren = der Cache wird gelöscht. Bestätigung über eine grüne Meldung in er oberen rechten Ecke.

    User Interface

    General Settings

    help
    Defines which of the pages in the ./pages folder is displayed by default.
    help
    Defines the look and feel.
    help
    Page title in the browser tab.
    help
    Sets the language to be used by smartVISU.
    Further translations are appreciated!
    Note: Not all widgets are multi-lingual.
    help
    Are pages to be cached for faster loading? The cache needs to be cleared to apply page changes (=switch off for pages under development).

    Behaviour

    help
    Use animation between pages.
    help
    Seconds of inactivity until home page is shown.
    Set to 0 to disable returning automatically.
    help
    Which time to be used by clock widgets?
    client = time of your device
    server = smartVISU server time
    help
    Timezone of the server's location (!)

    Unter "Verhalten" gibt es folgende Einstellmöglichkeiten:
    • Animation = Auswahlmöglichkeit um einige Elemente wie z.B. das Einblenden der Telefonliste animiert darzustellen (empfohlen = on)
    • auto. Rückkehr = Hier kann die Zeit eingestellt werden, nach der die Anzeige zur Startseite zurückkehrt.
    • Zeitquelle = Auswahlmöglichkeit, ob die Uhrzeit vom Server oder vom Anzeigegerät (client) verwendet wird.
    • Zeitzone = Auswahlmöglichkeit für die lokale Zeitzone.

    SmartHome / IoT-Datenquelle

    Hier legt man die Schnittstelle zum Backend fest. Die Standardeinstellungen für die Backends werden aus den jeweiligen io-Treibern entnommen und müssen - außer bei der IP-Adresse - in der Regel nicht angepasst werden. Bei Host/IP wird die IP-Adresse des Smarthome-Systems eingetragen. Im Fall eines Raspberry PI mit SmartHomeNG ist das die IP-Adresse des Raspberry Pi. eingetragen werden.
    • System = SmartHome System am Backend (empfohlen = SmartHomeNG)
    • Host/IP = Verbindung zum Backend (empfohlen = IP des Raspberry Pi)
    • Port = Port zur Verbindung mit Backend (empfohlen = Standard Port von SmartHomeNG = 2424)
    • TLS-Port = Port zur verschlüsselten Verbindung mit Backend (empfohlen = Standard TLS-Port von SmartHomeNG = 2425)
    • Realtime = Echtzeit (empfohlen = on)
    • Reconnect = Verbindungen zum Backend automatisch wiederherstellen, z.B. wenn Browser Tab im Hintergrund war (empfohlen = on)
    • Reverse Proxy = Löscht IP-Adresse und Port, wenn der Server als Reverse Proxy betrieben wird.
    Der in v3.2 eingeführte neue Treiber für smarthomeNG ("smarthomenNG new") verbessert die Erkennung der bestehenden Verbindung und benötigt deshalb die Option "Reverse Proxy" nicht mehr. Wird die Visu allerdings nicht über die IP-Adresse aufgerufen, sondern über einen Hostnamen, dann muss dieser Hostname zwingend im Abschnitt "smartVISU Hostname / Proxy Server" eingegeben werden!

    SmartHome/IoT data source

    Data connection / driver

    help
    Which system gathers the data?
    help
    Host name or IP address the system can be reached at (e.g. 192.168.1.2)
    If left empty hostname of HTTP request will be used in most systems.
    help
    The port the system can be reached at, e.g.:
    1028 - LinKNX
    2121 - FHEM
    2424 - smartHomeNG
    If left empty the port of HTTP request will be used in most systems.
    help
    The port for TLS-encrypted communication, e.g. 2425 with smartHomeNG. The driver uses this port if the visu page is called via HTTPS.
    help
    Observe system online for data changes?
    help
    Automatically reconnect in case of a connection drop?
    help
    If the server is configured as reverse proxy the fields for IP address and port must be empty

    Console


    help
    The port the console can be reached at, e.g.:
    8101 - OpenHAB
    help
    The username for authentication on the console.
    help
    The password to the username.
    ATTENTION: The password is saved unencrypted in config.ini.

    Authentication / Security


    help
    Activate for encrypted communication with the server and, if necessary, adjust the port settings to the SSL port, if different from 443.
    Recommended when using authentication with a password.
    ATTENTION: The server's certificate must be trustworthy on the client, otherwise the connection is refused.
    help
    The username or API token for authentication on the server.
    help
    The password for the username. Usually empty when using an API token.
    ATTENTION: The password is saved unencrypted in config.ini and if SSL is not activated it is also transmitted unencrypted to the server.

    smartVISU Host Name / Proxy Server


    help
    If smartVISU gets called with its host name in the internal net,
    e.g. as smartVISU.local, the host name must be entered here. (optional if IP address is being used)
    help
    Activate this setting if the smartVISU server is connecting to the Internet through a proxy server.
    help
    The address of the proxy server.
    help
    The user name for login to the proxy server.
    help
    The password for login to the proxy server.

    Weitere Optionen, wie Authentifizierung oder Konsolen-Zugriff werden passend zum ausgewählten Backend angeboten. Unter "Proxy-Server" werden die Adresse und die Zugangsdaten eines Proxy-Servers eingetragen.

    Andere Datenquellen:

    Hier kann man verschiedene Online-Wetterdienste auslesen. In der Regel wird ein "API-Key" benötigt, für den man sich beim Anbieter registrieren muss. Lediglich Yr.no benötigt keinen API-Key.
    • Anbieter = Internet Wetterservice
    • Location = Ort, für den das Wetter abfragt werden soll (empfohlen = Wohnort)
    • Key = Anmeldekey für den Service (kann bei Yr.no leer bleiben)

    Other Data Sources

    Weather

    help
    Name of the weather service.
    help
    Your location in the format of your weather service
    (e.g. Germany/Bayern/Würzburg/)
    or your Wunderground station code
    help
    Your key / password if you are a registered user of the service (required by some services, otherwise number of requests per hour / day may be limited).

    Phone

    help
    The driver to be used for your phone system.
    help
    Host name or IP address to acccess your phone system (e.g. 192.168.1.1)
    help
    The port to access your phone system (if required).
    help
    The user name for logging in to your phone system (e.g. admin).
    help
    The password for logging in to your phone system.

    Calendar

    help
    The driver to be used for your calendar service.
    help
    The address for connecting to your calendar service.
    For ICS/iCal, you can add more than one URL, separated by whitespace.
    help
    The user name to be used for login at the calendar provider (if required).
    help
    The password to be used for login at the calendar provider (if required).
    help
    One or more calendar names to be read (separated by comma, e.g. calendar1,calendar2)
    help
    Default colors for the above calendar(s), in the same order.
    help
    Authorize Google Data Access
    Authorize

    Unter "Telefon" können Services für unterschiedliche Telefonanlagen ausgewählt werden, um Anruflisten anzeigen zu lassen. Hierzu werden IP-Adresse und ggfls. Port der Anlage benötigt, sowie die Zugangsdaten (Username und Passwort). Erfordert eine Anlage keine Zugangsdaten, so sind diese Felder leer zu lassen.

    Unter "Kalender" können Kalenderdienste zur Anzeige von Ereignissen konfiguriert werden. Dies können Internet-Dienste sein, oder CLoud-Lösungen z.B. auf einem eigenen NAS. Je nach Service werden die Internet-Adresse (URL) und die Zugangsdaten (Username und Passwort) benötigt. Im Feld Kalender kann man einzelne Kalendernamen spezifizieren (mit Komma getrennt). Bleibt das Feld leer, werden alle im Service verfügbaren Kalender ausgelesen.
    Den benannten Kalendern können Farben zugewiesen werden. Diese sind ebenfalls durch Komma zu trennen.

    Optionen:

    Hier werden zusätzliche Optionen ausgwählt:
    • Updateprüfung: wenn dies aktiviert ist, sucht smartVISU regelmäßig nach Updates und meldet dies im Mitteilungsbereich oben rechts (empfohlen = on).

    Options

    Check for updates

    help
    Look on smartvisu.de and github for a newer version.

    Speichern:

    Die Einstellungen müssen durch Klick auf die "Speichern"-Taste gesichert werden. Der Erfolg des Vorgangs wird durch ein grünes Dreieck oben rechts im Mitteilungsbereich rückgemeldet. Zudem lädt smartVISU die aktuelle Seite neu. Bitte nach Änderungen nicht vergessen, den Seiten-Cache zu löschem (siehe oben)!