KPCD GUI
How to Run the Software on Windows
1. Download the Repository
Use the following git command to clone the cdbus_gui repository. Make sure to include the , otherwise the pycdnet submodule directory will be empty:
git clone --recursive https://github.com/dukelec/cdbus_gui.git
Alternative (Manual ZIP Download):
You can also download the ZIP archive of the cdbus_gui project directly from the webpage. However, you will need to separately download the pycdnet repository and manually replace the empty pycdnet folder inside cdbus_gui with its contents.
(This extra step is required because GitHub's ZIP download feature does not automatically package git submodules.)
2. Install Python and Dependencies
If Python is not installed on your system, please install it first:
Ensure you install Python 3.8 or above. Download link: https://www.python.org/downloads/
Importante: During installation, make sure to check the option "Add Python to PATH".
After installing Python, open a standard Windows Command Prompt ( (not the interactive Python shell) and run the following command to install the required dependency packages:
pip install pythoncrc json5 websockets pyserial u-msgpack-python aiohttp IntelHex

3. Open the Directory
Navigate to your downloaded cdbus_gui directory in Windows File Explorer.

4. Open Command Prompt from the Folder
Click on the address bar at the top of File Explorer, type cmd, and press Ingresar.

5. Launch the Application
In the newly opened Command Prompt window, execute the following command and press Ingresar:

6. Access the Web GUI
Follow the on-screen prompt and navigate to the following URL in your web browser (please use a modern mainstream browser such as Chrome, Edge, or Firefox):
👉 http://localhost:8910
7. Connect to the Serial Port
En elSerial section, enter the corresponding COM port(p.ej.,COM6) or enter a matching substring such as the device VID:PID.
Click the Open (打开 / Open) button on the right.
Confirm that the status displays Online (在线 / Online).

8. Add Device and Open Register Control Panel
En elDevices section below:
Notes on Addressing & Localization:
The default device ID is typically fe(p.ej.,00:00:fe). If your board uses a different ID, simply replace fe with your target ID while leaving the 00:00: prefix unchanged.
If your operating system or browser display language is set to Chinese, the interface will automatically localize to Chinese.
Enter any custom name label.
Select the configuration file (.json) corresponding to your target board from the drop-down menu.
Click the Open Window (打开窗口 / Open Window) button on the right.
In the newly opened device page, you can now read and write registers, monitor status, and perform various configuration operations.

kpcd_gui_v3 Cross-platform (including Windows)
kpcd_gui_v3 For Windows 10 and above. Simply double-click the .bat script to run—no Python installation required.