TFA Bridge – Ръководство за потребителя
v0.18 · октомври 2026
Устройство за автоматично препращане на данни от сензори TFA Dostmann (Mobile Alerts) към Weather Underground или съвместими станции. Работи денонощно, без компютър.
1. Съдържание и изисквания
В пакета: - Устройство TFA Bridge – ESP32-S3 (Waveshare DevKitC) или Wemos D1 Mini, според изпълнението - USB кабел (USB-C за ESP32-S3; micro-USB за Wemos) - Стикер с адреса и паролата на устройството
Необходимо е още: - USB захранване 5 V - WiFi мрежа 2,4 GHz с достъп до интернет - Станция в Weather Underground – безплатна регистрация - Device ID на всеки TFA сензор (показва се в приложението Mobile Alerts)
2. Първоначална настройка
2.1 Свързване с WiFi
- Свържете USB захранването. Няколко секунди след включване устройството създава WiFi мрежа
TFA-Bridge-Setup. - От телефон се свържете с мрежата
TFA-Bridge-Setup(без парола). Порталът се отваря автоматично; ако не се отвори, отидете наhttp://192.168.4.1. - Изберете Configure WiFi → домашната мрежа → въведете паролата → Save.
- Устройството се рестартира и получава IP адрес от рутера.
2.2 Достъп до интерфейса
Основен адрес (Mac, Linux, Windows 10 и по-нови):
http://tfa-bridge-XXXXXX.local/
Резервен вариант (по-стари версии на Windows без Bonjour): намерете IP адреса в списъка с DHCP клиенти на рутера – устройството с MAC адрес XX:XX:XX:XX:XX:XX.
2.3 Вход
Потребителят и паролата са отпечатани на стикера на устройството.
Всяко устройство има собствена парола, отпечатана на стикера; тя не се споделя с други устройства. Паролата от стикера важи отново след фабричен ресет, затова пазете стикера.
2.4 Смяна на паролата (по желание)
Ако стикерът е на видно място, можете да зададете друга парола:
- Отворете Настройки → Сигурност → Смяна на парола.
- Въведете нова парола (поне 6 знака) и натиснете Запази новата парола.
- Устройството се рестартира. Влезте с новата парола.
Забравената парола може да се възстанови: паролата от стикера винаги може да се върне, а поддръжката може да зададе нова отдалечено. Вижте раздел 7.4.
3. Свързване на сензори
3.1 Device ID
Всеки TFA сензор има уникален 12-символен шестнадесетичен код (напр. 090005AC99E2):
- Приложението Mobile Alerts: Settings → Devices → изберете сензора → Device ID
- Стикерът на сензора: под капака на батерията
- Кутията: етикет с QR код
3.2 Добавяне
Отворете Настройки → TFA сензори и натиснете + Добави сензор за всеки сензор. Попълнете:
| Поле | Стойност |
|---|---|
| Device ID | 12-символен шестнадесетичен код, без разделители |
| Етикет | Кратко описание (напр. „Външно“, „Балкон“) |
Натиснете Запази. Устройството чете данните при следващата синхронизация (до 5 мин).
За синхронизация веднага натиснете еднократно бутона BOOT или бутона „Синхронизирай сега“ в Диагностика.
3.3 Проверка
Страницата Преглед показва сензорите с последните им стойности. Ако сензор не показва данни:
- Проверете 12-символния код за грешка при изписване.
- Проверете в приложението Mobile Alerts дали сензорът работи (батерия, обхват до шлюза).
4. Свързване към Weather Underground
4.1 Регистрация на станция в WU
Ако все още нямате регистрирана станция:
- Отворете https://www.wunderground.com/member/devices и изберете Add New Device.
- Попълнете местоположението.
- Запишете Station ID (напр.
IBANYA15) и Station Key.
4.2 Добавяне на станция
Отворете Настройки → Станции и натиснете + Добави станция. Попълнете полетата:
| Поле | Стойност |
|---|---|
| ID | предложеното (напр. wu1) |
| Име | по избор (напр. „Главна станция“) |
| Station ID | Station ID от WU |
| Парола | Station Key от WU |
| WU API ключ | по желание – нужен е за историята (вижте 6.5) |
| Активна | ✓ |
Натиснете Запази, след това Тест.
4.3 Тест
Бутонът Тест на всяка станция изпраща тестови стойности и показва отговора на WU:
- Тестът е успешен – данните за станцията са верни.
- Station ID или паролата не са приети – проверете ги в wunderground.com.
- При друга грешка се показва конкретният отговор на WU.
Тестът използва записаните стойности – първо натиснете „Запази“, след това „Тест“.
4.4 Съпоставяне на полетата
Страницата Съпоставяне определя кое поле от кой сензор към кой параметър на WU се изпраща. При повече от една станция всеки ред показва и станцията, към която се изпраща.
Полета от TFA сензора:
| Код | Значение |
|---|---|
t1, t2 |
Температура (канал 1 и 2) |
h |
Влажност |
r |
Кумулативен дъжд |
ws, wg, wd |
Вятър (скорост, пориви, посока) |
ap |
Атмосферно налягане |
Преобразувания (метрични единици → имперските единици на WU):
| Код | Преобразуване |
|---|---|
c2f |
°C → °F |
ms2mph |
m/s → mph |
hpa2inhg |
hPa → inHg |
idx2deg |
Посока (0–15) → градуси |
rain_hour |
mm за последния час |
rain_daily |
mm от полунощ |
none |
Без преобразуване |
Пълен пример има в Приложение А. Промените не се записват, докато не натиснете Запази; жълт банер напомня за незаписаните редове.
5. Наблюдение
5.1 Лента за състоянието
В горната част на страницата Преглед. До индикатора е изписана причината и какво да се направи.
| Индикатор | Значение |
|---|---|
| ✓ Работи нормално | Всичко е в норма |
| Не е настроено | Още няма добавен сензор или станция |
| ⚠ Внимание | Част от сензорите или станциите имат проблем, синхронизацията закъснява или всички станции са изключени |
| ✕ Проблем | Синхронизацията е спряла, станциите не приемат данни или сензорите не се виждат |
5.2 Автоматична работа
- Синхронизация с облака на TFA Mobile Alerts: на всеки 5 минути (настройва се)
- Изпращане към станциите: при всяка синхронизация
- Дневният дъжд се нулира в полунощ местно време
- Проверка за нова версия на фърмуера: на всеки час
5.3 Връзка с поддръжката
Бутонът Изпрати настройките в раздел Техническа поддръжка на страницата Преглед изпраща настройките и текущото състояние към техническата поддръжка. Поддръжката може да ги прегледа и коригира, без достъп до устройството. Устройството изпраща такава снимка и автоматично след промяна на настройките, за да е поддръжката информирана.
6. Отдалечен достъп
Станцията може да се преглежда, а при желание и да се управлява, и извън домашната мрежа – от компютър или телефон, в браузъра.
6.1 Включване
Отдалеченият достъп е изключен по подразбиране. Включва се само от домашната мрежа:
- Отворете Настройки → Сигурност → Отдалечен достъп.
- Изберете ниво и натиснете Запази.
| Ниво | Какво е достъпно отвън |
|---|---|
| Изключен | Нищо |
| Само табло | Показанията на сензорите и историята, без промени |
| Табло и управление | Освен това промени по сензорите, станциите и съпоставянето |
Достъпът започва да работи до минута след запазването. Нивото може да се смени или достъпът да се изключи по всяко време – отново от домашната мрежа.
6.2 Вход
Отворете https://remote.tfabridge.com/ и въведете ID на устройството – от стикера, полето „ID“ или MAC адреса. Влезте с потребителя и паролата от стикера.
Пряк адрес на устройството:
https://remote.tfabridge.com/r/XXXXXXXXXXXX/
След 10 неуспешни опита за вход достъпът от съответния интернет адрес спира за 15 минути.
6.3 Какво се вижда отдалеч
Отдалеч се отварят същите страници като в домашната мрежа. Данните в тях обаче идват от последната снимка на състоянието, която устройството изпраща към сървъра – при включване, веднъж на час и няколко секунди след всяка промяна на настройките. Затова показанията отдалеч може да са на възраст до около час; лентата в горната част на страницата показва колко.
При ниво „Табло и управление“ промените се записват на сървъра, а устройството ги прилага при следващата си проверка – обикновено до 5 минути.
Следните раздели и бутони не се показват отдалеч, защото работят само от домашната мрежа:
- Мрежа, Сигурност (включително настройката на отдалечения достъп) и Системни действия
- Архивиране и възстановяване, Корекция на дъжда
- Конфигурация от поддръжката и Обновяване на фърмуера
- „Тест“ на станциите, „Покажи наличните полета“ и „Синхронизирай сега“
6.4 Линк без парола
В Настройки → Сигурност → Линк без парола може да се създаде линк само към таблото. Който има линка, вижда показанията и историята, но не може да променя настройките. „Нов линк“ спира стария, „Спри линка“ го изключва. Линкът работи, само докато отдалеченият достъп е включен.
6.5 История
Графиките (Днес, 7 дни, 30 дни, Година) се зареждат директно от Weather Underground и не зависят от снимката на състоянието. Необходим е безплатен WU API ключ от профила на собственика на станцията: wunderground.com → профил → API Keys. Ключът се въвежда в Настройки → Станции → поле „WU API ключ“ на съответната станция. Без ключ таблото показва само текущите показания.
7. Диагностика и чести проблеми
7.1 Устройството не се появява в WiFi мрежата
| Причина | Решение |
|---|---|
| Слаб сигнал | Преместете устройството по-близо до рутера |
| Мрежа 5 GHz | Използвайте мрежа 2,4 GHz – 5 GHz не се поддържа |
| WPA3 Enterprise | Използвайте WPA2 Personal |
За нова настройка на WiFi без загуба на останалите настройки: натиснете бутона BOOT 3 пъти → портал TFA-Bridge-Setup.
7.2 Интерфейсът не се отваря
- Отворете интерфейса директно по IP адреса от рутера.
- Проверете дали устройството е в списъка с DHCP клиенти на рутера.
- Проверете връзката с ping от друго устройство в мрежата.
- Ако ping отговаря, но страницата не се отваря, изключете и включете захранването.
7.3 Смяна на WiFi мрежа
- Чрез портала за настройка (например при сменен рутер): натиснете бутона BOOT 3 пъти или Настройки → Мрежа → Отвори портала → свържете се с
TFA-Bridge-Setup→ изберете мрежата и въведете паролата ѝ. - От интерфейса: Настройки → Мрежа → Смяна на мрежа → име и парола на мрежата → „Смени WiFi и рестартирай“.
7.4 Забравена парола
- Стикерът: паролата от стикера важи отново след бутона „Върни паролата от стикера“ (Настройки → Сигурност → Смяна на парола) или след фабричен ресет.
- Поддръжката може да зададе нова парола отдалечено; устройството я прилага до 30 минути.
- Фабричен ресет (BOOT ≥ 3 сек) връща паролата от стикера, но изтрива всички настройки. Използва се само в краен случай.
7.5 Страница Диагностика
Страницата Диагностика показва последните заявки и отговори към облака на TFA Mobile Alerts и към станциите, с бутон „Копирай“ за всеки блок. Приложете съдържанието ѝ, когато съобщавате за проблем.
8. Бутон BOOT
Бутонът на устройството (означен BOOT; на Wemos – бутонът до USB порта):
| Действие | Резултат |
|---|---|
| 1 кратко натискане | Синхронизация веднага |
| 3 бързи натискания (< 2 сек) | Смяна на WiFi мрежата без загуба на настройките |
| Задържане ≥ 3 секунди | Фабричен ресет |
| Задържане при включване | Фабричен ресет (както задържане ≥ 3 сек) |
9. Обновяване на фърмуера
Устройството проверява за нова версия на всеки час и проверява целостта на всяко обновление преди инсталиране.
- С потвърждение (стандартно) – банер „Налична е нова версия на фърмуера“ → Обнови сега → около 30 сек → рестарт
- Автоматично – критичните поправки се инсталират без потвърждение
Ръчна проверка: Настройки → Сервизни настройки → Обновяване на фърмуера → „Провери сега“.
Не изключвайте захранването по време на обновяване.
10. Технически спецификации
| Параметър | ESP32-S3 | Wemos D1 Mini |
|---|---|---|
| Процесор | Xtensa dual-core 240 MHz | Xtensa 80/160 MHz |
| RAM | 8 MB PSRAM + 320 KB SRAM | 80 KB |
| Flash | 16 MB | 4 MB |
| Макс. сензори | 32 | 8 |
| Макс. станции | 8 | 4 |
| Захранване | USB-C 5 V | micro-USB 5 V |
| WiFi | 2,4 GHz (802.11 b/g/n) | 2,4 GHz (802.11 b/g/n) |
| Работна температура | −10…+40 °C | −10…+40 °C |
| Период на синхронизация | 60–3600 сек (стандартно 300) | 60–3600 сек (стандартно 300) |
11. Поддръжка
При проблем се свържете с поддръжката и посочете:
- MAC адреса (на стикера или в Диагностика → Системна информация)
- Кратко описание на проблема
Какво може поддръжката от разстояние:
- Да види настройките, показанията на сензорите и състоянието на станциите – от снимката, която устройството изпраща
- Да коригира настройките и да публикува обновления – устройството ги прилага само
- Да зададе нова парола при забравена
Какво поддръжката не прави:
- Не получава паролата на WiFi мрежата
- Няма достъп до други устройства в домашната мрежа
Приложение А: Типична настройка с 5 сензора
Сензори:
| Позиция | Тип | Device ID | Етикет |
|---|---|---|---|
| Външно | Т/влажност | 090005ABC001 |
Външна |
| Балкон | Т/влажност | 090005ABC002 |
Балкон |
| Дъждомер | Дъжд | 083D73ABC001 |
Дъжд |
| Вятър | Вятър | 0B25642ABC01 |
Вятър |
| Дневна | Т/влажност | 090005ABC003 |
Дневна |
Съпоставяне за Weather Underground:
| Сензор | TFA поле | WU поле | Преобразуване |
|---|---|---|---|
| Външна | t1 | tempf | c2f |
| Външна | h | humidity | none |
| Балкон | t1 | temp2f | c2f |
| Дъждомер | r | rainin | rain_hour |
| Дъждомер | r | dailyrainin | rain_daily |
| Вятър | ws | windspeedmph | ms2mph |
| Вятър | wg | windgustmph | ms2mph |
| Вятър | wd | winddir | idx2deg |
| Дневна | t1 | indoortempf | c2f |
| Дневна | h | indoorhumidity | none |
Тези 10 реда съпоставяне изпращат към WU пълния набор от данни.
Приложение Б: Основни адреси
| Ресурс | URL |
|---|---|
| Преглед | http://tfa-bridge-XXXXXX.local/ |
| Настройки | http://tfa-bridge-XXXXXX.local/settings |
| Диагностика | http://tfa-bridge-XXXXXX.local/diagnostics |
| Отдалечен достъп | https://remote.tfabridge.com/r/XXXXXXXXXXXX/ |
| Ръководство | https://remote.tfabridge.com/manual |
| Станцията в WU | https://www.wunderground.com/dashboard/pws/[Station ID] |
v0.18 · TFA Bridge · Made in Bulgaria