eedomus plugin : Mass Switch - Commutateur en masse

• Plugin version : 1.0
• Origine : GitHub/Nikya/massSwitch

Description

Nikya eedomus plugin Mass Switch est un plugin pour la box domotique eedomus.
Il permet de commuter en masse simultanément plusieurs équipements vers des valeurs souhaitées.
La principale force de ce script est que les actions sont réalisées de façon intelligente : que si nécessaire, afin de ne pas surcharger la box.

Cas d'utilisation

• Atteindre toutes les lumières restées allumées en quittant la maison
  • Commute vers Off seulement les lumières nécessaires.
• Allumer simultanément plusieurs équipements
  • Commute vers On seulement les lumières nécessaires.
• Entre-ouvrir simultanément plusieurs volets
  • Commute vers une valeur souhaitée seulement les volets qui ne sont pas déjà dans la bonne position.

Installation via store

Depuis le portail eedomus, cliquez sur

• Configuration
• Ajouter ou supprimer un périphérique
• Store eedomus
• puis sélectionner Commutateur en masse

Des informations seront demandées pour la création du plugin.
Voir le paragraphe valeurs pour plus d'informations.

Utilisation

Par défaut, le plugin génère un actionneur http avec différentes combinaisons :

• Masse Off : Positionne à 0 les périphériques listés dans VAR1

• Masse On : Positionne à 100 les périphériques listés dans VAR2

• Masse valeur : Positionne à la valeur souhaitée les périphériques listés dans VAR3

• Variante intelligente : N'exécute l'action que si nécessaire (si n'est pas déjà dans l'état demandé)

• Variante forcée : Execute systématiquement l'action

Installation manuelle

1. Télécharger le projet sur GitHub : GitHub/Nikya/massSwitch
2. Uploader le fichier dist/massSwitch.php sur la box (Doc eedomus script)
3. Créer manuellement un actionneur http avec des appels vers ce script en renseignant les paramètres souhaités.

Exemple d'URL :

https://localhost/script/?exec=massSwitch.php&toOn=123,456&toOff=147,258&toVal=159:20,753:70&force=true

Tous les paramètres son optionels.
Voir le paragraphe valeurs pour plus d'informations.
Le paramètre force=true oblige l'exécution de l'action (le script n'est plus en mode intelligent) Le paramètre force=true oblige l'exécution de l'action (le script n'est plus en mode intelligent)

Valeurs

• toOff : Liste de periphId à positionner à Off (0), séparés par des virgules
  • Une installation via le store place ces valeurs dans le champ VAR1
  • Exemple : 123456,789456,159753
• toOn : Liste de periphId à positionner à On (100), séparés par des virgules
  • Une installation via le store place ces valeurs dans le champ VAR2
  • Exemple : 123456,789456,159753
• toVal : Liste de periphId à positionner à la valeur souhaitée, chacun suivi d'un : puis de la valeur souhaité et le tout séparés par des virgules
  • Une installation via le store place ces valeurs dans le champ VAR3
  • Exemple : 123456:20,789456:50,159753:70

Résultat

A titre d'information, l'appel de ce script répond par un XML servant de compte rendu d'éxecution (utile pour debugger si besoin).
Les XPath suivants sont diponibles :

• /root/params/ToOffCount : Nombre de périphérique trouvés à mettre off
• /root/params/ToOnCount : Nombre de périphérique trouvés à mettre on
• /root/params/ToValCount : Nombre de périphérique trouvés à mettre à la valeur souhaitée
• /root/params/force : Indicateur de forcer ou non les exécutions
• /root/results/exe_msg_fr : Phrase de compte rendu d'éxecution en Français
• /root/results/exe_msg_en : Phrase de compte rendu d'éxecution en Anglais
• /root/results/exeCount : Nombre d'exécution effectivement réalisées
• /root/results/executions : Détails des exécutions réalisées au format pid+val

Aide suplémentaire

Voir le forum : Forum eedomus/Mass Switch