Add multi-device emulation support with interactive selection and colored output

[Copilot]

Overview

Transforms VirtUSDev from a single-purpose barcode scanner into a flexible multi-device virtual USB emulator supporting multiple device types with enhanced user experience.

What Changed

🎯 Multi-Device Architecture

Created a modular device system with 4 device types:

• Barcode Scanner (115200 baud) - Original functionality fully preserved
• USB Keyboard - Full-featured HID keyboard emulation
• Mouse Jiggler - Prevents screen lock by periodic mouse movement
• RS232 Serial Port - Virtual serial communication interface

Each device has its own implementation in the new devices/ directory:

devices/
├── device_interface.h   # Common device interface
├── barcode.c/h         # Barcode scanner (original logic preserved)
├── usb_keyboard.c/h    # USB keyboard
├── mouse_jiggle.c/h    # Mouse jiggler
└── rs232.c/h           # RS232 serial port

🎨 Three Ways to Select Devices

1. Command-line parameter:

sudo ./virtual_keyboard barcode
sudo ./virtual_keyboard mouse_jiggle

2. Interactive menu with descriptions:

sudo ./virtual_keyboard

Shows a colored menu:

╔═══════════════════════════════════════════════════════╗
║           VirtUSDev - Device Selection Menu           ║
╚═══════════════════════════════════════════════════════╝

[1] barcode         - Barcode Scanner (115200 baud)
[2] usb_keyboard    - USB Keyboard
[3] mouse_jiggle    - Mouse Jiggler
[4] rs232           - RS232 Serial Port

3. Configuration file:

# /etc/virtusdev/config
DEVICE=barcode

🔄 Tool Rename with Backward Compatibility

• Renamed keyboard_writer.c → virtusdev.c
• Created symlink keyboard_writer → virtusdev for existing scripts
• All existing workflows continue to work unchanged

🎨 Enhanced User Experience

• Full ANSI color support throughout all terminal output
• Color-coded messages (cyan for info, green for success, red for errors, yellow for warnings)
• Improved readability and visual feedback
• Clear error messages with suggested fixes

🔧 System Integration

Installation support:

sudo make install

• Installs binaries to /usr/local/bin/
• Creates /etc/virtusdev/ config directory
• Installs systemd service file
• Clean uninstall with make uninstall

Systemd service:

sudo systemctl enable virtusdev
sudo systemctl start virtusdev

• Auto-start on boot
• Reads device type from config file
• Proper error handling and restart policy

📚 Documentation

• README.md - Complete rewrite with comprehensive usage examples
• MIGRATION.md - Migration guide from previous version
• SUMMARY.md - Detailed implementation summary
• Enhanced Makefile with help target

✅ Quality Assurance

• 19 automated tests - All passing
• Zero build warnings with -Wall -Wextra
• 100% backward compatible - No breaking changes
• Test suite in scripts/test_functionality.sh

Backward Compatibility

All existing code continues to work:

• keyboard_writer symlink maintained
• Same command-line interface for barcode operations
• Original barcode timing and behavior preserved (115200 baud, 87μs per character)
• Compatible with all existing scripts and workflows

Example Usage

# Build
make

# Select device (interactive)
sudo ./virtual_keyboard

# Select device (command-line)
sudo ./virtual_keyboard barcode

# Use barcode writer (new name)
sudo ./virtusdev /dev/input/event25

# Use barcode writer (legacy name - still works)
sudo ./keyboard_writer /dev/input/event25

# Install system-wide
sudo make install
sudo systemctl enable virtusdev

Files Changed

New files (15):

• Device implementations in devices/ (9 files)
• virtusdev.c, virtusdev.service
• MIGRATION.md, SUMMARY.md
• Test and demo scripts

Modified files (6):

• virtual_keyboard.c - Multi-device support
• Makefile - Enhanced build system
• README.md - Complete rewrite
• .gitignore, scripts/compile.sh

Testing

All functionality tested and verified:

Passed: 19
Failed: 0
All tests passed! ✅

---

This PR delivers a production-ready multi-device emulation system with enhanced UX, comprehensive documentation, and full backward compatibility.

Original prompt

Eu quero poder escolher qual dispositivo eu vou querer emular ao rodar o virtual_keyboard.c, quero poder escolher entre barcode, teclado usb, mouse jiggle, uma porta serial RS232.

Cada dispositivo deve ter sua implementação feita em um arquivo separado, faça uma pasta com o nome "devices" e coloque lá dentro cada device que poderei emular.

Não perca o funcionando do barcode atual, mantenha o código de funcionamento dele intacto.

Quero poder escolher qual dispositivo vou usar por parâmetro e se eu rodar sem parâmetro eu quero uma tela interativa que eu possa escolher qual eu desejo, nesta tela interativa eu quero o dispositivo e uma descrição dele.

Quero poder escolher o dispositivo que quero emular através de um arquivo de configuração presente em /etc/virtusdev

Eu quero que tenha um troque o nome de keyboard_write.c para virtusdev.c e ele possa ser instalável no sistema

Eu quero que o sistema possa rodar um serviço que rode o virtual_keyboard.c com o parâmetro que eu configurei em /etc/virtusdev que citei anteriormente.

Adicione cores no ouput no terminal

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.