qmk_firmware

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

readme.md (2304B)

      1 # Raise
      2 
      3 ![](https://cdn.shopify.com/s/files/1/0374/9448/9228/files/Dygma-Raise-Hero2.png)
      4 
      5 * Keyboard Maintainer: [ibash](https://github.com/ibash)
      6 * Hardware Supported: [F411 Blackpill](https://github.com/WeActStudio/WeActStudio.MiniSTM32F4x1) with the [Dygma Raise](http://www.dygma.com)
      7 * Hardware Availability: See below
      8 
      9 
     10 Make example for this keyboard (after setting up your build environment):
     11 
     12     make handwired/dygma/raise/ansi:default
     13 
     14 Flashing example for this keyboard:
     15 
     16     make handwired/dygma/raise/ansi:default:flash
     17 
     18 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).
     19 
     20 ## Hardware
     21 
     22 QMK does not currently support the [Dygma Neuron](https://dygma.com/products/neuron-black) because QMK does not support SAMD21 which the Neuron has.
     23 Instead this code uses a [STM32 Blackpill](https://github.com/WeActTC/MiniSTM32F4x1) to create a Neuron replacement.
     24 
     25 ## Required Hardware
     26 
     27 1. [STM32 Blackpill from WeAct Studio](https://github.com/WeActTC/MiniSTM32F4x1) (via [aliexpress](https://www.aliexpress.com/item/1005001456186625.html) or [adafruit](https://www.adafruit.com/product/4877)).
     28 
     29 2. 2x USB-C breakouts (via [keeb](https://keeb.io/collections/diy-parts/products/usb-c-breakout-board) or [adafruit](https://www.adafruit.com/product/4090)).
     30 
     31 3. 2x 2.7KΩ resistors (via [digikey](https://www.digikey.com/en/products/detail/yageo/CFR-25JB-52-2K7/684)).
     32 
     33 4. Breadboard or PCB proto board, wires, solder, etc.
     34 
     35 ## Wiring
     36 
     37 Briefly each raise hand uses I2C to communicate with the Neuron:
     38 
     39 1. USB D+ is the I2C clock line.
     40 2. USB D- is the I2C data line.
     41 3. The resistors are pullup resistors for the I2C lines.
     42 4. Each hand draws power from the USB port.
     43 
     44 ![](https://i.imgur.com/ai9rcHal.png)
     45 
     46 <p float="left">
     47   <img src="https://i.imgur.com/GvXfnpf.jpg" width="200">
     48   <img src="https://i.imgur.com/kFKFjrU.jpg" width="200">
     49 </p>
     50 
     51 We are also prototyping a [custom pcb](https://www.reddit.com/r/DygmaLab/comments/ojgm95/pcb_for_running_qmk_on_the_raise/?utm_source=share&utm_medium=web2x&context=3).
     52 
     53 <p>
     54   <img src="https://i.imgur.com/xfzIxkW.png" width="200">
     55 </p>