Extron MAV Plus for Home Assistant

Remote control of Extron MAV Plus matrices from Home Assistant

Table of Contents

1. About
2. Getting Started
   • Compatability
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Acknowledgments

About

The custom component provides an integration for Home Assistant to remote control Extron MAV Plus matrices. The integration uses Extron's Simple Instruction Set to read the status and control the matrix over a Telnet connection.

The integration currently supports simple switching of inputs to outputs. Each output is exposed as an entity in Home Assistant allowing them to be targetted by button presses, automations and scenes.

Getting Started

Compatability

This integration should work with all Extron MAV Plus and Crosspoint 400 matrices. It may potentially work with other Extron matrices that implement Extron Simple Instruction Set over Telnet.

The integration has been tested and proven to work with the following devices:

• MAV Plus 1616 SVA

Installation

To install the integration:

1. Clone the repository
2. Copy the extron_mav folder to the custom_components folder in your Home Assistant installation
3. Restart Home Assistant

(back to top)

Usage

To add a new matrix to Home Assistant:

1. Go to "Settings" -> "Devices & services" to open the Integrations page, and then select "Add integration".
2. If the integration has been sucessfully installed "Extron MAV Matrix" will be available in the list.
3. Add the following details:

• host (required) - the hostname or IP address of the matrix
• port (required) - the port to use for the telnet connection, set to 23 by default
• password (optional) - the password for the matrix, leave blank for none.
• num_inputs - the number of inputs on the matrix
• num_outputs - the number of outputs on the matrix

4. Click submit.

The matrix will be added to Home Assistant as a device with a separate entity for each output. The currently routed input can be changed from a drop down list.

(back to top)

Roadmap

Planned features:

• Device type identifcation
• Device health monitoring
• Volume control
  • Switching audio inputs between +4/-10
  • Adjustable output gain
• Separate switching of audio and video levels
• Custom input and output names

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

Top contributors:

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Acknowledgements

Thanks to:

• Home Assistant for the incredible open source platform. https://www.home-assistant.io/
• The Best Readme Template. https://github.com/othneildrew/Best-README-Template

(back to top)