SamsungTV модуль
автор: vashal от 23.01.2020
Описание
Модуль управления телевизорами Samsung с TizenOS
Установка модуля
Установка осуществляется через Маркет дополнений в разделе Оборудование- SamsungTV.
Важно:
ВНИМАНИЕ!!! Модуль работает с устройствами, выпущенными не ранее 2016 года и с обновленными прошивками. Если вы ограничили загрузку обновлений на телевизор для взаимодействия с какими-либо программами, то, скорее всего, модуль не будет взаимодействовать с вашим устройством.
'Все действия', связанные с обновлением вашего устройства, вы делаете на свой страх и риск и автор модуля не несет никакой ответственности за это. Равно как и не гарантирует возможности взаимодействия модуля с вашим устройством после обновления.
Общие сведения
Модуль предназначен для интеграции смарт-телевизоров Samsung на платформе Tizen.
Возможности модуля:
- ручное добавление ТВ по IP адресу;
- поддержка нескольких ТВ;
- определение доступности ТВ;
- получение громкости ТВ;
- управление ТВ (каналы, источники, приложения, громкость, выключение). Для добавления телевизора нажмите кнопку +Добавить, введите IP адрес и придумайте название телевизора. После нажатия кнопки Добавить телевизор запросит разрешение на сопряжение с модулем. Отвечаем утвердительно, и после этого телевизор появится в списке устройств в модуле
Так как Samsung не предоставляет открытое API для управления своими телевизорами, в модуле собрано несколько типов управления, добытых из открытых источников:
- wss-соединение(SSL Websocket) на порту 8002 - отправка команд, запрос приложений, открытие сайтов встроенным браузером;
- POST запросы на порт 8001 для управления(запуск, закрытие, статус) приложениями;
- протокол SOAP на порту 9197 для считывания уровня громкости, установки громкости;
- Wake-on-lan для запуска выключенного телевизора (не испытывался на Wi-Fi соединении).
Модуль реализует классическую концепцию MajorDoMo для взаимодействия с пользователем через привязанные к определенным командам или приложениям свойства объекта. Объекты и свойства создаются пользователем самостоятельно. В модуле уже добавлены основные команды управления телевизором, но вы можете добавить свою. Список доступных команд см. ниже
В модуле имеется цикл, который раз в 10 секунд опрашивает состояние ТВ, а именно определяет, какое приложение запущено в данный момент, и запрашивает уровень громкости.
Список команд
Список ключей может различаться в зависимости от модели телевизора. Ниже приведены некоторые общие коды и их описания. Не все ключи могут работать конкретно на вашей модели телевизора.
Power keys
| Ключ | Действие |
|---|---|
| KEY_POWER | PowerToggle |
Input keys
| Ключ | Действие |
|---|---|
| KEY_SOURCE | Source |
| KEY_COMPONENT1 | Component1 |
| KEY_COMPONENT2 | Component2 |
| KEY_AV1 | AV1 |
| KEY_AV2 | AV2 |
| KEY_AV3 | AV3 |
| KEY_SVIDEO1 | SVideo1 |
| KEY_SVIDEO2 | SVideo2 |
| KEY_SVIDEO3 | SVideo3 |
| KEY_HDMI | HDMI |
| KEY_HDMI1 | HDMI1 |
| KEY_HDMI2 | HDMI2 |
| KEY_HDMI3 | HDMI3 |
| KEY_HDMI4 | HDMI4 |
| KEY_FM_RADIO | FMRadio |
| KEY_DVI | DVI |
| KEY_DVR | DVR |
| KEY_TV | TV |
| KEY_ANTENA | AnalogTV |
| KEY_DTV | DigitalTV |
Number keys
| Ключ | Действие |
|---|---|
| KEY_1 |    1 |
| KEY_2 |    2 |
| KEY_3 |    3 |
| KEY_4 |    4 |
| KEY_5 |    5 |
| KEY_6 |    6 |
| KEY_7 |    7 |
| KEY_8 |    8 |
| KEY_9 |    9 |
| KEY_0 |    0 |
Misc keys
| Ключ | Действие |
|---|---|
| KEY_PANNEL_CHDOWN | 3D |
| KEY_ANYNET | AnyNet+ |
| KEY_ESAVING | EnergySaving |
| KEY_SLEEP | SleepTimer |
| KEY_DTV_SIGNAL | DTVSignal |
Channel keys
| Ключ | Действие |
|---|---|
| KEY_CHUP | ChannelUp |
| KEY_CHDOWN | ChannelDown |
| KEY_PRECH | PreviousChannel |
| KEY_FAVCH | FavoriteChannels |
| KEY_CH_LIST | ChannelList |
| KEY_AUTO_PROGRAM | AutoProgram |
| KEY_MAGIC_CHANNEL | MagicChannel |
Volume keys
| Ключ | Действие |
|---|---|
| KEY_VOLUP | VolumeUp |
| KEY_VOLDOWN | VolumeDown |
| KEY_MUTE | Mute |
Direction keys
| Ключ | Действие |
|---|---|
| KEY_UP | NavigationUp |
| KEY_DOWN | NavigationDown |
| KEY_LEFT | NavigationLeft |
| KEY_RIGHT | NavigationRight |
| KEY_RETURN | NavigationReturn/Back |
| KEY_ENTER | NavigationEnter |
Media keys
| Ключ | Действие |
|---|---|
| KEY_REWIND | Rewind |
| KEY_STOP | Stop |
| KEY_PLAY | Play |
| KEY_FF | FastForward |
| KEY_REC | Record |
| KEY_PAUSE | Pause |
| KEY_LIVE | Live |
| KEY_QUICK_REPLAY | fnKEY_QUICK_REPLAY |
| KEY_STILL_PICTURE | fnKEY_STILL_PICTURE |
| KEY_INSTANT_REPLAY | fnKEY_INSTANT_REPLAY |
Picture in Picture
| Ключ | Действие |
|---|---|
| KEY_PIP_ONOFF | PIPOn/Off |
| KEY_PIP_SWAP | PIPSwap |
| KEY_PIP_SIZE | PIPSize |
| KEY_PIP_CHUP | PIPChannelUp |
| KEY_PIP_CHDOWN | PIPChannelDown |
| KEY_AUTO_ARC_PIP_SMALL | PIPSmall |
| KEY_AUTO_ARC_PIP_WIDE | PIPWide |
| KEY_AUTO_ARC_PIP_RIGHT_BOTTOM | PIPBottomRight |
| KEY_AUTO_ARC_PIP_SOURCE_CHANGE | PIPSourceChange |
| KEY_PIP_SCAN | PIPScan |
Modes
| Ключ | Действие |
|---|---|
| KEY_VCR_MODE | VCRMode |
| KEY_CATV_MODE | CATVMode |
| KEY_DSS_MODE | DSSMode |
| KEY_TV_MODE | TVMode |
| KEY_DVD_MODE | DVDMode |
| KEY_STB_MODE | STBMode |
| KEY_PCMODE | PCMode |
Color keys
| Ключ | Действие |
|---|---|
| KEY_GREEN | Green |
| KEY_YELLOW | Yellow |
| KEY_CYAN | Cyan |
| KEY_RED | Red |
Teletext
| Ключ | Действие |
|---|---|
| KEY_TTX_MIX | TeletextMix |
| KEY_TTX_SUBFACE | TeletextSubface |
AspectRatio
| Ключ | Действие |
|---|---|
| KEY_ASPECT | AspectRatio |
| KEY_PICTURE_SIZE | PictureSize |
| KEY_4_3 | AspectRatio4:3 |
| KEY_16_9 | AspectRatio16:9 |
| KEY_EXT14 | AspectRatio3:4(Alt) |
| KEY_EXT15 | AspectRatio16:9(Alt) |
Picture Mode
| Ключ | Действие |
|---|---|
| KEY_PMODE | PictureMode |
| KEY_PANORAMA | PictureModePanorama |
| KEY_DYNAMIC | PictureModeDynamic |
| KEY_STANDARD | PictureModeStandard |
| KEY_MOVIE1 | PictureModeMovie |
| KEY_GAME | PictureModeGame |
| KEY_CUSTOM | PictureModeCustom |
| KEY_EXT9 | PictureModeMovie(Alt) |
| KEY_EXT10 | PictureModeStandard(Alt) |
Menus
| Ключ | Действие |
|---|---|
| KEY_MENU | Menu |
| KEY_TOPMENU | TopMenu |
| KEY_TOOLS | Tools |
| KEY_HOME | Home |
| KEY_CONTENTS | Contents |
| KEY_GUIDE | Guide |
| KEY_DISC_MENU | DiscMenu |
| KEY_DVR_MENU | DVRMenu |
| KEY_HELP | Help |
OSD
| Ключ | Действие |
|---|---|
| KEY_INFO | Info |
| KEY_CAPTION | Caption |
| KEY_CLOCK_DISPLAY | ClockDisplay |
| KEY_SETUP_CLOCK_TIMER | SetupClock |
| KEY_SUB_TITLE | Subtitle |
Zoom
| Ключ | Действие |
|---|---|
| KEY_ZOOM_MOVE | ZoomMove |
| KEY_ZOOM_IN | ZoomIn |
| KEY_ZOOM_OUT | ZoomOut |
| KEY_ZOOM1 | Zoom1 |
| KEY_ZOOM2 | Zoom2 |
Other keys
| Ключ | Действие |
|---|---|
| KEY_WHEEL_LEFT | WheelLeft |
| KEY_WHEEL_RIGHT | WheelRight |
| KEY_ADDDEL | Add/Del |
| KEY_PLUS100 | Plus100 |
| KEY_AD | AD |
| KEY_LINK | Link |
| KEY_TURBO | Turbo |
| KEY_CONVERGENCE | Convergence |
| KEY_DEVICE_CONNECT | DeviceConnect |
| KEY_11 | KEY11 |
| KEY_12 | KEY12 |
| KEY_FACTORY | KEYFactory |
| KEY_3SPEED | KEY3SPEED |
| KEY_RSURF | KEYRSURF |
| KEY_FF_ | FF_ |
| KEY_REWIND_ | REWIND_ |
| KEY_ANGLE | Angle |
| KEY_RESERVED1 | Reserved1 |
| KEY_PROGRAM | Program |
| KEY_BOOKMARK | Bookmark |
| KEY_PRINT | |
| KEY_CLEAR | Clear |
| KEY_VCHIP | VChip |
| KEY_REPEAT | Repeat |
| KEY_DOOR | Door |
| KEY_OPEN | Open |
| KEY_DMA | DMA |
| KEY_MTS | MTS |
| KEY_DNIe | DNIe |
| KEY_SRS | SRS |
| KEY_CONVERT_AUDIO_MAINSUB | ConvertAudioMain/Sub |
| KEY_MDC | MDC |
| KEY_SEFFECT | SoundEffect |
| KEY_PERPECT_FOCUS | PERPECTFocus |
| KEY_CALLER_ID | CallerID |
| KEY_SCALE | Scale |
| KEY_MAGIC_BRIGHT | MagicBright |
| KEY_W_LINK | WLink |
| KEY_DTV_LINK | DTVLink |
| KEY_APP_LIST | ApplicationList |
| KEY_BACK_MHP | BackMHP |
| KEY_ALT_MHP | AlternateMHP |
| KEY_DNSe | DNSe |
| KEY_RSS | RSS |
| KEY_ENTERTAINMENT | Entertainment |
| KEY_ID_INPUT | IDInput |
| KEY_ID_SETUP | IDSetup |
| KEY_ANYVIEW | AnyView |
| KEY_MS | MS |
| KEY_MORE | |
| KEY_MIC | |
| KEY_NINE_SEPERATE | |
| KEY_AUTO_FORMAT | AutoFormat |
| KEY_DNET | DNET |
Auto Arc keys
| Ключ | |
|---|---|
| KEY_AUTO_ARC_C_FORCE_AGING | |
| KEY_AUTO_ARC_CAPTION_ENG | |
| KEY_AUTO_ARC_USBJACK_INSPECT | |
| KEY_AUTO_ARC_RESET | |
| KEY_AUTO_ARC_LNA_ON | |
| KEY_AUTO_ARC_LNA_OFF | |
| KEY_AUTO_ARC_ANYNET_MODE_OK | |
| KEY_AUTO_ARC_ANYNET_AUTO_START | |
| KEY_AUTO_ARC_CAPTION_ON | |
| KEY_AUTO_ARC_CAPTION_OFF | |
| KEY_AUTO_ARC_PIP_DOUBLE | |
| KEY_AUTO_ARC_PIP_LARGE | |
| KEY_AUTO_ARC_PIP_LEFT_TOP | |
| KEY_AUTO_ARC_PIP_RIGHT_TOP | |
| KEY_AUTO_ARC_PIP_LEFT_BOTTOM | |
| KEY_AUTO_ARC_PIP_CH_CHANGE | |
| KEY_AUTO_ARC_AUTOCOLOR_SUCCESS | |
| KEY_AUTO_ARC_AUTOCOLOR_FAIL | |
| KEY_AUTO_ARC_JACK_IDENT | |
| KEY_AUTO_ARC_CAPTION_KOR | |
| KEY_AUTO_ARC_ANTENNA_AIR | |
| KEY_AUTO_ARC_ANTENNA_CABLE | |
| KEY_AUTO_ARC_ANTENNA_SATELLITE |
Panel keys
| Ключ | Действие |
|---|---|
| KEY_PANNEL_POWER | |
| KEY_PANNEL_CHUP | |
| KEY_PANNEL_VOLUP | |
| KEY_PANNEL_VOLDOW | |
| KEY_PANNEL_ENTER | |
| KEY_PANNEL_MENU | |
| KEY_PANNEL_SOURCE | |
| KEY_PANNEL_ENTER |
Extended keys
| Ключ | |
|---|---|
| KEY_EXT1 | |
| KEY_EXT2 | |
| KEY_EXT3 | |
| KEY_EXT4 | |
| KEY_EXT5 | |
| KEY_EXT6 | |
| KEY_EXT7 | |
| KEY_EXT8 | |
| KEY_EXT11 | |
| KEY_EXT12 | |
| KEY_EXT13 | |
| KEY_EXT16 | |
| KEY_EXT17 | |
| KEY_EXT18 | |
| KEY_EXT19 | |
| KEY_EXT20 | |
| KEY_EXT21 | |
| KEY_EXT22 | |
| KEY_EXT23 | |
| KEY_EXT24 | |
| KEY_EXT25 | |
| KEY_EXT26 | |
| KEY_EXT27 | |
| KEY_EXT28 | |
| KEY_EXT29 | |
| KEY_EXT30 | |
| KEY_EXT31 | |
| KEY_EXT32 | |
| KEY_EXT33 | |
| KEY_EXT34 | |
| KEY_EXT35 | |
| KEY_EXT36 | |
| KEY_EXT37 | |
| KEY_EXT38 | |
| KEY_EXT39 | |
| KEY_EXT40 | |
| KEY_EXT41 |
Управление ТВ
Отправка команд на ТВ выполняется с помощью привязанного к ним свойства объекта путем записи в это свойство команды через функцию setGlobal() или иным способом. Возможные команды приведены в таблице ниже.
Пример:
setGlobal('TV1.Power', '1');
// Или сокращенная форма setGlobal
sg('TV1.Volume', '-3');
// Открытие сайта в браузере
sg('TV1.URL', 'yandex.ru');
При добавлении в модуль телевизора, с ним автоматически добавляются часто используемые команды. Их описание в таблице ниже.
Команда Описание Значения
Команда В привязанное к этой команде свойство вы можете написать любую команду из списка выше и она будет передана в чистом виде на телевизор. Любая команда из списка выше
ВКЛ/ВЫКЛ Выключение и включение ТВ Включение ТВ с помощью WOL (только для подключения ТВ по ethernet). Поддерживается не всеми моделями ТВ. 1 - включить, 0 - выключить
Управление громкостью Управление громкостью. Положительное число - прибавить на заданное количество пунктов. Отрицательное число - убавить на заданное количество пунктов. 0 - MUTE
Установка громкости Установка уровня громкости. 1-100
Управление каналами Переключение каналов. 1 - канал вперед, 0 - список каналов, -1 - канал назад
Навигация Управление курсором. 0 или ENTER или OK - кнопка ENTER, 1 или LEFT - влево, 2 или UP - вверх, 3 или RIGHT - вправо, 4 или DOWN - вниз.
Назад Кнопка НАЗАД Любое значение
Меню Кнопка МЕНЮ Любое значение
Домой Кнопка ДОМОЙ Любое значение
Стоп Кнопка СТОП Любое значение
Воспроизведение Кнопка ПЛЭЙ Любое значение
HDMI Первый источник HDMI Любое значение
HDMI1 Второй источник HDMI Любое значение
Цифровые кнопки Ввод цифр. Например, для переключения каналов Любое положительное цифровое значение
Цветные кнопки Цветные кнопки на пульте 1 или RED - красная кнопка, 2 или GREEN - зеленая кнопка, 3 или YELLOW - желтая кнопка, 4 или BLUE - синяя кнопка.
Аналогично происходит управление приложениями. В привязанном свойстве возможны значения 1 - запустить, 0 - закрыть.
Первое приложение Internet - запускает браузер с URL, записанным в значение свойства.
Если вы установили новое приложение, то для того, чтоб оно появилось в модуле, нажмите кнопку Обновить внизу списка приложений.
Встроенные функции
Модулем также можно управлять с помощью встроенных функций. В любой функции в качестве имени устройства можно использовать его ID, название или IP-адрес.
Функция Описание Пример
STVPowerOn(Имя устройства) Включение телевизора. STVPowerOn('Телевизор в зале');
STVPowerOff(Имя устройства) Включение телевизора STVPowerOff('192.168.0.106');
STVVolUp(Имя устройства, значение) Прибавить громкость. Если не написать значение, громкость будет прибавлена на 1 STVVolUp('Телевизор в зале');
STVVolUp('192.168.0.106', 4);
STVVolDown(Имя устройства, значение) Убавить громкость. Если не написать значение, громкость будет убавлена на 1 STVVolDown('Телевизор в зале');
STVVolDown('192.168.0.106', 4);
STVGetVol(Имя устройства) Запрос текущей громкости ТВ STVGetVol('Телевизор в зале');
STVSetVol(Имя устройства, значение) Установка громкости на устройстве STVSetVol('192.168.0.106', 15);
STVChUp(Имя устройства) Переключение канала вперед STVChUp('Телевизор в зале');
STVChDown(Имя устройства) Переключение канала назад STVChDown('192.168.0.106');
STVEnter(Имя устройства) Кнопка ENTER STVEnter('Телевизор в зале');
STVSendURL(Имя устройства, url) Открытие ссылки в браузере STVSendURL('192.168.0.106', 'yandex.ru');
STVSendKey(Имя устройства, ключ) Отправка любого ключа из списка выше на ТВ STVSendKey('Телевизор в зале', 'KEY_VOLUP');
STVStatus(Имя устройства) Получение информации о доступности устройства (TRUE/FALSE) STVStatus('192.168.0.106');
