1. Produto acabadoview
The Waveshare MK10 is a multi-functional AI Voice Control Panel designed to enhance productivity and control across various applications. It features a dual-system architecture combining Linux for complex logic processing and QMK for zero-latency mechanical input. The device includes 10 programmable 0.85-inch mechanical LCD macro keys and a 2.01-inch secondary screen, offering extensive customization and real-time data display capabilities. It supports AI speech recognition, smart home integration, and is compatible with both Windows and macOS systems.

Imagem: Acimaview of the Waveshare MK10 AI Voice Control Panel, showcasing its LCD macro keys, QMK response, flexible configuration, and AI/HA support.
2. Guia de configuração
2.1 Conteúdo da embalagem
Antes de prosseguir com a instalação, verifique se todos os itens estão presentes na embalagem:
- Waveshare MK10 Unit (White) x1
- Cabo USB Tipo C x1
- Dongle USB x1
- Suporte destacável x1

Image: The package contents for the Waveshare MK10, including the device, USB cable, USB dongle, and detachable stand.
2.2 Conexão Física
Connect the Waveshare MK10 to your computer using the provided USB Type-C cable. The device features a Type-C interface for a simple one-line connection, ensuring it does not occupy additional GPU resources.
Video: Demonstration of connecting the Waveshare MK10 via its Type-C interface and the immediate display of key functions.
2.3 Opções de Colocação
The MK10 offers flexible placement to suit various desk setups and user preferences:
- 40° Detachable Stand: Use the included triangular stand for an ergonomic 40-degree viewing and interaction angle, ideal for prolonged use.
- 5.5° Desktop Flat Placement: For a lower profile, the device can be placed flat on the desktop at a 5.5-degree angle.

Image: Illustrates the two available placement methods for the Waveshare MK10: using the detachable stand for a 40-degree angle or flat on the desktop at 5.5 degrees.
3. Operando o dispositivo
3.1 Key Functionality and Customization
The MK10's 10 mechanical LCD macro keys are highly customizable, supporting a wide range of operations natively through QMK without requiring PC software:
- Single Key Presses: Assign individual functions to each key.
- Combinações de teclas: Program keys to execute multiple key presses simultaneously (e.g., Ctrl+C).
- Macro Operations: Create complex sequences of actions with a single press.
- Controle do mouse: Assign mouse movements or clicks to keys.
- Multi-Command Chaining: Execute a series of commands in sequence.
Video: Demonstrates various key functionalities including single key, key combination, macro mouse control, and multi-command chaining on the Waveshare MK10.
3.2 Theme Editor and Dynamic Display
The built-in theme editor allows for easy drag-and-drop customization of key displays and the secondary screen. No coding is required, and real-time dynamic preview ensures immediate visual feedback. Users can import and export configurations and themes for sharing.
The device supports 10-screen splicing display, enabling dynamic layering of multiple images and videos across the keys for a flexible and rich visual presentation.

Image: The theme editor interface, demonstrating dynamic preview and custom macro plugin settings for personalized operation scenarios.
3.3 AI Voice Control and Smart Home Integration
The MK10 integrates AI speech recognition and interaction capabilities, supporting connection to mainstream AI models such as DeepSeek and XiaoZhi. This allows for natural and smooth voice control experiences, executing preset commands via AI.
Additionally, the product is compatible with the Home Assistant (HA) platform, enabling one-click linkage with smart home devices for comprehensive scene control.

Image: Illustration of the Waveshare MK10's AI speech recognition and interaction features, including sending commands to large language models and receiving replies.
4. Recursos avançados
4.1 Dual-System Architecture
The MK10 operates on a robust Linux + QMK dual-system architecture:
- Main Controller (T113-S3, Dual-core A7, 1.2GHz): Runs Linux for complex logic processing and advanced functionalities.
- Sub-Controller (GD32 MCU): Runs QMK to deliver a zero-latency, true mechanical input experience for the macro keys.

Image: Detailed diagram explaining the Linux + QMK dual-system architecture, highlighting the main and sub-controllers.
4.2 Real-Time Data Integration
The device supports real-time data integration into its themes, providing immediate access to critical system information:
- LibreHardwareMonitor: Displays CPU temperature, fan speed, and other hardware information.
- OpenWeather: Integrates live weather data for dynamic background updates.

Image: The Waveshare MK10 displaying real-time data such as CPU usage, GPU usage, SSD usage, and weather information on its screens.
4.3 Cross-Platform Support
The Waveshare MK10 is designed for broad compatibility, seamlessly working with both Windows and macOS operating systems, offering versatility for users across different computing environments.

Image: The Waveshare MK10 shown operating efficiently with both Windows and macOS systems, highlighting its cross-platform compatibility.
5. Manutenção
5.1 Instruções de Limpeza
To maintain the appearance and functionality of your Waveshare MK10, follow these cleaning guidelines:
- Disconnect the device from its power source before cleaning.
- Use um pano macio, seco e sem fiapos para limpar as superfícies externas.
- Para manchas persistentes, aplique levementeampLimpe o pano com água ou um detergente suave e não abrasivo. Evite borrifar líquidos diretamente no aparelho.
- Do not use harsh chemicals, solvents, or abrasive materials, as these can damage the finish and screens.
5.2 Atualizações de Software
The Waveshare MK10 benefits from continuous online updates for its themes and plugins. Regularly check for and install updates to ensure optimal performance, access new features, and maintain the cutting-edge functional experience. Refer to the official Waveshare website or the device's companion software for update procedures.
6. Solução De Problemas
If you encounter issues with your Waveshare MK10, please refer to the following common troubleshooting steps:
- Dispositivo não responde: Ensure the USB Type-C cable is securely connected to both the device and your computer. Try connecting to a different USB port or using a different cable.
- O software não detecta o dispositivo: Verify that the latest drivers and companion software are installed. Restart your computer and the MK10.
- Teclas com funcionamento incorreto: Check your key assignments in the theme editor. Ensure no conflicting macros are active.
- Problemas de exibição: If screens are blank or flickering, ensure the device is properly powered. Check theme settings for any display configurations that might be causing issues.
- AI Voice Control Problems: Ensure your internet connection is stable and that the device has access to the necessary AI models. Check microphone settings.
For further assistance, please visit the official Waveshare support website ou entre em contato com o atendimento ao cliente.
7. Especificações
| Recurso | Detalhe |
|---|---|
| Fabricante | Compartilhamento de ondas |
| Modelo | MK10 |
| Peso do item | 1.5 libras |
| Dimensões da embalagem | 7.8 x 7.8 x 2.7 polegadas |
| ASIN | B0FPLWGRXK |
| Cor | Branco |
| Material | Metal Or High-Quality Plastic |
| Tipo de exibição | LCD |
| Controlador principal | T113-S3 (Dual-core A7, 1.2GHz) |
| Sub-Controller | Microcontrolador GD32 |
| Tipo de chave | Mechanical LCD Macro Keys (10x 0.85-inch) |
| Tela Secundária | 2.01 polegadas |
| Sistemas Operacionais | Windows, macOS |
8. Garantia e Suporte
8.1 Suporte ao Produto
For technical support, product inquiries, or assistance with your Waveshare MK10, please visit the official Waveshare website or contact the seller directly. Ensure you have your product model and ASIN (B0FPLWGRXK) available when seeking support.
8.2 Informações de garantia
Specific warranty details may vary by region and retailer. Please refer to the warranty documentation included with your purchase or consult the Waveshare official webConsulte o site para obter a política de garantia mais recente aplicável ao seu produto.





