Chain DualKey Factory Firmware User Guide

Chain DualKey is a programmable dual-button input development board. Its factory firmware allows you to configure button functions and RGB LED colors, as well as other Chain series devices connected via the Chain Bus.

1.Button Numbering

In the factory firmware, the two buttons on Chain DualKey are named Key1 (Left Key) and Key2 (Right Key):

2.Switch Positions

• OFF USB: When the switch is in the middle position, Chain DualKey is turned off when not connected to an external power source, and operates in USB wired mode when connected (will also enable BLE and Wi-Fi).
• BLE / Wi-Fi: When the switch is toggled to the left or right, both modes function identically in this firmware, enabling BLE and Wi-Fi.

3.Connecting to Host as Keyboard

• Wired Connection: Use a USB-C cable to connect the Chain DualKey to a computer, smartphone, or other host device.
• Bluetooth Connection: Power the Chain DualKey via an external power source or toggle the switch to left / right side. On your computer, smartphone, or other host device, connect to the Bluetooth device named Chain DualKey. When a pairing code dialog appears, simply confirm it. This firmware supports pairing and connecting to only one Bluetooth host at a time. To connect to another host, unpair it from the currently paired device first.

Chain DualKey can connect to two devices simultaneously — one via a wired connection and the other via Bluetooth.

4.Configuration Web Page

Power the Chain DualKey via an external power source or toggle the switch to left / right side. On your computer or smartphone, connect to the Wi-Fi access point (SSID: DualKey_AP, Password: 12345678), then open a browser and visit 192.168.4.1 to access the configuration web page:

• The language of the page (Chinese / English) can be switched in the upper-right corner, where you can also check the Wi-Fi AP connection status and the latest update time.
• In the middle-left Basic Information section, you can configure the LED colors of the two buttons and check button states (when pressed, the ring becomes darker, as shown below), switch position, and battery status. If you set both button colors to pure black (0, 0, 0), the LEDs will not turn off — instead, they will display a rainbow 🌈 color cycle!
• In the middle HID Device Status section, you can set button functions, enable or disable USB wired mapping and BLE wireless mapping, and check USB and Bluetooth connection status.
• In the middle-right Wi-Fi section, you can configure the Wi-Fi network for Chain DualKey to connect to. Enter the SSID, password, and static IP address, then click Apply. Chain DualKey will disable AP mode and connect to the specified network. You can then access the configuration page from the assigned IP address via computer or smartphone.

Resetting Wi-Fi

To reset Wi-Fi settings: press and hold both buttons for 5 seconds until the Key1 LED turns off and the Key2 LED turns on, then release both buttons. The two LEDs will flash red 3 times, then alternately flash white 3 times. Wi-Fi settings will be reset — the device will forget connected networks and re-enable AP mode.

5.Chain Bus

Chain DualKey can connect to other Chain series devices—such as Chain Key and Chain Joystick—through the Chain Bus on either side. (More Chain series devices will be released soon.)

Devices in the Chain series can be connected via Chain Bridge or Chain Return. When connecting, pay attention to the direction: the triangle arrow at the bottom of each device should point outward from the Chain DualKey (the main controller), as shown below:

At the bottom of the configuration web page, you can view and configure the functions of all devices connected to the Chain Bus:

• Click a device in the top topology diagram to quickly jump to its corresponding section in the detailed device list below.
• Each device's detail card shows the latest triggered events and collected data values, and allows you to adjust the indicator LED color.
• Click HID Function Config to assign functions to various trigger events. Note that some trigger events may conflict with each other (especially Press, Release, and other button events). Be careful when assigning functions.
• When a device generates a trigger event or data update, its detail card will flash.
• Bus RGB refers to the indicator LED color for all devices on that Chain Bus (one side of the Chain DualKey).