logo

qmk_firmware

custom branch of QMK firmware git clone https://anongit.hacktivis.me/git/qmk_firmware.git

readme.md (2108B)

    

  1. # xdboards/recon
  3. ![xdboards/recon](https://imgur.com/a/HcjT4yq)
  5. A split low profile keyboard with hotswap sockets that is built around the Sea-Picro microcontroller for it's dedicated RGB pin.
  7. * Keyboard Maintainer: [Daniel Weeks](https://github.com/Xanimos)
  8. * Hardware Supported: Recon PCB, Sea-Picro, backwards compatibility with ProMicro pin layout.
  9. * Hardware Availability: [xdboards.xyz shop](https://www.xdboards.xyz)
  11. Make example for this keyboard (after setting up your build environment):
  13.     make xdboards/recon:default
  15. See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs).
  17. ## Bootloader
  19. Enter the bootloader in 2 ways:
  21. * **Physical reset button**: Briefly press the button on the side of the PCB
  22. * **Keycode in layout**: Press the key mapped to `QK_BOOT` if it is available
  23. * **Boot Magic**: Hold down the boot magic key while plugging in the USB cable
  25. ## Setup for Sea-Picro microcontrollers
  27. To take advantage of the dedicated 5v RGB pin on the sea-picro you must create your keymap
  28. and then add a `rules.mk` file and copy and paste the following:
  29. ```
  30. CONVERT_TO = rp2040_ce
  31. USE_SEA_PICRO_RGB_PIN = yes
  32. ```
  34. If you do not want to use the dedicated 5v RGB header then follow the Setup for non Sea-Picro microcontrollers.
  36. ## Setup for non Sea-Picro microcontrollers
  38. Solder the "Pro-Micro Compatibility" jumper on the bottom of both boards.
  40. In your keymap directory:
  41.   - add/modify a `rules.mk` file
  42.     - Remove or set `CONVERT_TO` to desired converter see [QMK Documentation](https://docs.qmk.fm/#/feature_converters)
  43.     - Remove or set `USE_SEA_PICRO_RGB_PIN` to `no`
  46. ## Setup for Underglow rgb only
  49. Solder the "Per-Key RGB Skip" jumper on the bottom of both boards. Do not install per key RGBs.
  51. In your keymap directory:
  52.   - add/modify a `config.h` file and insert 
  53.     ```
  54.     #define RGB_MATRIX_SPLIT { 5, 5 }
  55.     #define RGB_MATRIX_LED_COUNT 10
  56.     ```
  57.