Giter Club home page Giter Club logo

eedomusscript_massswitch's Introduction

eedomus plugin : Mass Switch - Commutateur en masse

Nuki Logo

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

eedomusscript_massswitch's People

Contributors

nikya avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.