Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

The wiring to match the QMK firmware is confusing. #20

Open
SeattleChris opened this issue May 29, 2020 · 4 comments
Open

The wiring to match the QMK firmware is confusing. #20

SeattleChris opened this issue May 29, 2020 · 4 comments

Comments

@SeattleChris
Copy link

I was helping someone out with making their own DMOTE keyboard, and they were struggling with the proper order to wire things together. I looked at how the layout is defined in the QMK firmware and drew an image for how it seems the keys should be connected.

dmote-wire-drawn

Is my drawing correct?

Do you want me to submit a PR that includes this, or an updated, image?

@veikman
Copy link
Owner

veikman commented May 29, 2020

It certainly makes for an awkward graph in 2D, doesn’t it? 😅

Your drawing is correct. Here’s a picture of my build from last year:

2019-07-03_wiring

Here’s a diagram of the same design, possibly less confusing. I just drew it. It can certainly be improved and annotated.

20200529_dmote_connectiongraph_v050

It may not be clear from these pictures, but the physical shape of the case is the only reason for the convoluted graph. I found this to be the easiest way to wire it up in practice.

As for how best to present this, I’m not sure. I am roughly on step 4 of the list in #16. My ongoing work on the Concertina design will require a different graph. Maintainability is crucial and the application is versatile.

Right now, I continue to believe that the best way to present a detailed build guide is as a blog post or equivalent article, separate from the evolving code repo. I would be happy to link to it.

@SeattleChris
Copy link
Author

I think it is good if the repository, as the authoritative source, has a build guide. You could use the wiki feature of the GitHub repo, or markdown files in the docs directory. Then a blog post can be more focused on a more general audience to "get the word out", and not lose audience due to the overburden of including all the details.

@SeattleChris
Copy link
Author

Yea, deciphering it from the QMK layout I figured it probably made more sense in real physical 3D. I have doubts a device picture could get a good angle to see the complicated thumb cluster wiring. The device walls, tighter clearance, and 3D context make it harder to comprehend. A cross-section view, or some way to diagram it is probably the best bet.

@veikman
Copy link
Owner

veikman commented Apr 11, 2021

There is still no build guide or pretty wiring diagram for the DMOTE design, but those things do exist for the later Concertina design:

Those documents are external to the CAD application repository, by design.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants