AccessControl & Expose#

local handle = expose(obj, typ, opcje)

-- Przekaźnik GPIO
local relay = GPIO_DOUT:new("RELAY1", 17, {activeLow = true})
expose(relay, "switch", {name = "Lampa salon"})

-- Obiekt z OM registry
expose(_:get("CLU.DOUT1"), "switch", {name = "Lampa kuchnia"})

-- Czujnik temperatury (wartość statyczna lub dynamiczna)
expose({value = 0, get = function(self) return self.value end}, "temperature", {
    name = "Temperatura salon"
})

-- Scena
scene("wieczor", function()
    _:get("CLU.DOUT1"):execute(DOUT.METHOD_SWITCH_ON)
    _:get("CLU.DOUT2"):execute(DOUT.METHOD_SWITCH_OFF)
end)
expose(getScene("wieczor"), "scene", {name = "Tryb wieczorny"})

local h = expose(obj, "switch", {name = "Lampa"})
h:name("Nowa nazwa")    -- zmień nazwę
h:readonly()             -- ustaw jako tylko-odczyt
h:mqttOnly()             -- wyłącz HomeKit
h:homekitOnly()          -- wyłącz MQTT
h:group("salon")         -- ustaw grupę

expose(obj, "switch"):name("Lampa"):readonly():mqttOnly()

h:getValue()        -- odczytaj aktualną wartość
h:setValue(1)        -- ustaw wartość (emituje state_changed)
                     -- nie działa gdy readonly

-- Zmień nazwę (aktualizuje discovery w HA i HomeKit)
h:rename("Zmieniona nazwa")

-- Zmień opcje (merge)
h:update({readonly = true})
h:update({mqtt = false})          -- ukryj z MQTT, zostaw HomeKit
h:update({homekit = false})       -- ukryj z HomeKit, zostaw MQTT

h:unexpose()        -- usuń obiekt z HA i HomeKit
h:isExposed()       -- sprawdź czy nadal wyeksponowany (true/false)

h:getPath()         -- zwraca ścieżkę, np. "vclu:switch1" lub "CLU.DOU123"

local count = exposeRegistry()
-- Zwraca: liczba nowo wyeksponowanych obiektów

-- user.lua
expose(_:get("CLU.DOUT1"), "switch", {name = "Moja lampa", readonly = true})

-- Później (np. w bootstrap)
exposeRegistry()  -- pominie CLU.DOUT1, bo już wyeksponowany

-- Odczytaj dostęp
local level = AccessControl.get("mqtt", "CLU.DOUT1")   -- "full"/"readonly"/"hidden"

-- Helpersy
AccessControl.isHidden("mqtt", "CLU.DOUT1")     -- true/false
AccessControl.isReadonly("mqtt", "CLU.DOUT1")   -- true/false
AccessControl.canControl("mqtt", "CLU.DOUT1")   -- true = level == "full"
AccessControl.canPublish("mqtt", "CLU.DOUT1")   -- true = level ~= "hidden"

-- Pobierz wszystkie reguły
local all = AccessControl.getAll()
-- { ["CLU.DOU1"] = { mqtt = "full", homekit = "hidden" }, ... }

objects:
  CLU221000290.DOU0001:
    mqtt: full
    homekit: hidden
  CLU221000290.DIMM0001:
    mqtt: readonly
    homekit: full
  CLU221000290.DOU0003:
    mqtt: hidden
    homekit: hidden

-- Przy eksponowaniu
expose(obj, "switch", {name = "Lampa", mqtt = false})

-- Albo w runtime na istniejącym handle
h:update({mqtt = false})

-- Przy eksponowaniu
expose(obj, "switch", {name = "Lampa", homekit = false})

-- Albo w runtime
h:update({homekit = false})

-- Dla obu integracji naraz
h:update({readonly = true})

h:unexpose()

h:rename("Nowa nazwa")
-- HA: re-publikuje discovery z nową nazwą
-- HomeKit: aktualizuje przy następnym odświeżeniu

local lock = expose(_:get("CLU.LOCK1"), "lock", {name = "Zamek drzwi"})

-- Scena "nocny" - wyłącz sterowanie zamkiem
scene("tryb_nocny", function()
    lock:update({readonly = true})
end)

-- Scena "dzienny" - przywróć pełne sterowanie
scene("tryb_dzienny", function()
    lock:update({readonly = false})
end)

-- user.lua

-- 1. Ręcznie eksponuj z własną nazwą i ustawieniami
expose(_:get("CLU.DOUT1"), "switch", {
    name = "Lampa salon",
    readonly = true,
    homekit = false
})

-- 2. Reszta obiektów z registry - automatycznie
exposeRegistry()
-- CLU.DOUT1 jest pominięty (już wyeksponowany ręcznie)
-- Reszta obiektów eksponowana z domyślnymi nazwami

local MySwitch = {}
function MySwitch:new()
    return setmetatable({_value = 0, _cbs = {}}, {__index = self})
end
function MySwitch:get(f) return self._value end
function MySwitch:set(f, v) self._value = v; self:_notify() end
function MySwitch:onChange(cb)
    table.insert(self._cbs, cb)
    return function()  -- MUSI zwrócić funkcję unsubscribe!
        for i, c in ipairs(self._cbs) do
            if c == cb then table.remove(self._cbs, i); break end
        end
    end
end
function MySwitch:_notify()
    for _, cb in ipairs(self._cbs) do cb(self._value) end
end

local sw = MySwitch:new()
expose(sw, "switch", {name = "Mój przełącznik"})
-- Teraz sw:set(0, 1) automatycznie aktualizuje stan w HA/HomeKit

-- Eksponuj obiekt na 5 minut (np. do testów)
local h = expose(obj, "switch", {name = "Tymczasowy"})

after(5 * 60 * 1000, function()
    h:unexpose()
    log.info("Tymczasowy obiekt usunięty")
end)

objects:
  CLU.DOU0001:
    mqtt: hidden
  CLU.DOU0002:
    mqtt: readonly
  CLU.DOU0003:
    mqtt: hidden
    homekit: hidden