/* Independent wire expectations for the optional Type200..203 example. * Usage: node test/remote_parameter_loopback_test.cjs .build//iec104_slave_example.exe * Local TCP verifies application integration, not external-master interoperability. */ 'use strict'; const assert = require('node:assert/strict'); const net = require('node:net'); const path = require('node:path'); const { spawn } = require('node:child_process'); const { once } = require('node:events'); const { setTimeout: delay } = require('node:timers/promises'); const { Master } = require('./slave_example_loopback_test.cjs'); const executable = path.resolve(process.argv[2]); const build = path.resolve(__dirname, '..', '.build'); const relative = path.relative(build, executable); assert(relative !== '' && relative !== '..' && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative)); const children = [], sockets = []; const ioas = [0x8001, 0x8003, 0x8005, 0x8006, 0x8020, 0x8221, 0x8224]; const head = (type, count, cot = 6) => Buffer.from([type, count, cot, 0x72, 7, 0]); const u16 = value => { const b = Buffer.alloc(2); b.writeUInt16LE(value); return b; }; const address = value => Buffer.from([value & 255, (value >> 8) & 255, (value >> 16) & 255]); const element = (ioa, tag, value) => Buffer.concat([address(ioa), Buffer.from([tag, value.length]), value]); const floating = value => { const b = Buffer.alloc(4); b.writeFloatLE(value); return b; }; const read = (sn, addresses = []) => Buffer.concat([head(202, addresses.length), u16(sn), ...addresses.map(address)]); const preset = (sn, elements, more = false, test = false) => Buffer.concat([ head(203, elements.length, test ? 0x86 : 6), u16(sn), Buffer.from([more ? 0x81 : 0x80]), ...elements]); const end = (sn, cancel = false, test = false) => Buffer.concat([ head(203, 0, (cancel ? 8 : 6) | (test ? 0x80 : 0)), u16(sn), Buffer.from([0])]); function launch(enabled, runMs) { const args = ['--port', '0', '--ca', '7', '--events', '0', '--background-ms', '0', '--run-ms', String(runMs)]; if (enabled) args.push('--remote-parameter'); const child = spawn(executable, args, { windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'] }); const process = { child, output: '', errors: '', done: false }; child.stdout.on('data', b => { process.output += b; }); child.stderr.on('data', b => { process.errors += b; }); process.exit = once(child, 'close').then(([code, signal]) => { process.done = true; return { code, signal }; }); process.exit.catch(() => {}); process.timer = setTimeout(() => child.kill(), runMs + 5000); children.push(process); return process; } async function listener(process) { const deadline = Date.now() + 2500; while (!process.done && !/LISTEN 127\.0\.0\.1:(\d+) CA=7/.test(process.output) && Date.now() < deadline) await delay(10); const match = process.output.match(/LISTEN 127\.0\.0\.1:(\d+) CA=7/); assert(match, `${process.output}\n${process.errors}`); return Number(match[1]); } async function connect(port, coi = 0) { const socket = net.connect({ host: '127.0.0.1', port }); sockets.push(socket); const master = new Master(socket); master.asynchronous = true; await once(socket, 'connect'); await master.control(7, 0x0b); assert.deepEqual([...await master.readASDU()], [70, 1, 4, 0, 7, 0, 0, 0, 0, coi]); return master; } async function response(master, request) { await master.send(request); return master.readASDU(); } async function mirror(master, request, cot = 7, cancel = false) { const expected = Buffer.from(request); expected[2] = cot | (request[2] & 0x80); if (cancel) expected[8] = 0x40; assert.deepEqual(await response(master, request), expected); } async function values(master, sn, addresses = [], test = false) { const request = read(sn, addresses); if (test) request[2] |= 0x80; await master.send(request); const result = []; for (let frames = 0; frames < 8; ++frames) { const frame = await master.readASDU(); assert.deepEqual([...frame.subarray(0, 1)], [202]); assert.equal(frame[2], test ? 0x87 : 7); assert.deepEqual([...frame.subarray(3, 6)], [0x72, 7, 0]); assert.equal(frame.readUInt16LE(6), sn); assert.equal(frame[8] & ~1, 0); let offset = 9; for (let i = 0; i < frame[1]; ++i) { assert(offset + 5 <= frame.length); const ioa = frame.readUIntLE(offset, 3), tag = frame[offset + 3], length = frame[offset + 4]; assert(offset + 5 + length <= frame.length); const raw = frame.subarray(offset + 5, offset + 5 + length); const value = tag === 4 ? raw.toString('ascii') : tag === 45 ? raw.readUInt16LE() : tag === 35 ? raw.readUInt32LE() : raw.readFloatLE(); result.push({ ioa, tag, value }); offset += 5 + length; } assert.equal(offset, frame.length); if (frame[8] === 0) return result; } throw new Error('Read did not terminate'); } async function area(master, expected) { assert.deepEqual(await response(master, Buffer.concat([head(201, 1), address(0)])), Buffer.from([201, 1, 7, 0x72, 7, 0, 0, 0, 0, expected, 0, 0, 0, 4, 0])); } async function finish(process) { assert.deepEqual(await process.exit, { code: 0, signal: null }, `${process.output}\n${process.errors}`); assert.equal(process.errors, ''); clearTimeout(process.timer); } async function exercise() { const process = launch(true, 6500), port = await listener(process); let master = await connect(port); await area(master, 0); for (const sn of [1, 4, 5]) { await mirror(master, Buffer.concat([head(200, 1), address(0), u16(sn)]), sn === 5 ? 0x47 : 7); } await area(master, 4); const initial = await values(master, 0); assert.deepEqual(initial.map(x => x.ioa), ioas); assert.deepEqual(initial.slice(0, 4).map(x => x.value), ['DTU\0', 'Example\0', '1\0', 0xCBF43926]); assert.deepEqual((await values(master, 1)).map(x => x.ioa), [0x8221, 0x8224]); // 202读取请求SN对应的已保存一套;当前选中4区时仍可逐区读取,读取不能隐式切区。 for (const [sn, expected] of [[0, [30, 1]], [1, [60, 2]], [2, [90, 3]], [3, [120, 4]], [4, [150, 5]]]) { assert.deepEqual((await values(master, sn, [0x8221, 0x8224])).map(x => x.value), expected); } await area(master, 4); await mirror(master, read(1, [0x8001]), 0x47); await mirror(master, read(0, [0x9000]), 0x6f); const first = preset(1, [element(0x8221, 45, u16(10))], true); await mirror(master, first); assert.equal((await values(master, 1, [0x8221]))[0].value, 60); await mirror(master, end(1), 0x47); // incomplete batch cannot solidify await mirror(master, Buffer.concat([head(200, 1), address(0), u16(0)]), 0x47); await mirror(master, preset(1, [element(0x8224, 38, floating(2.5)), element(0x8221, 45, u16(11))])); await mirror(master, end(1)); assert.deepEqual((await values(master, 1)).map(x => x.value), [11, 2.5]); assert.deepEqual((await values(master, 1, [0x8221, 0x8221], true)).map(x => x.value), [11, 11]); // 固化1区不会从4区自动切过去;显式200切入后才选用刚保存的11/2.5。 await area(master, 4); assert.deepEqual((await values(master, 4)).map(x => x.value), [150, 5]); await mirror(master, Buffer.concat([head(200, 1), address(0), u16(1)])); await area(master, 1); // 当前区固化直接更新当前配置,预置期间仍保持原值;未写的复归时间须保留11。 await mirror(master, preset(1, [element(0x8224, 38, floating(3.5))])); assert.deepEqual((await values(master, 1)).map(x => x.value), [11, 2.5]); await mirror(master, end(1)); assert.deepEqual((await values(master, 1)).map(x => x.value), [11, 3.5]); assert.deepEqual((await values(master, 0, [0x8221, 0x8224])).map(x => x.value), [30, 1]); // Read-only rejection discards candidates and erects the recovery boundary. await mirror(master, preset(0, [element(0x8020, 38, floating(3)), element(0x8001, 4, Buffer.from('X\0'))]), 0x47); await mirror(master, preset(0, [element(0x8020, 38, floating(4))]), 0x47); await mirror(master, end(4, true), 9, true); assert.equal((await values(master, 0, [0x8020]))[0].value, 0); await mirror(master, preset(0, [element(0x8020, 38, floating(4))])); await mirror(master, end(0)); assert.equal((await values(master, 0, [0x8020]))[0].value, 4); await area(master, 1); // SN0公共死区固化不切区,但随后日志中的当前1区配置应使用公共值4。 // CANCEL carries SN2 while cleaning the original SN1 staging area only. await mirror(master, preset(1, [element(0x8221, 45, u16(99))])); await mirror(master, end(2, true), 9, true); assert.equal((await values(master, 1, [0x8221]))[0].value, 11); assert.equal((await values(master, 2, [0x8221]))[0].value, 90); await mirror(master, preset(1, [element(0x8221, 45, u16(77))], false, true)); await mirror(master, end(1, false, true)); assert.equal((await values(master, 1, [0x8221]))[0].value, 11); await mirror(master, Buffer.concat([head(200, 1, 0x86), address(0), u16(4)])); await area(master, 1); // TEST切区也只能模拟,不能改变应用选中的一套。 await mirror(master, preset(1, [element(0x8221, 45, u16(66))], true)); const broken = preset(1, [element(0x8224, 38, floating(3))]).subarray(0, 13); await mirror(master, broken, 0x47); await mirror(master, end(1), 0x47); await mirror(master, end(1, true), 9, true); assert.deepEqual((await values(master, 1)).map(x => x.value), [11, 3.5]); // STOP discards the unfinished batch but preserves published runtime values. await mirror(master, preset(1, [element(0x8221, 45, u16(88))], true)); await master.control(0x13, 0x23); await master.control(7, 0x0b); // INIT_EVERY_START在同一TCP再次启动时也发送初始化结束;远程定值仍走HIGH。 assert.deepEqual([...await master.readASDU()], [70, 1, 4, 0, 7, 0, 0, 0, 0, 0]); assert.equal((await values(master, 1, [0x8221]))[0].value, 11); await area(master, 1); const closed = once(master.socket, 'close'); await mirror(master, Buffer.from([105, 1, 6, 0x72, 7, 0, 0, 0, 0, 1])); await closed; await delay(80); master = await connect(port, 2); await area(master, 0); for (const [sn, expected] of [[0, [30, 1]], [1, [60, 2]], [2, [90, 3]], [3, [120, 4]], [4, [150, 5]]]) { assert.deepEqual((await values(master, sn, [0x8221, 0x8224])).map(x => x.value), expected); } assert.deepEqual((await values(master, 0, [0x8005, 0x8006, 0x8020])).map(x => x.value), ['1\0', 0xCBF43926, 0]); await mirror(master, preset(0, [element(0x8020, 38, floating(5))], true)); await master.close(); // disconnect must deliver one final DISCARD await finish(process); assert.match(process.output, /REMOTE_PARAMETER .*solidified=3 .*discards=3 .*recovery_required=0 faulted=0/); // 完整退出后再检查stdout,避免TCP确认与管道分块的先后造成偶发失败。 // 这里独立核对应用真正选中的配置:预置、撤销、拒绝及TEST均不得增加一条变更记录。 assert.deepEqual(process.output.split(/\r?\n/).filter(line => line.startsWith('REMOTE_SETTINGS ')), [ 'REMOTE_SETTINGS reason=init target_area=0 current_area=0 reset_seconds=30 x_time=1 deadband=0', 'REMOTE_SETTINGS reason=switch target_area=1 current_area=1 reset_seconds=60 x_time=2 deadband=0', 'REMOTE_SETTINGS reason=switch target_area=4 current_area=4 reset_seconds=150 x_time=5 deadband=0', 'REMOTE_SETTINGS reason=solidify target_area=1 current_area=4 reset_seconds=150 x_time=5 deadband=0', 'REMOTE_SETTINGS reason=switch target_area=1 current_area=1 reset_seconds=11 x_time=2.5 deadband=0', 'REMOTE_SETTINGS reason=solidify target_area=1 current_area=1 reset_seconds=11 x_time=3.5 deadband=0', 'REMOTE_SETTINGS reason=solidify target_area=0 current_area=1 reset_seconds=11 x_time=3.5 deadband=4', 'REMOTE_SETTINGS reason=reset target_area=0 current_area=0 reset_seconds=30 x_time=1 deadband=0', 'REMOTE_SETTINGS reason=exit target_area=0 current_area=0 reset_seconds=30 x_time=1 deadband=0' ]); const disabled = launch(false, 1000); const legacy = await connect(await listener(disabled)); await mirror(legacy, Buffer.concat([head(201, 1), address(0)]), 0x6c); await legacy.close(); await finish(disabled); assert(!disabled.output.includes('REMOTE_PARAMETER')); assert(!disabled.output.includes('REMOTE_SETTINGS')); } exercise().then(() => console.log('Remote parameter example TCP loopback passed')).catch(error => { console.error(error); for (const child of children) console.error(child.output, child.errors); process.exitCode = 1; }).finally(async () => { for (const socket of sockets) socket.destroy(); for (const child of children) { clearTimeout(child.timer); if (!child.done) child.child.kill(); } await Promise.allSettled(children.map(child => child.exit)); });