keyboards/meira/readme.md

   1 # Meira
   2
   3 ![Miera](https://imgur.com/kF4MFlW)
   4
   5 A 4x12 ortholinear low-profile keyboard.
   6
   7 Keyboard Maintainer: [Cole Markham](https://github.com/colemarkham)
   8 Hardware Supported: Meira/ProMicro, Meira/FeatherBLE
   9 Hardware Availability: [WoodKeys.click](https://woodkeys.click/meira)
  10
  11 Two controllers are support: the Pro Micro, and the Adafruit Feather BLE 32u4. Support for each is defined as a hardware revision subfolder in QMK. Main differences include processor frequencies and matrix pinouts.
  12
  13 Make example for this keyboard (after setting up your build environment):
  14
  15     make meira/promicro:default
  16
  17 or
  18
  19     make meira/featherble:default
  20
  21 See [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) then the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information on generic QMK configuration and setup.
  22
  23 Both the Pro Micro and the Feather BLE use the Catalina bootloader, which is typically programmed using avrdude.
  24
  25 ## Matrix
  26
  27 In order to have enough pins for the matrix and other functions, a custom matrix is implemented using a demultiplexer to scan the columns. Since the demux is active low, the diodes must be oriented with the cathode connected to the demux pin. When looking at the bottom of the board with the controller at the top right, the cathode mark on the diode should be toward the left.
  28
  29 ## LED Controller
  30
  31 The in-switch LEDs are driven by an ISSI LED controller (IS31FL3731). The micro controller communicates with this chip using I2C. Individual LED control is possible, but currently only general backlighting support is implemented. This functionality is located in lighting.c, issi.c, and TWILib.c.