#130 facility data object, some code cleanup, comms protocol changed from 1.0.1 to 1.1.0

supervisor/session/rsctl.lua

@@ -0,0 +1,39 @@
+--
+-- Redstone RTU Session I/O Controller
+--
+
+local rsctl = {}
+
+-- create a new redstone RTU I/O controller
+---@param redstone_rtus table redstone RTU sessions
+function rsctl.new(redstone_rtus)
+    ---@class rs_controller
+    local public = {}
+
+    -- write to a digital redstone port (applies to all RTUs)
+    ---@param port IO_PORT
+    ---@param value boolean
+    function public.digital_write(port, value)
+        for i = 1, #redstone_rtus do
+            local db = redstone_rtus[i].get_db()    ---@type redstone_session_db
+            local io = db.io[port]                  ---@type rs_db_dig_io|nil
+            if io ~= nil then io.write(value) end
+        end
+    end
+
+    -- read a digital redstone port<br>
+    -- this will read from the first one encountered if there are multiple, because there should not be multiple
+    ---@param port IO_PORT
+    ---@return boolean|nil
+    function public.digital_read(port)
+        for i = 1, #redstone_rtus do
+            local db = redstone_rtus[i].get_db()    ---@type redstone_session_db
+            local io = db.io[port]                  ---@type rs_db_dig_io|nil
+            if io ~= nil then return io.read() end
+        end
+    end
+
+    return public
+end
+
+return rsctl