13 KiB

Raw Permalink Blame History

Virtualno računalo s jednom pločom

Umjesto kupnje IoT uređaja, zajedno sa senzorima i aktuatorima, možete koristiti svoje računalo za simulaciju IoT hardvera. CounterFit projekt omogućuje vam pokretanje aplikacije lokalno koja simulira IoT hardver poput senzora i aktuatora te pristup tim senzorima i aktuatorima iz lokalnog Python koda napisanog na isti način kao što biste pisali na Raspberry Pi-ju koristeći fizički hardver.

Postavljanje

Za korištenje CounterFit-a, potrebno je instalirati besplatan softver na svoje računalo.

Zadatak

Instalirajte potreban softver.

Instalirajte Python. Pogledajte stranicu za preuzimanje Pythona za upute o instalaciji najnovije verzije Pythona.
Instalirajte Visual Studio Code (VS Code). Ovo je uređivač koji ćete koristiti za pisanje koda za vaš virtualni uređaj u Pythonu. Pogledajte dokumentaciju za VS Code za upute o instalaciji VS Code-a.

💁 Slobodno koristite bilo koji Python IDE ili uređivač za ove lekcije ako imate omiljeni alat, ali upute u lekcijama će se temeljiti na korištenju VS Code-a.
Instalirajte Pylance ekstenziju za VS Code. Ovo je ekstenzija za VS Code koja pruža podršku za Python jezik. Pogledajte dokumentaciju za Pylance ekstenziju za upute o instalaciji ove ekstenzije u VS Code-u.

Upute za instalaciju i konfiguraciju CounterFit aplikacije bit će dane u odgovarajućem trenutku u uputama za zadatak jer se instalira za svaki projekt zasebno.

Hello world

Tradicionalno je, kada započinjete s novim programskim jezikom ili tehnologijom, stvoriti aplikaciju 'Hello World' - malu aplikaciju koja ispisuje tekst poput "Hello World" kako bi pokazala da su svi alati ispravno konfigurirani.

Hello World aplikacija za virtualni IoT hardver osigurat će da su Python i Visual Studio Code ispravno instalirani. Također će se povezati s CounterFit-om za virtualne IoT senzore i aktuatore. Neće koristiti nikakav hardver, samo će se povezati kako bi dokazala da sve radi.

Ova aplikacija bit će u mapi pod nazivom nightlight, a ponovno će se koristiti s različitim kodom u kasnijim dijelovima ovog zadatka za izradu aplikacije za noćno svjetlo.

Konfiguriranje Python virtualnog okruženja

Jedna od snažnih značajki Pythona je mogućnost instalacije Pip paketa - to su paketi koda koje su napisali drugi ljudi i objavili na internetu. Možete instalirati Pip paket na svoje računalo jednim naredbom, a zatim koristiti taj paket u svom kodu. Koristit ćete Pip za instalaciju paketa za komunikaciju s CounterFit-om.

Po zadanim postavkama, kada instalirate paket, on je dostupan svugdje na vašem računalu, što može dovesti do problema s verzijama paketa - na primjer, jedna aplikacija ovisi o jednoj verziji paketa koja prestaje raditi kada instalirate novu verziju za drugu aplikaciju. Kako biste zaobišli ovaj problem, možete koristiti Python virtualno okruženje, što je u osnovi kopija Pythona u namjenskoj mapi, a kada instalirate Pip pakete, oni se instaliraju samo u tu mapu.

💁 Ako koristite Raspberry Pi, tada niste postavili virtualno okruženje na tom uređaju za upravljanje Pip paketima, već koristite globalne pakete jer su Grove paketi globalno instalirani pomoću instalacijskog skripta.

Zadatak - konfiguriranje Python virtualnog okruženja

Konfigurirajte Python virtualno okruženje i instalirajte Pip pakete za CounterFit.

Iz svog terminala ili naredbenog retka pokrenite sljedeće na lokaciji po vašem izboru kako biste stvorili i prešli u novi direktorij:
```
mkdir nightlight
cd nightlight
```
Sada pokrenite sljedeće kako biste stvorili virtualno okruženje u mapi .venv:
```
python3 -m venv .venv
```
💁 Morate eksplicitno pozvati python3 kako biste stvorili virtualno okruženje za slučaj da imate instaliran Python 2 uz Python 3 (najnoviju verziju). Ako imate instaliran Python 2, pozivanje python koristit će Python 2 umjesto Pythona 3.
Aktivirajte virtualno okruženje:
- Na Windowsu:
  - Ako koristite Command Prompt ili Command Prompt kroz Windows Terminal, pokrenite:
```
.venv\Scripts\activate.bat
```
  - Ako koristite PowerShell, pokrenite:
```
.\.venv\Scripts\Activate.ps1
```
    Ako dobijete grešku o tome da je pokretanje skripti onemogućeno na ovom sustavu, morat ćete omogućiti pokretanje skripti postavljanjem odgovarajuće politike izvršavanja. To možete učiniti pokretanjem PowerShell-a kao administrator, a zatim pokretanjem sljedeće naredbe:
```
Set-ExecutionPolicy -ExecutionPolicy Unrestricted
```
    Unesite Y kada se zatraži potvrda. Zatim ponovno pokrenite PowerShell i pokušajte ponovno.
    
    Možete resetirati ovu politiku izvršavanja kasnije ako je potrebno. Više o tome možete pročitati na stranici o politikama izvršavanja na Microsoft Docs.
- Na macOS-u ili Linuxu, pokrenite:
```
source ./.venv/bin/activate
```
💁 Ove naredbe trebaju se pokrenuti s iste lokacije na kojoj ste pokrenuli naredbu za stvaranje virtualnog okruženja. Nikada nećete trebati navigirati u mapu .venv, uvijek biste trebali pokrenuti naredbu za aktivaciju i bilo koje naredbe za instalaciju paketa ili pokretanje koda iz mape u kojoj ste bili kada ste stvorili virtualno okruženje.
Kada je virtualno okruženje aktivirano, zadana naredba python pokrenut će verziju Pythona koja je korištena za stvaranje virtualnog okruženja. Pokrenite sljedeće kako biste dobili verziju:
```
python --version
```
Izlaz bi trebao sadržavati sljedeće:
```
(.venv) ➜  nightlight python --version
Python 3.9.1
```
💁 Vaša verzija Pythona može biti drugačija - sve dok je verzija 3.6 ili novija, sve je u redu. Ako nije, izbrišite ovu mapu, instalirajte noviju verziju Pythona i pokušajte ponovno.
Pokrenite sljedeće naredbe za instalaciju Pip paketa za CounterFit. Ovi paketi uključuju glavnu CounterFit aplikaciju kao i shims za Grove hardver. Ovi shims omogućuju vam pisanje koda kao da programirate koristeći fizičke senzore i aktuatore iz Grove ekosustava, ali povezane s virtualnim IoT uređajima.
```
pip install CounterFit
pip install counterfit-connection
pip install counterfit-shims-grove
```
Ovi Pip paketi bit će instalirani samo u virtualnom okruženju i neće biti dostupni izvan njega.

Pisanje koda

Kada je Python virtualno okruženje spremno, možete napisati kod za aplikaciju 'Hello World'.

Zadatak - pisanje koda

Stvorite Python aplikaciju koja ispisuje "Hello World" na konzolu.

Iz svog terminala ili naredbenog retka pokrenite sljedeće unutar virtualnog okruženja kako biste stvorili Python datoteku pod nazivom app.py:
- Na Windowsu pokrenite:
```
type nul > app.py
```
- Na macOS-u ili Linuxu pokrenite:
```
touch app.py
```
Otvorite trenutnu mapu u VS Code-u:
```
code .
```
💁 Ako vaš terminal vrati command not found na macOS-u, to znači da VS Code nije dodan u vaš PATH. Možete dodati VS Code u svoj PATH slijedeći upute u odjeljku Pokretanje iz naredbenog retka u dokumentaciji za VS Code i zatim pokrenuti naredbu. VS Code je prema zadanim postavkama dodan u PATH na Windowsu i Linuxu.
Kada se VS Code pokrene, aktivirat će Python virtualno okruženje. Odabrano virtualno okruženje pojavit će se u donjoj statusnoj traci:
Ako je VS Code Terminal već pokrenut kada se VS Code pokrene, neće imati aktivirano virtualno okruženje u njemu. Najlakše je zatvoriti terminal pomoću gumba Kill the active terminal instance:

Možete prepoznati je li terminal aktivirao virtualno okruženje jer će ime virtualnog okruženja biti prefiks na terminalskom promptu. Na primjer, moglo bi biti:
```
(.venv) ➜  nightlight
```
Ako nemate .venv kao prefiks na promptu, virtualno okruženje nije aktivno u terminalu.
Pokrenite novi VS Code Terminal odabirom Terminal -> New Terminal ili pritiskom na CTRL+`. Novi terminal učitat će virtualno okruženje, a poziv za aktivaciju pojavit će se u terminalu. Prompt će također imati ime virtualnog okruženja (.venv):
```
➜  nightlight source .venv/bin/activate
(.venv) ➜  nightlight 
```
Otvorite datoteku app.py iz VS Code explorera i dodajte sljedeći kod:
```
print('Hello World!')
```
Funkcija print ispisuje sve što joj se proslijedi na konzolu.
Iz VS Code terminala pokrenite sljedeće kako biste pokrenuli svoju Python aplikaciju:
```
python app.py
```
Sljedeće će biti u izlazu:
```
(.venv) ➜  nightlight python app.py 
Hello World!
```

😀 Vaš 'Hello World' program je uspješno pokrenut!

Povezivanje 'hardvera'

Kao drugi korak 'Hello World', pokrenut ćete CounterFit aplikaciju i povezati svoj kod s njom. Ovo je virtualni ekvivalent priključivanja IoT hardvera na razvojni komplet.

Zadatak - povezivanje 'hardvera'

Iz VS Code terminala pokrenite CounterFit aplikaciju sljedećom naredbom:
```
counterfit
```
Aplikacija će se pokrenuti i otvoriti u vašem web pregledniku:

Bit će označena kao Disconnected, s LED-icom u gornjem desnom kutu isključenom.
Dodajte sljedeći kod na vrh app.py:
```
from counterfit_connection import CounterFitConnection
CounterFitConnection.init('127.0.0.1', 5000)
```
Ovaj kod uvozi klasu CounterFitConnection iz modula counterfit_connection, koji dolazi iz counterfit-connection pip paketa koji ste ranije instalirali. Zatim inicijalizira vezu s CounterFit aplikacijom koja radi na 127.0.0.1, što je IP adresa koju uvijek možete koristiti za pristup svom lokalnom računalu (često se naziva localhost), na portu 5000.

💁 Ako imate druge aplikacije koje rade na portu 5000, možete to promijeniti ažuriranjem porta u kodu i pokretanjem CounterFit-a pomoću CounterFit --port <port_number>, zamjenjujući <port_number> s portom koji želite koristiti.
Morat ćete pokrenuti novi VS Code terminal odabirom gumba Create a new integrated terminal. To je zato što CounterFit aplikacija radi u trenutnom terminalu.
U ovom novom terminalu pokrenite datoteku app.py kao i prije. Status CounterFit-a promijenit će se u Connected i LED-ica će se upaliti.

💁 Ovaj kod možete pronaći u mapi code/virtual-device.

😀 Vaša veza s hardverom je uspješno uspostavljena!

Odricanje od odgovornosti:
Ovaj dokument je preveden pomoću AI usluge za prevođenje Co-op Translator. Iako nastojimo osigurati točnost, imajte na umu da automatski prijevodi mogu sadržavati pogreške ili netočnosti. Izvorni dokument na izvornom jeziku treba smatrati autoritativnim izvorom. Za ključne informacije preporučuje se profesionalni prijevod od strane čovjeka. Ne preuzimamo odgovornost za nesporazume ili pogrešna tumačenja koja mogu proizaći iz korištenja ovog prijevoda.

13 KiB Raw Permalink Blame History