summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDavid Kühling <665506+dvdkhlng@users.noreply.github.com>2022-12-04 21:43:28 +0100
committerGitHub <noreply@github.com>2022-12-04 20:43:28 +0000
commit2f92880578ce926c4901604d4ea4c176804d3202 (patch)
treeb15ac7f21f21757053c61080c7be4c0839896a9b
parent4d1b1bc534aeea4252bf25086810ceccff43f19f (diff)
dqz11n1g: Documentation improvement. (#19230)
Co-authored-by: David <dvdkhlng@posteo.de>
-rw-r--r--keyboards/handwired/dqz11n1g/matrix.c2
-rw-r--r--keyboards/handwired/dqz11n1g/readme.md20
2 files changed, 12 insertions, 10 deletions
diff --git a/keyboards/handwired/dqz11n1g/matrix.c b/keyboards/handwired/dqz11n1g/matrix.c
index f9f3f2b68f..d93dd853b6 100644
--- a/keyboards/handwired/dqz11n1g/matrix.c
+++ b/keyboards/handwired/dqz11n1g/matrix.c
@@ -38,7 +38,7 @@ void matrix_init_custom(void) {
/* 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
* on low-to-high transition (CPOL=1). Receive the LSB first (DORD=1).
*/
diff --git a/keyboards/handwired/dqz11n1g/readme.md b/keyboards/handwired/dqz11n1g/readme.md
index 0e3a57873d..9fbebb5178 100644
--- a/keyboards/handwired/dqz11n1g/readme.md
+++ b/keyboards/handwired/dqz11n1g/readme.md
@@ -2,24 +2,26 @@
![DQz11N1G](https://u.cubeupload.com/ddklg/OPBN5q.jpg)
-Firmware for a DIY controller replacement for one of the ortholinear contoured
-keyboards manufactured by [PCD Maltron Ltd](https://www.maltron.com)
+Using QMK with one of the ortholinear contoured keyboards manufactured by [PCD
+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
-with NO WARRANTY. Modifying your Maltron keyboard as described below will
-certainly void your warranty and may cause damage to your keyboard. Proceed
-at your own risk!
+with ABSOLUTELY NO WARRANTY, to the extent permitted by applicable law.
+Modifying your Maltron keyboard as described below will certainly void your
+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)
* 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
minor or no changes at all are required to make this work on different
language versions of the keyboard.
* Hardware Availability:
* [PCD Maltron Ltd](https://www.maltron.com), for the original keyboard
* 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.
* 19x pull-down resistors (10k Ohm),
* 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
-[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
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
@@ -57,7 +59,7 @@ board which is still easy to source.
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
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
the utilized shift-register inputs.