MediaInput Cluster

Cluster ID: 0x0507  |  Endpoint: Media endpoint (TV, AV receiver, etc.)

MediaInput manages the external input sources of a device — HDMI, USB, component, optical, and other audio/video input interfaces. Users can query available input sources, check which one is selected, switch to a specific source, and customize input source names. It is one of the core Clusters for media devices such as smart TVs and AV receivers.

Commands

The MediaInput Cluster has 4 commands. SelectInput switches the input source, ShowInputStatus / HideInputStatus control the OSD display of input source information, and RenameInput allows users to customize input source names (requires the NU feature). Click a command ID in the table below to jump to its detailed description.

SelectInput — Switch Input Source (0x00)

Switches the device to the specified input source. Index must match the Index value of an InputInfoStruct in InputList; otherwise the device returns an error. On success, the CurrentInput attribute updates to the specified Index value.

↑ Back to Commands

ShowInputStatus — Show Input Source Info (0x01)

Requests the device to display current input source information on screen (OSD overlay), similar to pressing the "Info" button on a remote. No parameters required. The displayed content and duration are determined by the device.

↑ Back to Commands

HideInputStatus — Hide Input Source Info (0x02)

Requests the device to hide the input source information display on screen. No parameters required. If no input source information is currently displayed, this command has no effect.

↑ Back to Commands

RenameInput — Rename Input Source (0x03)

Sets a custom name for the specified input source. After modification, the Name field of the corresponding entry in InputList updates. This command requires the device to have the NU (NameUpdates) feature enabled.

// RenameInput command example
// Rename the input source at Index=2 to "PS5"
{
  "Index": 2,
  "Name": "PS5"
}
// After execution, the Name of Index=2 in InputList becomes "PS5"

↑ Back to Commands

Attributes

The MediaInput Cluster has 2 attributes. Click an attribute ID in the summary table below to jump to its detailed description.

Input Source State (0x0000, 0x0001)

Describes the device's currently available input source list and the currently selected input source.

↑ Back to Attributes

Struct Definitions

The MediaInput Cluster uses one structure to describe input source information.

InputInfoStruct

Describes the complete information for an input source, including index, type, name, and description.

InputTypeEnum

Defines the physical interface type of input sources. Contains 12 enum values covering common audio/video input interfaces. Controllers can use this to display corresponding icons or categories in the UI.

Feature Bitmap

The MediaInput Cluster declares optional capabilities the device supports via FeatureMap (0xFFFC):

Example Data

Read results of the MediaInput Cluster from a smart TV — currently selected HDMI 1, with 4 input sources:

{
  // --- Current Input Source ---
  "0x0001": 1,                   // CurrentInput = 1 (currently selected HDMI 1)

  // --- Input Source List ---
  "0x0000": [                    // InputList
    {
      "Index": 0,
      "InputType": 0,            // Internal (built-in tuner)
      "Name": "TV Tuner",
      "Description": "Built-in digital TV tuner"
    },
    {
      "Index": 1,
      "InputType": 4,            // HDMI
      "Name": "HDMI 1",
      "Description": "Living room set-top box"
    },
    {
      "Index": 2,
      "InputType": 4,            // HDMI
      "Name": "HDMI 2",
      "Description": "Game console"
    },
    {
      "Index": 3,
      "InputType": 10,           // USB
      "Name": "USB",
      "Description": "USB media playback"
    }
  ]
}

Common Scenarios