Files
examples/win32-example/README.md
2026-02-01 11:59:18 +08:00

68 lines
4.2 KiB
Markdown

# IRext Win32 Example
A Windows desktop example demonstrating the IRext infrared decoder library.
## Overview
IRext is an open-source infrared remote control library. This example provides a command-line application to test IR decoding functionality on Windows.
## Features
- Decode IR binary files for air conditioners (AC)
- Decode IR binary files for TV devices
- Query supported AC modes, wind speeds, swing options, and temperature ranges
- Generate IR timing data for remote control signals
## Requirements
- **Operating System**: Windows 10 or later
- **IDE**: Visual Studio 2019 or later
- **Build Tools**: MSVC v142 (VS2019) or v143 (VS2022)
## Building
1. Open `IRextWin32Example.sln` in Visual Studio.
2. If you encounter build error `MSB8020` (Platform Toolset not found), retarget the solution:
- Right-click the solution in Solution Explorer
- Select **Retarget solution**
- Choose an installed Windows SDK and Platform Toolset
3. Select the desired configuration (`Debug` or `Release`) and platform (`x86` or `x64`).
4. Build the solution (`Ctrl+Shift+B` or **Build > Build Solution**).
## Usage
1. Run the compiled executable from the command line.
2. The program will prompt you to input key codes to simulate remote control actions.
3. Key code reference: https://site.irext.net/doc#keymap
4. Enter `99` to exit the program.
### Example Key Codes
| Key Code | Function |
|----------|-----------------------------|
| 14 | Query supported modes |
| 15 | Query supported wind speeds |
| 16 | Query temperature range |
| 99 | Exit program |
## Project Structure
- `IRextWin32Example.sln` - Visual Studio solution file
- `IRextWin32Example.vcxproj` - Visual Studio project file
- `DecodeTestWin.cpp` - Main entry point
- `ir_decoder/src/` - IR decoder source files and headers
## Related Links
- [IRext Official Site](https://site.irext.net)
- [IRext Documentation](https://site.irext.net/doc)
- [IRext Open Source Project](https://opensource.irext.net)
## License
Please refer to the [IRext repository](https://opensource.irext.net) for license information.