rpi-tulivision/CONTROLLER_SETUP_GUIDE.md

IR Controller Setup Guide

Overview

This guide will help you set up your IR remote controller for use with the video player system. The setup process will map each button on your remote to specific functions.

Quick Start

Option 1: Automated Setup (Recommended)

cd /home/tulivision/rpi-tulivision
./setup_controller.sh

This script will:

1. Integrate the custom protocol decoder into your IR system
2. Guide you through mapping all remote buttons
3. Save the mappings for use by other services

Option 2: Manual Setup

cd /home/tulivision/rpi-tulivision
python3 quick_controller_setup.py

Setup Process

The setup will ask you to press buttons in this order:

1. Power Toggle - Power on/off button
2. Channel 1-9, 0 - Channel selection buttons
3. Volume Up/Down - Volume control buttons
4. Mute - Mute button
5. Play/Pause - Play/pause button
6. Stop - Stop button
7. Next/Previous Channel - Channel navigation
8. Menu - Menu button
9. Back - Back button
10. OK - OK/Enter button
11. Arrow Keys - Up, Down, Left, Right navigation

Instructions

1. Point your remote at the IR receiver on the Raspberry Pi
2. When prompted, press the corresponding button on your remote
3. Wait for confirmation that the command was recorded
4. Continue with the next button
5. Skip or retry if a button doesn't work

Output Format

The mappings will be saved in ir_mapping.json in the format expected by other services:

{
  "CUSTOM_BF00_AD52": {
    "command": "power_toggle",
    "description": "Power on/off button",
    "repeatable": false
  },
  "CUSTOM_BF00_AF50": {
    "command": "channel_1", 
    "description": "Channel 1 button",
    "repeatable": false
  }
}

Testing

After setup, test your mappings:

# Test IR listener with verbose output
python3 simple_ir_listener_polling.py --verbose

# Test with video player
python3 video_player.py

Troubleshooting

No IR Commands Detected

• Check IR receiver connection
• Ensure remote has batteries
• Point remote directly at receiver
• Try different buttons

Setup Interrupted

• Run the setup script again
• You can skip buttons you don't have
• Press Ctrl+C to exit anytime

Mappings Not Working

• Check that ir_mapping.json was created
• Verify the custom protocol decoder is integrated
• Test with verbose IR listener

Files Created

• ir_mapping.json - Command mappings for other services
• backup_ir_system/ - Backup of original IR system files

Integration

The mappings are automatically integrated into your IR system and will work with:

• Video player control
• Channel switching
• Volume control
• Menu navigation

Support

If you encounter issues:

1. Check the troubleshooting section above
2. Verify IR receiver hardware is working
3. Test with known working remotes first
4. Check system logs for errors

---

Ready to start? Run ./setup_controller.sh to begin! 🎯