Introduction

MK10 is a multi-functional AI smart control panel with 10 LCD mechanical keys and a 2.01inch secondary screen. The device supports voice recognition and AI platform integration, allowing users to conveniently manage applications, automation tasks, and smart home scenarios through voice interaction and one-click macro operations. The exquisite aluminum alloy body and adjustable stand design make MK10 an efficient interactive tool for creators and smart life users.

Hardware Connection

Connect the USB port of MK10 to the USB port of the computer using a Type-C data cable.
(Note: Please make sure that the USB port of the connected computer can provide a stable power supply.)

Software Settings

Download Software

• Windows version: ScreenKeyWindows
• Mac version: ScreenKeyMacOS

Run Theme

1. Download and unzip the software package.
2. Run the ScreenKeyWindows.exe application and ensure that "Screenkey Connected" is displayed in the upper left corner.
3. Download your favorite theme from the store in the upper right corner.

4. Select the theme you want to display from the Theme Select drop-down box, click "Save & Run", wait for the run to complete, and "File sent" will be displayed in the upper left corner.

XiaoZhi AI Application

XiaoZhi AI relies on the network and needs to be configured for the network first.

1. Device Networking

① Please insert the USB wireless network card into the USB port of the device first, and then power on the device. The current USB wireless network card does not support hot-swapping and needs to be plugged in before powering on.
② Open the software, click the ⚙ in the upper right corner to open settings.
③ A new option "Device Networking" will appear in the settings.

④ Select the target WiFi (ensure it's a 2.4GHz network), enter the password, and wait for the prompt "Connected" to confirm a successful connection.

2. Download and Load Theme

① Enter the store in the software, search for and download Secondscreen - Theme 20.

② Back to the main page, right-click on the secondary screen location → load, and select the downloaded 20.theme file.
③ In the side button bar, find Device → AI enable switching and AI status switching, and drag them to any position in the button panel.

④ Click "Save & Run", and the theme will take effect.
⑤ After configuration, the text may display the following status:
- `xiaozhiAI connect`: The XiaoZhi AI has successfully connected and can start interacting.
- `Captcha`: Xiaozhi AI is waiting to be activated.

3. Connect to XiaoZhi AI

① Open XiaoZhi official website, register and log in with your phone number.
② Select Add Device, and the system will prompt you to enter the verification code.

③ Check the verification code on the MK10 screen and enter it to complete the connection.

4. Control XiaoZhi Voice Status

• AI enable switching: Used to enable or disable the XiaoZhi AI function.

 Screen display instructions:  
 - `xiaozhiAI enable` / `xiaozhiAI connect`: XiaoZhi AI has connected and ready to start a conversation.  
 - `xiaozhiAI disable`: XiaoZhi AI has been disabled.
 - `Audio Device Error`: The audio interface is occupied, just restart the device  

• AI status switching: Used to control the XiaoZhi AI voice function.

 Screen display instructions:  
 - `xiaozhiAI Listening`: XiaoZhi is listening and can start voice commands.  
 - `xiaozhiAI Pausing`: XiaoZhi has paused listening and cannot receive voice commands temporarily.

XiaoZhi AI Chat

XiaoZhi AI can not only execute control commands for devices and host computers but also conduct simple conversations and information queries, enhancing the interactive experience.
For example: "How is the weather today?", "Play a song", "Tell a joke".

You can set the language, voice, and background introduction of the dialogue character in Console → Agents → Configure Role.

XiaoZhi AI Built-in Commands

XiaoZhi AI has built-in the following common commands, which are divided into host computer processing and device processing based on different processing methods.

Extended Commands (Custom AI Control)

In addition to the built-in commands mentioned above, you can also configure AI commands through controls:
① Fill in the voice command in the AI command field of the control

② Save the theme and run it
③ After running, it can be triggered by voice
Application example: "Open the Waveshare official website"

Theme Customization (Optional Operation)

1. Enter "Theme editing" Interface

After clicking the "Theme editing" button in the lower left corner, a screen selection window will pop up. There are three options in the pop-up window:

• Button: 10 x 0.85" mechanical display keys (resolution 128×128)
• Main screen: Overall area consisting of 10 keys (resolution 640×256)
• Secondary screen: 2.01inch secondary screen (resolution 240×296)

In this example, the secondary screen 240×296 is selected as the object for subsequent introduction.

2. Set "Image" Control

① Click "Image" to set the center coordinates of the image (centered by default (120,148)).
② Set the image path, place the created image in the \image\MK10 file directory and select it.

③ A preview of the image will appear in the canvas area. If you need to modify it, you can edit it by clicking on the layer.

3. Set "Text" Control

① Click on "Text" to set the text coordinate position (default (120,148), can be dragged and zoomed with the mouse).
② Set the text content, foreground color, and font, and click "Save" to take effect
③ If the "Data classification" switch is turned on, the text control will display the corresponding dynamic data in real time.

4. Set "Circular Progress Bar" Control

① Hover over "Circular Progress Bar" to select the progress bar type.
② Set the parameters such as circular coordinates, diameter, arc width, and interval.
③ Set the color, which can be displayed in three gradients or monochrome.
④ Set the starting and ending angles of the arc, control direction and arc length.
⑤ After selecting system data and setting the upper and lower limits, the progress bar dynamically displays the corresponding data.

5. Set "Linear Progress Bar" Control

① Click "Linear Progress Bar" to set coordinates, width, height, corner radius, edge width, etc.
② Set the rectangular border, background color, and content foreground color, which can be displayed in gradient or monochrome colors.
③ After checking the system data, the rectangular progress bar dynamically displays the corresponding data.

HA Configuration Guide

http://<Raspberry Pi IP>:8123/

wget -O - https://get.hacs.xyz | bash -

reboot

Settings - > Voice assistants - > Expose - > Assistants

Dual System Architecture Description

MK10 adopts a dual-system architecture:

• Host Mode

Run the host software on Windows/MacOS, which allows you to customize themes, macro commands, AI voice interaction, and other functions through a graphical interface.

• Independent Operation Mode (QMK Firmware)

Even without running the host software, the MK10 can rely on the built-in QMK firmware to perform the following functions:
① Keyboard input: Single key input, combined key input (e.g., Ctrl+C, Alt+Tab).
② Quick operation: Enter commands via Win+R to quickly open web pages, applications, folders, or files.
③ Mouse simulation: Perform mouse clicks, scrolling, and other operations.
④ QMK string: One-click entry of preset characters (such as entering the boot password when powering on/locking the screen).
⑤ Operational flow control: Delay, loop, conditional execution.
⑥ XiaoZhi AI: Supports simple voice dialogue (optional feature).

Resources

• XiaoZhi Emojis

FAQ

Support

Monday-Friday (9:30-6:30) Saturday (9:30-5:30)

Email: services01@spotpear.com