dqz11n1g: Documentation improvement. (#19230)

Co-authored-by: David <dvdkhlng@posteo.de>
This commit is contained in:
David Kühling 2022-12-04 21:43:28 +01:00 committed by GitHub
parent 4d1b1bc534
commit 2f92880578
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 12 additions and 10 deletions

View file

@ -38,7 +38,7 @@ void matrix_init_custom(void) {
/* columns read via shift-register on SPI lines */ /* columns read via shift-register on SPI lines */
/* Enable SPI, Master, set clock rate fck/2. First bit already at Qh /* Enable SPI, Master, set clock rate fck/16. First bit already at Qh
* output before clock edge (CPHA=0). SN74HC165 shift register shifts * output before clock edge (CPHA=0). SN74HC165 shift register shifts
* on low-to-high transition (CPOL=1). Receive the LSB first (DORD=1). * on low-to-high transition (CPOL=1). Receive the LSB first (DORD=1).
*/ */

View file

@ -2,24 +2,26 @@
![DQz11N1G](https://u.cubeupload.com/ddklg/OPBN5q.jpg) ![DQz11N1G](https://u.cubeupload.com/ddklg/OPBN5q.jpg)
Firmware for a DIY controller replacement for one of the ortholinear contoured Using QMK with one of the ortholinear contoured keyboards manufactured by [PCD
keyboards manufactured by [PCD Maltron Ltd](https://www.maltron.com) Maltron Ltd](https://www.maltron.com) by modding it with a DIY replacement
controller.
This work here in no way officially associated with PCD Maltron Ltd and comes This work here in no way officially associated with PCD Maltron Ltd and comes
with NO WARRANTY. Modifying your Maltron keyboard as described below will with ABSOLUTELY NO WARRANTY, to the extent permitted by applicable law.
certainly void your warranty and may cause damage to your keyboard. Proceed Modifying your Maltron keyboard as described below will certainly void your
at your own risk! warranty and may e.g. cause damage to your keyboard. Proceed at your own risk!
* maintainer: [David Kuehling](https://github.com/dvdkhlng/qmk_firmware_dqz11n1g) * maintainer: [David Kuehling](https://github.com/dvdkhlng/qmk_firmware_dqz11n1g)
* Hardware Supported: Maltron DQz11N1G with a replacement controller board * Hardware Supported: Maltron DQz11N1G with a replacement controller board
assembled as described below. The work here is based on a german version assembled as described below. The work here is based on a German version
of the keyboard: DQz11N1G-DE. I assume, but don't know for sure, that of the keyboard: DQz11N1G-DE. I assume, but don't know for sure, that
minor or no changes at all are required to make this work on different minor or no changes at all are required to make this work on different
language versions of the keyboard. language versions of the keyboard.
* Hardware Availability: * Hardware Availability:
* [PCD Maltron Ltd](https://www.maltron.com), for the original keyboard * [PCD Maltron Ltd](https://www.maltron.com), for the original keyboard
* 1x [Arduino Pro Micro](https://www.sparkfun.com/products/12640) * 1x [Arduino Pro Micro](https://www.sparkfun.com/products/12640)
* 3x [SN74HC165](https://www.ti.com/product/SN74HC165) * 3x shift register [SN74HC165](https://www.ti.com/product/SN74HC165)
* 3x ceramic blocking capacitors (100 nF) one for each shift register
* 1x DIL connector 2 rows a 17 pins. * 1x DIL connector 2 rows a 17 pins.
* 19x pull-down resistors (10k Ohm), * 19x pull-down resistors (10k Ohm),
* 4 LED current limiting resistors (not sure about the correct resistance, * 4 LED current limiting resistors (not sure about the correct resistance,
@ -31,7 +33,7 @@ Make example for this keyboard (after setting up your build environment):
## In Detail ## In Detail
[PCD Maltron Ltd](https://www.maltron.com) manufacturs ergonomic keyboards [PCD Maltron Ltd](https://www.maltron.com) manufactures ergonomic keyboards
that appear to be hand-wired internally. For the Maltron DQz11N1G-DE that appear to be hand-wired internally. For the Maltron DQz11N1G-DE
keyboard that I happen to own, the keyboard matrix is wired to a 34-pin DIL keyboard that I happen to own, the keyboard matrix is wired to a 34-pin DIL
connector. This makes it rather easy to replace the proprietary connector. This makes it rather easy to replace the proprietary
@ -57,7 +59,7 @@ board which is still easy to source.
Unfortunately pin-count of the DQz11N1G-DE's keyboard matrix is way beyond Unfortunately pin-count of the DQz11N1G-DE's keyboard matrix is way beyond
the Pro Micro's available I/O pin count. I'm using three 8-bit the Pro Micro's available I/O pin count. I'm using three 8-bit
shift-registers ([SN74HC165](https://www.ti.com/product/SN74HC165) ) to shift-registers ([SN74HC165](https://www.ti.com/product/SN74HC165) ) to
connect the 19 colums of the keyboard matrix for readout. Due to diode connect the 19 columns of the keyboard matrix for readout. Due to diode
direction in DQz11N1G-DE we also need 19 pull-down resistors one for each of direction in DQz11N1G-DE we also need 19 pull-down resistors one for each of
the utilized shift-register inputs. the utilized shift-register inputs.