Skip to content
Dokumentace

Berry Script pro FW 0.12.11

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

This content is not available in your language yet.

Co je Berry Script

Section titled “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

Section titled “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á

Section titled “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á

Section titled “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

Section titled “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

Section titled “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

Section titled “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

Section titled “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:

Související témata

Section titled “Související témata”