AN08 Cyklický semafor v Lua podle tabulky

Podporovaná zařízení:  NETIO 4All, NETIO PowerPDU 4C, NETIO 4

Lua skript v této aplikační poznámce obsahuje v záhlaví uživatelem nadefinovanou tabulku 8 stavů, které ovládají periodické zapínání/vypínání čtyř výstupů zásuvek 230V (110/230V IEC-320 pro NETIO 4C). Každý z 8 stavů trvá nastavitelný čas, po který výstupy setrvají v nastavených hodnotách.
Počet stavů (řádků tabulky) lze rozšířit na víc než 8.

Akce výstupu může být 0/1, ale také 2/3 nebo 4, případně 5.

Akce 0 až 5 pro jednotlivé výstupy používá firma NETIO products ve všech M2M API.

Akce 2/3 slouží pro vytvoření pulsu na výstupu o definované délce. Lze tak například vytvořit stav, který trvá 5 sekund, ale jeden výstup se zapne pouze na 2 sekundy (state2 v příkladu).

Akce 5 je užitečná, pokud potřebujete výstup ovládat například tlačítkem na zařízení, nebo z jiného zdroje (mobilní aplikace, web rozhraní). Při použití akce 5 zůstane výstup beze změny.

Vytvoření pravidla (rule)

Pro vytvoření a spuštění Lua skriptu je nutné následující:

1) Ve webové administraci NETIO 4 v sekci Actions, přidejte pravidlo pomocí tlačítka Create Rule

------------Section 1------------
local states = {"0000,1", --state1
                "3001,5", --state2
                "0010,1", --state3
                "1011,1", --state4
                "1100,1", --state5
                "0101,1", --state6
                "0110,1", --state7
                "0111,1"} --state8

local shortTimeMs = 1000 -- time used in states 2 and 3
---------End of Section 1---------

local currentState = 1 -- internal variable, do not change
local value -- internal variable
local time -- internal variable

local function checkFormat()
  for i=1,#states do
    local time = tonumber(states[i]:sub(6))
    if time == nil or time < -1 then
      logf("Time in state %d is invalid!",i)
      return false
    end
    local comma = states[i]:sub(5,5)
    if comma ~= "," then
      logf("Time in state %d is not separated by comma!", i)
      return false
    end
    for j=1,4 do
      local test = tonumber(states[i]:sub(j,j))
      if test == nil or test > 5 or test < 0 then
        logf("Value in state %d for outlet %d is invalid!", i,j)        
        return false
      end 
    end  
  end  
  return true
end

local function trafficLights()
  --logf("Current state: %d",currentState)
  time = tonumber(states[currentState]:sub(6))
  for i=1,4 do
    value = tonumber(states[currentState]:sub(i,i))
    if value == 0 then -- turn off
      devices.system.SetOut{output = i, value = false}
    elseif value == 1 then -- turn on
      devices.system.SetOut{output = i, value = true}
    elseif value == 2 then -- short off
      devices.system.SetOut{output = i, value = false}
      milliDelay(shortTimeMs,function() short(i,true) end)
    elseif value == 3 then -- short on
      devices.system.SetOut{output = i, value = true}
      milliDelay(shortTimeMs,function() short(i,false) end)   
    elseif value == 4 then -- toggle
      if devices.system["output" ..i.. "_state"] == 'on' then  
        devices.system.SetOut{output=i,value=false}
      else
        devices.system.SetOut{output=i, value=true}
      end
    elseif value == 5 then
      -- do nothing
    end
  end
  currentState = (currentState%#states) + 1
  delay(time,function() trafficLights() end)
end

local function short(outlet,state)
  devices.system.SetOut{output=outlet,value=state}
end

if checkFormat() then
  trafficLights()
end

Ve stavu 1 se vypnou všechny výstupy. Za 30 sekund se semafor dostane do stavu 1 a zapne se výstup 4. Postupně se, počíaje výstupem 4, po 30 sekundách zapínají všechny výstupy až do stavu 5, kdy jsou všechny zapnuté. Poté se opět po 30 sekundách od výstupu 4 začnou vypínat. Ze stavu 8, kdy je zapnutý pouze výstup 1, přejde semafor opět do stavu 1 a celý cyklus se opakuje.

Ve stavu 8 je na jednom místě použit stav výstupu 5. Kdyby se v průběhu předchozího stavu změnil stav výstupu, nedojde k jeho vypnutí. Nechová se tedy stejně, jako kdyby tam byla 0.

Časté chyby

• Špatné formátování
  • "0000" - není udán čas
  • "0000.30" - mezi stavy a časem musí být čárka (,)
  • "0006,30" - hodnota stavu musí být 0-5
  • "000x,30" - pokud nechcete stav zásuvky měnit, použijte hodnotu 5
  •  0000,30  - chybí uvozovky

Spuštění skriptu

Po nastavení všech parametrů a uložení skriptu je potřeba restartovat chytré zásuvky NETIO. Po opětovném naběhnutí systému se skript spustí a výstupy se začnou nastavovat podle tabulky. Pokud se skript nespustí zkontrolujte nastavení.

FAQ:

1) Je možné mít jiný počet stavů než je 8?

Ano, do proměnné states můžete vložit tolik stavů, kolik budete chtít. Nezapomeňte ale na správné formátování. Před prvním a posledním stavem musí být složené závorky a jednotlivé stavy musí být odděleny čárkou, viz obrázky.

Ukázky pro 4 a 10 stavů:

Tato Aplikační poznámka může být použita v:

	NETIO 4 NETIO 4 je PDU modul čtyř zásuvek 230V/8A s připojením do počítačové sítě pomocí LAN a WiFi. Každou ze zásuvek lze individuláně vypnout/zapnout pomocí různých M2M API protokolů. NETIO 4 je unikátní produkt, který najde uplatnění v IT, průmyslu, chytrých domech, multimediálních instalacích atd. Všude, kde potřebujete zásuvky na 230V ovládané z mobilní aplikace, z nějakého programu (M2M API), z uživatelského skriptu (Lua), z funkcí časovač (Scheduler) a automatický restartér (IP WatchDog). Více o NETIO 4
	NETIO 4All NETIO 4All je PDU modul čtyř elektrických zásuvek 230V/8A s měřením spotřeby na každé zásuvce, který lze připojit do počítačové sítě pomocí LAN a WiFi. Každou ze čtyř zásuvek lze individuálně vypnout/zapnout přes web nebo pomocí různých M2M API protokolů. Na každé zásuvce lze měřit její spotřebu elektřiny (A, W, kWh). Chytré zásuvky NETIO 4All jsou určeny pro aplikace vzdáleného měření a ovládání elektrických zásuvek. Více o NETIO 4All
	NETIO PowerPDU 4C NETIO PowerPDU 4C je malé PDU (Power Distribution Unit) na 110/230V. Každý ze čtyř výstupů IEC-320 C13 lze ovládat samostatně (On / Off / Reset / přepni). Na každém výstupu jsou měřeny elektrické veličiny (A, W, kWh, TPF, V, Hz) s vysokou přesností. Zařízení obsahuje dva LAN porty pro připojení do sítě (vestavěný Ethernet switch). Každý výstup napájení podporuje ZCS (Zero Current Switching), to znamená šetrné ovládání připojených zařízení. Více o NETIO PowerPDU 4C