Assistance

C’est un projet d’une seule personne. Cela veut dire que vous aurez une vraie réponse de quelqu’un qui connaît le code, et que cela peut prendre quelques jours.

Est-ce vous, ou est-ce nous ?

Les services partagés disposent d’une page d’état publique : le service d’alertes cloud, ce site et le bridge de démonstration. Aucune connexion requise. Trente secondes bien employées avant toute autre chose : elles distinguent « un service est en panne » de « ma configuration a un problème », et les suites à donner n’ont rien à voir.

Votre propre bridge n’y figure pas, et ne peut pas y figurer : il tourne sur votre matériel, sur votre réseau. Vérifiez celui-là avec curl -s http://<hôte-du-bridge>:8787/healthz.

Avant d’écrire

La FAQ couvre ce sur quoi on bute le plus : la porte qui n’est pas trouvée, le relais qui semble basculer, Bonjour qui ne découvre pas le bridge, et ce qui fonctionne à distance. Deux minutes bien employées.

Comment nous joindre

Par e-mail : support@garageopener.app. Les bugs et les questions d’installation sont aussi les bienvenus en issues et discussions GitHub sur le dépôt du bridge, généralement la voie la plus rapide.

Quoi joindre

Presque toutes les questions se ramènent à ces cinq éléments. Les envoyer d’emblée transforme généralement trois échanges en un seul :

Ce que le bridge dit de lui-même. La sortie de curl -s http://<hôte-du-bridge>:8787/healthz. Si vous n’utilisez pas de bridge, précisez-le.
Votre version de Protect. Console → Réglages → Système, ou le champ applicationVersion dans la sortie ci-dessus.
La version de l’app. Dans les Réglages, tout en bas. Pour toute question sur l’achat, précisez aussi si les Réglages indiquent Garage Opener Unlimited comme débloqué.
Les modèles de votre relais et de votre capteur, et la configuration de la sortie du relais (Pulse ou non, et sa durée d’impulsion).
Ce que vous attendiez et ce qui s’est passé, avec les heures approximatives, pour pouvoir recouper avec le journal d’activité.

Merci de masquer votre clé d’API, vos jetons de bridge et votre secret de webhook avant d’envoyer quoi que ce soit. /healthz ne les contient pas, mais les journaux du conteneur en mode debug peuvent les contenir.

Limites connues

Deux portes au maximum. Chacune a besoin de sa propre sortie de relais et de son propre capteur, et avec un bridge il faut la version 0.6 ou ultérieure. La seconde porte n’a été testée que sur le simulateur, pas sur une seconde porte réelle.
Des images de la caméra, pas de vidéo. L’écran de la porte affiche des images fixes rafraîchies toutes les quelques secondes. Il n’y a pas de flux en direct.
UniFi Protect uniquement. Les autres relais, les autres hubs et Home Assistant sont hors périmètre.
Android diffère par endroits. Pas de widgets sur l’écran verrouillé, pas de phrases vocales comme avec Siri, et Garage Opener Unlimited ne peut pas être partagé avec la famille sur Google Play ; voir la FAQ.
Une porte arrêtée est lue comme ouverte. Un capteur d’inclinaison rapporte le même contact pour une porte arrêtée à mi-course et pour une porte grande ouverte ; l’app mémorise donc le sens plutôt que de prétendre le mesurer.
Les alertes cloud ne peuvent pas fermer la porte. Le service ne détient aucun identifiant vers votre console ; « Fermer maintenant » est exécuté par l’app, via votre propre connexion.
Un webhook perdu ressemble à une porte ouverte. Si votre console n’envoie jamais l’événement « fermée », les alertes cloud continuent de la croire ouverte, d’où la formulation « a signalé ».
Protect peut changer. Ubiquiti peut modifier l’API d’intégration à tout moment ; le cas échéant, les choses cassent jusqu’à une mise à jour.

Signaler un problème de sécurité

Si vous avez trouvé une faille, écrivez à support@garageopener.app avec « security » en objet, et merci de ne pas la publier d’abord. Vous recevrez un accusé de réception, et le crédit si vous le souhaitez.