mirror of https://github.com/YunoHost-Apps/domoticz_ynh.git synced 2024-09-03 18:26:17 +02:00

yunohost-bot d982b77acf Auto-update README

2022-05-26 07:35:27 +00:00

7.8 KiB

Raw Blame History

Domoticz pour YunoHost

Ce package vous permet d'installer Domoticz rapidement et simplement sur un serveur YunoHost. Si vous n'avez pas YunoHost, regardez ici pour savoir comment l'installer et en profiter.

Vue d'ensemble

Logiciel open sources et gratuit de domotique qui vous permet de configurer un grand nombre d'appareils

Version incluse : 2020.2~ynh4

Avertissements / informations importantes

Domoticz est un système de domotique permettant de controler différents objets et de recevoir des données de divers senseurs Il peut par exemple être utilisé avec :

des interrupteurs
des senseurs de portes
des sonnettes d'entrées
des systèmes de sécurité
des stations météo pour les UV, la pluie, le vent...
des sondes de températures
des sondes d'impulsions
des voltmètres
Et bien d'autres

Version incluse : Toujours la dernière version stable. La dernière version compilée est récupérée dans ce répertoire lors de l'installation. Une fois installée, les mises à jour de l'application sont gérées depuis les menus de l'application elle même. Le script de mise à jour Yunohost mettra uniquement à jour de nouvelles version du package.

Le broker MQTT mosquitto est intégré au package et nécessite un sous-domaine ou un domaine distinct. Il est optionnel et si vous indiquez lors de l'installation le même domaine que le domaine principal, il ne sera pas installé.

Configuration

Broker MQTT Mosquitto

A l'installation, un broker MQTT, Mosquitto, est installé en même temps que Domoticz. La version installée est celle du dépot officiel du projet, et non des dépots Debian. Ce broker nécessite un domaine ou un sous-domaine particulier pour fonctionner (ex : mqtt.your.domain.tld) : il est nécessaire de créer ce domaine auparavant.

####Utilisation

Pour pouvoir l'utiliser, vous devez paramétrer la communication avec entre domoticz et le broker en suivant la documentation de domoticz dans la partie Add hardware "MQTT Client Gateway" Les users et mot de passe du broker sont automatiquement générés lors de l'installation. Vous pouvez les récupérer en tapant

sudo yunohost app setting domoticz mqtt_user
sudo yunohost app setting domoticz mqtt_pwd

Vous pouvez ensuite publier sur ce serveur en utilisant la syntaxe:

mosquitto_pub -u *user* -P *password* -h mqtt.your.domain.tld -p 443 -t 'domoticz/in' -m '{ "idx" : 1, "nvalue" : 0, "svalue" : "25.0" }'

De la même manière, vous pouvez suivre ce qu'il se passe avec

mosquitto_sub -u *user* -P *password* -h mqtt.your.domain.tld -p 443 -t 'domoticz/out'

####Mise à jour depuis les versions n'ayant pas mosquitto Si vous êtes sur le package ynh3 ou inférieur, mosquitto n'est pas installé par défaut. De même si vous avez choisi de ne pas indiquer de domaine pour mosquitto lors de l'installation initiale. Pour pouvoir l'installer après coup, faites les actions suivantes:

créez un domaine ou sous-domaine pour recevoir les informations (par exemple : 'mqtt.your.domain.tld')
connecter vous en ligne de commande à votre serveur
taper la commande suivante : yunohost app setting domoticz mqtt_domain -v mqtt.your.domain.tld
Procédez à la mise à jour. Si vous êtes déjà sur la dernière version, utiliser la commmande suivante : yunohost app upgrade domoticz --force

Senseurs, langue et ce genre de choses

Toute la configuration de l'application a lieu dans l'application elle même

Accès et API

Par défaut, l'accès aux API JSON est autorisé sur cette URL /votredomaine.tld/api_/chemindedomoticz. Donc, si vous accédez à domoticz par https://votredomaine.tld/domoticz, utilisez le chemin suivant pour l'api: /votredomaine.tld/api_/domoticz/json.htm?votrecommandeapi

Par défaut, seuls la mise à jour de senseur et les interrupteurs sont autorisés. Pour autoriser une nouvelle commande, vous devez (pour l'instant) manuellement éditer le fichier de configuration nginx :

sudo nano /etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf

Puis éditer le bloc suivant en y ajoutant le regex de la commmande à autoriser :

  #set the list of authorized json command here in regex format
  #you may retrieve the command from https://www.domoticz.com/wiki/Domoticz_API/JSON_URL's
  #By default, sensors updates and toggle switch are authorized
  if ( $args ~* type=command&param=udevice&idx=[0-9]*&nvalue=[0-9]*&svalue=.*$|type=command&param=switchlight&idx=[0-9]*&switchcmd=Toggle$) {
    set $api "1";
    }

Par exemple, pour ajouter la commmande json pour retrouver le statut d'un équipement (/json.htm?type=devices&rid=IDX),il faut modifier la ligne comme ceci:

  #set the list of authorized json command here in regex format
  #you may retrieve the command from https://www.domoticz.com/wiki/Domoticz_API/JSON_URL's
  #By default, sensors updates and toggle switch are authorized
  if ( $args ~* type=command&param=udevice&idx=[0-9]*&nvalue=[0-9]*&svalue=.*$|type=command&param=switchlight&idx=[0-9]*&switchcmd=Toggle$|type=devices&rid=[0-9]* ) {
    set $api "1";
    }

Toutes les adresses IPv4 du réseau local (192.168.0.0/24) et toutes les adresses IPv6 sont autorisées pour l'API. A ma connaissance, il n'y a pas moyen d'effectuer un filtre pour les adresses IPv6 sur le réseau local, vous pouvez donc retirer leur autorisation en enlevant ou en commentant la ligne suivante dans /etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf:

allow ::/1;

Ceci autorisera seulement les adresses IPv4 local a accéder aux API de domoticz. Vous pouvez ajouter des adresses IPv6 de la même façon.

Limitations

Pas de gestion d'utilisateurs ni d'intégration LDAP. L'application ne prévoit pas de gérer les utilisateurs par LDAP, donc le package non plus.
Un backup ne peut pas être restauré sur un type de machine différente de celle d'origine (x86, arm...) car les sources compilées doivent être différentes

Documentations et ressources

Site officiel de l'app : https://domoticz.com/
Documentation officielle utilisateur : https://www.domoticz.com/DomoticzManual.pdf
Documentation officielle de l'admin : https://www.domoticz.com/wiki/Main_Page
Dépôt de code officiel de l'app : https://github.com/domoticz/domoticz
Documentation YunoHost pour cette app : https://yunohost.org/app_domoticz
Signaler un bug : https://github.com/YunoHost-Apps/domoticz_ynh/issues

Informations pour les développeurs

Merci de faire vos pull request sur la branche testing.

Pour essayer la branche testing, procédez comme suit.

sudo yunohost app install https://github.com/YunoHost-Apps/domoticz_ynh/tree/testing --debug
ou
sudo yunohost app upgrade domoticz -u https://github.com/YunoHost-Apps/domoticz_ynh/tree/testing --debug

Plus d'infos sur le packaging d'applications : https://yunohost.org/packaging_apps

7.8 KiB Raw Blame History