Skip to content

Commit

Permalink
(bluefox) working on docs
Browse files Browse the repository at this point in the history
  • Loading branch information
GermanBluefox committed Mar 21, 2019
1 parent 27d4aa2 commit 0cb2c59
Show file tree
Hide file tree
Showing 69 changed files with 486 additions and 577 deletions.
5 changes: 0 additions & 5 deletions archive/news/news.en.md

This file was deleted.

5 changes: 0 additions & 5 deletions archive/news/news.ru.md

This file was deleted.

83 changes: 41 additions & 42 deletions archive/news/news.de.md → blog/de/2018_03_17.md
Original file line number Diff line number Diff line change
@@ -1,42 +1,41 @@
## 2018.03.17
### Ankündigung
Es wurde die neue Cloud-Adapter-Version vorbereitet.

Es ist wichtig, dass ALLE diese Version haben, wenn der Cloud-Server nächtes mal neu gestartet wird (in einer Woche).

Das ist gültig für iobroker.net und auch für iobroker.pro. Allerdings iobroker.pro wird nach ca. einer Woche nach iobroker.net upgedatet sein.

#### Was ist geändert
Cloud-Adapter unterstützt jetzt die Steuerungsbefehle vom Cloud-Server.

Es gibt 3 Arten von Cloud-Befehlen:

##### 1. "Redirect".
Da iobroker.net mit sehr vielen veralteten Clients belastet ist, kann jetzt Cloud-Server die neue Clients auf die neue Adresse 10557 umleiten und die alte Clients einfach zu machen.

Die alten Clients werden alten Server 10555 immer noch belasten, aber es wird ein spezieller schneller Server sein, der nichts macht, ausser die Versionen prüfen. Damit kann Cloud-Server ungefähr 30 Connections pro Sekunde (!) sparen.

Auch zukünftige Umzuge und Load-Ballancing wird damit möglich sein.

##### 2. "Stop".
Cloud-Server kann jetzt zu Clients, die nicht passende Version haben, "stop"-Befehl senden. Damit werden die Clients angehalten und werden den Server mit Anfragen nicht mehr belasten.

Client wird so lange disconnected, bis der nicht upgedated wird.

Leider ist noch das Befehl mit älteren < 2.5.0 Clients nicht unterstützt und deswegen muss man Trick mit Serverumzug machen.

Aber in der Zukunft wird dann es einfacher.

##### 3. "Wait".
Beim Start bekommt der Cloud-Server SEHR viele gleizeitige Verbindungsanfragen. Da Datenbank nicht so viele Anfragen gleichzeitig verarbeiten kann werden die Clients gebeten 60-90 Sekunden zu warten und es wird 500 oder 1000 Clients gleichzeitig angebunden.

So kann der Server in Ruhe alle Anfragen verarbeiten, sonst hat man ein "Schaukel-Effekt".

#### "Schaukel-Effekt"
Es werden viele Clients angebunden und der Server wird langsammer. Die Clients verliehren die Verbindung und fangen sofort wieder eine Verbindung aufzubauen zusätzlich zu alten. Dann Verdoppelt sich die Anzahl von Verbindungen bis der Server gar nichts machen kann. So ein Zustand kann bis zu 5 Stunden dauern.

## 2018.01.19
Neuegkeiten für 19 Januar

## 2018.01.11
Neuegkeiten für 11 Januar
---
Author: Homoran
imageSource: https://pixabay.com/photos/sky-clouds-atmosphere-air-oxygen-1441936/
---
![logo](images/2018_03_22.png)
# Cloud-Adapter-Version
## Ankündigung
Es wurde die neue Cloud-Adapter-Version vorbereitet.

Es ist wichtig, dass ALLE diese Version haben, wenn der Cloud-Server nächtes mal neu gestartet wird (in einer Woche).

Das ist gültig für iobroker.net und auch für iobroker.pro. Allerdings iobroker.pro wird nach ca. einer Woche nach iobroker.net upgedatet sein.

### Was ist geändert
Cloud-Adapter unterstützt jetzt die Steuerungsbefehle vom Cloud-Server.

Es gibt 3 Arten von Cloud-Befehlen:

#### 1. "Redirect".
Da iobroker.net mit sehr vielen veralteten Clients belastet ist, kann jetzt Cloud-Server die neue Clients auf die neue Adresse 10557 umleiten und die alte Clients einfach zu machen.

Die alten Clients werden alten Server 10555 immer noch belasten, aber es wird ein spezieller schneller Server sein, der nichts macht, ausser die Versionen prüfen. Damit kann Cloud-Server ungefähr 30 Connections pro Sekunde (!) sparen.

Auch zukünftige Umzuge und Load-Ballancing wird damit möglich sein.

#### 2. "Stop".
Cloud-Server kann jetzt zu Clients, die nicht passende Version haben, "stop"-Befehl senden. Damit werden die Clients angehalten und werden den Server mit Anfragen nicht mehr belasten.

Client wird so lange disconnected, bis der nicht upgedated wird.

Leider ist noch das Befehl mit älteren < 2.5.0 Clients nicht unterstützt und deswegen muss man Trick mit Serverumzug machen.

Aber in der Zukunft wird dann es einfacher.

#### 3. "Wait".
Beim Start bekommt der Cloud-Server SEHR viele gleizeitige Verbindungsanfragen. Da Datenbank nicht so viele Anfragen gleichzeitig verarbeiten kann werden die Clients gebeten 60-90 Sekunden zu warten und es wird 500 oder 1000 Clients gleichzeitig angebunden.

So kann der Server in Ruhe alle Anfragen verarbeiten, sonst hat man ein "Schaukel-Effekt".

### "Schaukel-Effekt"
Es werden viele Clients angebunden und der Server wird langsammer. Die Clients verliehren die Verbindung und fangen sofort wieder eine Verbindung aufzubauen zusätzlich zu alten. Dann Verdoppelt sich die Anzahl von Verbindungen bis der Server gar nichts machen kann. So ein Zustand kann bis zu 5 Stunden dauern.
Binary file added blog/images/2018_03_17.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
85 changes: 38 additions & 47 deletions docs/de/adapterref/iobroker.harmony/README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,6 @@
---
lastChanged: 20.07.2018
---
![Harmony](media/harmony.png)
# Logitech Harmony

Expand Down Expand Up @@ -67,8 +70,7 @@ Der Adapter findet automatisch alle Harmony Hubs, die sich im Subnetz des
ioBroker-Servers befinden.

### Fenster "Logitech Harmony adapter settings"
![Admin](media/a_harmony_admin_settings.png "Admin Oberfläche")<span style="color:grey">
*Admin Oberfläche*</span>
![Admin](media/a_harmony_admin_settings.png "Admin Oberfläche")

| Feld | Beschreibung |
|:-------------|:-------------|
Expand All @@ -85,8 +87,7 @@ verlassen. Dadurch efolgt im Anschluß ein Neustart des Adapters.
Die Installation des Adapters hat im Bereich `Objekte` eine aktive Instanz des
Logitech Harmony-Hub-Adapters angelegt.

![Instanz](media/a_harmony_instanz.png "Instanz")<span style="color:grey">
*Erste Instanz*</span>
![Instanz](media/a_harmony_instanz.png "Erste Instanz")

Auf einem ioBroker Server lässt sich immer nur eine Instanz des Logitech
Harmony-Adapters installieren.
Expand All @@ -101,32 +102,30 @@ Im Bereich `Objekte` werden in einer Baumstruktur alle vom Adapter im Hub
erkannten Geräte und Aktivitäten aufgelistet. Zusätzlich wird auch noch
darüber informiert, ob die Kommunikation mit dem Hub reibungslos erfolgt.

![Objekte](media/a_harmony_objekte.png "Harmony Objekte")<span style="color:grey">
*Objekte des Harmony-Adapters*</span>
![Objekte](media/a_harmony_objekte.png "Objekte des Harmony-Adapters")

Jeder Datenpunkt ist mit seinem zugehörigen Datentyp sowie seinen Berechtigungen aufgehführt.
Berechtigungen können lesend (R) sowie schreibend (W) sein. Jeder Datenpunkt kann mindestens gelesen (R) werden, während
andere ebenfalls beschrieben werden können. Zum auffinden eines bestimmten Datenpunkts empfiehlt sich die Suche mittels
der Tastenkombination "STRG + F".

Objekt | Zugriff | Bescheibung
:------|:-------:|:-----------
**harmony.0** | R | Name der ersten *Instanz* des Logitech Harmony-Adapters
&emsp;**Harmony Hub**| R | Name des *Hubs*
&emsp;&emsp;**Apple TV Generation 3**| R | Name eines *Geräts*, enthält Gerätefunktionen
&emsp;&emsp;**Denon AV-Empfänger**| R | Name eines *Geräts*, enthält Gerätefunktionen
&emsp;&emsp;**:**| R | Weitere *Geräte*
&emsp;&emsp;**activities**| R | Liste mit allen im Harmony Hub programmierten *Aktivitäten*
&emsp;&emsp;***hubBlocked***| R | Zeigt an, ob der Hub gerade beschäftigt ist
&emsp;&emsp;***hubConnected***| R | Status der Verbindung zwischen Adapter und Hub
| Objekt | Zugriff | Bescheibung|
|------|-------|-----------|
|**harmony.0** | R | Name der ersten *Instanz* des Logitech Harmony-Adapters|
|&emsp;**Harmony Hub**| R | Name des *Hubs*|
|&emsp;&emsp;**Apple TV Generation 3**| R | Name eines *Geräts*, enthält Gerätefunktionen|
|&emsp;&emsp;**Denon AV-Empfänger**| R | Name eines *Geräts*, enthält Gerätefunktionen|
|&emsp;&emsp;**:**| R | Weitere *Geräte*|
|&emsp;&emsp;**activities**| R | Liste mit allen im Harmony Hub programmierten *Aktivitäten*|
|&emsp;&emsp;***hubBlocked***| R | Zeigt an, ob der Hub gerade beschäftigt ist|
|&emsp;&emsp;***hubConnected***| R | Status der Verbindung zwischen Adapter und Hub|

### Gerätefunktionen
Öffnet man ein Gerät, so erhält man eine Liste mit allen zum Gerät gehörenden
Funktionalitäten. Diese Gerätefunktionen sind gerätespezifisch und unterscheiden sich
deshalb bei Geräten unterschiedlichen Typs.

![Gerät](media/a_harmony_geraet.png "Harmony Gerät")<span style="color:grey">
*Gerätefunktionen*</span>
![Gerät](media/a_harmony_geraet.png "Gerätefunktionen")

#### Auslösen einer Gerätefunktion
Jede Gerätefunktion `{Instanz}.{Hub Name}.{Gerät}.{Gerätefunktion}` löst eine
Expand All @@ -144,8 +143,7 @@ Nach dem Auslösen der Gerätefunktion ändert sich der Wert wieder auf 0.
Unterhalb von `activities`werden alle am Harmony Hub programmierten Aktivitäten
aufgelistet.

![Aktivitäten](media/a_harmony_activities.png "Aktivitäten")<span style="color:grey">
*Aktivitäten*</span>
![Aktivitäten](media/a_harmony_activities.png "Aktivitäten")

#### Starten einer Aktivität
Aktivitäten werden gestartet, wenn man bei einer Aktivität
Expand Down Expand Up @@ -175,8 +173,6 @@ an. Dabei bedeuten die Werte
Die Bedeutung der Werte ist analog zu
`{Instanz}.{Hub Name}.activities.currentStatus`.

<a name="deinstallation"/>

## Deinstallation
> T: Ich bin der Meinung, dass eine Standarddeinstallation eines Adapters in einem
zentralen Artikel ausführlich dokumentiert wird. Beim Adapter wird (immer)
Expand All @@ -202,9 +198,13 @@ Sollten die Installationsdateien vollständig von dem Host gelöscht werden, mus
in der Kachel des Harmony-Adapters in der Rubrik Adapter geschehen.

## Besonderheiten
Backup

Backup

Multihost

History

Performance

## FAQ
Expand Down Expand Up @@ -246,7 +246,7 @@ Performance
5-10 Minuten nach dem WLAN-Routerstart ein.

8. **Der HUB wird nicht gefunden.**

Prüfe nach, ob der Hub sich wirklich um gleichen Netzwerksubnetz und VLAN
wie der ioBroker-Server befindet. Sind Multicasts erlaubt oder werden diese
vom Router gefiltert? Leuchtet die Status-LED am Hub grün?
Expand All @@ -263,6 +263,7 @@ Performance
### JavaScript
Auslösen von Gerätefunktionen. Hier wird der Denon AV-Empfänger ein- oder ausgeschaltet,
wenn sich der Wert eines anderen Datenpunktes verändert.

```
if (getState("hm-rpc.0.MEQ01234567.2.STATE").val == true) {
setState("harmony.0.Harmony Hub.Denon AV-Empfänger.PowerOn"/*Denon AV-Empfänger:PowerOn*/, '1', true);
Expand All @@ -279,41 +280,31 @@ if (getState("hm-rpc.0.MEQ01234567.2.STATE").val == true) {
Auslösen von Gerätefunktionen. Hier wird der Denon AV-Empfänger ein- oder ausgeschaltet,
wenn sich der Wert eines anderen Datenpunktes verändert.

![Blockly](media/a_hamony_simple_blockly.jpg)
**Blockly**
![Blockly](media/a_hamony_simple_blockly.jpg "Blockly")

[Quelltext][blockly]
[Quelltext](media/a_harmony_blockly.xml)

### Node-Red
> zugehörige node-red-Elemente
> Beispiele
> Exporte zum Weiterverwenden
### vis
> zugehörige vis-Elemente
> Beispiele
> Exporte zum Weiterverwenden
> Code-Fragmente
> Beispiele
> Exporte zum Weiterverwenden
> Code-Fragmente
## Links
> Referenzen auf andere Dokumente im ioBroker-Portal
> Weblinks z.B. zum Hersteller
> GitHub-Links
* Herstellerseite https://www.logitech.com/de-de/product/harmony-hub (20.07.2018)

## Historie
> Der folgende Text dient nur als Platzhalter. Die Historie wird
vom Dokumentengenerator dynamisch erzeugt und hier eingefügt. Datenquelle
ist io-package.json -> common.news in der jeweiligen Doku-Sprache
| Version | Änderung |
|:-------:|:------------------------------------------|
|0.9.1 |Fix für problematische Zeichen |
|0.7.1 |Bug fixes |
|0.7.0 |Unterstützung für mehrere Hubs hinzugefügt |
|0.6.2 |falscher Port korrigiert |
|0.1.0 |Initialer commit |
> Weblinks z.B. zum Hersteller
> GitHub-Links
[logo]: https://badge.fury.io/js/svgo.svg "npm logo"
[blockly]: media/a_harmony_blockly.xml "Blockly"
* Herstellerseite [https://www.logitech.com/de-de/product/harmony-hub](https://www.logitech.com/de-de/product/harmony-hub)
119 changes: 0 additions & 119 deletions docs/de/adapterref/iobroker.harmony/en/README.md

This file was deleted.

Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading

0 comments on commit 0cb2c59

Please sign in to comment.