2024.12.5
Home ▸ Integrations ▸

Monoprice Blackbird Matrix Switch

The blackbird platform allows you to control Monoprice Blackbird Matrix Switch (8x8) using a serial or IP connection, this integration does not support the 4x4 matrix switch.

To add a Blackbird 8x8 device to your installation, add the following to your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file. After changing the configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file, restart Home Assistant to apply the changes. The integration is now shown on the integrations page under Settings > Devices & services. Its entities are listed on the integration card itself and on the Entities tab.

# Example configuration.yaml entry
media_player:
  - platform: blackbird
    port: /dev/ttyUSB0
    zones:
      1:
        name: Living Room
    sources:
      3:
        name: BluRay

Configuration Variables

Looking for your configuration file?
port string (Exclusive)

The serial port to which Blackbird matrix switch is connected. port and host cannot be specified concurrently.

host string (Exclusive)

The IP address of the Blackbird matrix switch. port and host cannot be specified concurrently.

zones map Required

This is the list of zones available. Valid zones are 1, 2, 3, 4, 5, 6, 7, 8. Each zone must have a name assigned to it.

ZONE_NUMBER string

The name of the zone.

sources map Required

The list of sources available. Valid source numbers are 1, 2, 3, 4, 5, 6, 7, 8. Each source number corresponds to the input number on the Blackbird matrix switch. Similar to zones, each source must have a name assigned to it.

ZONE_NUMBER string

The name of the source.

Action blackbird.set_all_zones

Set all zones to the same input source. This action allows you to immediately synchronize all the TVs in your home. Regardless of entity_id provided, all zones will be updated.

Data attribute Optional Description
entity_id yes String that points at an entity_id of a zone.
source no String of source name to activate.

Related topics