feat: Add test scripts for Q10 VacuumTrait functionality

Author: lboue

examples/Q10/README.md

@@ -0,0 +1,82 @@
+# Q10 VacuumTrait Test Scripts
+
+This directory contains test scripts for the Q10 VacuumTrait functionality added in [PR #754](https://github.com/Python-roborock/python-roborock/pull/754).
+
+## Scripts
+
+### test_q10_simple.py
+Interactive test script with detailed debug information. This script:
+- Shows comprehensive device information
+- Lists all available property APIs
+- Provides an interactive menu to test vacuum commands
+- Includes error handling and detailed output
+
+**Use this script when:**
+- You want to verify your device supports Q10 properties
+- You need to debug connection or API issues
+- You want detailed information about what's happening
+
+### test_q10_vacuum.py
+Basic test script for Q10 vacuum commands. A simpler version focused on testing the vacuum trait.
+
+## Requirements
+
+Install the package in development mode:
+```bash
+python3 -m venv venv
+source venv/bin/activate
+pip install -e .
+```
+
+## Usage
+
+1. Run the test script:
+```bash
+python examples/Q10/test_q10_simple.py
+```
+
+2. On first run, you'll be prompted to log in:
+   - Enter your Roborock account email
+   - A code will be sent to your email
+   - Enter the code to complete authentication
+   - Credentials are cached for future runs
+
+3. The script will:
+   - List all your devices
+   - Show available APIs for each device
+   - Present an interactive menu if Q10 properties are found
+
+## Available Commands
+
+The VacuumTrait provides these commands:
+
+- **Start cleaning** - Initiates a full cleaning cycle
+- **Pause cleaning** - Pauses the current cleaning operation
+- **Resume cleaning** - Resumes a paused cleaning operation
+- **Stop cleaning** - Stops the cleaning operation completely
+- **Return to dock** - Sends the robot back to its charging dock
+
+## Supported Devices
+
+These scripts are designed for Roborock Q10 devices that support the B01 Q10 protocol. The script will automatically detect if your device has the required `b01_q10_properties` API.
+
+## Troubleshooting
+
+**"This device doesn't have Q10 properties"**
+- Your device may not be a Q10 model
+- Check the device model shown in the output
+- The device might use a different API (v1_properties, b01_q7_properties, etc.)
+
+**Authentication errors**
+- Delete cached credentials: `rm ~/.cache/roborock-user-params.pkl`
+- Try logging in again
+
+**Connection issues**
+- Ensure your device is online and connected to the internet
+- Check that your account has access to the device
+
+## Related Documentation
+
+- [PR #754: Add VacuumTrait to q10 devices](https://github.com/Python-roborock/python-roborock/pull/754)
+- [Main example script](../example.py)
+- [Supported Features](../../SUPPORTED_FEATURES.md)