Skip to content

Latest commit

 

History

History
130 lines (79 loc) · 5.37 KB

Plugin_Mise-a-jour.md

File metadata and controls

130 lines (79 loc) · 5.37 KB

Les mises à jour et les branches

Mettre à jour le Plugin

Le Plugin est régulièrement mis à jour que ce soit pour de la correction de bug ou l'ajout de nouvelle fonctionnalités.

Procédure

ATTENTION: si vous n'etes pas encore en Version 6, merci de suivre cette procédure de mise à jour vers la version 6

  • Ouvrir un terminal et aller jusqu'au répertoire du Plugin ZigBeeForDomoticZ (généralement c'est '/home/pi/domoticz/plugins/Domoticz-Zigbee')

  • Lancer la commande git submodule update --init --recursive

Note : Depuis la version 6, le git pull n'est plus suffisant.

Les informations de mise à jour sont affichées comme dans l'exemple ci-dessous :

Mise à jour

  • Exécuter ensuite : sudo chmod +x plugin.py

  • Redémarrer DomoticZ

En cas d'erreurs

Il peut y avoir des fichiers dont les droits ont changés. Dans ce cas, faire les commandes suivantes :

  git reset --hard
  git pull --force

Les branches de mise à jour

Le Plugin évolue en permanence suite à la correction de bug, l'amélioration du Plugin ou l'ajout de nouveaux objets. Afin d'éviter un maximum de bug, le code du Plugin est disponible sous différents canaux de mise à jour.

Au fur et à mesure des évolutions de DomoticZ, le Plugin se doit d'évoluer et, malheureusement, il n'est pas possible de conserver une compatibilité du Plugin avec toutes les versions antérieurs de DomoticZ. C'est pourquoi à partir de la version 5 (mai 2021), une branche stable5 est crée pour conserver la branche stable compatible avec les anciennes versions.

Les différentes branches sont :

stable6 (créée en avril 2022)

C'est la branche par défaut actuelle. C'est la version qui a ouvert le plugin aux coordinateurs TI CCXXXX, Sonoff, Elelabs, ZNP.

Info Compatibilité
Coordinateurs ZiGate V1 et V2
ELElabs
ZZH
Sonoff
TI CCXXXX
Compatibilité minimale DomoticZ 2021.1
Compatibilité maximale Dernière version de DomoticZ

Note : Le passage à la stable6 nécessite une procédure particulière : voir la page Migration vers version 6.

beta6/dev (créée en avril 2022)

La branche béta6 est le canal de développement. Ne passez pas sur la branche beta6/dev sans y avoir été invité.

Si vous êtes sur la branche beta6/dev (suite à l'ajout d'un nouveau matériel par exemple), vous pouvez repasser sur la branche stable6/dev à la prochaine mise à jour du canal stable6.

Info Compatibilité
Coordinateurs idem stable6
Compatibilité minimale DomoticZ 2021.1
Compatibilité maximale Dernière version de DomoticZ

stable5 (créée en mai 2021)

C'est la version qui a ajouté la compatibilité avec la ZiGate+ (V2).

Info Compatibilité
Modèles de ZiGate V1 et V2
Compatibilité minimale DomoticZ 2020.1
Compatibilité maximale DomoticZ 2022.1

Cette version ne recevra plus de mise à jour.

Note : Le passage à la stable5 nécessite un redémarrage de DomoticZ et de renseigner des nouveaux paramètres dans le Paramétrage du plugin sinon, vous aurez une erreur de communication au lancement du Plugin.

stable

C'était la version par défaut jusqu'au moment de la sortie de la ZiGate V2. Sa compatibilité s'arrête avec DomoticZ 2020.2.

Info Compatibilité
Modèles de ZiGate V1
Compatibilité minimale DomoticZ 4.XXX
Compatibilité maximale DomoticZ 2020.2

Cette version ne recevra plus de mise à jour.

dev

La branche dev est le canal de développement. Ne passez pas sur la branche dev sans y avoir été invité.

Si vous êtes sur la branche dev (suite à l'ajout d'un nouveau matériel par exemple), vous pouvez repasser sur la branche stableX à la prochaine mise à jour du canal stableX.

Info Compatibilité
Modèles de ZiGate V1 et V2
Compatibilité minimale DomoticZ 2020.1
Compatibilité maximale Dernière version de DomoticZ

Cette version ne recevra plus de mise à jour.

Connaître sa branche

  • Ouvrir un terminal et aller jusqu'au répertoire du Plugin ZigBeeForDomoticZ (généralement c'est '/home/pi/domoticz/plugins/Domoticz-Zigate')
  • Lancer la commande git status

Passer d'une branche à l'autre

Il est recommandé des faire une sauvegarde avant de faire des modifications afin de pouvoir revenir en arrière en cas de problèmes.

  • Ouvrir un terminal et aller jusqu'au répertoire du Plugin ZigBeeForDomoticZ (généralement c'est '/home/pi/domoticz/plugins/Domoticz-Zigate')

  • Lancer la commande git pull

  • Lancer la commande git checkout stable6 pour aller sur le canal stable6

  • Lancer la commande git checkout dev pour aller sur le canal de developement

Attention aux compatibilités avec DomoticZ lors du changement de branche.

Poursuivre sur la mise à jour du Plugin

Revenir à une version précédente

En cas de gros soucis avec une nouvelle version, il est possible de revenir en arrière en utilisant la commande git checkout beta-5.2.XXX en remplaçant beta et 5.2.XXX par les valeurs souhaitées.