Ajutor pentru notificări
Tot ce îți trebuie ca Notifier să ruleze lângă TeslaMate și ce verifici când un eveniment nu ajunge.
Înainte să începi
Trei lucruri, iar majoritatea instalărilor TeslaMate le au deja pe primele două.
- TeslaMate cu un broker MQTT. Mosquitto vine în fișierul Compose implicit al TeslaMate.
- Docker pe aceeași mașină ca TeslaMate sau pe orice host care poate ajunge la broker.
- Acces la internet spre exterior. Fără port deschis spre interior, iar TeslaMate nu trebuie să fie public.
Instalează Notifier
TeslaMate nu are cum să ajungă singur la telefonul tău, iar o notificare iOS poate veni doar prin Apple. Notifier este containerul mic care urmărește MQTT și predă evenimentele mai departe. Stă lângă TeslaMate și nu deschide niciodată vreun port.
-
Ia tokenul din aplicație
Deschide HedgieMate, mergi la Configurări, apoi la Notificări push, și activează notificările. Aplicația îți arată un token de asociere care începe cu hm_ și un ID de server pentru serverul TeslaMate la care ești conectat. Copiază-le pe amândouă.
Tokenul asociază aplicația cu containerul. Tratează-l ca pe o parolă.
-
Adaugă containerul în fișierul Compose
Deschide docker-compose.yml din care rulezi TeslaMate și adaugă serviciul de mai jos. Dacă îl ții în același fișier, împarte aceeași rețea cu brokerul, așa că MQTT_HOST este pur și simplu numele serviciului brokerului.
docker-compose.yml# add under services: in the docker-compose.yml you run TeslaMate from hedgiemate-notifier: image: hedgiemate/notifier:latest restart: unless-stopped depends_on: - mosquitto environment: HEDGIEMATE_USER_TOKEN: "hm_your_token_here" SERVER_ID: "your-server-uuid" MQTT_HOST: "mosquitto" MQTT_PORT: "1883" CAR_IDS: "1" LOG_LEVEL: "info" volumes: - hedgiemate-notifier-data:/data # and under the top-level volumes: key, adding it if the file has none hedgiemate-notifier-data:Volumul este opțional. Păstrează numele mașinilor după o repornire; fără el, releul completează oricum numele. Folosește un volum cu nume, nu un bind mount: containerul rulează ca utilizator non-root și nu poate scrie într-un director de pe host creat de Docker ca root.
-
Pornește-l
Pornește noul serviciu. Nimic altceva din stack nu trebuie repornit.
Terminaldocker compose up -d hedgiemate-notifier
Apoi citește logurile. O pornire reușită afișează conexiunea la broker și ID-urile mașinilor pe care le urmărește.
Terminaldocker compose logs -f hedgiemate-notifier
-
Confirmă în aplicație
În câteva secunde, aplicația marchează serverul ca fiind conectat. De acolo poți activa sau dezactiva evenimente individuale, pentru fiecare mașină.
Nu ajunge nimic până când mașina nu își schimbă efectiv starea. Conectarea la încărcător este cel mai rapid mod de a vedea primul eveniment.
Fără Compose
Dacă TeslaMate nu este gestionat prin Compose, docker run face același lucru. Setează MQTT_HOST la un host pe care containerul îl poate accesa.
docker run -d \ --name hedgiemate-notifier \ --restart unless-stopped \ -e HEDGIEMATE_USER_TOKEN="hm_your_token_here" \ -e SERVER_ID="your-server-uuid" \ -e MQTT_HOST="your-mqtt-host" \ -e CAR_IDS="1" \ hedgiemate/notifier:latest
Mai multe instanțe TeslaMate
Rulează câte un Notifier lângă fiecare server. Același token de asociere funcționează peste tot. ID-ul serverului este cel care le ține separate în aplicație.
Configurare
Totul se setează prin variabile de mediu. Trei sunt obligatorii, restul au valori implicite care funcționează.
| Variabilă | Implicit | Descriere |
|---|---|---|
HEDGIEMATE_USER_TOKEN obligatorie | niciuna | Tokenul de asociere din aplicație. Începe cu hm_. |
MQTT_HOST obligatorie | niciuna | Numele hostului brokerului MQTT. În Compose este numele serviciului, de obicei mosquitto. |
SERVER_ID obligatorie | niciuna | UUID-ul serverului din aplicație. Containerul pornește și fără el, dar atunci configurările pe server și pe mașină făcute în aplicație sunt ignorate. |
MQTT_PORT | 1883 | Portul brokerului. |
MQTT_USERNAME | niciuna | Numele de utilizator pentru broker, dacă al tău cere autentificare. |
MQTT_PASSWORD | niciuna | Parola pentru broker. |
MQTT_CLIENT_ID | hedgiemate-notifier | Client ID folosit pe broker. Schimbă-l dacă altceva se conectează deja cu acesta. |
MQTT_TLS | false | Setează la true pentru un broker cu TLS. Portul implicit devine atunci 8883. |
MQTT_NAMESPACE | niciuna | Pune aceeași valoare ca MQTT_NAMESPACE din TeslaMate, dacă ai setat unul. Topicurile devin teslamate<namespace>/cars/#. |
CAR_IDS | 1 | ID-urile mașinilor de urmărit, separate prin virgulă, de exemplu 1,2. Fiecare mașină are propria mașină de stări. |
LOG_LEVEL | info | debug, info, warn sau error. |
RELAY_URL | https://push.hedgiemate.com | Endpointul releului. Nu există niciun motiv să îl schimbi. |
Toate evenimentele
Fiecare rând este un comutator separat pentru fiecare mașină, în aplicație. Actualizările Activităților live nu sunt notificări și nu apar aici.
| Notificare | Se trimite când |
|---|---|
| Condus | |
| Cursă începută | state → driving |
| Cursă încheiată | state leaves driving |
| Încărcare | |
| Încărcare începută | charging_state → Charging |
| Încărcare finalizată | charging_state → Complete |
| Încărcare întreruptă | charging_state leaves Charging without Complete |
| Încărcător conectat | plugged_in → true |
| Încărcător deconectat | plugged_in → false |
| Baterie | |
| Baterie descărcată | battery_level ≤ BATTERY_LOW_THRESHOLD |
| Nivel țintă al bateriei atins | battery_level ≥ BATTERY_HIGH_THRESHOLD |
| Locație | |
| Intrare în zonă geografică | geofence set |
| Ieșire din zonă geografică | geofence cleared or changed |
| Securitate | |
| Înregistrare Santinelă | center_display_state = 7 |
| Vehicul | |
| Actualizare software | update_available → true |
| Intrare în repaus | state → asleep pending |
| În repaus | state → asleep |
| Trezire | state leaves asleep |
Nu ajunge nimic
Parcurge lista în ordine. Majoritatea cazurilor sunt unul dintre primele trei.
Aplicația spune în continuare că serverul nu este conectat
Verifică cu docker compose ps dacă containerul chiar rulează, apoi citește-i logurile. Cauza obișnuită este un MQTT_HOST greșit: în Compose este numele serviciului brokerului, mosquitto, nu localhost.
Containerul rulează, dar nu se declanșează niciun eveniment
CAR_IDS trebuie să corespundă ID-ului mașinii din TeslaMate. TeslaMate numerotează mașinile de la 1, iar dacă ai mai multe le enumeri: CAR_IDS=1,2.
MQTT se conectează, dar logul rămâne gol
Dacă ai setat MQTT_NAMESPACE în TeslaMate, setează aceeași valoare și în Notifier. Fără ea, numele topicurilor nu se potrivesc, iar containerul stă degeaba fără nimic de citit.
Unele evenimente ajung, altele niciodată
Fiecare eveniment are un comutator separat pentru fiecare mașină, în aplicație. Deschide serverul în Configurări și verifică lista de evenimente pentru acea mașină.
Notificările despre baterie nu apar niciodată
BATTERY_LOW_THRESHOLD și BATTERY_HIGH_THRESHOLD au implicit valorile 20 și 90. Se declanșează o dată pe sesiune de încărcare, deci o mașină care nu a trecut pragul de când a început încărcarea nu va trimite nimic.
Notificările se opresc după câteva zile
Asigură-te că serviciul are restart: unless-stopped, ca să repornească odată cu hostul. Apoi verifică iOS: un mod Concentrare sau configurările de notificări ale aplicației le pot bloca.
Activitățile live nu apar
Activitățile live trebuie permise pentru HedgieMate în Configurări iOS și trebuie să existe o sesiune activă. Dynamic Island necesită iPhone 14 Pro sau un model mai nou.
Brokerul cere autentificare sau TLS
Setează MQTT_USERNAME și MQTT_PASSWORD. Pentru TLS setează MQTT_TLS la true, iar portul implicit devine 8883.
Vrei să vezi ce face
Setează LOG_LEVEL la debug, reprodu situația, apoi pune-l înapoi. În modul debug se afișează fiecare mesaj MQTT și fiecare decizie luată pe baza lui.
Întrebări
De ce am nevoie de Notifier?
TeslaMate stă pe propriul tău server și nu are cum să ajungă la telefonul tău, iar o notificare iOS poate fi livrată doar de Apple. Notifier este piesa care acoperă acest gol: urmărește topicurile MQTT, observă schimbarea de stare și trimite evenimentul mai departe pentru livrare.
Trebuie ca TeslaMate să fie accesibil din internet?
Nu. Notifier face doar conexiuni de ieșire, deci nu trebuie să expui nimic și nici să redirecționezi vreun port pentru ca notificările să funcționeze.
Ce pleacă de fapt de pe serverul meu?
Tipul evenimentului, nivelul bateriei, starea încărcării și numele zonei geografice, dacă folosești zone geografice. Coordonatele și traseele rămân în TeslaMate, iar adresa serverului nu se trimite niciodată. Datele despre evenimente se șterg după câteva ore.
Poate rula pe altă mașină decât TeslaMate?
Da, atât timp cât poate ajunge la brokerul MQTT. Setează MQTT_HOST la acel host și asigură-te că portul brokerului este accesibil de acolo.
Funcționează cu mai multe mașini?
Da. Enumeră ID-urile în CAR_IDS, iar fiecare mașină primește propria urmărire a stării și propriile comutatoare în aplicație.
Ce se întâmplă dacă releul nu este accesibil?
Containerul reîncearcă de câteva ori, cu pauze tot mai mari, apoi renunță la acel eveniment. Continuă să ruleze și preia normal următoarea schimbare de stare.
Stochează ceva?
Doar un cache cu numele mașinilor și doar dacă montezi volumul opțional. Restul este ținut în memorie cât timp rulează containerul.
Cum îl actualizez?
Descarcă din nou imaginea și recreează serviciul. Notele de versiune sunt pe pagina de releases de pe GitHub.
Cum opresc notificările?
Le dezactivezi din aplicație sau oprești containerul. Oricare dintre variante funcționează singură și nimic altceva din stackul TeslaMate nu depinde de el.
Cod sursă
Notifier este scris în Go, sub licență MIT. Citește codul sau deschide un issue dacă ceva nu e în regulă.
LukStankovic/hedgiemate-notifier
Ai nevoie de ajutor?
Ai probleme cu configurarea? Suntem aici să te ajutăm să începi.