keychron_qmk_firmware/keyboards/ferris/sweep

Ferris sweep

A version of the Ferris keyboard that uses a daughterboard, designed by the fantastic @davidphilipbarr with some input from @pierrechevalier83 for the copper pad. All PCB files are available on the project's github page

Keyboard Info

• Keyboard Maintainer: Pierre Chevalier
• Hardware Supported: Sweep (all versions)
• Hardware Availability: Print the PCB with gerber files from the repository

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

make ferris/sweep:default

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

Setting Handedness

Firmware uses handedness by EEPROM as default and it must be configured once on each side. The make commands for Pro micros are:

make ferris/sweep:default:avrdude-split-left
make ferris/sweep:default:avrdude-split-right

For Elite-C or compatible controllers using DFU bootloader, add the line BOOTLOADER = atmel-dfu into the user keymap rules.mk file and use the following make commands:

make ferris/sweep:default:dfu-split-left
make ferris/sweep:default:dfu-split-right

QMK Toolbox can also be used to set EEPROM handedness. Place the controller in bootloader mode and select menu option Tools -> EEPROM -> Set Left/Right Hand

RP2040 Controllers

Pro Micro RP2040 controllers are supported with QMK Converters. The make command example with handedness setting for Adafruit's KB2040 are:

make CONVERT_TO=kb2040 ferris/sweep:default:uf2-split-left
make CONVERT_TO=kb2040 ferris/sweep:default:uf2-split-right

Bootloader

Enter the bootloader in 3 ways:

• Bootmagic reset: Hold down the top left key on the left half (or the top right key on the right half) and plug in the controller on that side.
• Physical reset button: Briefly press the reset button soldered on the PCB.
• Keycode in layout: Press the key mapped to QK_BOOT if it is configured.

Swapped Pins

If you printed one of the PCB variant with swapped letters Q and B / P and N, add the following code to your keymap's config.h to swap pins E6 and D7 in the firmware:

#undef DIRECT_PINS
#define DIRECT_PINS { \
    { D7, F7, F6, F5, F4 }, \
    { B1, B3, B2, B6, D3 }, \
    { D1, D0, D4, C6, E6 }, \
    { B4, B5, NO_PIN, NO_PIN, NO_PIN } \
}
#undef DIRECT_PINS_RIGHT
#define DIRECT_PINS_RIGHT { \
    { F4, F5, F6, F7, D7 }, \
    { D3, B6, B2, B3, B1 }, \
    { E6, C6, D4, D0, D1 }, \
    { B5, B4, NO_PIN, NO_PIN, NO_PIN } \
}