Homebridge Atelier

This Homebridge plugin allows you to control your Braun Atelier R4 or CC4 receiver. Supports on/off, volume, mute, loudness, input selection, play, pause, stop, fast-forward and rewind.

Only devices from the first generation are supported (R4/1 and CC4/1), devices from the second generation do not support getting the device's status.

Usage

The device running Homebridge needs to be connected directly to the Atelier device using an appropriate serial cable. The plugin communicates with the receiver using control sequences, see docs.md for more information.

The plugin exposes a TV accessory, and two linked accessories: a fan (to set the volume) and a switch (to toggle loudness). In the Home app, the TV accessory can be used to toggle the device on or off and select an input channel; additionally, using the remote widget in the iOS control center, some remote keys are supported ( play, pause, stop, fast-forward and rewind).

Devices need to be manually added to HomeKit, even if HomeBridge has already been added. Check the log after activating and configuring this plugin.

Configuration

The easiest way to use this plugin is to use homebridge-config-ui-x. To configure manually, add the AtelierRs232HomebridgePlugin platform in your config.json file. Then, add the name and path for the devices to monitor:

{
"platform": "AtelierRs232HomebridgePlugin",
  "devices": [
    {
      "name": "The name of the device, e.g. 'Atelier R4'",
      "model": "The model of the device, e.g. 'Atelier R4/1'. Optional.",
      "path": "The path to the serial port connected to the device, e.g. '/dev/ttyUSB0' when using an USB converter on Linux",
      "maxVolume": "The volume set via HomeKit will be a percentage of the maximum volume given here. E.g., for a maximum volume of '60', setting the volume in Homekit to 50(%) will set the device to a volume of 30."
    }
  ]
}

License

MIT