![]() This is checked when the controller first starts up, and determines what half the keyboard is, and how to orient the keyboard layout. This method sets the keyboard's handedness by setting a flag in the persistent storage ( EEPROM). While MATRIX_MASKED isn't necessary to use SPLIT_HAND_MATRIX_GRID successfully, without it you may experience issues trying to suspend your computer with your keyboard attached as the matrix will always report at least one key-press. Each bit of a single value (starting form the least-significant bit) is used to tell qmk whether or not to pay attention to key presses at that intersection. You can instruct qmk to ignore that intersection by defining MATRIX_MASKED and then defining a matrix_row_t matrix_mask array in your keyboard config. ![]() Note that adding a diode at a previously unused intersection will effectively tell the firmware that there is a key held down at that point. # define SPLIT_HAND_MATRIX_GRID_LOW_IS_RIGHT To enable the split keyboard feature, add the following to your rules.mk: Note that the total resistance for the connected system should be within spec at 2.2k-10kOhm, with an 'ideal' at 4.7kOhm, regardless of the placement and number. If you wish to use the halves independently, it is also possible to use 4 resistors and have the pull-ups in both halves. The pull-up resistors may be placed on either half. The 4 wires of the TRRS cable need to connect GND, VCC, and SCL and SDA (aka PD0/pin 3 and PD1/pin 2, respectively) between the two Pro Micros. ?> Note that the pin used here is actually set by SOFT_SERIAL_PIN below. The 3 wires of the TRS/TRRS cable need to connect GND, VCC, and D0/D1/D2/D3 (aka PD0/PD1/PD2/PD3) between the two Pro Micros. For this reason, they are not recommended for connecting split keyboards. !> Using USB cables for communication between the controllers works just fine, but the connector could be mistaken for a normal USB connection and potentially short out the keyboard, depending on how it's wired. However, USB cables, SATA cables, and even just 4 wires have been known to be used for communication between the controllers. Make sure that you use one that actually supports 4 wires/lanes. You should always disconnect the board from USB before unplugging and plugging in TRRS cables, or you can short the controller, or worse.Īnother option is to use phone cables (as in, old school RJ-11/RJ-14 cables). However, since one of the wires carries VCC, this means that the boards are not hot pluggable. These provide 4 wires, making them very useful for split keyboards, and are easy to find. The most commonly used connection is a TRRS cable and jacks. If you want to use I 2C to communicate between halves, you will need a cable with at least 4 wires and 2x 4.7kΩ pull-up resistors. Required HardwareĪpart from diodes and key switches for the keyboard matrix in each half, you will need 2x TRRS sockets and 1x TRRS cable.Īlternatively, you can use any sort of cable and socket that has at least 3 wires. This assumes that you're using two Pro Micro-compatible controllers, and are using TRRS jacks to connect to two halves. Both hardware and software limitations are detailed within the driver documentation. ![]() Moreover Blackpill's uses 3.3v logic, and atmega32u4 uses 5v logic. Currently, mixing AVR and ARM is not possible as ARM vs AVR uses different method for serial communication, and are not compatible. !> Both sides must use the same MCU family, for eg two Pro Micro-compatible controllers or two Blackpills. !> ARM split supports most QMK subsystems when using the 'serial' and 'serial_usart' drivers. QMK Firmware has a generic implementation that is usable by any board, as well as numerous board specific implementations.įor this, we will mostly be talking about the generic implementation used by the Let's Split and other keyboards. ![]() Split keyboards can have a lot of benefits, but there is some additional work needed to get them enabled. They use two controllers-one plugging into USB, and the second connected by a serial or an I 2C connection over a TRRS or similar cable. Many keyboards in the QMK Firmware repo are "split" keyboards. ![]()
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |