50% low-profile hot-swappable keyboard

# Introduction

* Gateron hot-swappable low-profile switches
* 50% layout
* Based on the open source [QMK solution](https://github.com/qmk/qmk_firmware)
* The main control uses CKS32F103CBT6/AIR32F103CBT6
* Supports Via/Vial/OpenRGB/SignalRGB

## Update Notes

### 8/24 Update:
* Update OpenRGB to the latest official version and detect the system language (support Chinese). The related keyboard firmware needs to be updated at the same time.
* ArtemisRGB can be used through the OpenRGB SDK. Provide firmware that supports via/openrgb/signalrgb. You can freely choose to use these three RGB control software for lighting control (OpenRGB/SignalRGB/ArtemisRGB).
* ArtemisRGB is shown in the figure.
![`JV%XP)J[U%{PXX79`S5W4C.png] ### 8/22 Update:

* Added support for the new master control air32f103cbt6, which can directly replace the existing project with pin2pin, only 4.8 yuan.
* Provide uf2 bootloader and via+openrgb+signalrgb firmware for air32f103cbt6.
* No need for usb dp external hardware pull-up when using air32f103cbt6, which can save a resistor (1.5k).
* See the attachment and project link for related firmware.

### 8/17 Update:

* Added Via firmware (Vial is not supported), and also supports
* Via (V3 version 2.0.5 or web version [Via Web](https://usevia.app/#/)), and bottom light, axis light, indicator light, and knob can be set through Via.
* [OpenRGB](https://gitlab.com/CalcProgrammer1/OpenRGB)
* [SignalRGB](https://signalrgb.com/)
* Note: Via and the other two software can be used at the same time. Please be careful when using OpenRGB and SignalRGB at the same time. See the attachment for the updated content (zq50\_via\_openrgb\_signalrgb firmware and json package.zip).
* Via as shown in the picture:
![4.png] ![3.png] ![2.png] ![1.png] ![5.png] * SignalRGB as shown in the picture:
![7.png] ![6.png]
### 6/6 Update:

* Update vial version to v0.6.0, support visual setting of full-key anti-ghosting, etc.
* Update keyboard firmware.
* ![1.png] * ![2.png]
### 4/27 Update:

* This PCB has been verified
* Updated source code and firmware, fixed the problem that the WS2812RGB coding order is inconsistent with the datasheet provided by the merchant
* Added some lighting and function demonstration videos

## Function introduction

* Support [QMK/VIA](https://github.com/qmk/qmk_firmware).
* Support [Vial](https://get.vial.today/) (can realize GUI real-time key change, powerful function).
* Support [OpenRGB](https://gitlab.com/CalcProgrammer1/OpenRGB) (can realize GUI adjustment of lighting).
* Support [SignalRGB](https://signalrgb.com/).
* With RGB axis light bottom light (WS2812), it can realize analog bottom light axis light control (QMK support or OpenRGB). Onboard 80 lighting effects, support OpenRGB music rhythm, etc., rich playability, see [OpenRGB open source community](https://gitlab.com/CalcProgrammer1/OpenRGB) for details.
* With knob, support knob customization function.
* Support simulation of simple Windows 10 [Radial Controller](https://docs.microsoft.com/en-us/windows-hardware/design/component-guidelines/radial-implementation-guide) function (roller).
* Adopt uf2 format firmware, can realize firmware update through MSC download.
* Support personal Chinese version of Vial, support visual setting of light, i.e. indicator light.

# Related pictures

## PCB

![pc.png]
![pcb2.jpg]
![pcb3.jpg]
## Via/Vial

![1.png] GUI control RGB light

![2.png]
## OpenRGB

![3.png]
## Firmware update

After downloading the Bootloader, double-click the NRST button on the PCB or the RESET key code of QMK, and you can see that there is an MSC device connected. Copy or drag the firmware to be updated to the U disk to complete the update.

# Statement

* Thanks to QMK, VIA, VIAL, OPENRGB and other open source projects and their contributors.
* Related open source project addresses:
* [QMK Firmware](https://github.com/qmk/qmk_firmware)
* [uf2-stm32f103](https://github.com/mmoskal/uf2-stm32f103)
* [vial-qmk](https://github.com/vial-kb/vial-qmk)
* [vial-gui](https://github.com/vial-kb/vial-gui)
* [OpenRGB](https://gitlab.com/CalcProgrammer1/OpenRGB)
* [SignalRGB](https://signalrgb.com/)
* Thanks to Suda from Station B for the tutorial on customizing the mechanical keyboard and the help of all the experts.
* My level is limited, if there are any problems with the project, please correct me.
* For project-related information, please see the project attachment or [Github repository](https://github.com/zhaqian12/ZQ-Keyboard/tree/main/keyboard/zq50).

# Demo video

* RGB lighting demo
* Dial function demo
* Vial demo