commit 754b8ccb3a364e8e3d8577ce9d7b1e2996fd92ba
Author: Leander Hutton
+
+
+Mainly HID page 7, with additions to support internal features, media keys, and power keys.
+The following code names are deprecated, and should no longer be used.
+For most uses, either a single key or a combination can be specified. This diagram gives an simplified view of the processing stages inside the converter: The first stage is a fixed translation into HID codes, that cannot be modified by the config. The goal of this stage is
+ to map into a reasonable base set of codes for further remapping, and to try and ensure that each key on the keyboard
+ results in a unique HID code after this stage. The second stage combines remapping and layer functions, since layers are simply alternate remappings. The third stage is macro expansion. The final stage separates out the internal commands such as SELECTn and BOOT etc. and routes them appropriately, and
+ also converts the HIDX codes back into standard HID codes for the keyboard, media, and power code pages. The Example: The Quotation marks are optional unless the file name contains spaces. Example:
+Groups of settings can be toggled by using the
+When any of the SELECT codes are output the entire config is reloaded, and the Blocks following Blocks following Example: Blocks following the Example: Blocks following the The keyboard ID is given in hexadecimal. See the Troubleshooting section for details of how to find out the ID of your keyboard. Example: Layerblocks define combinations of function keys to access different layers. Function keys are defined by remapping keys to codes FN1 to FN8. Example: Remapblocks define remappings either for the base layer, or for the specified
+layer if a Example: Macroblocks define one or more macros. Macros are triggered by a single HID
+key with any combination of metas, and can have command blocks that execute
+on make and/or break of the HID key. Example:
+Macros are triggered only when the state matches for all of the the specified metas.
+When looking for a match, macros are checked in the order they appear in the config file. The correct order would be: See the HID code list for HID and META values. Comments begin with a '#' and continue to the end of the line. The force command disables the auto-detection of keyboard type. The include command processes another file, exactly as if it was copy-pasted to where the include command is. Conditionals stay in effect until the conditional is repeated with different argument(s). Layerblocks define combinations of function keys to access different layers. Remapblocks define remappings either for the base layer, or for the specified
+layer if a layer command is given inside the block. Macroblocks define one or more macros. Macros are triggered by a single HID
+key with any combination of metas, and can have command blocks that execute
+on either or both of make and break of the HID key. The firmware has been compiled for the following CPUs, listed roughly in order of preference:Deskthority Thread Contents
+
+
+
+
+Reply Date By Post
+0 22 Apr 2012 Soarer: This is my Teensy-based project which adapts XT, AT and some 122 key terminal keyboar ...
+1 23 Apr 2012 Maarten: Oh nice work! Now all i need is a teensy
+2 23 Apr 2012 Kurrk: This is a good opportunity to say thank you! I'm using a XT model F with your convert ...
+3 23 Apr 2012 bhtooefr: Congrats on getting 1.0 out, and thank you. This adapter is powering my favorite keyb ...
+4 23 Apr 2012 Soarer: Thanks people, you're welcome! I hope there aren't too many bugs discovered, so I can ...
+5 23 Apr 2012 litster: Excellent converter! It is not just for IBM keyboards. It can make all your Filco key ...
+6 23 Apr 2012 RC-1140: Yup, have to agree, this converter firmware is by far the best. I'm using a teensy at ...
+7 23 Apr 2012 Soarer: I probably will - I'm a forum whore, I'll open my mouth wherever there are good posti ...
+8 23 Apr 2012 fruktstund: This is a fantastic converter. Used it for an old BTC (I think it was BTC at least) k ...
+9 23 Apr 2012 Soarer: It could just be a wiring error when you rebuilt it... is it rebuilt with the same co ...
+10 23 Apr 2012 fruktstund: Yeah, it seems the most likely that it's a wiring error, even though that would mean ...
+11 23 Apr 2012 Soarer: It's pretty unusual to actually kill anything (but it has been known). Although, it's ...
+12 24 Apr 2012 Grond: Is there any way to build such a converter without soldering?
+13 24 Apr 2012 bhtooefr: Yes, although it'll take having a Teensy with pins, and then having the right jumper ...
+14 24 Apr 2012 Grond: I'd like to make this converter for Model M terminal. Suppose I get a female RJ conne ...
+15 24 Apr 2012 bhtooefr: You'd probably need to solder the RJ connector. However, 122-key terminal Ms (if it's ...
+16 24 Apr 2012 Grond: Yes it does! So what? Can I get a wire that goes from the six pin connector to the Te ...
+17 24 Apr 2012 bhtooefr: You would need female jumper wires to go from the pins on the controller to the pins ...
+18 24 Apr 2012 Grond: Like these?
+19 24 Apr 2012 bhtooefr: That would work, yes.
+20 24 Apr 2012 Grond: Thanks!
+21 26 Apr 2012 fruktstund: I've checked the wiring now and I'm confident it's correctly done! I also tried it ou ...
+22 27 Apr 2012 Soarer: Hmm, I get about 0.6MΩ measured on the Teensy, with no keyboard or USB attached. I'm ...
+23 28 Apr 2012 fruktstund: I seem to get approximately the same measurements as you Soarer, so this is beginning ...
+24 28 Apr 2012 Soarer: Well, it doesn't mean the Teensy isn't damaged, but it seems to be basically OK. What ...
+25 05 May 2012 Soarer: fruktstund - did you spot anything?
+26 08 May 2012 nfc: Finally had the opportunity to test it... a masterpiece. Info research, write phase, ...
+27 09 May 2012 dirge: What are the chances of the wyse boards working? Before I start messing on with mine.
+28 09 May 2012 Soarer: Thanks! I'm happy enough if it's 'useful' Pretty slim, I'm afraid. I don't know muc ...
+29 09 May 2012 dirge: You're much better at this type of thing so would you offer some advice on how I coul ...
+30 09 May 2012 off: As the uninitiated, soarer's converter sounds like a protocol converter, so you'd hav ...
+31 09 May 2012 Soarer: I'm going to assume for now that its signalling is something like the two shown on kb ...
+32 09 May 2012 dirge: Thanks mate, that helps a lot. Working on the key matrix, following sixty's instructi ...
+33 14 May 2012 fruktstund: hid_listen only prints out a lot of "R05", with an occasional "R04" every now and the ...
+34 14 May 2012 Soarer: Sorry, I meant when it's first connected... have hid_listen running before you plug i ...
+35 14 May 2012 hoggy: Just built one of these. Soarer, you are a genius. I'll take some pics when I've got ...
+36 15 May 2012 hoggy: It's a lousy photo...
+37 15 May 2012 fruktstund: Ah, I see. I'll check as soon as I can!
+38 15 May 2012 Soarer: Nice project box!
+39 15 May 2012 off: Indeed! Not the smallest, but looks to be the most functionally complete
+40 16 May 2012 hoggy: What I wanted to make was a small lego box, with 3 leds and one of these stickers (to ...
+41 16 May 2012 hoggy: The converter works better with my siig minitouch than a blue cube.
+42 17 May 2012 Soarer: That's a fine idea to use one of those stickers! I don't think I ever looked into why ...
+43 31 May 2012 Soarer: New version uploaded which fixes a bug that stopped jump to bootloader functions work ...
+44 10 Jun 2012 Soarer: Another new version posted, v1.02 - the converter wasn't handling the commands tellin ...
+45 06 Jul 2012 Findecanor: Does the current code base have support for driving LEDs for Caps Lock, Scroll Lock a ...
+46 06 Jul 2012 Soarer: It does
+47 07 Jul 2012 JBert: I have made CapsLock an FN1 key, but now I was wondering if I could make some key on ...
+48 07 Jul 2012 Soarer: Not without remapping one of the shifts in the Fn layer to something which would just ...
+49 07 Jul 2012 JBert: Ah, that's a handy chart. I've been experimentally building some other macros to coun ...
+50 07 Jul 2012 Soarer: I use the double-shift myself, in the base layer, and find it feels quite logical. Bu ...
+51 16 Jul 2012 Paranoid: Has anyone ever tested if you can hook up an old laptop keyboard to your computer wit ...
+52 16 Jul 2012 Findecanor: If a keyboard has a ribbon cable, then you can bet that the controller is not part of ...
+53 16 Jul 2012 JBert: I happen to have another (weird) question: will there ever be support for a few extra ...
+54 21 Jul 2012 JBert: No answer? I actually noticed another thing: it seems that the DELETE remap code crea ...
+55 21 Jul 2012 Soarer: Sorry! I saw your post before, but then forgot about it I don't think I'll add anyth ...
+56 21 Jul 2012 Soarer: Ahem Ignore that Autohotkey was blocking my deletes
+57 22 Jul 2012 JBert: Woah, today it somehow works?!? I also noticed that the output above is not for TAB b ...
+58 22 Jul 2012 Soarer: Don't worry, I didn't spend too long on it. I added some debug printing to the macro ...
+59 22 Jul 2012 Paranoid: Hey Soarer! I recently acquired a liberty keyboard and it has this connecter: The wei ...
+60 22 Jul 2012 Soarer: WTF is that thing!!! At a guess, there is... CGND - case/shielding ground S.P. - dunn ...
+61 24 Jul 2012 Paranoid: Hehe okidoki thanks for figuring it out! I wonder if there is any way that could ma ...
+62 24 Jul 2012 Soarer: If you have a serial port, you could try wiring it to that (and a power supply for th ...
+63 01 Aug 2012 Trent: Question: I have an IBM board with the RJ-45 converter. To hook this up to the conver ...
+64 01 Aug 2012 AltRN8: Hoping folks can help. What is the expected behavior of using a SC with a Model F and ...
+65 01 Aug 2012 Soarer: Nope... just something like this: Unfortunately they don't fit in a breadboard though ...
+66 01 Aug 2012 Soarer: Yup, without legacy.sc compiled and loaded, * is just *. The two commands you need ar ...
+67 02 Aug 2012 spolia_optima: Is anyone here willing to build one of these for profit? Or is building one myself no ...
+68 02 Aug 2012 Trent: Soarer thanks for the advice. I took a look at the link you suggested and bought the ...
+69 02 Aug 2012 JBert: Here's a step by step guide: You should now have a working converter. See Soarer's po ...
+70 02 Aug 2012 AltRN8: Thanks Soarer! I actually figured it out right after I posted. I feel a little dense ...
+71 02 Aug 2012 Soarer: Sure does! It handles all of the codes produced by the 'extra' positions available on ...
+72 03 Aug 2012 Trent: Awesome thanks very much. I ordered all of the parts for my converter! The only parts ...
+73 03 Aug 2012 JBert: I think you misunderstood that forum post. This also means that you will only supply ...
+74 03 Aug 2012 Trent: Ah I was wondering whether or not the keyboard would still be able to be powered with ...
+75 03 Aug 2012 Soarer: Actually, I think the forum post is mistaken; a Teensy running at 5V should work fine ...
+76 03 Aug 2012 Trent: Yeah it was that post. Ah a serial connection that makes sense. And does this convert ...
+77 04 Aug 2012 Soarer: Hey, that's a trick question! No fair! It's both, and neither! Typically the PS/2 por ...
+78 06 Aug 2012 Trent: Ah clever. Well cool I look forward to making the converter! I am still waiting on pa ...
+79 06 Aug 2012 RC-1140: hm, reading this stuff makes me overthink the project I had planned (maybe you rememb ...
+80 07 Aug 2012 Soarer: I think I said before that it sounded 'challenging'. Now it's sounding challenging ...
+81 09 Aug 2012 Trent: Ok so what am I doing wrong: * Programmed the teensy with 1.02 * using a terminal sty ...
+82 09 Aug 2012 Icarium: I've tried a RJ-45 jack once for a 122key Model M and there was something else in the ...
+83 09 Aug 2012 JBert: That's a known bug: Simply unplug the Teensy from USB and it should work again.
+84 09 Aug 2012 Trent: Icarium I will try what you suggested. Jbert I noticed that does indeed help. I can't ...
+85 09 Aug 2012 Soarer: I haven't had that problem with scinfo, only with scrd. After running scboot you woul ...
+86 09 Aug 2012 Trent: So the order would be: 1. Flash teensy 2. scas example.sc example.scb 2. scwr example ...
+87 09 Aug 2012 Soarer: Ouch, that's as I feared... backwards The silver line is the shielding, which is PE. ...
+88 09 Aug 2012 Trent: Edit: after re-do of backward ass colors, I load up the teensy, reflash with Soarer_a ...
+89 09 Aug 2012 Soarer: Strange choice of colours, for sure. Hardly matters though. That they used pinouts th ...
+90 10 Aug 2012 Trent: Do you know what the colors would be for the silver tag XT/AT style adapters? I have ...
+91 10 Aug 2012 Soarer: I think they vary... at least, the PC/XT colours are different to the 122-key's. Let ...
+92 10 Aug 2012 JBert: Noooooo! 1. Press button on Teensy 2. Flash Teensy 3. scas ... 4. scwr 5. Unplug / pl ...
+93 11 Aug 2012 Trent: Hmm, seems that this board is indeed dead after following your instructions jBert. I' ...
+94 31 Aug 2012 AKIMbO: I need some serious help with programming this teensy. If someone could give me the e ...
+95 31 Aug 2012 Soarer: Nothing but a couple of misunderstandings here First, you don't want to be in progra ...
+96 31 Aug 2012 AKIMbO: It worked! Thank you so much Soarer! Is there an easy way to completely go back to de ...
+97 31 Aug 2012 Soarer: Sure, just compile an empty text file! Or, in a Windows command prompt, you can simpl ...
+98 07 Sep 2012 Soarer: I see some people have noticed the v1.03 release... it's far from an essential update ...
+99 23 Sep 2012 fruktstund: Soarer, I'm back with a new exciting question: is it possible to use other pins on th ...
+100 23 Sep 2012 Soarer: Hmm, well I don't really want to start producing and testing a modified version, but ...
+101 23 Sep 2012 fruktstund: Tried your shorting test, and both output the error codes as expected (except that on ...
+102 23 Sep 2012 dirge: Got mine working but trying to make a USB cable out the original cable. Looking towar ...
+103 23 Sep 2012 Soarer: So they are both XTs, but they have LEDs? Sorry, for some reason I thought you were t ...
+104 23 Sep 2012 Soarer: On your head be it! Have a camera handy for when the magic smoke gets out
+105 23 Sep 2012 dirge: well typing on it now so no great damage But would love to know the correct usb pinn ...
+106 23 Sep 2012 Soarer: My files are symbol agnostic, as are scan codes and HID codes Any discrepancy betwe ...
+107 25 Sep 2012 Grond: Anyone tested this with Teensy 3.0?
+108 25 Sep 2012 JBert: It's a totally different processor and thus the .hex file will not work.
+109 25 Sep 2012 dirge: Well that would explain it, who's idea was it to have the end inverted on the mini so ...
+110 25 Sep 2012 dirge: right I`ve used the included tools and compiled the dvorak bin. I like the fact £ is ...
+111 25 Sep 2012 Soarer: Damn UK vs US layout problem! 'Backslash' is a # on a UK layout... think of the diffe ...
+112 25 Sep 2012 dirge: Changing to US would be bad, I`m logged into UK servers most the time. "`¬" is an op ...
+113 25 Sep 2012 Soarer: That's because GRAVE and HASH aren't keys All the key names are US-centric, so we j ...
+114 25 Sep 2012 dirge: Your awesome! I'm going to post some pics now!
+115 02 Oct 2012 Mikester: hi guys, i just modified my IBM 3487 terminal keyboard with a teensy-board with soare ...
+116 03 Oct 2012 Soarer: Very nice! That USB extension fits tidily between the existing posts, I see! Strictly ...
+117 03 Oct 2012 Soarer: Anyone that thinks they might've applied power in reverse - see here for a test and f ...
+118 04 Oct 2012 sealclubber: Hey Soarer. Just wanted to thank you for your awesome work. I finally got my baby to ...
+119 04 Oct 2012 Soarer: Ha! You don't! There's an initial translation from each scan code set into HID codes, ...
+120 04 Oct 2012 sealclubber: I am honestly surprised that this is so easy! Thank you for all of your help
+121 04 Oct 2012 Soarer: Cool! I made a little mistake in the last three macros - well, not really a mistake, ...
+122 05 Oct 2012 Soarer: Heh, another minor mistake... the code prefixed by 'd' is remapping. The one you wa ...
+123 05 Oct 2012 sealclubber: Gotcha. Just popped in again to tell you everything is working all nice and smooth. T ...
+124 05 Oct 2012 Soarer: Aha, well, that's even better! ... I finally finished my set of adapters... ... by fi ...
+125 26 Oct 2012 wcass: feature request: i know that all of the guys that like trackpoints would like to see ...
+126 26 Oct 2012 Soarer: Hmm. I might add mousekeys functions at some point (similar to hasu's code), but I'm ...
+127 26 Oct 2012 wcass: a trackpoint mod would have bare leads rather than a proper PS2 plug. yes, i could cr ...
+128 26 Oct 2012 Soarer: Are you sure? I'd only spotted the Mouse Keys ("You can emulates mouse move and butto ...
+129 26 Oct 2012 wcass: - Features section, 5th bullet item. if you have a copy of his code, look for ps2_mo ...
+130 27 Oct 2012 Soarer: Ah, so it does
+131 27 Oct 2012 hasu: I'm a fan of trackpoint, sure But it is very difficult to integrate it into my favo ...
+132 27 Oct 2012 Icarium: Actually there is another good reason for putting PS/2 through the Teensy but I haven ...
+133 27 Oct 2012 Soarer: I might pencil it in for v2.0 It sounds like quite a lot of work to do it nicely - d ...
+134 29 Oct 2012 suka: I have used exactly such a setup in my custom board for the last couple of months, an ...
+135 29 Oct 2012 Soarer: Heh, I'm not saying it would be , just that it would take And I don't even have a ...
+136 29 Oct 2012 fossala: I've got a teensy coming for a 122 key terminal M. What would be the best way to conn ...
+137 29 Oct 2012 wcass: I installed a teensy inside the case of my keyboard. i'll post pictures of how i did ...
+138 30 Oct 2012 wcass: This is what i did and it has worked very well for me. You will need a 6' USB A-to-mi ...
+139 30 Oct 2012 fossala: Looks good, lots of good info. I'll take mine apart and look at it later. I can see f ...
+140 30 Oct 2012 Soarer: That's excellent, wcass! I'll just add my usual caveat about not trusting the wire co ...
+141 08 Nov 2012 fossala: OK, the teensy turned up yesterday. I've stripped the wires ready for doing the solde ...
+142 08 Nov 2012 JBert: It should work fine without a config loaded. Only when you got some ancient keyboard ...
+143 08 Nov 2012 Soarer: Indeed; config files are just tweaks to the default mappings (one for each scan code ...
+144 10 Nov 2012 Vierax: Hello, just a noob in C (in Python too but work in progress for bothâ¦) so I might m ...
+145 10 Nov 2012 fossala: All up and running, typing this with it now. Thanks for your hard work. Sure there wi ...
+146 10 Nov 2012 Soarer: It still sends keycodes, so yes, the sensible layouts to do in hardware are those whi ...
+147 11 Nov 2012 Vierax: Oh yeah macros, that's clever ! You just need a referential layout who can handle the ...
+148 11 Nov 2012 Soarer: Hmm, true, and being OS specific would make it a bit pointless really, unless you wer ...
+149 12 Nov 2012 Vierax: Yes the simplest way seems to have hard dvorak and colemak and combining the hard qwe ...
+150 21 Nov 2012 JBert: Except it doesn't work with UAC or the login screen... It's fun to type in Colemak in ...
+151 24 Nov 2012 Hubbert: I have the exact same question: did you come up with a fix, JBert? Otherwise, I guess ...
+152 24 Nov 2012 JBert: No, I just left the project for what it was after Soarer said he didn't want to add s ...
+153 24 Nov 2012 Hubbert: OK...sounds like maybe that's the way to go. I made a new thread about how to interfa ...
+154 27 Nov 2012 fossala: How can I get the lefthand keys working on a 122 model m with this firmware?
+155 27 Nov 2012 Icarium: Which one? With Soarer's it should work out of the box. Wait, what do you mean by lef ...
+156 27 Nov 2012 7bit: The function keys to the left of the keyboard.
+157 27 Nov 2012 fossala: IBM model m terminal. By left hand keys I mean the 10 key caps to the far left.
+158 27 Nov 2012 Icarium: Ah, well those you actually have to add to the config afair. I can send you mine as a ...
+159 27 Nov 2012 fossala: I will have to read up how to make configs, thanks.
+160 27 Nov 2012 Icarium: Soarer's docs are insanely good. I would like to reward him with a virtual cookie or ...
+161 28 Nov 2012 bhtooefr: I need to find how I mapped mine, but it involved mapping volume, the PrtSc/ScrLk/Pau ...
+162 07 Dec 2012 Soarer: PLEASE VOTE for my converter in the Deskthority Awards 2012: Best input device mod 20 ...
+163 10 Dec 2012 sealclubber: Hello again Soarer! Just nabbed myself a Model F off ebay (for cheap... great conditi ...
+164 10 Dec 2012 Soarer: I can't remember it 100%. Which Model F? I think in most cases the controller grounds ...
+165 10 Dec 2012 bhtooefr: You might get the ground path of: Base pan -> keyboard frame -> controller -> Teensy ...
+166 11 Dec 2012 sealclubber: Nevermind its all good. Typing on it at the moment actually. Some of the keys needed ...
+167 13 Dec 2012 Soarer: Is there still desire for the extra few keys? I've got v1.1 almost ready, and could p ...
+168 13 Dec 2012 JBert: I think I'm personally not going to use it anymore now that there are alternative Pok ...
+169 18 Dec 2012 Hubbert: That would still be great for me! And I like the no-matrix idea, both for simplicity ...
+170 18 Dec 2012 Soarer: For now I've coded it to read 5 inputs at 1kHz with a simple 10ms batch debounce. Tha ...
+
+
diff --git a/docs/GH.html b/docs/GH.html
new file mode 100644
index 0000000..c84f661
--- /dev/null
+++ b/docs/GH.html
@@ -0,0 +1,651 @@
+
+
+
+GeekHack Thread Contents
+
+
+
+
+Reply Date By Post
+0 22 Apr 2011 Soarer: This is my Teensy-based project which adapts XT, AT and some 122 key terminal keyboar ...
+1 22 Apr 2011 Mr. Perfect: Impressive work there. It's tempting to make one of these even for boards that work o ...
+2 22 Apr 2011 Soarer: Some boards don't have LEDs (e.g. XTs and Terminals), and in the case of the XT the p ...
+3 22 Apr 2011 HaveANiceDay: This looks really interesting. Especially the Filco NKRO USB Mod possibilities. I don ...
+4 23 Apr 2011 hasu: Nice work! I tried your converter with PS/2 keyboard on Mac and confirmed NKRO works ...
+5 23 Apr 2011 Soarer: Thanks, hasu! I might need to add in your fix for the SET_IDLE problem on OS-X. I hav ...
+6 23 Apr 2011 Soarer: Which one? My firmware was already working better than theirs many weeks ago.
+7 23 Apr 2011 ch_123: I'd be willing to check this out whenever I get my Teensy and sufficient free time.
+8 23 Apr 2011 Soarer: That would be great, thanks! I think the most likely problem (if any) is an occasio ...
+9 24 Apr 2011 Hak Foo: Just built, waiting for my terminal F to come tomorrow. adding the LEDs lets you test ...
+10 24 Apr 2011 Soarer: Ah, Hak Foo... just spotted your question on IRC about the devices that the converter ...
+11 24 Apr 2011 xwhatsit: What are you using for a VID/PID?
+12 24 Apr 2011 Soarer: I'll check later, but I haven't changed it from the defaults in the PJRC sample code. ...
+13 24 Apr 2011 xwhatsit: Ah right. I'm going to use the standard V-USB HID keyboard VID/PID for my wee project ...
+14 24 Apr 2011 intealls: Nice work! Just wondering what kind of remapping/macro features your firmware support ...
+15 25 Apr 2011 Soarer: For personal projects, I guess it doesn't really matter what we use! (I admit I hav ...
+16 25 Apr 2011 Soarer: Remappings are done from HID code to HID code, using a table in RAM, after the native ...
+17 25 Apr 2011 Hak Foo: Stupid question: what's the default mapping for a 122 look like? I'm thinking I'm go ...
+18 25 Apr 2011 Soarer: Roughly speaking, it's done as a regular 102 with extra keys. The block of 10 keys on ...
+19 25 Apr 2011 intealls: I've got a Teensy++ 2.0 with your firmware hooked up to my MBP Santa Rosa, and I've y ...
+20 25 Apr 2011 Soarer: Excellent news! Thanks for letting me know, that was the last part that was completel ...
+21 25 Apr 2011 intealls: Sorry 'bout that. :/ Yup, seems fine when no keys are pressed! Gonna test a couple mo ...
+22 25 Apr 2011 Soarer: Thinking about it, I can't quite figure out what's going wrong - I guess it must some ...
+23 25 Apr 2011 intealls: It does not wake up :( That was what I was testing. I just tried the same thing on Li ...
+24 25 Apr 2011 Soarer: I think handling wake-up will have to wait until I support suspend mode correctly - i ...
+25 25 Apr 2011 intealls: It still seems to repeat. :/ Would be great if someone else could try to reproduce it ...
+26 25 Apr 2011 kishy: I am unable to reproduce, or witness any issues at all after waking from standby (jus ...
+27 25 Apr 2011 intealls: I think it's a problem related to OS X, Linux (Ubuntu 10.04 I think) on the same mach ...
+28 25 Apr 2011 kishy: Win7...so yeah...might be OS-related (in fact, there's a good chance it is...standby ...
+29 26 Apr 2011 Soarer: Thanks for trying it. :-) I'm still hoping that there is a change I can make that ...
+30 27 Apr 2011 Oqsy: High five! 122 key terminal Model F up and running!!! Everything is good so far :) I ...
+31 01 May 2011 Soarer: v0.992 is now available, which works around an annoying issue with Linux. The problem ...
+32 01 May 2011 Neit: Hi Soarer, I would like to wire your converter with both DIN and PS/2 connectors. Sin ...
+33 01 May 2011 Soarer: Nice diagram! Yes, that should be fine. (In fact, I don't think plugging both in at t ...
+34 02 May 2011 Oqsy: Glad this was brought up, as short-term I will be doing the same with a terminal F, a ...
+35 02 May 2011 Neit: Thanks :) I wanted to make it clear and "readable" for my first electronic build. Goo ...
+36 02 May 2011 Soarer: That is fine. (It's probably about the same thickness as the wires in the cable to th ...
+37 02 May 2011 Neit: Okay good. I'll get some resistors just in case. Yes, I was planning on a (lego) box. ...
+38 02 May 2011 nowsharing: Wow, awesome work everyone. You've achieved the "impossible." Could I buy one of the ...
+39 03 May 2011 bhtooefr: Man, this code works great. Now I just need the remappable version. :)
+40 03 May 2011 slueth: Just buy a teensy and request a sample from tyco electronics for the DIN connectors ...
+41 03 May 2011 Hak Foo: if you don't feel like harassing tyco, the socket costs <4 USD from the big online pa ...
+42 03 May 2011 8_INCH_FLOPPY: I want to do this, but why is the teensy so damn expensive?
+43 03 May 2011 slueth: Its because not only can you use it for a keyboard convertor, you can use it for a sl ...
+44 04 May 2011 Neit: Hey, I Updated the diagram before soldering. I finally chose to add the resistors for ...
+45 04 May 2011 Soarer: Yep, even better! I like that the socket views are labelled as front and back - it re ...
+46 04 May 2011 Soarer: Is it though? Even used just as a keyboard converter, I don't think it's unreasonab ...
+47 04 May 2011 Findecanor: There are lots of unused pins, though. I wonder if they could be used for something u ...
+48 04 May 2011 Mr. Perfect: Very nice diagrams there Neit. Any idea where the lock LEDs would fit into those?
+49 04 May 2011 Soarer: DIP switches!!
+50 04 May 2011 Soarer: Has anyone wired them up yet? I'm tempted to move them to different pins on the Teens ...
+51 05 May 2011 Hak Foo: I have. If one thing is annoying about the laout, it is the lights. Too close togeth ...
+52 05 May 2011 Neit: I'll add them on the diagram as soon as Soarer has chosen the final pins to use (curr ...
+53 05 May 2011 Soarer: Still a bit risky but should be ok (as ok as hot-swapping any PS/2, I guess). The con ...
+54 06 May 2011 Mr. Perfect: Yes, that's exactly what I was asking about. Probably best to wait and see if they ...
+55 06 May 2011 8_INCH_FLOPPY: I'm just a cheapass who doesn't understand who people are willing to use an arduino ...
+56 06 May 2011 hasu: 8_INCH_FLOPPY, You can do with V-USB at cheap. You just need a crystal, 2 zeners, som ...
+57 06 May 2011 Soarer: Ah, well, I can explain that quite simply: it's easier! I chose Atmel AVR mainly beca ...
+58 06 May 2011 8_INCH_FLOPPY: Thanks for the detailed explanation. I didn't mean to suggest that you are lazy. Aft ...
+59 06 May 2011 Soarer: I didn't really think you had, the last paragraph was very much tongue in cheek :-) ...
+60 06 May 2011 8_INCH_FLOPPY: I caved and ordered a couple. Maybe I can recoup the cost of one by selling the other ...
+61 07 May 2011 Oqsy: Repeat that enough times in the right places and they will. However, this is still DI ...
+62 07 May 2011 8_INCH_FLOPPY: Not if I build a bunch and sell them. Muahahahaha.
+63 08 May 2011 Hak Foo: To me, the logical endgame of this project is to eventually develop a small-run PCB w ...
+64 08 May 2011 bhtooefr: Of course, in my case, I just mounted the Teensy internally. That way, it looks like ...
+65 09 May 2011 Mr. Perfect: Ok, here's a question that probably hasn't come up before: can USB keyboards be hooke ...
+66 09 May 2011 Soarer: Yes, it should work fine! (I'm sure someone did ask that before, but maybe not in t ...
+67 09 May 2011 Mr. Perfect: That's great news. So to wire a female USB socket to the controller you just match up ...
+68 09 May 2011 Soarer: I don't know how the passive USB to PS/2 adapters are wired up though - either probe ...
+69 12 May 2011 Soarer: New version (v0.994) posted which adds suspend and wake-up support! Many thanks to ...
+70 12 May 2011 slueth: Soarer, you are amazing! :)
+71 13 May 2011 intealls: Heh, no problem, just glad I was able to help :) You're the one doing the awesome wor ...
+72 13 May 2011 Soarer: Well this phase is really a shakedown, making sure that reliability is top notch befo ...
+73 13 May 2011 Voixdelion: Okay, I just kind of skimmed the discussion because it was all rather technical for m ...
+74 13 May 2011 bhtooefr: Soarer is developing the firmware, you buy a Teensy or Teensy++, you can get one with ...
+75 13 May 2011 Soarer: Basic shopping list: Optional items, as desired: To assemble it just needs a few wire ...
+76 13 May 2011 bhtooefr: And, my build didn't even use the socket, due to how I installed mine.
+77 13 May 2011 intealls: Here's my highly ghettoish solution (I HATE that movie btw) [ Attachment Invalid Or ...
+78 13 May 2011 ch_123: Things often get more difficult to comprehend as you grow older.
+79 14 May 2011 slueth: Not that hard as long as you can understand the pinouts. Make sure you are looking a ...
+80 14 May 2011 8_INCH_FLOPPY: Is that the same as the XT pinout? I wired it up to my XT keyboard like that and it ...
+81 14 May 2011 slueth: I used this with the information from the article: Conn. Teensy GND -------- GN ...
+82 14 May 2011 Oqsy: Voix: I have this connected to a 122 Terminal F from the acfrazier group buy. Really ...
+83 14 May 2011 Soarer: The most common mistake so far is wiring the socket backwards - it's important to not ...
+84 14 May 2011 kishy: [ Attachment Invalid Or Does Not Exist ] 18121[/ATTACH] Please feel free to pop this ...
+85 14 May 2011 Voixdelion: kewl. will definitely try this...soon
+86 15 May 2011 Neit: Finally done mine, 0.994 working perfectly with my cherry 81-3000 (yes MY switches ar ...
+87 15 May 2011 slueth: It shouldn't light up, if it lights up there was a problem. Should handle nkro. Corr ...
+88 15 May 2011 bhtooefr: If the keyboard itself doesn't handle NKRO, though, there's a problem, and it'll ligh ...
+89 16 May 2011 Soarer: I don't think the lack of NKRO is a factor here - the keyboard is still capable of tr ...
+90 22 May 2011 8_INCH_FLOPPY: I got mine to work for a moment with a PS/2 keyboard, but after I unplugged it and tr ...
+91 22 May 2011 Soarer: Yup, that's the right order when looking into the socket. AT and XT are the same. Pul ...
+92 22 May 2011 8_INCH_FLOPPY: Ok, here's the message with one keypress on an AT keyboard: R06 R06 R06 It doesn't gi ...
+93 22 May 2011 Soarer: Not accusing you of sloppy soldering! But something seems to have broken after the fi ...
+94 22 May 2011 8_INCH_FLOPPY: There's continuity between The socket and the board, according to ye olde VTVM. Also, ...
+95 22 May 2011 8_INCH_FLOPPY: Ok, I've switched back to an AT board, and now it's not working again. Here's the mes ...
+96 22 May 2011 8_INCH_FLOPPY: It seems that, out of the 3 AT keyboard that I've tested, the only one that does not ...
+97 22 May 2011 8_INCH_FLOPPY: After much testing, here's what basically happens: Normal AT keyboard: Works fine, do ...
+98 22 May 2011 Soarer: Hmm... I used an IBM XT 'board for developing, and then had to tweak my code to get i ...
+99 22 May 2011 8_INCH_FLOPPY: I tested my other XT keyboard, and it responded the same as the first one. I have to ...
+100 23 May 2011 Soarer: Cherry 'board didn't do anything that might shed light on what the 'S' setting on you ...
+101 24 May 2011 8_INCH_FLOPPY: I'm not sure what make they are. Unfortunately, the last owner peeled the stickers of ...
+102 24 May 2011 Soarer: Oh wow, that would really help! Normally the signals very easy to capture on a 'scope ...
+103 13 Jun 2011 Hak Foo: Is there any chance we can get the source if we want to compile our own custom mappin ...
+104 14 Jun 2011 8_INCH_FLOPPY: These were all captured with me pressing the "accent grave/tilde" key. The "S" settin ...
+105 18 Jun 2011 REVENGE: Soarer, this is an excellent project! My implementation works nicely with a Model F 1 ...
+106 18 Jun 2011 Soarer: It could well well Autumn before I have a chance to implement the fancy bits; loo ...
+107 18 Jun 2011 Soarer: That Monterey is an odd beast! For starters, it's going more than twice as fast as a ...
+108 18 Jun 2011 didjamatic: Nice work, I'm doing this! Is there a downside to the ++ or is it just larger than n ...
+109 18 Jun 2011 Soarer: No downside apart from cost really! It just has more of everything (which the convert ...
+110 25 Jun 2011 REVENGE: Soarer, one of the keys on my 122 key terminal Model F does not send any key codes th ...
+111 25 Jun 2011 Soarer: My bad! Looks like I did half a change - I took it out of the global remaps, but fo ...
+112 25 Jun 2011 REVENGE: Thanks! :) Aside from that key not sending a code, the board is currently missing def ...
+113 26 Jun 2011 kps: This is what I did for my 122-key F; it might help someone else. No guarantees, and ...
+114 28 Jun 2011 Oqsy: Nice. I need to do an ANSI mod and add my RGB modifiers too. Excellent work and thx f ...
+115 02 Jul 2011 Soarer: New version (0.995) posted that maps the top-right key of the numpad to 'Pause'. Not ...
+116 03 Jul 2011 mr_a500: I'm thinking of trying this thing with an IBM 5155 keyboard. It should be the same as ...
+117 04 Jul 2011 REVENGE: Yep, I had my BlackWidow and the Model F both connected. First off, the Teensy stays ...
+118 05 Jul 2011 Soarer: It has to stay powered for a keypress to be able to trigger the wake-up ;) I know it ...
+119 05 Jul 2011 REVENGE: Still waiting for Explorer to scan the pr0n cache and total up the file sizes, I'll g ...
+120 05 Jul 2011 Soarer: It's just the size that counts! I'll check next time I reboot what I set in my BIOS, ...
+121 05 Jul 2011 REVENGE: Sounds good, mad props again for developing and maintaining this project. :P
+122 10 Jul 2011 mr_a500: So nobody has ever tried this with an IBM 5155? (that means I'll be the first... in h ...
+123 10 Jul 2011 kps: Open it. Power and ground should be straightforward to identify. Data & clock might ...
+124 10 Jul 2011 mr_a500: You mean open the keyboard? That could be tricky. There are no screws. It looks like ...
+125 10 Jul 2011 Soarer: If you have a multimeter, you might be able to work it out without taking it apart. M ...
+126 11 Jul 2011 Hak Foo: Revenge: I think I've had a similar symptom. Only happened since 0.99.5, but it see ...
+127 20 Jul 2011 LETE: These files aren't much use without the source code, right? Or did you just inject th ...
+128 20 Jul 2011 alaricljs: You write the teensy firmware with this hex file. It's a complete firmware.
+129 20 Jul 2011 Soarer: [strike]I didn't work out what they were for either.... presumably OS side somewhere. ...
+130 20 Jul 2011 LETE: I'm talking about the files kps posted in the attached zip file "remap.zip" on page 1 ...
+131 20 Jul 2011 alaricljs: Just looked at the contents, it's got a makefile and everything is automatic... it sp ...
+132 20 Jul 2011 LETE: Ah, well said. Thank you.
+133 20 Jul 2011 Soarer: Oh... so that's what it does... outrageous subterfuge!! I should warn anyone trying t ...
+134 20 Jul 2011 alaricljs: The people WANT YOUR STUFF... ;) they just want it their way.
+135 21 Jul 2011 REVENGE: Soarer, I understand you're not ready to release your source, but I would be satisfie ...
+136 21 Jul 2011 kps: Thanks! I thought so, from the table contents. It's enough to get my Terminal F layou ...
+137 22 Jul 2011 LETE: I'm going to stick a couple solid state relays in my box and set this thing up to con ...
+138 29 Jul 2011 LETE: Here are a few pictures of my teensy mounting solution for a model F terminal board. ...
+139 11 Aug 2011 SmallFry: Is it possible that I could get the source code? I wanted to recompile/edit a little/ ...
+140 11 Aug 2011 Soarer: Sorry, I'm not ready to give it out yet. It might be a while because I'm very busy wi ...
+141 11 Aug 2011 SmallFry: Alright, thanks anyways Soarer
+142 12 Aug 2011 wcass: Soarer, perhaps the GH community could help with building a front end? something that ...
+143 18 Aug 2011 Soarer: I'm sorry, I missed this! Thanks for the offer! I would like some help with the front ...
+144 28 Aug 2011 wcass: so a couple of questions. input file format should be ... what? default name? comment ...
+145 28 Aug 2011 Soarer: I'm imagining something along the lines of this: (Case insensitive and spaces ignored ...
+146 28 Aug 2011 wcass: would it conserve RAM to only include key mappings for the hardware and configuration ...
+147 28 Aug 2011 Soarer: Oh, I was just using Colemak as an example, it needn't be included all the time. And ...
+148 29 Aug 2011 wcass: yes, i was thinking to reload firmware when changing key maps and macros. speaking fo ...
+149 29 Aug 2011 Soarer: Heh, it's not that - I'd always planned on asking for someone to do the front end whe ...
+150 30 Aug 2011 Hak Foo: box an xampp install with the package. I've pondered doing that with an in-house web- ...
+151 07 Sep 2011 timofonic: About macros and remappings... What about showing it as a Mass Storage Device with th ...
+152 07 Sep 2011 Shawn Stanford: Well, I went ahead and ordered a Teensy 2.0, a breadboard and a set of LEDs. I've nev ...
+153 07 Sep 2011 Oqsy: Shawn, it's a great project to start with. Pretty straightforward, and great payoff ( ...
+154 07 Sep 2011 itlnstln: So, in other words, you're calling Shawn a dummy. Way to support our troops.
+155 07 Sep 2011 one_each: IF THE-KEY-PRESSED-HAS-A-KEYCAP-WITH-A-ON-IT THEN SEND-THE-CODE-FOR THE-LETTER-A. E ...
+156 07 Sep 2011 itlnstln: I'm lame. VB.NET for the win. I'm a DB guy, not a programmer.
+157 08 Sep 2011 Soarer: Seems a bit heavyweight for this! I think if JavaScript can't do it, a Python or Java ...
+158 08 Sep 2011 kps: No, no, no. During the day, whenever someone presses a key, you simply append the mat ...
+159 09 Sep 2011 timofonic: OK, sorry. I did think the structure would be able to be generated in-time. There wou ...
+160 09 Sep 2011 Soarer: Of the four layers I was thinking of, the driver is actually the easiest part. The de ...
+161 09 Sep 2011 timofonic: Like this board? They use a common Broadcom bluetooth controller.
+162 09 Sep 2011 Soarer: The battery comment wasn't a joke! Those things work great as controllers for contact ...
+163 09 Sep 2011 Oqsy: Lawn mower batt work? :P
+164 09 Sep 2011 Soarer: Bettah! You could fit one a terminal keyboard's case, no problem. Look a bit daft con ...
+165 10 Sep 2011 Soarer: I had changed the ACPI setting in my BIOS to S1. IIRC, in S3 the wakeup simply didn't ...
+166 10 Sep 2011 timofonic: Well, the oriiginal battery fromm. The bluetooth keyboard was 1xx mah and lastedd a w ...
+167 10 Sep 2011 Soarer: Unable to reproduce :-/ BIOS Power Settings at defaults (S3). Fresh Window 7 install. ...
+168 10 Sep 2011 Hak Foo: It seems to be alonbg the lines of suspend wake via converted board power down conver ...
+169 10 Sep 2011 Soarer: power down?
+170 11 Sep 2011 Hak Foo: start-> shut down?
+171 11 Sep 2011 Soarer: I dunno, you said it! :-p I'm confused as to how power down is part of a problem with ...
+172 27 Sep 2011 fohat.digs: OK guys, I am totally stoked. I received an IBM Model F 122-key terminal keyboard fro ...
+173 29 Sep 2011 theferenc: Harry, did you snag yours from OceanTechPrecision on ebay? Does it have dip switches ...
+174 29 Sep 2011 kishy: It can misbehave quite severely if you attempt to press any keys BEFORE the auto-dete ...
+175 29 Sep 2011 Soarer: Sounds like the adapter is somehow thinking it's a scan code set 2 board, so not tryi ...
+176 29 Sep 2011 fohat.digs: Thanks, but I am not there yet. It will be sometime next week before my Teensy gets h ...
+177 29 Sep 2011 theferenc: Thanks, kishy. I'll give that a try and see if it fixes the issue. I would really lov ...
+178 29 Sep 2011 Hak Foo: The Enter labelling is just for decoration- the converter ighnores it. I have a 122M ...
+179 29 Sep 2011 theferenc: Running hid_listen, I get the following: rAA rBF rBF wEE R101wF2 rEE wED R100!!00wED ...
+180 29 Sep 2011 Soarer: It looks like it's just unusually slow to reply to commands - like world record holde ...
+181 29 Sep 2011 theferenc: Soarer is the man! Hopefully it continues to work as well as it does right now -- tho ...
+182 30 Sep 2011 Oqsy: Great news!
+183 30 Sep 2011 theferenc: So one last question about this. The key on the keypad, directly above 9. What is its ...
+184 30 Sep 2011 Soarer: It's scroll lock... what does that do in X?
+185 30 Sep 2011 N8N: nothing at all, really... but I just tried it on my machine and scroll lock comes up ...
+186 30 Sep 2011 theferenc: Yeah, I thought it should be scroll lock, but it doesn't match scroll lock on my othe ...
+187 01 Oct 2011 Soarer: Just posted a new version (v0.996) with fixes for some reported problems, and a coupl ...
+188 01 Oct 2011 theferenc: That second one is almost exactly how I have mine laid out at the moment. Too bad I d ...
+189 01 Oct 2011 Soarer: Ah, but instead you have the jumper block inside! I've chosen the IDs so they only re ...
+190 01 Oct 2011 SmallFry: Just a thought... not really necessary but it'd be cool to add support for the SD rea ...
+191 01 Oct 2011 theferenc: AHK runs portably, for certain sure. It's just a download directly from their website ...
+192 01 Oct 2011 SmallFry: My school would have a hacker alert stroke if I wired in like at home. Therefore, I w ...
+193 01 Oct 2011 Oqsy: The perfboard and alligator clip rig I'm using for this would surely get a bomb squad ...
+194 04 Oct 2011 kishy: Here's what I've been working on for the last little while... Complete with externall ...
+195 04 Oct 2011 timofonic: Hello. Very nice! I would consider ordering one too... What about adding a SD card ...
+196 04 Oct 2011 kishy: What I did is essentially just 'packaging' the adapter...I did not make any design ch ...
+197 04 Oct 2011 alaricljs: 7 pins for the LCD... 2 pins for up/down buttons... 5 pins for the SD card slot... 2 ...
+198 04 Oct 2011 one_each: @Soarer Have you considered using something like code.google.com to host the code as ...
+199 04 Oct 2011 timofonic: @Soarer In terms of available pinout, memory and such... How's the Teensy2 or Tenensy ...
+200 04 Oct 2011 alaricljs: I'm not exactly sure what it is you're asking timo, but if you scroll to the top of t ...
+201 04 Oct 2011 fohat.digs: Help ! Getting very close, I think, but I am way over my head here, and I am not a pr ...
+202 04 Oct 2011 Oqsy: Have you checked yr pinout from the keyboard? I have no idea what colors mean what i ...
+203 04 Oct 2011 Soarer: Thanks for showing your build! SD card is almost definitely a 'no'. There's no shor ...
+204 04 Oct 2011 Soarer: [strike]Have you tried swapping the yellow and red wires?[/strike] Hang on, not sure ...
+205 04 Oct 2011 fohat.digs: Thanks for the reply. I think/hope I did something kind of like what you described. M ...
+206 04 Oct 2011 Soarer: Found a label inside my 122F so decided to just photograph it :-) [ Attachment Inval ...
+207 04 Oct 2011 fohat.digs: Thank you so much. I think that is exactly how I connected mine. Is there anything el ...
+208 04 Oct 2011 Soarer: Is it? Yellow/Clock should go to PD1, and Red/Data should go to PD0.
+209 04 Oct 2011 fohat.digs: RIGHT YOU ARE ! Stupid me with that whole upside-down-and-backwards thing! (And my re ...
+210 05 Oct 2011 Soarer: Excellent! Glad to hear it's working :-)
+211 05 Oct 2011 fohat.digs: Sorry for the double post, but, for doing the majority of my re-mapping for me! I w ...
+212 05 Oct 2011 theferenc: Yeah, I briefly considered wiring up the lock LEDs. Then I realized, wait a sec, I do ...
+213 05 Oct 2011 fohat.digs: Now this beauty is together and working great. I could not be more pleased - it is fa ...
+214 05 Oct 2011 theferenc: If you're running windows, AHK is a decent option, as is KeyTweak. The former is an a ...
+215 05 Oct 2011 fohat.digs: I usually work in Windows, but I dual-boot to Ubuntu fairly often. I would use it a l ...
+216 05 Oct 2011 Soarer: There was a hack somewhere, which should work, but some remappings done that way migh ...
+217 05 Oct 2011 theferenc: I use KeyTweak and xmodmap both, without issues whatsoever. I prefer these over the A ...
+218 06 Oct 2011 fohat.digs: You guys are simply the greatest! But I am a pest. Hopefully, when you answer my ques ...
+219 06 Oct 2011 theferenc: That's weird, I was able to remap them just fine. Did you use "teach mode" in keytwea ...
+220 06 Oct 2011 fohat.digs: No luck with that. I went through the routines in both "Half Teach Mode" and "Full Te ...
+221 06 Oct 2011 Soarer: I reckon KeyTweak has got confused trying to remap Pause... try reverting both NumLoc ...
+222 07 Oct 2011 fohat.digs: Boy-oh-boy! a missed day of geekhack down had me worried! Thanks for all your help, g ...
+223 07 Oct 2011 Soarer: Sorry, but you won't be able to remap some of the keys in that left hand F-key block, ...
+224 09 Oct 2011 fohat.digs: Hi, it's me, harrymoss, I just felt like I needed to change my ID to something less m ...
+225 09 Oct 2011 Soarer: As it stands, I'm afraid you'll have to accept that you can't get all of the layout t ...
+226 13 Oct 2011 theferenc: That's really weird, honestly. I remapped nearly everything in Linux with no issues w ...
+227 14 Oct 2011 fohat.digs: So, my amateurish trial and error fumblings continue. I post this stuff, not in a nar ...
+228 15 Oct 2011 LETE: You don't need to worry about the thicker coating affecting performance. When the key ...
+229 16 Oct 2011 fohat.digs: It might not be all that hard to make one, provided that you had a hole punch of just ...
+230 16 Oct 2011 LETE: Let's both give it a shot and compare notes. Of course, if we get a proof of concept ...
+231 17 Oct 2011 fohat.digs: May be getting far enough off-topic to warrant a new thread. Since I am really fond o ...
+232 17 Oct 2011 LETE: Yeah, I made us a thread of our own.
+233 19 Oct 2011 fohat.digs: Soarer - I have put together a 2nd keyboard, and left all the jumpers open to defaul ...
+234 20 Oct 2011 Soarer: I wish I knew why that numlock won't remap! Does it just stay as numlock then? True, ...
+235 20 Oct 2011 fohat.digs: Yes, it just stays NumLock regardless of what I tell it to be. I was using KeyTweak a ...
+236 22 Oct 2011 Soarer: No requests, sorry! The two alternative mappings came about for specific reasons - th ...
+237 23 Oct 2011 theferenc: I would recommend something like C++/Qt combination, or possibly python using wx or s ...
+238 24 Oct 2011 Soarer: C++/Qt would suit me - I'd only need to learn the Qt bit! I think I'll just go with C ...
+239 24 Oct 2011 HaaTa: Heh, I know Qt :D
+240 29 Oct 2011 RPro: Hi - dumb question,but I couldn't find it with search: Does this Teensy PS2 adapter w ...
+241 30 Oct 2011 Soarer: It should - it certainly works with my Dell AT102W and SGI Granite :)
+242 30 Oct 2011 RPro: That's great! Gonna order a teensy board soon then.
+243 31 Oct 2011 fohat.digs: A couple of things: First, do you want the Teensy for the Dell AT-101 for gaming? Bec ...
+244 31 Oct 2011 kishy: And that really does sum up a lot of why so many of us love these things...the Fs, es ...
+245 31 Oct 2011 fohat.digs: You have to take the Model F apart to really appreciate its construction. It seems mo ...
+246 04 Nov 2011 theferenc: I know the M cases can be dyed, but it's a challenge due to the size. Some folks have ...
+247 05 Nov 2011 fohat.digs: I decided that the advice was mostly against dyeing the Model F case, so I went to th ...
+248 06 Nov 2011 RPro: Actually, my new Sandy Bridge Asus P8Z68V-Pro motherboard does not have any PS/2 port ...
+249 06 Nov 2011 Soarer: Looks great, I like it! This code can't add NKRO to a non-NKRO keyboard of course, b ...
+250 08 Nov 2011 kishy: That's GORGEOUS! Very well done.
+251 11 Nov 2011 RPro: I got the teensy converter programmed and the connector soldered (stole it from an ol ...
+252 11 Nov 2011 RPro: Whoops - guess the Dell AT101W is a 2KRO. Oh well.
+253 11 Nov 2011 Soarer: Ah cool, you got it working ok! You never know exactly what you're going to get with ...
+254 11 Nov 2011 RC-1140: Hey, Currently I'm using this adapter for a 1990's 122-Key Terminal Model M, and in g ...
+255 11 Nov 2011 Soarer: Hmm, I dunno! Although... 7 is the HID usage page for keyboard keys, and 88 is the HI ...
+256 11 Nov 2011 RC-1140: well, 93 is the X keycode for the Hiragana_Katakana Symbol. I don't know why, but one ...
+257 12 Nov 2011 Soarer: Oh, ok. I don't really know anything about remapping USB keyboards in X, but somethin ...
+258 12 Nov 2011 RC-1140: d'oh! when in doubt, read manpages… m( Well. Looks like I have to do it by editing al ...
+259 12 Nov 2011 RPro: Hmm, I seem to be having an issue - it seems when I let the PC idle for a while (it d ...
+260 12 Nov 2011 Soarer: That sounds odd, I'm gonna hope it works ok on a rear port! Power saving can be an is ...
+261 12 Nov 2011 RPro: I have an Asus P8Z68-V Pro motherboard. Windows 7 64 bit. It is set to S3. It BSODed ...
+262 13 Nov 2011 Soarer: I doubt the converter caused a BSOD! Wish I knew what to suggest for that, getting a ...
+263 13 Nov 2011 RPro: Yeah I don't think it was the converter. If I have more issues with the keyboard itse ...
+264 07 Dec 2011 dorkvader: Hmm, Can I use something like this to decode a normal ascii keyboard?
+265 07 Dec 2011 Soarer: Dunno... I'm not sure what you mean...?
+266 07 Dec 2011 Soarer: Are not whole translation tables! As a silly example, if you wanted to swap the '1' k ...
+267 08 Dec 2011 hasu: mmm, nice features! and can't wait for trying new your firmware! If the syntax is sim ...
+268 08 Dec 2011 alaricljs: I want. I am not patient... but I haven't succeeded in getting anywhere with my own ...
+269 08 Dec 2011 fohat.digs: Soarer - Have you come up with a way to remap those 2 pesky numpad keys on the F-122 ...
+270 08 Dec 2011 Soarer: Thanks! I'm looking for the quickest way to get something usable - a better syntax, o ...
+271 18 Dec 2011 LukStarkiller: I have one question in mind, which is the slower response time (latency) that we can ...
+272 18 Dec 2011 Soarer: Hmm, good question! I haven't tested it, but I the worst case should be just under ...
+273 18 Dec 2011 LukStarkiller: :eek: Surprising information I never thought that the delay caused by the keyboard's ...
+274 18 Dec 2011 dorkvader: I had to do some research, to know what I meant by that (I had to look up and double ...
+275 19 Dec 2011 Mikelittoris: Okey, so i've got my terminal 122 key model f (6110347), my teensy with a female 5 po ...
+276 19 Dec 2011 DaemonRaccoon: Assuming counting from the bottom left (facing the connector). That's AT (and PS/2), ...
+277 19 Dec 2011 Mikelittoris: Oh crapper! Thanks alot DeamonRaccoon yo're the best, I shall get back to the solderi ...
+278 19 Dec 2011 Mikelittoris: Well I've connected the cables as you said DaemonRaccoon. Still nothing is happening. ...
+279 19 Dec 2011 DaemonRaccoon: Start with flashing the Teensy without the keyboard connected, make sure you have the ...
+280 19 Dec 2011 Soarer: Don't panic just yet - it's not easy to kill a Teensy with this mod! I think about th ...
+281 19 Dec 2011 Mikelittoris: Ok thanks I will have to try that tomorrow, been up for 32h straight now and I thogut ...
+282 19 Dec 2011 Soarer: LOL! Yeah, helps if everything is plugged in!
+283 19 Dec 2011 Soarer: I've no idea! There is another Wyse that kbdbabel has signalling info for, and it is ...
+284 20 Dec 2011 Mikelittoris: There we go, connected the cable to the controller and it works! I've done it, YEY! : ...
+285 31 Dec 2011 thebum: Wow. Soarer thanks so much for putting your time into this. Just got my teensy today. ...
+286 04 Jan 2012 Soarer: You're welcome - thanks for posting :-) The XT support was actually one of the easie ...
+287 04 Jan 2012 litster: Soarer, is your mapping without recompiling part ready yet? I am wondering if I coul ...
+288 04 Jan 2012 Soarer: Afraid not - I haven't had time to do any more since the last status update :-( The o ...
+289 04 Jan 2012 litster: That's cool, Soarer. We can wait. Thanks.
+290 05 Jan 2012 thebum: Thanks for the welcome. I've spent quite a bit of time on the board and have encount ...
+291 26 Feb 2012 Soarer: New version posted. For the brave!
+292 26 Feb 2012 timofonic: Features list? Please? :)
+293 26 Feb 2012 Soarer: Not brave enough - you're barred! :-p There is some (scant) documentation in the tool ...
+294 27 Feb 2012 Soarer: Ok, so what's new is all the stuff outlined in this post, and media key support. You ...
+295 28 Feb 2012 REVENGE: HOOOOOOOOOORAAAAAAAAAYYYYY!
+296 28 Feb 2012 alaricljs: Can you explain a 'SELECT'? It sounds as tho it can be used to set a layer/keymap vi ...
+297 28 Feb 2012 litster: This new update sounds very awesome. We need someone to help port it over to use on ...
+298 28 Feb 2012 Soarer: Pretty much what I thought when I finally found some time to work on it again!! FN an ...
+299 28 Feb 2012 alaricljs: Where you use crazy chords, I would use Fn. I'm also not a fan of toggles, hence usi ...
+300 28 Feb 2012 Soarer: The crazy chord was just an example :) There must be millions of ways you could put t ...
+301 29 Feb 2012 Soarer: Oh yeah, forgot to mention - SELECT_0 can be used to reset all toggles to off. So you ...
+302 29 Feb 2012 Soarer: Currently got about a dozen items on my to-do list, and making this sort of thing pos ...
+303 29 Feb 2012 alaricljs: Well, there's people willing to help if you want to share the load ;)
+304 29 Feb 2012 Soarer: Has anyone had a go at compiling the tools for Linux or MacOSX? (Linux I could try so ...
+305 29 Feb 2012 theferenc: I can try it on Mac later today or tomorrow, if you want. I'll be trying Linux, as we ...
+306 29 Feb 2012 Soarer: Either would be great! Linux is probably the one I'm more worried about, in case diff ...
+307 01 Mar 2012 Soarer: Lego! [ Attachment Invalid Or Does Not Exist ] 42352[/ATTACH]
+308 01 Mar 2012 Soarer: I call the bastardized version of usage page 7 HID codes that the converter uses inte ...
+309 02 Mar 2012 litster: Good to hear that this is on your to-do list!
+310 02 Mar 2012 mkawa: i can port this to phantom, i just need some pointers on how to get simulavr running ...
+311 02 Mar 2012 Soarer: I haven't used the simulator at all, just a combination of debug print output, extra ...
+312 03 Mar 2012 Soarer: Built myself a neat converter today :-) A while back I spotted some console hack dong ...
+313 03 Mar 2012 SmallFry: SWEET! Nice package to keep your converter in! Since it uses Atmel's stuff to program ...
+314 03 Mar 2012 Soarer: Thanks! Still one thing left to do... drill a hole in the case so I can reset it for ...
+315 03 Mar 2012 alaricljs: How much does the case flex in that spot? You might not need a hole, just fill the g ...
+316 03 Mar 2012 Soarer: Sorry, missed your edit... No, it's not compatible with the Teensy utility, and you c ...
+317 03 Mar 2012 mkawa: ok message received -- it sounds like simulators are pretty hopeless. this will have ...
+318 03 Mar 2012 Soarer: Hardly any flex, surprisingly, but it might _just_ work... with a very firm squeeze! ...
+319 03 Mar 2012 Soarer: Dunno about hopeless, but I always find using them a mixed bag. It's nice to be able ...
+320 03 Mar 2012 mkawa: agreed. i was hoping there was a nice debugging toolkit that would let me do these th ...
+321 03 Mar 2012 Soarer: Hmm. This looks quite easy, actually, but which address to jump to depends on the boo ...
+322 05 Mar 2012 drteming: Newbie here. Just got a terminal 1390572 last week. Cleaned it up and did a full bo ...
+323 05 Mar 2012 Soarer: Thank you for posting pics - I love seeing a nice tidy build!
+324 06 Mar 2012 fohat.digs: Oh that is beautiful. I am doing something similar when I have some spare time, and y ...
+325 06 Mar 2012 theferenc: Soarer, do you want compilation feedback via PM or in the thread?
+326 06 Mar 2012 Soarer: Aha, cool! Probably here, in case others might want to try as well. Unless it's embar ...
+327 07 Mar 2012 theferenc: I don't think it's embarrassing, no. This is all on Linux (RHEL 6). I was able to get ...
+328 07 Mar 2012 Soarer: Knocked together some code that should work for nearly all Atmel AVR chips (except xm ...
+329 07 Mar 2012 Soarer: Thanks for putting the time in! I'll plug my Linux (Mint, Debian) box back in so I ca ...
+330 07 Mar 2012 Soarer: Got scrd and scwr working on Mint! Needed libusb-0.1-4 and libusb-dev installing to g ...
+331 07 Mar 2012 RC-1140: Hey Soarer, at first: thank you very much for creating such a fantastic converter sof ...
+332 07 Mar 2012 Soarer: It should work fine on any 32U4, as long as you can get it in there! The dongle I ada ...
+333 08 Mar 2012 RC-1140: Actually even this would be great, as I'm currently using 0.996 anyway. This might be ...
+334 08 Mar 2012 Soarer: The trouble is, I'm not sure why it helps much - the '32U4 chip is about 5EUR, and th ...
+335 08 Mar 2012 Soarer: In other news, I just added Jump to Bootloader support for the next release, with two ...
+336 08 Mar 2012 RC-1140: Yeah, of course that little price difference doesn't justify the extra work you would ...
+337 08 Mar 2012 Soarer: I will have a look in case there's some easy memory saving that can be done, but othe ...
+338 08 Mar 2012 Soarer: Well, I managed to reduce the size by about 2KB. (Stupid makefile forcing inclusion o ...
+339 09 Mar 2012 SmallFry: Will you ever open source your code? I know I've asked before, but can't recall off hand.
+340 09 Mar 2012 Soarer: I really don't know if or when. Once done it cannot be undone - last time I started t ...
+341 09 Mar 2012 litster: Which IBM keyboard would be best to use for this project if I want to keep it small a ...
+342 09 Mar 2012 Soarer: The AT (84-key). It's not 'small', but there's only about an extra inch on the RHS co ...
+343 09 Mar 2012 litster: Right, the AT. But it would be hard to get one now. Could I do this on a Phantom, w ...
+344 09 Mar 2012 Soarer: Hard, but far from impossible. You just have to keep looking, and be prepared to pay ...
+345 09 Mar 2012 litster: Ah, I get it now. The Phantom firmware we have now came from PrinsValium. His code ...
+346 09 Mar 2012 Soarer: OK. I'll talk to him when I'm ready to make plans for controller stuff.
+347 12 Mar 2012 Soarer: Yes. (I missed seeing the edit again!)
+348 13 Mar 2012 drteming: Well, I worked up the courage to delve into Soarer's 0.997 firmware. My last foray i ...
+349 13 Mar 2012 wcass: if you are serious about this, i'ld like to talk to you about a project i'm working o ...
+350 13 Mar 2012 Soarer: Hail to the Brave! Thanks for posting up what you've done, and how. Sorry about the l ...
+351 13 Mar 2012 Soarer: I'm serious, but it's possibly not quite what you're after - my plan is to replace ju ...
+352 16 Mar 2012 Parak: I'm entirely too lazy to check this at the moment, but isn't the teensy++ and the mai ...
+353 16 Mar 2012 Soarer: Yup, same size, but the ++ has GND and AREF in the middle of one side, which aligns w ...
+354 16 Mar 2012 Parak: They would align in every one of the four possible orientations of a teensy++? Still, ...
+355 16 Mar 2012 Soarer: Well, there's also that +5V and GND are on diagonally opposite corners of the CPU, vs ...
+356 16 Mar 2012 Parak: Hmm, I see. Does T0 have to be used for something? If not then using teensy++ with +5 ...
+357 16 Mar 2012 Soarer: Depends on the 'board - the XT, AT and DisplayWriter use it for signalling to the hos ...
+358 19 Mar 2012 wcass: thanks Soarer. i used this in my IBM AT project here: http://geekhack.org/showwiki.ph ...
+359 01 Apr 2012 ed_avis: With a Dell M6300 (BIOS rev A14) and Windows XP x64 SP2, and the converter driving a ...
+360 01 Apr 2012 kishy: Yeah, I've had troubles with a Dell Inspiron 630m doing the same thing. Presuming BIO ...
+361 01 Apr 2012 ed_avis: Strangely, although the M6300 does not recognize the Soarer-adapted keyboard for hitt ...
+362 01 Apr 2012 Soarer: There must be something peculiar that these machines have in common. I mean, they wor ...
+363 02 Apr 2012 ed_avis: Soarer I see that you are in the same country as me. If you are near London and you ...
+364 02 Apr 2012 Soarer: Many thanks for the offer! For me, that wouldn't be feasible for a month or two thoug ...
+365 03 Apr 2012 litster: Sweet! I am going to get a few parts to build this. I have Teensys at home ready to go.
+366 07 Apr 2012 Morning Song: Just a little report/question: I'm using one of the earliest teensy adapters, made by ...
+367 08 Apr 2012 Soarer: Hey, that's an odd one! What's a 6011668? I'm guessing it's a 122-key terminal board ...
+368 08 Apr 2012 Morning Song: Er, whoops! It's a 6110668, not 6011668. (Same as, i believe, Sethstorm's). Force Se ...
+369 08 Apr 2012 Soarer: Cool, 'force' works! Using it stops the converter querying the board at all, so it's ...
+370 08 Apr 2012 Morning Song: Exactly! Back in the Dark Times before you guys came out with these adapters, Kishy h ...
+371 08 Apr 2012 Soarer: Heh, I finally started to try and get some better documentation sorted out today! A d ...
+372 08 Apr 2012 wcass: i was thinking i would like to help with an .hta GUI wrapper for your code. it would ...
+373 08 Apr 2012 Soarer: The more the merrier! I've managed to get the command line tools compiling on all pla ...
+374 08 Apr 2012 Morning Song: My thoughts on the matter is that if there's a nice simple one-file way of including ...
+375 08 Apr 2012 alaricljs: A gui could probably be built across the command line tools with AutoHotKey.
+376 08 Apr 2012 Soarer: It partly depends on what you all think a GUI should do! I know it wouldn't start off ...
+377 09 Apr 2012 SmallFry: The gui should include a verbose just for debugging stuff:) Other than that, and bein ...
+378 09 Apr 2012 Parak: I think the GUI could basically just be a front end to the tools. One would select fr ...
+379 09 Apr 2012 Soarer: Heh, a minimal front-end could just be a text editor with a 'send to keyboard' button ...
+380 16 Apr 2012 fruktstund: I'm a bit tired right now, and this might therefore be somewhat a stupid question, bu ...
+381 17 Apr 2012 Soarer: Glad you find it useful! USB-to-USB might happen at some point in the future - there ...
+382 17 Apr 2012 litster: Hi. I just built a Soarer converter. But I am running into some problem. Here is t ...
+383 17 Apr 2012 kishy: Silly question, but are you unplugging the USB connector before changing keyboards? E ...
+384 17 Apr 2012 Soarer: Aha, I hope it is just that! It's the only thing I can think of that makes sense of t ...
+385 17 Apr 2012 litster: Hi. I tried cold plugging different keyboards. The result is the same. On the old ...
+386 17 Apr 2012 Soarer: So you're plugging the keyboard into the converter, and then the converter into the P ...
+387 17 Apr 2012 litster: Thank you! That was it! I always connected the Teensy to the PC first, and then plu ...
+388 17 Apr 2012 kishy: Good to hear - and yes, hotplugging XT, AT or PS/2 interfaces is not really the best ...
+389 17 Apr 2012 Soarer: Phew!
+390 17 Apr 2012 litster: Soarer, is it possible to detect a disconnect of the PS/2 connection, and reset the T ...
+391 17 Apr 2012 Soarer: Hmm. Probably, with some work, but I'm not sure I want to encourage it! (There is a r ...
+392 18 Apr 2012 bhtooefr: What about detecting the unplug, and then blinking an error condition? Or even having ...
+393 18 Apr 2012 litster: Hehe, I thought more people need to know how cool Soarer's converter is, so I posted ...
+394 19 Apr 2012 Soarer: Thanks for that! Hope you enjoy it, and find a use for some of the other features as ...
+395 19 Apr 2012 Soarer: Been working on the docs a bit - any comments and/or tips would be welcome! [ Attach ...
+396 19 Apr 2012 REVENGE: Oh man, this looks great! I'll do a read through, let you know if I have any suggestions.
+397 19 Apr 2012 Gawkbasher: Very cool documentation. Thanks!
+398 19 Apr 2012 Soarer: It's pretty much the first time I've messed with CSS, so, um, don't look at that! The ...
+399 20 Apr 2012 bhtooefr: FWIW, you can do the navbar stuff in CSS, too - no need to do it in JavaScript. Typo ...
+400 20 Apr 2012 Soarer: The navbar is done in CSS, but effectively it's a client-side include I really wanted ...
+401 23 Apr 2012 Soarer: To celebrate, I present , with these new and improved features...
+402 23 Apr 2012 Zorael: Pre-built linux tools sounds awesome! Excuse me if I'm sobbing; I've just spent the b ...
+403 23 Apr 2012 Soarer: Thanks! And welcome to geekhack! Oh man, I'm really sorry :-( There were a few posts ...
+404 25 Apr 2012 andrewjoy: will this work on the rubber dome wise boards also ? i got one off ebay quite cheap i ...
+405 25 Apr 2012 Soarer: I don't know the keyboard - any idea what protocol it uses? What connector?
+406 25 Apr 2012 andrewjoy: it uses a phone type connector similar to other terminal boards i am amusing it uses ...
+407 25 Apr 2012 John Boone: Congrats and happy birthday for your Converter ! I would like to know if it is possi ...
+408 25 Apr 2012 Soarer: Thanks! Yes, it can, with some caveats... First, it won't fit with the standard Atmel ...
+409 01 May 2012 John Boone: Thanks for the answer, well I will stick with the 32k version as for now, since i am ...
+410 01 May 2012 Soarer: Unless you already have some 16k chips, then it's definitely worth going for the 32k. ...
+411 27 May 2012 REVENGE: Woo, busted out the Unsaver tonight. Converter works great, and now I finally have th ...
+412 27 May 2012 Soarer: BTW: LANG_4 is the center key in the arrow cluster for 122s. :-p There is an easier w ...
+413 27 May 2012 REVENGE: Good tip, thanks!
+414 31 May 2012 Soarer: New version which fixes a bug that stopped jump to bootloader functions working on AT ...
+415 05 Jun 2012 Soarer: We can add Dell Latitude D800 to that list :-( At least I have one to play with, so i ...
+416 06 Jun 2012 fohat.digs: I have installed 12.04 as a dual-boot with Windows 7, and the OS does not seem to rec ...
+417 06 Jun 2012 Soarer: Oh crap - what have they gone and done! :-( No driver needed, it should be all there ...
+418 06 Jun 2012 alaricljs: Also check if the USB on the other side of the Dell works. I haven't been able to fi ...
+419 06 Jun 2012 kishy: FWIW, all of my tests on the 630m involved all 4 ports (which are on the same "side", ...
+420 06 Jun 2012 alaricljs: My D820 and e6410 both have opposite side USB ports, I was under the impression that ...
+421 06 Jun 2012 kishy: [ Attachment Invalid Or Does Not Exist ] 52336[/ATTACH] I believe 630m is the odd on ...
+422 06 Jun 2012 Soarer: Actually, on the D800 (A11 BIOS) it seems to work OK from a cold boot, but not on res ...
+423 06 Jun 2012 Soarer: Hmm... so on this Dell actually all devices are showing up. Strangely, the scinfo com ...
+424 08 Jun 2012 Soarer: I not sure that this D800 has the quite same problem as those other Dells. On this on ...
+425 08 Jun 2012 fohat.digs: I don't know about anybody else's Ubuntu 12.04 problem, but mine was fixed immediatel ...
+426 08 Jun 2012 Soarer: Interesting... that actually makes it more similar to the Dell laptops' problem, in t ...
+427 08 Jun 2012 fohat.digs: Yes, I think that it just had to recognize the USB device once, smooth sailing after ...
+428 08 Jun 2012 Soarer: Ah good. Just these pesky Dells to deal with now then! :-D
+429 19 Jun 2012 AKIMbO: Hey guys I need a little help with my teensy install. I'm converting an XT to usb. ...
+430 19 Jun 2012 Soarer: Brown = Vcc Red = Ground White = Data Black = Clock :-)
+431 19 Jun 2012 AKIMbO: Thank you so much Soarer. I was pulling my hair out and second guessing myself with ...
+432 19 Jun 2012 Soarer: Haha, yeah, IBM (and Cherry) sure did pick some unintuitive colours! Good to hear of ...
+433 19 Jun 2012 Paranoid: Hi everyone. I'm also trying to convert XT to USB (IBM model F), but when I wire it l ...
+434 19 Jun 2012 Soarer: Ouch, that doesn't sound good at all - the Teensy shouldn't even be warm :-( Where th ...
+435 19 Jun 2012 Paranoid: The wire colours are in the same order as in the picture (brown-red-white-black) with ...
+436 19 Jun 2012 Soarer: Either Vcc and GND are fine. Hate to say it, but I think somehow the Teensy has died ...
+437 20 Jun 2012 Paranoid: Damn that would suck! I also can connect it to my computer and run and load the LED b ...
+438 20 Jun 2012 Soarer: Reversing Vcc and GND is more likely to damage the keyboard than the Teensy, and I'm ...
+439 20 Jun 2012 Paranoid: Yes, I do have a multimeter :) I did the test that you asked. Let me sum it up: Basic ...
+440 20 Jun 2012 Soarer: I dunno... something doesn't quite add up :-) I don't see how the Teensy would get ho ...
+441 20 Jun 2012 Paranoid: yes that's exactly how I did the current measurement. Maybe there's something wrong w ...
+442 21 Jun 2012 REVENGE: You could double check the wire config by using a multimeter and testing for continui ...
+443 21 Jun 2012 Paranoid: Hi Revenge, I checked that in the beginning. The VCC, ground and data were correct, o ...
+444 21 Jun 2012 Soarer: I think that means you were reading the pinout diagram backwards - it's drawn looking ...
+445 21 Jun 2012 Paranoid: hehe, that would explain why I got the grnd and vcc wrong the first try ^^ the pins a ...
+446 22 Jun 2012 Soarer: Sorry, I missed the update :-) I'm still puzzled why the teensy and cable get hot, wi ...
+447 24 Jun 2012 Parak: For my second F122 refurbishment, I took some of these that I had lying around and fo ...
+448 24 Jun 2012 Soarer: That's pretty neat :-) Put the pins on the back you mean? But then you'd have bits st ...
+449 24 Jun 2012 Parak: It would have looked a bit neater as the d0/d1 pins could have been flush, but then I ...
+450 23 Aug 2012 fohat.digs: I am probably just dense or incompetent, but here are 2 questions: 1. How to I get to ...
+451 23 Aug 2012 Soarer: 1. The article has moved to the first post in this thread ;) 2. Depends... Day-to-day ...
+452 26 Aug 2012 neocalm: Hello Soarer! What a fantastic project, with my beginner skills I never thought I wo ...
+453 26 Aug 2012 Soarer: Well, AB is only 'bad' because it is used to identify the regular 101/102-key keyboa ...
+454 28 Aug 2012 neocalm: Thanks, that makes sense on why "AB" is bad. Turns out that the board has no "JP3" ...
+455 28 Aug 2012 Soarer: Excellent! Actually, the 'force' command only forces the converter to for set 3, it ...
+456 31 Aug 2012 neocalm: That's great to know the Converter doesn't set the Set. So I did do something! :) E ...
+457 31 Aug 2012 Soarer: It isn't. I thought about it, but never got round to adding it, because it didn't rea ...
+458 01 Sep 2012 neocalm: ... well that ended pretty quick :( I was all set for the "bolt-mod" with all the req ...
+459 01 Sep 2012 Soarer: How frustrating :( I guess that means that one of those traces on the plastic sheets ...
+460 01 Sep 2012 N8N: Rear defogger repair kit?
+461 01 Sep 2012 Soarer: Yeah. Or from electronics suppliers ( ). I should say I've no idea how well or even i ...
+462 09 Sep 2012 Halvar: Hi, thank you Soarer for this great piece of software. Another report of a successful ...
+463 09 Sep 2012 Soarer: You're welcome! And good job building it in with LEDs, many people don't bother with ...
+464 09 Sep 2012 Halvar: *danceandsing* Thanks a lot Soarer, that did it! I even did read the post that you l ...
+465 09 Sep 2012 Soarer: Excellent! LOL, I hadn't even noticed the [´] in your post! Thanks for posting the c ...
+466 10 Sep 2012 __red__: Another satisfied customer here - IBM Model F 122 key, 6110344 5 August 1986. :)
+467 18 Sep 2012 Krogenar: I've got two broke-down Model M 122's headed my way -- looking forward to giving this ...
+468 18 Sep 2012 fohat.digs: Something is escaping me here. I am back where I was a month ago at post 451 trying t ...
+469 18 Sep 2012 Soarer: It's usually described as a 270 degree 5 pin DIN (or sometimes 240 degree), whereas t ...
+470 18 Sep 2012 Soarer: Does it recognize the keyboard if you program it with v0.997? There isn't any real di ...
+471 18 Sep 2012 fohat.digs: Thank you. I did this last year with an F-122 in which I installed the Teensy interna ...
+472 18 Sep 2012 Soarer: I think the old config will be fine, and anyway we won't need one yet, to get the key ...
+473 19 Sep 2012 fohat.digs: I think that I have done it several ways. My assumption is that the preferable metho ...
+474 19 Sep 2012 Soarer: I was just checking, since with the Teensy built-in to your other keyboard, the quest ...
+475 19 Sep 2012 fohat.digs: I do have hid_listen but there is nothing for it to listen to ...... Are the pins on ...
+476 19 Sep 2012 Soarer: Odd. Once the Teensy is programmed with the converter code, hid_listen should at leas ...
+477 19 Sep 2012 Krogenar: Thank you Soarer! I think I'm going to try a panel mount because I'd rather not alter ...
+478 19 Sep 2012 Soarer: Ah, the trailing socket wouldn't mean modifying the keyboard, it would be for making ...
+479 19 Sep 2012 fohat.digs: Allow me to clarify the situation and reduce misunderstanding. I have my "old" rig w ...
+480 19 Sep 2012 Soarer: That's exactly what would happen if you programmed it with blinkfast instead of progr ...
+481 20 Sep 2012 fohat.digs: Thank you. Do I need to somehow de-program ore re-format the Teensy from Fast-Blink? ...
+482 20 Sep 2012 Soarer: Hmm, strange. Programming it with the converter hex ought to remove the blinking. Jus ...
+483 20 Sep 2012 fohat.digs: "Something" happened. I went through your steps again. After opening the hex file, pr ...
+484 20 Sep 2012 fohat.digs: Now I am getting a little worried. I plugged an ordinary PS2 keyboard into the Teensy ...
+485 20 Sep 2012 Soarer: OK, progress, it seems to be programmed now :-) Since you're getting some response wh ...
+486 20 Sep 2012 fohat.digs: I keep working on this instead of my "real" work. My working converter is hard-wired ...
+487 20 Sep 2012 Soarer: Don't dismantle your working one! I meant we should be able to get this new one worki ...
+488 20 Sep 2012 fohat.digs: Using a 10-year-old Compaq rubber dome board with PS2 connector, with each key press ...
+489 20 Sep 2012 Soarer: That's a mix of Timeout and Start Bit errors, with a rare Internal error. One possibl ...
+490 20 Sep 2012 fohat.digs: Thanks, but going by your diagram at the beginning of the thread, I think I have it w ...
+491 20 Sep 2012 Soarer: I know you do, but there must be something wrong somewhere! :D Pretty much any standa ...
+492 21 Sep 2012 fohat.digs: Yes, the XT is what I have been working with. I gave up the alligator clips and have ...
+493 21 Sep 2012 Soarer: I think the only way to fully cook the keyboard is to connect power and ground in rev ...
+494 21 Sep 2012 fohat.digs: This is indeed disappointing, if I have carelessly wrecked 2 Model Fs. Is there a rel ...
+495 21 Sep 2012 Soarer: Well I'm not sure that you have totally wrecked them, unless you think you might have ...
+496 22 Sep 2012 fohat.digs: This is going to have to get shelved for a few days. - IF - I did apply the power bac ...
+497 22 Sep 2012 Soarer: OK. I'm sorry that this hasn't gone as smoothly for you as it did last time. Trouble ...
+498 22 Sep 2012 fohat.digs: Depending on how this all plays out, I can send you some dead parts that have no more ...
+499 22 Sep 2012 Soarer: Thanks! I'm still hopeful that it's not that much of a disaster though :)
+500 24 Sep 2012 kishy: If the controller is toast, let's not forget that dfj was making a full replacement.. ...
+501 24 Sep 2012 Soarer: True, I'm not forgetting it, but dfj would need quite some prodding to release code o ...
+502 25 Sep 2012 Krogenar: Fohat, just a heads up -- I got two 122-key Terminal Model M's from eBay. One has a c ...
+503 25 Sep 2012 kishy: I guess with the attachments being lost my huge post showing the differences between ...
+504 25 Sep 2012 Soarer: Unfortunately, Model M controllers don't have the special capacitive sensing chip tha ...
+505 26 Sep 2012 oTurtlez: I've got a Leading Edge DC-2014 and the internal connector has six wires coming out. ...
+506 26 Sep 2012 Soarer: Yeah, I'm afraid they need to be properly identified. Either by using a multimeter, o ...
+507 26 Sep 2012 oTurtlez: Heres another pic focusing more on the traces. It seems the Yellow is definitely the ...
+508 26 Sep 2012 Soarer: LOL, I said DON'T take my guesswork as fact!! :p Still need a pic that shows the tra ...
+509 26 Sep 2012 oTurtlez: Traces of the 14 pin ---> The 40-pin is an 8048 and the 14 pin reads 6A1 8(New line) ...
+510 26 Sep 2012 Soarer: Cool. 74LS125 is a tri-state buffer chip. Black and grey wires both go there, so they ...
+511 26 Sep 2012 oTurtlez: Trying that now, Teensy just came in the mail so I'm getting to the soldering Thanks.
+512 26 Sep 2012 oTurtlez: Well my Teensy just arrived so I tried it out and got everything soldered up. Loaded ...
+513 26 Sep 2012 Soarer: Bah :( Is it giving any output to hid_listen when you press keys? Also, with hid_list ...
+514 26 Sep 2012 oTurtlez: It gave no output when keys were pressed, I hadnt used it with the black and grey swa ...
+515 27 Sep 2012 fohat.digs: Sounds like what is happening to me. Could there be a bad batch of Teensys shipping r ...
+516 27 Sep 2012 oTurtlez: As much as I'd like that to be the case so I could get a replacement, All software de ...
+517 27 Sep 2012 Halvar: Hi, from my experience this error means that there's a problem with the connection be ...
+518 27 Sep 2012 Soarer: Oh man, that really sucks... I think the track away from the PD1 pad is on the top si ...
+519 27 Sep 2012 oTurtlez: I really need a better iron. This 25w POS has been with me for far too long. I need s ...
+520 27 Sep 2012 oTurtlez: Do you know if there's any way to reprogram the code to look to PD2 instead of PD1? O ...
+521 27 Sep 2012 Soarer: It would be possible, but the problem is I don't want to add such a build to the rele ...
+522 27 Sep 2012 oTurtlez: I'm guessing it's not as simple as going into the code and changing all PD1 to PD2? ( ...
+523 27 Sep 2012 Krogenar: How would you know if a keyboards controller were faulty, broken?
+524 28 Sep 2012 Soarer: It's written in C :-) The point is, it would be fairly easy for me to mod it, but I d ...
+525 28 Sep 2012 Soarer: That is a properly sorted 122-key! The LEDs and relegendable keys really make it sple ...
+526 28 Sep 2012 Soarer: From the IBM PC Technical Reference... So although the IBM keyboards didn't use the R ...
+527 03 Oct 2012 Krogenar: Soarer, just wanted to give you a huge thanks! Got your converter working late last n ...
+528 03 Oct 2012 Soarer: That's good to hear! Let's have some pics :D
+529 03 Oct 2012 Soarer: Paranoid's dead XT arrived, and I started examining it. Testing revealed a complete s ...
+530 04 Oct 2012 __red__: Any sign of bulging or other physical defecT?
+531 04 Oct 2012 Soarer: Not that I can tell. I'm sure it would've been more dramatic without the USB port's o ...
+532 05 Oct 2012 page2pagepro: Please note, for IBM Model M 1390572, the image above is for female socket, not male ...
+533 06 Oct 2012 Soarer: That on github is hasu's great repo :) There's no source code available for my conver ...
+534 06 Oct 2012 Soarer: Recently I've been working with oTurtlez trying to figure out his Leading Edge DC-201 ...
+535 14 Oct 2012 page2pagepro: Anti-Ghosting with Teensy? Using tool, http://www.microsoft.com/appliedsciences/antig ...
+536 14 Oct 2012 Soarer: I'm sorry to disappoint you, but the Model M isn't NKRO and the converter can't chang ...
+537 14 Oct 2012 __red__: I think we as a community need to buy soarer a logic analyzer. Given what he's given ...
+538 14 Oct 2012 Soarer: Thanks red! Actually, I've already got this one with a ... here's some ! ;D But mos ...
+539 15 Oct 2012 Krogenar: Is my converter weird or something? It's working -- if press keys on my 122 Terminal ...
+540 15 Oct 2012 Halvar: @Krogenar: To see the scan set, you'll have to have the hid_listen.exe window open w ...
+541 15 Oct 2012 Soarer: Thanks Halvar, that's all great! Krogenar, you don't really need to know which scan s ...
+542 15 Oct 2012 urbanus: Works with my 83-key Model F XT -- typing on it right now! :) Thank you very much So ...
+543 15 Oct 2012 Krogenar: Yes, I discovered that when I remove the keyboard cable and reinsert, that there's mo ...
+544 15 Oct 2012 alaricljs: If I recall from my reading of this thread.... you're not supposed to detach/attach t ...
+545 15 Oct 2012 Krogenar: Ok, here we go. Keep in mind I have no experience building electronics. My goal was t ...
+546 15 Oct 2012 Soarer: Hmm, that should work to clear things back to the defaults. You can check by running ...
+547 16 Oct 2012 Krogenar: I tried using Halvar's config file -- worked beautifully. I'm trying to find some nic ...
+548 16 Oct 2012 Halvar: The painting restoration story is hilarious. :D Some symbol fonts I found and partly ...
+549 16 Oct 2012 Krogenar: Yeah, she started out trying to restore Jesus, and wound up making him look like Mr. ...
+550 16 Oct 2012 Soarer: Nothing exciting... it's just the Window's menu key.
+551 16 Oct 2012 Halvar: http://www.clker.com/clipart-15445.html
+552 01 Nov 2012 Soarer: New improved version (sorry __red__!) now samples whenever any of PD0 to PD3 change, ...
+553 08 Nov 2012 Arbiter343GS: I actually did this project about a month ago after I bought a 122 key model M off of ...
+554 08 Nov 2012 fohat.digs: I have used Key Tweak, but most people seem to prefer Auto Hot Key. I plan to try AHK ...
+555 08 Nov 2012 Arbiter343GS: Ive been trying auto hotkey but I have no idea how to go about programming the extra ...
+556 08 Nov 2012 Soarer: Remappings are best done in the converter because then there's no restrictions (like ...
+557 08 Nov 2012 fohat.digs: Do you remember that I went through hours/days of anguish trying to get a Teensy to w ...
+558 09 Nov 2012 Soarer: That's a tough one to call! I the only likely way to electrically damage a Teensy w ...
+559 09 Nov 2012 fohat.digs: I emailed "Paul" and he was nice but I am not going to push for a replacement. He is ...
+560 09 Nov 2012 Soarer: Yes, that is a relief. I've used about half a dozen Teensies, and had no bad ones. I ...
+561 09 Nov 2012 wcass: it is actually quite easy. first, go to the DOCS folder and double-click on . since ...
+562 09 Nov 2012 fohat.digs: The last leg of this trip has been surprisingly difficult, but I now have my working ...
+563 09 Nov 2012 Krogenar: Nice build fohat!
+564 09 Nov 2012 fohat.digs: Arrgh! I spoke too soon about my ecstasy. My old build, F-122 with internal Teensy an ...
+565 09 Nov 2012 Halvar: hid_listen only shows the ID when the teensy is started. So to see it, unplug your ke ...
+566 09 Nov 2012 Soarer: Yes, the solution is to use a config file and do the remapping on the Teensy - wcass' ...
+567 09 Nov 2012 fohat.digs: Thank you. When I hot plug the Teensy, I get: wED rFE !!FEwED rFE !!FEwED rFE !!FE Th ...
+568 09 Nov 2012 Soarer: You don't have to give up on remapping Pause if you do the remapping in the converter ...
+569 09 Nov 2012 Halvar: I don't know if there's a difference between the default mapping of an M-122 and an F ...
+570 09 Nov 2012 fohat.digs: Finding the picture (not easy) that went along with my own post at #223 allowed me to ...
+571 10 Nov 2012 Soarer: Halvar, that's true... since v0.997 that Pause mapping moved to legacy.sc. It never w ...
+572 10 Nov 2012 Soarer: fohat, to give a quick idea of the process of getting config 'in the converter', the ...
+573 10 Nov 2012 Arbiter343GS: I pretty much understand how the entire process works now, but Im stumped on how to g ...
+574 10 Nov 2012 Soarer: On Windows, the simplest way to do it without the drag-drop into the command prompt w ...
+575 10 Nov 2012 zz: hi! and thank you so much for making this awesome project! i can confirm that it work ...
+576 10 Nov 2012 Soarer: Data line is stuck high - hopefully just a bad connection :)
+577 10 Nov 2012 zz: aw man and a support reaction time of ten minutes! there is no hid manufacturer that ...
+578 10 Nov 2012 Arbiter343GS: That worked, thank you for all the help! And wow. I am definitely blind, I was scouri ...
+579 10 Nov 2012 Soarer: Yeah, scas takes two arguments, so dropping a file onto it in the GUI doesn't work. ...
+580 10 Nov 2012 fohat.digs: Thank you again, you always come through. I was having a similar problem to Arbiter, ...
+581 10 Nov 2012 Soarer: We can most definitely get it much better than having to live with any annoyances, bu ...
+582 10 Nov 2012 fohat.digs: Sorry to make life difficult. First, I had already reset everything in KeyTweak back ...
+583 10 Nov 2012 Soarer: For the top-right numpad key, you need to remap EXTRA_SYSRQ, and the centre key in th ...
+584 10 Nov 2012 fohat.digs: My hat is off to you once again. And please, never let questions about keyboards get ...
+585 10 Nov 2012 Soarer: All stocked up now :cool: If Pause hadn't been EXTRA_SYSRQ, it would've been PAD_MIN ...
+586 10 Nov 2012 fohat.digs: Sweet! Even better than I thought. I guess that in England you don't have "blue laws" ...
+587 11 Nov 2012 Soarer: No, nothing like 'blue laws', but big shops are limited to I think 6 hours opening on ...
+588 11 Nov 2012 AKIMbO: A big shout out to Soarer...I just want to say thank you again for this awesome conve ...
+589 11 Nov 2012 fohat.digs: Good Luck! What was that one dated, April 1984? The oldest one I have is a 6110344 da ...
+590 11 Nov 2012 AKIMbO: April 1984....Part # 6110344. Foam mat appeared to be in decent condition and the me ...
+591 11 Nov 2012 zz: damn. why did i touch it. it was running perfectly :'( after very carefully resolder ...
+592 11 Nov 2012 fohat.digs: What wires? As much as I have tinkered with other stuff, I have not touched any "inte ...
+593 11 Nov 2012 zz: i meant the cable.. i just wanted to make it shorter to fit inside.
+594 11 Nov 2012 Soarer: So it's worse than before? Not even the rFF codes now? :( Most of the ways to damage ...
+595 11 Nov 2012 zz: phew! got it back to work on pd3 and pd4 with the alternate firmware a few pages bac ...
+596 11 Nov 2012 Soarer: Shame about the damage, but at least it's working now :)
+597 24 Nov 2012 AKIMbO: Mmmmm.....success. ANSI layout. Thanks again Soarer!
+598 24 Nov 2012 Soarer: Nicely done... and very clean!
+599 24 Nov 2012 AKIMbO: I'm having a bit of an issue with the converter. When I run the command (scwr akimbo ...
+600 24 Nov 2012 Soarer: That's odd. No errors from 'scas akimbo.cfg akimbo.scb', presumably?
+601 24 Nov 2012 AKIMbO: ^You know what I did wrong. I didn't use type .cfg when i ran 'scas akimbo.cfg akimb ...
+602 24 Nov 2012 Soarer: Ahahahahahaha... haaaa.... :p
+603 24 Nov 2012 AKIMbO: :-[ Hehehehe
+604 24 Nov 2012 Soarer: :-* (there is no bro-hug smiley, so...)
+605 25 Nov 2012 fohat.digs: Great job, AKIMbO. I have been working on my instructions for a project similar to th ...
+606 27 Nov 2012 fohat.digs: Just when I thought it was safe to go in the water again ..... I lost my numpad. The ...
+607 27 Nov 2012 Soarer: What an odd problem, since the CURRENT_USER setting should override the .DEFAULT!! BT ...
+608 27 Nov 2012 fohat.digs: I think that .DEFAULT must have blown everybody's minds. The choices were 0, 1, or 2 ...
+609 07 Dec 2012 Soarer: PLEASE VOTE for my converter in the Deskthority Awards 2012: Best input device mod 20 ...
+610 07 Dec 2012 fohat.digs: Everybody vote for Soarer. Without him, I would never have known the joy I have exper ...
+611 07 Dec 2012 Soarer: At least I can't lose to thin ABS keycaps again this year!! That made me sad, but my ...
+612 08 Dec 2012 Krogenar: Voted. Possibly twice. ;)
+613 08 Dec 2012 Soarer: Full source and binaries for the logic analyzer now posted on DT :D
+614 09 Dec 2012 JesuswasaZombie: http://learn.adafruit.com/usb-next-keyboard-with-arduino-micro/overview How cute, the ...
+615 09 Dec 2012 Soarer: Well maybe they are - it's a different protocol, after all! Pains me to see bit-bangi ...
+616 11 Dec 2012 precarious: http://deskthority.net/wiki/File:G80-0777.pdf I purchased a Teensy the other day to t ...
+617 11 Dec 2012 Soarer: Difficult to say what that extra ROM chip changes - it could be an entirely different ...
+618 11 Dec 2012 Halvar: Quite remarkable -- I have never seen an Amiga keyboard like that. AFAIK, the Amiga ...
+619 11 Dec 2012 precarious: The seller of the keyboard said it was for an Amiga 1000, so I suppose that makes sen ...
+620 12 Dec 2012 Soarer: Sure, this would be a great way to convert a Dolch! I don't know if there are any con ...
+621 12 Dec 2012 metalliqaz: Well this was an easy project. Zero to typing with my Model-M with surprisingly litt ...
+622 15 Dec 2012 Soarer: Many thanks to everyone who voted for my converter :D Deskthority Awards - Best input ...
+623 15 Dec 2012 precarious: the competition didn't stand a chance, congratulations :)
+624 15 Dec 2012 fohat.digs: Great work, Soarer! I guess that you have been working on this for the better part of ...
+625 16 Dec 2012 Krogenar: Congrats Soarer!
+626 18 Dec 2012 precarious: Received my Teensy and PS2 connector today, managed to get the Dolch working over USB ...
+627 18 Dec 2012 Soarer: Certainly some (most?) WYSE keyboards aren't handled by the converter, since they hav ...
+
+
diff --git a/docs/codes.html b/docs/codes.html
new file mode 100644
index 0000000..b9f779d
--- /dev/null
+++ b/docs/codes.html
@@ -0,0 +1,333 @@
+
+
+
+Codes
+
+
+
+
+Modified HID Code Set
+
+
+Codes in italics are used internally by the converter, and are not output.
+Codes with highlight are output, but may not be supported by all OS (notably Windows).
+Media and Power codes are translated to the correct code page before being output.
+
+
+
+
+
+
+Name HID Code Description
+UNASSIGNED 0x00 No Event
+OVERRUN_ERROR 0x01 Overrun Error
+POST_FAIL 0x02 POST Fail
+ERROR_UNDEFINED 0x03 ErrorUndefined
+A 0x04 a A
+B 0x05 b B
+C 0x06 c C
+D 0x07 d D
+E 0x08 e E
+F 0x09 f F
+G 0x0A g G
+H 0x0B h H
+I 0x0C i I
+J 0x0D j J
+K 0x0E k K
+L 0x0F l L
+M 0x10 m M
+N 0x11 n N
+O 0x12 o O
+P 0x13 p P
+Q 0x14 q Q
+R 0x15 r R
+S 0x16 s S
+T 0x17 t T
+U 0x18 u U
+V 0x19 v V
+W 0x1A w W
+X 0x1B x X
+Y 0x1C y Y
+Z 0x1D z Z
+1 0x1E 1 !
+2 0x1F 2 @
+3 0x20 3 #
+4 0x21 4 $
+5 0x22 5 %
+6 0x23 6 ^
+7 0x24 7 &
+8 0x25 8 *
+9 0x26 9 (
+0 0x27 0 )
+ENTER 0x28 Return
+ESC 0x29 Escape
+BACKSPACE 0x2A Backspace
+TAB 0x2B Tab
+SPACE 0x2C Space
+MINUS 0x2D - _
+EQUAL 0x2E = +
+LEFT_BRACE 0x2F [ {
+RIGHT_BRACE 0x30 ] }
+BACKSLASH 0x31 \ |
+EUROPE_1 0x32 Europe 1
+SEMICOLON 0x33 ; :
+QUOTE 0x34 ' "
+BACK_QUOTE 0x35 ` ~
+COMMA 0x36 , <
+PERIOD 0x37 . >
+SLASH 0x38 / ?
+CAPS_LOCK 0x39 Caps Lock
+F1 0x3A F1
+F2 0x3B F2
+F3 0x3C F3
+F4 0x3D F4
+F5 0x3E F5
+F6 0x3F F6
+F7 0x40 F7
+F8 0x41 F8
+F9 0x42 F9
+F10 0x43 F10
+F11 0x44 F11
+F12 0x45 F12
+PRINTSCREEN 0x46 Print Screen
+SCROLL_LOCK 0x47 Scroll Lock
+PAUSE 0x48 Pause
+INSERT 0x49 Insert
+HOME 0x4A Home
+PAGE_UP 0x4B Page Up
+DELETE 0x4C Delete
+END 0x4D End
+PAGE_DOWN 0x4E Page Down
+RIGHT 0x4F Right Arrow
+LEFT 0x50 Left Arrow
+DOWN 0x51 Down Arrow
+UP 0x52 Up Arrow
+NUM_LOCK 0x53 Num Lock
+PAD_SLASH 0x54 Keypad /
+PAD_ASTERIX 0x55 Keypad *
+PAD_MINUS 0x56 Keypad -
+PAD_PLUS 0x57 Keypad +
+PAD_ENTER 0x58 Keypad Enter
+PAD_1 0x59 Keypad 1 End
+PAD_2 0x5A Keypad 2 Down
+PAD_3 0x5B Keypad 3 PageDn
+PAD_4 0x5C Keypad 4 Left
+PAD_5 0x5D Keypad 5
+PAD_6 0x5E Keypad 6 Right
+PAD_7 0x5F Keypad 7 Home
+PAD_8 0x60 Keypad 8 Up
+PAD_9 0x61 Keypad 9 PageUp
+PAD_0 0x62 Keypad 0 Insert
+PAD_PERIOD 0x63 Keypad . Delete
+EUROPE_2 0x64 Europe 2
+APP 0x65 App
+POWER 0x66 Keyboard Power
+PAD_EQUALS 0x67 Keypad =
+F13 0x68 F13
+F14 0x69 F14
+F15 0x6A F15
+F16 0x6B F16
+F17 0x6C F17
+F18 0x6D F18
+F19 0x6E F19
+F20 0x6F F20
+F21 0x70 F21
+F22 0x71 F22
+F23 0x72 F23
+F24 0x73 F24
+EXECUTE 0x74 Keyboard Execute
+HELP 0x75 Keyboard Help
+MENU 0x76 Keyboard Menu
+SELECT 0x77 Keyboard Select
+STOP 0x78 Keyboard Stop
+AGAIN 0x79 Keyboard Again
+UNDO 0x7A Keyboard Undo
+CUT 0x7B Keyboard Cut
+COPY 0x7C Keyboard Copy
+PASTE 0x7D Keyboard Paste
+FIND 0x7E Keyboard Find
+MUTE 0x7F Keyboard Mute
+VOLUME_UP 0x80 Keyboard Volume Up
+VOLUME_DOWN 0x81 Keyboard Volume Dn
+LOCKING_CAPS_LOCK 0x82 Keyboard Locking Caps Lock
+LOCKING_NUM_LOCK 0x83 Keyboard Locking Num Lock
+LOCKING_SCROLL_LOCK 0x84 Keyboard Locking Scroll Lock
+PAD_COMMA 0x85 Keypad comma (Brazilian Keypad .)
+EQUAL_SIGN 0x86 Keyboard Equal Sign
+INTERNATIONAL_1 0x87 Keyboard Int'l 1 (Ro)
+INTERNATIONAL_2 0x88 Keyboard Intl'2 (Katakana/Hiragana)
+INTERNATIONAL_3 0x89 Keyboard Int'l 2 (Yen)
+INTERNATIONAL_4 0x8A Keyboard Int'l 4 (Henkan)
+INTERNATIONAL_5 0x8B Keyboard Int'l 5 (Muhenkan)
+INTERNATIONAL_6 0x8C Keyboard Int'l 6 (PC9800 Keypad comma)
+INTERNATIONAL_7 0x8D Keyboard Int'l 7
+INTERNATIONAL_8 0x8E Keyboard Int'l 8
+INTERNATIONAL_9 0x8F Keyboard Int'l 9
+LANG_1 0x90 Keyboard Lang 1 (Hanguel/English)
+LANG_2 0x91 Keyboard Lang 2 (Hanja)
+LANG_3 0x92 Keyboard Lang 3 (Katakana)
+LANG_4 0x93 Keyboard Lang 4 (Hiragana)
+LANG_5 0x94 Keyboard Lang 5 (Zenkaku/Hankaku)
+LANG_6 0x95 Keyboard Lang 6
+LANG_7 0x96 Keyboard Lang 7
+LANG_8 0x97 Keyboard Lang 8
+LANG_9 0x98 Keyboard Lang 9
+ALTERNATE_ERASE 0x99 Keyboard Alternate Erase
+SYSREQ_ATTN 0x9A Keyboard SysReq/Attention
+CANCEL 0x9B Keyboard Cancel
+CLEAR 0x9C Keyboard Clear
+PRIOR 0x9D Keyboard Prior
+RETURN 0x9E Keyboard Return
+SEPARATOR 0x9F Keyboard Separator
+OUT 0xA0 Keyboard Out
+OPER 0xA1 Keyboard Oper
+CLEAR_AGAIN 0xA2 Keyboard Clear/Again
+CRSEL_PROPS 0xA3 Keyboard CrSel/Props
+EXSEL 0xA4 Keyboard ExSel
+SYSTEM_POWER 0xA8 System Power
+SYSTEM_SLEEP 0xA9 System Sleep
+SYSTEM_WAKE 0xAA System Wake
+AUX1 0xAB Auxiliary key 1
+AUX2 0xAC Auxiliary key 2
+AUX3 0xAD Auxiliary key 3
+AUX4 0xAE Auxiliary key 4
+AUX5 0xAF Auxiliary key 5
+EXTRA_LALT 0xB1 AT-F extra pad lhs of space
+EXTRA_PAD_PLUS 0xB2 Term extra pad bottom of keypad +
+EXTRA_RALT 0xB3 AT-F extra pad rhs of space
+EXTRA_EUROPE_2 0xB4 AT-F extra pad lhs of enter
+EXTRA_BACKSLASH 0xB5 AT-F extra pad top of enter
+EXTRA_INSERT 0xB6 AT-F extra pad lhs of Insert
+EXTRA_F1 0xB7 122-key Terminal lhs F1
+EXTRA_F2 0xB8 122-key Terminal lhs F2
+EXTRA_F3 0xB9 122-key Terminal lhs F3
+EXTRA_F4 0xBA 122-key Terminal lhs F4
+EXTRA_F5 0xBB 122-key Terminal lhs F5
+EXTRA_F6 0xBC 122-key Terminal lhs F6
+EXTRA_F7 0xBD 122-key Terminal lhs F7
+EXTRA_F8 0xBE 122-key Terminal lhs F8
+EXTRA_F9 0xBF 122-key Terminal lhs F9
+EXTRA_F10 0xC0 122-key Terminal lhs F10
+EXTRA_SYSRQ 0xC2 Sys Req (AT 84-key)
+FN1 0xD0 Function layer key 1
+FN2 0xD1 Function layer key 2
+FN3 0xD2 Function layer key 3
+FN4 0xD3 Function layer key 4
+FN5 0xD4 Function layer key 5
+FN6 0xD5 Function layer key 6
+FN7 0xD6 Function layer key 7
+FN8 0xD7 Function layer key 8
+SELECT_0 0xD8 Select reset
+SELECT_1 0xD9 Select 1 toggle
+SELECT_2 0xDA Select 2 toggle
+SELECT_3 0xDB Select 3 toggle
+SELECT_4 0xDC Select 4 toggle
+SELECT_5 0xDD Select 5 toggle
+SELECT_6 0xDE Select 6 toggle
+SELECT_7 0xDF Select 7 toggle
+LCTRL 0xE0 Left Control
+LSHIFT 0xE1 Left Shift
+LALT 0xE2 Left Alt
+LGUI 0xE3 Left GUI
+RCTRL 0xE4 Right Control
+RSHIFT 0xE5 Right Shift
+RALT 0xE6 Right Alt
+RGUI 0xE7 Right GUI
+MEDIA_NEXT_TRACK 0xE8 Scan Next Track
+MEDIA_PREV_TRACK 0xE9 Scan Previous Track
+MEDIA_STOP 0xEA Stop
+MEDIA_PLAY_PAUSE 0xEB Play/ Pause
+MEDIA_MUTE 0xEC Mute
+MEDIA_BASS_BOOST 0xED Bass Boost
+MEDIA_LOUDNESS 0xEE Loudness
+MEDIA_VOLUME_UP 0xEF Volume Up
+MEDIA_VOLUME_DOWN 0xF0 Volume Down
+MEDIA_BASS_UP 0xF1 Bass Up
+MEDIA_BASS_DOWN 0xF2 Bass Down
+MEDIA_TREBLE_UP 0xF3 Treble Up
+MEDIA_TREBLE_DOWN 0xF4 Treble Down
+MEDIA_MEDIA_SELECT 0xF5 Media Select
+MEDIA_MAIL 0xF6 Mail
+MEDIA_CALCULATOR 0xF7 Calculator
+MEDIA_MY_COMPUTER 0xF8 My Computer
+MEDIA_WWW_SEARCH 0xF9 WWW Search
+MEDIA_WWW_HOME 0xFA WWW Home
+MEDIA_WWW_BACK 0xFB WWW Back
+MEDIA_WWW_FORWARD 0xFC WWW Forward
+MEDIA_WWW_STOP 0xFD WWW Stop
+MEDIA_WWW_REFRESH 0xFE WWW Refresh
+MEDIA_WWW_FAVORITES 0xFF WWW Favorites Deprecated Code Names v1.0+
+
+
+They are included for compatibility with older config files written for v0.997.
+Replacements for these names have been added beginning 'EXTRA_'.
+(As in, the change is just in the names of these codes).
+
+
+
+
+Name HID Code Description
+FAKE_01 0xB0 extra
+FAKE_02 0xB1 AT-F extra pad lhs of space
+FAKE_03 0xB2 Term extra pad bottom of keypad +
+FAKE_04 0xB3 AT-F extra pad rhs of space
+FAKE_05 0xB4 AT-F extra pad lhs of enter
+FAKE_06 0xB5 AT-F extra pad top of enter
+FAKE_07 0xB6 AT-F extra pad lhs of Insert
+FAKE_08 0xB7 Term F1
+FAKE_09 0xB8 Term F2
+FAKE_10 0xB9 Term F3
+FAKE_11 0xBA Term F4
+FAKE_12 0xBB Term F5
+FAKE_13 0xBC Term F6
+FAKE_14 0xBD Term F7
+FAKE_15 0xBE Term F8
+FAKE_16 0xBF Term F9
+FAKE_17 0xC0 Term F10
+FAKE_18 0xC1 extra
+FAKE_19 0xC2 Sys Req (AT 84-key) Modifiers
+
+
+Depending on context, a combination might mean 'any' or 'all' of the specified modifiers.
+
+
+
+Name Description
+LCTRL Left Control
+LSHIFT Left Shift
+LALT Left Alt
+LGUI Left GUI
+RCTRL Right Control
+RSHIFT Right Shift
+RALT Right Alt
+RGUI Right GUI
+CTRL Either/Both Control (shorthand for LCTRL RCTRL)
+SHIFT Either/Both Shift (shorthand for LSHIFT RSHIFT)
+ALT Either/Both Alt (shorthand for LALT RALT)
+GUI Either/Both GUI (shorthand for LGUI RGUI)
+ALL Any/All (shorthand for CTRL SHIFT ALT GUI)
+
diff --git a/docs/config.html b/docs/config.html
new file mode 100644
index 0000000..9ff7236
--- /dev/null
+++ b/docs/config.html
@@ -0,0 +1,258 @@
+
+
+
+Config v0.997+
+
+
+
+
+
+
+Overview
+
+
+
+ Command Reference
+
+
+force
+
+force
command disables the auto-detection of keyboard type. It is only very rarely needed!
+force {set1|set2|set3|set2ext}
+
+
+force set2
+
include
+
+include
command processes another file, exactly as if it was copy-pasted to where the include command is.
+include <file_name>
+
+
+include "colemak.sc"
+
ifselect
+
+ifselect
command and defining remaps or macros that output the SELECT_0 to SELECT_7 codes.
+ifselect {<select_num> | any}
+
ifselect
commands choose which blocks will be applied.
+When the converter powers-up, all selects, except select 0, are inactive.
+Multiple selects can be active at a time.
+Select 0 is special - it is always active, and when SELECT_0 is output it resets all the other selects.
+ifselect <select_num>
, up to the next ifselect
, are applied only if the specified select is active.ifselect any
, up to the next ifselect
, are applied regardless of which selects are active.
+
+# toggle between qwerty and colemak by pressing scroll lock
+
+ifselect 1
+include colemak.sc
+
+ifselect any
+remapblock
+ SCROLL_LOCK SELECT_1
+endblock
+
ifset
+
+ifset
command are only applied if using one of the specified sets.
+ifset [set1] [set2] [set3] [set2ext] [any]
+
+
+ifset set1 set2
+
ifkeyboard
+
+ifkeyboard
command are only applied if the keyboard has the specified ID.
+
+ifkeyboard {<keyboard_id> | any}
+
+
+ifkeyboard BABA
+
layerblock
+
+
+layerblock
+ <fn_key_combo> <layer_num>
+ ...
+endblock
+
+
+layerblock
+ FN1 1
+ FN2 1
+ FN1 FN2 2
+endblock
+
+remapblock
+ LGUI FN1
+ RGUI FN2
+endblock
+
remapblock
+
+layer
command is given inside the block.
+remapblock
+ [layer <layer_num>]
+ <from_hid> <to_hid>
+ ...
+endblock
+
+
+# swap capslock and backspace
+
+remapblock
+ CAPS_LOCK BACKSPACE
+ BACKSPACE CAPS_LOCK
+endblock
+
macroblock
+
+
+
+macroblock
+ macro <hid> [[-][{l|r}]shift] [[-][{l|r}]ctrl] [[-][{l|r}]alt] [[-][{l|r}]gui] ...
+ [
+ <command> [<value>]
+ ...
+ ]
+ [onbreak [norestoremeta]
+ <command> [<value>]
+ ...
+ ]
+ endmacro
+ ...
+endblock
+
+
+macroblock
+ macro SCROLL_LOCK LSHIFT LCTRL -ALT
+ PUSH_META CLEAR_META all # save and clear all metas
+ PRESS p # press some keys...
+ PRESS i
+ PRESS N # case is ignored - this results in lowercase 'n'
+ SET_META lshift # you have to set modifiers yourself
+ PRESS g # results in a capital 'G', since shift is set
+ POP_ALL_META # restore metas that were active before
+ endmacro
+endblock
+
Macro Commands
+
+
+
+
+
+Command Description
+NOP Does nothing
+PRESS <hid> Shorthand for MAKE <hid> then BREAK <hid>
+MAKE <hid> Set keystate to 'down'
+BREAK <hid> Set keystate to 'up'
+ASSIGN_META <metas> Set all metas to the state specified
+SET_META <metas> Set specified metas to down state
+CLEAR_META <metas> Set specified metas to up state
+TOGGLE_META <metas> Set specified metas to inverse of current state
+POP_META Restore metas from the time of the last PUSH_META
+POP_ALL_META Restore metas from the time of the first PUSH_META
+DELAY <delay_in_ms> Delay by the specified number of milliseconds
+CLEAR_ALL (internal use e.g. when buffer overrun is received)
+BOOT Cause the converter to jump to the bootloader v1.0+
+PUSH_META <cmd> <value> Save metas for later. Combines with other commands Macro trigger matching
+
+
+If a particular meta is not specified, its state is not matched.
+
+
+
+
+Meta Trigger condition
+LSHIFT LSHIFT is pressed
+RSHIFT RSHIFT is pressed
+SHIFT Either LSHIFT or RSHIFT is pressed
+-LSHIFT LSHIFT is not pressed
+The first matching macro found (if any) is executed, so you sometimes need to take of what order the macros are in.
+
+macroblock
+ macro SCROLL_LOCK LSHIFT # this macro will execute even if LCTRL is down, so...
+ ...
+ endmacro
+ macro SCROLL_LOCK LSHIFT LCTRL # ... this macro will never execute!
+ ...
+ endmacro
+endblock
+
+
+macroblock
+ macro SCROLL_LOCK LSHIFT LCTRL
+ ...
+ endmacro
+ macro SCROLL_LOCK LSHIFT
+ ...
+ endmacro
+endblock
+
+
diff --git a/docs/configquickref.html b/docs/configquickref.html
new file mode 100644
index 0000000..428a24d
--- /dev/null
+++ b/docs/configquickref.html
@@ -0,0 +1,69 @@
+
+
+
+Config Quick Reference v0.997+
+
+
+
+# This is a comment.
+
+
+force {set1|set2|set3|set2ext}
+
+
+include <file_name>
+
+The blocks following a conditional are only applied if...
+
+ifselect {<select_num> | any} # specified select is active.
+ifset [set1] [set2] [set3] [set2ext] [any] # using one of the specified sets.
+ifkeyboard {<keyboard_id> | any} # keyboard has the specified ID.
+
+(Function keys are defined by remapping one or more keys to pseudo-HID codes FN1 to FN8).
+
+layerblock
+ <fn_key_combo> <layer_num>
+ ...
+endblock
+
+
+remapblock
+ [layer <layer_num>]
+ <from_hid> <to_hid>
+ ...
+endblock
+
+macroblock
+ macro <hid> [[-][{l|r}]shift] [[-][{l|r}]ctrl] [[-][{l|r}]alt] [[-][{l|r}]gui] ...
+ [
+ <command> [<value>]
+ ...
+ ]
+ [onbreak [norestoremeta]
+ <command> [<value>]
+ ...
+ ]
+ endmacro
+ ...
+endblock
+
+
diff --git a/docs/firmware.html b/docs/firmware.html
new file mode 100644
index 0000000..634d53d
--- /dev/null
+++ b/docs/firmware.html
@@ -0,0 +1,57 @@
+
+
+
+Firmware
+
+
+
+
+
+CPUs
+
+
+
+CPU Known breakout board(s)
+ATmega32U4 Teensy 2.0, Adafruit Atmega32u4 Breakout Board
+AT90USB1286 Teensy++ 2.0
+AT90USB646 v1.0+ Teensy++ (no longer available)
+ATmega16U4 v1.0+ ???
Make sure you pick the right .hex file for your dev board!
+ +ATmega32U4 breakout boards are usually the best choice, on a price basis.
+ +AT90USB1286 boards work equally as well, and have more memory (which can be essential if you want to set up a very large number of layers and/or macros), but cost more.
+ +Note: the ATmega16U4 build is very close to 16KB in size, and probably does not leave room for a USB bootloader on the chip.
+So, ATmega16U4 based breakout boards are not recommended for novices!
+The Teensy family have the PJRC bootloader installed and are programmed using PJRC's Teensy Loader, available for all common OS. +
+
+Other breakout boards usually have the Atmel DFU bootloader installed and can be programmed using FLIP.
+FLIP is available for Windows and Linux. For Mac OS-X, see this guide on how use DFU-programmer.
+
+Arduino Leonardo can be programmed using avrdude, or the Arduino IDE. +
+Essential items:
+Optional items, as desired:
+You could, of course, mount the Teensy inside your keyboard and not even need a connector or a box!
+ +See the firmware section for details of supported AVR processors and breakout boards.
+ + +Connector | Breakout board |
---|---|
GND | GND |
Vcc/+5V | VCC |
Data | PD0 |
Clock | PD1 |
Keyboard Reset v1.1+ | PB7 |
See PJRC for Teensy pinouts, or the documentation that came with your chosen breakout board.
+'Keyboard Reset' is only required for certain PC/XT-like keyboards, such as the Leading Edge DC-2014.
+ + +I wired mine to a PS/2 socket, and then use adapters to connect the others.
+ +kbdbabel has masses of connector info. +So much, that it can be hard to find the one you want!
+ +So I've included the most common connectors used with this converter here.
+ +Note that all the connectors are shown looking into the socket.
PC/XT keyboards use a 5 pin, 180 degree, DIN connector. It is the same as the AT connector shown later, except + that pin 3 is defined as a reset signal...
+
+ (from the IBM PC Technical Reference Manual, with correction!)
Terminal keyboards usually have a 5 pin, 270 degree, DIN connector...
+
...or sometimes this 8P5C connector...
+
PC, XT and AT keyboards use the same 5 pin, 180 degree, DIN connector and pinout,
+while PS/2 keyboards use a 6 pin mini-DIN connector...
+
In nearly all cases, these resistors are not needed.
+But, if the keyboard has a very long cable (3m+), I recommend adding two pull-up resistors of 1Kohm - +one between Clock and +5V, the other between Data and +5V. +These can really help to clean up a dirty signal +(see here).
+ + +Optionally, lock LEDs can be wired up. Useful if your keyboard doesn't have them!
+The outputs are active high (each pin puts out +5V when it wants to light the LED).
+A resistor is needed inline with each LED. (The value needed depends on the type of LED,
+1Kohm is a good starting point for modern high-brightness types).
Here's an example circuit for hooking up an LED, taken from
+ ladyada.net:
+
+ They also have a more in-depth tutorial.
The pins used differ between CPUs.
+ +ATMEGA32U4 (Teensy 2.0) and ATMEGA16U4:
+LED | CPU Pin |
---|---|
CapsLock | PF5 |
NumLock | PF6 |
ScrollLock | PF7 |
AT90USB1286 (Teensy++ 2.0) and AT90USB646:
+LED | CPU Pin |
---|---|
CapsLock | PD3 |
NumLock | PD4 |
ScrollLock | PD5 |
Five inputs are provided for auxiliary keys, buttons, or footswitches, which generate codes that can be remapped in your config:
+Auxiliary Key | Code | CPU Pin |
---|---|---|
1 | AUX1 | PB0 |
2 | AUX2 | PB1 |
3 | AUX3 | PB2 |
4 | AUX4 | PB3 |
5 | AUX5 | PB4 |
Inputs cause key presses when grounded, so you can simply connect the switch between the pin and ground:
+ + +Inputs have the internal pull-up enabled, so an external resistor won't be required in most cases. But + it might be necessary to use one, for example with footswitches where the wires are long. Here's how + you would wire one up:
+
+ + +The GND and Vcc pins at the end of the Teensy can be used instead of the marked GND and Vcc, if you prefer. + Or you might choose to wire the connector to one GND and the LEDs using the other.
+ +Of course, not all connections are required! The minimum, and still fairly typical, setup would be to connect + just Ground, +5V, Data and Clock to the connector (or keyboard).
+ +v1.10
+
v1.03
+
v1.02
+
v1.01
+
v1.0 - details
+
v0.997
+
v0.996
+
v0.995
+
v0.994
+
v0.992
+
v0.99
+
A Teensy-based project to adapt XT, AT, PS/2 and some 122-key terminal keyboards to USB, also known simply as "Soarer's Converter".
+ +Keyboard protocols supported:
+Configurable Features: v0.997+
+Other Features:
+Way back in 2010, a Teensy landed on my doormat.
+ +My goal then was simply "to make a USB adapter for my AT model F".
+ +Why? I had modified the keyboard, and existing PS/2 to USB adapters didn't support the unusual codes created by the extra key positions.
+ +A few months later, the first release was made available on geekhack, in my project thread.
+ +On the release of v1.0, I also made it available on Deskthority.
+ +I guess I got a little carried away :-)
+ +The main tools are scas and scwr.
+ +Typically, you edit your config file(s), assemble them with scas, +then load them onto the converter with scwr.
+As long as it says 'device: complete' at the end, scwr has succeeded.
+ +C:\sctools> scas foo.sc foo.scb
+No errors. Wrote: foo.scb
+
+C:\sctools> scwr foo.scb
+Looking for Soarer's Converter: found
+...
+device: complete
+
+On Windows, you may find scaswr more convenient. It simply combines the two steps.
+ + ++
Tool | Description |
---|---|
scas | Assembles one or more config text files to a config binary file |
scdis | Dissassembles a config binary file to a config text file |
scwr | Writes a config binary file to the converter |
scrd | Reads a config binary file from the converter |
scboot | Causes the converter to jump to the bootloader v1.0+ |
scinfo | Displays converter's version and memory information v1.0+ |
scaswr | Combination of scas and scwr (Windows only) v1.1+ |
Assembles one or more config text files to a config binary file.
+ +Usage:
+scas <text_config> [<text_config> ...] <binary_config>
+
+Output, if everything is fine:
+No errors. Wrote: foo.scb
+
+Output, if there's an error:
+error at line 4: invalid argument
+
+Output, if there's an error in an included file in an included file:
+error at line 4: error at line 5: error at line 5: invalid argument
+
+To find the error, start with the last line number given, which will be an include command.
+Then look in that file for the next to last line number given, and so on.
+The first line number given is where the actual error is.
Only the first error found is reported.
+ +Alternatively, check that included files assemble successfully on their own, before including into another config.
+ +Dissassembles a config binary file to a config text file.
+ +Usage:
+scdis <binary_config> [<text_config>]
+
+There is no output unless an error occurs.
+ +This tool might be useful to validate that your config assembles as you expected (it was very useful while I was writing scas).
+ +Writes a config binary file to the converter.
+Usage:
+scwr <binary_config>
+
+Output:
+scwr: looking for Soarer's Converter: found
+scwr: reading file: 139 bytes: ok
+scwr: sending info request: ok
+device: ok
+protocol version check: converter=1.00, scwr=1.00: ok
+settings version check: converter=1.01, file=1.01: ok
+settings length check: max=1018, file=137 bytes: ok
+scwr: sending write request for 137 bytes: ok
+device: ok
+device: ready
+scwr: sending 60 bytes: ok
+device: ok
+device: ready
+scwr: sending 60 bytes: ok
+device: ok
+device: ready
+scwr: sending 17 bytes: ok
+device: ok
+device: complete
+
+
+Reads a config binary file from the converter.
+Usage:
+scrd <binary_config>
+
+Output:
+scrd: looking for Soarer's Converter: found
+scrd: sending read request: ok
+device: has 137 bytes: ok
+scrd: ready
+device: sent 64 bytes: ok
+scrd: ok
+scrd: ready
+device: sent 64 bytes: ok
+scrd: ok
+scrd: ready
+device: sent 9 bytes: ok
+scrd: ok
+scrd: complete
+scrd: writing file: 139 bytes: ok
+
+
+Causes the converter to jump to the bootloader.
+Usage:
+scboot
+
+After running this command, the converter should be ready to have new firmware loaded into it. +Note that, at this point, the converter will not be working as a keyboard any more! +To cancel the bootloader mode, simply disconnect the converter from the computer and reconnect it.
+Output:
+scboot: looking for Soarer's Converter: found
+scboot: sending boot request: ok
+device: ok
+
+
+Displays converter's version and memory information.
+Usage:
+scinfo
+
+Output:
+Code Version: v1.00
+Max Settings Version: v1.01
+Current Settings Version: v1.01
+SRAM Size: 2560 bytes
+SRAM Free: 1817 bytes
+EEPROM Size: 1024 bytes
+EEPROM Free: 883 bytes
+
+
+A combination of scas and scwr, designed so you can simply drag'n'drop a config file onto it (or a shortcut to it). + It will assemble the text config and then write the resulting binary config to the converter, in a single step.
+Of course, it can also be used from the command line...
+Usage:
+scaswr <text_config>
+
+
+
+Source code is provided, along with makefiles etc., to natively build on Windows, Linux and OS-X.
+Additionally, a mingw32 cross-compile can be used to build the Windows tools on Linux.
To rebuild the tools, change directory to the sub-directory of build that's right for your OS, and type make.
+ +The tools are built for Windows using MS Visual Studio 2003. Porting to later versions should be trivial.
+ +scwr, scrd, scboot and scinfo rely on a small library of RAWHID routines from PJRC.
+For Windows, this library was compiled to a DLL using the Microsoft DDK.
The tools are built for Linux using gcc etc.
+ +The tools are built for Mac OS-X on Snow Leopard using Xcode 3.2.6 and the version 10.6 SDK.
+ +The converter outputs some cryptic diagnostic information when in use - +it's especially useful to see what is happening when it starts up.
+ +The hid_listen +program (from PJRC) can display this output, +which mostly just consists of bytes read from and written to the keyboard when +things are working correctly.
+ +Most of the output takes the form of a prefix code, followed by a hex value, followed by a space. For example, 'r4A '.
+ +Prefixes used:
++
Prefix | Description |
---|---|
r | byte read from keyboard |
w | byte written to keyboard |
R | read error |
W | write error |
+ | HID code output from first translation stage (for key-press) |
- | HID code output from first translation stage (for key-release) |
d | HID code output (for key-press) v1.03+ |
u | HID code output (for key-release) v1.03+ |
Error codes:
++
Code | Error | Description |
---|---|---|
R03 | unknown | something bad happened! |
R04 | clock | missed one edge of the clock signal, usually because of a short spike |
R05 | timeout | started receiving clock from the board, but didn't receive enough for a full code |
R06 | start bit | read a start bit, but it was incorrect |
R07 | parity bit | failed to correctly read a parity bit |
R08 | stop bit | failed to correctly read a stop bit |
W005 | timeout | timeout while writing a command to the keyboard |
W105 | timeout | timeout while writing the first byte of a 2-byte command |
W205 | timeout | timeout while writing the second byte of a 2-byte command |
Usually, if you get error codes right after building your converter, it's because the wiring is incorrect. +One fairly common error is to read the socket pinout diagrams backwards - +they are drawn looking at the front of the socket, not the back.
+ + +As a side-project, I've posted a +Simple Logic Analyzer on Deskthority. This can help to diagnose wiring problems or incompatibilities quickly and simply, +whereas before you might've had to resort to trial and error, risking damage to the Teensy in the process.
+ + ++This section is mostly only relevant to terminal keyboards. The converter uses the ID to decide between using scan code set 3 for terminal keyboards, or extended scan code set 2 for 'regular' keyboards. +
+By using hid_listen, you can see what ID your keyboard has by looking at the two bytes read back after the get ID command (wF2 rFA). +
+The ID and scan code set selected are also printed in a more readable way: v0.996+ +
+Keyboard ID: BFBF
+Code Set: 3
++Terminal keyboards often have DIP switches on the back panel, or alternatively a pin header on the PCB that you can fit jumpers to, which configure the keyboard's ID code. The ID is a 16-bit number, but commonly fewer than 16 switches/jumpers are fitted meaning it's not possible to select all of the bits. The default value with no jumpers fitted, or with all the DIP switches in the 'open' position, is BFBF. +
+If your terminal keyboard is not operating correctly, it might be because the wrong ID is set on the switches/jumpers. The first byte should not be AB. + + +