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.
- Télécharge
User.HomeAssistant.dlldans la dernière release. - Ferme SimHub et copie la DLL dans le dossier de SimHub (souvent
C:\Program Files (x86)\SimHub). - Lance SimHub, accepte d'activer le plugin, puis ouvre Home Assistant dans le menu de gauche.
À 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.
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: -10Remplace 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.
Dans l'onglet Home Assistant de SimHub :
- Base URL : l'adresse de ton Home Assistant, par exemple
http://homeassistant.local:8123ouhttp://192.168.1.100:8123. - 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_idseul (simhub_toggle_bureau), le plugin construit alors<Base URL>/api/webhook/simhub_toggle_bureau. Une URL complètehttp://…ouhttps://…est aussi acceptée et utilisée telle quelle.
- 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.
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 |
| É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].
- 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.localne se résout pas sur tous les réseaux, mets l'adresse IP. OK ✓mais l'automatisation ne se lance pas : Home Assistant répond200mê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.
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.ps1utilise le MSBuild livré avec Windows. Le chemin de SimHub vient de la variable d'environnementSIMHUB_INSTALL_PATH(avec un\final). .\build.ps1 -Deploycopie 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.