---------
CLOCK is always from KEYBOARD. DATA are sent with MSB first.
-1) IDLE: both line is high.
+1) IDLE: both lines are high.
CLOCK ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
DATA ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3) HOST->KEYBOARD: HOST asserts bit on falling edge.
CLOCK ~~~~~~~~~~~~|__|~~~|__|~~~|__|~~~|__|~~~|__|~~~|__|~~~|__|~~~|__|~~~~~~~~~~~
DATA ~~~~~~|_____X777777X666666X555555X444444X333333X222222X111111X000000X~~~~~~~
- <----> 840us(request to send by host) <-> 80us(hold DATA)
+ <----> 840us(request to send by host) <---> 80us(hold DATA)
<--> 180us(clock low)
<---> 220us(clock high)
KEY EVENT:
bit 7 key state(0:press 1:release)
- bit 6-1 scan code
+ bit 6-1 scan code(see below)
bit 0 always 1
- To get scan code, use ((bits&(1<<7)) | ((bits&7F))>>1).
+ To get scan code use this: ((bits&(1<<7)) | ((bits&0x7F))>>1).
+
+ Note: On the M0110A, the numpad keys and the arrow keys are preceded by 0x79.
+ Moreover, the numpad keys =, /, * and + are preceded by shift-down 0x71 on press and shift-up 0xF1 on release.
+ So, the data transferred by nupmad 5 is "79 2F" whereas for numpad + it's "71 79 0D".
SCAN CODE:
+ m0111_recv_key() function returns follwing scan codes instead of raw key events.
+ Scan codes are 1 byte long and bit7 is set when key is released.
+
M0110
,---------------------------------------------------------.
| `| 1| 2| 3| 4| 5| 6| 7| 8| 9| 0| -| =|Backs|
| 3A| 37| 31 | 34| 3A|
`------------------------------------------------'
+ M0110A
+ ,---------------------------------------------------------. ,---------------.
+ | `| 1| 2| 3| 4| 5| 6| 7| 8| 9| 0| -| =|Bcksp| |Clr| =| /| *|
+ |---------------------------------------------------------| |---------------|
+ |Tab | Q| W| E| R| T| Y| U| I| O| P| [| ]| | | 7| 8| 9| -|
+ |-----------------------------------------------------' | |---------------|
+ |CapsLo| A| S| D| F| G| H| J| K| L| ;| '|Return| | 4| 5| 6| +|
+ |---------------------------------------------------------| |---------------|
+ |Shift | Z| X| C| V| B| N| M| ,| ,| /|Shft|Up | | 1| 2| 3| |
+ |---------------------------------------------------------' |-----------|Ent|
+ |Optio|Mac | Space | \|Lft|Rgt|Dn | | 0| .| |
+ `---------------------------------------------------------' `---------------'
+ ,---------------------------------------------------------. ,---------------.
+ | 32| 12| 13| 14| 15| 17| 16| 1A| 1C| 19| 1D| 1B| 18| 33| | 47| 68| 6D| 62|
+ |---------------------------------------------------------| |---------------|
+ | 30| 0C| 0D| 0E| 0F| 10| 11| 20| 22| 1F| 23| 21| 1E| | | 59| 5B| 5C| 4E|
+ |-----------------------------------------------------' | |---------------|
+ | 39| 00| 01| 02| 03| 05| 04| 26| 28| 25| 29| 27| 24| | 56| 57| 58| 66|
+ |---------------------------------------------------------| |---------------|
+ | 38| 06| 07| 08| 09| 0B| 2D| 2E| 2B| 2F| 2C| 38| 4D| | 53| 54| 55| |
+ |---------------------------------------------------------' |-----------| 4C|
+ | 3A| 37| 31 | 2A| 46| 42| 48| | 52| 41| |
+ `---------------------------------------------------------' `---------------'
+
References
----------
+Technical Info for 128K/512K and Plus
+ ftp://ftp.apple.asimov.net/pub/apple_II/documentation/macintosh/Mac%20Hardware%20Info%20-%20Mac%20128K.pdf
+ ftp://ftp.apple.asimov.net/pub/apple_II/documentation/macintosh/Mac%20Hardware%20Info%20-%20Mac%20Plus.pdf
Protocol:
+ Page 20 of Tech Info for 128K/512K
http://www.mac.linux-m68k.org/devel/plushw.php
Connector:
+ Page 20 of Tech Info for 128K/512K
http://www.kbdbabel.org/conn/kbd_connector_macplus.png
Signaling:
http://www.kbdbabel.org/signaling/kbd_signaling_mac.png
http://typematic.blog.shinobi.jp/Entry/14/
Scan Codes:
+ Page 22 of Tech Info for 128K/512K
+ Page 07 of Tech Info for Plus
http://m0115.web.fc2.com/m0110.jpg
http://m0115.web.fc2.com/m0110a.jpg
*/
-#define WAIT(stat, us, err) do { \
+#define WAIT_US(stat, us, err) do { \
if (!wait_##stat(us)) { \
m0110_error = err; \
goto ERROR; \
} \
} while (0)
+#define WAIT_MS(stat, ms, err) do { \
+ uint16_t _ms = ms; \
+ while (_ms) { \
+ if (wait_##stat(1000)) { \
+ break; \
+ } \
+ _ms--; \
+ } \
+ if (_ms == 0) { \
+ m0110_error = err; \
+ goto ERROR; \
+ } \
+} while (0)
+
uint8_t m0110_error = 0;
{
uint8_t data;
idle();
- _delay_ms(255);
+ _delay_ms(1000);
- m0110_send(M0110_MODLE);
+ // Model Number
+ // M0110 : 0x09 00001001 : model number 4 (100)
+ // M0110A: 0x0B 00001011 : model number 5 (101)
+ // M0110 & M0120: ???
+ m0110_send(M0110_MODEL);
data = m0110_recv();
print("m0110_init model: "); phex(data); print("\n");
m0110_error = 0;
request();
- WAIT(clock_lo, 1000, 0);
+ WAIT_MS(clock_lo, 250, 1); // keyboard may block long time
for (uint8_t bit = 0x80; bit; bit >>= 1) {
- WAIT(clock_lo, 250, 3);
- _delay_us(15);
+ WAIT_US(clock_lo, 250, 3);
if (data&bit) {
data_hi();
} else {
data_lo();
}
- WAIT(clock_hi, 200, 4);
+ WAIT_US(clock_hi, 200, 4);
}
_delay_us(100); // hold last bit for 80us
idle();
return 1;
ERROR:
- if (m0110_error) {
- print("m0110_send err: "); phex(m0110_error); print("\n");
- }
+ print("m0110_send err: "); phex(m0110_error); print("\n");
+ _delay_ms(500);
idle();
return 0;
}
uint8_t data = 0;
m0110_error = 0;
- WAIT(clock_lo, -1, 0); // need 250ms? insted 0xffff(16bit max)us
+ WAIT_MS(clock_lo, 250, 1); // keyboard may block long time
for (uint8_t i = 0; i < 8; i++) {
data <<= 1;
- WAIT(clock_lo, 200, 2);
- WAIT(clock_hi, 200, 3);
+ WAIT_US(clock_lo, 200, 2);
+ WAIT_US(clock_hi, 200, 3);
if (data_in()) {
data |= 1;
}
}
idle();
- if (data != M0110_NULL) {
- print("m0110_recv data: "); phex(data); print("\n");
- }
return data;
ERROR:
- if (m0110_error) {
- print("m0110_recv err: "); phex(m0110_error); print("\n");
- }
+ print("m0110_recv err: "); phex(m0110_error); print("\n");
+ _delay_ms(500);
idle();
return 0xFF;
}
if (key == 0xFF || key == M0110_NULL)
return M0110_NULL;
else
- return ((key&(1<<7)) | ((key&0x7F)>>1));
+ return M0110_RAW2SCAN(key);
}