User manual
Program
Tento program je uren pro mení okolního svtla. V tomto pípad však nedojde k výstupu dat
na web, ale pímo na webovou stránku ThingSpeak. Na stránce pitom nedochází k uložení dat,
ale k jejich zobrazení v pehledném grafickém režimu. Tento zpsob zobrazení je velmi praktický
pro mící stanice s dlouhodobým monitoringem. Aby byl program schopen odeslat data na website,
bude zapotebí zadní klíe API, který je v programu uveden pod položkou ThingSpeakKEY spolen
s WLAN daty. Po natení programu budou k dispozici namené hodnoty zobrazené na sériovém
rozhraní. Data nashromáždná po dobu 15. sekund jsou následn zprmrována a poté odeslána
na stránku ThingSpeak. Interval 15. sekund hraje velmi významnou roli. Nemže tak docházet
k odesílání dat každou sekundu. Výsledné hodnoty (prmr) jsou pak zobrazeny na stránce
s kanály v grafu.
Zdrojový text se výrazn liší od pedchozích program. Pesto obsahuje všechny doposud známe
prvky. Progmem zahrnuje HTTP request, který musí být odeslán na ThingSpeak page a stejn tak
i nkteré placeholdery, které budou v pípad poteby zamnny.
POST *URL* HTTP/1.1
Host: api.thingspeak.com
Connection: close
Content-Type: application/x-www-form-urlencoded
Content-Length: *LEN*
*APPEND*
Znovu bude zapotebí zadání „URL“. Stejn tak musí být zamnna „LEN“ délkou zápisu, který zadáte
namísto „APPEND“. Jedná se o universální, platný formát website, kterým dochází k odesílání dat
na stránky s POST-request. V pípad, že budete chtít zadat namená data do vytvoeného kanálu,
musíte použít následující strukturu: „URL“ je /update, což je sub-page, na kterou se musí odeslat data.
Zápis je tak vytvoen díky API key, obsahu pole a hodnot.
POST /update HTTP/1.1
Host: api.thingspeak.com
Connection: close
Content-Type: application/x-www-form-urlencoded
Content-Length: 35
api_key=GXE93O4WF03Q3X8I&field1=954
Website umožuje identifikaci uživatele a kanálu pomocí klíe API a automaticky vkládá hodnoty.
Pro odeslání nové hodnoty musí dojít k volání (call) funkce sendThingPost(), která vyžaduje parametr
KEY a data senzoru. Ostatní procesy pak budou probíhat na pozadí zcela automaticky.
Twitch Display
Website ThingSpeak disponuje daleko vtším množstvím funkcí, než je jen monitoring senzor.
Následující projekt bude velmi podobný projektm s TCP klientem. Informace se pitom shromažují
z website na internetu. V tomto pípad je specifický datový stream on-line nebo není k dispozici.
Jednou z výhod je, že ThingSpeak mže volat website prostednictvím HTTPS (HyperText Transfer
Protokol Secure), zatímco modul podporuje pouze HTTP protokol, který je daleko mén bezpený.
Druhou výhodou je to, že website umí pedem filtrovat dležité informace a poté i snížit objem dat,
která mají být zpracovány kontrolérem modulu.
V tomto experimentu dojde k realizaci zobrazení Twitch streaming, coby píklad rzných možností.
Twitch (www.twitch.tv) je website, na kterém jsou streamovány live games (a jiný obdobný obsah
související s hrami pro PC). Jeden z nejznámjších streaming kanál je RocketBeansTV
(díve GameOne). Tento kanál vysílá po celý den a je tak velmi vhodný pro první experiment.
V dalších projektech však mžete sami zvolit i jiný web. Pro tento experiment bude mimo jiné
zapotebí 1 LED (ervená) a 1 rezistor 1 k.
Program
Nabídka Apps poskytuje rzné možnosti pro následující aplikaci. V tomto experimentu se budeme
zabývat aplikací ThingHTTP. Po výbru korespondujícího tlaítka se zobrazí tém prázdné rozhraní.
Vyberte NewHTTP. Do aktivního formuláe zadejte následující parametry:
Name: Twitch
URL: https://api.twitch.tv/kraken/streams?channel=
rocketbeanstv
Method: GET
HTTP Version: 1.1
Parse String: _total
Pakliže dáváte pednost jinému streamovacímu kanálu, zadejte jiný kanál do URL za kanálem.
Vyberte Save ThingHTTP a zkopírujte API key, který se zobrazí, do doasné pamové schránky
(clipboard). Následn klí pekopírujte do programu za #define ThingHTTP. Nezapomete na WLAN
data. V této chvíli mžete naíst program. Program bude 1x za minutu vyhledávat streamovací obsah
a po jeho nalezení se rozsvítí LED. Tento programu funguje díky penosu informací Twitch page
ve známém JSON formátu. Na stránce https://api.twitch.tv/kraken/streams?channel=rocketbeanstv
mžete zaznamenat výstup ve formátu JSON. Naleznete zde velké množství textu. Zajímat se ale
budeme jen o attribute_total, který umožuje zobrazení aktivního streamu. Pakliže je jeho hodnota
vtší než 0, znamená to, že je aktivní nejmén 1 stream. Tento atribut je automaticky analyzován
funkcí ThingSpeak-page a výstup je poskytován ve strukturované hodnot. Tato hodnota mže být
volána a hodnocena programovou funkcí getThingSpeakHttp().
Twitter alarm system
Tímto projektem mžete vytvoit vlastní bezpenostní systém, který zaznamená napíklad otevení
dveí nebo boxu bez píslušného oprávnní. V tomto pípad dochází k nepetržitému vyhodnocování
stavu svtelného senzoru, který je vystaven specifickým svtelným podmínkám. Pakliže dojde