kmbox B+ (pro) User Manual

What is kmbox B+(pro)

Kmbox is a small and powerful USB development board which essentially functions as a keyboard and a mouse controller without having to install additional drivers or inject DLLs.

Scripts are completely separated from PC and run on CPU inside the box, which would easily allow ordinary keyboard and mouse (non-macro keyboard and mouse) programmable functions (macro functions).

A couple of simple python calls would turn ordinary keyboard and mouse into magic.

Not only that, it helps you get started with Python fairly quickly, learn programming, play with hardwares, etc. Whether it is the underlying hardware logic or the upper-layer framework application, kmbox will accompany you all the way. Definitely great for DIY enthusiasts.

1714557515342

Beginner's Guide

Here we'll learn how to use kmbox B+

01 Introduction

The following accessories are included in the package:

kmbox b+ (front and back)

1714558057271 1714558176051-en

Two Blue USB cables

02 Where to plug these cables

Port names are on the back of the box:

1714558353653

Note: if you are gaming on a single PC, cables plugged to "port serial" and "controlled PC" should both be connected to the gaming PC.

03 Install Serial Driver

Installation of serial driver is needed for PCs connected through serial port.

For starters, open your device manager and locate your COM port.

Please install the serial driver if none can be found;

There's no need to install a driver if the following is shown:

Click me to download driver

1714558507418

Note: The COM number is randomly allocated for each PC, check yours to make sure.

1714558825061

For now, no further installation is needed for the box.

If you require guidance with your assisting program, it is recommended that you refer to their manual.

The above instructions can be found in the following video:

04 Connect your gaming mouse to the Mouse and Keyboard port

You are recommended to connect your mouse to the box; otherwise, a multi-mouse input situation will occur.

After connecting your mouse to the box, no additional steps are required if your mouse could move around smoothly; Else, please refer to the section in FAQ on how to pair your mouse with your PC.

FAQ

Activation

Important: Do not upgrade your firmware if your box was not activated before 2024.8.31;

Normal upgrading is supported if your box was activated before 2024.8.31.

Legal Copy Check & Activation Guide

Click me to download activation tool

How to upgrade your firmware

There will be newly upgraded firmwares each month for B+ version to fix known bugs and improve keyboard and mouse features accordingly. You are recommended to download the latest firmware.

01_Download tools for upgrades

Click me to download

02_Download firmwares

Click me to download kmbox B+ firmwares

03_Upgrade your firmwares

Please follow the instructions closely. Make sure your COM number is correct. Try another PC if all failed.

1714559980660

1714560017442

1714560040318

How to customize your curve

01-What's the curve correction function?

This function allows a smoother mouse trajectory,free of unwanted glitches,teleportation and pauses. By default, the curve function is turned off.

Further instructions can be found in the following videos:

02-Download the software for controlling host PC

To customize your curve, you need the software to controll host PC.Click me to download tools for upgrades

03-upycraft Connect to the box

1714560376567

Modify the value in boot.py to the one that you want.

Note: After modification, ctrl+s to save, and download to the box.

1714560593043

1714560678856

1714560848358

How to modify your baud rate

By default, baud rate for the box is set to 115200. You can modify the rate through km.baud().

1714561167845

Note: After modification, save first(ctrl+s), download to the box and reboot it to take effect. Remember, only a baud rate of 115200 is supported by upycarft which would disconnect from the box if other rates are in place.

1714560593043

In the following image, baud rate is modified to 128000. To take effect, download and save the result before rebooting the box.

1714561428044

1714561555398

At this point, upycraft can no long connect to the box for it only supports a baud rate of 115200. To change it back, you can either reset your firmware or use the scroll wheel on your mouse to toggle.

Furthor instructions on how to toggle baud rate using scroll wheel on the mouse is included in the following video:

How to pair your mouse and keyboard

Your mouse needs pairing if it won't move or click after being connected to the box.

Refer to the following video for instructions:

How to modify mouse polling rate

You can change the polling rate to improve your mouse speed it moves rather slowly after connecting to the box. By default, the polling rate of the box is set to 500. Check out the following video for instructions on how to change the rate: