Complete batch 20261016-C-embedded-2: 45 verified GLM/Pi samples, independent regrades and archives; preserve difficulty misses and Salty blockage.
5.4 KiB
evdev 采集器的分片与丢包恢复
现场采集程序通过转发 fd 接收 Linux input_event 流:有时按键一直“按下”,拥塞恢复时旧移动量又被重放,小块读取后偶尔漏事件。修复当前 C11 工程的事件采集,保留接口与控制台格式。最终只提交并评分 event_io.c、event_state.c;头文件、控制台和构建脚本是只读上下文,评分从可信版本重建。
P1:流接口
events.h 定义独立 event_reader、event_ops 和回调。event_init 全部计数、keys/pending_keys、dx/dy/repeats/dropping/used 清零,保留传入 callback/context;callback 可为 NULL,仍正常累计 frames。两实例必须独立。fd 是不透明输入描述符,通过 ops 回调读取;控制台以可注入的伪造 fd 软件源提供真实 Linux ABI 的 struct input_event 字节,不需要 evdev 设备。架构为 trace5 Linux x86_64,input_event 为 24 字节(两个原生 long timeval、uint16 type/code、int32 value),时间戳无语义。
event_pump 连续读取和处理完整事件,直到 EAGAIN/EWOULDBLOCK 返回 0、无截断 EOF 返回 1、其他错误返回负 errno。read 返回正数可为任意短片段;任何跨 pump 的不完整事件必须保留,下一次从同一字节位置续接,不能把 EAGAIN 当帧结束。EINTR 原参数重试,不丢已读字节。read 的其他错误保留当前半个事件与已处理状态,供下一次重试;在错误前已提交的报告不撤销。若 EOF 时存在半个 input_event,丢弃半个事件和未提交事务(保留 committed keys),返回 -EPROTO;再次 EOF 返回 1。每次 read 的 capacity 不超过当前半个事件剩余容量,不能读取超出该事件后的字节。ops 或其两个回调缺失返回 -EINVAL 且无读取。所有输入指针有效,合法测试累计相对位移不会溢出 int64。
P2:事务与恢复
EV_KEY(type=1) 且 code 0..31:value=0 清 pending_keys 对应位,value=1 置位,value=2 仅令当前事务 repeats 加一,不改变按键位;其他 value/code 忽略。EV_REL(type=2) code REL_X=0 / REL_Y=1 的 int32 value 累加到当前事务 dx/dy,其他 code 忽略。其他 event type、以及除 SYN_REPORT/SYN_DROPPED 外的 EV_SYN code 都忽略。
正常态的 EV_SYN(type=0)/SYN_REPORT(code=0) 原子提交 pending_keys 至 keys,每次(含空事务)frames 加一,并回调 report(context,0,keys,dx,dy,repeats,frames);随后 dx/dy/repeats 归零、pending_keys=keys。不能把已提交的位移或 repeats 带入下个报告。
EV_SYN/SYN_DROPPED(code=3) 丢弃尚未提交的事务、进入 dropping;从正常态首次进入时 lost 加一,dropping 内重复 DROPPED 不再加。dropping 时忽略所有事件,直到 SYN_REPORT;此时必须通过 ops.snapshot_call 获取当前 32 位按键掩码,EINTR 原参数重试。snapshot 成功后 keys 和 pending_keys 等于该掩码、dx/dy/repeats=0、dropping=0,frames 加一并回调 report(context,1,keys,0,0,0,frames),该报告不再作为普通事务提交。snapshot 的其他错误使 pump 立即返回负 errno,保持 dropping 以及 committed keys,不产生回调;该 SYN_REPORT 已被消费,后续 SYN_REPORT 可重试恢复。普通报告不调用 snapshot。
event_discard 仅清半个事件和未提交事务(used=0、pending_keys=keys、dx/dy/repeats=0),保留 callback/context、keys、dropping、frames/lost。不会读 fd。候选不关闭 fd,不改 ops/context 源资产,除 API 正常状态外不输出内容。
P3:控制台与原始观测
公开 event_console.c 只有输入源和打印,无断言。stdin 每行一条命令,整数十进制,空行/#注释忽略。初始两实例为空、每次 read 最多 24 字节、无 EOF。A 0|1 选择实例;E type code value 在该 fd 队尾追加一个时间戳为零的事件;Q hex 追加任意原始字节(- 为空);C count(1..128)设置每次短读上限;K mask(0..2^32-1)设置 snapshot 返回掩码;F operation errno count 注入接下来的 count 次回调失败,operation 0=read、1=snapshot,失败无副作用且 count 减一;X 0|1 设置队列空时是否 EOF;P 调用 pump;I 重置 reader、N 用 NULL callback 重置 reader(都不清源队列/故障/计数);T discard。所有注入由公开源码实现。
回调输出 D id recovered keys dx dy repeats serial,P 随后输出 R result;每条命令后输出 S used dropping keys pending_keys dx dy repeats frames lost snapshot_calls queued_bytes。这些是候选状态和源的原始数值。snapshot_calls 包括失败与 EINTR 调用。输入 byte 缓冲和已读/未读队列不能由候选擅自修改。
P4:构建与自测
make:gcc -std=c11 -O2 -Wall -Wextra -pedantic event_console.c text.c event_io.c event_state.c -o abi_demo。正式同参数干净构建,限 20 秒;执行每个有效脚本限 15 秒、退出码 0,stdout 只输出观察格式,stderr 可诊断;非法控制台输入退出 2。自测 printf 'E 1 3 1\nP\nE 0 0 0\nP\nE 0 3 0\nK 1024\nE 0 0 0\nP\n' | ./abi_demo,检查普通报告和恢复报告。验收含每个 byte 分片位置、跨调用半事件、短读/EINTR/错误后重试、重复键、丢包/失败后恢复、bit31、多个完整事务、EOF、NULL callback 和双实例交错。只验证软件 ABI 流处理,不验证内核输入驱动或真实设备。