OctopusLab – workshop micropython – 1. díl

">>>" toto je takzvaný "prompt",

terminálová výzva, abychom tam něco napsali:

příkaz nebo "posloupnost příkazů"

>>> a = 123

do proměnné se uložila hodnota (číslo 123)

>>> a
123

vytiskne / zobrazí hodnotu proměnné

nebo print(a) pokud to chcete použít v programu

>>> a + 10
133

zobrazí vypočtenou hodnotu (jako kalkulačka)

někdy chceme složitější matematické výrazy, než je

+ sčítání

- odčítání

* násobení

/ dělení

>>> import math
importujeme knihovnu, až když jí potřebujeme,

jinak nám zbytečně blokuje operační paměť

>>> math.log10(1000)
3.0

>>> math.pi
3.141593

počet desetinných míst je omezený

*) pouze v této úvodní části jsme naznačili, co píše systém (tučně) a co píšete vy (normálně) - poznámky pak píšeme šikmo

>>> šipky nahoru nebo dolů -> historie příkazů

>>> metoda + tečka > TAB doplnění / nápověda

zkuste například:

>>> import math

>>> math. a po tečce stisknout TAB > vypíše vám:

__class__ __name__   pow      acos


 acosh     asin      asinh    atan


 atan2     atanh     ceil     copysign


 cos       cosh      degrees  e


 erf       erfc      exp      expm1


 fabs      floor     fmod     frexp


 gamma     isfinite  isinf    isnan


 ldexp     lgamma    log      log10


 log2      modf      pi       radians


 sin       sinh      sqrt     tan


 tanh      trunc

Micropython má obrovskou výhodu v tom, že běží jako interpret: když uživatel napíše název proměnné, třídy nebo instance objektu, skoro všechno se o nich můžeme dozvědět. Právě proto máme k dispozici všechny metody, po

def název(parametry): nezapomenout na dvojtečku!

>>> def suma(x, y):

... return x + y

Pozor na odsazení druhého řádku a důsledné zarovnávání logických bloků.

Ukončení definice lze nejrychleji "uENTRováním" (lépe po BACKSPACE).

...

...

>>>

a zkusíme, jak nám nová funkce funguje:

>>> suma (1, 2)
3

Lambda - pro jednoduché funkce:

>>> sumaL = lambda a, b: a + b

>>> sumaL(1, 2)
3

Jsou situace, kde je potřeba funkce na jedno použití někde uvnitř jiné funkce. Převážně k tomu se lambda funkce používá.

čekací prodlevy:
program bude pokračovat až po uplynutí dané doby

from time import sleep > již je v octopus()
sleep(1) > 1 sekunda pauza
sleep_ms(100) > 100 mili sec
sleep_us(500) > 500 micro sec

teplota u procesoru:

>>> import esp32

>>> esp32.raw_temperature()
127

hallova sonda - magnetického pole:

>>> import esp32

>>> esp32.hall_sensor()
129
cca standard hodnota

while podmínka:

... prováděj_pokud_je_splněná_podmínka()

a = 0

while True:

... a += 1

... print(a)

Pak bychom si práci s periferiemi představovali nějak takto:

led = Led() vytvoření instance objektu Led

led.value(1) > instance objektu "tečka" metoda "( parametry )"

zde: hodnota (value) s parametrem 1 znamená, že se LEDka rozsvítí.

Chceme jinou Led? Na jiném pinu? Vytvoříme instanci objektu:

led2 = Led(pin) > a pak ji používáme "stejně":

led2.value(1)

nezapomínejte spustit hlavní modul knihoven

po každém novém zapnutí a po resetu

Ukážeme si tři základní třídy: Led, Buzzer a Rgb

včetně odkazů na zdrojové kódy

třída Led > zdrojový kód

led = Led(2)
instance objektu Led s defaultním nastavením na pinu 2

(což je BUILT_IN_LED - vestavěná modrá LEDka)

led.value(1)
nastavení hodnoty na "1" - dioda svítí

led.value(0)
nastavení hodnoty na "0" - dioda nesvítí

blikání poprvé:

while True:

... led.value(1)

... sleep(1)

... led.value(0)

... sleep(1)

led.value()
bez parametru vrátí hodnotu nastavení - nyní tedy: 0

led.toggle()
"přepnout" > změní stav - nyní tedy z 0 na 1

blikání podruhé:

while True:

... led.toggle()

... sleep(1)

led.blink()
metoda pro jedno bliknutí blink()

(což si sami najdete ve zdrojových kódech)

led.blink(1000,500)
metoda blink (s parametry: 1s svítí a 0.5s nesvítí)

parametr se zadává v milisekundách

blikání potřetí:

while True:

... led.blink()

a právě tento příklad máme jako základní ukázku ve složce "examples":

https://github.com/octopusengine/octopuslab/blob/master/esp32-micropython/examples/blink.py

led2 = Led(33)
instance objektu Led na pinu 33

...

třída Buzzer > zdrojový kód

piezzo = Buzzer(18)

piezzo.beep()

napřímo přes octopus():

beep()
základní pípnutí (1000,50) > 1kHz na 50ms

beep(440,500)
komorní a 440Hz na 0.5s

from util.buzzer import notes

Notes.A4
440
k dispozici jsou tóny C3-C7

tone(440) => buzzer.play_tone(Notes.A4)

from util.buzzer import melody

piezzo.play_melody(melody.mario)

třída Rgb > zdrojový kód

ws = Rgb()

deklarace základu je provedena už spuštěním octopus()

ws = Rgb(32,8)
na pinu 32 máme 8 ws LEDek

ws.num

8
nám vrátí property (vlastnost, proměnnou: počet LEDek),

a vrátí 8, protože jsme nastavili 8 (systém to jinak nepozná)

ws.simpletest()
jednoduchý test, na první LED postupně R > G > B

ws.color(RED)

ws.color((128,64,0))
možnosti zadání barvy

from util.rgb import wheel

metoda wheel konvertuje číslo na posouvané RGB

>>> wheel(10)
(225, 30, 0)

>>> wheel(50)
(105, 150, 0)

chceme blikat náhodnými barvami?

from util.rgb import random_color

while True:

... ws.color(random_color())

... sleep(0.3)

Micropython umí pracovat se soubory, a přímo pracovat nejen se řetězci znaků, ale i s json formátem nebo jednoduchou databází. Všechny nastavené WiFi jsou tedy strukturovaně uložené ve vašem ESP v json-souboru:
config/wifi.json

chcete vidět co tam je? Zadejte:
(octopus() nemusíte pokaždé, stačí jen po restartu, ale start navíc ničemu neublíží, RAM se průběžně optimalizuje automaticky)

octopus()

f("config/wifi.json")
f jako file vám obsah souboru vypíše

Pro připojení k wifi nám stačí:

octopus()

w()

Na závěr dnešního dílu si ukážeme využití "api třetích stran" - webovou aplikaci, která aktualizuje RGB nastavení podle twitteru:
http://api.thingspeak.com/channels/1417/field/2/last.txt

Když publikujete například zprávu:
#octopusLAB and #micropython example

#cheerlights orange

výše uvedený odkaz zaktualizuje svůj stav na poslední publikovanou barvu

za hashtagem #cheerlights

do knihoven octopus (ve složce ukázek examples) jsme implementovali jednoduchou metodu twitter_rgb(), takže vám stačí zadat pouze pár řádků:

>>> octopus()

>>> w()

>>> from examples.twitter_rgb import twitter_rgb

>>> ws.color(twitter_rgb())

inicializace octopus, připojení k wifi, natažení knihovny a jednorázové spuštění příkazu

a RGB LEDka vám svítí podle posledního tweetu

Pokud chcete průběžnou aktualizaci, nedávejte to v nekonečné smyčce bez prodlevy, server umlátíte nereálným http dotazováním několikrát za vteřinu, což je krok regulernímu DDoS útoku (Distributed Denial of Service) takže vás záhy nejspíš odpojí

while True:

... ws.color(twitter_rgb())

... sleep(30)

kompromis, každých 30 vteřin, stejně rychleji tweetovat nebudete