1 #pragma once
2 
3 #include <common/glib.h>
4 
5 #define PS2_MOUSE_INTR_VECTOR 0x2c // 鼠标的中断向量号
6 
7 #define KEYBOARD_COMMAND_SEND_TO_PS2_MOUSE 0xd4 // 键盘控制器向鼠标设备发送数据的命令
8 
9 #define PS2_MOUSE_GET_ID 0xf2                    // 获取鼠标的ID
10 #define PS2_MOUSE_SET_SAMPLING_RATE 0xf3         // 设置鼠标的采样率
11 #define PS2_MOUSE_ENABLE 0xf4                    // 允许鼠标设备发送数据包
12 #define PS2_MOUSE_DISABLE 0xf5                   // 禁止鼠标设备发送数据包
13 #define PS2_MOUSE_SET_DEFAULT_SAMPLING_RATE 0xf6 // 设置使用默认采样率100hz，分辨率4px/mm
14 #define PS2_MOUSE_RESEND_LAST_PACKET 0xfe        // 重新发送上一条数据包
15 #define PS2_MOUSE_RESET 0xff                     // 重启鼠标
16 
17 #define KEYBOARD_COMMAND_ENABLE_PS2_MOUSE_PORT 0xa8 // 通过键盘控制器开启鼠标端口的命令
18 
19 #define ps2_mouse_buffer_size 360
20 
21 #define PORT_KEYBOARD_DATA 0x60
22 #define PORT_KEYBOARD_STATUS 0x64
23 #define PORT_KEYBOARD_CONTROL 0x64
24 
25 #define KEYBOARD_COMMAND_WRITE 0x60 // 向键盘发送配置命令
26 #define KEYBOARD_COMMAND_READ 0x20  // 读取键盘的配置值
27 #define KEYBOARD_PARAM_INIT 0x47    // 初始化键盘控制器的配置值
28 
29 // ========= 检测键盘控制器输入/输出缓冲区是否已满
30 #define KEYBOARD_FLAG_OUTBUF_FULL 0x01 // 键盘的输出缓冲区已满标志位
31 #define KEYBOARD_FLAG_INBUF_FULL 0x02  // 键盘的输入缓冲区已满标志位
32 
33 // 等待向键盘控制器写入信息完成
34 #define wait_keyboard_write() while (io_in8(PORT_KEYBOARD_STATUS) & KEYBOARD_FLAG_INBUF_FULL)
35 // 等待从键盘控制器读取信息完成
36 #define wait_keyboard_read() while (io_in8(PORT_KEYBOARD_STATUS) & KEYBOARD_FLAG_OUTBUF_FULL)
37 
38 #define SUCCESS 0
39 #define EINVALID_ARGUMENT -1
40 #define EFAIL -2
41 
42 // =========== 定义鼠标数据包 ==============
43 // 其中，x、y方向的移动值用9位二进制补码表示（算上byte0中的符号位）
44 // 目前只用到8位，（精度要求没那么高）
45 struct ps2_mouse_packet_3bytes
46 {
47 
48     unsigned char byte0; // 第0字节
49                          // [y溢出，x溢出，y符号位， x符号位， 1， 鼠标中键， 鼠标右键，鼠标左键]
50 
51     char movement_x;
52     char movement_y;
53 };
54 
55 // ID = 3 或 ID = 4时，采用4bytes数据包
56 struct ps2_mouse_packet_4bytes
57 {
58     unsigned char byte0; // 第0字节
59                          // [y溢出，x溢出，y符号位， x符号位， 1， 鼠标中键， 鼠标右键，鼠标左键]
60 
61     char movement_x;
62     char movement_y;
63 
64     char byte3; // 当鼠标ID=3时，表示z移动值
65                 // 当鼠标ID=4时，表示：[0, 0, 鼠标第5键, 鼠标第4键, Z3, Z2, Z1, Z0]
66                 // 其中，[Z3,Z0]表示鼠标滚轮滚动方向
67                 // Z3~Z0:   0:无滚动， 1:垂直向上滚动,  F:垂直向下滚动, 2:水平向右滚动, E:水平向左滚动
68 };
69 
70 /**
71  * @brief 键盘循环队列缓冲区结构体
72  *
73  */
74 struct ps2_mouse_input_buffer
75 {
76     unsigned char *ptr_head;
77     unsigned char *ptr_tail;
78     int count;
79     unsigned char buffer[ps2_mouse_buffer_size];
80 };
81 
82 /**
83  * @brief 初始化鼠标驱动程序
84  *
85  */
86 void ps2_mouse_init();
87 
88 /**
89  * @brief 卸载鼠标驱动程序
90  *
91  */
92 void ps2_mouse_exit();
93 
94 /**
95  * @brief 设置鼠标采样率
96  *
97  * @param hz 采样率
98  */
99 int ps2_mouse_set_sample_rate(unsigned int hz);
100 
101 /**
102  * @brief 获取鼠标数据包
103  *
104  * @param packet 数据包的返回值
105  * @return int 错误码
106  */
107 int ps2_mouse_get_packet(void *packet);
108 void analyze_mousecode();