123 lines
2.9 KiB
Markdown
123 lines
2.9 KiB
Markdown
# 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)
|
|
```bash
|
|
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
|
|
```bash
|
|
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:
|
|
|
|
```json
|
|
{
|
|
"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:
|
|
|
|
```bash
|
|
# 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! 🎯
|