Skip to content

Commit

Permalink
v4.0.0-beta
Browse files Browse the repository at this point in the history
  • Loading branch information
jemu75 committed Dec 17, 2023
1 parent 1e60a48 commit 3fa21fb
Show file tree
Hide file tree
Showing 9 changed files with 65 additions and 42 deletions.
32 changes: 27 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,27 @@
> Achtung: Diese Version von **FHEMApp** ist noch nicht für den produktiven Einsatz geeignet. Aktuell steht diese Version nur zum Testen zur Verfügung!
# FHEMApp 4
**FHEMApp** ist eine webbasierende, grafische Benutzeroberfläche für FHEM. Das System unterstützt die optimale Darstellung auf verschiedenen Geräten wie Desktop-PCs, Tablets oder Smartphones. **FHEMApp** bietet eine Vielzahl von Einstellungen zur einfachen Erstellung von Benutzeroberflächen. Programmierkenntnisse sind für die Einrichtung nicht notwendig.
**FHEMApp** ist eine webbasierende, grafische Benutzeroberfläche für FHEM. Sie unterstützt die optimale Darstellung auf verschiedenen Geräten wie Desktop-PCs, Tablets oder Smartphones. **FHEMApp** bietet eine Vielzahl von Einstellungen ermöglicht die einfache Erstellung von Benutzeroberflächen. Programmierkenntnisse sind dabei nicht notwendig.
# Systemanforderungen
Für den Einsatz von **FHEMApp** wird FHEM(tm) (https://fhem.de/) benötigt.
Für den Einsatz von **FHEMApp** wird FHEM(tm) benötigt. Weitere Informationen zu FHEM findest du unter https://fhem.de/
# Installation und Updates
... Beschreibung in FHEM
Die Installation von **FHEMApp** kann direkt in FHEM erfolgen. Hierfür erstellt du in FHEM ein *fhemapp*-Device.

```
define myapp fhemapp fhemapp4
```
Das *fhemapp*-Device ist für das Laden und Speichern der Konfigurationsdaten von **FHEMApp** zuständig und dient zudem für die Installation und Updates von **FHEMApp**.

Bei der Installation wird automatisch ein neuer Ordner in deiner FHEM Installation unter *./opt/fhem/www/* erstellt. In diesem wird **FHEMApp** installiert. Weiterhin wird in deiner FHEM Installation unter *./opt/fhem/conf/* die Konfiguation abgelegt, die alle Einstellungen enthält. Für jedes *fhemapp*-Device wird dabei eine separate Konfigurationsdatei erstellt. Diese erthält den Name des *fhemapp*-Devices (z.B. *myapp*_config.fhemapp)

Updates von **FHEMApp** können ebenfalls direkt in FHEM ausgeführt werden.
```
set myapp update
```
> [!ATTENTION]
> Beschreibung mit Benni abstimmen!
# Instanzen
In FHEM können beliebig viele Devices vom Typ *fhemapp* definiert werden. Hinter jedem *fhemapp*-Device wird eine separate KKonfiguration gespeichert. Dies ermöglicht die Betrieb von mehreren **FHEMApp**-Instanzen. Beim Aufruf von **FHEMApp** kann dann auf die jeweilige Instanz verwiesen.
In FHEM können mehrere *fhemapp*-Devices definiert werden. Hinter jedem Device wird eine separate Konfiguration gespeichert. Dies ermöglicht die Betrieb von beliebig vielen **FHEMApp**-Instanzen. Beim Aufruf von **FHEMApp** kann dann auf die jeweilige Instanz verwiesen.
# Aufruf der App
Der Aufruf von **FHEMApp** erfolgt über einen Web-Browser. Am Ende der URL wird jeweils der Name des *fhemapp*-Device aus FHEM angegeben. Dessen Konfiguration wird beim Aufruf von **FHEMApp** verwendet. Bei der Installation in FHEM erfolgt der Aufruf nach folgendem Schema:
```
Expand All @@ -35,7 +49,15 @@ Zum Aufruf von **FHEMApp** können optionale URL-Parameter verwendet werden. Die
|xhr|Umschaltung auf Longpoll wenn Browser kein websocket unterstützt|1|
|loglevel|Detailgrad der Protokollierung für Fehleranalyse über die Browserkonsole (*1=status, 2=error, 3=warnings, 4=infos, 5=all request to fhem, 6=received events from fhem, 7=details, 8=all received events from FHEM*)|1...8|
# Einstellungen
...
**FHEMApp** ist in drei wesentliche Bereiche untergliedert, welche individuell konfiguriert werden können.
* die **Kopfzeile** im oberen Bereich
* die **Navigationsleiste** auf der linken Seite
* den Anzeigebereich für die **Panels**

Der Zugriff auf die Einstellungen von **FHEMApp** ist im standardmäßig ausgeblendet, damit die Konfiguration nicht von jedem Benutzer verändert werden kann. Zu den Einstellungen gelangt man durch Angabe der Route `settings` in der URL
```
http://fhem:8083/fhem/fhemapp4/index.html#/myapp/settings
```
# Kopfzeile
...
## Optionsmenü
Expand Down
1 change: 1 addition & 0 deletions src/stores/fhem.js
Original file line number Diff line number Diff line change
Expand Up @@ -834,6 +834,7 @@ export const useFhemStore = defineStore('fhem', () => {
if(!res) {
log(3, 'FHEMApp launching failed.')
} else {
app.message = false
log(1, 'FHEMApp launched.', app)
}

Expand Down

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading

0 comments on commit 3fa21fb

Please sign in to comment.