HDMI Switch Mannul

BliKVM-Switch-V1.0 uses and tests video, supporting BliKVM and PiKVM

Introduction

BliKVM-Switch-V1.0 is a four channel HDMI+USB switch, which supports panel button, desktop controller, KVM remote to switch between computers. Maximum support of the switch itself 4K@60HZ Plug and play, drive free.
BliKVM-Switch-V1.0 uses the same hardware solution as XH-HK4401, AG7210 HDMI switching chip supports up to 4K@60Hz, CH444G USB switching chip supports USB2.0. The difference is that BliKVM-Switch-V1.0 is equipped with KVM USB cable, which can realize KVM port selection. BliKVM-Switch-V1.0 is compatible with BliKVM and PiKVM.

points for attention

The switch can be powered directly from the USB input to the computer, that is, the switch can work normally without power supply.
If the USB power supply of the controlled computer cannot make the switch work, the switch can be powered independently.
The switch package only provides a USB power cable, but does not provide a power adapter. The customer needs to configure a power adapter (5V).
Desktop controller can control HDMI switch with USB cable. For customers who do not use KVM, this is another way of switching for easy cable management.
HDMI input support up to 4096x2160/60Hz resolution
4K 60Hz input, the power is about 200 mW.

Interface diagram

There must be 2 USB cables from KVM to blikvm, one for controller, and second from USB on KVM to USB-PC on blikvm.

Front and back interface diagram, the control interface in the right figure is the remote control interface.A cable with one end being USB-A and the other end being micro USB, labeled with the word "KVM," serves as the control cable. The micro USB end is connected to the control interface of the switch, while the USB-A end is connected to the USB port of the KVM.

Schematic Diagram of Side Interface.

Equipment connection diagram.

Software configuration

!!! info "If you are using BliKVM software and have powered on the switch and connected the cables before starting BliKVM, no additional configuration is needed. BliKVM will automatically detect the switch when it starts. If automatic detection fails, you can manually specify the switch device. First, confirm the device descriptor name of the switch by using the terminal, such as /dev/ttyUSB0. Then, edit the switch_handle field in /usr/bin/blikvm/package.json. Set switch_enable to 1 and switch_path to /dev/ttyUSB0 in the configuration: . Afterward, restart BliKVM. Click MORE in the lower left corner, find the BliKVM switch column, and then switch. Note that the flashing blue dot of the corresponding channel indicates that the switch insertion is recognized and is in the current channel. If there is no blue dot, the switch insertion is not recognized。"

If you use PiKVM software, please configure it according to the following instructions.

Log in to PiKVM through SSH. The user name and password are root;
Uses the rw command on the terminal to change the system to a read-write system;

Edit /etc/kvmd/override.yaml this file to make it contain the following contents. That is, add after the original content.

kvmd:
    gpio:
        drivers:
            hk:
                type: xh_hk4401
                device: /dev/ttyUSB0
        scheme:
            ch0_led:
                driver: hk
                pin: 0
                mode: input
            ch1_led:
                driver: hk
                pin: 1
                mode: input
            ch2_led:
                driver: hk
                pin: 2
                mode: input
            ch3_led:
                driver: hk
                pin: 3
                mode: input
            ch0_button:
                driver: hk
                pin: 0
                mode: output
                switch: false
            ch1_button:
                driver: hk
                pin: 1
                mode: output
                switch: false
            ch2_button:
                driver: hk
                pin: 2
                mode: output
                switch: false
            ch3_button:
                driver: hk
                pin: 3
                mode: output
                switch: false
        view:
            table:
                - ["#Input 1", ch0_led, ch0_button]
                - ["#Input 2", ch1_led, ch1_button]
                - ["#Input 3", ch2_led, ch2_button]
                - ["#Input 4", ch3_led, ch3_button]

The above configuration is based on the 2022 pikvm image. If you are using the latest pikvm image or latest software version, Edit file /etc/kvmd/override.yaml and add the line: protocol: 2, Sample:

kvmd:
gpio:
    drivers:
        hk:
            type: xh_hk4401
            protocol: 2
            device: /dev/ttyUSB0
    scheme:
        ch0_led:
        driver: hk
        ...

Use the ro command on the terminal to reset the system to a read-only system;
Use 'systemctl restart kvmd' on the terminal to restart the service;
Enter the PiKVM web interface and click the GPIO menu. You should see 4 inputs, one of which has a green circle to indicate that it is currently selected. Click Other Inputs to change the selected host.

Control protocol

If you want to use the blicube switch on other platforms, please refer to the following protocol

The communication baud rate is 19200
The message sent to switch by switching to channel 1 isSW1\r\nG01gA
The message sent to switch by switching to channel 2 isSW2\r\nG02gA
The message sent to switch by switching to channel 3 isSW3\r\nG03gA
The message sent to switch by switching to channel 4 isSW4\r\nG04gA
The message returned by the switch for the current channel is:G01gA,G02gA,G03gA,G04gA

Packing list

product	quantity	note
HDMI KVM Switch(4-channel)	1	110mm * 60mm * 33mm
Desktop controller	1
USB cable of Desktop controller	4	length: 1.2m
HDMI(Standard) cable	5	length: 1.5m
USB power cable	1	length: 0.8m
USB cable of KVM	1	length: 1.5m
USB cable of Desktop controller	1	length: 1m

Last update: February 18, 2024
Created: January 7, 2023