tmk_keyboard/converter/pc98_usb/README.md

88 lines
2 KiB
Markdown
Raw Normal View History

2013-02-23 01:15:03 +09:00
PC98 to USB keyboard protocol converter
=======================================
2023-06-13 15:32:40 +09:00
TMK Keyboard protocol converter for NEC PC-9801 series that allows you to use PC-9801 keyboard on modern USB PC.
2013-02-22 09:53:46 +09:00
2023-06-13 15:32:40 +09:00
Main target is TMK prebuilt converter(ATMega32u2) but it will work on dev boards with ATMega32u4.
2013-02-22 09:53:46 +09:00
2021-09-18 09:10:28 +09:00
You can buy [TMK prebuilt converter](https://geekhack.org/index.php?topic=72052.0) here to support this project.
2021-09-18 09:10:28 +09:00
Discuss or report issue on github or [this thread](https://geekhack.org/index.php?topic=110094.0).
2023-06-13 15:32:40 +09:00
See [this wiki page](https://github.com/tmk/tmk_keyboard/wiki/PC-9801-Keyboard) for PC98 keyboard technical infos.
2013-02-23 01:15:03 +09:00
Connector
---------
2018-07-23 09:53:35 +09:00
On host/converter:
2013-02-22 09:53:46 +09:00
2013-02-23 01:15:03 +09:00
8Pin mini DIN
___ ___
/ |_| \
/ 8 7 6 \
| 5 4 3 |
\_ 2 1 _/
2018-06-07 17:29:13 +09:00
\_____/
2013-02-23 01:15:03 +09:00
(receptacle)
2013-02-22 09:53:46 +09:00
2023-06-13 15:32:40 +09:00
Pin mini DIN AVR Pins
2013-02-22 09:53:46 +09:00
----------------------------------
2014-04-25 15:16:12 +09:00
1 ~RST(TXD) PD3
2013-02-22 09:53:46 +09:00
2 GND GND
2013-02-23 01:15:03 +09:00
3 ~RDY PD4
4 RXD PD2
5 ~RTY PD1
2018-06-07 17:29:13 +09:00
6 NC
7 NC
2013-02-22 09:53:46 +09:00
8 5V VCC
2013-02-23 01:15:03 +09:00
2020-12-09 13:16:03 +09:00
Prebilt Firmware
----------------
Prebuilt firmware HEX files are available under 'binary' directory.
2013-02-22 09:53:46 +09:00
Build Firmware
--------------
2023-06-13 15:32:40 +09:00
### TMK PC98 Converter
2020-12-09 13:16:03 +09:00
Just use 'make' to bild firmware for TMK PC98 converter(ATMega32u2).
2013-02-23 01:15:03 +09:00
2018-07-23 09:53:35 +09:00
$ make clean
2013-02-22 09:53:46 +09:00
$ make
2013-02-23 01:15:03 +09:00
2020-12-09 13:16:03 +09:00
To flash firmware run this command
2018-07-23 09:53:35 +09:00
$ make dfu
then push button on the converter to flash firmware.
2018-07-23 09:53:35 +09:00
2023-06-13 15:32:40 +09:00
### Ohter boards
2020-12-09 13:16:03 +09:00
If you are using ATMega32u4 based board use following commands to get firmware HEX file.
2018-09-08 09:34:50 +09:00
$ make -f Makefile.32u4 clean
$ make -f Makefile.32u4
2020-12-09 13:16:03 +09:00
And flash it on your board using specific program method.
2018-09-08 09:34:50 +09:00
2018-07-23 09:53:35 +09:00
Raku Raku keyboard support
--------------------------
2023-06-13 15:32:40 +09:00
This is not supported actively anymore.
2018-07-23 09:53:35 +09:00
NEC PC-9801-98-S02 - raku raku keyboard:
https://deskthority.net/photos-f62/nec-pc-9801-98-s02-t5212.html
To build firmware for the keyboard
$ make KEYMAP=rakuraku clean
$ make KEYMAP=rakuraku
$ make KEYMAP=rakuraku dfu
2023-06-13 15:32:40 +09:00
Its scan code map is very different from standard types.
See `unimap_trans.h` and `unimap_rakuraku.c`.