XT/AT/PS2/Terminal to USB Converter with NKRO

vladafkv

14 Jul 2020, 03:07

Hi! Im very happy that I finally got my hands on the IBM Model M keyboard. It was very dirty when it arrived so I had to fully disassemble it and do a bolt mod on it. Now I need help converting it to USB Type C. I bought a teensy off of ebay for $10 and type c connector board. I removed the SDL connector from the board and soldered teensy to it but I have trouble soldering type c connector board. I was following this guide : https://sudonull.com/post/17086-How-to-cook-IBM-Model-M

But its very hard for me to understand this part:

For our purposes, we need power (A4, B9, B4, A9), ground (A1, A12, B1, B12 and connector body), a pair for data transmission - D + (A6, B6) and D− (A7, B7). CC1 and CC2 must be connected to ground through resistors with a resistance of 5.1 kΩ. We connect to the stub of the USB cable bundled with Teensy: black - ground, red - power, green - D +, white - D−. A little plastic, superglue, electrical tape - and the connector is ready. Fix the tie and the keyboard is ready.

I believe this was translated from a russian website. Im not the best with understanding how this works. Can anyone help me?

I have the same components as seen in this guide.

JBert

14 Jul 2020, 13:31

While there are translation mistakes in the text (including the title), the bit you quoted actually looks correct.

Basically it refers to this USB C connector diagram:
mmmbbohpxsacjnr5v0xhagzly6g_usb_c_diagram.png
Here you can see that there are connector pins labeled A1 to A12, and pins B1 to B12. The text is thus instructing you to look up which holes in the USB C connector board you need to solder together and then on to which pin of the mini USB cable (which will go to the Teensy). A4, B9, B4, A9 are all "VBUS" / power pins. They should be all connected to the red wire in your USB cable. Same for (A1, A12, B1, B12) = ground = black cable; (A6, B6) = D+ = green cable; (A7, B7) = D- = white cable

Then CC1 and CC2 are the only ones left: here they mean that pin A5 needs a 5.1 kΩ resistor soldered to it with the other end of the resistor connected to ground (i.e. pin A1, A12, B1, B12 and the black USB cable). Another 5.1 kΩ resistor is connected to pin B5 with the other end also going to ground, and again connected in some way to all the ground pins and the black cable.

Once you get all those wires of the USB cable soldered then you can connect the Teensy and start testing.

EDIT: Well, before plugging in an USB cable it might be better to take out your multimeter and check that there is no short-circuit in your soldering, and verify that the right pins from the USB C connector board have been soldered.

vladafkv

14 Jul 2020, 14:06

Maybe a stupid question, but how do I connect 4 pins to 1 wire? Im new to this im sorry

diagram doesnt show up, it just says mmmbbohpxsacjnr5v0xhagzly6g_usb_c_diagram.png

kelvinhall05

18 Jul 2020, 04:14

Any idea if this will work with a Wang 725? If so, does someone have a pinout of the Wang's connector? Mine doesn't have the cable :(

User avatar
t8c

18 Jul 2020, 17:29

kelvinhall05 wrote:
18 Jul 2020, 04:14
Any idea if this will work with a Wang 725? If so, does someone have a pinout of the Wang's connector? Mine doesn't have the cable :(
Pinout is at the bottom http://sandy55.fc2web.com/keyboard/wang_724.html

kelvinhall05

18 Jul 2020, 17:34

t8c wrote:
18 Jul 2020, 17:29
kelvinhall05 wrote:
18 Jul 2020, 04:14
Any idea if this will work with a Wang 725? If so, does someone have a pinout of the Wang's connector? Mine doesn't have the cable :(
Pinout is at the bottom http://sandy55.fc2web.com/keyboard/wang_724.html
You're a legend :D

Does it just speak AT or something? I will try wiring a converter up when it gets here :)

User avatar
Inxie

18 Jul 2020, 21:08

I just want to personally thank Soarer for this honestly. I got my first IBM Model F (typing on it right now) and I was worried I was going to have problems adopting this for use on my modern PC, especially with the F's NKRO. Nope, I've been playing Doom Eternal on a Model F XT with Soarer's converter now for the past 12 hours, and not one beat skipped (just lost in the game's repetitiveness honestly). I am VERY impressed. You'd think this keyboard was natively USB, there's no sign that it's being converted. Even with print-screen by default being mapped to num pad *, I know people on GitHub thought this was incorrect, but actually it's very correct. Running CheckIt for DOS through DOSBox even passes the Print Screen key due to this, so this is correct behavior. It's Windows that simply doesn't treat it as Print Screen anymore (nothing Greenshot with a custom written .ini won't solve).

So yea, thank you Soarer for this, because now my first hand experience with a Model F in 2020 is perfect. (I last used a Model F when I was in elementary school in the early 90's).

vladafkv

19 Jul 2020, 00:09

Inxie wrote:
18 Jul 2020, 21:08
I just want to personally thank Soarer for this honestly. I got my first IBM Model F (typing on it right now) and I was worried I was going to have problems adopting this for use on my modern PC, especially with the F's NKRO. Nope, I've been playing Doom Eternal on a Model F XT with Soarer's converter now for the past 12 hours, and not one beat skipped (just lost in the game's repetitiveness honestly). I am VERY impressed. You'd think this keyboard was natively USB, there's no sign that it's being converted. Even with print-screen by default being mapped to num pad *, I know people on GitHub thought this was incorrect, but actually it's very correct. Running CheckIt for DOS through DOSBox even passes the Print Screen key due to this, so this is correct behavior. It's Windows that simply doesn't treat it as Print Screen anymore (nothing Greenshot with a custom written .ini won't solve).

So yea, thank you Soarer for this, because now my first hand experience with a Model F in 2020 is perfect. (I last used a Model F when I was in elementary school in the early 90's).
what components did you use to convert it?

User avatar
Inxie

19 Jul 2020, 05:51

vladafkv wrote:
19 Jul 2020, 00:09
what components did you use to convert it?
Mine was a pre-built on eBay, built into the USB plug itself. I believe they are the only authorized seller for them.

User avatar
fohat
Elder Messenger

19 Jul 2020, 15:45

Orihalcon perfected his cable construction and my recollection is that he provides his own firmware programming instructions (in addition to Soarer's listed here).

Contact him via ebay or this forum and he will probably help you out.

User avatar
Hypersphere

19 Jul 2020, 16:26

My first keyboard conversion project was an IBM-XT. I put a Teensy inside along with a flush-mount USB-B connector (I thought this heavy-duty board ought to have a more sustantial connector than a mini or micro USB). Programmed the Teensy with Soarer's converter. This XT is still one of my favorite keyboards.

I've also used cables with built-in converters as well as internal converters from Orihalcon -- I second fohat's recommendation -- Orihalcon makes excellent products.

vladafkv

20 Jul 2020, 03:15

Hypersphere wrote:
19 Jul 2020, 16:26
My first keyboard conversion project was an IBM-XT. I put a Teensy inside along with a flush-mount USB-B connector (I thought this heavy-duty board ought to have a more sustantial connector than a mini or micro USB). Programmed the Teensy with Soarer's converter. This XT is still one of my favorite keyboards.

I've also used cables with built-in converters as well as internal converters from Orihalcon -- I second fohat's recommendation -- Orihalcon makes excellent products.
did you follow any guide or something?

User avatar
Hypersphere

20 Jul 2020, 14:30

@vladafkv: Thanks for your question. No, I did not follow any particular guide for refurbishing my XT keyboard. I suppose I used a combination of intuition and tips gleaned from various posts in the Deskthority (DT) and Geekhack (GH) forums. For programming the Teensy with Soarer's converter, I did follow Soarer's posts and the Soarer's converter documentation along with guidance on the programming posted by Muirium.

kelvinhall05

09 Aug 2020, 19:57

Anyone know if this will work with a DEC LK201-like keyboard? Is the conversion for DEC protocol documented?

ZyBeR

23 Aug 2020, 18:25

Is there anyway to rename the controller from "Soarer's Keyboard converter (Soarer)"? It would be nice to have the actually keyboard manufacturer and model name instead.

Can I control the Num Lock or Scroll Lock leds and use them as layer indicators?

JBert

23 Aug 2020, 19:48

No to both questions.

ZyBeR

24 Aug 2020, 09:14

JBert wrote:
23 Aug 2020, 19:48
No to both questions.
Thats's too bad. How about different functions on hold/tap?
So for example if I tap Caps Lock it acts normal, but if I hold it becomes Alt, can that be done?

User avatar
tentator

24 Aug 2020, 10:09

With qmk it can! And also it could do the previous two questions.. Just I never tried a qmk converter with an XT protocol before so you should try.. Are you using a pro micro right?

User avatar
Muirium
µ

31 Mar 2021, 10:25

64 bit Mac version of Soarer's Tools here, by the way. Catalina and later require it! Which finally forced me to make them. :D

EvanAddington

14 Apr 2022, 15:13

Hey!! I realize that I am posting in an outdated thread on I wanted to thank you for the solution provided above. They helped me with a similar problem.

User avatar
Muirium
µ

14 Apr 2022, 16:29

Good for you. ;)

Jan Pospisil

31 Jul 2022, 00:29

Apologies if this is not the right place to ask!
I'm using a BTC dome with slider DIN kb through a Soarer's converter I bought off eBay (from an Italian guy I think, it seems to be a pro micro).
It works just fine.
This keyboard however has a BAE focus style layout and I wanna switch the backslash with the quote key.
So I tried making a .sc file with a remapblock.
(they should be the right codes)
When I drag it onto the scaswr.bat file, all seems to go through fine, it all says "ok".
But the keys still output the same things as before. I tried to unplug and replug, still the same.
Am I doing something wrong?
(I thought perhaps the codes were wrong, but after checking them in QMK Toolbox, they're not. They're reporting as +34 - QUOTE and +31 - BACKSLASH.)

apastuszak

03 Aug 2022, 22:45

So I'm hitting my first snag with the Soarer's Converter in 2022. On my Mac mini, when I try to run any of the command line tools, I get the error "Bad CPU type in executable."

I have to assume this is because the binaries are 32-bit, and MacOS no longer support 32-bit apps. This is going to be an even bigger problem, as Apple transitions to it's new Apple Silicon processor.

The Soarer's Converter is effectively dead for Mac users, unless Soarer somehow comes back and releases the source code for his utilities so that can be re-compiled.

And before you ask, I don't have any Windows machines in the house. Everything is Mac and Linux.

Sadly, this sucks.

apastuszak

03 Aug 2022, 22:53

Ok, you can ignore my stupidity. I just found the thread with X86-64 binaries and ARM binaries.

User avatar
Muirium
µ

03 Aug 2022, 23:06

I was gonna say. ;)

Soarer’s tools were open source from the start. Rebuilding them was fiddly but doable, even for a rube like me. His Converter will live as long as the Teensy, at least.

apastuszak

04 Aug 2022, 03:41

The Deskthorithy wiki says:
Soarer's Converter is a closed-source converter firmware. Following the untimely disappearance of Soarer, the project is no longer developed.
wiki/Soarer%27s_Converter

That lead me to believe the source was not available.

apastuszak

04 Aug 2022, 03:50

Is there a way to use the Soarer's Converter to launch an app on Windows?

I was trying to use the F14 key on M122 to launch Windows Terminal. I thought I could use a Macro to do it, by emulating what I type on my keyboard to launch an app from my keyboard.

In my Macro Block I did the following:

Code: Select all

PRESS LGUI
DELAY 10
PRESS T
PRESS E
PRESS R
PRESS M
PRESS I
PRESS N
PRESS A
PRESS L
DELAY 10
PRESS ENTER
When I press F14, the start menu pops up, but nothing gets typed. If I press F14 a few more times, it will eventually popup the start menu and type in terminal, but it never hits the Enter key. If I change it to not press LGUI, and press it manually, then the macro successfully launches Windows Terminal.

Is there a better way to launch an app?

I know I can create a batch file and give it a keyboard shortcut, so that might be a better option than trying to get the coverter to do it.

User avatar
Muirium
µ

04 Aug 2022, 09:16

Windows may have a guard on the GUI key to ignore accidental key presses. (The Mac has a similar safety on Caps Lock.) As you’ve seen: the PRESS command jabs keys real quick. I’d suggest breaking the PRESS LGUI down into a separate MAKE LGUI and BREAK LGUI, with a suitable delay in the middle. That way Windows might get the message you really mean it.

apastuszak

04 Aug 2022, 15:52

That worked!

I added a DELAY 10 between PRESS and BREAK and then added a DELAY 100 after BREAK, and another DELAY 100 before ENTER.

Now to make a whole layer that launches apps.

apastuszak

04 Aug 2022, 17:18

I'm having a really odd problem with my Soarer's Converter today.

It's working just fine when I plug it into my Mac. When I plug it into my Windows 10 work computer, it gives me all sorts of issues. It fails to type sometimes. Other times, I will type a letter and will just continuously repeat. I hit backspace and it won't backspace. I hit it again, and backspace runs till I deletes my entire line.

I don't have another Windows computer in the house to test it with, so it's tough to tell if it's something to do with the the Windows 10 image on my work PC, or if it's a problem with the converter and Windows 10 in general.

Has anyone seen this with Windows 10?

Post Reply

Return to “Workshop”