qmk_firmware

QMK firmware for my keyboards (Corne, Sweep Ferris) and trackball (Ploopy Adept)
Log | Files | Refs | Submodules | LICENSE

readme.md (2130B)


      1 # Drashna's Blackpill Tractyl Manuform (5x6) with a right side trackball
      2 
      3 * System Timer on TIM5
      4 * VBUS mod, using PB10 -- does work, but not on my tractyl... bad soldering probably
      5 * Split Hand Pin, using PC14
      6 * Full Duplex Serial/USART using PA2 and PA3 on USART2
      7 * PWM Audio using PB1 and TIM3 and GPT on TIM4
      8 * PWM WS2812 RGB using PA1 TIM2
      9 * 8KB SPI EEPROM chip sharing PA5-PA7 on SPI1 with PA4 as CS pin
     10 * pmw3360 sensor sharing PA5-PA7 on SPI1, with B0 as CS pin
     11 * Encoder using PA13 and PA14
     12 * SSD1306 OLED display (128x64) using PB8-PB9 on I2C1
     13 * Pull-up resistor (22k) on PA10 to fix reset issue.
     14 * Pull-up resistor (5.1k) on PA1 for WS2812 LED support, and wire it's VCC to the 5V pin.
     15 * Pins PA9 is meant for VBUS sense, and has an internal pulldown resistor. A 5.1k pullup resistor can work (but should be avoided)
     16 * Pins PA11 and A12 are not useable because they're used for USB connection, and can't be shared. 
     17 * Pin PB2 is used by BOOT1, and is unusable
     18 
     19 ## Keyboard Info
     20 
     21 * Keyboard Maintainer: [Drashna Jael're](https://github.com/drashna)
     22 * Hardware Supported: [Design files](https://gitlab.com/keyboards1/dm_r_track/-/tree/master/boolean), [WeAct BlackPill (F411)](https://github.com/WeActStudio/WeActStudio.MiniSTM32F4x1), [PMW3360 Optical Sensor](https://www.tindie.com/products/jkicklighter/pmw3360-motion-sensor/)
     23 
     24 Make example for this keyboard (after setting up your build environment):
     25 
     26     make handwired/tractyl_manuform/5x6_right/f411:default
     27 
     28 Flashing example for this keyboard:
     29 
     30     make handwired/tractyl_manuform/5x6_right/f411:default:flash
     31 
     32 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).
     33 
     34 ## Bootloader 
     35 
     36 * **Bootmagic reset**: Hold down the top right key on the right side, or the top left key on the left side while plugging in.
     37 * **Physical reset button**: Briefly press the "USER" button on the BlackPill
     38 * **Keycode in layout**: Press the key mapped to `QK_BOOT`.