Samsung Television IP Driver

IP Control driver for the 7 Series models of Samsung Televisions. Written using 49" MU7000.

Version

1.0 The original release of the driver

1.01 Adds support for art mode. Adds fix for mute toggle. Adds fix for heartbeat functions taking too much CPU time.

1.02 Adds change to force user to use correct firmware version

1.03 Adds the Cable/Satellite TV page to APEX

1.04 Adds support for ambient mode. The Netmask is no longer required in the configuration. The driver takes care of getting the netmask from the XP processor.

1.05 Modified Volume Increment repeat rate and adjusted volume feedback.

1.06 Changed default port to 1516 to match a change made by Samsung for 2020 models.

1.07 Fixed authentication issue on North American TVs.

1.08 Fixed issue with HTTPFail spamming logs with logging turned off on the driver.

1.09 Added new configuration item for TV model year (pre/post 2024). Wake On LAN is only available pre-2024.

Connection

Connection Type - Driver supports IP control only

Network - Static Entry, UPnP(Friendly Name or Serial Number), Connection Needs To Be Enabled, See Below.

Authorization

The television requires initial authorization on the first boot up of the driver. Subsequent boot ups will retrieve the authorization token from persistence memory. A boolean variable is available to provide for "Authorization Required" visibility. Once the "Get Authorization" command is sent, an on screen prompt will appear (this requires television to be powered on). Using the television's remote, click "Allow" on the prompt. **Choosing Deny twice will black list the driver - DO NOT DENY ACCESS**

Televisions - Driver supports up to 16 televisions with one instance

Name - The name of the television

Model Year - TV model year. User can choose from pre/post 2024.

TCP Address - The IP Address

TCP Port - The Port Number, default is 1516. The default for pre-2020 models was 1515

Wake On LAN Port - Wake On LAN port number. Only relevant for TV models pre-2024. Will not be utilized for TV models that are post-2024.

Mac Address - The MAC address of the TV. Used for Wake on LAN. (On test device, MAC address was found in the Settings/Support/About This TV)

Notes -

· Keypad object allows you to send channel commands by inputing the channel number then pressing enter

· Power On - Power on commands utilize Wake On Lan (when TV is in deep sleep) for pre-2024 TV models. Post-2024 do not utilize Wake On Lan.

· UPnP - when using UPnP it is possible to send a power on command (WoL) and have the device respond, but not be "found" yet in the discovery process. Control commands will only function once the device is found.

· Certain Variables (Picture Mode, Color, Tint...) will not populate or update on certain Source types (PC for example)

· Enable Connection Procedure: Enter Settings --> General --> Network --> Expert --> IP Remote --> Enable.

· Commands will fail if "Art Mode" is on/enabled on a supported TV. Art Mode must be turned back off to regain regular control (volume, color, contrast, etc.)

· Certain Variables (Color, Brightness, Contrast, Sharpness, Tint) have separate variables based on the TV model year and will only populate one set. Pre-2024 TVs use the standard variables, Post-2024 TVs use the new variables - (Brightness (0-50), etc.)

· The tint command/variable for TVs 2024 and newer do not use a scale with numerical values. It uses values of R15-G15 and must be done with buttons rather than a slider.