Prezentarea notificărilor

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.

  1. 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ă.

  2. 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.

  3. Pornește-l

    Pornește noul serviciu. Nimic altceva din stack nu trebuie repornit.

    Terminal
    docker 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.

    Terminal
    docker compose logs -f hedgiemate-notifier
  4. 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.

Terminal
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

Imagine Docker hedgiemate/notifier:latest Docker Hub

Ai nevoie de ajutor?

Ai probleme cu configurarea? Suntem aici să te ajutăm să începi.