HamsterS
Instanssin esittely
Kun lisäät HamsterS-lohkon työtilaan, Python-koodiin lisätään automaattisesti seuraava instanssin esittely:
hamster_s = HamsterS(0)
# Kun instansseja on useita
hamster_s_1 = HamsterS(1)Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| index | Pudotusvalikon vaihtoehto | Instanssin numero (alkaa nollasta) | Kokonaisluku 0 tai suurempi | 0 |
Aseta pyörän nopeus
Määrittää pyörän nopeuden. Nopeus on välillä -100 ja 100.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| unit | Pudotusvalikon vaihtoehto | Ohjattava pyörä | vasen(left), oikea(right), molemmat(both) | - |
| speed | Syöte (lohko) | Pyörän nopeus | Kokonaisluku välillä -100 ja 100, 0: pysähdys | - |
Python
hamster_s = HamsterS(0)
hamster_s.set_wheel_speed('both', 50)Liiku matka
Ajaa määrittämäsi matkan nykyisellä pyörän nopeudella.
Jos pyörän nopeutta ei ole asetettu, robotti ajaa eteenpäin oletusnopeudella.
Jos matka on 0, robotti jatkaa ajamista nykyisellä pyörän nopeudella.
Kun valitset odota, suoritus odottaa, kunnes liike on valmis.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| data | Syöte (lohko) | Ajettava matka | Desimaaliluku 0 tai suurempi | - |
| unit | Pudotusvalikon vaihtoehto | Matkan yksikkö | cm, mm, tuuma(inch) | cm |
| wait | Valintaruutu | Odotetaanko, kunnes valmis | TRUE / FALSE | TRUE |
Python
hamster_s = HamsterS(0)
hamster_s.move_distance(50, 'cm', wait=True)Liiku ajan
Ajaa määrittämäsi ajan nykyisellä pyörän nopeudella.
Jos pyörän nopeutta ei ole asetettu, robotti ajaa eteenpäin oletusnopeudella.
Kun valitset odota, suoritus odottaa, kunnes liike on valmis.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| data | Syöte (lohko) | Ajoaika (sekuntia) | Desimaaliluku 0 tai suurempi | - |
| wait | Valintaruutu | Odotetaanko, kunnes valmis | TRUE / FALSE | TRUE |
Python
hamster_s = HamsterS(0)
# wait = TRUE
hamster_s.move_time(5, wait=True)
# wait = FALSE
hamster_s.move_time(5, wait=False)Käänny paikallaan
Määrittää, mihin suuntaan ja kuinka monta astetta robotti kääntyy paikallaan.
Kun valitset odota, suoritus odottaa, kunnes kääntyminen on valmis.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| direction | Pudotusvalikon vaihtoehto | Kääntymissuunta | vasen(left), oikea(right) | - |
| data | Syöte (lohko) | Kääntymiskulma (astetta) | Desimaaliluku 0 tai suurempi | - |
| wait | Valintaruutu | Odotetaanko, kunnes valmis | TRUE / FALSE | TRUE |
Python
hamster_s = HamsterS(0)
hamster_s.turn_degree('left', 90, wait=True)Muuta pyörän nopeutta
Muuttaa HamsterSin pyörän nopeutta.
Uusi pyörän nopeus on nykyinen pyörän nopeus plus kirjoittamasi nopeus.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| unit | Pudotusvalikon vaihtoehto | Ohjattava pyörä | vasen(left), oikea(right), molemmat(both) | - |
| speed | Syöte (lohko) | Nopeuden muutos | Kokonaisluku välillä -200 ja 200 | - |
Python
hamster_s = HamsterS(0)
hamster_s.change_wheel_speed('both', 10)Pysäytä
Pysäyttää HamsterSin liikkeen.
Parametrit
(ei mitään)
Python
hamster_s = HamsterS(0)
hamster_s.stop()Liikkuuko pyörä?
Palauttaa true, jos pyörä liikkuu, ja false, jos se on pysähdyksissä.
Parametrit
(ei mitään)
Python
hamster_s = HamsterS(0)
hamster_s.wheel_moving()Liiku laudalla yksi askel eteenpäin
Liikkuu laudalla yhden askelen kerrallaan laudan ruudutuksen mukaan.
Parametrit
(ei mitään)
Python
hamster_s = HamsterS(0)
hamster_s.grid_move()Käänny laudalla
Kääntyy laudalla 90 astetta määrittämääsi suuntaan.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| direction | Pudotusvalikon vaihtoehto | Kääntymissuunta | vasen(left), oikea(right) | - |
Python
hamster_s = HamsterS(0)
hamster_s.grid_turn('left')Kierrä pisteen ympäri
Määrittää kiertopisteen, suunnan ja kulman, kun käytät kynänpidintä.
Kun valitset odota, suoritus odottaa, kunnes kääntyminen on valmis.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| base | Pudotusvalikon vaihtoehto | Kiertopiste | vasen kynä(left_pen), oikea kynä(right_pen), vasen pyörä(left_wheel), oikea pyörä(right_wheel) | - |
| direction | Pudotusvalikon vaihtoehto | Kääntymissuunta | eteenpäin(forward), taaksepäin(backward) | - |
| degree | Syöte (lohko) | Kääntymiskulma (astetta) | Desimaaliluku 0 tai suurempi | - |
| wait | Valintaruutu | Odotetaanko, kunnes valmis | TRUE / FALSE | TRUE |
Python
hamster_s = HamsterS(0)
hamster_s.pivot('left_pen', 'forward', 90, wait=True)Piirrä ympyrä pisteen ympäri
Määrittää kiertopisteen, suunnan, säteen ja kulman, kun piirrät ympyrän kynänpitimellä.
Kun valitset odota, suoritus odottaa, kunnes kääntyminen on valmis.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| base | Pudotusvalikon vaihtoehto | Kiertopiste | vasen kynä(left_pen), oikea kynä(right_pen) | - |
| direction | Pudotusvalikon vaihtoehto | Kääntymissuunta | vasemmalle eteen(left_forward), vasemmalle taakse(left_backward), oikealle eteen(right_forward), oikealle taakse(right_backward) | - |
| degree | Syöte (lohko) | Kääntymiskulma (astetta) | Desimaaliluku 0 tai suurempi | - |
| radius | Syöte (lohko) | Kierron säde | Desimaaliluku 0 tai suurempi | - |
| unit | Pudotusvalikon vaihtoehto | Säteen yksikkö | cm, mm, tuuma(inch) | cm |
| wait | Valintaruutu | Odotetaanko, kunnes valmis | TRUE / FALSE | TRUE |
Python
hamster_s = HamsterS(0)
hamster_s.pivot_circle('left_pen', 'left_forward', 90, 1, 'cm', wait=True)Seuraa viivaa anturilla
HamsterS seuraa tietyn väristä viivaa lattia-anturin avulla.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| floor | Pudotusvalikon vaihtoehto | Viivaa seuraava lattia-anturi | vasen(left), oikea(right), keskimmäinen(center) | - |
| line | Pudotusvalikon vaihtoehto | Viivan väri | musta(black), valkoinen(white) | black |
Python
hamster_s = HamsterS(0)
hamster_s.trace_line('left', 'black')Seuraa viivaa seuraavaan risteykseen
HamsterS liikkuu risteyksessä määrittämääsi suuntaan ja jatkaa, kunnes se kohtaa seuraavan risteyksen.
Kun valitset odota, suoritus odottaa, kunnes liike on valmis.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| direction | Pudotusvalikon vaihtoehto | Suunta risteyksessä | käänny vasemmalle(left), käänny oikealle(right), aja eteenpäin(forward), u-käännös(uturn) | - |
| line | Pudotusvalikon vaihtoehto | Viivan väri | musta(black), valkoinen(white) | black |
| wait | Valintaruutu | Odotetaanko, kunnes valmis | TRUE / FALSE | TRUE |
Python
hamster_s = HamsterS(0)
hamster_s.trace_intersection('left', 'black', wait=True)Aseta viivanseurannan nopeus
Määrittää nopeuden, jolla robotti seuraa viivaa. Nopeus on välillä 1 ja 10.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| data | Syöte (lohko) | Viivanseurannan nopeus | Kokonaisluku välillä 1 ja 10 | - |
Python
hamster_s = HamsterS(0)
hamster_s.set_trace_speed(5)Aseta viivanseurannan vahvistus
Määrittää, kuinka paljon suunta muuttuu, kun robotti seuraa viivaa. Muutos on välillä 1 ja 10.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| data | Syöte (lohko) | Suunnan muutos | Kokonaisluku välillä 1 ja 10 | - |
Python
hamster_s = HamsterS(0)
hamster_s.set_trace_gain(5)Lopeta viivan seuraaminen
Lopettaa HamsterSin viivanseurannan.
Parametrit
(ei mitään)
Python
hamster_s = HamsterS(0)
hamster_s.stop_trace()Aseta LED-valon väri
Määrittää HamsterSin LED-valon värin.
Kun valitset värin väripaletista, se muunnetaan kutsussa värin nimeksi (englanninkieliseksi merkkijonoksi). (Koodiin tulee värin nimi, ei R-, G- ja B-lukuja.)
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| unit | Pudotusvalikon vaihtoehto | Ohjattava LED-valo | vasen(left), oikea(right), molemmat(both) | - |
| color | Väri | Valitse väripaletista → muunnetaan värin nimeksi (englanniksi) | Värin nimi: 'black', 'red', 'yellow', 'green', 'cyan', 'blue', 'magenta', 'white' | - |
Python
hamster_s = HamsterS(0)
hamster_s.set_led_color('both', 'red')Aseta LED-valon väri Väri-kategorian lohkolla
Ottaa syötteeksi Väri-kategorian lohkon ([R, G, B]) ja määrittää LED-valon värin.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| unit | Pudotusvalikon vaihtoehto | Ohjattava LED-valo | vasen(left), oikea(right), molemmat(both) | - |
| data | Syöte (väri) | Väri-kategorian lohko tai [R, G, B]-taulukko | [0~255, 0~255, 0~255] | - |
Python
hamster_s = HamsterS(0)
hamster_s.set_led_color('both', *Utils.color_rgb(255, 128, 0))Muuta LED-valon väriä RGB-arvoilla
Muuttaa HamsterSin LED-valon väriä antamillasi R-, G- ja B-arvoilla.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| unit | Pudotusvalikon vaihtoehto | Ohjattava LED-valo | vasen(left), oikea(right), molemmat(both) | - |
| r | Syöte (kenttä) | Punaisen muutos | Kokonaisluku välillä -255 ja 255 | 0 |
| g | Syöte (kenttä) | Vihreän muutos | Kokonaisluku välillä -255 ja 255 | 0 |
| b | Syöte (kenttä) | Sinisen muutos | Kokonaisluku välillä -255 ja 255 | 0 |
Python
hamster_s = HamsterS(0)
hamster_s.change_led_color('both', 10, 0, 0)Sammuta LED-valo
Poistaa LED-valon värin.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| unit | Pudotusvalikon vaihtoehto | Ohjattava LED-valo | vasen(left), oikea(right), molemmat(both) | both |
Python
hamster_s = HamsterS(0)
hamster_s.turn_off('both')Aseta summerin taajuus
Määrittää HamsterSin summerin äänen valitsemallasi taajuudella.
Taajuus voi olla välillä 122.1 Hz ja 4186.0 Hz.
Jos kirjoitat arvon tämän alueen ulkopuolelta, summeri ei soi.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| hz | Syöte (lohko) | Taajuus (Hz) | Desimaaliluku välillä 122.1 ja 4186.0 (muuten 0) | - |
Python
hamster_s = HamsterS(0)
hamster_s.sound_buzz(440)Soita nuotti
HamsterS soittaa valitsemasi nuotin.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| note | Pudotusvalikon vaihtoehto | Nuotti | Do(C), Do#(C#), Re(D), Re#(D#), Mi(E), Fa(F), Fa#(F#), Sol(G), Sol#(G#), La(A), La#(A#), Si(B) | - |
| octave | Pudotusvalikon vaihtoehto | Oktaavi | 3, 4, 5, 6, 7 | 4 |
Python
hamster_s = HamsterS(0)
hamster_s.sound_note('D', 5)Toista äänileike
HamsterS toistaa tietyn äänileikkeen.
Kun valitset odota, suoritus odottaa, kunnes toisto on valmis.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| clip | Pudotusvalikon vaihtoehto | Äänileikkeen nimi | 'mute', 'beep', 'siren', 'engine', 'robot', 'march', 'birthday', 'happy', 'angry', 'sad' ja muut | - |
| wait | Valintaruutu | Odotetaanko, kunnes valmis | TRUE / FALSE | TRUE |
Python
hamster_s = HamsterS(0)
hamster_s.sound_clip('siren', wait=True)Ääni pois
Sammuttaa HamsterSin äänen.
Parametrit
(ei mitään)
Python
hamster_s = HamsterS(0)
hamster_s.sound_off()Soiko ääni?
Palauttaa true, jos ääni soi, ja false, jos ei soi.
Parametrit
(ei mitään)
Python
hamster_s = HamsterS(0)
hamster_s.sound_playing()Pyörän nopeus
Tietyn pyörän nopeus
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| unit | Pudotusvalikon vaihtoehto | Luettava pyörä | vasen(left), oikea(right) | - |
Python
hamster_s = HamsterS(0)
hamster_s.wheel_speed('left')Läheisyysanturin arvo
Tietyn läheisyysanturin arvo
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| unit | Pudotusvalikon vaihtoehto | Mitattavan anturin sijainti | vasen(left), oikea(right) | - |
Python
hamster_s = HamsterS(0)
hamster_s.proximity('left')Lattia-anturin arvo
Tietyn lattia-anturin arvo
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| unit | Pudotusvalikon vaihtoehto | Mitattavan anturin sijainti | vasen(left), oikea(right) | - |
Python
hamster_s = HamsterS(0)
hamster_s.floor('left')Kiihtyvyyden arvo
Painovoiman kiihtyvyys tietyllä akselilla
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| unit | Pudotusvalikon vaihtoehto | Mitattava akseli | x-akseli(x), y-akseli(y), z-akseli(z) | - |
Python
hamster_s = HamsterS(0)
hamster_s.acceleration('x')Kirkkaus
Kirkkausanturin arvo
Parametrit
(ei mitään)
Python
hamster_s = HamsterS(0)
hamster_s.light()Lämpötila
Lämpötila-anturin arvo
Parametrit
(ei mitään)
Python
hamster_s = HamsterS(0)
hamster_s.temperature()Signaalin voimakkuus
Signaalin voimakkuus
Parametrit
(ei mitään)
Python
hamster_s = HamsterS(0)
hamster_s.signal_strength()Akku
Akun jännite
Parametrit
(ei mitään)
Python
hamster_s = HamsterS(0)
hamster_s.battery()Onko tila muuttunut?
Onko robotin tila muuttunut
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| unit | Pudotusvalikon vaihtoehto | Tilan laji | Välillä 0 ja 7 (katso alla oleva taulukko) | - |
| unit | Merkitys | Python |
|---|---|---|
| 0 | Kallistus eteen | acceleration('x') > 5000 |
| 1 | Kallistus taakse | acceleration('x') < -5000 |
| 2 | Kallistus vasemmalle | acceleration('y') > 5000 |
| 3 | Kallistus oikealle | acceleration('y') < -5000 |
| 4 | Käännetty ylösalaisin | acceleration('z') > 0 |
| 5 | Ei käännetty | acceleration('z') < -3000 |
| 6 | Este/käsi havaittu | proximity('left') > 50 or proximity('right') > 50 |
| 7 | Naputus | tap() |
Python
hamster_s = HamsterS(0)
# unit = 0
hamster_s.acceleration('x') > 5000
# unit = 6
hamster_s.proximity('left') > 50 or hamster_s.proximity('right') > 50
# unit = 7
hamster_s.tap()Aseta portin tulotila
Määrittää I/O-portin tulotilan.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| unit | Pudotusvalikon vaihtoehto | I/O-portti | A(a), B(b), molemmat(both) | - |
| option | Pudotusvalikon vaihtoehto | I/O-tila | analog_input, digital_input, digital_input_pullup, digital_input_pulldown, analog_input_voltage, servo_output, pwm_output, digital_output | - |
Python
hamster_s = HamsterS(0)
hamster_s.io_mode('both', 'analog_input')Aseta portin lähtö
Määrittää valitsemasi I/O-portin lähtöarvon.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| unit | Pudotusvalikon vaihtoehto | I/O-portti | A(a), B(b), molemmat(both) | - |
| data | Syöte (lohko) | Lähtöarvo | Kokonaisluku välillä 0 ja 180 | - |
Python
hamster_s = HamsterS(0)
hamster_s.set_output('a', 90)Muuta portin lähtöä
Muuttaa valitsemasi I/O-portin lähtöarvoa.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| unit | Pudotusvalikon vaihtoehto | I/O-portti | A(a), B(b), molemmat(both) | - |
| data | Syöte (lohko) | Lähtöarvon muutos | Kokonaisluku | - |
Python
hamster_s = HamsterS(0)
hamster_s.change_output('a', 10)Avaa / sulje tarttuja
Avaa tai sulkee HamsterSin tarttujan.
Unitin arvon mukaan kutsutaan toista kahdesta metodista.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| unit | Pudotusvalikon vaihtoehto | Toiminto | avaa(open), sulje(close) | - |
Python
hamster_s = HamsterS(0)
# unit = "open"
hamster_s.open_gripper()
# unit = "close"
hamster_s.close_gripper()Aseta laukaisimen kulma
Ohjaa laukaisinta määrittämällä kulman. Kulma on välillä 0 ja 180.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| data | Syöte (lohko) | Laukaisimen kulma | Kokonaisluku välillä 0 ja 180 | - |
Python
hamster_s = HamsterS(0)
hamster_s.shooter(45)Portin tuloarvo
Palauttaa HamsterSin I/O-portin tuloarvon.
Parametrit
| Nimi | Laji | Kuvaus | Alue / Tyyppi | Oletus |
|---|---|---|---|---|
| unit | Pudotusvalikon vaihtoehto | I/O-portti | A(a), B(b) | - |
Python
hamster_s = HamsterS(0)
hamster_s.get_input('a')