13 KiB

Raw Permalink Blame History Unescape Escape

Virtualus vieno plokštės kompiuteris

Užuot pirkę IoT įrenginį kartu su jutikliais ir aktuatoriais, galite naudoti savo kompiuterį, kad simuliuotumėte IoT techninę įrangą. CounterFit projektas leidžia paleisti programą lokaliai, kuri simuliuoja IoT techninę įrangą, tokią kaip jutikliai ir aktuatoriai, ir pasiekti juos iš vietinio Python kodo, parašyto taip pat, kaip rašytumėte kodą Raspberry Pi naudojant fizinę techninę įrangą.

Paruošimas

Norėdami naudoti CounterFit, turėsite įdiegti nemokamą programinę įrangą savo kompiuteryje.

Užduotis

Įdiekite reikiamą programinę įrangą.

Įdiekite Python. Instrukcijas, kaip įdiegti naujausią Python versiją, rasite Python atsisiuntimų puslapyje.
Įdiekite Visual Studio Code (VS Code). Tai redaktorius, kurį naudosite rašydami virtualaus įrenginio kodą Python kalba. Instrukcijas, kaip įdiegti VS Code, rasite VS Code dokumentacijoje.

💁 Galite naudoti bet kurį Python IDE ar redaktorių, jei turite mėgstamą įrankį, tačiau pamokose bus pateiktos instrukcijos, pagrįstos VS Code naudojimu.
Įdiekite VS Code Pylance plėtinį. Tai VS Code plėtinys, kuris suteikia Python kalbos palaikymą. Instrukcijas, kaip įdiegti šį plėtinį VS Code, rasite Pylance plėtinio dokumentacijoje.

Instrukcijos, kaip įdiegti ir sukonfigūruoti CounterFit programą, bus pateiktos atitinkamu metu užduočių instrukcijose, nes ji įdiegiama kiekvienam projektui atskirai.

Sveikas pasauli!

Pradėjus naudoti naują programavimo kalbą ar technologiją, tradiciškai sukuriama „Sveikas pasauli!“ programa – nedidelė programa, kuri išveda tekstą, pvz., "Sveikas pasauli!", kad parodytų, jog visi įrankiai yra tinkamai sukonfigūruoti.

„Sveikas pasauli!“ programa virtualiai IoT techninei įrangai užtikrins, kad Python ir Visual Studio Code būtų tinkamai įdiegti. Ji taip pat prisijungs prie CounterFit, kad galėtų naudoti virtualius IoT jutiklius ir aktuatorius. Ji nenaudos jokios techninės įrangos, tiesiog prisijungs, kad įrodytų, jog viskas veikia.

Ši programa bus aplanke, pavadintame nightlight, ir ji bus naudojama su skirtingu kodu vėlesnėse šios užduoties dalyse, kad būtų sukurta naktinė lemputė.

Konfigūruokite Python virtualią aplinką

Viena iš galingų Python funkcijų yra galimybė įdiegti Pip paketus – tai kitų žmonių parašyti ir internete publikuoti kodų paketai. Galite įdiegti Pip paketą savo kompiuteryje vienu komandu ir naudoti tą paketą savo kode. Naudosite Pip, kad įdiegtumėte paketą, skirtą bendrauti su CounterFit.

Pagal numatymą, kai įdiegiate paketą, jis tampa prieinamas visur jūsų kompiuteryje, ir tai gali sukelti problemų su paketų versijomis – pavyzdžiui, viena programa priklauso nuo vienos paketo versijos, kuri sugenda, kai įdiegiate naują versiją kitai programai. Norėdami išspręsti šią problemą, galite naudoti Python virtualią aplinką, iš esmės Python kopiją dedikuotame aplanke, ir kai įdiegiate Pip paketus, jie įdiegiami tik tame aplanke.

💁 Jei naudojate Raspberry Pi, tuomet nesukūrėte virtualios aplinkos tam įrenginiui valdyti Pip paketus, vietoj to naudojate globalius paketus, nes Grove paketai yra įdiegti globaliai per diegimo scenarijų.

Užduotis – konfigūruokite Python virtualią aplinką

Konfigūruokite Python virtualią aplinką ir įdiekite Pip paketus, skirtus CounterFit.

Terminale arba komandų eilutėje paleiskite šiuos veiksmus pasirinktoje vietoje, kad sukurtumėte ir pereitumėte į naują katalogą:
```
mkdir nightlight
cd nightlight
```
Dabar paleiskite šiuos veiksmus, kad sukurtumėte virtualią aplinką .venv aplanke:
```
python3 -m venv .venv
```
💁 Turite aiškiai nurodyti python3, kad sukurtumėte virtualią aplinką, jei turite įdiegtą Python 2 be Python 3 (naujausia versija). Jei turite įdiegtą Python 2, tada paleidus python bus naudojamas Python 2 vietoj Python 3.
Aktyvuokite virtualią aplinką:
- Windows sistemoje:
  - Jei naudojate Command Prompt arba Command Prompt per Windows Terminal, paleiskite:
```
.venv\Scripts\activate.bat
```
  - Jei naudojate PowerShell, paleiskite:
```
.\.venv\Scripts\Activate.ps1
```
    Jei gaunate klaidą apie tai, kad scenarijų paleidimas yra išjungtas šioje sistemoje, turėsite įjungti scenarijų paleidimą nustatydami tinkamą vykdymo politiką. Tai galite padaryti paleisdami PowerShell kaip administratorius, tada paleisdami šią komandą:
```
Set-ExecutionPolicy -ExecutionPolicy Unrestricted
```
    Patvirtinimui įveskite Y. Tada iš naujo paleiskite PowerShell ir bandykite dar kartą.
    
    Jei reikia, vėliau galite atstatyti šią vykdymo politiką. Daugiau apie tai galite perskaityti Microsoft Docs puslapyje apie vykdymo politiką.
- macOS arba Linux sistemoje paleiskite:
```
source ./.venv/bin/activate
```
💁 Šios komandos turėtų būti paleistos iš tos pačios vietos, kur paleidote komandą, kad sukurtumėte virtualią aplinką. Jums niekada nereikės pereiti į .venv aplanką, visada turėtumėte paleisti aktyvavimo komandą ir bet kokias komandas, skirtas paketų įdiegimui ar kodo paleidimui, iš aplanko, kuriame buvote, kai sukūrėte virtualią aplinką.
Kai virtuali aplinka bus aktyvuota, numatytoji python komanda paleis Python versiją, kuri buvo naudojama kuriant virtualią aplinką. Paleiskite šią komandą, kad gautumėte versiją:
```
python --version
```
Rezultate turėtų būti:
```
(.venv) ➜  nightlight python --version
Python 3.9.1
```
💁 Jūsų Python versija gali būti kitokia – jei ji yra 3.6 ar naujesnė, viskas gerai. Jei ne, ištrinkite šį aplanką, įdiekite naujesnę Python versiją ir bandykite dar kartą.
Paleiskite šias komandas, kad įdiegtumėte Pip paketus, skirtus CounterFit. Šie paketai apima pagrindinę CounterFit programą, taip pat Grove techninės įrangos šimus. Šimai leidžia rašyti kodą taip, tarsi programuotumėte naudodami fizinius jutiklius ir aktuatorius iš Grove ekosistemos, bet prijungtus prie virtualių IoT įrenginių.
```
pip install CounterFit
pip install counterfit-connection
pip install counterfit-shims-grove
```
Šie Pip paketai bus įdiegti tik virtualioje aplinkoje ir nebus prieinami už jos ribų.

Parašykite kodą

Kai Python virtuali aplinka bus paruošta, galite parašyti kodą „Sveikas pasauli!“ programai.

Užduotis – parašykite kodą

Sukurkite Python programą, kuri išveda "Sveikas pasauli!" į konsolę.

Terminale arba komandų eilutėje paleiskite šiuos veiksmus virtualioje aplinkoje, kad sukurtumėte Python failą, pavadintą app.py:
- Windows sistemoje paleiskite:
```
type nul > app.py
```
- macOS arba Linux sistemoje paleiskite:
```
touch app.py
```
Atidarykite dabartinį aplanką VS Code:
```
code .
```
💁 Jei jūsų terminalas macOS sistemoje grąžina command not found, tai reiškia, kad VS Code nebuvo pridėtas prie jūsų PATH. Galite pridėti VS Code prie PATH, vadovaudamiesi instrukcijomis VS Code dokumentacijos skyriuje apie paleidimą iš komandų eilutės ir paleisti komandą vėliau. VS Code pagal numatymą pridedamas prie PATH Windows ir Linux sistemose.
Kai VS Code paleidžiamas, jis aktyvuoja Python virtualią aplinką. Pasirinkta virtuali aplinka bus rodoma apatiniame būsenos juostoje:
Jei VS Code terminalas jau veikia, kai VS Code paleidžiamas, jis neturės aktyvuotos virtualios aplinkos. Lengviausias būdas yra uždaryti terminalą naudojant Kill the active terminal instance mygtuką:

Galite pasakyti, ar terminalas turi aktyvuotą virtualią aplinką, nes terminalo raginime bus virtualios aplinkos pavadinimas kaip prefiksas. Pavyzdžiui, tai gali būti:
```
(.venv) ➜  nightlight
```
Jei neturite .venv kaip prefikso raginime, virtuali aplinka nėra aktyvuota terminale.
Paleiskite naują VS Code terminalą pasirinkdami Terminal -> New Terminal arba paspausdami CTRL+`. Naujas terminalas įkels virtualią aplinką, o aktyvavimo komanda pasirodys terminale. Raginime taip pat bus virtualios aplinkos pavadinimas (.venv):
```
➜  nightlight source .venv/bin/activate
(.venv) ➜  nightlight 
```
Atidarykite app.py failą iš VS Code naršyklės ir pridėkite šį kodą:
```
print('Hello World!')
```
print funkcija išveda tai, kas perduodama jai, į konsolę.
Iš VS Code terminalo paleiskite šią komandą, kad paleistumėte savo Python programą:
```
python app.py
```
Rezultate bus:
```
(.venv) ➜  nightlight python app.py 
Hello World!
```

😀 Jūsų „Sveikas pasauli!“ programa buvo sėkminga!

Prijunkite „techninę įrangą“

Kaip antrą „Sveikas pasauli!“ žingsnį, paleisite CounterFit programą ir prijungsite savo kodą prie jos. Tai yra virtualus ekvivalentas prijungti IoT techninę įrangą prie kūrimo rinkinio.

Užduotis – prijunkite „techninę įrangą“

Iš VS Code terminalo paleiskite CounterFit programą naudodami šią komandą:
```
counterfit
```
Programa pradės veikti ir atsidarys jūsų interneto naršyklėje:

Ji bus pažymėta kaip Disconnected, o LED viršutiniame dešiniajame kampe bus išjungtas.
Pridėkite šį kodą į app.py failo viršų:
```
from counterfit_connection import CounterFitConnection
CounterFitConnection.init('127.0.0.1', 5000)
```
Šis kodas importuoja CounterFitConnection klasę iš counterfit_connection modulio, kuris yra iš counterfit-connection pip paketo, kurį įdiegėte anksčiau. Tada jis inicializuoja ryšį su CounterFit programa, veikiančia 127.0.0.1, tai yra IP adresas, kurį visada galite naudoti norėdami pasiekti savo vietinį kompiuterį (dažnai vadinamą localhost), per 5000 prievadą.

💁 Jei turite kitų programų, veikiančių per 5000 prievadą, galite tai pakeisti atnaujindami prievadą kode ir paleisdami CounterFit naudodami CounterFit --port <port_number>, pakeisdami <port_number> į norimą prievadą.
Turėsite paleisti naują VS Code terminalą pasirinkdami Create a new integrated terminal mygtuką. Taip yra todėl, kad CounterFit programa veikia dabartiniame terminale.
Šiame naujame terminale paleiskite app.py failą kaip anksčiau. CounterFit būsena pasikeis į Connected, o LED užsidegs.

💁 Šį kodą galite rasti code/virtual-device aplanke.

😀 Jūsų ryšys su technine įranga buvo sėkmingas!

Atsakomybės apribojimas:
Šis dokumentas buvo išverstas naudojant AI vertimo paslaugą Co-op Translator. Nors siekiame tikslumo, prašome atkreipti dėmesį, kad automatiniai vertimai gali turėti klaidų ar netikslumų. Originalus dokumentas jo gimtąja kalba turėtų būti laikomas autoritetingu šaltiniu. Kritinei informacijai rekomenduojama naudoti profesionalų žmogaus vertimą. Mes neprisiimame atsakomybės už nesusipratimus ar klaidingus interpretavimus, atsiradusius dėl šio vertimo naudojimo.

13 KiB Raw Permalink Blame History Unescape Escape