From 2f92880578ce926c4901604d4ea4c176804d3202 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20K=C3=BChling?= <665506+dvdkhlng@users.noreply.github.com> Date: Sun, 4 Dec 2022 21:43:28 +0100 Subject: [PATCH] dqz11n1g: Documentation improvement. (#19230) Co-authored-by: David --- keyboards/handwired/dqz11n1g/matrix.c | 2 +- keyboards/handwired/dqz11n1g/readme.md | 20 +++++++++++--------- 2 files changed, 12 insertions(+), 10 deletions(-) diff --git a/keyboards/handwired/dqz11n1g/matrix.c b/keyboards/handwired/dqz11n1g/matrix.c index f9f3f2b68fd..d93dd853b6a 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 0e3a57873d5..9fbebb51786 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.