# 固定控制台与内存设备 1. 输入为ASCII文本。每行(不含LF)最多1023字节;EOF前最后一行可无LF。行首/词间ASCII空白允许;空行、首个非空白为#及词间或数字后#起的行尾注释忽略。每个实际命令是一个非空白字节的名称及至多32个十进制整数,整数可带+/-,范围-32768..32767。损坏数字、多字符命令词、整数越界、过长行、超过32个整数属于语法错误,立即退出2,不为错误行输出;前面已完成命令的输出保留。 2. 语法正确但未知命令、数量不符或控制台参数非法时,result=-4、无库调用、会话与pin不变;仍计一个命令。每个实际命令sequence从1递增。正常EOF返回0;输出失败返回3。stderr仅用于诊断,不限制内容或编码。 3. `N`:清空24个pin和模拟器,调用session_init清会话;sequence持续递增。`C`:调用close。`L low value`:直接调用physical。`V n triples...`直接调用validate,`M n triples...`直接调用mask,每个triple是pin low initial。n在0..8时必须恰有n个triple;n域外时不带triple并交库判非法。 4. `O n fail_request fail_direction triples...`:按与V相同规则组成计划并调用open。两个fail参数各为0..8,0不注入失败,k表示本命令第k个该类回调失败。任一失败参数域外属于控制台非法。request阶段失败后不会进入direction阶段。 5. `A n fail_write values...`:n在0..8时恰有n个值,否则不带值,由库判非法;fail_write为0..8,含义同上。注入是按该命令内write回调序号的一次故障,后续恢复write不再失败;k超过实际回调数时没有故障。值参数是否合法由库整体判断。 6. `B pin raw`:pin为0..23、raw为0或1且该pin当前不属于本会话(owner不为1)时,设置外部占用owner=2、direction=1、raw保存;否则控制台非法。不会产生后端事件。N清外部占用,close不能清它。 7. `Z operation n`:直接NULL指针接口观察。operation=0调用validate(NULL,n),1调用mask(NULL,n),2调用open(session,bus,NULL,n),3调用apply(session,bus,NULL,n)。其他operation控制台非法。 8. 每个实际命令恰输出一个JSON对象,键sequence/result/session/pins/events/arguments。JSON空白和对象键顺序不限;不输出其他stdout文本。session为 `[active,count,generation,pins[8],active_low[8],logical[8]]`;pins为24个 `[owner,direction,raw]`;events为本命令发生的回调数组,元素是 `[operation,pin,raw,result]`,operation字符串为R(request)、D(direction)、W(write)、X(release)。arguments为本命令整数参数的调用后观察,必须保持原输入。所有数值为整数,不能以JSON布尔代替。 9. 初始和N后所有状态为0。request成功把pin置为[1,0,0];遇外部/自身占用或注入失败不改pin。direction成功在owner=1时置direction=1、raw为参数;write成功要求owner=1且direction=1,仅改raw;release清owner=1的pin为[0,0,0]。所有失败回调记录result=-1且不改pin,成功记0。R与X的事件raw固定-1;D与W记录传入电平。X按合同应只用于本会话持有pin。日志上限64项,正确库单条命令不会超过此限。 10. 固定观察模块负责读命令、设置故障和打印原始状态,不包含正确答案或断言。评分直接链接提交的两个C文件和该观察模块;全部公开库API及辅助接口都会独立调用,不要求特定内部实现。