qmk_firmware/keyboards/xdboards/recon/readme.md
Daniel Weeks 3b874ee434
[Keyboard] Add xdboards/recon keyboard (#24135)
Co-authored-by: Drashna Jaelre <drashna@live.com>
2024-10-24 02:04:51 -07:00

2.1 KiB

xdboards/recon

xdboards/recon

A split low profile keyboard with hotswap sockets that is built around the Sea-Picro microcontroller for it's dedicated RGB pin.

  • Keyboard Maintainer: Daniel Weeks
  • Hardware Supported: Recon PCB, Sea-Picro, backwards compatibility with ProMicro pin layout.
  • Hardware Availability: xdboards.xyz shop

Make example for this keyboard (after setting up your build environment):

make xdboards/recon:default

See the build environment setup and the make instructions for more information. Brand new to QMK? Start with our Complete Newbs Guide.

Bootloader

Enter the bootloader in 2 ways:

  • Physical reset button: Briefly press the button on the side of the PCB
  • Keycode in layout: Press the key mapped to QK_BOOT if it is available
  • Boot Magic: Hold down the boot magic key while plugging in the USB cable

Setup for Sea-Picro microcontrollers

To take advantage of the dedicated 5v RGB pin on the sea-picro you must create your keymap and then add a rules.mk file and copy and paste the following:

CONVERT_TO = rp2040_ce
USE_SEA_PICRO_RGB_PIN = yes

If you do not want to use the dedicated 5v RGB header then follow the Setup for non Sea-Picro microcontrollers.

Setup for non Sea-Picro microcontrollers

Solder the "Pro-Micro Compatibility" jumper on the bottom of both boards.

In your keymap directory:

  • add/modify a rules.mk file
    • Remove or set CONVERT_TO to desired converter see QMK Documentation
    • Remove or set USE_SEA_PICRO_RGB_PIN to no

Setup for Underglow rgb only

Solder the "Per-Key RGB Skip" jumper on the bottom of both boards. Do not install per key RGBs.

In your keymap directory:

  • add/modify a config.h file and insert
    #define RGB_MATRIX_SPLIT { 5, 5 }
    #define RGB_MATRIX_LED_COUNT 10