Подключение Samsung TV к Tizen Studio выполняется через Remote Device Manager или консольную утилиту sdb после включения режима разработчика на телевизоре. Для успешной пары оба устройства должны находиться в одной подсети, а на экране ТВ нужно подтвердить RSA-отпечаток ключа компьютера. Ниже описан полный цикл от настройки телевизора до отладки приложения на реальном железе.
Процесс отличается от стандартного ADB подключения Android-устройств: Tizen использует собственный протокол Smart Development Bridge (SDB) на порту 26101. Отсутствие открытого порта в брандмауэре Windows или несовпадение версий SDK и прошивки ТВ — частые причины ошибки connection refused.
Подготовка телевизора: включение режима разработчика
Зайдите в Apps (Приложения), нажмите кнопку настройки (шестеренка) в правом верхнем углу и выберите Developer Mode (Режим разработчика). Система запросит пин-код профиля (по умолчанию 1234 или заданный пользователем) и IP-адрес хоста — введите IPv4-адрес компьютера, с которого планируете подключение.
После перезагрузки Smart Hub в меню настроек появится пункт Developer Mode со статусом «Включено». Здесь же генерируется уникальный DUID (Device Unique ID), необходимый для выпуска сертификатов автора и распространителя. Без активного режима разработчика ТВ не будет принимать входящие SDB-соединения.
🟢 Включите Developer Mode через Apps → Settings → Developer Mode.
🟢 Укажите IP-адрес ПК в поле «Host IP» для автоматического добавления в белый список.
🟢 Запомните или скопируйте DUID — он пригодится для создания сертификатов в Tizen Studio.
🟢 Перезагрузите телевизор, если пункт меню не появился сразу.
⚠️ Внимание: На моделях 2018–2020 годов пути меню могут отличаться: ищите «Режим разработчика» в разделе «Поддержка» или «Система». Точную схему уточняйте в руководстве по конкретной серии (RU, TU, QN, LS).
Настройка сети и определение IP-адреса ТВ
Компьютер и телевизор должны находиться в одной L2-сегменте (одна подсеть, без изоляции клиентов AP Isolation). Рекомендуется подключить оба устройства кабелем к одному роутеру или использовать 5 ГГц Wi-Fi для стабильности передачи бинарников.
Узнайте IP телевизора: Settings → General → Network → Network Status → IP Settings. Запишите IPv4-адрес (например, 192.168.1.45). Если ТВ получает адрес по DHCP, зафиксируйте его в настройках роутера привязкой по MAC-адресу, чтобы не искать его после каждой перезагрузки.
Проверьте доступность с ПК командой ping 192.168.1.45. Успешный ответ подтверждает L3-связность. Если пинг проходит, но SDB не коннектится — проблема в брандмауэре или порту 26101.
Установка и базовая настройка Tizen Studio на компьютере
Скачайте установщик Tizen Studio с официального портала разработчика Samsung (developer.samsung.com/tizen). Запустите tizen-studio-web-installer.exe, выберите пакет Baseline SDK — он включает sdb, эмуляторы и Certificate Manager. Установку лучше проводить в путь без кириллицы и пробелов, например C:\tizen-studio.
После установки запустите Package Manager и обновите все компоненты до последних версий. Устаревший sdb может не поддерживать прошивки новых линеек Neo QLED или The Frame. Добавьте папку tools/sdb в системную переменную PATH, чтобы вызывать утилиту из любой консоли.
В Certificate Manager создайте профиль автора (Author Certificate) и профиль распространителя (Distributor Certificate). Для Distributor укажите сохраненный ранее DUID телевизора. Без валидного distributor-сертификата установка .wgt-пакетов на реальном устройстве завершится ошибкой signature verification failed.
Подключение через Remote Device Manager (GUI)
Откройте Tizen Studio → меню Tools → Device Manager. В панели слева выберите вкладку Remote Device Manager. Нажмите значок «+» (Add Device), введите IP-адрес ТВ и порт 26101, нажмите Connect.
На экране телевизора появится диалоговое окно: «Разрешить подключение от устройства с отпечатком RSA: SHA256:...». Выберите OK (Allow). В Device Manager статус устройства сменится на Connected, появится иконка монитора с галочкой. Теперь можно нажимать Run As → Tizen Web Application прямо из IDE.
🟢 Откройте Device Manager → Remote Device Manager.
🟢 Нажмите «+», введите IP ТВ и порт 26101.
🟢 Подтвердите RSA-отпечаток на экране телевизора.
🟢 Проверьте статус «Connected» перед запуском приложения.
☑️ Чек-лист перед первым подключением через GUI
Подключение через командную строку (sdb)
Консольный метод удобен для CI/CD, скриптов и быстрой диагностики. Откройте терминал (PowerShell или cmd) и выполните:
sdb connect 192.168.1.45:26101Утилита вернет connected to 192.168.1.45:26101 и на ТВ покажет то же окно подтверждения RSA-ключа. После подтверждения повторите команду — она сообщает already connected. Проверьте список устройств:
sdb devicesВывод должен содержать строку с IP ТВ и статусом device. Если видите unauthorized — не подтвердили отпечаток на экране. Если offline — разорвалось соединение, попробуйте sdb kill-server и подключите заново.
Для установки приложения используйте sdb install -r myapp.wgt, для запуска — sdb shell app_launcher -s com.example.myapp. Логи доступны через sdb dlog или в вкладке Log Viewer внутри Tizen Studio.
⚠️ Внимание: Брандмауэр Windows по умолчанию блокирует входящие соединения на порт 26101. Создайте правило для входящих подключений TCP 26101 для процесса sdb.exe или временно отключите профиль «Общественная сеть» для текущего адаптера.
Типичные ошибки подключения и их устранение
Ошибка connection refused или таймаут. Проверьте: режим разработчика активен, IP верный, пинг проходит, порт 26101 открыт в фаерволе. Перезапустите SDB-сервер: sdb kill-server && sdb start-server. На ТВ выключите и включите Developer Mode — это сбрасывает таблицу авторизованных хостов.
Статус unauthorized в sdb devices. На экране ТВ не подтвержден RSA-диалог. Иногда диалог скрыт за запущенным приложением — нажмите кнопку «Home» на пульте, вернитесь в Smart Hub, подтверждение всплывет поверх интерфейса.
Ошибка установки signature verification failed. Distributor-сертификат не соответствует DUID телевизора или истек срок действия (1 год). Перегенерация сертификата в Certificate Manager с актуальным DUID решает проблему. Убедитесь, что профиль выбран как Active в настройках проекта (Properties → Tizen Studio → Package → Certificate).
Нюансы работы с сертификатами на Tizen 6.5 и выше
Начиная с Tizen 6.5 (модели 2021+), Samsung ужесточила политику подписи. Distributor Certificate теперь привязывается не только к DUID, но и к региону аккаунта разработчика. Если ТВ куплен в другом регионе, чем аккаунт Samsung Developers, установка может блокироваться политикой Smart Hub. В таком случае помогает смена региона в настройках Smart Hub (последовательность кнопок пульта: Forward 2, 8, 9, Forward) или использование тестового аккаунта региона ТВ. Также проверяйте, что в Author Certificate указан правильный Privilege Level (Partner или Public) в зависимости от используемых API.
Работа с приложениями: запуск, отладка и логи
После успешного подключения в Project Explorer нажмите правой кнопкой на проекте → Run As → Tizen Web Application. IDE соберет .wgt, передаст по SDB, установит и запустит. Консоль Console View покажет ход деплоя: Transferring... → Installing... → Launching....
Для отладки JS-кода используйте Web Inspector. В Device Manager напротив подключенного ТВ нажмите иконку «паука» (Inspect) — откроется Chrome DevTools, прикрепленный к процессу WebKit на телевизоре. Работают брейкпоинты, Console, Network, Memory. Латентность инспектора выше, чем в эмуляторе, но окружение настоящее.
Системные логи читаются через sdb shell dlog или вкладку Log Viewer (Window → Show View → Log). Фильтруйте по тегу приложения (APP_TAG) или PID. Полезно перенаправить вывод в файл: sdb dlog > tv_logs.txt для анализа утечек памяти или крашей нативных модулей.
⚠️ Внимание: Web Inspector требует включенной опции «Web Inspector» в меню Developer Mode на ТВ. На некоторых прошивках она сбрасывается после обновления ОС — проверяйте галочку перед стартом отладки.
Используйте `sdb forward tcp:8000 tcp:8000` для проброса портов, если ваше веб-приложение обращается к локальному бэкенду на ПК. ТВ будет ходить на `localhost:8000`, а трафик уйдет на машину разработчика.
Главное правило стабильной отладки: фиксированный IP ТВ, открытый порт 26101, актуальные сертификаты с верным DUID и подтвержденный RSA-отпечаток. Остальное — дело техники.
| Параметр | GUI (Device Manager) | CLI (sdb) | Примечание |
|---|---|---|---|
| Скорость первого подключения | Средняя (клики мышью) | Высокая (одна команда) | CLI удобен для скриптов |
| Видимость RSA-диалога | Автоматический фокус | Требует ручного переключения на ТВ | GUI надежнее для новичков |
| Управление сертификатами | Встроенный Certificate Manager | Только через CLI утилиты | GUI предпочтительнее |
| Автоматизация CI/CD | Не поддерживается | Полная поддержка | CLI обязателен для автосборок |
| Диагностика ошибок сети | Ограниченные логи | Полный вывод в консоль | CLI информативнее |
Часто задаваемые вопросы (FAQ)
Почему ТВ не видно в списке устройств при сканировании?
Сканирование (mDNS) работает только в одной широковещательной подсети. Если ПК и ТВ разделены VLAN или гостевой Wi-Fi — добавьте устройство вручную по IP. Также проверьте, что на ТВ включен «Network Discovery» в настройках сети (если доступно).
Можно ли подключиться по USB-кабелю вместо Wi-Fi?
Tizen TV не поддерживают ADB-over-USB или SDB-over-USB в пользовательском режиме. Порт USB на ТВ предназначен для носителей и периферии. Единственный способ — сеть (Ethernet/Wi-Fi).
Что делать, если после обновления прошивки пропал Developer Mode?
Обновление ОС сбрасывает настройки разработчика. Зайдите в Apps → Settings снова, включите режим, введите IP ПК и DUID (он не меняется). Сертификаты в Tizen Studio остаются валидными, если DUID совпадает.
Как отладить приложение на ТВ без Tizen Studio (только браузер)?
Включите «Web Inspector» в Developer Mode на ТВ. В браузере на ПК откройте http://IP_ТВ:7011 — откроется список запущенных веб-приложений с ссылками на инспектор. Работает без установки SDK, но требует доступного порта 7011.
Нужен ли аккаунт Samsung Developers для подключения?
Для самого подключения (sdb connect) — нет. Аккаунт и вход в Tizen Studio нужны только для генерации Distributor Certificate (требует логина на портале) и публикации в Galaxy Store. Локальная отладка работает офлайн.