risc-v-cpu

28 Commits 3 Branches 0 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
Alpha	28c696ece2	fix(ps2): 鼠标 dy 方向取负（PS/2 正 dy = 上，软件正 dy = 下）；键盘补 W/A/S/D 别名上板实测：鼠标已能操作（说明“奇校验 + 帧按位的下标对齐”那个修复就是根因），但上下是反的、左右正确 —— 这是两套约定的差异，不是解码错： * PS/2 鼠标原生约定：dx 正 = 右、dy 正 = 上 * saolei.c 的约定：正 dx = 列 +1、正 dy = 行 +1（向下），和 cpu21_pointer 的 BTND = +8 一致所以 cpu21_ps2_mouse 在拼包时把 dy 取负（dx 不动），三种事件源（板载按键 / PS/2 鼠标 / PS/2 键盘）方向统一。键盘：另加 W/A/S/D = 方向键（与 tools/play_saolei.tcl 里的别名保持一致），这样用普通字母键也能测。自测同步更新（都 ALL PASS）： * tb_ps2_mouse：改发“鼠标向上”的 dy=+8，事件里必须得到 dy=-8；向下 dy=-5 -> +5 * tb_ps2_kbd：新增 W(1D) -> dy=-8 用例	2026-09-23 22:50:19 +08:00
Alpha	9dfff16794	feat(board): 支持 PS/2 键盘（与鼠标共用板载 USB HID 口），并修好 PS/2 帧校验一、修 PS/2 接收器的真 bug —— 这就是上板“鼠标毫无反应”的根因鼠标和键盘两个接收模块原来是同一个写法错误： * 帧用整体右移 {data, frame_q[10:1]}，判 frame_q[10] 时停止位还没移进来，判到的其实是校验位；取数据 frame_q[8:1] 也因此整体错一位 * 校验位按“偶校验”判，而 PS/2 是“奇校验” 两者叠加让真设备发来的帧 100% 被丢掉（上板表现为 rx_count 恒为 0，看起来像硬件或跳线问题）。现在按“位的下标”存帧（frame_q[i] = 第 i 位，所以字节 = frame_q[8:1]、校验 = frame_q[9]），停止位直接在当前拍的 ps2_data 上判，校验按奇校验。二、新增 PS/2 键盘解码 cpu21_ps2_kbd.v 扫描码集 2：E0 = 扩展前缀、F0 = 松开前缀，只对“按下”产生事件，并映射成与鼠标完全相同的事件格式（↑↓←→ = dy/dx ±8，正好一格；Enter/空格 = 左键；左 Shift/F/C = 右键 = 插旗），所以 saolei 的 C 代码一行都不用改；按住方向键 = 连续移动（用的是键盘自己的重复码）。三、顶层 cpu21_board_top：用 SW15 选设备同一根 PS/2 线上只会插一个设备，但两个解码器都在听：键盘的扫描码会凑巧组成 “合法的鼠标包”，两路同时生效会让光标乱跳。因此新增端口 hid_sel(SW15)： 0 = 键盘（默认），1 = 鼠标；诊断 LED 改显示“当前选中设备”收到的字节数。四、其它 * XDC：hid_sel -> V10（SW15），引脚号在官方母版里核对过 * tb_board_top 补 hid_sel 端口，避免悬空 * 新增自测 srcs/tb/tb_ps2_mouse.v / tb_ps2_kbd.v：含“故意发一个校验位错的帧，必须丢帧”的用例，两个都 ALL PASS * README / saolei/README：新增“PS/2 键鼠”一节（接线方式、SW15、LED 诊断口诀、键位表），修正显存格式（每格 2 字节、0x2000-0x2FFF）、扫雷难度与验证状态、修好 riscv 工具链 -Prefix 路径	2026-09-23 22:35:50 +08:00

Author

SHA1

Message

Date

Alpha

28c696ece2

fix(ps2): 鼠标 dy 方向取负（PS/2 正 dy = 上，软件正 dy = 下）；键盘补 W/A/S/D 别名

上板实测：鼠标已能操作（说明“奇校验 + 帧按位的下标对齐”那个修复就是根因），
但上下是反的、左右正确 —— 这是两套约定的差异，不是解码错：
  * PS/2 鼠标原生约定：dx 正 = 右、**dy 正 = 上**
  * saolei.c 的约定：正 dx = 列 +1、**正 dy = 行 +1（向下）**，和 cpu21_pointer 的
    BTND = +8 一致
所以 cpu21_ps2_mouse 在拼包时把 dy 取负（dx 不动），三种事件源（板载按键 / PS/2 鼠标 /
PS/2 键盘）方向统一。

键盘：另加 W/A/S/D = 方向键（与 tools/play_saolei.tcl 里的别名保持一致），这样用普通
字母键也能测。

自测同步更新（都 ALL PASS）：
  * tb_ps2_mouse：改发“鼠标向上”的 dy=+8，事件里必须得到 dy=-8；向下 dy=-5 -> +5
  * tb_ps2_kbd：新增 W(1D) -> dy=-8 用例

2026-09-23 22:50:19 +08:00

Alpha

9dfff16794

feat(board): 支持 PS/2 键盘（与鼠标共用板载 USB HID 口），并修好 PS/2 帧校验

一、修 PS/2 接收器的真 bug —— 这就是上板“鼠标毫无反应”的根因
  鼠标和键盘两个接收模块原来是同一个写法错误：
  * 帧用整体右移 {data, frame_q[10:1]}，判 frame_q[10] 时停止位还没移进来，判到的
    其实是校验位；取数据 frame_q[8:1] 也因此整体错一位
  * 校验位按“偶校验”判，而 PS/2 是“奇校验”
  两者叠加让真设备发来的帧 100% 被丢掉（上板表现为 rx_count 恒为 0，看起来像硬件
  或跳线问题）。现在按“位的下标”存帧（frame_q[i] = 第 i 位，所以字节 = frame_q[8:1]、
  校验 = frame_q[9]），停止位直接在当前拍的 ps2_data 上判，校验按奇校验。

二、新增 PS/2 键盘解码 cpu21_ps2_kbd.v
  扫描码集 2：E0 = 扩展前缀、F0 = 松开前缀，只对“按下”产生事件，并映射成与鼠标
  完全相同的事件格式（↑↓←→ = dy/dx ±8，正好一格；Enter/空格 = 左键；左 Shift/F/C
  = 右键 = 插旗），所以 saolei 的 C 代码一行都不用改；按住方向键 = 连续移动（用的是
  键盘自己的重复码）。

三、顶层 cpu21_board_top：用 SW15 选设备
  同一根 PS/2 线上只会插一个设备，但两个解码器都在听：键盘的扫描码会凑巧组成
  “合法的鼠标包”，两路同时生效会让光标乱跳。因此新增端口 hid_sel(SW15)：
  0 = 键盘（默认），1 = 鼠标；诊断 LED 改显示“当前选中设备”收到的字节数。

四、其它
  * XDC：hid_sel -> V10（SW15），引脚号在官方母版里核对过
  * tb_board_top 补 hid_sel 端口，避免悬空
  * 新增自测 srcs/tb/tb_ps2_mouse.v / tb_ps2_kbd.v：含“故意发一个校验位错的帧，
    必须丢帧”的用例，两个都 ALL PASS
  * README / saolei/README：新增“PS/2 键鼠”一节（接线方式、SW15、LED 诊断口诀、
    键位表），修正显存格式（每格 2 字节、0x2000-0x2FFF）、扫雷难度与验证状态、
    修好 riscv 工具链 -Prefix 路径

2026-09-23 22:35:50 +08:00