qmk_firmware/keyboards/ferris/sweep
Albert Y a7bc02bf69
[Keyboard] Sweep swap hand feature and pin documentation (#15264)
Co-authored-by: filterpaper <filterpaper@localhost>
2021-11-29 00:19:00 -08:00
..
config.h [Keyboard] Add bootmagic lite keys to both halve of Sweep (#14732) 2021-10-10 20:48:02 -07:00
readme.md [Keyboard] Sweep swap hand feature and pin documentation (#15264) 2021-11-29 00:19:00 -08:00
rules.mk [Keyboard] Add bootmagic lite keys to both halve of Sweep (#14732) 2021-10-10 20:48:02 -07:00
sweep.c [Keyboard] Sweep swap hand feature and pin documentation (#15264) 2021-11-29 00:19:00 -08:00
sweep.h

Ferris sweep

Ferris sweep, top view Ferris sweep, bottom view

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 are:

make ferris/sweep:default:avrdude-split-left
make ferris/sweep:default:avrdude-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

Bootloader

Enter the bootloader in 3 ways:

  • Bootmagic reset: Hold down the top left key on the left half (or the top right 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 RESET 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 } \
}