https://github.com/vda-solutions/vda-ir-control
Home Assistant integration for controlling IR devices using ESP32 boards
https://github.com/vda-solutions/vda-ir-control
esp32 hacs home-assistant home-assistant-custom-component homeassistant ir-remote
Last synced: 5 months ago
JSON representation
Home Assistant integration for controlling IR devices using ESP32 boards
- Host: GitHub
- URL: https://github.com/vda-solutions/vda-ir-control
- Owner: vda-solutions
- License: mit
- Created: 2025-12-18T21:15:05.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-08T09:38:15.000Z (6 months ago)
- Last Synced: 2026-01-13T19:49:24.377Z (5 months ago)
- Topics: esp32, hacs, home-assistant, home-assistant-custom-component, homeassistant, ir-remote
- Language: Python
- Size: 3.04 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# VDA IR Control
[](https://github.com/vda-solutions/vda-ir-control/releases)
[](LICENSE)
A Home Assistant integration for controlling multiple IR devices (TVs, AV receivers, cable boxes, etc.) using ESP32 boards. Designed for commercial venues like bars and restaurants that need to control many devices from a central location.
## What This Does
The VDA IR Control integration provides:
- **Multi-board Management** - Connect multiple ESP32 IR controllers
- **Device Profiles** - Manage IR code profiles for your devices
- **IR Learning** - Learn codes from original remotes
- **Serial Devices** - Control RS-232/USB devices (projectors, matrices, processors)
- **Network Devices** - Control HDMI matrices and network-controllable devices
- **HA Device Integration** - Use Home Assistant remote entities (Apple TV, Roku, Android TV)
- **Device Groups** - Control multiple devices with a single command
- **Projector Screen Linking** - Automatically drop/raise screens when projectors power on/off
- **REST API** - Full API for automation and custom integrations
- **Community Profiles** - Sync IR codes from the community repository
## Part of the VDA IR Control Ecosystem
This integration works with several companion repositories:
| Repository | Purpose | Required |
|------------|---------|----------|
| **vda-ir-control** | Home Assistant Integration (this repo) | Yes |
| [vda-ir-control-admin-card](https://github.com/vda-solutions/vda-ir-control-admin-card) | Admin/Management Lovelace Card | Yes |
| [vda-ir-remote-card](https://github.com/vda-solutions/vda-ir-remote-card) | Remote Control Lovelace Card | Optional |
| [vda-ir-firmware](https://github.com/vda-solutions/vda-ir-firmware) | ESP32 Firmware | Yes |
| [vda-ir-profiles](https://github.com/vda-solutions/vda-ir-profiles) | Community IR Profiles | Optional |
| [vda-network-drivers](https://github.com/vda-solutions/vda-network-drivers) | Network Device Drivers | Optional |
## Installation
### Step 1: Flash Firmware to ESP32
Download firmware from [vda-ir-firmware releases](https://github.com/vda-solutions/vda-ir-firmware/releases):
| Board | Firmware |
|-------|----------|
| Olimex ESP32-POE-ISO | `firmware-esp32-poe-iso-vX.X.X.bin` |
| ESP32 DevKit (WiFi) | `firmware-esp32-devkit-wifi-vX.X.X.bin` |
Flash using [esptool](https://github.com/espressif/esptool):
```bash
esptool.py --chip esp32 --port /dev/ttyUSB0 write_flash 0x0 firmware-esp32-devkit-wifi-v1.2.5.bin
```
### Step 2: Install Integration (HACS)
1. Open HACS
2. Click ⋮ → **Custom repositories**
3. Add: `https://github.com/vda-solutions/vda-ir-control`
4. Type: **Integration**
5. Download "VDA IR Control"
6. Restart Home Assistant
### Step 3: Install Admin Card (HACS)
1. Open HACS
2. Click ⋮ → **Custom repositories**
3. Add: `https://github.com/vda-solutions/vda-ir-control-admin-card`
4. Type: **Dashboard**
5. Download "VDA IR Control Admin Card"
6. Hard refresh browser (Ctrl+Shift+R)
### Step 4: Install Remote Card (Optional)
1. Open HACS
2. Click ⋮ → **Custom repositories**
3. Add: `https://github.com/vda-solutions/vda-ir-remote-card`
4. Type: **Dashboard**
5. Download "VDA IR Remote Card"
### Step 5: Add Cards to Dashboard
```yaml
# Admin card for configuration
type: custom:vda-ir-control-card
# Remote card for device control
type: custom:vda-ir-remote-card
```
## Supported Hardware
| Board | Connection | Features |
|-------|------------|----------|
| [Olimex ESP32-POE-ISO](https://www.olimex.com/Products/IoT/ESP32/ESP32-POE-ISO/) | Ethernet + PoE | Stable, isolated power |
| ESP32 DevKit | WiFi | Easy setup, captive portal |
See [vda-ir-firmware](https://github.com/vda-solutions/vda-ir-firmware) for hardware setup and wiring guides.
## IR Driver Module
**8-Channel IR Driver Module v1.1** - A professional IR driver board designed to work with ESP32 microcontrollers.
**Features:**
- 8 independent IR output channels (CN1-CN8)
- Current limiting resistors for LED protection
- Transistor drivers for high-power IR LED output
- Reverse polarity protection diode
- Power filtering capacitors for clean signal output
**Compatibility:**
- Works with any microcontroller with 3.3V or 5V GPIO
- Designed specifically for ESP32 DevKit and Olimex ESP32-POE-ISO boards
- Pre-built firmware available in [vda-ir-firmware](https://github.com/vda-solutions/vda-ir-firmware)
**Purchase:**
IR Driver Module boards will soon be available at [vdasolutionsny.com](https://vdasolutionsny.com)
## Built-in IR Profiles
The integration includes pre-loaded profiles for popular devices:
**TVs:** Samsung, LG, Sony, Vizio, TCL/Roku, Hisense, Panasonic, Sharp, Toshiba
**AV Receivers:** Pioneer, Pioneer Elite, Denon, Yamaha, Onkyo, Marantz, Sony
**Soundbars:** Samsung, Sony, Vizio
**Streaming:** Apple TV, Amazon Fire TV, Roku, NVIDIA Shield
**Cable/Satellite:** DirecTV, DISH Network, Verizon FiOS, Altice One
**Projector Screens:** Elite Screens
Additional profiles available via [vda-ir-profiles](https://github.com/vda-solutions/vda-ir-profiles) community repository.
## Network Device Drivers
Control network devices directly without IR:
**HDMI Matrices:** Generic protocol (OREI, Monoprice, J-Tech)
**Projectors:** PJLink Class 1 (Epson, NEC, Sony, BenQ)
**AV Receivers:** Denon/Marantz, Yamaha
Drivers provide pre-configured commands - just enter the IP address. Sync additional drivers from [vda-network-drivers](https://github.com/vda-solutions/vda-network-drivers).
## Home Assistant API Endpoints
| Endpoint | Description |
|----------|-------------|
| `/api/vda_ir_control/boards` | List configured boards |
| `/api/vda_ir_control/devices` | List controlled IR devices |
| `/api/vda_ir_control/serial_devices` | List serial devices |
| `/api/vda_ir_control/network_devices` | List network devices |
| `/api/vda_ir_control/ha_devices` | List HA remote devices |
| `/api/vda_ir_control/device_groups` | List device groups |
| `/api/vda_ir_control/profiles` | List user profiles |
| `/api/vda_ir_control/builtin_profiles` | List built-in profiles |
| `/api/vda_ir_control/community_profiles` | List synced community profiles |
| `/api/vda_ir_control/sync_profiles` | Sync from community repo |
| `/api/vda_ir_control/drivers` | List network device drivers |
| `/api/vda_ir_control/serial_drivers` | List serial device drivers |
| `/api/vda_ir_control/discover_devices` | Discover network devices |
## Troubleshooting
### Board not discovered
- Verify board has IP (check router DHCP)
- Ensure same network/VLAN as Home Assistant
- Try accessing `http:///info` directly
### IR codes not working
- Check IR LED connection and polarity
- Try different protocols (NEC, SAMSUNG, SONY)
- Use transistor driver for longer range
### Cards not loading
- Hard refresh browser (Ctrl+Shift+R)
- Check browser console for errors
- Verify resources are added to Lovelace
## Contributing
Contributions welcome! See individual repositories for contribution guidelines.
## License
MIT License - see [LICENSE](LICENSE) for details.
## Support
- **Issues**: [GitHub Issues](https://github.com/vda-solutions/vda-ir-control/issues)
- **Firmware**: [vda-ir-firmware](https://github.com/vda-solutions/vda-ir-firmware)
- **Community Profiles**: [vda-ir-profiles](https://github.com/vda-solutions/vda-ir-profiles)