TI Hub -valikko

Huomaa: Uutta tätä moduulia käyttävää ohjelmaa luotaessa on suositeltavaa käyttää Hub-projekti-ohjelmatyyppiä. Tällä varmistetaan kaikkien asiaankuuluvien moduulien tuonti.

objekti

Kuvaus

from ti_hub import *

Tuo kaikki menetelmät ti_hub-moduulista.

 

Hubin sisäiset laitteet > Värituotos

objekti

Kuvaus

rgb(red,green,blue)

Määrittää RGB-merkkivalon värin.

blink(frequency,time)

Määrittää valitun värin vilkkumisen tiheyden ja keston.

off()

Sammuttaa RGB-merkkivalon.

 

Hubin sisäiset laitteet > Valotuotos

objekti

Kuvaus

on()

Sytyttää merkkivalon.

off()

Sammuttaa merkkivalon.

blink(frequency,time)

Määrittää merkkivalon vilkkumisen tiheyden ja keston.

 

Hubin sisäiset laitteet > Äänituotos

objekti

Kuvaus

tone(frequency,time)

Toistaa äänen määritetyllä taajuudella määritetyn ajan.

note("note",time)

Toistaa määritetyn nuotin määritetyn ajan.

Nuotti määritetään käyttämällä nuotin nimeä ja oktaavia. Esimerkiksi : A4, C5.

Nuottien nimet ovat C, CS, D, DS, E, F, FS, G, GS, A, AS, and B.

Oktaavinumerot vaihtelevat välillä 1–9 (ääriarvot mukaan lukien).

tone(frequency,time,tempo)

Toistaa äänen määritetyllä frekvenssillä määritetyn ajan ja tempon.

Tempo määrittää piippausten määrän sekunnissa välillä 0–10 (mukaan lukien).

note("note",time,tempo)

Toistaa määritetyn nuotin määritetyn ajan ja tempon.

Nuotti määritetään käyttämällä nuotin nimeä ja oktaavia. Esimerkiksi : A4, C5.

Nuottien nimet ovat C, CS, D, DS, E, F, FS, G, GS, A, AS, and B.

Oktaavinumerot vaihtelevat välillä 1–9 (ääriarvot mukaan lukien).

Temponumerot vaihtelevat välillä 0–10 (ääriarvot mukaan lukien).

 

Hubin sisäiset laitteet > Kirkkauden syöttö

objekti

Kuvaus

measurement()

Lukee kiinteää KIRKKAUS-anturia (valon määrä) ja antaa lukeman.

Oletusalue on 0–100. Tätä voidaan muuttaa range()-toiminnon avulla.

range(min,max)

Määrittää vaihteluvälin valon määrää mittaavan anturin lukemien kartoittamiselle.

Jos molemmat puuttuvat tai arvoksi on määritetty ”Ei mitään”, oletuskirkkausalueena on 0–100.

 

Lisää syöttölaite

Tässä valikossa on luettelo ti_hub-moduulin tukemista antureista (syöttölaitteista). Kaikki valikkovaihtoehdot liittävät objektin nimen ja odottavat muuttujaa sekä anturin kanssa käytettävää porttia. Jokaisella anturilla on measurement()-menetelmä, joka antaa anturin arvon.

objekti

Kuvaus

DHT (digitaalinen kosteus ja lämpötila)

Antaa senhetkisestä lämpötilasta, kosteudesta, anturin tyypistä ja viimeisestä välimuistissa olevasta lukemasta koostuvan luettelon.

Etäisyysmittari

Antaa senhetkisen etäisyyden annetusta ultraäänietäisyysmittarista.

• measurement_time() – Palauttaa ajan, joka ultraäänisignaalilta kestää tavoittaa esine (”lentoaika”).

Valotaso

Antaa kirkkauden määrän ulkoisen valon määrän (kirkkauden) anturista.

Lämpötila

Antaa lämpötilalukeman ulkoisesta lämpötila-anturista.

Oletusmäärityksenä on tukea Seeed-lämpötila-anturia IN 1-, IN 2- tai IN 3 -portissa.

Jos haluat käyttää TI-Innovator™ -hubin koekytkentälevypaketin TI LM19 -lämpötila-anturia, tulee porttia muokata käytössä olevaan BB-nastaan ja käyttää valinnaista argumenttia ”TIANALOG”.

Esimerkki: mylm19=temperature(”BB 5”,”TIANALOG”)

Kosteus

Antaa kosteusanturin lukeman.

Magneettinen

Havaitsee mahdollisen magneettikentän.

Kentän havaitsemisen raja-arvo määritetään trigger()-funktiolla.

Oletusraja-arvo on 150.

Vernier

Lukee komentoon määritetyn analogisen Vernier-anturin arvon.

Komento tukee seuraavia Vernier-antureita:

• temperature – lämpötila-anturi ruostumattomasta teräksestä.
• lightlevel – TI-anturi valon määrälle.
• pressure – alkuperäinen paineanturi kaasulle
• pressure – uudempi paineanturi kaasulle.
• pH – pH-anturi.
• force10 - ±10 N -asetus, kaksoisvoimantunnistin.
• force50 - ±50 N -asetus, kaksoisvoimantunnistin.
• accelerometer – pienen G-voiman kiihtyvyysmittari.
• generic – mahdollista asentaa muita antureita, joita ei tueta suoraan yläpuolella, ja calibrate()-API:n käytön yhtälökertoimien asettamiseen.

Analoginen tulo

Tukee analogiseen syöttöön käytettäviä yleisiä laitteita.

Digitaalinen tulo

Palauttaa DIGITAL-objektiin liitetyn digitaalinastan senhetkisen tilan tai objektiin viimeksi ASETETUN digitaalisen lähtöarvon välimuistissa olevan tilan.

Potentiometri

Tukee potentiometrianturia.

Anturin aluetta voidaan muuttaa range()-funktiolla.

Termistori

Lukee termistoriantureita.

Oletuskertoimet on suunniteltu vastaamaan TI-Innovator™ Hubin koekytkentälevypakettiin sisältyvää termistoria, kun sitä käytetään 10 KΩ:n kiinteän vastuksen kanssa.

Termistorille voidaan määrittää uusi kalibrointikerroinjoukko ja vertailuvastus käyttämällä calibrate()-funktiota.

Äänenvoimakkuus

Tukee äänenvoimakkuusantureita.

Väritulo

Antaa rajapintoja I2C-liitettyyn värituloanturiin.

bb_port-nastaa käytetään I2C-portin lisäksi värianturin LED-merkkivalon ohjaamiseen.

• color_number(): Antaa välillä 1–9 olevan, anturin havaitsemaa väriä edustavan arvon.

Numerot edustavat seuraavan erittelyn mukaisia värejä:

1: Punainen

2: Vihreä

3: Sininen

4: Syaani

5: Magenta

6: Keltainen

7: Musta

8: Valkoinen

9: Harmaa

• red(): Antaa välillä 0–255 olevan arvon, joka edustaa havaitun PUNAISEN värin voimakkuutta.
• green(): Antaa välillä 0–255 olevan arvon, joka edustaa havaitun VIHREÄN värin voimakkuutta.
• blue(): Antaa välillä 0–255 olevan arvon, joka edustaa havaitun SINISEN värin voimakkuutta.
• gray(): Antaa välillä 0–255 olevan, havaittua harmaan määrää edustavan arvon, jossa 0 on musta ja 255 valkoinen.

BB-portti

Varmistaa tuen kaikkien kymmenen BB-porttinastan käyttöön yhdistettynä digitaalisena tulo-/lähtöporttina.

Alustustoiminnoissa on valinnainen ”mask”-parametri, joka mahdollistaa kymmenen nastan alijoukon käytön.

• read_port(): Lukee BB-portin tulonastojen senhetkiset arvot.
• write_port(value): Asettaa lähtönastan arvot määritettyyn arvoon, jossa arvo on välillä 0–1023. Huomaa, että arvoa säädetään myös var=bbport(mask)-toiminnon maskiarvon mukaan, jos maski on annettu.

Hub-aika

Mahdollistaa sisäisen millisekuntiajastimen käytön.

TI-RGB-matriisi

Sisältää funktioita TI-RGB-matriisin ohjelmointiin.

Alustustoiminto hyväksyy valinnaisen LAMP-parametrin, jolla voidaan ottaa käyttöön erittäin kirkas tila ulkoisen virtalähteen vaativalle TI-RGB-matriisille.

• set(led_position, r,g,b): Asettaa tietyn led_position-aseman (0–15) määritettyyn r,g,b-arvoon, jossa r,g,b-arvot välillä 0–255.
• set(led_list,red,green,blue): Asettaa ”led_list”-listassa määritetyt LED-valot ”punaiseksi”, ”vihreäksi”, ”siniseksi”. ”led_list” on Python-luettelo, joka sisältää LED-valojen indeksit 0–15. Esimerkiksi sarja([0,2,4,6,15], 0, 0, 255) asettaa LED-valot 0, 2, 4, 6 ja 15 sinisiksi.
• set_all(r,g,b): Asettaa matriisin kaikki RGB-merkkivalot samaan r,g,b-arvoon.
• all_off(): Sammuttaa matriisin kaikki RGB:t.
• measurement(): Antaa likimääräisen virrankulutuksen, jota RGB-matriisi käyttää TI-Innovator™-järjestelmästä milliampeereina.
• pattern(pattern): Ottaa käyttöön pikselit, joissa 1-arvo esityksessä olisi käyttäen argumentin arvoa binaariarvona välillä 0–65535. Merkkivalot syttyvät punaisina, ja pwm-tason arvo on 255.
• pattern(value,red,green,blue): Asettaa ”pattern”-kuvion määrittämät LED-valot ”punaiseksi”, ”vihreäksi”, ”siniseksi”.

 

Lisää lähtölaite

Tässä valikossa on luettelo ti_hub-moduulin tukemista lähtölaitteista. Kaikki valikkovaihtoehdot liittävät objektin nimen ja odottavat muuttujaa ja laitteen kanssa käytettävää porttia.

objekti

Kuvaus

LED-valo

Funktiot ulkoisesti liitettyjen LED-valojen ohjaamiseen.

RGB

Tuki ulkoisten RGB-merkkivalojen ohjaamiseen.

TI-RGB-matriisi

Sisältää funktioita TI-RGB-matriisin ohjelmointiin.

Kaiutin

Funktiot ulkoisten kaiuttimien tukemiseen TI-Innovator™ Hub:ia käytettäessä.

Funktiot ovat samat kuin edellä olevassa ”ääni”-vaihtoehdossa.

Teho

Funktiot ulkoisen virran ohjaamiseksi TI-Innovator™ Hubilla.

• set(value): Asettaa virran tason määritettyyn arvoon välillä 0–100.
• on(): Asettaa virran tasoksi 100.
• off(): Asettaa virran tasoksi 0.

Jatkuva servo

Funktiot jatkuvien servomoottorien ohjaamiseksi.

• set_cw(speed,time): Servo pyörii myötäpäivään annetulla nopeudella (0–255) ja tietyn ajan sekunteina.
• set_ccw(speed,time): Servo pyörii vastapäivään annetulla nopeudella (0–255) ja tietyn ajan sekunteina.
• stop(): Pysäyttää jatkuvan servon.

Analoginen lähtö

Funktiot analogiseen syöttöön käytettäviä yleisiä laitteita varten.

Värinämoottori

Funktiot värinämoottoreiden ohjaamiseen.

• set(val): Asettaa värinämoottorin voimakkuuden arvoon val (0–255).
• off(): Sammuttaa värinämoottorin.
• on(): Kytkee värinämoottorin päälle suurimmalla teholla.

Rele

Säätää ohjausreleiden rajapintoja.

• on(): Laittaa releen PÄÄLLE.
• off(): Laittaa releen POIS PÄÄLTÄ.

Servo

Funktiot servomoottorien ohjaamiseen.

• set_position(pos): Asettaa pyyhkäisyservoasennon välille -90 – +90.
• zero(): Asettaa pyyhkäisyservon nolla-asentoon.

Neliöaalto

Funktiot neliöaallon luontiin.

• set(frequency,duty,time): Määrittää lähtevän neliöaallon oletuskäyttöjaksolle 50 % (jos käyttöä ei ole määritetty) ja frequence-parametrin määrittämällä lähtötaajuudella. Taajuus voi olla välillä 1–500 Hz. Jos käyttöjakso on annettu, se voi olla välillä 0–100 %.
• off(): Laittaa neliöaallon pois päältä.

Digitaalinen lähtö

Rajapinnat digitaalisen lähdön ohjaamiseen.

• set(val): Asettaa digitaalisen lähdön val-parametrin määrittämään arvoon (0 tai 1).
• on(): Asettaa digitaalisen lähdön tilaksi korkea (1).
• off(): Asettaa digitaalisen lähdön tilaksi matala (0).

BB-portti

Sisältää funktioita TI-RGB-matriisin ohjelmointiin.

Ks. tarkemmat tiedot edellä.

 

Komennot

objekti

Kuvaus

sleep(seconds)

Keskeyttää ohjelman annetun sekuntimäärän ajaksi.

Tuotu time-moduulista.

text_at(row,"text","align")

Näyttää määritetyn ”tekstin” piirtoalueella määritetyllä ”tasauksella”.

Osa ti_plotlib-moduulia.

cls()

Tyhjentää komentotulkkinäytön piirtämistä varten.

Osa ti_plotlib-moduulia.

while get_key() != "esc":

Suorittaa komennot while-silmukassa, kunnes esc-näppäintä painetaan.

get_key()

Antaa painettua näppäintä edustavan merkkijonon.

Näppäimellä 1 saadaan 1, näppäimellä esc saadaan esc ja niin edelleen.

Kun kutsutaan ilman parametreja – get_key() – se antaa tuloksen välittömästi.

Kun kutsutaan parametrillä – get_key(1) – se odottaa näppäimen painamista.

Osa ti_system-moduulia.

 

Portit

Nämä ovat TI-Innovator™ Hubissa käytettävissä olevat tulo- ja lähtöportit.

objekti

LÄHTÖ 1

LÄHTÖ 2

LÄHTÖ 3

TULO 1

TULO 2

TULO 3

BB 1

BB 2

BB 3

BB 4

BB 5

BB 6

BB 7

BB 8

BB 9

BB 10

I2C