local comms = require("scada-common.comms") local log = require("scada-common.log") local mqueue = require("scada-common.mqueue") local rsio = require("scada-common.rsio") local util = require("scada-common.util") -- supervisor rtu sessions (svrs) local svrs_boiler = require("supervisor.session.rtu.boiler") local svrs_emachine = require("supervisor.session.rtu.emachine") local svrs_envd = require("supervisor.session.rtu.envd") local svrs_redstone = require("supervisor.session.rtu.redstone") local svrs_sna = require("supervisor.session.rtu.sna") local svrs_sps = require("supervisor.session.rtu.sps") local svrs_turbine = require("supervisor.session.rtu.turbine") local rtu = {} local PROTOCOLS = comms.PROTOCOLS local SCADA_MGMT_TYPES = comms.SCADA_MGMT_TYPES local RTU_UNIT_TYPES = comms.RTU_UNIT_TYPES local print = util.print local println = util.println local print_ts = util.print_ts local println_ts = util.println_ts local RTU_S_CMDS = { } local RTU_S_DATA = { RS_COMMAND = 1, UNIT_COMMAND = 2 } rtu.RTU_S_CMDS = RTU_S_CMDS rtu.RTU_S_DATA = RTU_S_DATA local PERIODICS = { KEEP_ALIVE = 2.0 } ---@class rs_session_command ---@field reactor integer ---@field channel RS_IO ---@field value integer|boolean -- create a new RTU session ---@param id integer ---@param in_queue mqueue ---@param out_queue mqueue ---@param advertisement table function rtu.new_session(id, in_queue, out_queue, advertisement) local log_header = "rtu_session(" .. id .. "): " local self = { id = id, in_q = in_queue, out_q = out_queue, advert = advertisement, -- connection properties seq_num = 0, r_seq_num = nil, connected = true, rtu_conn_watchdog = util.new_watchdog(3), last_rtt = 0, rs_io_q = {}, units = {} } ---@class rtu_session local public = {} -- parse the recorded advertisement and create unit sub-sessions local function _handle_advertisement() self.units = {} self.rs_io_q = {} for i = 1, #self.advert do local unit = nil ---@type unit_session|nil local rs_in_q = nil ---@type mqueue|nil ---@type rtu_advertisement local unit_advert = { type = self.advert[i][1], index = self.advert[i][2], reactor = self.advert[i][3], rsio = self.advert[i][4] } local u_type = unit_advert.type -- create unit by type if u_type == RTU_UNIT_TYPES.REDSTONE then unit, rs_in_q = svrs_redstone.new(self.id, i, unit_advert, self.out_q) elseif u_type == RTU_UNIT_TYPES.BOILER then unit = svrs_boiler.new(self.id, i, unit_advert, self.out_q) elseif u_type == RTU_UNIT_TYPES.BOILER_VALVE then -- @todo Mekanism 10.1+ elseif u_type == RTU_UNIT_TYPES.TURBINE then unit = svrs_turbine.new(self.id, i, unit_advert, self.out_q) elseif u_type == RTU_UNIT_TYPES.TURBINE_VALVE then -- @todo Mekanism 10.1+ elseif u_type == RTU_UNIT_TYPES.EMACHINE then unit = svrs_emachine.new(self.id, i, unit_advert, self.out_q) elseif u_type == RTU_UNIT_TYPES.IMATRIX then -- @todo Mekanism 10.1+ elseif u_type == RTU_UNIT_TYPES.SPS then unit = svrs_sps.new(self.id, i, unit_advert, self.out_q) elseif u_type == RTU_UNIT_TYPES.SNA then unit = svrs_sna.new(self.id, i, unit_advert, self.out_q) elseif u_type == RTU_UNIT_TYPES.ENV_DETECTOR then unit = svrs_envd.new(self.id, i, unit_advert, self.out_q) else log.error(log_header .. "bad advertisement: encountered unsupported RTU type") end if unit ~= nil then table.insert(self.units, unit) if self.rs_io_q[unit_advert.reactor] == nil then self.rs_io_q[unit_advert.reactor] = rs_in_q else self.units = {} self.rs_io_q = {} log.error(log_header .. "bad advertisement: duplicate redstone RTU for reactor " .. unit_advert.reactor) break end else self.units = {} self.rs_io_q = {} local type_string = comms.advert_type_to_rtu_t(u_type) if type_string == nil then type_string = "unknown" end log.error(log_header .. "bad advertisement: error occured while creating a unit (type is " .. type_string .. ")") break end end end -- mark this RTU session as closed, stop watchdog local function _close() self.rtu_conn_watchdog.cancel() self.connected = false -- mark all RTU unit sessions as closed so the reactor unit knows for i = 1, #self.units do self.units[i].close() end end -- send a SCADA management packet ---@param msg_type SCADA_MGMT_TYPES ---@param msg table local function _send_mgmt(msg_type, msg) local s_pkt = comms.scada_packet() local m_pkt = comms.mgmt_packet() m_pkt.make(msg_type, msg) s_pkt.make(self.seq_num, PROTOCOLS.SCADA_MGMT, m_pkt.raw_sendable()) self.out_q.push_packet(s_pkt) self.seq_num = self.seq_num + 1 end -- handle a packet ---@param pkt modbus_frame|mgmt_frame local function _handle_packet(pkt) -- check sequence number if self.r_seq_num == nil then self.r_seq_num = pkt.scada_frame.seq_num() elseif self.r_seq_num >= pkt.scada_frame.seq_num() then log.warning(log_header .. "sequence out-of-order: last = " .. self.r_seq_num .. ", new = " .. pkt.scada_frame.seq_num()) return else self.r_seq_num = pkt.scada_frame.seq_num() end -- feed watchdog self.rtu_conn_watchdog.feed() -- process packet if pkt.scada_frame.protocol() == PROTOCOLS.MODBUS_TCP then if self.units[pkt.unit_id] ~= nil then local unit = self.units[pkt.unit_id] ---@type unit_session unit.handle_packet(pkt) end elseif pkt.scada_frame.protocol() == PROTOCOLS.SCADA_MGMT then -- handle management packet if pkt.type == SCADA_MGMT_TYPES.KEEP_ALIVE then -- keep alive reply if pkt.length == 2 then local srv_start = pkt.data[1] local rtu_send = pkt.data[2] local srv_now = util.time() self.last_rtt = srv_now - srv_start if self.last_rtt > 500 then log.warning(log_header .. "RTU KEEP_ALIVE round trip time > 500ms (" .. self.last_rtt .. "ms)") end -- log.debug(log_header .. "RTU RTT = ".. self.last_rtt .. "ms") -- log.debug(log_header .. "RTU TT = ".. (srv_now - rtu_send) .. "ms") else log.debug(log_header .. "SCADA keep alive packet length mismatch") end elseif pkt.type == SCADA_MGMT_TYPES.CLOSE then -- close the session _close() elseif pkt.type == SCADA_MGMT_TYPES.RTU_ADVERT then -- RTU unit advertisement -- handle advertisement; this will re-create all unit sub-sessions self.advert = pkt.data _handle_advertisement() else log.debug(log_header .. "handler received unsupported SCADA_MGMT packet type " .. pkt.type) end end end -- PUBLIC FUNCTIONS -- -- get the session ID function public.get_id() return self.id end -- check if a timer matches this session's watchdog ---@param timer number function public.check_wd(timer) return self.rtu_conn_watchdog.is_timer(timer) and self.connected end -- close the connection function public.close() _close() _send_mgmt(SCADA_MGMT_TYPES.CLOSE, {}) println(log_header .. "connection to RTU closed by server") log.info(log_header .. "session closed by server") end -- iterate the session ---@return boolean connected function public.iterate() if self.connected then ------------------ -- handle queue -- ------------------ local handle_start = util.time() while self.in_q.ready() and self.connected do -- get a new message to process local msg = self.in_q.pop() if msg ~= nil then if msg.qtype == mqueue.TYPE.PACKET then -- handle a packet _handle_packet(msg.message) elseif msg.qtype == mqueue.TYPE.COMMAND then -- handle instruction elseif msg.qtype == mqueue.TYPE.DATA then -- instruction with body local cmd = msg.message ---@type queue_data if cmd.key == RTU_S_DATA.RS_COMMAND then local rs_cmd = cmd.val ---@type rs_session_command if rsio.is_valid_channel(rs_cmd.channel) then cmd.key = svrs_redstone.RS_RTU_S_DATA.RS_COMMAND if rs_cmd.reactor == nil then -- for all reactors (facility) for i = 1, #self.rs_io_q do local q = self.rs_io.q[i] ---@type mqueue q.push_data(msg) end elseif self.rs_io_q[rs_cmd.reactor] ~= nil then -- for just one reactor local q = self.rs_io.q[rs_cmd.reactor] ---@type mqueue q.push_data(msg) end end end end end -- max 100ms spent processing queue if util.time() - handle_start > 100 then log.warning(log_header .. "exceeded 100ms queue process limit") break end end -- exit if connection was closed if not self.connected then println(log_header .. "connection to RTU closed by remote host") log.info(log_header .. "session closed by remote host") return self.connected end ------------------ -- update units -- ------------------ local time_now = util.time() for i = 1, #self.units do self.units[i].update(time_now) end ---------------------- -- update periodics -- ---------------------- local elapsed = util.time() - self.periodics.last_update local periodics = self.periodics -- keep alive periodics.keep_alive = periodics.keep_alive + elapsed if periodics.keep_alive >= PERIODICS.KEEP_ALIVE then _send_mgmt(SCADA_MGMT_TYPES.KEEP_ALIVE, { util.time() }) periodics.keep_alive = 0 end self.periodics.last_update = util.time() end return self.connected end return public end return rtu