qmk_firmware/keyboards/converter/ibm_5291/readme.md
listofoptions 4ebd27002a Keyboard: 5291 firmware to replace the existing soarers controller firmware (#4483)
* compiles but is not working

* still testing 5291

* compiles but is not working

* still testing 5291

* fixed a but in the layout (reversed key order in row)

* compiles but is not working

* still testing 5291

* fixed a but in the layout (reversed key order in row)

* fixed some issues

* doumentation needed

* doumentation needed

* documentation needed

* documentation needed

* Update readme.md

documentation

* Update readme.md

i dislike markdown <_>

* merge preperation
2018-11-26 09:53:49 -08:00

70 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# IBM 5291 keyboard converter
![5291](https://deskthority.net/wiki/IBM_Model_F#IBM_5291_Keyboard)
A converter for the eponymous keyboard.
Keyboard Maintainer: [Listofoptions](https://github.com/listofoptions)
Hardware Supported: IBM 5291, Teensy 2.0
Make example for this keyboard (after setting up your build environment):
make converter/ibm_5291:default
See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs).
the pinout is as follows:
IBM5291Cable to Pinhead14
| pin | description
----|------------------------
1 | GND
2 | NC
3 | GND
4 | GN)
5 | +5V
6 | D0
7 | D1
8 | D2
9 | D3
10| D4
11| D5
12| D6
13| Strobe
14| Out
the pins on this connector are organized ![here](https://geekhack.org/index.php?action=dlattach;topic=48950.0;attach=36759;image)
IBM52912 Cable with DB15M connector
| pin | description
----|-------------
|1,2,3 | GND
|4 | +5V
|5 | D0
|6 | D1
|7 | D2
|8 | D3
|9 | D4
|10 | D5
|11 | D6
|12 | Strobe
|13 | Out
|14 | PE
|15 | NC
the above connector is actually numbered so it should be easier to determine
where the needed connections are.
to connect to the teensy, the following are pins are needed (if you should choose not set your own):
* PB0 -> PB6 are connected to D0 -> D6
* +5V is connected to the corresponding teensy pin
* gnd is as well, only one of the gnd pins needs to be connected though.
* strobe is connected to pin PD1
* data is connected to PD0
* PE does not need to be connected to anything, but it could also be connected to gnd
sources:
http://www.retrocomputing.eu/documents/5291_MaintenanceLibrary.pdf