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.
-
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.
-
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.
-
Spustite ho
Spustite novú službu. Nič iné vo vašom stacku nemusíte reštartovať.
Termináldocker 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áldocker compose logs -f hedgiemate-notifier
-
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.
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
Potrebujete pomoc?
Nedarí sa vám nastavenie? Radi vám pomôžeme začať.