/* Finite-capacity boundaries inaccessible through practical wire traffic. * Include the implementation only in this executable; the build must exclude * its separate translation unit. Production has no cursor/identity setters. */ #define main remote_parameter_public_suite_main #include "iec104_remote_parameter_test.c" #undef main #include "IEC104_RemoteParameter.c" /** * 功能:专用于 SIZE_MAX 游标探针:按模式结束遍历或追加空值条目,以触发后续游标越界检查。 * 输入参数:context——业务回调的测试上下文;request——当前业务请求(只读);index——待访问或核对的条目下标;ioa——信息对象地址;frame——读取结果帧或报文缓冲区。 * 输出参数:frame——追加定值元素后的读取帧。 * 返回值:查值结果,区分追加成功、结束/跳过、容量不足及失败。 * 说明:检查不满足时由 CHECK 立即报告失败,不继续本用例。 */ static IEC104_RemoteParameterLookupResult_t exhausted_lookup(void *context, const IEC104_RemoteParameterRequest_t *request, size_t index, uint32_t ioa, IEC104_RemoteParameterFrame_t *frame) { CHECK(context==&rp&&request->count==0&&index==SIZE_MAX&&ioa==0); ++rp.lookups; if(rp.lookup_mode==0)return IEC104_REMOTE_PARAMETER_LOOKUP_END; CHECK(IEC104_RemoteParameter_Add_Bytes(frame,0x8001,NULL,0)==IEC104_REMOTE_PARAMETER_ADD_OK); return IEC104_REMOTE_PARAMETER_LOOKUP_ADDED; } /** * 功能:验证 SIZE_MAX 上仅 END 可成功。 * 输入参数:无。 * 输出参数:无。 * 返回值:无。 * 说明:继续追加条目时,首帧前后均终止读取并给出对应否定确认。 */ static void test_index_exhaustion(void) { IEC104_RemoteParameterHandlers_t exhausted={action,exhausted_lookup}; unsigned branch; for(branch=0;branch<3;++branch){ open_rp();send_rp(read_all,8); if(branch==2){CHECK(execute()==IEC104_REMOTE_PARAMETER_EXECUTE_OK);flush();clear_wire();} rp.module->tasks[rp.module->order[0]].cursor=SIZE_MAX; rp.lookup_mode=branch==0?0:1; CHECK(IEC104_RemoteParameter_Execute_Next(rp.module,&exhausted,&rp)==IEC104_REMOTE_PARAMETER_EXECUTE_OK); flush(); if(branch==0){ const uint8_t expected[]={202,0,7,17,1,0,1,0,0};expect(0,expected,sizeof(expected)); CHECK(status().reads_completed==1&&status().invalid_callbacks==0); }else if(branch==1){ const uint8_t expected[]={202,0,71,17,1,0,1,0};expect(0,expected,sizeof(expected)); CHECK(status().reads_aborted==1&&status().invalid_callbacks==1); }else{ const uint8_t expected[]={202,0,71,17,1,0,1,0,0};expect(0,expected,sizeof(expected)); CHECK(status().reads_aborted==1&&status().invalid_callbacks==1); } CHECK(status().pending_requests==0);close_rp(); } } /** * 功能:验证实例序号耗尽时创建失败,恢复计数后仍能正常创建和释放实例。 * 输入参数:无。 * 输出参数:无。 * 返回值:无。 * 说明:检查不满足时由 CHECK 立即报告失败,不继续本用例。 */ static void test_instance_exhaustion(void) { uint64_t saved; IEC104_Slave_t *slave=IEC104_Slave_Create(); IEC104_RemoteParameterConfig_t config; IEC104_RemoteParameter_t *module; CHECK(slave!=NULL);IEC104_RemoteParameter_Config_Default(&config); saved=next_instance_id;next_instance_id=UINT64_MAX; CHECK(IEC104_RemoteParameter_Create(slave,&config)==NULL); next_instance_id=saved; module=IEC104_RemoteParameter_Create(slave,&config);CHECK(module!=NULL); CHECK(IEC104_RemoteParameter_Destroy(module)); CHECK(IEC104_Slave_Destroy(slave,NULL)==IEC104_TCP_OK); } /** * 功能:验证重连后旧预置仍按原连接代次 DISCARD,清理前禁止销毁。 * 输入参数:无。 * 输出参数:无。 * 返回值:无。 * 说明:普通实例可接受新代次请求,已故障实例继续拒绝业务且不重复关链。 */ static void test_generation_boundaries(void) { unsigned fault,i; uint64_t generation; IEC104_SlaveEvent_t event; for(fault=0;fault<2;++fault){ open_rp();mirror(preset1,16,7);generation=rp.first.generation; if(fault){ rp.send_fault=2;rp.close_fault=1;send_rp(area1,9); CHECK(execute()==IEC104_REMOTE_PARAMETER_EXECUTE_OK); CHECK(status().faulted&&rp.closes==1); } fake.recv_eof=1;poll_rp();fake.recv_eof=0; CHECK(status().discard_pending&&!status().recovery_required); rp.send_fault=0;fake.accept_pending=1;poll_rp(); push(start_act,sizeof(start_act));poll_rp();rp.ns=rp.nr=0;fake.sent_bytes=0; CHECK(status().generation!=generation&&status().discard_pending); CHECK(!IEC104_RemoteParameter_Destroy(rp.module)); CHECK(execute()==IEC104_REMOTE_PARAMETER_EXECUTE_OK); CHECK(rp.last.operation==IEC104_REMOTE_PARAMETER_OP_DISCARD&&rp.last.generation==generation); CHECK(rp.calls[7]==1&&!rp.staged&&rp.closes==fault); send_rp(preset1,16); if(fault){ CHECK(status().faulted&&status().faulted_dropped==1&&status().pending_requests==0); CHECK(rp.closes==1&&rp.calls[4]==1); CHECK(IEC104_RemoteParameter_Destroy(rp.module)); CHECK(IEC104_Slave_Close(rp.slave,NULL)==IEC104_TCP_OK); while(IEC104_Slave_NextEvent(rp.slave,&event)==IEC104_TCP_EVENT_READY){} for(i=0;i<2;++i){ CHECK(IEC104_Slave_Remove_Station(rp.slave,&rp.stations[i])==IEC104_STATION_OK); CHECK(IEC104_Station_Is_Reusable(&rp.stations[i])); } CHECK(IEC104_Slave_Destroy(rp.slave,NULL)==IEC104_TCP_OK); }else{ CHECK(execute()==IEC104_REMOTE_PARAMETER_EXECUTE_OK); CHECK(rp.first.generation!=generation&&rp.calls[4]==2); close_rp(); } } } /** * 功能:运行游标耗尽、实例耗尽及跨连接代次清理三个内部边界专项。 * 输入参数:无。 * 输出参数:无。 * 返回值:正常完成返回 0;参数、运行或断言失败以非零状态结束进程。 * 说明:本辅助入口用于构造或核对上述测试场景,相关状态保存在当前测试夹具中。 */ int main(void) { test_index_exhaustion(); test_instance_exhaustion(); test_generation_boundaries(); printf("RemoteParameter internal: SIZE_MAX, instance exhaustion and generation boundaries PASS\n"); return 0; }