1. 제품 오버view
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.

이미지: 이상view of the Waveshare MK10 AI Voice Control Panel, showcasing its LCD macro keys, QMK response, flexible configuration, and AI/HA support.
2. 설정 가이드
2.1 패키지 내용
설치를 진행하기 전에 패키지에 모든 구성품이 들어 있는지 확인하십시오.
- Waveshare MK10 Unit (White) x1
- USB Type-C 케이블 x1
- USB 동글 x1
- 분리형 스탠드 x1

Image: The package contents for the Waveshare MK10, including the device, USB cable, USB dongle, and detachable stand.
2.2 물리적 연결
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 배치 옵션
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°): 낮은 프로의 경우file, 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. 장치 작동
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.
- 주요 조합: Program keys to execute multiple key presses simultaneously (e.g., Ctrl+C).
- 거시적 운영: Create complex sequences of actions with a single press.
- 마우스 제어: Assign mouse movements or clicks to keys.
- 다중 명령 체이닝: 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 테마 편집기 및 동적 표시
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. 고급 기능
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. 유지관리
5.1 청소 지침
To maintain the appearance and functionality of your Waveshare MK10, follow these cleaning guidelines:
- Disconnect the device from its power source before cleaning.
- 부드럽고, 건조하고, 보푸라기가 없는 천을 사용하여 외부 표면을 닦으세요.
- 완고한 얼룩의 경우 가볍게 dampen the cloth with water or a mild, non-abrasive cleaner. Avoid spraying liquids directly onto the device.
- Do not use harsh chemicals, solvents, or abrasive materials, as these can damage the finish and screens.
5.2 소프트웨어 업데이트
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. 문제 해결
If you encounter issues with your Waveshare MK10, please refer to the following common troubleshooting steps:
- 장치가 응답하지 않음: 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.
- 소프트웨어가 기기를 감지하지 못했습니다: Verify that the latest drivers and companion software are installed. Restart your computer and the MK10.
- 키가 제대로 작동하지 않습니다: Check your key assignments in the theme editor. Ensure no conflicting macros are active.
- 디스플레이 문제: 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 web사이트를 방문하거나 고객 서비스에 문의하세요.
7. 사양
| 특징 | 세부 사항 |
|---|---|
| 제조업체 | 웨이브셰어 |
| 모델 | 엠씨10 |
| 품목 무게 | 1.5파운드 |
| 패키지 크기 | 7.8 x 7.8 x 2.7 인치 |
| ASIN | B0FPLWGRXK |
| 색상 | 하얀색 |
| 재료 | Metal Or High-Quality Plastic |
| 디스플레이 유형 | 액정표시장치 |
| 메인 컨트롤러 | T113-S3 (듀얼코어 A7, 1.2GHz) |
| 서브 컨트롤러 | GD32 MCU |
| 키 유형 | Mechanical LCD Macro Keys (10x 0.85-inch) |
| 보조 화면 | 2.01인치 |
| 운영 체제 | 윈도우, 맥OS |
8. 보증 및 지원
8.1 제품 지원
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 보증 정보
Specific warranty details may vary by region and retailer. Please refer to the warranty documentation included with your purchase or consult the Waveshare official web해당 제품에 적용되는 최신 보증 정책은 해당 웹사이트에서 확인하세요.





