converter/pc98_usb/README

   1 PC98 to USB keyboard protocol converter
   2 =======================================
   3 Target MCU is ATMega32u2 but other USB capable AVR will also work.
   4
   5
   6 Connector
   7 ---------
   8 On host/converter:
   9
  10     8Pin mini DIN
  11        ___ ___
  12       /  |_|  \
  13      / 8  7  6 \
  14     | 5    4  3 |
  15      \_ 2   1 _/
  16        \_____/
  17      (receptacle)
  18
  19
  20 Wiring: You can change this with editing config.h.
  21
  22     Pin mini DIN        MCU
  23     ----------------------------------
  24     1  ~RST(TXD)        PD3
  25     2   GND             GND
  26     3  ~RDY             PD4
  27     4   RXD             PD2
  28     5  ~RTY             PD1
  29     6   NC
  30     7   NC
  31     8   5V              VCC
  32
  33
  34
  35
  36 Protocol
  37 --------
  38 Signal: Asynchronous, Positive logic, 19200baud, Least bit first
  39 Frame format: 1-Start bit(Lo), 8-Data bits, Odd-Parity, 1-Stop bit
  40
  41
  42
  43 Build Firmware
  44 --------------
  45 Just use 'make' to bild firmware
  46
  47     $ make clean
  48     $ make
  49
  50 To flash firmware
  51
  52     $ make dfu
  53
  54 then push button on converter to flash firmware.
  55
  56
  57
  58 PC98 Scan Codes
  59 ---------------
  60     ,---. ,---. ,------------------------. ,------------------------. ,------------------------.
  61     |Pau| |PrS| | F1 | F2 | F3 | F4 | F5 | | F6 | F7 | F8 | F9 | F10| | F11| F12| F13| F14| F15|
  62     `---' `---' `------------------------' `------------------------' `------------------------'
  63     ,-------------------------------------------------------------. ,-------.  ,---------------.
  64     | Esc|  1|  2|  3|  4|  5|  6|  7|  8|  9|  0|  -|  =|JPY|Bspc| |Ins|Del|  |Hom|End|  -|  /|
  65     |-------------------------------------------------------------| |-------|  |---------------|
  66     | Tab  |  Q|  W|  E|  R|  T|  Y|  U|  I|  O|  P|  [|  ]|      | |PgD|PgU|  |  7|  8|  9|  *|
  67     |-------------------------------------------------------`Enter| |-------|  |---------------|
  68     |Ctl|Cap|  A|  S|  D|  F|  G|  H|  J|  K|  L|  ;|  '|  \|     | |  Up   |  |  4|  5|  6|  +|
  69     |-------------------------------------------------------------| |-------|  |---------------|
  70     | Shift   |  Z|  X|  C|  V|  B|  N|  M|  ,|  .|  /| RO| Shift | |Lef|Rig|  |  1|  2|  3|  =|
  71     `-------------------------------------------------------------' |-------|  |---------------|
  72      ^3|Kana|Gui|Alt|MHEN|       Space        |HENK|Alt|Gui|App|^2  | Down  |  |  0|  ,|  .| ^1|
  73        `-------------------------------------------------------'    `-------'  `---------------'
  74     ^1: Enter on keypad is identical to Enter on alphanumeric portion.
  75     ^2: Right Alt is ALT on DIGITAL WAVE Dboard while Menu on PC-9821 keyboard.
  76         App is HOME key on PC98XL keyboard.
  77     ^3: Caps and Kana are locking keys, either mechanically or by firmware emulation.
  78
  79
  80     ,---. ,---. ,------------------------. ,------------------------. ,------------------------.
  81     | 60| | 61| | 62 | 63 | 64 | 65 | 66 | | 67 | 68 | 69 | 6A | 6B | | 52 | 53 | 54 | 55 | 56 |
  82     `---' `---' `------------------------' `------------------------' `------------------------'
  83     ,-------------------------------------------------------------. ,-------.  ,---------------.
  84     | 00 | 01| 02| 03| 04| 05| 06| 07| 08| 09| 0A| 0B| 0C| 0D| 0E | | 38| 39|  | 3E| 3F| 4D| 41|
  85     |-------------------------------------------------------------| |-------|  |---------------|
  86     |  0F  | 10| 11| 12| 13| 14| 15| 16| 17| 18| 19| 1A| 1B|      | | 36| 37|  | 42| 43| 44| 45|
  87     |-------------------------------------------------------`  1C | |-------|  |---------------|
  88     | 74| 71| 1D| 1E| 1F| 20| 21| 22| 23| 24| 25| 26| 27| 28|     | |   3A  |  | 46| 47| 48| 49|
  89     |-------------------------------------------------------------| |-------|  |---------------|
  90     |   70    | 29| 2A| 2B| 2C| 2D| 2E| 2F| 30| 31| 32| 33| 70/7D | | 3B| 3C|  | 4A| 4B| 4C| 4D|
  91     `-------------------------------------------------------------' |-------|  |---------------|
  92        | 72 | 77| 73| 51 |        34          | 35 | 79| 78| 5E|    |   3D  |  | 4E| 4F| 50| 1C|
  93        `-------------------------------------------------------'    `-------'  `---------------'
  94     5E: HOME on PC98XL keyboard
  95     79: ALT on DIGITAL WAVE Dboard
  96     77,78,79: Left Win, right Win and Application on PC-9821 keyboard
  97
  98
  99
 100 PC98 keyboard commands
 101 ----------------------
 102 http://www.webtech.co.jp/company/doc/undocumented_mem/io_kb.txt
 103
 104 response from keyboard:
 105     FAh: ACK
 106     FCh: NACK
 107
 108 Inhibit repeating key:
 109     9Ch, 70h
 110
 111 LED control:
 112     9Dh 7xh
 113
 114     second byte:
 115     0111 xxxx
 116          |||`- NumLock
 117          ||`-- ?
 118          |`--- CapsLock
 119          `---- Kana
 120
 121 Enabling Win and App key on PC-9821 keyboard:
 122     95h, 03h
 123
 124
 125
 126 Raku Raku keyboard support
 127 --------------------------
 128 NEC PC-9801-98-S02 - raku raku keyboard:
 129 https://deskthority.net/photos-f62/nec-pc-9801-98-s02-t5212.html
 130
 131 To build firmware for the keyboard
 132
 133     $ make KEYMAP=rakuraku clean
 134     $ make KEYMAP=rakuraku
 135     $ make KEYMAP=rakuraku dfu
 136
 137 Its scan code map is very different from standard types. This is not tested.
 138
 139
 140
 141 Other PC98 converter projects and resource
 142 ------------------------------------------
 143 PC-9800シリーズ テクニカルデータブック HARDWARE 編 1993年 p139, p343
 144 https://archive.org/stream/PC9800TechnicalDataBookHARDWARE1993/PC-9800TechnicalDataBook_HARDWARE1993#page/n355
 145
 146 PC98 to USB
 147 http://davy.nyacom.net/kbd98usb/
 148
 149 PC98 to PS/2
 150 http://www.tsp.ne.jp/~sawada/mago/c_gka98at.htm
 151 http://www.tsp.ne.jp/~sawada/mago/src/gka98at.asm
 152
 153 scan code:
 154 http://ixsvr.dyndns.org/usb2pc98