Anleitung powered by qfix Dokument Nr.
Inhaltsverzeichnis 1 Einleitung 4 1.1 Referenz . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.2 Inhalt der CD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.3 Zusätzlich benötigte Komponenten . . . . . . . . . . . . . . . . . . . . . . 5 1.4 Kontakt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2 Installation und Start 6 2.1 Voraussetzungen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 2.
INHALTSVERZEICHNIS 5.4 IDE – C-Control PRO Entwicklungsumgebung 3 . . . . . . . . . . . . . . . 20 5.5 Terminal – Terminalprogramm . . . . . . . . . . . . . . . . . . . . . . . . 21 5.6 Tools anpassen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Kapitel 1 Einleitung Der Name Grape steht für “Graphical Programming Environment”, also Graphische Programmierumgebung. Das bedeutet, dass man mit Grape programmieren kann, ohne über Erfahrungen in einer textorientierten Programmiersprache zu verfügen. Es ist vielmehr so, dass man beim Befassen mit Grape ganz automatisch auch die textuelle Art des Programmierens lernt, da man stets den vom System generierten Programmcode live betrachten kann, bevor man das Programm auf das Controllerboard lädt.
KAPITEL 1. EINLEITUNG 1.3 5 Zusätzlich benötigte Komponenten Grape kann rein als graphischer Editor für Programmstrukturen verwendet werden. Hierzu wird keine weitere Software oder Hardware benötigt. Mit Grape for C-Control PRO ist es möglich, graphische Programme in ausführbaren Code zu übersetzen und auf einen C-Control PRO Controller zu laden. Hierzu wird zusätzlich eine C-Control PRO Hardware benötigt. Bitte informieren Sie sich hierzu auf der Internetseite www.c-control.
Kapitel 2 Installation und Start 2.1 Voraussetzungen Die Software kann ab Windows XP installiert werden. Die Windows-Versionen vor XP werden nicht mehr unterstützt, bzw. werden nicht geprüft. Für das Übertragen von Programmen auf einen C-Control PRO Controller wird ein freier USB Port benötigt. Achtung: Um vom Code-Generator erzeugte Programme zu übersetzen, muss die C-Control PRO Software installiert sein. Bitte laden Sie diese von der Internetseite www.c-control.de herunter und installieren sie vorab.
KAPITEL 2.
Kapitel 3 Programmstruktur graphisch erstellen In diesem Kapitel wird beschrieben, wie man in Grape ein Flussdiagramm erstellt, um die Programmstruktur des zu erstellenden Programmes graphisch darzustellen. Als Beispielprojekt soll ein einfaches Programm dienen, das andauernd einen Button abfragt und bei Betätigung eine LED an- bzw. ausschaltet. 3.1 Neues Projekt starten Klicken Sie im Startfenster ”New Project” an.
KAPITEL 3. PROGRAMMSTRUKTUR GRAPHISCH ERSTELLEN 9 Das Hauptfenster ist in zwei Teile unterteilt: Links die Auswahlliste für Programmelemente, rechts das Programmierfenster. Bei größeren Flussdiagrammen wird manchmal etwas mehr Platz im Hauptfenster benötigt. Aus diesem Grund kann das Fenster, das die Programmelemente enthält aus dem Hauptfenster herausgezogen werden.
KAPITEL 3. PROGRAMMSTRUKTUR GRAPHISCH ERSTELLEN 3.3 10 Elemente anordnen Elemente einfügen Programmelemente werden per Drag&Drop in das bestehende Flussdiagramm eingefügt. Hierzu wird ein Element mit der Maus gefasst (linke Maustaste drücken und halten) und an der gewünschten Einfügestelle wieder losgelassen. Das Einfügen ist jeweils an der Stelle eines Pfeiles möglich.
KAPITEL 3. PROGRAMMSTRUKTUR GRAPHISCH ERSTELLEN 11 Alternativ öffnet sich per rechtem Mausklick auf ein Element das Popup-Menü dieses Elements. Hierin gibt es einen Eintrag ”Rename”, über den ebenfalls das Eingabefeld geöffnet werden kann. Elemente löschen Über das Popup-Menü (rechte Maustaste) lässt sich der Eintrag ”Delete” auswählen, der ein Element, bzw. einen ganzen Block löscht. 3.4 Funktionen hinzufügen Über den Menüpunkt Diagram→New function...
Kapitel 4 Code generieren Der Code-Generator von Grape hat die Aufgabe, das erstellte Flussdiagramm in (lesbaren) Programmcode zu übersetzen. Natürlich ist dies allein auf Basis der Beschreibungen, die auf den Elementen des Flussdiagrammes stehen, nicht möglich. Vielmehr muss nun genau spezifiziert werden, was mit jedem einzelnen Element gemeint ist. 4.1 Code-Generator anschalten Um Code zu generieren, muss erst der Code-Generator von Grape aktiviert werden.
KAPITEL 4. CODE GENERIEREN 13 Das neue Code-Fenster ist ebenso wie das Fenster mit den Programmelementen aus dem Hauptfenster herausnehmbar und kann so beliebig platziert werden. Wie man sieht existiert bereits ein Programm-Grundgerüst. Dieses wird sogar schon durch den Compiler fehlerfrei übersetzt. Eine Funktion erfüllt es aber natürlich noch nicht. Diese Funktion soll nun im folgenden hinzugefügt werden. 4.
KAPITEL 4. CODE GENERIEREN 4.3 14 Modul-Funktionen anzeigen Die Funktionen, die ein bestimmtes Modul anbietet können eingesehen werden, indem mit der rechten Maustaste auf ein bestimmtes Modul geklickt wird. Es öffnet sich ein Kontextmenü mit dem Eintrag ”Module info...”. Nach Auswahl dieses Eintrags erscheint eine Informationsbox über das entsprechende Modul. Alternativ kann mittels F1 die Hilfe gestartet werden, in der die Funktionen der einzelnen Module ebenfalls beschrieben werden. 4.
KAPITEL 4. CODE GENERIEREN 4.4.2 15 Fallunterscheidungen Ein Doppelklick auf eine Fallunterscheidung (If-Statement) öffnet den zugehörigen Dialog: Im ersten Tab lässt sich ein Funktionsaufruf bestimmen, dessen Rückgabewert direkt entscheidet, ob die Fallunterscheidung nach links (true) oder nach rechts (false) abzweigt. Im zweiten Tab lässt sich ein Vergleich zweier Werte realisieren. 4.4.
KAPITEL 4. CODE GENERIEREN 4.4.4 16 Funktionsaufrufe Ein Doppelklick auf einen Funktionsaufruf (Function Call) öffnet den zugehörigen Dialog: Hier lässt sich in Tab 1 lediglich eine bereits angelegte Funktion auswählen (siehe 3.4). 4.4.5 Variablendeklaration Ein Doppelklick auf eine Variablendeklaration öffnet den zugehörigen Dialog: Hier kann eine Variable eines bestimmten Datentyps deklariert werden.
KAPITEL 4. CODE GENERIEREN 4.4.6 17 Tab ’C-Code’ In jedem Dialog existiert noch ein weiterer Tab ’C-Code’. In diesem Tab ist es möglich, direkt textuellen C-Code einzugeben. Diese Möglichkeit wurde vorgesehen, falls es in einer bestimmten Situation nicht möglich ist, über die Auswahlmöglichkeiten der vorherigen Tabs die gewünschte Funktonalität zu erreichen.
Kapitel 5 Tools Grape verwendet für verschiedene Aufgaben externe Programme, sogenannte Tools. Beispielsweise wird der Aufruf des Compilers oder das Programm zur Übertragung auf das Controller-Board jeweils als Tool verwaltet.
KAPITEL 5. TOOLS 19 Die Compilierung erfolgt im Hintergrund und dauert einige Sekunden. Nach erfolgreicher Compilierung erscheint folgende Nachricht: Diese Nachricht zeigt an, dass in Ihrem aktuellen Verzeichnis eine ausführbare Datei ("Binärdatei") mit der Endung .bc erzeugt wurde, die nun auf den Controller übertragen werden kann. Fehler beim Übersetzen Grape ist so ausgelegt, dass normalerweise keine Übersetzungsfehler vorkommen können.
KAPITEL 5. TOOLS 20 Bitte prüfen Sie, ob sich das Controllerboard im Reset-Zustand befindet! Drücken Sie andernfalls den Reset-Button am C-Control Board. Klicken Sie nun auf ”OK”. Für die Übertragung wird das C-Control PRO Übertragungsprogramm verwendet. Die Übertragung dauert nur wenige Sekunden. Nach erfolgreichem Übertragen starten Sie das Programm durch Drücken des Start-Knopfes am C-Control Board.
KAPITEL 5. TOOLS 21 Hierdurch wird es möglich, am gleichen Projekt textbasiert weiter zu arbeiten. 5.5 Terminal – Terminalprogramm Ein Druck auf F9 startet ein kleines Terminal-Programm. Mit diesem ist es möglich, Text und Daten eines C-Control Boards zu empfangen, die über die serielle Schnittstelle des Controllers verschickt wurden. Hierzu muss der serielle Port des Controllerboards an einen USB-Port des PCs angeschlossen werden.
KAPITEL 5. TOOLS 5.6 22 Tools anpassen Um ein C-Control Programm zu übersetzen und auf den Controller zu laden werden externe Programme (sogenannte Tools) benötigt. Diese Tools sind voreingestellt, müssen aber für Ihre Kombination aus Computer, Betriebssystem und Ort der C-Control-Software nicht unbedingt passen. Die Tools lassen sich jedoch flexibel konfigurieren, so dass sie leicht angepasst werden können.
KAPITEL 5. TOOLS 23 Das Tool für den Aufruf des Compilers ist folgendermaßen voreingestellt: • Kommando: ”%grape\c-control-pro\Bin\CC_Comp.exe” • Parameter: -cpu-avr32 -lib=IntFunc_lib -lib=LCD_Lib.cc -dest=%path\%file.bc %path\%file.cc Hier wird als Compiler also der C-Control Compiler CC_Comp.exe aufgerufen, in dem betreffenden Unterverzeichnis ausgehend vom Installationsverzeichnis der Grape Software (abgekürzt durch %grape).
KAPITEL 5. TOOLS 24 den Eintrag -com=%com. Bei dieser Einstellung wird ein Dialog geöffnet, über den der COM-Port ausgewählt werden kann. Anmerkung: Welche COM-Schnittstelle bei Ihnen verwendet wird, sehen Sie am einfachsten durch Anstecken der Hardware und durch Öffnen des ”Gerätemanagers”. Öffnen sie hierzu über das Start-Menü die Systemsteuerung und wählen den Gerätemanager.
KAPITEL 5. TOOLS 25 Es handelt sich um das gleiche Tool wie beim Download. Es werden lediglich andere Parameter übergeben. Achtung: Hier ist wieder die korrekte USB COM-Schnittstelle einzugeben. 5.6.4 Tool IDE Das Tool zum Öffnen der C-Control IDE ist folgendermaßen voreingestellt: • Kommando: ”%grape\c-control-pro\CP_IDE.exe” • Parameter: %path\%file.cc Über dieses Tool kann die C-Control IDE mit dem aktuell erzeugten Quellcode geöffnet werden.
KAPITEL 5. TOOLS 26 Das Tool für das Terminal-Programm ist folgendermaßen voreingestellt: • Kommando: ”%grape\qfixTerminal.exe” • Parameter: Dieses Tool startet das Terminal-Programm qfixTerminal, das sich im Grape Ordner befindet. Selbstverständlich können hier auch andere Terminal-Programme gestartet werden.
Conrad Electronic SE Klaus-Conrad-Straße 1 92240 Hirschau qfix robotics GmbH Erich-Rittinghaus-Straße 2/2 89250 Senden Web: www.c-control.de Web: www.conrad.de Tel.: Fax.: Mail: Web: 07307-800321 07307-800322 info@qfix.de www.qfix.