MK10 User Guide

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 "Finish of sending file" will be displayed in the upper left corner.

XiaoZhi AI Application

1. Device Networking

Note: Only 2.4GHz WiFi is supported, not 5G WiFi.

① Insert the wireless network card into the USB port and power it on again.
② Open the software, click the ⚙ in the upper right corner to open setting.
③ A new option "Network Configuration" 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.

3. Connect to XiaoZhi AI

① Open XiaoZhi official website, register and log in with your phone number or Google Account.The default language of the website is Chinese. You can switch the language in the upper right corner

② 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`: Indicates that XiaoZhi AI is connected and ready to start a conversation.  
 - `xiaozhiAI disable`: Indicates that the XiaoZhi AI is disabled.

AI status switching: Used to interrupt or activate the XiaoZhi AI voice function.

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

Theme Customization (Optional Operation)

Collapse

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: The 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.

Parameter introduction
Data classification	Description
LibreHardwareMonitor	System hardware monitors data and supports displaying CPU usage, temperature, memory usage, GPU load, etc. It requires the LibreHardwareMonitor library.
OpenWeather	Weather data, which can display temperature, humidity, wind speed, weather description, city information, etc. You can refer to the openweathermap website for an introduction to related parameters.
xiaozhiAI	Interaction data from Xiaozhi AI, such as voice assistant output, intelligent dialogue feedback, etc.
Weather and the city	Displays the weather information and geographical location name of the city set by the user, and is often used in conjunction with OpenWeather.
System Data	Local system status information, such as CPU usage, memory remaining, disk usage, etc., is updated in real time.
System Time	The current system time, which can be used as a clock.
Device information	Static information of the device, device brightness and volume information.
Audio decibels	Real-time environmental sound decibel level, which can be used to visualize the intensity of audio input.

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 "Rectangle Progress Bar" Control

① Click "Rectangle 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.

This tutorial is continuously updated.

Resources

XiaoZhi Emojis

FAQ

Question: Why can't the device connect to WiFi?

Answer:

1. Please confirm that the WiFi is on the 2.4GHz frequency band; 5G WiFi is not supported.
2. Confirm that the WiFi password is entered correctly.
3. Avoid special characters in the WiFi name.
4. Confirm that the network signal is stable, and you can use the mobile hotspot for comparison testing.

Question: How to check if the network card is working properly?

Answer:

1. Insert the network card into the Windows PC.
2. The first time you connect the network card, a USB flash drive will pop up. Double-click the exe file to install the realtek driver, and after the network card is connected, the wireless network will be recognized in Device Manager.