Domaine : torque_logger_2025 · Version : 2025.09.1 · IoT class : local_push
Torque Logger 2025 reçoit en push les données de l’app Torque (Android) et crée automatiquement des capteurs (PID) + un device_tracker (position GPS du véhicule) dans Home Assistant.
C’est simple, rapide, et prêt pour vos tableaux de bord de passionné. 🔧📈
- ✨ Fonctionnalités
- 📦 Installation
- ⚙️ Configuration côté Home Assistant
- 📱 Réglages dans Torque (Android)
- 🧪 Tests rapides (sans Torque)
- 🛰️ Capteurs & suivi GPS
- 🗑️ Supprimer un véhicule (sans enlever l’intégration)
- 🧰 Dépannage
- 🧠 Notes techniques
- 🗒️ Changelog
- 🔐 Sécurité & bonnes pratiques
- 📎 Carte HomeAssistant
- 🤝 Remerciements
- Création auto des capteurs à partir des PIDs connus (voir
const.py). - Device tracker basé sur
gpslat/gpslon(position en temps réel). - Localisation FR/EN des libellés de capteurs.
- Conversion d’unités (km→mi, °C→°F, km/h→mph, m→ft) via pint.
- Anti-bruit : filtrage optionnel par email (seuls vos envois passent).
- Désambiguïsation automatique quand deux PIDs portent le même short name.
- Suppression ciblée d’un véhicule directement depuis l’UI d’Home Assistant.
- Assurez-vous d’avoir HACS installé dans Home Assistant.
- Ouvrez HACS → Intégrations → ⋮ → Dépôts personnalisés (Custom repositories).
- Ajoutez ce dépôt :
https://github.com/Marlboro62/homeassistant
(Type : Intégration)
⚠️ Vérifiez qu’il n’y a pas d’espace dans l’URL si vous copiez/collez.
- Dans HACS → Intégrations, recherchez “Torque Logger 2025”, installez.
- Redémarrez Home Assistant.
- Copiez le dossier
custom_components/torque_logger_2025dans votre instance Home Assistant. - Redémarrez Home Assistant.
⚠️ Une seule instance de l’intégration est autorisée.
💡 Ressources Images Installation: Voir les images
- Paramètres → Intégrations → Ajouter une intégration → “Torque Logger 2025”
- Renseignez :
- Email (facultatif) : si défini, seuls les envois Torque portant exactement cet email seront traités.
- Unités impériales : conversions automatiques.
- Langue :
frouen& Autres pour les libellés.
ℹ️ Ces options sont modifiables plus tard via Options de l’intégration.
Dans Torque Pro :
- Activez l’upload vers serveur web
(Data Logging & Upload → Upload to Web Server). - URL du serveur : http(s)://VOTRE_HA:PORT/api/torque_logger_2025
- (Conseillé) Renseignez votre email dans Torque (champ envoyé en
eml=...) — il doit correspondre si vous avez activé le filtre côté intégration. - Laissez Torque envoyer ses paramètres par défaut (
session,id,eml,profileName,time,kXX, etc.).
💡 L’endpoint n’exige pas d’authentification par défaut (upload direct depuis le téléphone).
Si votre HA est exposé sur Internet, protégez-le (reverse proxy, VPN, allow-list IP) ou utilisez le filtre email.
💡 Ressources BASH : Voir les images
Vitesse OBD (PID 0x0D) :
curl "http://HA:8123/api/torque_logger_2025?session=A1&id=devA&[email protected]&profileName=Ma%20Voiture&v=1.0&time=1694090000&userFullName0d=Vehicle%20speed&userShortName0d=speed&defaultUnit0d=km/h&k0d=250"
curl "https://xxx.duckdns.org/api/torque_logger_2025?session=A1&id=devA&[email protected]&profileName=Ma%20Voiture&v=1.0&time=1694090000&userFullName0d=Vehicle%20speed&userShortName0d=speed&defaultUnit0d=km/h&k0d=250"Vitesse GPS (PID ff1001) ::
curl "http://HA:8123/api/torque_logger_2025?session=A1&id=devA&[email protected]&profileName=Ma%20Voiture&v=1.0&time=1694090100&userFullNameff1001=Vehicle%20speed%20(GPS)&userShortNameff1001=gps_spd&defaultUnitff1001=km/h&kff1001=142"
curl "https://xxx.duckdns.org/api/torque_logger_2025?session=A1&id=devA&[email protected]&profileName=Ma%20Voiture&v=1.0&time=1694090100&userFullNameff1001=Vehicle%20speed%20(GPS)&userShortNameff1001=gps_spd&defaultUnitff1001=km/h&kff1001=142"Les capteurs sont créés automatiquement à partir des PIDs connus déclarés dans TORQUE_CODES
(voir custom_components/torque_logger_2025/const.py).
gpslat/gpsloncréent undevice_tracker(source GPS).- Les PIDs GPS non positionnels (cap, altitude, précision, satellites, vitesse GPS, etc.) sont exposés en capteurs classiques.
- En cas de conflit de nom, le nom du capteur est suffixé par le code PID (p. ex.
-0d,-ff1001) afin de rester unique.
Chemin UI : Paramètres → Appareils & Services → Appareils → sélectionnez le véhicule → menu ⋮ → Supprimer l’appareil.
L’intégration oublie alors ce véhicule et nettoie ses références internes.
- 400: Bad Request : la requête n’a pas de
session. Torque l’envoie normalement → vérifiez l’URL de l’endpoint et votre testcurl. - Aucun capteur créé : envoyez au moins un PID connu avec métadonnées (
userFullNameXX,userShortNameXX,defaultUnitXX,kXX) et unprofileName(nom du véhicule). - Rien n’apparaît avec filtre e-mail : le paramètre
eml=dans la requête doit correspondre exactement à l’e-mail configuré dans l’intégration. - Position GPS absente : pour créer le
device_tracker, Torque doit envoyergpslatetgpslon(pas seulement la vitesse GPS). Vérifiez les permissions Localisation d’Android pour Torque. - Noms en doublon / capteurs dupliqués : si deux PIDs partagent le même short name, un suffixe
-<pid>est ajouté automatiquement (ex.-0d,-ff1001). Renommez vos short names côté Torque si nécessaire. - Unités / langue incorrectes : modifiez ces options via Options de l’intégration (redémarrez HA si demandé).
- 404 / 403 : vérifiez le chemin
/api/torque_logger_2025, le schéma (http/https), le port de HA et les règles de votre reverse-proxy / pare-feu. - Trop de requêtes : réduisez la fréquence d’upload dans Torque (5–10 s suffisent) pour éviter la surcharge.
- Logs utiles : ouvrez Paramètres → Système → Journaux ou le fichier
home-assistant.loget chercheztorque_logger_2025(passez en niveauDEBUGsi besoin).
curl "http://HA:8123/api/torque_logger_2025?session=A1&id=devA&profileName=Ma%20Voiture&time=1694090000&userFullName0d=Vehicle%20speed&userShortName0d=speed&defaultUnit0d=km/h&k0d=250"
curl "https://xxx.duckdns.org/api/torque_logger_2025?session=A1&id=devA&profileName=Ma%20Voiture&time=1694090000&userFullName0d=Vehicle%20speed&userShortName0d=speed&defaultUnit0d=km/h&k0d=250"- Endpoint :
GET /api/torque_logger_2025 - Filtre e-mail : si configuré, seuls les paquets dont
emlcorrespond sont traités. - Localisation : libellés fr / en.
- Conversions : via pint (km↔mi, °C↔°F, km/h↔mph, m↔ft).
- Instance unique : une seule instance de l’intégration est supportée.
- Intégration Config Flow (UI).
- FR/EN pour les libellés.
- Option Unités impériales.
- Création automatique des capteurs (incluant PIDs GPS hors lat/lon). 💡 Visuel HA : Voir les images
- Device tracker basé sur
gpslat/gpslon. - Suppression fine d’un véhicule depuis l’UI (sans retirer l’intégration).
- ** Ajout de tous les PID connu de Torque**. 💡 Ressources: Voir les PID
Si votre instance HA est accessible depuis Internet, ne laissez pas l’endpoint exposé sans protection :
- VPN / reverse proxy
- Filtrage IP (allow-list)
- À défaut, activez le filtre e-mail côté intégration
Ajustez la fréquence d’upload dans Torque pour éviter de surcharger la base
(5–10 s suffisent si vous n’êtes pas en temps réel).
- Communauté Home Assistant & utilisateurs de Torque.
- Contributeurs & testeurs qui rendent ce projet plus robuste chaque jour. 💙
- Modele / Model (https://github.com/Marlboro62/homeassistant/tree/main/docs/images/card/code_card.md).
Merci aux projets développés par :
Ce projet est distribué sous licence MIT.
Il est basé sur les travaux de :
Les fichiers de licence originaux sont inclus et respectés.
Vous êtes libre d’utiliser, modifier et redistribuer ce projet conformément aux termes de la licence MIT.
👉 Voir le fichier LICENSE pour plus de détails.
Amazon : OBD2 Bluetooth
Si vous aimez ce projet, vous pouvez me soutenir ici :
