Überblick

In diesem Bereich wird der direkte Zugriff auf die Datei DobotDll.dll über die DobotDllType.py getestet. Ziel ist es, typische Fehlerquellen und Möglichkeiten zu erkennen und stabile Lösungen in der DobotDllType.py zu dokumentieren.

• Dobot Magician – Deutsche Python-API-Dokumentation
  - von uns mittels ChatGPT erstellt und gepflegt
• DobotDllType Test: DLL Laden
• Dobot-Magician-ALARM-Description
• Dobot Magician - Dobot API
  Englische API-Referenz mit Entwicklungsübersicht.
• Dobot Magician Demo Description (englisch)
  Das Dokument beschreibt den Aufbau der Entwicklungsumgebung und Beispielprogramme für die Ansteuerung des Dobot Magician in verschiedenen Programmiersprachen und Systemen, darunter Python, Java, C#, Arduino und STM32.
• Starter Guide Dobot Magician with Python: Peripherals
  Informationen zu den Peripheriegeräten des Dobot Magician und deren Ansteuerung mit Python.

Dateien im Projekt

• api-test-00-dll-laden.py
  

  Testet die Verbindung zur Dobot-DLL und die Funktion GetDeviceVersion.

  Das Skript ist ein reiner Lade-/Umgebungstest für die Dobot-API. Es setzt den Projektpfad, ermittelt das SDK-Verzeichnis, zeigt Python- und DLL-Infos an, importiert DobotDllType, registriert das sdk64-Verzeichnis als Windows-DLL-Suchpfad und versucht anschließend, DobotDll.dll zu laden. Wenn das Laden klappt, gibt es Erfolgsmeldungen aus und beendet sich; bei Fehlern bricht es mit einer klaren Fehlermeldung und Exit-Code 1 ab.

• api-test-01-verbinden.py

  Testet die Verbindung zur Dobot und grundlegende API-Funktionen werden die Seriennummer, der Name und die Version des Geräts sowie aktuelle Pose/Gelenkwinkel und aktive Alarme ausgelesen.

• api-test-02-namen-aendern.py

  Testet das Ändern des Namens der Dobot.

• api-test-03-position-lesen.py

  Testet das Auslesen der aktuellen Position der Dobot.

• api-test-04-alarme-lesen.py

  Testet das Auslesen von Alarmen der Dobot.

• api-test-05-alarme-loeschen.py

  Testet das Löschen von Alarmen der Dobot.

• api-test-06-sofort-fahren.py

  Testet das sofortige Fahren der Dobot zu einer festen Zielposition.
  Sollte der Fahrbefehl einen Alarm auslösen, wird der Befehl nicht ausgeführt.

Ausführlich dokumentierte Beispiele

• test-1.py
  1. Es richtet die Pfade zum SDK und zur DLL ein und zeigt Python-/Systeminfos an.
  2. Es lädt das Modul DobotDllType und registriert das SDK-Verzeichnis als DLL-Suchpfad.
  3. Es lädt die Dobot-DLL, verbindet sich über COM10 mit 115200 Baud und prüft den Verbindungsstatus.
  4. Bei erfolgreicher Verbindung liest es Geräteinfos aus (Seriennummer, Name, Version), aktuelle Pose/Gelenkwinkel und aktive Alarme.
  5. Am Ende trennt es die Verbindung in jedem Fall sauber wieder (auch bei Fehlern).
• test-2.py

  Neu gegenüber test-1.py: Löscht Alarme, setzt PTP-Parameter und sendet anschließend einen sofortigen Fahrbefehl zu einer festen Zielposition.

• test-3.py

  Neu gegenüber test-2.py: Nutzt die Queue mit Überwachung (Alarm/Index), stoppt und leert zunächst laufende Befehle und bricht bei nicht löschbaren Alarmen vor der Bewegung ab.

• test-4.py

  Neu gegenüber test-3.py: Erweitert den Test um Timeout, Endauswertung mit Zielabweichung/Erfolgsstatus, robustere Vorprüfungen und ein abgesichertes Cleanup beim Trennen.