# Lab 6 · 三模式反应与数字记忆游戏

**先玩一遍再读代码。** 菜单按 A 进视觉模式，B 进听觉模式，C 进记忆模式，* 看成绩。在任何子界面按 * 回菜单。视觉等绿灯，听觉等蜂鸣，收到提示才向红外模块挥手。记忆模式先看完三组数字，再按键盘逐组输入。

## 第 1–50 行 · 读接线和三类参数

Uno R3 接线如下。LCD 电源接匹配的供电，所有模块共地。单颗 LED 串联限流电阻。

| 器件 | 脚位 |
|---|---|
| 红外反射传感器 Vout | D2，检测到手默认 LOW |
| 红、黄、绿灯 | D3、D4、D5 |
| 无源蜂鸣器 | D6 |
| 键盘 R1–R4 | D7、D8、D9、D10 |
| 键盘 C1–C4 | D11、D12、D13、A0，A0 此处当数字脚 |
| I²C LCD | SDA→A4，SCL→A5，地址 0x27 |

`Wire` 和 `LiquidCrystal_I2C` 管屏幕通信，`string.h` 提供字符串比较，`stdio.h` 提供文字格式化。`KEY_LAYOUT` 是行列到键值的对照表，索引从 0 开始，例如第 2 行第 3 列得到 '6'。键盘要求稳定 35 ms，红外要求稳定 40 ms。反应等待最多 10 秒，成绩显示 6 秒。记忆默认 4 位、每组 5 秒，共 3 组。

## 第 51–116 行 · 状态变量保存了什么

`enum GameState` 给 18 个界面或过程各一个名字。视觉走 READY → RED → YELLOW → GO，听觉走 READY → WAIT → GO。抢跑、结果、成绩是独立状态。记忆分设置、准备、展示、间隔、输入、反馈、成绩。程序用 `state` 保存当前状态，用 `stateSince` 保存进入时间，用 `cueTime` 单独存提示发出时刻。

`redTimeMs`、`yellowTimeMs`、`audioWaitMs` 存抽出的等待时间。成绩分别存视觉最短、听觉最短和记忆最高，反应以 0 表示初始无成绩，记忆以 −1 表示未玩，0 分可正常保存。

`memoryNumbers[3][9]` 放三组字符串，一组最多八个数字加结束符 `'\0'`。`showingGroup` 是当前看第几组，`answeringGroup` 是正在答第几组。`entered` 和 `enteredCount` 保存本组已输内容和长度。`perfectGroups` 记整组正确数，`correctPositions` 累加逐位匹配数。最后几个变量保存原始键值、稳定键值、红外原始与稳定状态的时间，以及成绩屏已显示的页号。

## 第 117–158 行 · 三个输出工具和进入状态的函数

- `lights(red,yellow,green)` 把三个布尔值分别写到三个引脚。例如 `lights(false,false,true)` 只亮绿灯。
- `showLine(row,message)` 先定位到该行开头，逐字输出，遇结束符停止，最多 16 字符。行尾补空格覆盖旧字。`showTwoLines()` 调两次，一次写第 0 行，一次写第 1 行。
- `enterState(next,now)` 同时更新状态和进入时间。之后用 `millis()-stateSince` 算在此状态待了多久。
- `shortBeep()` 通过 `tone` 输出频率和时长。默认 1400 Hz、75 ms，函数返回后蜂鸣器继续响，主循环继续查键盘与红外。

## 第 159–206 行 · 扫键盘，再把抖动滤掉

`keypadRaw()` 逐行扫描。先让本行成为低电平输出，等 3 μs，然后查四列。列脚配置为上拉输入，未按时 HIGH。按下某键使这行的低电平连到该列，读到 LOW 便从 `KEY_LAYOUT[r][c]` 取字符。无论找到与否，离开这一行前都改回 INPUT。四行全扫不到返回 0。

`readKeyPress(now)` 先看原始读数有没有变化。变了就记录新值和时刻。某值连续不变至少 35 ms 且与上次稳定值不同，才更新稳定值。新稳定值是按键字符时返回它，松开时只更新状态。举例，按 'A' 在 100 ms→102 ms 抖动，最后从 105 ms 起一直读 'A'，最早在 140 ms 发出一个按键事件。一直按住时只发一次。

## 第 207–232 行 · 把挥手变成一个带时间的事件

`digitalRead(IR_PIN)==IR_ACTIVE_LEVEL` 把电平转换成「有手」。原始状态改变时记 `irRawChangedAt`。它持续至少 40 ms 且不同于稳定状态，才更新稳定值。只在稳定变为有手时返回 true，记 `lastWaveStartMs` 为这次变化的初始时刻。若在 4780 ms 检测到手、4820 ms 才确认稳定，反应时间用 4780 ms 计算，因此不会额外多加 40 ms。手移开并稳定后，下次挥手才能产生新事件。

## 第 233–262 行 · 菜单和开始前的画面

`openMenu()` 设 MENU、灭灯并停止蜂鸣，显示 A/B/C 和 * 的功能。`openReactionReady(audio,now)` 保存是听觉还是视觉，灭灯，按 `audio` 选对应 READY 状态和标题，第二行提示 # 开始、* 返回。调用这一段只是准备，计时在真正的提示发出时开始。

## 第 263–321 行 · 抽取等待时间，处理抢跑

`beginReaction` 用当前微秒计数做随机种子。听觉抽 2000–5000 ms，灭灯、提示听声音，进入 AUDIO_WAIT。视觉抽红灯 1500–3500 ms、黄灯 800–1800 ms，先亮红灯并进入 VISUAL_RED。`random(min,max)` 取到下界但取不到上界，所以写 5001 才能包含 5000。

`falseStart(now)` 进 FALSE_START，屏幕提示太早，亮红灯，响 320 Hz 的 350 ms 低音，串口报错。闪灯节奏和返回由主循环决定。

## 第 322–411 行 · 反应结果、纪录和成绩屏首屏

`unsigned long &best` 让 `best` 成为对应纪录变量的别名。听觉更新 `bestAudioMs`，视觉更新 `bestVisualMs`。若尚无纪录或新时间更短，立即保存为纪录。两段 `snprintf` 将模式、时间和文字写进两个 17 字节的缓冲区，最多显示 16 字符并留结束符。显示结果后灭灯，按是否破纪录选择音高，进入 REACTION_RESULT，串口记录模式、本次时间和最佳时间。

`showBest(now)` 进入 BEST_SCREEN，令 `displayedBestPage=255`，为下一轮强制刷新做准备。先显示视觉与听觉最短用时。纪录为 0 时显示横线。之后主循环轮播两种成绩页。

## 第 412–492 行 · 设置记忆题、生成三组、重置进度

`showMemorySetup()` 用 `snprintf` 写位数和秒数，下面一行提醒 A/B 加减位数、C/0 加减秒数。`openMemorySetup()` 进入状态，灭灯，显示设置和串口说明。

`makeMemoryNumbers()` 外层循环走三组，内层走本组每一位。`random(0,10)` 取 0–9，加字符 '0' 得到 '0'–'9'，所以 0042 可保留开头的零。写完把末尾设为 `'\0'`。例如四位就是下标 0–3 存数字、下标 4 结束。

`startMemory()` 重新生成三组，清整组分数和逐位分数、展示和作答下标以及输入长度。显示准备画面，亮黄灯，进入 MEMORY_PREP，再打印当前位数和秒数。

## 第 493–553 行 · 放题、开启答题、画输入

`showMemoryGroup` 进入 MEMORY_SHOW、亮黄灯，第一行写第几组，第二行显示当前待记字符串，再响一声。`showMemoryEntry` 进入 MEMORY_INPUT，把上一组的输入清空，亮绿灯并提示 # 确认、D 删除。`refreshTypedAnswer` 每一位如果已有输入就显示字符，否则写下划线。例如长度 4，输入 6、0，屏上看到 `60__`。末尾加 NUL，确保显示函数知道在哪里停止。

## 第 554–620 行 · 整组是否正确，逐位又对多少

`strcmp(entered,expected)==0` 说明两串字符逐一相同，`perfectGroups` 加一。另走一遍每个下标，相等就给 `correctPositions` 加一。假设题目 0427、提交 0457，四位分别是对、对、错、对，整组计 0，逐位累计加 3。之后屏幕、灯和蜂鸣提示对错，进入 MEMORY_FEEDBACK，串口打印题号、正确串、输入串、整组对错。

## 第 621–685 行 · 最终百分制如何手算

总位数是三组乘每组位数。把逐位正确数乘 100 再除总位数即可得百分数。整数除法丢小数，代码先在分子加上整数版的半个分母做四舍五入。

$$N=3\times\text{位数},\qquad score=\left\lfloor\frac{100\times\text{正确位数}+\lfloor N/2\rfloor}{N}\right\rfloor$$

例如三组各 4 位，共 12 位，答对 8 位，$(8\times100+6)/12=806/12$，整数结果 67 分。若比历史最高分高就更新。LCD 第一行写整组全对数，第二行写百分制分数。全对时亮三灯、响更高的音。进入 MEMORY_RESULT 并用串口记录总位数、正确位数、本次和最佳分数。

**读实物照片。** 10 月 30 日的 LCD 照片显示 `Correct: 2/3` 和 `Score: 92/100`。4 位一组时，总共 12 位。两组全对占 8 位，若另一组只错一位，累计就是 11 位。按代码计算 $\lfloor(11\times100+6)/12\rfloor=92$，所以「整组正确数」和「逐位得分」会同时显示不同结果。

## 第 686–744 行 · 开机顺序与循环的入口

串口设为 115200。红外设上拉输入，三色灯和蜂鸣器设输出。键盘四行初始为高阻输入，四列为上拉输入。红外先读取一次，把原始与稳定状态设成相同，再初始化屏幕、开背光、清屏和进入菜单。

以后每轮先取当前时间，再读一个键盘事件和一个挥手事件。若不是菜单且按了 *，直接回菜单并结束本轮。否则按 `state` 进入对应的 `case`。时长判断只做比较，不用等待数秒才执行下一次循环。

## 第 745–784 行 · 菜单按键与准备界面

MENU 读到 A、B、C、* 分别打开视觉准备、听觉准备、记忆设置、纪录。两个 READY 状态内，按 # 或检测到一次挥手就开局，函数参数 false/true 选视觉/听觉。没有事件时直接跳出 `switch`，下一轮继续读。

## 第 785–856 行 · 红、黄、绿三段与反应时

| 当前状态 | 发生了什么 | 下一步 |
|---|---|---|
| VISUAL_RED | 挥手 | 抢跑 |
| VISUAL_RED | 等够本局红灯时间 | 点黄、提示等待、进入 VISUAL_YELLOW |
| VISUAL_YELLOW | 挥手 | 抢跑 |
| VISUAL_YELLOW | 等够本局黄灯时间 | 点绿、立即记 `cueTime`、换 VISUAL_GO、提示挥手 |
| VISUAL_GO | 挥手，起始时间在提示之前 | 抢跑 |
| VISUAL_GO | 挥手，起始时间在提示之后 | 相减求反应时间、显示结果 |
| VISUAL_GO | 未挥手且超过 10 秒 | 回到准备画面，提示超时 |

手算边界。绿灯 4500 ms。手在 4480 ms 开始，4520 ms 才被确认为稳定。虽已进入 GO，起始时刻仍比提示早 20 ms，判抢跑。若手 4780 ms 开始，则 $4780-4500=280$ ms。源码将两时刻差转成有符号 `long`，在 Uno 的短时间间隔内用负差检查抢跑。

## 第 857–905 行 · 听觉提示只响一声

AUDIO_WAIT 中，先挥手就抢跑。等够随机时间后记 `cueTime`，响 1800 Hz、180 ms，不切换灯光或屏幕，再进 AUDIO_GO。GO 中的计算和视觉相同，比较挥手开始时刻与提示时刻。收到较晚的事件就算出时间，无事件且满 10 秒则回听觉准备页。

## 第 906–937 行 · 抢跑后闪灯，成绩页可重来

FALSE_START 以经过时间除 200 ms，取整数，再取余数判断亮灭。0–199 ms 的商是 0，红灯亮。200–399 ms 的商是 1，红灯灭。如此交替，满 1600 ms 回到原模式准备界面。REACTION_RESULT 按 # 立即重开，没按则 6000 ms 后回准备界面。

## 第 938–1017 行 · 纪录两页轮播

从进 BEST_SCREEN 起每过 2500 ms 取一个整数，用 `%2` 得到交替的 0、1 页。只有页号变化才更新屏幕。第 0 页写视觉和听觉的最短时间，无成绩写横线。第 1 页写记忆最高分，−1 时写未玩。反应竞速看最小值，记忆答题看最大值。

## 第 1018–1058 行 · 改位数和显示秒数

MEMORY_SETUP 内 A 加一位、B 减一位，允许 2–8 位。C 加一秒、0 减一秒，允许 2–10 秒。只在变化后重写画面，因此达到边界时按键不再改变设置。按 # 调用 `startMemory()`。

## 第 1059–1122 行 · 展示每组数字及组间空档

MEMORY_PREP 满 1200 ms 后显示第一组。MEMORY_SHOW 等满 `showSeconds*1000` ms，灭灯并切到 MEMORY_GAP。若还有下一组，屏幕提示下一组将开始。三组全看完则提示回忆。MEMORY_GAP 满 900 ms，有下一组就把下标加一并显示，否则开启第一组作答并画下划线。

例如每组显示 5 秒，忽略少量刷新时间，按 # 后第 1.2 秒出第一组，第 6.2 秒进入空档，第 7.1 秒出第二组。

## 第 1123–1168 行 · 输入、删除和确认

数字键且长度还未满时，向当前下标写键值并自增长度，把结束符紧跟在最后一个字符之后。D 在已有一位时将长度减一，再把结束符写到新末尾。两种操作都刷新下划线。按 # 时长度正好才评分，没填满发 350 Hz 短音继续等待。比如 `60__` 再按 9 得 `609_`，按 D 回到 `60__`，此时按 # 只响，补足两位才提交。

## 第 1169–1201 行 · 反馈、下一组和最终返回

每组反馈显示至少 1100 ms。后面还有组就令 `answeringGroup++`，清输入并显示下一组。全部三组完成就调用 `finishMemory()`。成绩页按 # 回设置，可以改参数再玩。任何非菜单状态仍适用前面的 * 返回。串口最后一行中的 `exact_groups`、`matched_positions`、`score` 分别记录整组全对数、逐位正确数和百分制得分。
