keyboard.s

linux完全注释的源代码。内核版本为0.11的linux kernel。

// alt 键同时按下时的映射表。
alt_map:
 db 0,0
 db 0,'@',0,'$',0,0,"{[]}",'\',0
 db 0,0
 db 0,0,0,0,0,0,0,0,0,0,0
 db '~',13,0
 db 0,0,0,0,0,0,0,0,0,0,0
 db 0,0
 db 0,0,0,0,0,0,0,0,0,0,0
 db 0,0,0,0 /* 36-39 */
 db 16 dup(0) /* 3A-49 */ /* 扫描码0x3A-0x49 对应的ASCII 码 */
 db 0,0,0,0,0 /* 4A-4E */
 db 0,0,0,0,0,0,0 /* 4F-55 */
 db '|'
 db 10 dup(0)

#elif defined(KBD_US)

// 以下是美式键盘的扫描码映射表。
key_map:
 db 0,27
 db "1234567890-="
 db 127,9
 db "qwertyuiop[]"
 db 13,0
 db "asdfghjkl;'"
 db '`',0
 db "\zxcvbnm,./"
 db 0,'*',0,32 /* 36-39 */
 db 16 dup(0) /* 3A-49 */ /* 扫描码0x3A-0x49 对应的ASCII 码 */
 db '-',0,0,0,'+' /* 4A-4E */
 db 0,0,0,0,0,0,0 /* 4F-55 */
 db '<'
 db 10 dup(0)


shift_map:
 db 0,27
 db "!@#$%^&*()_+"
 db 127,9
 db "QWERTYUIOP{}"
 db 13,0
 db "ASDFGHJKL:",'"'
 db '~',0
 db "|ZXCVBNM<>?"
 db 0,'*',0,32 /* 36-39 */
 db 16 dup(0) /* 3A-49 */ /* 扫描码0x3A-0x49 对应的ASCII 码 */
 db '-',0,0,0,'+' /* 4A-4E */
 db 0,0,0,0,0,0,0 /* 4F-55 */
 db '>'
 db 10 dup(0)

alt_map:
 db 0,0
 db 0,'@',0,'$',0,0,"{[]}","\",0
 db 0,0
 db 0,0,0,0,0,0,0,0,0,0,0
 db '~',13,0
 db 0,0,0,0,0,0,0,0,0,0,0
 db 0,0
 db 0,0,0,0,0,0,0,0,0,0,0
 db 0,0,0,0 /* 36-39 */
 db 16 dup(0) /* 3A-49 */ /* 扫描码0x3A-0x49 对应的ASCII 码 */
 db 0,0,0,0,0 /* 4A-4E */
 db 0,0,0,0,0,0,0 /* 4F-55 */
 db '|'
 db 10 dup(0)

#elif defined(KBD_GR)

// 以下是德语键盘的扫描码映射表。
key_map:
 db 0,27
 db "1234567890\'"
 db 127,9
 db "qwertzuiop@+"
 db 13,0
 db "asdfghjkl[]^"
 db 0,'#'
 db "yxcvbnm,.-"
 db 0,'*',0,32 /* 36-39 */
 db 16 dup(0) /* 3A-49 */ /* 扫描码0x3A-0x49 对应的ASCII 码 */
 db '-',0,0,0,'+' /* 4A-4E */
 db 0,0,0,0,0,0,0 /* 4F-55 */
 db '<'
 db 10 dup(0)


shift_map:
 db 0,27
 db '!','"',"#$%&/()=?`"
 db 127,9
 db "QWERTZUIOP\*"
 db 13,0
 db "ASDFGHJKL{}~"
 db 0,''
 db "YXCVBNM:_"
 db 0,'*',0,32 /* 36-39 */
 db 16 dup(0) /* 3A-49 */ /* 扫描码0x3A-0x49 对应的ASCII 码 */
 db '-',0,0,0,'+' /* 4A-4E */
 db 0,0,0,0,0,0,0 /* 4F-55 */
 db '>'
 db 10 dup(0)

alt_map:
 db 0,0
 db 0,'@',0,'$',0,0,"{[]}",'\',0
 db 0,0
 db '@',0,0,0,0,0,0,0,0,0,0
 db '~',13,0
 db 0,0,0,0,0,0,0,0,0,0,0
 db 0,0
 db 0,0,0,0,0,0,0,0,0,0,0
 db 0,0,0,0 /* 36-39 */
 db 16 dup(0) /* 3A-49 */ /* 扫描码0x3A-0x49 对应的ASCII 码 */
 db 0,0,0,0,0 /* 4A-4E */
 db 0,0,0,0,0,0,0 /* 4F-55 */
 db '|'
 db 10 dup(0)


#elif defined(KBD_FR)

// 以下是法语键盘的扫描码映射表。
key_map:
 db 0,27
 db "&{",'"',"'(-}_/@)="
 db 127,9
 db "azertyuiop^$"
 db 13,0
 db "qsdfghjklm|"
 db '`',0,42 /* coin sup gauche, don't know, [*|mu] */
 db "wxcvbn,:!"
 db 0,'*',0,32 /* 36-39 */
 db 16 dup(0) /* 3A-49 */ /* 扫描码0x3A-0x49 对应的ASCII 码 */
 db '-',0,0,0,'+' /* 4A-4E */
 db 0,0,0,0,0,0,0 /* 4F-55 */
 db '<'
 db 10 dup(0)

shift_map:
 db 0,27
 db "1234567890]+"
 db 127,9
 db "AZERTYUIOP<>"
 db 13,0
 db "QSDFGHJKLM%"
 db '~',0,'#'
 db "WXCVBN?./\"
 db 0,'*',0,32 /* 36-39 */
 db 16 dup(0) /* 3A-49 */ /* 扫描码0x3A-0x49 对应的ASCII 码 */
 db '-',0,0,0,'+' /* 4A-4E */
 db 0,0,0,0,0,0,0 /* 4F-55 */
 db '>'
 db 10 dup(0)

alt_map:
 db 0,0
 db 0,"~#{[|`\^@]}"
 db 0,0
 db '@',0,0,0,0,0,0,0,0,0,0
 db '~',13,0
 db 0,0,0,0,0,0,0,0,0,0,0
 db 0,0
 db 0,0,0,0,0,0,0,0,0,0,0
 db 0,0,0,0 /* 36-39 */
 db 16 dup(0) /* 3A-49 */ /* 扫描码0x3A-0x49 对应的ASCII 码 */
 db 0,0,0,0,0 /* 4A-4E */
 db 0,0,0,0,0,0,0 /* 4F-55 */
 db '|'
 db 10 dup(0)

#else
#error "KBD-type not defined"
#endif
/*
* do_self handles "normal" keys, ie keys that don't change meaning
* and which have just one character returns.
*/
/*
* do_self 用于处理“普通”键，也即含义没有变化并且只有一个字符返回的键。
*/
do_self:
// 454-460 行用于根据模式标志mode 选择alt_map、shift_map 或key_map 映射表之一。
	lea ebx,alt_map // alt 键同时按下时的映射表基址alt_map??ebx。
	test mode,20 /* alt-gr */ /* 右alt 键同时按下了? */
	jne l15 // 是，则向前跳转到标号1 处。
	lea ebx,shift_map // shift 键同时按下时的映射表基址shift_map??ebx。
	test mode,03h // 有shift 键同时按下了吗？
	jne l15 // 有，则向前跳转到标号1 处。
	lea ebx,key_map // 否则使用普通映射表key_map。
// 取映射表中对应扫描码的ASCII 字符，若没有对应字符，则返回(转none)。
l15:
	mov al,[ebx+eax] // 将扫描码作为索引值，取对应的ASCII 码??al。
	or al,al // 检测看是否有对应的ASCII 码。
	je none // 若没有(对应的ASCII 码=0)，则返回。
// 若ctrl 键已按下或caps 键锁定，并且字符在'a'-'}'(0x61-0x7D)范围内，则将其转成大写字符
// (0x41-0x5D)。
	test mode,4ch /* ctrl or caps */ /* 控制键已按下或caps 亮？*/
	je l16 // 没有，则向前跳转标号2 处。
	cmp al,'a' // 将al 中的字符与'a'比较。
	jb l16 // 若al 值<'a'，则转标号2 处。
	cmp al,'}' // 将al 中的字符与'}'比较。
	ja l16 // 若al 值>'}'，则转标号2 处。
	sub al,32 // 将al 转换为大写字符(减0x20)。
// 若ctrl 键已按下，并且字符在'`'--'_'(0x40-0x5F)之间(是大写字符)，则将其转换为控制字符
// (0x00-0x1F)。
l16: 
	test mode,0ch /* ctrl */ /* ctrl 键同时按下了吗？*/
	je l17 // 若没有则转标号3。
	cmp al,64 // 将al 与'@'(64)字符比较(即判断字符所属范围)。
	jb l17 // 若值<'@'，则转标号3。
	cmp al,64+32 // 将al 与'`'(96)字符比较(即判断字符所属范围)。
	jae l17 // 若值>='`'，则转标号3。
	sub al,64 // 否则al 值减0x40，
// 即将字符转换为0x00-0x1f 之间的控制字符。
// 若左alt 键同时按下，则将字符的位7 置位。
l17: 
	test mode,10h /* left alt */ /* 左alt 键同时按下？*/
	je l18 // 没有，则转标号4。
	or al,80h // 字符的位7 置位。
// 将al 中的字符放入读缓冲队列中。
l18: 
	and eax,0ffh // 清eax 的高字和ah。
	xor ebx,ebx // 清ebx。
	call put_queue // 将字符放入缓冲队列中。
none: 
	ret

/*
* minus has a routine of it's own, as a 'E0h' before
* the scan code for minus means that the numeric keypad
* slash was pushed.
*/
/*
* 减号有它自己的处理子程序，因为在减号扫描码之前的0xe0
* 意味着按下了数字小键盘上的斜杠键。
*/
minus: 
	cmp e0,1 // e0 标志置位了吗？
	jne do_self // 没有，则调用do_self 对减号符进行普通处理。
	mov eax,'/' // 否则用'/'替换减号'-'??al。
	xor ebx,ebx
	jmp put_queue // 并将字符放入缓冲队列中。

/*
* This table decides which routine to call when a scan-code has been
* gotten. Most routines just call do_self, or none, depending if
* they are make or break.
*/
/* 下面是一张子程序地址跳转表。当取得扫描码后就根据此表调用相应的扫描码处理子程序。
* 大多数调用的子程序是do_self，或者是none，这起决于是按键(make)还是释放键(break)。
*/
key_table:
 DD none,   do_self,do_self,do_self /* 00-03 s0 esc 1 2 */
 DD do_self,do_self,do_self,do_self /* 04-07 3 4 5 6 */
 DD do_self,do_self,do_self,do_self /* 08-0B 7 8 9 0 */
 DD do_self,do_self,do_self,do_self /* 0C-0F + ' bs tab */
 DD do_self,do_self,do_self,do_self /* 10-13 q w e r */
 DD do_self,do_self,do_self,do_self /* 14-17 t y u i */
 DD do_self,do_self,do_self,do_self /* 18-1B o p } ^ */
 DD do_self,ctrl,   do_self,do_self /* 1C-1F enter ctrl a s */
 DD do_self,do_self,do_self,do_self /* 20-23 d f g h */
 DD do_self,do_self,do_self,do_self /* 24-27 j k l | */
 DD do_self,do_self,lshift, do_self /* 28-2B { para lshift , */
 DD do_self,do_self,do_self,do_self /* 2C-2F z x c v */
 DD do_self,do_self,do_self,do_self /* 30-33 b n m , */
 DD do_self,minus,  rshift, do_self /* 34-37 . - rshift * */
 DD alt,    do_self,caps,   func /* 38-3B alt sp caps f1 */
 DD func,   func,   func,   func /* 3C-3F f2 f3 f4 f5 */
 DD func,   func,   func,   func /* 40-43 f6 f7 f8 f9 */
 DD func,   num,    scroll, cursor /* 44-47 f10 num scr home */
 DD cursor, cursor, do_self,cursor /* 48-4B up pgup - left */
 DD cursor, cursor, do_self,cursor /* 4C-4F n5 right + end */
 DD cursor, cursor, cursor, cursor /* 50-53 dn pgdn ins del */
 DD none,   none,   do_self,func /* 54-57 sysreq ? < f11 */
 DD func,   none,   none,   none /* 58-5B f12 ? ? ? */
 DD none,   none,   none,   none /* 5C-5F ? ? ? ? */
 DD none,   none,   none,   none /* 60-63 ? ? ? ? */
 DD none,   none,   none,   none /* 64-67 ? ? ? ? */
 DD none,   none,   none,   none /* 68-6B ? ? ? ? */
 DD none,   none,   none,   none /* 6C-6F ? ? ? ? */
 DD none,   none,   none,   none /* 70-73 ? ? ? ? */
 DD none,   none,   none,   none /* 74-77 ? ? ? ? */
 DD none,   none,   none,   none /* 78-7B ? ? ? ? */
 DD none,   none,   none,   none /* 7C-7F ? ? ? ? */
 DD none,   none,   none,   none /* 80-83 ? br br br */
 DD none,   none,   none,   none /* 84-87 br br br br */
 DD none,   none,   none,   none /* 88-8B br br br br */
 DD none,   none,   none,   none /* 8C-8F br br br br */
 DD none,   none,   none,   none /* 90-93 br br br br */
 DD none,   none,   none,   none /* 94-97 br br br br */
 DD none,   none,   none,   none /* 98-9B br br br br */
 DD none,   unctrl, none,   none /* 9C-9F br unctrl br br */
 DD none,   none,   none,   none /* A0-A3 br br br br */
 DD none,   none,   none,   none /* A4-A7 br br br br */
 DD none,   none,   unlshift,none /* A8-AB br br unlshift br */
 DD none,   none,   none,   none /* AC-AF br br br br */
 DD none,   none,   none,   none /* B0-B3 br br br br */
 DD none,   none,   unrshift,none /* B4-B7 br br unrshift br */
 DD unalt,  none,   uncaps, none /* B8-BB unalt br uncaps br */
 DD none,none,none,none /* BC-BF br br br br */
 DD none,none,none,none /* C0-C3 br br br br */
 DD none,none,none,none /* C4-C7 br br br br */
 DD none,none,none,none /* C8-CB br br br br */
 DD none,none,none,none /* CC-CF br br br br */
 DD none,none,none,none /* D0-D3 br br br br */
 DD none,none,none,none /* D4-D7 br br br br */
 DD none,none,none,none /* D8-DB br ? ? ? */
 DD none,none,none,none /* DC-DF ? ? ? ? */
 DD none,none,none,none /* E0-E3 e0 e1 ? ? */
 DD none,none,none,none /* E4-E7 ? ? ? ? */
 DD none,none,none,none /* E8-EB ? ? ? ? */
 DD none,none,none,none /* EC-EF ? ? ? ? */
 DD none,none,none,none /* F0-F3 ? ? ? ? */
 DD none,none,none,none /* F4-F7 ? ? ? ? */
 DD none,none,none,none /* F8-FB ? ? ? ? */
 DD none,none,none,none /* FC-FF ? ? ? ? */

/*
* kb_wait waits for the keyboard controller buffer to empty.
* there is no timeout - if the buffer doesn't empty, we hang.
*/
/*
* 子程序kb_wait 用于等待键盘控制器缓冲空。不存在超时处理 - 如果
* 缓冲永远不空的话，程序就会永远等待(死掉)。
*/
kb_wait:
	push eax
l19: 
	in al,64h // 读键盘控制器状态。
	test al,02h // 测试输入缓冲器是否为空(等于0)。
	jne l19 // 若不空，则跳转循环等待。
	pop eax
	ret
/*
* This routine reboots the machine by asking the keyboard
* controller to pulse the reset-line low.
*/
/*
* 该子程序通过设置键盘控制器，向复位线输出负脉冲，使系统复位重启(reboot)。
*/
reboot:
	call kb_wait // 首先等待键盘控制器输入缓冲器空。
	mov word ptr ds:[472h],1234h /* don't do memory check */
	mov al,0fch /* pulse reset and A20 low */
	out 64h,al // 向系统复位和A20 线输出负脉冲。
die: 
	jmp die // 死机。

end