qmk_firmware/keyboards/bastardkb/dilemma/readme.md
jack e1b42d5252
Refactor bastardkb/dilemma/3x5_2 (#25462)
* Refactor bastardkb/dilemma/3x5_2

- Rename splinky -> promicro as the DIY PCB supports a Pro Micro
  compatible development board
    - Update keyboard aliases accordingly
- Migrated shared configuration to top level 3x5_2 directory
- Migrate keymap to JSON
- Migrate miscellaneous configuration to JSON
- Remove configuration that trends towards user-specific (CRC Table)
- Use short SPDX license headers
- Tidy up readme and make note of differences between PCBs

In short, the only difference between these two revisions (assembled vs.
promicro) is SPI vs. I2C (respectively) is used for the Cirque Trackpad.

* Migrate promicro configuration to AVR

The code in dilemma.c that reinitialises the ADC capable pins on RP2040
as digital inputs is not needed. Per section RP2040-E6 (p.630) of RP2040
datasheet, it appears digital inputs are *not* disabled, and this should
be handled internally anyway in matrix initialisation
2025-07-10 12:42:36 +01:00

1.7 KiB

Dilemma

  • Keyboard Maintainer: BastardKB
  • Hardware Supported: Dilemma PCBs with integrated or devlopment board* microcontrollers
  • Hardware Availability: GitHub

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

make bastardkb/dilemma/3x5_2/assembled:default
make bastardkb/dilemma/3x5_2/promicro:default
make bastardkb/dilemma/3x5_3:default
make bastardkb/dilemma/4x6_4:default

Flashing example for this keyboard:

make bastardkb/dilemma/3x5_2/assembled:default:flash
make bastardkb/dilemma/3x5_2/promicro:default:flash
make bastardkb/dilemma/3x5_3:default:flash
make bastardkb/dilemma/4x6_4:default:flash

Note*: the dilemma/3x5_2/promicro revision is the only DIY Dilemma PCB. It is footprint and pin compatible with a Pro Micro development board, and the firmware is written as such it can be used with the Converter Feature. This PCB uses I2C communication for the Cirque Trackpad, opposed to SPI for the variants with an integrated microcontroller.

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 3 ways:

  • Bootmagic reset: Hold down the key at (0,0) in the matrix and plug in the keyboard
  • Physical reset button: Double-tap the reset button under/near the microcontroller.
  • Keycode in layout: Press the key mapped to QK_BOOT if it is available