Settings Spec
RS-232C
| Setting Item | Type / Default | Parameter Value | Notes |
|---|---|---|---|
| RS-232C Control Setting ID: rs232c-control | Type: Enum Default: Standard | – Off: Off – Standard: Via HDMI port – VDA: Via serial port | Standard: Via HDMI port VDA: Via serial port |
HDMI Input Picture
X: Enter HDMI input number
| Android TV OS | Setting / ID | Type / Default | Parameter Value | Notes | Supported Model | ||||
|---|---|---|---|---|---|---|---|---|---|
| 10*1 | 12 | HDMI1 | HDMI2 | HDMI3 | HDMI4 | ||||
| △*2 | 〇 | HDMI Picture Mode Setting ID: picture-mode-hdmiX | Type: Enum Default: Standard | Vivid, Standard, Cinema, Game, Graphics, Photo, Custom | Vivid, Standard, Cinema, Game, Graphics, Photo, Custom | Vivid, Standard, Cinema, Game, Graphics, Photo, Custom | Vivid, Standard, Cinema, Game, Graphics, Photo, Custom | May increase power consumption | Cloud API-compatible models |
| 〇 | 〇 | HDMI Brightness Setting ID: brightness-hdmiX | Type: Number Default: 35 | Range: 0-50 | Range: 0-50 | Range: 0-50 | Range: 0-50 | 0 may increase power consumption | Cloud API-compatible models |
| 〇 | 〇 | HDMI Auto Picture Mode Setting ID: auto-picture-mode-enabled-hdmiX | Type: Boolean Default: false | true / false | true / false | true / false | true / false | true may increase power consumption | Cloud API-compatible models |
| 〇 | 〇 | HDMI Light Sensor*3 Setting ID: light-sensor-enabled-hdmiX | Type: Boolean Default: true | true / false | true / false | true / false | true / false | false may increase power consumption | BZ30L, BZ35L, BZ40L, BZ40H, BZ30J, BZ35J |
| 〇 | 〇 | HDMI Ambient Light Sensor*3 Setting ID: ambient-light-sensor-enabled-hdmiX | Type: Boolean Default: true | true / false | true / false | true / false | true / false | -false may increase power consumption -Depending on settings, the following are also imported simultaneously: ‣ambient-light-sensor-light-enabled(Brightness) ‣ambient-light-sensor-gamma- enabled(Tone Curve) | BZ30L(98inch), BZ50L, BZ53L, BZ40J |
| 〇 | Brightness Setting ID: ambient-light-sensor-light-enabled-hdmiX | Type: Boolean Default: true | true / false | true / false | true / false | true / false | BZBZ30L(98inch), BZ50L, BZ53L, BZ40J | ||
| 〇 | Tone Curve Setting ID: ambient-light-sensor-gamma-enabled-hdmiX | Type: Boolean Default: true | true / false | true / false | true / false | true / false | BZ30L(98inch), BZ50L, BZ30L(98inch), BZ50L, BZ53L, BZ40J | ||
*1 Supported with firmware 6.7283 or higher.
*2 Android TV OS 10 HDMI2-HDMI4 do not support [Game] / [Graphics] modes.
*3 Set the light sensor value according to the target model.
Video Input Picture Settings
X: Enter Video input number
| Setting Item | Type / Default | Parameter Value | Notes | Supported Model | |
|---|---|---|---|---|---|
| Video1 | Video2 | ||||
| Video Picture Mode Setting ID: picture-mode-videoX | Type: Enum Default: Standard | Vivid, Standard, Cinema, Game, Custom | Vivid, Standard, Cinema, Game, Custom | May increase power consumption | Cloud API-compatible models |
| Video Light Sensor Setting ID: light-sensor-enabled-videoX | Type: Boolean Default: true | true / false | true / false | False may increase power consumption | BZ30L, BZ35L, BZ40L, BZ40H, BZ30J, BZ35J |
| Video Ambient Light Sensor Setting ID: ambient-light-sensor-enabled-videoX | Type: Boolean Default: true | true / false | true / false | – False 0 may increase power consumption – Must import with ambient-light-sensor-light-enabled-video1 (if ambient-light-sensor-enabled-video1 = “true”), ambient-light-sensor-gamma-enabled-video1 (if ambient-light-sensor-enabled-video1 = “true”) | BZ30L(98inch), BZ50L, BZ53L, BZ40J |
| Video Auto Brightness Level Setting ID: ambient-light-sensor-light-enabled-videoX | Type: Boolean Default: true | true / false | true / false | False may increase power consumption | BZ30L(98inch), BZ50L, BZ53L, BZ40J |
| Video Auto Tone Curve Setting ID: ambient-light-sensor-gamma-enabled-videoX | Type: Boolean Default: true | true / false | true / false | False may increase power consumption | BZ30L(98inch), BZ50L, BZ53L, BZ40J |
| Video Brightness Setting ID: brightness-videoX | Type: Number Default: 35 | Range: 0-50 | Range: 0-50 | 0 may increase power consumption | Cloud API-compatible models |
App Input Settings
X: Enter app type (lowercase)
| Setting Item | Type / Default | Parameter Value | Notes | Supported Model | |||
|---|---|---|---|---|---|---|---|
| Video App (video) | Photo App (photo) | Game App (game) | General App (general) | ||||
| App Picture Mode Setting ID: picture-mode-app-X | Type: Enum Default: Standard *photo only for app-photo | Vivid, Standard, Cinema, Custom | Photo only (fixed) | Game, Graphics | Vivid, Standard, Cinema, Game, Graphics, Photo, Custom | May increase power consumption | Cloud API-compatible models |
| App Light Sensor Setting ID: light-sensor-enabled-app-X | Type: Boolean Default: true | true / false | true / false | true / false | true / false | N/A | BZ30L, BZ35L, BZ40L, BZ40H, BZ30J, BZ35J |
| App Ambient Light Sensor Setting ID: ambient-light-sensor-enabled-app-X | Type: Boolean Default: true | true / false | true / false | true / false | true / false | N/A | BZ30L(98inch), BZ50L, BZ53L, BZ40J |
| App Auto Brightness Level Setting ID: ambient-light-sensor-light-enabled-app-X | Type: Boolean Default: true | true / false | true / false | true / false | true / false | N/A | BZ30L(98inch), BZ50L, BZ53L, BZ40J |
| App Auto Tone Curve Setting ID: ambient-light-sensor-gamma-enabled-app-X | Type: Boolean Default: true | true / false | true / false | true / false | true / false | N/A | BZ30L(98inch), BZ50L, BZ53L, BZ40J |
| App Brightness Setting ID: brightness-app-X | Type: Number Default: 35 | Range: 0-50 (Step: 1) | Range: 0-50 (Step: 1) | Range: 0-50 (Step: 1) | Range: 0-50 (Step: 1) | 0 may increase power consumption | Cloud API-compatible models |
Network & Internet
| Android TV OS | Setting / ID | Type / Default | Parameter Value | Setting Conditions / Dependencies | Notes | |
|---|---|---|---|---|---|---|
| 10* | 12 | |||||
| 〇 | 〇 | IP Assignment Setting ID: ip-assignment | Type: Enum Default: DHCP | – DHCP: DHCP – Static: Static | N/A | – Must import with ipv4-address (if Static), ipv4-prefix-length (if Static), proxy-enabled |
| 〇 | 〇 | IPv4 Address Setting ID: ipv4-address | Type: String Default: 192.168.1.128 | IPv4 format | ip-assignment=Static | – Must import with: wifi-ip-assignment. Regex: ^(\d{1,2}|1\d\d|2[0-4]\d|25[0-5])\.(…)$ |
| 〇 | 〇 | Subnet Mask Setting ID: ipv4-prefix-length | Type: Number Default: 24 | 8-32 (Step: 1) | ip-assignment = Static | – Must import with ip-assignment. |
| 〇 | 〇 | Gateway Setting ID: ipv4-gateway | Type: String Default: 192.168.1.1 | IPv4 format / can be blank | ip-assignment = Static | – Must import with: ip-assignment. – Regex: ^(\d{1,2}|1\d\d|2[0-4]\d|25[0-5])\.(…)$|^$ |
| 〇 | 〇 | DNS Server Setting ID: ipv4-dns-servers | Type: String Default: 8.8.8.8,8.8.4.4 | N/A | ip-assignment=Static | – Must import with: ip-assignment. – Regex: ^(?:(IPv4)(?:,(IPv4))?)?$|^$ where IPv4=(\d{1,2}|1\d\d|2[0-4]\d|25[0-5]).(…)$ |
| 〇 | 〇 | Proxy Settings Setting ID: proxy-enabled | Type: Enum Default: None | – None: None – Static: Manual | N/A | – Must import with ip-assignment, proxy-host (if Static), proxy-port (if Static) |
| 〇 | 〇 | Proxy Host Setting ID: proxy-host | Type: String Default: proxy.example.com | 1-255 characters | proxy-enabled = Static | – Must import with proxy enabled |
| 〇 | 〇 | Proxy Port Setting ID: proxy-port | Type: Number Default: 8080 | 1-65535 | proxy-enabled = Static | – Must import with proxy-enabled. |
| 〇 | 〇 | Proxy Exclusion List Setting ID: proxy-exclusive-list | Type: Domain enumeration Default: – | 1-255 characters / domain format | proxy-enabled=Static | – Must import with proxy-enabled. |
| 〇 | 〇 | Wi-Fi Enabled Setting ID: wifi-enabled | Type: Boolean Default: false | true / false | N/A | N/A |
| 〇 | 〇 | Wi-Fi SSID Setting ID: wifi-ssid | Type: String Default: blank | 1-32 characters | wifi-enabled=true | – Cannot read from device. – Must import with wifi-security, wifi-ip-assignment, wifi-proxy-enabled |
| 〇 | 〇 | Wi-Fi Security Setting ID: wifi-security | Type: Enum Default: None | None, WEP, WPA/WPA2 PSK | wifi-enabled=true | – Cannot read from device. – Must import with wifi-ssid, wifi-ip-assignment, wifi-proxy-enabled, wifi-wep-value (if Wep), wifi-wpa-value (if Wpa) |
| 〇 | 〇 | Wi-Fi WEP Value Setting ID: wifi-wep-value | Type: Password | – | wifi-enabled=true and wifi-security=Wep | – Cannot read from device. – Must import with wifi-security. – Regex: ^[\x20-\x7E]+$ |
| 〇 | 〇 | Wi-Fi WPA Value Setting ID: wifi-wpa-value | Type: Password Default: “” | 8-63 | wifi-enabled=true and wifi-security=Wpa | – Cannot read from device. – Must import with wifi-security. – Regex: ^[\x20-\x7E]+$ |
| × | 〇 | Connect Setting ID: wifi-connected | Type: Boolean Default: true | true / false | N/A | – Cannot read from device. – Must import with wifi-ssid, wifi-security, wifi-ip-assignment, wifi-proxy-enabled |
| 〇 | 〇 | IP settings Setting ID: wifi-ip-assignment | Type: Enum Default: DHCP | DHCP / Static | wifi-enabled = true | – Cannot read from device. – Must import with wifi-ssid, wifi-security, wifi-ip-assignment, wifi-proxy-host (if wifi-proxy-enabled = “Static”) wifi-proxy-port (if wifi-proxy-enabled = “Static”) |
| 〇 | 〇 | IP address Setting ID: wifi-ipv4-address | Type: String Default: 192.168.1.128 | IPv4 format | wifi-enabled = true and wifi-ip-assignment = Static | – Cannot read from device. – Must import with wifi-ip-assignment. – Regex: ^(\d{1,2}|1\d\d|2[0-4]\d|25[0-5])\.(…)$ |
| 〇 | 〇 | Network prefix length Setting ID: wifi-ipv4-prefix-length | Type: Number Default: 24 | 8-32 (Step: 1) | wifi-enabled = true and wifi-ip-assignment = Static | – Cannot read from device. – Must import with wifi-ip-assignment. – Equivalent to subnet mask. |
| 〇 | 〇 | Wi-Fi Gateway Setting ID: wifi-ipv4-gateway | Type: String Default: 192.168.1.1 | IIPv4 format | wifi-enabled = true and wifi-ip-assignment = Static | – Cannot read from device. – Must import with wifi-ip-assignment – Regex: ^(\d{1,2}|1\d\d|2[0-4]\d|25[0-5])\.(…)$|^$ |
| 〇 | 〇 | Wi-Fi DNS Setting ID: wifi-ipv4-dns-servers | Type: String Default: 8.8.8.8,8.8.4.4 | IPv4 format×2 (comma separated) | wifi-enabled = true and wifi-ip-assignment = Static | – Cannot read from device. – Must import with wifi-ip-assignment. – Regex: ^(?:(IPv4)(?:,(IPv4))?)?|^ where IPv4=(\d{1,2}|1\d\d|2[0-4]\d|25[0-5])\.(…)$ |
| 〇 | 〇 | Wi-Fi Proxy Settings Setting ID: wifi-proxy-enabled | Type: Enum Default: None | None / Static | wifi-enabled = true | – Cannot read from device – Must import with wifi-enabled. – When Static, the following items must be set simultaneously: ‣wifi-proxy-host, wifi-proxy-port, wifi-proxy-exclusive-list |
| 〇 | 〇 | Wi-Fi Proxy Host Setting ID: wifi-proxy-host | Type: String Default: － | 1-255 characters | wifi-enabled=true and wifi-proxy-enabled=Static | – Cannot read from device. – Must import with wifi-proxy-enabled. |
| 〇 | 〇 | Wi-Fi Proxy Port Setting ID: wifi-proxy-port | Type: Number Default: 8080 | 1-65535 (Step: 1) | wifi-enabled=true and wifi-proxy-enabled=Static | – Cannot read from device. – Must import with wifi-proxy-enabled. |
| 〇 | 〇 | Wi-Fi Proxy Exclusion List Setting ID: wifi-proxy-exclusive-list | Type: Domain enumeration | 1-255 characters / domain format | wifi-enabled=true and wifi-proxy-enabled=Static | – Cannot read from device. – Must import with wifi-proxy-enabled. |
| 〇 | 〇 | Authentication Method Setting ID: ip-control-authentication | Type: Enum Default: Normal | Normal, None, PSK, Normal PSK | Must import with ip-control-authentication-psk when PSK is required | N/A |
| 〇 | 〇 | PSK Setting ID: ip-control-authentication-psk | Type: String Default: – | 1-64 characters | Can be set only when ip-control-authentication = PSK / Normal PSK | N/A |
| 〇 | 〇 | IP Control Communication Mode Setting ID: ip-control-communication-mode | Type: Enum Default: HTTP, HTTPS | HTTP, HTTP‣HTTPS, HTTPS | – Depends on targetRegion / enforced attributes. – Valid combinations: • false / false • true / false • true / true – SW <6.8088: redda object not available, use false / false. | N/A |
| 〇 | 〇 | Simple IP Control Setting ID: simple-ip-control-enabled | Type: Boolean Default: false | true / false | N/A | – true may increase power consumption |
| 〇 | 〇 | Control4® Setting ID: control4-enabled | Type: Boolean Default: false | true / false | N/A | N/A |
| 〇 | 〇 | Remote Device Control Remotely Setting ID:remote-device-control-remotely | Type: Boolean Default: false | true / false | – Depends on targetRegion / enforced attributes. – Valid combinations: ‣false / false ‣true / false ‣true / true – SW <6.8088: redda object not available, use false / false. | N/A |
* Supported with firmware version 6.7283 or later
Settings -power-saving
| Setting Item | Type / Default | Parameter Value | Notes |
|---|---|---|---|
| Power saving Setting ID: power-saving | Type: Enum Default: Off | Off, Low, High | Off may increase power consumption |
| Idle display power off Setting ID: Idle display power off idle-tv-standby | Type: Enum Default: 4h | 15min, 30min, 1h, 2h, 4h, 8h, 12h, 24h, Never | This may increase power consumption more than the default configuration at the following values: “8h”, “12h”, “24h”, “Never” |
| Device name Setting ID: device-name | Type: String Default: “” | true / false | N/A |
| Automatic check for software update Setting ID: system-software-update-automatically-check | Type: Boolean Default: false | true / false | N/A |
| Auto shut-off Setting ID: auto-shut-off-enabled | Type: Boolean Default: true | true / false | Developer options |
| Stay awake Setting ID: stay-awake-enabled | Type: Boolean Default: false | true / false | N/A |
| Set time zone Setting ID: time-zone | Type: Enum Default: GreenwichMeanTime | City code lists | N/A |
| Language Setting ID: language | Type: Enum Default: en-US | Language code lists | N/A |
| Bluetooth Setting ID: bluetooth-enabled | Type: Boolean Default: true | true / false | N/A |
Pro settings – Power Management
| Setting Item | Type / Default | Parameter Value | Notes |
|---|---|---|---|
| AC Power On Behavior Setting ID: ac-power-on | Type: Enum Default: Standard | Standard, AlwaysOn, AlwaysStandby | N/A |
| Wake Up On Signal Setting ID: wake-up-on-signal | Type: Enum Default: Disable | Disable, AlwaysEnabled, InputChangeOnly, SpecifiedHours | May increase power consumption |
| Signal Detection Start Time Setting ID: wake-up-on-signal-detect-start-time | Type: Time Default: 00:00 | 00:00-23:59 | N/A |
| Signal Detection End Time Setting ID: wake-up-on-signal-detect-end-time | Type: Time Default: 00:00 | 00:00-23:59 | N/A |
| Power Scheduling Setting ID:power-scheduling | Type: Enum Default: Off | Daily, Weekly, Off | N/A |
| Power On Time Setting ID: power-scheduling-on-time | Type: Time Default: 00:00 | 00:00-23:59 | N/A |
| Power Off Time Setting ID: power-scheduling-off-time | Type: Time Default: 00:00 | 00:00-23:59 | N/A |
| Weekly Schedule Setting ID: power-scheduling-weekly | Type: Week Default: “” | Weekday selection | N/A |
| Periodic Restart Setting ID: periodic-restart | Type: Enum Default: Off | Daily, Weekly, Off | N/A |
| Restart Time Setting ID: periodic-restart-time | Type: Time Default: 00:00 | 00:00-23:59 | N/A |
| Weekly Restart Schedule Setting ID: periodic-restart-weekly | Type: Week Default: “” | Weekday selection | N/A |
| Force Restart While Displaying Setting ID: periodic-restart-force | Type: Boolean Default: false | true / false | N/A |
Pro settings – System/UI Settings
| Setting Item | Type / Default | Parameter Value | Notes |
|---|---|---|---|
| PC Input Optimization Setting ID: pc-input-optimization-enabled | Type: Boolean Default: false | true / false | N/A |
| Home Key Behavior Setting ID: home-key-behavior | Type: Enum Default: Standard | Standard, Custom, Toggle, Disabled | N/A |
| Custom Home URI Setting ID: custom-home-uri | Type: String Default: “” | URI string | Regex: ^.+$ |
| NTP Server Setting Setting ID: ntp-server | Type: String Default: “” | NTP server | N/A |
| Pro Mode Lock Setting ID: pro-mode-lock | Type: String Default: “” | 4-digit number (except 0000) or blank | Regex: ^(?:(?!0000$)\d{4}|)$|^$ |
| Font Scale Setting ID: font-scale | Type: Number Default: 1 | Range: 0.25-5.0 (Step: 0.01) | N/A |
| USB Charging During Standby Setting ID: charge-usb-during-standby-enabled | Type: Boolean Default: false | true / false | May increase power consumption |
Pro settings – Initial input source
| Setting Item | Type / Default | Parameter Value | Notes |
|---|---|---|---|
| Initial input source Setting ID: initial-input-source | Type: Enum Default: Default | Default, External Input, Startup App, Android Apps | N/A |
| External input Setting ID: initial-input-source-external-input | Type: Enum Default: hdmi1 | hdmi1, hdmi2, hdmi3, hdmi4, video1 | N/A |
| Set URI of startup app Setting ID: initial-input-source-startup-app-uri | Type: String Default: “” | App URI | Regex: ^.+$ |
| Package name (Android App) Setting ID: initial-input-source-android-app-package | Type: String Default: “” | Package name | Regex: ^.+$ |
| Activity name (Android App) Setting ID: initial-input-source-android-app-activity | Type: String Default: “” | Activity name | Regex: ^.+$ |
| Intent data Setting ID: initial-input-source-android-app-intent-data | Type: String Default: “” | Intent data | N/A |
| Intent extra key Setting ID: initial-input-source-android-app-intent-extra-key | Type: String Default: “” | Intent extra key | N/A |
| Intent extra value Setting ID: initial-input-source-android-app-intent-extra-value | Type: Boolean Default: false | Intent extra value | N/A |
Pro settings – Control and Restriction Settings
| Setting Item | Type / Default | Parameter Value |
|---|---|---|
| Display Key Control Setting ID: display-key-control-enabled | Type: Boolean Default: true | true / false |
| IR Remote Control Setting ID: ir-remote-control-enabled | Type: Boolean Default: true | true / false |
| Bluetooth Remote Control Setting ID: bluetooth-remote-control-enabled | Type: Boolean Default: true | true / false |
| HDMI1 Input Restriction Setting ID: external-input-restriction-hdmi1 | Type: Enum Default: UseWithLabels | UseWithLabels, UseWithoutLabels, NotUse |
| HDMI2 Input Restriction Setting ID: external-input-restriction-hdmi2 | Type: Enum Default: UseWithLabels | UseWithLabels, UseWithoutLabels, NotUse |
| HDMI3 Input Restriction Setting ID: external-input-restriction-hdmi3 | Type: Enum Default: UseWithLabels | UseWithLabels, UseWithoutLabels, NotUse |
| HDMI4 Input Restriction Setting ID: external-input-restriction-hdmi4 | Type: Enum Default: UseWithLabels | UseWithLabels, UseWithoutLabels, NotUse |
| Video1 Input Restriction Setting ID: external-input-restriction-video1 | Type: Enum Default: UseWithLabels | UseWithLabels, UseWithoutLabels, NotUse |
| Video2 Input Restriction Setting ID: external-input-restriction-video2 | Type: Enum Default: UseWithLabels | UseWithLabels, UseWithoutLabels, NotUse |
Pro Settings – USB Drive Auto Run Settings
| Setting Item | Type / Default | Parameter Value |
|---|---|---|
| Import Settings Setting ID: import-enabled | Type: Boolean Default: false | true / false |
| Install BPK Setting ID: install-bpk-enabled | Type: Boolean Default: false | true / false |
| Launch Web App Setting ID: launch-web-app-enabled | Type: Boolean Default: false | true / false |
| Install Web App Setting ID: web-apps-installation-enabled | Type: Boolean Default: false | true / false |
Pro Settings – App Management
| Setting Item | Type / Default | Parameter Value | Notes |
|---|---|---|---|
| Apps Setting ID: enabled-apps | Type: Enabled-apps Default: Per-app settings | enabled, limited-enabled, disabled | Enable/disable control for each app |