Преглед на известията

Помощ за известията

Всичко необходимо, за да пуснете Notifier до вашия TeslaMate, и какво да проверите, когато дадено събитие не пристига.

Преди да започнете

Три неща, като повечето инсталации на TeslaMate вече имат първите две.

  • TeslaMate с MQTT брокер. Mosquitto идва със стандартния Compose файл на TeslaMate.
  • Docker на същата машина, на която е TeslaMate, или на всеки хост, който може да достигне брокера.
  • Изходящ достъп до интернет. Без входящ порт, а вашият TeslaMate не трябва да е публичен.

Инсталиране на Notifier

Вашият TeslaMate няма как сам да достигне до телефона ви, а iOS известие може да пристигне само през Apple. Notifier е малкият контейнер, който следи MQTT и предава събитията нататък. Той стои до TeslaMate и никога не отваря порт.

  1. Вземете токена си в приложението

    Отворете HedgieMate, отидете в Настройки, после в Push известия, и включете известията. Приложението показва токен за свързване, който започва с hm_, и ID на сървъра за TeslaMate сървъра, с който сте свързани. Копирайте и двете.

    Токенът сдвоява приложението с контейнера. Пазете го като парола.

  2. Добавете контейнера към своя 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.

  3. Стартирайте го

    Пуснете новата услуга. Нищо друго във вашия стек не трябва да се рестартира.

    Терминал
    docker compose up -d hedgiemate-notifier

    След това прочетете логовете. При успешно стартиране се изписват връзката с брокера и ID на автомобилите, които се следят.

    Терминал
    docker compose logs -f hedgiemate-notifier
  4. Потвърдете в приложението

    Приложението отбелязва сървъра като свързан до няколко секунди. Оттам можете да включвате или изключвате отделни събития за всеки автомобил.

    Нищо не пристига, докато автомобилът действително не смени състоянието си. Най-бързият начин да видите първото събитие е да включите колата в зарядното.

Без 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, ако нещо не е наред.

Docker образ hedgiemate/notifier:latest Docker Hub

Нужна ви е помощ?

Имате затруднения с настройката? Тук сме, за да ви помогнем да започнете.