Berry Script pro FW 0.12.11

Verzovaný přehled role Berry Scriptu v kontrolerech Spectoda pro firmware 0.12.11.

Co je Berry Script

Berry Script je skriptovací vrstva, která běží přímo v kontroleru Spectoda. Slouží k tomu, aby bylo možné doplnit vlastní logiku projektu bez nutnosti upravovat samotný firmware.

V praxi jde o nástroj pro pokročilé tvůrce, integrátory a výrobce svítidel, kteří potřebují, aby se kontroler choval přesně podle konkrétního projektu.

Berry Script není:

cloudová automatizace
logika běžící v telefonu nebo v browseru
náhrada za základní nastavení ve Spectoda Studiu

Berry Script je naopak lokální logika běžící přímo tam, kde se ovládají světla, IO a události.

Kde má místo v ekosystému Spectoda

Ve Spectoda ekosystému sedí Berry Script mezi:

Controller Configem a definicí projektu
TNGL / logikou vytvořenou ve Studiu
runtime vrstvou kontroleru a jeho IO

To znamená, že Berry Script může navázat na nastavení kontroleru a doplnit vlastní chování nad tím, co už je v projektu definováno.

Typicky pracuje s těmito vrstvami:

io pro přístup ke konkrétním vstupům a výstupům kontroleru
spectoda pro práci s událostmi, zprávami a mapováním IO
controller pro informace o běžícím kontroleru
timeline pro časové a datumové informace

K čemu se Berry Script používá

Berry Script dává smysl všude tam, kde nestačí jen základní konfigurace a je potřeba doplnit vlastní projektovou logiku.

Typické scénáře:

reakce na tlačítka, senzory a jiné vstupy
vlastní vazby mezi IO a EventState
převod externích protokolů na chování světel v síti Spectoda
pluginová logika běžící průběžně v kontroleru
doplnění specifické podpory pro nestandardní periferie nebo zařízení

V praxi se tak Berry Script často používá například pro:

návaznost fyzických vstupů na světelné scény
projektovou logiku nad DALI, DMX, Art-Net nebo sACN integrací
vlastní zpracování dat z připojených zařízení
jemné doladění chování svítidla bez zásahu do C++ části firmware

Jaké stavební bloky Berry Script používá

Spectoda nad Berry vrstvou zpřístupňuje několik základních objektů a helperů:

VAL pro práci s typovanou hodnotou
EVS pro stavové hodnoty typu EventState
EVT pro emisi událostí
Plugin(...) pro průběžně volanou logiku kontroleru

Zjednodušeně:

VAL řeší, jakou hodnotu skript drží nebo posílá
EVS řeší, jaký stav se v síti sleduje
EVT řeší, jak vyvolat událost
Plugin(...) řeší, co se má pravidelně vyhodnocovat

Berry Script tak není izolovaný „mini jazyk bokem“, ale přímo součást řídicí vrstvy Spectoda.

Odkud se Berry Script bere

V aktuálním modelu Spectoda se Berry Script může do kontroleru dostat několika cestami:

jako součást Controller Configu
jako doplňující skripty připojené k projektu
jako logika odvozená z projektové definice a TNGL vrstvy
jako pluginová logika, která má v kontroleru zůstat aktivní trvale

Pro uživatele je důležité hlavně toto:

Berry Script je součástí projektu kontroleru
načítá se do běžícího runtime kontroleru
výsledné chování je vykonáváno lokálně v zařízení

Díky tomu může systém reagovat rychle a nezávisle na připojení telefonu, browseru nebo cloudu.

Kdy Berry Script použít a kdy ne

Berry Script použijte ve chvíli, kdy:

potřebujete vlastní logiku přímo v kontroleru
propojujete více technologií a potřebujete mezi nimi vlastní vrstvu chování
řešíte pokročilé integrace nebo netypické zařízení

Berry Script naopak často není potřeba, pokud:

vám stačí standardní nastavení ve Spectoda Studiu
řešíte jen základní mapování IO
nepotřebujete vlastní reakce nebo transformaci dat

Dobré pravidlo je:

Nejprve navrhněte projekt standardní cestou přes konfiguraci a Studio. Berry Script přidávejte ve chvíli, kdy už víte, jakou konkrétní logiku potřebujete doplnit.

Praktický dopad pro tvůrce a výrobce

Berry Script rozšiřuje Spectoda ekosystém o vrstvu, díky které lze z jednoho kontroleru udělat nejen vykonavatele předem připravených scén, ale i aktivní řídicí prvek s vlastní logikou.

To je důležité hlavně pro:

výrobce svítidel, kteří potřebují specifické chování produktu
integrátory, kteří propojují Spectodu s dalšími technologiemi
pokročilé tvůrce, kteří chtějí nad projektem jemnější kontrolu

Berry Script tedy není jen „skript navíc“, ale praktický nástroj pro rozšíření schopností kontroleru v rámci celého Spectoda ekosystému.

Praktická témata pro FW 0.12.11

Ve firmware 0.12.11 je k dispozici také obecné I2C API pro Berry Script.

Pokud potřebujete:

číst data z vlastního I2C senzoru
zapisovat registry externí periferie
postavit si device-specific driver přímo v projektu

pokračujte na samostatnou stránku:

Berry I2C pro FW 0.12.11