XWK-BOT Cheatsheet

🎨 Farben

Verwende diese Farben mit Namen, oder mische deine eigene RGB-Farbe mit Werten von 0-255. 0=dunkel, 255=hell.

# Grundfarben     Rot  Grün  Blau (RGB)
    bot.BLACK       # (0,   0,    0)
    bot.RED         # (255, 0,    0)
    bot.GREEN       # (0,   255,  0)
    bot.BLUE        # (0,   0,    255)
    bot.CYAN        # (0,   255,  255)
    bot.YELLOW      # (255, 255,  0)
    bot.MAGENTA     # (255, 0,    255)
    bot.WHITE       # (255, 255,  255)
    bot.GREY        # (128, 128,  128)

📝 bot.write(“hallo”)

Zeigt Text auf dem Bot-Display an.

bot.write("hallo", color=bot.RED)       # benutze einen Farbnamen
    bot.write("hallo", color=(0, 128, 128)) # benutze eine eigene Farbe
    bot.write("hallo", newline=False)       # schreibe in die gleiche Zeile
    bot.write("hallo", line=3)              # schreibe in eine bestimmte Zeile
    bot.write("Entfernung: ", 42, " cm")    # schreibe mehrere Dinge auf einmal

🧹 bot.clear()

Löscht das Bot-Display und macht es schwarz.

🖼️ bot.image(“smiley.raw”)

Zeigt ein Bild aus einer Datei auf dem Display an.

bot.image("smiley.raw", scale=2)  # Bild in 2x Größe anzeigen, Standard ist 5x
    bot.image("icon.raw", x=10, y=20) # Position von oben links

🚗 Motor-Funktionen

⏩ bot.step_forward()

⏪ bot.step_backward()

Bewegt den Bot für eine feste Zeit und stoppt dann.

bot.step_forward(duration=0.5)    # 0,5 Sekunden vorwärts fahren
    bot.step_forward(speed=30)        # mit Geschwindigkeit 30 vorwärts fahren

⬅️ bot.step_left()

➡️ bot.step_right()

Dreht den Bot für eine feste Zeit und stoppt dann.

bot.step_left(duration=0.75)      # 0,75 Sekunden nach links drehen
    bot.step_left(speed=30)           # mit Geschwindigkeit 30 nach links drehen

⏩ bot.forward()

⏪ bot.backward()

Bewegt den Bot vorwärts/rückwärts bis er mit “bot.stop()” gestoppt wird.

bot.forward(speed=20)             # mit Geschwindigkeit 20 vorwärts fahren
    bot.stop()                        # Bot stoppen wenn fertig

⬅️ bot.turn_left()

➡️ bot.turn_right()

🎲 bot.turn_random()

Dreht den Bot in die angegebene Richtung bis er gestoppt wird.

bot.turn_left(speed=20)           # mit Geschwindigkeit 20 nach links drehen
    bot.stop()                        # Bot stoppen wenn fertig

🎮 bot.motor()

Direkte Steuerung der Motoren.

bot.motor("forward", 20, "forward", 20)  # beide Motoren vorwärts Geschw. 20
    bot.motor("backward", 30, "forward", 0)  # linker Motor rückwärts

🔊 Sound-Funktionen

🔊 bot.beep()

Erzeugt einen Piepton über den Bot-Lautsprecher.

bot.beep(frequency=2000)   # in Hz 100 = tief, 10000 = hoch
    bot.beep(duration=0.1)     # wie lange der Ton dauern soll in Sekunden

🎵 bot.sweep()

Spielt einen auf und wieder abschwellenden Ton.

🤫 bot.shutup()

Stoppt alle laufenden Töne.

💡 LED-Funktionen

🌈 bot.rgb_led()

Setzt die Farbe der RGB-LED des Bots. Benutze “bot.BLACK” zum Ausschalten.

bot.rgb_led(bot.RED)             # LED auf Rot setzen
    bot.rgb_led((255, 0, 128))       # eigene RGB-Farbe setzen (rosa)

📊 bot.visualize_value()

Zeigt einen Wert als Farbverlauf auf der RGB-LED an (0=rot, 127=gelb, 255=grün).

bot.visualize_value(0)           # rot anzeigen (niedriger Wert)
    bot.visualize_value(127)         # gelb anzeigen (mittlerer Wert)
    bot.visualize_value(255)         # grün anzeigen (hoher Wert)

📏 Sensor-Funktionen

🌑 bot.ir_is_dark_left()

🌑 bot.ir_is_dark_right()

Prüft ob der Infrarot-Sensor eine dunkle Fläche erkennt.

if bot.ir_is_dark_left():        # wenn linker Sensor dunkel sieht
        bot.write("Links dunkel!", bot.RED)

☀️ bot.ir_is_bright_left()

☀️ bot.ir_is_bright_right()

Prüft ob der Infrarot-Sensor eine helle Fläche erkennt.

if bot.ir_is_bright_left():      # wenn linker Sensor hell sieht
        bot.write("Links hell!", bot.GREEN)

📏 bot.distance()

Misst mit dem Ultraschall-Sensor die Entfernung zum nächsten Objekt in Zentimetern.

if bot.distance() < 10:          # prüfen ob Objekt näher als 10cm
        bot.stop()                   # wenn ja, Bot stoppen

🔋 System-Funktionen

⏱️ bot.sleep()

Pausiert die Programmausführung für die angegebene Zeit. Standard = 1 Sekunde.

bot.sleep(0.5)                   # eine halbe Sekunde warten

🔍 bot.is_pressed(bot.BUTTON_A)

Prüft ob ein Knopf gerade gedrückt wird. Verfügbare Knöpfe: bot.BUTTON_A, bot.BUTTON_UP, bot.BUTTON_DOWN, bot.BUTTON_LEFT, bot.BUTTON_RIGHT.

if bot.is_pressed(bot.BUTTON_A): # wenn Knopf "A" gedrückt wird
        bot.write("A gedrückt!", bot.GREEN)

🔄 bot.reset()

Stoppt Motoren, schaltet LED und Lautsprecher aus.

📝 Grundlagen der Programmierung

💾 Variablen

Werte in deinem Programm speichern und verwenden.

name = "Klemm"                  # Text in Variable "name" speichern
    bot.write("Hallo", name)        # Variablen verwenden, schreibt "Hallo Klemm"
    
    distance = bot.distance()       # Ultraschall-Sensor Entfernung speichern
    bot.write("Entfernung: ", distance, "cm") # schreibt "Entfernung 42cm"

🔀 “If”-Bedingungen

Entscheidungen in deinem Programm treffen.

if bot.ir_is_dark_left():       # wenn linker Sensor etwas Dunkles sieht
        bot.turn_left()             # nach links drehen
    elif bot.ir_is_dark_right():    # sonst wenn rechter Sensor dunkel sieht
        bot.turn_right()            # nach rechts drehen
    else:                           # ansonsten wenn kein Sensor dunkel sieht
        bot.forward()               # vorwärts fahren

🔄 “While”-Schleife

Code wiederholen solange eine Bedingung erfüllt ist.

# Diese Schleife läuft endlos bis das Programm gestoppt wird
    while True:                     # Endlosschleife starten
        bot.rgb_led(bot.RED)        # LED rot machen
        bot.sleep()                 # 1 Sekunde warten
        bot.rgb_led(bot.BLACK)      # LED ausschalten
        bot.sleep()                 # wieder 1 Sekunde warten
        # Schleife beginnt von vorne, erzeugt Blinkeffekt

🔢 “For”-Schleife

Code eine bestimmte Anzahl von Malen wiederholen.

for i in range(3):              # etwas 3 mal machen
        bot.write("Zähle ", i)     # Schreibt "Zähle 1, Zähle 2, Zähle 3"

XWK-BOT SCHUMMELZETTEL

🖥️ Display-Funktionen