Prehľad hlásení

Pomoc s hláseniami

Všetko, čo potrebujete, aby Notifier bežal vedľa vášho TeslaMate, a čo skontrolovať, keď udalosť nepríde.

Skôr než začnete

Tri veci, a väčšina inštalácií TeslaMate prvé dve už má.

  • TeslaMate s MQTT brokerom. Mosquitto je súčasťou predvoleného súboru Compose pre TeslaMate.
  • Docker na tom istom počítači ako TeslaMate alebo na akomkoľvek hostiteľovi, ktorý sa dostane k brokeru.
  • Odchádzajúci prístup na internet. Žiadny prichádzajúci port a váš TeslaMate nemusí byť verejný.

Inštalácia Notifiera

Váš TeslaMate sa sám k vášmu telefónu nedostane a hlásenie v iOS môže prísť iba cez Apple. Notifier je malý kontajner, ktorý sleduje MQTT a odovzdáva udalosti ďalej. Beží vedľa TeslaMate a nikdy neotvára žiadny port.

  1. Získajte token v aplikácii

    Otvorte HedgieMate, prejdite do Nastavení, potom do časti Push hlásenia a zapnite hlásenia. Aplikácia zobrazí prepojovací token, ktorý začína na hm_, a ID servera pre server TeslaMate, ku ktorému ste pripojení. Skopírujte oboje.

    Token spája aplikáciu s kontajnerom. Narábajte s ním ako s heslom.

  2. Pridajte kontajner do súboru Compose

    Otvorte docker-compose.yml, z ktorého spúšťate TeslaMate, a pridajte službu nižšie. Keď je v tom istom súbore, zdieľa sieť s vaším brokerom, takže MQTT_HOST je jednoducho názov služby brokera.

    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:

    Zväzok (volume) je voliteľný. Uchováva názvy áut aj po reštarte, bez neho názov aj tak doplní relay. Použite pomenovaný zväzok, nie bind mount: kontajner beží pod používateľom bez práv root a nemôže zapisovať do priečinka na hostiteľovi, ktorý Docker vytvoril ako root.

  3. Spustite ho

    Spustite novú službu. Nič iné vo vašom stacku nemusíte reštartovať.

    Terminál
    docker compose up -d hedgiemate-notifier

    Potom si prečítajte logy. Pri úspešnom štarte sa vypíše pripojenie k brokeru a ID áut, ktoré sleduje.

    Terminál
    docker compose logs -f hedgiemate-notifier
  4. Overte to v aplikácii

    Aplikácia do pár sekúnd označí server ako pripojený. Potom môžete jednotlivé udalosti zapínať a vypínať pre každé auto zvlášť.

    Kým auto naozaj nezmení stav, nič nepríde. Prvú udalosť uvidíte najrýchlejšie, keď auto pripojíte k nabíjačke.

Bez Compose

Ak TeslaMate nespravujete cez Compose, rovnakú prácu urobí docker run. MQTT_HOST nastavte na hostiteľa, na ktorého kontajner dosiahne.

Terminál
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

Viac ako jeden TeslaMate

Pri každom serveri spustite jeden Notifier. Rovnaký prepojovací token funguje všade. V aplikácii ich od seba odlišuje ID servera.

Konfigurácia

Všetko sa nastavuje cez premenné prostredia. Tri sú povinné, ostatné majú funkčné predvolené hodnoty.

Premenná Predvolená hodnota Popis
HEDGIEMATE_USER_TOKEN povinné žiadna Prepojovací token z aplikácie. Začína na hm_.
MQTT_HOST povinné žiadna Názov hostiteľa vášho MQTT brokera. V Compose je to názov služby, zvyčajne mosquitto.
SERVER_ID povinné žiadna UUID servera z aplikácie. Kontajner sa spustí aj bez neho, ale nastavenia pre server a pre jednotlivé autá z aplikácie sa potom ignorujú.
MQTT_PORT 1883 Port brokera.
MQTT_USERNAME žiadna Používateľské meno pre broker, ak váš broker vyžaduje overenie.
MQTT_PASSWORD žiadna Heslo pre broker.
MQTT_CLIENT_ID hedgiemate-notifier ID klienta na brokeri. Zmeňte ho, ak sa pod týmto ID už pripája niečo iné.
MQTT_TLS false Pre broker s TLS nastavte na true. Predvolený port sa potom zmení na 8883.
MQTT_NAMESPACE žiadna Ak ste v TeslaMate nastavili MQTT_NAMESPACE, zadajte rovnakú hodnotu. Topicy sa potom zmenia na teslamate<namespace>/cars/#.
CAR_IDS 1 ID áut na sledovanie oddelené čiarkou, napríklad 1,2. Každé auto má vlastný stavový automat.
LOG_LEVEL info debug, info, warn alebo error.
RELAY_URL https://push.hedgiemate.com Endpoint relay. Nie je dôvod ho meniť.

Všetky udalosti

Každý riadok je v aplikácii samostatný prepínač pre každé auto. Aktualizácie aktivít naživo nie sú hlásenia, preto tu nie sú uvedené.

Hlásenie Odošle sa, keď
Jazda
Jazda sa začala state → driving
Jazda skončila state opustí driving
Nabíjanie
Nabíjanie sa začalo charging_state → Charging
Nabíjanie dokončené charging_state → Complete
Nabíjanie prerušené charging_state opustí Charging bez Complete
Nabíjačka pripojená plugged_in → true
Nabíjačka odpojená plugged_in → false
Batéria
Nízka batéria battery_level ≤ BATTERY_LOW_THRESHOLD
Dosiahnutá cieľová úroveň batérie battery_level ≥ BATTERY_HIGH_THRESHOLD
Poloha
Vstup do geozóny geofence je nastavená
Opustenie geozóny geofence sa vymaže alebo zmení
Zabezpečenie
Záznam v režime Sentry center_display_state = 7
Vozidlo
Aktualizácia softvéru update_available → true
Vozidlo zaspáva state → asleep pending
Vozidlo spí state → asleep
Vozidlo sa prebudilo state opustí asleep

Nič neprichádza

Postupujte podľa zoznamu. Väčšinou ide o jeden z prvých troch prípadov.

Aplikácia stále hlási, že server nie je pripojený

Príkazom docker compose ps overte, že kontajner naozaj beží, a potom si prečítajte jeho logy. Zvyčajnou príčinou je nesprávny MQTT_HOST: v Compose je to názov služby brokera, mosquitto, nie localhost.

Kontajner beží, ale žiadna udalosť nikdy nepríde

CAR_IDS sa musí zhodovať s ID auta, ktoré používa TeslaMate. TeslaMate čísluje autá od 1 a pri viacerých autách ich vymenujte: CAR_IDS=1,2.

MQTT sa pripojí, ale v logu je ticho

Ak ste v TeslaMate nastavili MQTT_NAMESPACE, nastavte rovnakú hodnotu aj v Notifieri. Bez nej sa názvy topicov nezhodujú a kontajner nemá čo čítať.

Niektoré udalosti prichádzajú, iné nikdy

Každá udalosť má v aplikácii vlastný prepínač pre každé auto. Otvorte server v Nastaveniach a skontrolujte zoznam udalostí pre dané auto.

Hlásenia o batérii nikdy neprídu

BATTERY_LOW_THRESHOLD a BATTERY_HIGH_THRESHOLD majú predvolené hodnoty 20 a 90. Odošlú sa raz za nabíjanie, takže auto, ktoré od začiatku nabíjania hranicu neprekročilo, hlásenie nepošle.

Hlásenia po pár dňoch prestanú chodiť

Uistite sa, že služba má restart: unless-stopped, aby sa po reštarte hostiteľa znova spustila. Potom skontrolujte iOS: hlásenia môže zachytávať režim Sústredenie alebo nastavenia hlásení aplikácie.

Aktivity naživo sa nezobrazujú

Aktivity naživo musia byť pre HedgieMate povolené v Nastaveniach iOS a musí prebiehať aktívne nabíjanie alebo jazda. Dynamic Island vyžaduje iPhone 14 Pro alebo novší.

Broker vyžaduje prihlásenie alebo TLS

Nastavte MQTT_USERNAME a MQTT_PASSWORD. Pre TLS nastavte MQTT_TLS na true, čím sa predvolený port zmení na 8883.

Potrebujete vidieť, čo robí

Nastavte LOG_LEVEL na debug, zopakujte situáciu a potom ho vráťte späť. V režime debug sa vypíše každá správa MQTT a každé rozhodnutie, ktoré z nej vyplynulo.

Otázky

Prečo vôbec potrebujem Notifier?

Váš TeslaMate beží na vašom vlastnom serveri a nemá ako sa dostať k vášmu telefónu, a hlásenie v iOS môže doručiť iba Apple. Notifier túto medzeru vypĺňa: sleduje vaše MQTT topicy, zachytí zmenu stavu a udalosť odošle na doručenie.

Musí byť môj TeslaMate dostupný z internetu?

Nie. Notifier nadväzuje iba odchádzajúce spojenia, takže aby hlásenia fungovali, netreba nič sprístupňovať ani presmerovať žiadny port.

Čo presne opúšťa môj server?

Typ udalosti, úroveň batérie, stav nabíjania a názov geozóny, ak geozóny používate. Súradnice a trasy jázd zostávajú vo vašom TeslaMate a adresa vášho servera sa nikdy neodosiela. Údaje o udalostiach sa po niekoľkých hodinách vymažú.

Môže bežať na inom počítači ako TeslaMate?

Áno, ak sa dostane k vášmu MQTT brokeru. Nastavte MQTT_HOST na daného hostiteľa a uistite sa, že port brokera je z neho dostupný.

Funguje s viacerými autami?

Áno. Vymenujte ID v CAR_IDS a každé auto bude mať vlastné sledovanie stavu a vlastné prepínače v aplikácii.

Čo sa stane, keď relay nie je dostupný?

Kontajner to niekoľkokrát skúsi znova s rastúcim odstupom a potom danú udalosť zahodí. Beží ďalej a ďalšiu zmenu stavu normálne zachytí.

Ukladá niečo?

Iba cache názvov áut, a to iba ak pripojíte voliteľný zväzok. Všetko ostatné drží v pamäti, kým kontajner beží.

Ako ho aktualizujem?

Znova stiahnite image a službu vytvorte nanovo. Poznámky k vydaniam sú na stránke vydaní na GitHube.

Ako hlásenia vypnem?

Vypnite ich v aplikácii alebo zastavte kontajner. Funguje oboje samostatne a nič iné vo vašom stacku TeslaMate od neho nezávisí.

Zdrojový kód

Notifier je napísaný v Go pod licenciou MIT. Prečítajte si ho, alebo založte issue, ak niečo nesedí.

LukStankovic/hedgiemate-notifier

Docker image hedgiemate/notifier:latest Docker Hub

Potrebujete pomoc?

Nedarí sa vám nastavenie? Radi vám pomôžeme začať.