Skip to content

About

Plugin SimHub : déclenche des automatisations Home Assistant (webhooks) depuis une boîte à boutons, un volant ou un clavier

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Home Assistant — plugin SimHub

Déclenche des automatisations Home Assistant depuis n'importe quel bouton que SimHub sait lire : boîte à boutons, volant, clavier, manette, encodeur rotatif. Chaque bouton envoie un webhook à Home Assistant, qui fait le reste (allumer une lumière, changer sa luminosité, lancer une scène, etc.).

Exemple d'usage : un bouton de la boîte à boutons allume ou éteint la lumière du bureau, et un encodeur rotatif augmente ou baisse sa luminosité, sans quitter la course.

Installation

  1. Télécharge User.HomeAssistant.dll dans la dernière release.
  2. Ferme SimHub et copie la DLL dans le dossier de SimHub (souvent C:\Program Files (x86)\SimHub).
  3. Lance SimHub, accepte d'activer le plugin, puis ouvre Home Assistant dans le menu de gauche.

Mises à jour

À chaque démarrage de SimHub, le plugin compare sa version à la dernière release GitHub. S'il y a plus récent, un bandeau apparaît en haut de l'onglet Home Assistant : clique Installer, puis redémarre SimHub. Le fichier téléchargé est vérifié (SHA-256, nom, version) avant de remplacer l'ancien, et tes réglages sont conservés. Si SimHub est dans un dossier protégé, Windows demande l'autorisation administrateur.

Les versions 1.0.0 n'ont pas ce système : passe une fois en 1.1.0 à la main (étapes ci-dessus), la suite se fait depuis le bandeau.

Configuration

1. Créer l'automatisation dans Home Assistant

Une automatisation par action, avec un déclencheur Webhook.

Depuis l'interface : Paramètres → Automatisations et scènes → Créer une automatisation, déclencheur Webhook. Home Assistant propose un identifiant (webhook ID) ; tu peux le garder ou le remplacer. Dans les options du déclencheur, laisse POST coché et Uniquement local activé.

En YAML, l'exemple de la lumière du bureau :

# Bouton : allumer / éteindre
- alias: "SimHub - Toggle lumière bureau"
  triggers:
    - trigger: webhook
      webhook_id: "simhub_toggle_bureau"
      allowed_methods: [POST]
      local_only: true
  actions:
    - action: light.toggle
      target:
        entity_id: light.bureau

# Encodeur, sens horaire : +10 % de luminosité
- alias: "SimHub - Lumière bureau +"
  triggers:
    - trigger: webhook
      webhook_id: "simhub_bureau_plus"
      allowed_methods: [POST]
      local_only: true
  actions:
    - action: light.turn_on
      target:
        entity_id: light.bureau
      data:
        brightness_step_pct: 10

# Encodeur, sens anti-horaire : -10 % de luminosité
- alias: "SimHub - Lumière bureau -"
  triggers:
    - trigger: webhook
      webhook_id: "simhub_bureau_moins"
      allowed_methods: [POST]
      local_only: true
  actions:
    - action: light.turn_on
      target:
        entity_id: light.bureau
      data:
        brightness_step_pct: -10

Remplace light.bureau par l'entité de ta lumière. Le webhook ne demande pas de token : n'importe qui sur ton réseau qui connaît l'ID peut le déclencher, choisis donc des IDs pas trop évidents.

2. Renseigner les webhooks dans SimHub

Dans l'onglet Home Assistant de SimHub :

  1. Base URL : l'adresse de ton Home Assistant, par exemple http://homeassistant.local:8123 ou http://192.168.1.100:8123.
  2. Pour chaque ligne (12 au total) :
    • Actif : coche la case, sinon le bouton ne fait rien.
    • Label : un nom libre (affiché dans les logs et l'overlay).
    • Webhook ID ou URL : le webhook_id seul (simhub_toggle_bureau), le plugin construit alors <Base URL>/api/webhook/simhub_toggle_bureau. Une URL complète http://… ou https://… est aussi acceptée et utilisée telle quelle.
  3. Clique ▶ pour tester : la colonne Statut affiche OK ✓ si Home Assistant a répondu, sinon le code d'erreur.

Les réglages sont enregistrés à la fermeture de SimHub.

3. Mapper les boutons physiques

Dans SimHub → Controls and events, crée un mapping par bouton : choisis l'action HomeAssistantPlugin.HA_Button1 (… jusqu'à HA_Button12), puis appuie sur le bouton physique à associer.

Un encodeur rotatif apparaît dans SimHub comme deux boutons (un par sens de rotation) : mappe un sens sur la ligne « + » et l'autre sur la ligne « − ». Exemple :

Ligne Label Webhook ID Bouton physique
1 Lumière bureau simhub_toggle_bureau bouton de la boîte à boutons
2 Bureau + simhub_bureau_plus encodeur, sens horaire
3 Bureau − simhub_bureau_moins encodeur, sens anti-horaire

Référence

Élément Nom
Actions SimHub HA_Button1 à HA_Button12
Propriété (dashboards, overlays) HomeAssistantPlugin.LastTriggered : label du dernier bouton déclenché, pendant 5 secondes
Réglages PluginsData\Common\HomeAssistantPlugin.GeneralSettings.json dans le dossier SimHub

Chaque appui envoie un POST vide (délai max 5 s) sans bloquer SimHub. Les envois et leurs résultats apparaissent dans les logs SimHub, préfixés [HomeAssistant].

Dépannage

  • Rien ne se passe : vérifie que la ligne est cochée Actif et que le test ▶ répond OK ✓.
  • Erreur de nom ou de connexion : homeassistant.local ne se résout pas sur tous les réseaux, mets l'adresse IP.
  • OK ✓ mais l'automatisation ne se lance pas : Home Assistant répond 200 même pour un webhook ID inconnu. Vérifie l'ID (sensible à la casse) et que l'automatisation est activée ; sa trace dans Home Assistant montre si elle a été déclenchée.

Développement

plugin/                   plugin SimHub (C# 5, .NET Framework 4.8)
plugin/build.ps1          compile avec le MSBuild de Windows (-Deploy : copie dans SimHub)
release.ps1               publie une version sur GitHub
  • Aucun Visual Studio nécessaire : plugin\build.ps1 utilise le MSBuild livré avec Windows. Le chemin de SimHub vient de la variable d'environnement SIMHUB_INSTALL_PATH (avec un \ final).
  • .\build.ps1 -Deploy copie la DLL dans SimHub, qui doit être fermé.
  • Publier : .\release.ps1 -Version x.y.z -Notes "...". Les notes s'affichent en infobulle sur le bandeau de mise à jour.

About

Plugin SimHub : déclenche des automatisations Home Assistant (webhooks) depuis une boîte à boutons, un volant ou un clavier

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages