Gabe/technical-writing
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

typo corrections to paged-out! article.

Browse source
This commit is contained in:
Gabe Venberg 2025-03-05 17:25:23 +01:00
parent db61e97df5
commit 38c11053fb
2 changed files with 66 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

61
flake.lock generated Normal file
View file

@ -0,0 +1,61 @@
{
"nodes": {
"flake-utils": {
"inputs": {
"systems": "systems"
},
"locked": {
"lastModified": 1731533236,
"narHash": "sha256-l0KFg5HjrsfsO/JpG+r7fRrqm12kzFHyUHqHCVpMMbI=",
"owner": "numtide",
"repo": "flake-utils",
"rev": "11707dc2f618dd54ca8739b309ec4fc024de578b",
"type": "github"
},
"original": {
"owner": "numtide",
"repo": "flake-utils",
"type": "github"
}
},
"nixpkgs": {
"locked": {
"lastModified": 1740126099,
"narHash": "sha256-ozoOtE2hGsqh4XkTJFsrTkNxkRgShxpQxDynaPZUGxk=",
"owner": "nixos",
"repo": "nixpkgs",
"rev": "32fb99ba93fea2798be0e997ea331dd78167f814",
"type": "github"
},
"original": {
"owner": "nixos",
"ref": "nixos-unstable",
"repo": "nixpkgs",
"type": "github"
}
},
"root": {
"inputs": {
"flake-utils": "flake-utils",
"nixpkgs": "nixpkgs"
}
},
"systems": {
"locked": {
"lastModified": 1681028828,
"narHash": "sha256-Vy1rq5AaRuLzOxct8nz4T6wlgyUR7zLU309k9mBC768=",
"owner": "nix-systems",
"repo": "default",
"rev": "da67096a3b9bf56a91d16901293e51ba5b49a27e",
"type": "github"
},
"original": {
"owner": "nix-systems",
"repo": "default",
"type": "github"
}
}
},
"root": "root",
"version": 7
}

10
paged-out!/stop-using-trrs/main.typ
View file

@ -9,10 +9,10 @@
authors: "Foo", authors: "Foo",
) )
TRRS (Tip Ring Ring Sleeve, or, as you may know it, "headphone jack with microphone support") cables have long been the go to connector between split keyboard halves. TRRS (Tip Ring Ring Sleeve, or, as you may know it, "headphone jack with microphone support") cables have long been the go-to connector between split keyboard halves.
They are cheap, compact, and thanks to their popularity, come in a variety of aesthetic styles. They are cheap, compact, and thanks to their popularity, come in a variety of aesthetic styles.
However, TRRS jacks were only designed for passive electrical components, and expose one large flaw when used actively. However, TRRS jacks were only designed for passive electrical components, and expose a serious flaw when used actively.
When a TRRS cable is (dis)connected, the tip of the plug will slide past every single contact of the jack. When a TRRS cable is (dis)connected, the tip of the plug will slide past every single contact of the jack.
Likewise, the first contact of the jack will slide past every contact of the plug. Likewise, the first contact of the jack will slide past every contact of the plug.
@ -51,7 +51,7 @@ Now, what if we put the 5v at the base, so that it is the first pin disconnected
) )
In this case, we are looking at the active side of the board, connected to USB, and supplying power to the passive side. In this case, we are looking at the active side of the board, connected to USB, and supplying power to the passive side.
Now, when unplugged the 5v contact of the jack will immediately make contact with the Rx line, Now when unplugged, the 5v contact of the jack will immediately make contact with the Rx line,
pulling it up to 5v and damaging the pin on the passive side of the board. pulling it up to 5v and damaging the pin on the passive side of the board.
No matter what order we put the contacts in, No matter what order we put the contacts in,
@ -60,13 +60,13 @@ No other electronics found in your home suffer permanent damage from simply bein
In a moment of carelessness or forgetfulness, damage to hardware could easily happen. In a moment of carelessness or forgetfulness, damage to hardware could easily happen.
So what are the alternatives? So what are the alternatives?
USB-C, while almost as small as TRRS, are more expensive component wise and and USB-C, while almost as small as TRRS, are more expensive component wise and
having the same connector for board-to-board and PC-to-board connections may lead to user error. having the same connector for board-to-board and PC-to-board connections may lead to user error.
There are also a wide variety of JST and Molex connectors, some of which rival TRRS in size, There are also a wide variety of JST and Molex connectors, some of which rival TRRS in size,
but premade cables are not readily available, but premade cables are not readily available,
and many connectors have a tendency to work themselves loose over time. and many connectors have a tendency to work themselves loose over time.
My personal favorite are 4P4C connectors, also known as RJ9, RJ10, or RJ22. My personal favorite are 4P4C connectors, also known as RJ9, RJ10, or RJ22.
While bulky on the PCB, the connection is sturdy, cables are availible, and one can make ones own cables with a cheap crimping tool. While bulky on the PCB, the connection is sturdy, cables are availible, and one can make one's own cables with a cheap crimping tool.
There are of course other connectors, and any with at least 4 conductors will work for a split keyboard. There are of course other connectors, and any with at least 4 conductors will work for a split keyboard.
Unfortunately, there does not seem to be a perfect connector, but there are many alternatives better than TRRS. Unfortunately, there does not seem to be a perfect connector, but there are many alternatives better than TRRS.