dev-spi-messages:公开工程合同

P1 构建、边界与输入

这是软件替身工程,不连接内核、物理设备或网络。构建 make observe(C11、gcc、-O2 -Wall -Wextra -pedantic),运行 ./observe 从stdin逐行接收命令,正常EOF退出0;词法错误退出2。所有参数均为十进制int,单行≤2047字符、≤80参数。空行和以#开始的行忽略。下述合法词法但非法命令返回-EINVAL,继续处理后续输入。独立程序一次≤2000命令;构建25秒、运行20秒、评分120秒,Agent3600秒用于防挂死。

公共 lab.h 是接口和布局;client_init清空客户端状态并保留backend指针(属性/配置初始值见P3),client_apply只修改当前bank的公开状态。最终只评分client.c,其他文件恢复为本工程版本。不得依赖新增文件或改写后端。候选可以采用任何满足观察合同的实现。

P2 设备替身、故障与观察

四个相互独立bank,初选0;每bank有8个客户端int槽、8个后端int槽和256字节存储。存储初始 (17*offset+29*bank)&255;未说明的槽初值0且保持0。A bank选择0..3(client/backend同步);F index errno count设置全局故障槽0..7,errno和count非负(测试最多count=3),后续该类调用每次消耗一个并在副作用前返回-errno;count耗尽正常。所有客户端系统调用遇到-EINTR原参数重试,其余错误立即返回;失败不改变成功计数或缓存,除P3明确的部分成功及错误计数。Z slot value seed直接设置当前bank后端槽0..7,seed≥0时全存储重置为 (17*offset+seed)&255,seed<0则不改存储;用于模拟其他进程。Z参数非法返回-EINVAL。F/A非法转由client作为未知命令拒绝。

每命令输出N序号(从1连续),再输出0或多条T(调用原始观察,严格按调用顺序),再R、C、B各一行。格式为 N seq,T kind operation a result,R result length [byte...](字节十进制),C selected [bank0的8槽 ... bank3的8槽],B selected total_calls [每bank的8槽及存储sum&65535] [8组errno remaining]。T的kind、operation、a与设备副作用是backend.c::device_call的冻结公开合同;不是判分期望。trace总数包括失败和EINTR,每个命令≤64个实际调用。R无数据时length0。所有失败返回负的Linux errno,所有成功返回0。

只读wire.c负责输入解析、trace/故障队列和字节输出;console.c只路由公共控制命令和打印原始状态;codec.c严格文本整数解析与格式化。不能跳过设备调用而仅伪造客户端快照,因为公开调用序列和后端状态也属于接口。

诊断接口Q slot width返回当前client槽的低width字节小端表示(slot0..7,width1/2/4);P start count连续返回count个int32小端槽,start0..8、count0..8-start,可返回空。参数数或范围错误-EINVAL,无设备调用、不改状态。负值按二补数低位输出。诊断不计业务错误计数。

P3 SPI消息接口

O mode speed配置并置active,mode0..3、speed1..1000000,否则-EINVAL;每次op5 a=mode b=speed,成功才更新缓存,允许重复O。X清active,无设备调用。

W address count bytes...、R address count要求active(否则-ENODEV);地址≥0、count1..32、address+count≤256、写字节数准确且0..255,否则-EINVAL。W按16字节页边界拆成最少连续段;每段op1 a0 WREN成功后op2 a=段地址、data=段字节;每个成功段writes加1、txbytes加该段长,失败立即停止,已成功段保留且不回滚,不重试EIO。R一次op3 a=address,传count,返回RX的前4字节为命令/地址头[3,0,0,address],后面才是count数据,只返回数据给调用者;成功reads加1、rxbytes加count。

E address要求active、地址0..224且32对齐,先op1再op4 a=address擦除32字节,成功erases加1。client槽active,mode,speed,reads,writes,erases,txbytes,rxbytes;后端槽mode,speed,WEL,programs,reads,erases,0,0。故障槽0..4对应op1..5。op1置WEL;op2/op4要求WEL否则-EACCES,成功消耗WEL;op2跨16页或长度>16返回-EINVAL且不消耗,写是逐位AND;op4写FF。op3不消耗WEL,op5不改WEL。所有EINTR重试同一次调用。

P4 自测

printf 'O 0 1000000\nE 0\nW 15 2 18 52\nR 15 2\n' | ./observe;测试多个页面、故障发生在后段、非FF存储按位写及RX切片。