Hamster

Instanz deklarieren

Wenn du einen Hamster-Block zum Arbeitsbereich hinzufügst, wird im Python-Code automatisch die folgende Instanzdeklaration eingefügt:

hamster = Hamster(0)
# wenn es mehrere Instanzen gibt
hamster_1 = Hamster(1)

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
index	Dropdown-Option	Instanznummer (beginnt bei 0)	ganze Zahl ≥ 0	0

Radgeschwindigkeit setzen

Legt die Radgeschwindigkeit fest. Der Bereich der Geschwindigkeit ist -100 ~ 100.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
unit	Dropdown-Option	Art des Rads	links(left), rechts(right), beide(both)	-
speed	Eingabe (Block)	Radgeschwindigkeit	ganze Zahl -100 ~ 100, 0: Stopp	-

Python

hamster = Hamster(0)

hamster.set_wheel_speed('both', 50)

Zeit fahren

Fährt mit der aktuellen Radgeschwindigkeit für die angegebene Zeit.
Ist keine Radgeschwindigkeit gesetzt, fährt der Roboter mit der Standardgeschwindigkeit vorwärts.
Wenn du warten aktivierst, wird gewartet, bis die Fahrt abgeschlossen ist.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
data	Eingabe (Block)	Fahrzeit (Sekunden)	reelle Zahl ≥ 0	-
wait	Kontrollkästchen	Auf Abschluss warten	TRUE / FALSE	TRUE

Python

hamster = Hamster(0)

# wait = TRUE
hamster.move_time(5, wait=True)
# wait = FALSE
hamster.move_time(0.5, wait=False)

Radgeschwindigkeit ändern

Ändert die Radgeschwindigkeit von Hamster.
Die eingegebene Geschwindigkeit wird zur aktuellen Radgeschwindigkeit addiert und ergibt die neue Radgeschwindigkeit.
Die neu gesetzte Radgeschwindigkeit wird auf den Bereich -100 ~ 100 begrenzt.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
unit	Dropdown-Option	Art des Rads	links(left), rechts(right), beide(both)	-
speed	Eingabe (Block)	Geschwindigkeitsdifferenz	ganze Zahl -200 ~ 200	-

Python

hamster = Hamster(0)

hamster.change_wheel_speed('both', 10)

Anhalten

Stoppt die Fahrt von Hamster.
Beide Radgeschwindigkeiten von Hamster werden auf 0 zurückgesetzt.

Parameter

(keine)

Python

hamster = Hamster(0)

hamster.stop()

Auf dem Spielfeld einen Schritt vorwärts fahren

Fährt auf dem Spielfeld wie vorgesehen Feld für Feld.

Parameter

(keine)

Python

hamster = Hamster(0)

hamster.grid_move()

Auf dem Spielfeld drehen

Dreht sich auf dem Spielfeld um 90 Grad in die angegebene Richtung.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
direction	Dropdown-Option	Drehrichtung	links(left), rechts(right)	-

Python

hamster = Hamster(0)

hamster.grid_turn('left')

Der Linie mit dem Bodensensor folgen

Hamster folgt mit dem Bodensensor einer Linie in einer bestimmten Farbe.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
floor	Dropdown-Option	Bodensensor für die Linienverfolgung	links(left), rechts(right), Mitte(center)	-
line	Dropdown-Option	Farbe der Linie	schwarz(black), weiß(white)	black

Python

hamster = Hamster(0)

hamster.trace_line('left', 'black')

Der Linie bis zur nächsten Kreuzung folgen

Hamster fährt an der Kreuzung in die angegebene Richtung und folgt dann der Linie, bis er die nächste Kreuzung erreicht.
Wenn du warten aktivierst, wird gewartet, bis die Fahrt abgeschlossen ist.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
direction	Dropdown-Option	Fahrtrichtung an der Kreuzung	links abbiegen(left), rechts abbiegen(right), vorwärts(forward), wenden(uturn)	-
line	Dropdown-Option	Farbe der Linie	schwarz(black), weiß(white)	black
wait	Kontrollkästchen	Auf Abschluss warten	TRUE / FALSE	TRUE

Python

hamster = Hamster(0)

hamster.trace_intersection('left', 'black', wait=True)

Linienverfolgungsgeschwindigkeit setzen

Legt die Geschwindigkeit der Linienverfolgung fest. Der Bereich ist 1 ~ 10.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
data	Eingabe (Block)	Geschwindigkeit der Linienverfolgung	ganze Zahl 1 ~ 10	-

Python

hamster = Hamster(0)

hamster.set_trace_speed(5)

Linienverfolgung beenden

Beendet die Linienverfolgung von Hamster.

Parameter

(keine)

Python

hamster = Hamster(0)

hamster.stop_trace()

LED-Farbe setzen

Legt die Farbe der LED fest.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
unit	Dropdown-Option	Ziel-LED	links(left), rechts(right), beide(both)	-
color	Dropdown-Option	Farbe	schwarz(black), blau(blue), grün(green), cyan(cyan), rot(red), magenta(magenta), gelb(yellow), weiß(white)	-

Python

hamster = Hamster(0)

hamster.set_led_color('both', 'red')

LED ausschalten

Löscht die Farbe der LED.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
unit	Dropdown-Option	Ziel-LED	links(left), rechts(right), beide(both)	both

Python

hamster = Hamster(0)

hamster.turn_off('both')

Summerton setzen

Legt den Summerton von Hamster mit der angegebenen Frequenz fest.
Der Frequenzbereich, in dem ein Ton erzeugt werden kann, ist 1,0 Hz ~ 6553,5 Hz.
Bei anderen Werten wird kein Summerton erzeugt.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
hz	Eingabe (Block)	Frequenz (Hz)	reelle Zahl 0 ~ 6553,5	-

Python

hamster = Hamster(0)

hamster.sound_buzz(440)

Note spielen

Hamster spielt die angegebene Note.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
note	Dropdown-Option	Note	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	Dropdown-Option	Oktave	1, 2, 3, 4, 5, 6, 7	4

Python

hamster = Hamster(0)

hamster.sound_note('D', 5)

Ton ausschalten

Schaltet den Ton von Hamster aus.

Parameter

(keine)

Python

hamster = Hamster(0)

hamster.sound_off()

Radgeschwindigkeit

Die Geschwindigkeit eines bestimmten Rads

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
unit	Dropdown-Option	Ziel-Rad	links(left), rechts(right)	-

Python

hamster = Hamster(0)

hamster.wheel_speed('left')

Näherungssensor

Der Wert eines bestimmten Näherungssensors

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
unit	Dropdown-Option	Position des Sensors	links(left), rechts(right)	-

Python

hamster = Hamster(0)

hamster.proximity('left')

Bodensensor

Der Wert eines bestimmten Bodensensors

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
unit	Dropdown-Option	Position des Sensors	links(left), rechts(right), Mitte(center)	-

Python

hamster = Hamster(0)

hamster.floor('left')

Beschleunigung

Der Wert der Erdbeschleunigung auf einer bestimmten Achse

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
unit	Dropdown-Option	Gemessene Achse	x, y, z	-

Python

hamster = Hamster(0)

hamster.acceleration('x')

Helligkeit

Wert des Helligkeitssensors

Parameter

(keine)

Python

hamster = Hamster(0)

hamster.light()

Temperatur

Wert des Temperatursensors

Parameter

(keine)

Python

hamster = Hamster(0)

hamster.temperature()

Signalstärke

Signalstärke

Parameter

(keine)

Python

hamster = Hamster(0)

hamster.signal_strength()

Batterie

Batteriespannung

Parameter

(keine)

Python

hamster = Hamster(0)

hamster.battery()

Zustandsänderung

Ob sich der Zustand des Roboters geändert hat

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
unit	Dropdown-Option	Art des Zustands	0 ~ 6 (siehe Tabelle unten)	-

unit	Bedingung
0	acceleration('x') > 5000
1	acceleration('x') < -5000
2	acceleration('y') > 5000
3	acceleration('y') < -5000
4	acceleration('z') > 0
5	acceleration('z') < -3000
6	proximity('left') > 50 or proximity('right') > 50

Python

hamster = Hamster(0)

# unit = 0
hamster.acceleration('x') > 5000
# unit = 6
hamster.proximity('left') > 50 or hamster.proximity('right') > 50

Port-Eingabemodus festlegen

Legt den Eingabemodus des IO-Ports fest.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
unit	Dropdown-Option	Ein-/Ausgabeport	a, b, beide(both)	-
option	Dropdown-Option	Ein-/Ausgabemodus	analog_input, digital_input, digital_input_pullup, digital_input_pulldown, analog_input_voltage, servo_output, pwm_output, digital_output	-

Python

hamster = Hamster(0)

hamster.io_mode('both', 'analog_input')

Ausgabe des Ports setzen

Setzt den Ausgabewert des angegebenen IO-Ports.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
unit	Dropdown-Option	Ein-/Ausgabeport	a, b, beide(both)	-
data	Eingabe (Block)	Ausgabewert	ganze Zahl 0 ~ 180	-

Python

hamster = Hamster(0)

hamster.set_output('both', 90)

Ausgabe des Ports ändern

Ändert den Ausgabewert des angegebenen IO-Ports.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
unit	Dropdown-Option	Ein-/Ausgabeport	a, b, beide(both)	-
data	Eingabe (Block)	Differenz des Ausgabewerts	ganze Zahl	-

Python

hamster = Hamster(0)

hamster.change_output('a', 10)

Greifer öffnen / schließen

Öffnet oder schließt den Greifer von Hamster.
Je nach Wert von unit wird eine der beiden Methoden aufgerufen.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
unit	Dropdown-Option	Aktion	schließen(close), öffnen(open)	-

Python

hamster = Hamster(0)

# unit = "open"
hamster.open_gripper()
# unit = "close"
hamster.close_gripper()

Abschusswinkel setzen

Steuert den Schussmechanismus über den Winkel. Der Bereich des Winkels ist 0 ~ 180.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
data	Eingabe (Block)	Abschusswinkel	ganze Zahl 0 ~ 180	-

Python

hamster = Hamster(0)

hamster.shooter(45)

Eingabe

Gibt den Eingabewert des Ein-/Ausgabeports von Hamster zurück.

Parameter

Name	Art	Beschreibung	Bereich / Typ	Standardwert
unit	Dropdown-Option	Ein-/Ausgabeport	a, b	-

Python

hamster = Hamster(0)

hamster.get_input('a')