Funktion | Aktion |
playTone(freq, duration) | spielt einen Ton mit gegebener Frequenz (in Hertz) und Dauer (in ms) |
setVolume(volume) | setzt die Lautstärke (0..100). Dieser Wert wird dauerhaft gespeichert |
setLED(pattern) | schaltet LEDs: 0: aus, 1: grün, 2: rot, 3: rot hell, 4: grün blinkend, 5: rot blinkend, 6: rot blinkend hell, 7: grün doppelblinkend, 8: rot doppelblinkend, 9: rot doppelblinkend hell |
drawString(text, x, y) | schreibt einzeiligen Text an Position x (horizontal, y (vertikal) |
clearDisplay() | löscht den Bildschirm |
sleep(ms) | hält das Programm während der gegebenen Zeit (in ms) an |
getIPAddresses() | gibt eine Liste aller IP Adressen zurück, die der EV3 erhalten hat |
getRobot() | liefert die Instanz des globalen Robot zurück (zur Verwendung der OOP-Klassen) |
exit() | gibt alle Ressourcen frei. Alle Programme müssen zuletzt exit() aufrufen, damit das nächste Programm ausgeführt werden kann |
Funktion | Aktion |
forward() | startet die Vorwärtsbewegung mit vordefinierter Geschwindigkeit |
backward() | startet die Rückwärtsbewegung mit vordefinierter Geschwindigkeit |
left() | startet die Linksbewegung (rechter Motor vorwärts, linker Motor rückwärts) |
right() | startet die Rechtsbewegung (linker Motor vorwärts, rechter Motor rückwärts) |
leftArc(radius) | startet die Linkskurvenbewegung (Radius in m, nur approximativ) |
rightArc(radius) | startet die Rechtskurvenbewegung (Radius in m, nur approximativ) |
stop() | stoppt die Bewegung |
setSpeed(speed) | setzt die Geschwindigkeit (0..100). Wird erst beim Aufruf der nächsten Bewegungsfunktion wirksam |
Instanzen | Ort |
motA, motB, motC, motD | Motor am entprechenden MotorPort |
Methoden | Aktion |
forward() | dreht den Motor vorwärts |
backward() | dreht den Motor rückwärts |
setSpeed(speed) | setzt die Geschwindigkeit (0..100) |
isMoving() | gibt True zurück, falls der Motor in Bewegung ist |
stop() | stoppt den Motor |
getMotorCount() | gibt den momentanen Stand des Zählers zurück |
resetMotorCount() | setzt den Zähler auf 0 |
rotateTo(count) | setzt Zähler auf 0, bewegt Motor bis Zählerstand count und stoppt (blockierend) |
rotateTo(count, blocking) | wie rotateTo(count), mit blocking = False nicht blockierend |
continueTo(count) | wie rotateTo(count), aber Zähler nicht auf 0 gesetzt |
continueTo(count, blocking) | wie rotateTo(count, blocking), aber Zähler nicht auf 0 gesetzt, mit blocking = False nicht blockierend |
continueRelativeTo(count) | wie continueTo(count), aber count ist Inkrement |
continueRelativeTo(count, blocking) | wie continueTo(count, blocking), aber count ist Inkrement, mit blocking = False nicht blockierend |
Instanzen | Ort |
button_escape | Oben links |
button_enter | Mitte |
button_left | Cursor links |
button_right | Cursor rechts |
button_up | Cursor aufwärts |
button_down | Cursor abwärts |
Methode | Aktion |
was_pressed() | gibt True zurück, falls der Button seit dem letzten Aufruf gedrückt wurde |
Instanzen | Ort |
ls1, ls2, ls3, ls4 | Lichtsensor am entsprechenden SensorPort |
Methode | Aktion |
getValue() | liefert die Lichtintensität (0..1023) |
Instanzen | Ort |
sht1, sht2, sht3, sht4 | Sensor am entsprechenden SensorPort |
Methode | Aktion |
getValues() | liefert ein Float-Tupel mit Temperatur (Grad C) und Luftfeuchtigkeit (%). |
Instanzen | Ort |
bme1, bme2, bme3, bme4 | Sensor am entsprechenden SensorPort |
Methode | Aktion |
getValues() | liefert ein Float-Tupel mit Temperatur (Grad C) , Luftfeuchtigkeit (%) und Luftdruck (hPa) |
Instanzen | Ort |
adxl1, adxl2, adxl3, adxl4 | Sensor am entsprechenden SensorPort |
Methode | Aktion |
getValues() | liefert ein Float-Tupel mit den Beschleunigungen in x-, y- und z-Richtung (m/s^2 im Bereich -2g .. 2g) |
Funktion | Aktion |
getDistance() | liefert Distanz in mm (-1, falls keine reflektierendes Objekt gefunden wird) |
Funktion | Aktion |
getTemperature() | liefert die Temperatur in Grad Celsius |
Instanzen | Ort |
irs | Infrarotsensor an SensorPort S1 |
Methode | Aktion |
getCommand() | gibt die aktuelle Kommando-ID für die gedrückten Tasten zurück: Der rote Schiebeschalter muss ganz oben stehen (für SensorPort S1) |
Funktion | Aktion |
httpGet(url) | führt einen HTTP GET Request durch und liefert den Response zurück. url in der Form "http://<server>?key=value&key=value&..." Statt http kann auch https verwendet werden |
httpPost(url, content) | führt einen HTTP POST Request durch und liefert den Response zurück. url in der Form "http://<server>". content im Format "key=value&key=value&..." Statt http kann auch https verwendet werden |
httpDelete(url) | führt einen HTTP DELETE Request mit der gegebenen Ressource aus |
startHTTPServer(handler) | startet einen HTTP Server (Webserver auf Port 80), der auf HTTP GET Requests hört. Bei einem GET Request wird die benutzerdefinierte Callbackfunktion handler(clientIP, filename, params) aufgerufen. Beispiel: Für die URL http://192.168.0.101/on?a=ok&b=3 ist filename = "/on" und params = {"a" : "ok", "b" : "3"} Die Rückgabe besteht aus kommagetrennten Werten, die in die %s-Formatangaben der gespeicherten HTML-Datei eingebaut werden, bevor sie dem Browser zurückgesendet wird. (Die Anzahl und Reihenfolge muss übereinstimmen.) Fehlt der Rückgabewert, so wird die HTML-Datei unverändert zurückgesendet. Die Funktion ist blockierend. Um wieder in den Kommandomodus zu kommen, muss der Micro:LinkUp neu gebootet werden |
saveHTML(text) | speichert den Text als HTML-Datei, die dem Browser bei einem GET Request zugesendet wird. Sie kann %-Formatangaben enthalten, die mit den Rückgabewerten der Callbackfunktion handler ersetzt werden |
Wetterdaten
Funktion | Aktion | ||||||||||||||||||||
getWeather(city, key) |
macht einen Wetterdaten-Request auf http://openweathermap.org für den gegebenen Ort. Dabei wird der gegebene Authorisierungsschlüssel verwendet. Diesen kann man man kostenfrei auf diesem Host beziehen. (Wird der Parameter weggelassen, so wird ein Standardschlüssel verwendet, der maximal 60 Anfragen / min für alle Nutzer erlaubt.) Rückgabewert: Dictionary mit den Feldern:
|
Lokales Datum/Zeit für gegebene Stadt
Funktion | Aktion |
getHTTPDateTime(city, timezone, key) |
macht einen Zeit/Datum-Request auf https://api.timezonedb.com für den gegebenen Ort. Dabei wird der gegebene Authorisierungsschlüssel verwendet. Diesen kann man man kostenfrei auf diesem Host beziehen. (Wird der Parameter weggelassen, so wird ein Standardschlüssel verwendet, der maximal 1 Anfrage/sec für alle Nutzer erlaubt.) timezone ist entweder der Country Code oder der Landesname (englisch). Rückgabewert: String im Format: ww yyyy-nn-dd hh:mm:ss Falls ein Fehler auftritt, wird None zurückgegeben |
getHTTPTime(city, timezone, key) | dasselbe, aber es wird nur der Zeitteil im Format hh:mm:ss zurückgegeben |
getCountryCode(country) | gibt den Country Code (2 Buchstaben) zum gegebenenen Land (englisch geschrieben) zurück |
getCountry(countryCode) | gibt das Land zum zum gegebenenen Country Code zurück |
countryCodes | Dictionary mit countryCode:country |