Помощ за известията
Всичко необходимо, за да пуснете Notifier до вашия TeslaMate, и какво да проверите, когато дадено събитие не пристига.
Преди да започнете
Три неща, като повечето инсталации на TeslaMate вече имат първите две.
- TeslaMate с MQTT брокер. Mosquitto идва със стандартния Compose файл на TeslaMate.
- Docker на същата машина, на която е TeslaMate, или на всеки хост, който може да достигне брокера.
- Изходящ достъп до интернет. Без входящ порт, а вашият TeslaMate не трябва да е публичен.
Инсталиране на Notifier
Вашият TeslaMate няма как сам да достигне до телефона ви, а iOS известие може да пристигне само през Apple. Notifier е малкият контейнер, който следи MQTT и предава събитията нататък. Той стои до TeslaMate и никога не отваря порт.
-
Вземете токена си в приложението
Отворете HedgieMate, отидете в Настройки, после в Push известия, и включете известията. Приложението показва токен за свързване, който започва с hm_, и ID на сървъра за TeslaMate сървъра, с който сте свързани. Копирайте и двете.
Токенът сдвоява приложението с контейнера. Пазете го като парола.
-
Добавете контейнера към своя Compose файл
Отворете docker-compose.yml, от който пускате TeslaMate, и добавете услугата по-долу. Когато е в същия файл, тя споделя мрежа с брокера ви, така че MQTT_HOST е просто името на услугата на брокера.
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:Томът не е задължителен. Той кешира имената на автомобилите при рестарт, а без него релейният сървър така или иначе попълва името. Използвайте именуван том, а не bind mount: контейнерът работи като потребител без root права и не може да пише в директория на хоста, която Docker е създал като root.
-
Стартирайте го
Пуснете новата услуга. Нищо друго във вашия стек не трябва да се рестартира.
Терминалdocker compose up -d hedgiemate-notifier
След това прочетете логовете. При успешно стартиране се изписват връзката с брокера и ID на автомобилите, които се следят.
Терминалdocker compose logs -f hedgiemate-notifier
-
Потвърдете в приложението
Приложението отбелязва сървъра като свързан до няколко секунди. Оттам можете да включвате или изключвате отделни събития за всеки автомобил.
Нищо не пристига, докато автомобилът действително не смени състоянието си. Най-бързият начин да видите първото събитие е да включите колата в зарядното.
Без Compose
Ако TeslaMate не се управлява с Compose, docker run върши същата работа. Насочете MQTT_HOST към хост, който контейнерът може да достигне.
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
Повече от един TeslaMate
Пуснете по един Notifier до всеки сървър. Един и същ токен за свързване работи навсякъде. ID на сървъра е това, което ги разграничава в приложението.
Конфигурация
Всичко се задава чрез променливи на средата. Три са задължителни, останалите имат работещи стойности по подразбиране.
| Променлива | По подразбиране | Описание |
|---|---|---|
HEDGIEMATE_USER_TOKEN задължителна | няма | Токен за свързване от приложението. Започва с hm_. |
MQTT_HOST задължителна | няма | Име на хоста на вашия MQTT брокер. В Compose това е името на услугата, обикновено mosquitto. |
SERVER_ID задължителна | няма | UUID на сървъра от приложението. Контейнерът стартира и без него, но тогава настройките по сървър и по автомобил, направени в приложението, се пренебрегват. |
MQTT_PORT | 1883 | Порт на брокера. |
MQTT_USERNAME | няма | Потребителско име за брокера, ако той изисква удостоверяване. |
MQTT_PASSWORD | няма | Парола за брокера. |
MQTT_CLIENT_ID | hedgiemate-notifier | Client ID, използван при брокера. Сменете го, ако нещо друго вече се свързва със същото. |
MQTT_TLS | false | Задайте true за брокер с TLS. Портът по подразбиране тогава става 8883. |
MQTT_NAMESPACE | няма | Съвпада с MQTT_NAMESPACE в TeslaMate, ако сте го задали. Темите стават teslamate<namespace>/cars/#. |
CAR_IDS | 1 | ID на автомобилите за следене, разделени със запетая, например 1,2. Всеки автомобил получава собствен автомат на състоянията. |
LOG_LEVEL | info | debug, info, warn или error. |
RELAY_URL | https://push.hedgiemate.com | Endpoint на релейния сървър. Няма причина да го променяте. |
Всички събития
Всеки ред е отделен превключвател за всеки автомобил в приложението. Актуализациите на Активностите на живо не са известия и не са изброени тук.
| Известие | Изпраща се, когато |
|---|---|
| Шофиране | |
| Начало на пътуване | state → driving |
| Край на пътуване | state leaves driving |
| Зареждане | |
| Начало на зареждане | charging_state → Charging |
| Завършено зареждане | charging_state → Complete |
| Прекъснато зареждане | charging_state leaves Charging without Complete |
| Включване в зарядно | plugged_in → true |
| Изключване от зарядно | plugged_in → false |
| Батерия | |
| Ниска батерия | battery_level ≤ BATTERY_LOW_THRESHOLD |
| Достигнато целево ниво | battery_level ≥ BATTERY_HIGH_THRESHOLD |
| Местоположение | |
| Влизане в геозона | geofence set |
| Излизане от геозона | geofence cleared or changed |
| Сигурност | |
| Запис от Sentry | center_display_state = 7 |
| Автомобил | |
| Софтуерна актуализация | update_available → true |
| Заспиване | state → asleep pending |
| В режим на сън | state → asleep |
| Събуждане | state leaves asleep |
Нищо не пристига
Минете по списъка отгоре надолу. Повечето случаи са сред първите три.
Приложението все още показва, че сървърът не е свързан
Проверете дали контейнерът наистина работи с docker compose ps, след това прочетете логовете му. Обичайната причина е грешен MQTT_HOST: в Compose това е името на услугата на брокера, mosquitto, а не localhost.
Контейнерът работи, но нито едно събитие не се задейства
CAR_IDS трябва да съвпада с ID на автомобила, което използва TeslaMate. TeslaMate номерира автомобилите от 1, а при няколко автомобила ги изброявате: CAR_IDS=1,2.
MQTT се свързва, а логът мълчи
Ако сте задали MQTT_NAMESPACE в TeslaMate, задайте същата стойност и в Notifier. Без нея имената на темите не съвпадат и контейнерът стои, без да има какво да чете.
Някои събития пристигат, а други никога
Всяко събитие е отделен превключвател за всеки автомобил в приложението. Отворете сървъра в Настройки и проверете списъка със събития за този автомобил.
Известията за батерията никога не се задействат
BATTERY_LOW_THRESHOLD и BATTERY_HIGH_THRESHOLD са по подразбиране 20 и 90. Те се задействат веднъж на сесия на зареждане, така че автомобил, който не е минал прага, откакто е започнал да се зарежда, няма да изпрати известие.
Известията спират след няколко дни
Уверете се, че услугата има restart: unless-stopped, за да се стартира отново заедно с хоста. След това проверете iOS: режим Фокус или настройките за известия на приложението може да ги поглъщат.
Активностите на живо не се показват
Активностите на живо трябва да са разрешени за HedgieMate в Настройки на iOS и трябва да има активна сесия. Dynamic Island изисква iPhone 14 Pro или по-нов.
Брокерът изисква вход или TLS
Задайте MQTT_USERNAME и MQTT_PASSWORD. За TLS задайте MQTT_TLS на true, при което портът по подразбиране става 8883.
Трябва да видите какво прави
Задайте LOG_LEVEL на debug, възпроизведете случая и после го върнете обратно. В режим debug се изписва всяко MQTT съобщение и всяко решение, взето въз основа на него.
Въпроси
Защо изобщо ми трябва Notifier?
Вашият TeslaMate работи на вашия собствен сървър и няма как да достигне до телефона ви, а iOS известие може да бъде доставено само от Apple. Notifier е частта, която запълва тази празнина: следи MQTT темите ви, засича промяната в състоянието и изпраща събитието навън за доставка.
Трябва ли моят TeslaMate да е достъпен от интернет?
Не. Notifier прави само изходящи връзки, така че за работата на известията нищо не трябва да бъде излагано и не е нужно пренасочване на портове.
Какво всъщност напуска моя сървър?
Видът на събитието, нивото на батерията, състоянието на зареждането и името на геозоната, ако използвате геозони. Координатите и маршрутите остават във вашия TeslaMate, а адресът на сървъра ви никога не се изпраща. Данните за събитията се изтриват след няколко часа.
Може ли да работи на друга машина, а не там, където е TeslaMate?
Да, стига да може да достигне вашия MQTT брокер. Задайте MQTT_HOST към този хост и се уверете, че портът на брокера е достъпен от него.
Работи ли с няколко автомобила?
Да. Изброете ID в CAR_IDS и всеки автомобил получава собствено следене на състоянието и собствени превключватели в приложението.
Какво става, ако релейният сървър е недостъпен?
Контейнерът опитва отново няколко пъти с нарастващо забавяне и след това се отказва от това събитие. Той продължава да работи и нормално улавя следващата промяна в състоянието.
Съхранява ли нещо?
Само кеш с имената на автомобилите, и то само ако монтирате незадължителния том. Всичко останало се пази в паметта, докато контейнерът работи.
Как да го актуализирам?
Изтеглете образа отново и пресъздайте услугата. Бележките към версиите са на страницата с версии в GitHub.
Как да изключа известията?
Изключете ги в приложението или спрете контейнера. И двата начина работят самостоятелно и нищо друго във вашия стек на TeslaMate не зависи от него.
Изходен код
Notifier е написан на Go под лиценз MIT. Прочетете кода или отворете issue, ако нещо не е наред.
LukStankovic/hedgiemate-notifier
Нужна ви е помощ?
Имате затруднения с настройката? Тук сме, за да ви помогнем да започнете.