Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/djthorpe/go-rotel
Bridge Rotel Amplifier to Home Assistant
https://github.com/djthorpe/go-rotel
golang home-assistant home-automation mqtt remote-control rs232
Last synced: 25 days ago
JSON representation
Bridge Rotel Amplifier to Home Assistant
- Host: GitHub
- URL: https://github.com/djthorpe/go-rotel
- Owner: djthorpe
- License: apache-2.0
- Created: 2019-12-07T05:38:19.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-10-17T12:39:34.000Z (3 months ago)
- Last Synced: 2024-12-13T17:48:17.661Z (about 1 month ago)
- Topics: golang, home-assistant, home-automation, mqtt, remote-control, rs232
- Language: Go
- Homepage:
- Size: 1.01 MB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Rotel Amplifier Control
The code here is for bridging a Rotel Amplifier to MQTT, for integration into Home Assistant,
where the Rotel Amplifier is connected to the serial port of a host machine. The requirements
are:
* A Linux host connected to the Rotel Amplifier via a RS232 port
* A MQTT broker running on the same machine or on the network
* GNU Make and docker installed on the host machine
To run the docker container on an ARM64 host,
```bash
docker run --rm --name rotel --device=/dev/ttyUSB1 \
ghcr.io/djthorpe/go-rotel-linux-arm64:1.0.14 \
rotel -mqtt ipaddress:1883 -tty /dev/ttyUSB1
```
On Intel,
```bash
docker run --rm --name rotel --device=/dev/ttyUSB1 \
ghcr.io/djthorpe/go-rotel:latest \
rotel -mqtt ipaddress:1883 -tty /dev/ttyUSB1
```
This assumes that the serial port is `/dev/ttyUSB1` and the MQTT broker is running on a machine
with a specific ip address and port 1883. The command line arguments for the rotel command are:
```bash
Usage of rotel:
-credentials string
MQTT credentials (user:password)
-id string
Unique identifier for Rotel device (default "amp00")
-mqtt string
MQTT broker address (default "localhost:1833")
-qos int
MQTT quality of service
-topic string
Topic for messages (default "homeassistant")
-tty string
TTY for Rotel device (default "/dev/ttyUSB0")
-version
Print version and exit
```
## Building the Docker Container
To build the docker container, ensure you are logged into docker. The Makefile
contains some parameters you'll want to change. Then,
```bash
git clone [email protected]:djthorpe/go-rotel.git
cd go-rotel
make docker
```
This will make the container, ready to be pushed to the remote repo.
## Configuring Home Assistant
Assuming you have the MQTT integratiion installed, you can create a card in Home Assistant to control the amplifier, that looks like this:
The card can be created using the following YAML:
```yaml
type: entities
entities:
- entity: switch.rotel_amp00_power
- entity: number.rotel_amp00_volume
- entity: select.rotel_amp00_input
- entity: switch.rotel_amp00_speaker_a
- entity: switch.rotel_amp00_speaker_b
title: Rotel
show_header_toggle: false
state_color: true
```
If you have more than one amplifier, you can change the unique identifier `amp00` to something else with the `-id` argument,
and update the YAML accordingly.
## Contributions, etc
Contributions are welcome. Please raise an issue or pull request on the GitHub repository. The limitations at the me moment are,
* Only the power, volume, source and speaker are exposed (it wouldn't be difficult to expose more controls). These are the other controls which could be added:
* ROTEL_FLAG_MUTE
* ROTEL_FLAG_BALANCE
* ROTEL_FLAG_BYPASS
* ROTEL_FLAG_DIMMER
* Implement the following push buttons: play, stop, pause, track_next, track_prev, mute_toggle, vol_up, vol_down, bass_up, bass_down, bass_reset, treble_up, treble_down, treble_reset, balance_left, balance_right, balance_reset, dimmer_toggle, power_toggle
* Code is only tested on an A12 amplifier, but should work on other models
* A github workflow only works with Intel platform