darkkirb/qmk_firmware
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
qmk_firmware/keyboards/ferris/sweep/readme.md
Joel Challis d2accb48e7
RESET -> QK_BOOT keyboard readme (#18110)
2022-08-20 11:34:17 +01:00

2.7 KiB
Raw Blame History

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

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 } \
}