Skip to content

README.md

Latest commit

 

History

History
123 lines (83 loc) · 5.43 KB

README.md

File metadata and controls

123 lines (83 loc) · 5.43 KB

banner

RAV311 Remote — Home Assistant Custom Integration:

HACS Custom HACS Validation Hassfest GitHub Release GitHub Release Date GitHub Stars GitHub Forks GitHub Issues Last Commit Home Assistant License

Control your Yamaha AV receiver from Home Assistant via infrared, using the native infrared building block introduced in HA 2026.4.

Compatible models (all use the RAV311 remote):

  • Yamaha RX-V361
  • Yamaha RX-V361BL
  • Yamaha HTR-6025
  • Yamaha HTR-6030
  • Maybe more, you tell me!

Requirements:

  • Home Assistant 2026.4 or later
  • An ESPHome device configured with the IR/RF Proxy component (infrared transmitter) already added to Home Assistant

Installation via HACS:

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

  1. In HACS, go to Integrations → Custom repositories
  2. Add this repository URL and select category Integration
  3. Click Download
  4. Restart Home Assistant

Manual installation:

Copy the custom_components/rav311_remote/ folder into your config/custom_components/ directory, then restart Home Assistant.

Setup:

  1. Go to Settings → Devices & Services → Add Integration
  2. Search for RAV311 Remote
  3. Select the infrared transmitter entity pointed at your receiver
  4. Done — your receiver appears as a device with all entities

Entities created:

Platform Entity Notes
media_player RAV311 Remote Power, volume, mute, source select
select Input Source CD, DVD, Tuner, V-AUX, XM…
select Sound Program Straight, Enhancer, Surround Decode, Night
button Power On / Standby
button Mute, Sleep, Display, Return… All remote buttons
button Program Left/Right DSP navigation
button A-E/Cat, Preset Ch… Tuner navigation

All entities use assumed state — IR is one-way, so HA tracks the last command sent.

Protocol notes

The RAV311 remote uses the Pioneer IR protocol at 40 kHz. All codes were sourced from a working ESPHome configuration and verified against the physical remote.

Minimum ESPHome hardware setup:

  1. An ESP32 or ESP6266 MCU
  2. An IR diode
  3. A transistor
  4. A power source
image

Minimum ESPHome config:

Here is an example of the required esphome config. Change variables to fit your needs (board type, wifi credentials, GPIO, etc)

  1. You need to add the ir transmitter component, set the correct GPIO corresponding to the IR LED and give your ir transmitter an ID.
  2. Then add the ir proxy transmitter compoenent, set the "remote_transmitter_id:" value so it matches the ID previously give the the ir_transmitter.
esphome:
  name: irblaster
  friendly_name: IR Blaster

esp8266:
  board: esp01_1m

api:
  encryption:
    key: ""

ota:
  - platform: esphome
    password: ""

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

  ap:
    ssid: "IR Blaster Fallback Hotspot"
    password: ""

captive_portal:

remote_transmitter:
  pin: GPIO04
  carrier_duty_percent: 50%
  id: my_ir_transmiter

infrared:
  - platform: ir_rf_proxy
    name: IR Proxy Transmitter Salon
    id: ir_proxy_tx
    remote_transmitter_id: my_ir_transmiter

The original remote this integration replaces:

If your remote or AV receiver looks like this, this integration will control your AV device.

image image