Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
de:examples:setup:windows [2010/11/09 23:40] Wemberde:examples:setup:windows [2020/07/20 09:00] (current) – external edit 127.0.0.1
Line 1: Line 1:
-====== Installationsanweisungen für Windows ======+====== Installationsanweisung für Windows ======
  
-Dieser Abschnitt enthält Informationen die notwendig sind um die AVR Development Software auf einem Windows OS zu installieren.+Dieser Abschnitt enthält alle notwendigen Informationen zur Installation der AVR Entwicklungssoftware auf einem Windows Betriebssystem zu installieren.
  
 ===== Installation ===== ===== Installation =====
  
-Man benötigt die folgende Software welche von der Homepage des Herstellers geladen werden kann oder von der CD welche mit dem HomeLab Kit geliefert wird.+Es wird die nachfolgende Software benötigt, die von der Homepage des Herstellers heruntergeladen werden kann. Wahlweise kann die Software auch von der, im HomeLab Kit enthaltenen, CD installiert werden.
  
 **1. AVR Studio** **1. AVR Studio**
  
-AVR Studio 4 IDE (//Integrated Development Environment//) ist eine Software um den Source Code zu schreiben, zu kompilieren und das Programm in den Controller zu laden. AVR Studio kann von der Atmel Homepage geladen werden.+AVR Studio 4 IDE (//Integrated Development Environment//) ist eine Software um den Quellcode zu schreiben, zu kompilieren und das Programm in den Controller zu laden. AVR Studio kann kostenlos von der Atmel Homepage bezogen werden.
  
 **2. WinAVR** **2. WinAVR**
  
-WinAVR ist ein GNU-GCC Compiler für AVR Microcontroller. Das Programm ist Freeware, welche von Sourceforge geladen werden kann. Währen der Installation WinAVR schlägt das Programm einen Ordnernamen mit einer langen Versionsnummer vor. Wir würden vorschlagen, die Versionsnummer zu entfernen, so wie es unterhalb gezeigt wird.+WinAVR ist ein GNU-GCC Compiler für AVR Microcontroller. Das Programm ist eine kostelose Software und kann welche von der Sourceforge Homepage geladen werden. Währen der Installation von WinAVR schlägt das Programm einen Ordnernamen mit einer langen Versionsnummer vor. Wir würden vorschlagen, die Versionsnummer zu entfernen, und das Programm wie folgt zu installieren:
  
   C:\WinAVR   C:\WinAVR
  
-**3. HomeLab library**+**3. HomeLab Bibliothek**
  
-HomeLab library ist ein Set von Funktionen die für das HomeLab Kit und AVR Controllern designt sindWenn man diese Bibliothek nutzt, ist das programmieren viel einfacher und effektiver. Die neuste Version der Bibliothek kann von der HomeLab Webseite geladen werden. Diese Bibliothek sollte in den gleichen Ordner von WinAVR installiert werden.+Die HomeLab Bibliothek ist ein Set von Funktionen welches für das HomeLab Kit und AVR Controller entworfen wurdeDie Nutzung dieser Bibliothek macht das Programmieren wesentlich einfacher und effektiver. Die neuste Version der Bibliothek kann von der HomeLab Webseite heruntergeladen werden. Diese Bibliothek sollte in den gleichen Ordner installiert werden, in dem sich auch WinAVR befindet.
  
-**4. Virtualer COM port Treiber**+**4. Virtualer COM Port Treiber**
  
-Der Treiber ermöglicht den Anschluss des USB JTAG-ICE Programmierer mit dem PC. Der Treiber muss vor dem anschliessen des Programmierers Installiert werden. Der Dateiname des Treibers ist "CDM x.xx.xx.exe" wobei "x" für die Versionsnummer steht. Nach der Installation des Treibers kann man den JTAG-ICE Programmierer über den USB Port anschliessen und Windows wird das Gerät automatisch erkennen. Man sollte folgende Notiz in der Windows Task-leiste sehen.+Der Treiber ermöglicht den Anschluss des USB JTAG-ICE Programmiergerätes an den PC. Er muss vor Anschluss des Programmiergerätes installiert werden. Der Dateiname des Treibers ist "CDM x.xx.xx.exe"wobei "x" für die Versionsnummer steht. Nach der Installation des Treibers kann das JTAG-ICE Programmiergerät über den USB Port angeschlossen werden und Windows wird es automatisch erkennen. Folgende Meldung sollte in der Taskleiste zu sehen sein:
  
 {{  :examples:install:windows:new_hardware_popup.png?349  |Notice of finding the new device}} {{  :examples:install:windows:new_hardware_popup.png?349  |Notice of finding the new device}}
  
-Je nach Anzahl der Virtuellen Ports die vorher an dem Computer schon definiert wurden, wird Windows eine Portnummer für das neue Gerät hinzufügenEin neuer COM Port Name wird generiert wenn das Gerät am selben Computer in einen andern USB Port gesteckt wird. Einige AVR Studio Versionen können den Programmierer nicht nutzen wenn die COM Port Nummer über 10 ist, bzw. über 4 wenn das Gerät als Debugger genutzt wird.  +Abhängig von der Anzahl vorher bereits definierter virtueller Ports, wird Windows dem neuen Gerät eine Portnummer zuweisenEs wird ein neuer Name für den COM Port generiert, sobald das Gerät an einen anderen USB Port des selben Computers angeschlossen wird. Einige AVR Studio Versionen können nicht auf das Programmiergerät zugreifen, wenn die Nummer des COM Ports größer ist als 10, bzw. größer als 4 wenn es als Debugger genutzt wird.  
-Um diese Situation zu verhindern kann man die Portnummer im //Gerätemanager// verändern und zwischen COM0 und COM4 einstellen.+ 
 +Um das zu verhindernkann die Portnummer im //Gerätemanager// verändert und auf einen Wert zwischen COM0 und COM4 einstellt werden 
 [[en:examples:setup:portissue|See the complete procedure here ]]. [[en:examples:setup:portissue|See the complete procedure here ]].
  
 ===== Ein neues Projekt erstellen ===== ===== Ein neues Projekt erstellen =====
  
-Um ein Programm für den Controller zu schreiben muss man einen Projektraum erstellen. Das Projekt beinhaltet typischer Weise unterschiedliche Dateien wie Sourcecodes, Headerdateien, kompilierte Programmdateien usw. Es wird geraten einen neuen Ordner für jedes Projekt zu erstellen(Dies wird auch vom New Project Wizard angeboten)+Um ein Programm für den Controller zu schreiben muss man einen Projektraum erstellen. Das Projekt beinhaltet typischerweise unterschiedliche Dateien wie Quellcodes, Headerdateien, kompilierte Programmdateien usw. Es wird dringend dazu geratenfür jedes Projekt einen separaten Ordner zu erstellen (Diese Funktion wird auch vom New Project Wizard angeboten).
  
-Folgende Schritte müssen erledigt werden, wenn man ein neues Projekt mit der Hilfe des Wizards erstellt.+Wird ein neues Projekt mit Hilfe des Wizards erstellt, sind folgende Schritte zu durchlaufen:
  
  
-**1.** Öffne AVR Studio und drück //New Project//. Falls die Dialogbox sich nicht automatisch öffnet wähle //Project - New project// aus der MenuleisteDrücke //Next//.+**1.** Öffnen Sie AVR Studio und klicken Sie auf //New Project//. Falls sich das Dialogfeld nicht automatisch öffnet, wählen Sie //Project - New project// aus der Menüleiste ausKlicken Sie auf //Next//.
  
 {{  :examples:install:windows:studio_welcome.png?400  |}} {{  :examples:install:windows:studio_welcome.png?400  |}}
  
-**2.** Die nächste Dialogbox ist über den Compiler und die Starteinstellungen. Wähle AVR GCC Compiler. Füge Links den Namen des Projekt und den Hauptsourcedatennamen ein. Der Sourcedateienname sollte die Endung "*.c" haben. Zwei Checkboxen sollten auch angeklickt werden, welche einen Neuen Ordner erschaffen und eine neue Datei. Man sollte auch den Ordner angeben wo die Projektdateien erstellt werden. Nach den richtigen Einstellungen drücke //Next//.+**2.** In dem nächsten Dialogfeld geht es um den Compiler und die Starteinstellungen. Wählen Sie den AVR GCC Compiler ausFügen Sie dann links den Namen des Projekts und den Hauptquelldateinamen ein. Der Quelldateienname sollte die Endung "*.c" haben. Außerdem sollten noch zwei Ankreuzfelder angeklickt werden, welche einen Neuen Ordner und die Startdatei erzeugen. Man sollte auch den Ordner angeben wo die Projektdateien erstellt werden. Nachdem diese Einstellungen vorgenommen wurden, klicken Sie auf //Next//.
  
-BeachteWenn der AVR GCC in der Compilerliste fehlt, ist er nicht richtig installiert. In diesem Fall muss die WinAVR Software installiert werden bevor man den C Sourcecode schreibt.+AchtungFehlt der AVR GCC in der Compilerliste, ist er nicht richtig installiert. In diesem Fall muss die WinAVR Software installiert werden bevor mit dem Programmieren begonnen wird.
  
 {{  :examples:install:windows:studio_new_project.png?400  |}} {{  :examples:install:windows:studio_new_project.png?400  |}}
  
-**3.** In der nächsten Dialogbox muss man die Debuggerplattform und den Microcontroller auswählen. HomeLab Kit nutzt den JTAG ICE als Debugger und den ATmega128 als MicrocontrollerNach der Auswahl drücke //Finish//.+**3.** Im nun folgenden Dialogfeld sind die Debuggerplattform sowie der Mikrocontroller auszuwählenDas HomeLab kit nutzt die JTAG ICE Debuggerplattform und den ATmega128 MikrocontrollerKlicken Sie nach der Auswahl auf //Finish//.
  
 {{  :examples:install:windows:studio_project_programmer.png?400 |}} {{  :examples:install:windows:studio_project_programmer.png?400 |}}
  
-**4.** Nun wird der Projektraum erstellt und ein neues Fenster öffnet sich, wo man den Sourcecode des Programms schreiben kann.+**4.** Nun wird der Projektraum erstellt und ein neues Fenster öffnet sich, in welchem mit dem Programmieren begonnen werden kann.
  
 {{  :examples:install:windows:studio_overview.png?500  |}} {{  :examples:install:windows:studio_overview.png?500  |}}
  
-**5.** Man muss einige Parameter des Projekts einstellen bevor man es kompiliert+**5.** Vor der ersten Kompilierung, müssen einige Parameter des Projekts eingestellt werden
-Die wichtigen Parameter sind Controllertaktfrequenz und Optimierungsmethode.Der HomeLab Controller hat eine Frequenz von 14,7456 MHz (14745600 Hz). Die Frequenz kann in Projekteinstellungen angegeben werden in Hz (nicht MHz):  +Die wichtigen Parameter sind  die Taktfrequenz des Controllers und Optimierungsmethode.Der HomeLab Controller hat eine Frequenz von 14,7456 MHz (14745600 Hz). Sie kann in den Projekteinstellungen in Hz (nicht MHz) angegeben werden :  
- //Project -> Configuration Options -> General//. Optimierungsmethode sollte -Os sein, falls man keine andere Methode benötigt.+ //Project -> Configuration Options -> General//Die Optimierungsmethode sollte -Os sein, falls keine andere Methode benötigt wird. 
 {{  :examples:install:windows:studio_project_properties_general.png?400  |}} {{  :examples:install:windows:studio_project_properties_general.png?400  |}}
  
-**6.** Um HomeLab Library Funktionen zu nutzen muss die Software richtig installiert sein. Jedes neue Projekt benötigt das hinzufügen der Bibliothek zu Liste der verlinkten Objekte. Um dies zu machen gehe nach: //Project -> Configuration Options -> Libraries// und füge Objekt "libhomelab.a" hinzu.+**6.** Um die Funktionen der HomeLab Bibliothek zu nutzen muss die Software richtig installiert sein. Bei jedem neuen Projekt benötigt muss die Bibliothek zur Liste der verlinkten Objekte hinzugefügt werdenHierzu gehen Sie auf: //Project -> Configuration Options -> Libraries// und fügen Sie "libhomelab.a" hinzu.
  
 {{  :examples:install:windows:studio_project_properties_libraries.png?400  |}} {{  :examples:install:windows:studio_project_properties_libraries.png?400  |}}
  
-Falls das Objekt //libhomelab.a// in der linken Liste fehlt ist die Bibliothek nicht richtig +Falls das Objekt //libhomelab.a// in der Liste links fehltist die Bibliothek nicht richtig installiert und sollte erneut installiert werden.
  
-===== Setting Test =====+===== Test der Einstellungen =====
  
-Nach dem Setup der Entwicklungsumgebung sollte man diese testen, um sicherzustellen, dass sie korrekt funktioniert. Der einfachste Weg ist, ein kleines Programm zu schreiben, es zu kompilieren und in den Controller zu laden. +Nach Installation der Entwicklungsumgebung sollte diese getestet werden, um sicherzustellen, dass sie korrekt funktioniert. Der einfachste Weg hierfür ist, ein kleines Programm zu schreiben, es zu kompilieren und in den Controller zu laden. 
  
-**1.** Schließe den Programmierer an dem ATmega128 Board an. Stelle sicher, dass der Programmierer richtig am JTAG Anschluss angeschlossen ist. (Kabel zeit vom Board weg - s. BildSchließe die Stromversorgung des Boards an (eine kleine grüne LED sollte leuchten wenn alles richtig angeschlossen ist.).+**1.** Schließen Sie das Programmiergerät an dem ATmega128 an. Stellen Sie sicher, dass es korrekt am JTAG Anschluss angeschlossen ist. (Kabel zeigt vom Board weg - siehe AbbildungSchließen Sie nun die Stromversorgung an (eine kleine grüne LED sollte leuchten wenn alles korrekt angeschlossen ist.).
  
-Füge den einfachen C Code ein.:+Fügen Sie nun folgenden C Code ein:
  
 <code c> <code c>
Line 81: Line 84:
 int main(void) int main(void)
 { {
- // Pin PB7 to output+ // Pin PB7 als Output
  DDRB = 0x80;  DDRB = 0x80;
  
- // Endless cycle+ // Endlosschleife
  while (true)  while (true)
  {  {
- // Pin PB7 invertion+ // Invertierung Pin PB7
  PORTB ^= 0x80;  PORTB ^= 0x80;
  hw_delay_ms(500);  hw_delay_ms(500);
Line 94: Line 97:
 </code> </code>
  
-[{{  :examples:install:windows:studio_quick_buttons.png?267  |Compilation and programmer buttons}}]+[{{  :examples:install:windows:studio_quick_buttons.png?267  |Kompilierung und Schalter des Programmiergerätes}}]
  
-Kompiliere das Projekt mit dem //Build// Befehl (Taste F7). Stelle sicher, dass die Kompilierung erfolgreich ist. Dafür sollte folgende Nachricht im Nachrichtenfenster stehen:+Kompilieren Sie das Projekt mit dem //Build// Befehl (Taste F7). Stellen Sie sicher, dass die Kompilierung erfolgreich ist. Dafür sollte folgende Nachricht im Nachrichtenfenster stehen:
  
 <code> <code>
Line 102: Line 105:
 </code> </code>
  
-**2.** Öffne das Controllerfenster //Tools -> Program AVR -> Auto Connect//Stelle sicher das der Tab //Program// offen ist..+**2.** Öffnen Sie das Controllerfenster //Tools -> Program AVR -> Auto Connect//Stellen Sie sicher, dass der Tab //Program// geöffnet ist.
  
 {{  :examples:install:windows:studio_programmer.png?400  |}} {{  :examples:install:windows:studio_programmer.png?400  |}}
  
-Falls das beschriebene Fenster sich nicht öffnet und das //Connection Failed// Fenster öffnet sich, ist der Programmer oder das Board nicht richtig angeschlossen. Überprüfe zuerst ob der Microcontroller Strom hat (grüne LED ist an) und ob der Programmer richtig an den JTAG angeschlossen ist. Falls das OK ist, überprüfe  die COM Port Nummer welche von Windows vergeben wirdWenn diese größer als 9 ist, kann Das AVR Studio den Programmierer nicht erkennen. Folge die Anweisungen zu Beginn des Kapitels um eine Portnummer zwischen 0 und 4 zuzuweisen.+Falls sich das beschriebene Fenster nicht öffnet und sich stattdessen das //Connection Failed// Fenster öffnet, ist das Programmiergerät oder die Platine nicht richtig angeschlossen. Überprüfen Sie zunächst, ob der Mkcrocontroller an die Stromversorgung angeschlossen ist (grüne LED leuchtet) und ob das Programmiergerät korrekt an den JTAG angeschlossen ist. Falls das korrekt erfolgt ist, überprüfen Sie  die von Windows vergebene COM Port Nummer. Ist diese größer als 9, kann Das AVR Studio das Programmiergerät nicht erkennen. Folgen Sie den Anweisungen zu Beginn des Kapitelsum eine Portnummer zwischen 0 und 4 zuzuweisen.
  
 {{  :examples:install:windows:studio_project_programmer_port.png?400  |}} {{  :examples:install:windows:studio_project_programmer_port.png?400  |}}
  
-**3.** Im Programmer Fester füge in die  //Flash//-sektion Textbox //Input HEX File// den Ort des kompilierten Programms ein in dem man den "..." Knopf drückt. Das kompilierte Programm ist normalerweise in dem Unterordner //default// des Projekts zu finden und hat den gleichen Namen wie das Projekt aber mit der Endung "*.hex", z.B. "Labor1.hex". Nach der Auswahl der richtigen Datei wähle //Programm// um das Programm in den Controller zu laden. +**3.** Fügen Sie im Fenster des Programmiergerätes //Flash//-sektion Textbox //Input HEX File// durch Betätigung der "..." Taste den Ort des kompilierten Programms ein. Das kompilierte Programm ist normalerweise in dem Unterordner //default// des Projekts zu finden und hat den gleichen Namen wie das Projekt jedoch mit der Endung "*.hex", z.B. "Labor1.hex". Nach Auswahl der richtigen Datei wählen Sie //Programm// um das Programm in den Controller zu laden. 
-Wenn alles richtig lief sollte man folgende Nachricht am Ende des Fensters sehen:+Wenn alles richtig gelaufen ist, sollte folgende Nachricht am Ende des Fensters zu sehen sein:
  
   OK   OK
Line 130: Line 133:
 ===== Debugger ===== ===== Debugger =====
  
-[{{  :examples:install:windows:studio_debugger_io_view.png?280|The list of registers in the debugger of the ATmega128.}}] +[{{  :examples:install:windows:studio_debugger_io_view.png?280|Liste der Register des Debuggers des ATmega128.}}] 
-Das Debuggen eines Programms bedeutet, dass man nach Fehlern im Programm sucht. +Debuggen eines Programms bedeutet, dass man nach Fehlern im Programm sucht. 
-Dafür gibt es Programme die Debugger heißensie erlauben es das Programm Schritt-für-Schritt auszuführen und dort zu stoppen wo es benötigt wirdEinige Funktionen des Programms erlauben das Überprüfen von Werten einer Variable zu jeder Phase des Programms, den Inhalt der Register und die Sequenz des Ausführens des Programms. +Dazu gibt es Programme, genannt Debugger, welche erlauben das Programm Schritt-für-Schritt auszuführen und an den notwendigen Stellen zu stoppen. Eine Implementierung des Programms ermöglicht das Überprüfen von Werten einer Variable in jeder Phase des Programms, sowie des Inhalts der Register und der Sequenz des Ausführens des Programms. 
-Debugging ist sehr wichtig, wenn man mit komplexeren Programmen arbeitet wo es oft schwer ist Fehler zu findenMit Microcontrollern ist es wichtig, dass eine Schritt-für-Schritt Implementation des Programms im Controller stattfindet, welche es erlaubt die Änderung des realen Outputs als auch die Werte der Register zu sehenZwei Bedingungen müssen erfüllt sein um einen Debugger zu nutzen: Der Microcontroller muss debuggen unterstützen und man muss die notwendige Hardware haben - den JTAG Programmer welcher Debuggen erlaubt. Günstigere Programmieren welche ISP Programmier Interface nutzen können zwar kompilierte Programme in den Controller laden aber nicht notwendigerweise debuggen.+Debugging ist sehr wichtig, wenn man mit komplexeren Programmen arbeitet, in denen die Fehlersuche häufig schwierig ist. Bei der Arbeit mit Mikrocontrollern ist es wichtig, dass eine Schritt-für-Schritt Implementation des Programms im Controller stattfindet, wodurch die Veränderung des tatsächlichen Outputs und auch die Werte der Register gesehen werden könnenZur Nutzung eines Debuggers müssen zwei erfüllt sein: Der Mikrocontroller muss das Debugging unterstützen und man muss über die notwendige Hardware verfügen, nämlich den JTAG Programmer welcher Debuggen erlaubt. Günstigere Programmiergeräte, welche das ISP Programmier Interface nutzenkönnen zwar kompilierte Programme in den Controller laden aber nicht unbedingt debuggen.
  
- Um das Programm im Debugmodus zu starten, sollte es zuerst kompiliert werden in dem mann //build// (F7) drückt und das kompilierte Programm mit dem Befehlt //run// (F5) starten+Um das Programm im Debugmodus mit dem AVR Studio zu starten, sollte es zuerst durch //build// (F7) kompiliert und daraufhin mit dem Befehl //run// (F5) gestartet werden
-Zuvor können //break points// (F9) in bestimmte Stellen im Quellcode eingefügt werden. +Zuvor können //break points// (F9) an bestimmten Stellen im Quellcode eingefügt werden. 
-Wenn die Implementation des Programms ein Breakpoint erreicht, wird das Programm gestoppt um den Status des Microcontrollers an diesem Punkt zu bestimmen. Die Implementation des Programms kann mit dem Befehl //Run//  fortgeführt werden oder mit //Step Into// (F11) kann das Programm für mit nur einem Befehl auf einmal implementiert werden. +Erreicht die Implementation des Programms einen solchen Punkt, wird das Programm angehalten, um den Status des Mikrocontrollers an diesem Punkt festzulegen. Die Implementation des Programms kann mit dem Befehl //Run// fortgeführt oder durch //Step Into// (F11) mit nur einem Befehlt vollständig implementiert werden. 
  
  
  
-===== Das Nutzen von floating-point Variablen =====+===== Die Nutzung von floating-point Variablen =====
  
-Manchmal wird in es in AVR Programmen notwendig Floating-Point Variablen zu nutzen. Um mit ihnen zu rechnen und sie mit //printf//-Typ Funktionen darzustellen, folgende SetUp-Änderungen müssen in der Konfiguration des Projekts vorgenommen werden:+Manchmal ist es bei AVR Programmen notwendigFloating-Point Variablen zu nutzen. Um mit ihnen zu rechnen und sie mit //printf//-Typ Funktionen darzustellen, müssen folgende Installationsänderungen in der Konfiguration des Projekts vorgenommen werden:
  
-**1.** Öffne das Set-Up des Projekts aus dem Menu //Project -> Configuration Options//.  Füge //libprintf_flt.a// und //libm.a// nach //libhomelab.a// der Homelab Bibliothek im Konfigurationstab //Libraries// hinzu. +**1.** Öffnen Sie die Installationsdatei des Projekts aus dem Menü //Project -> Configuration Options//.  Fügen Sie //libprintf_flt.a// und //libm.a// zu //libhomelab.a// der Homelab Bibliothek im Konfigurationstab //Libraries// hinzu. 
  
-**2.** Danach öffne //Custom Options// und wähle //[All files]//Füge Zeilen mit "-lprintf_flt" ja "-lm" in die Box rechts und die Zeile mit  "-uvfprintf" zu die //[Linker Options]// Sektion hinzu.+**2.** Öffnen Sie anschließend //Custom Options// und wählen Sie //[All files]//Fügen Sie daraufhin Zeilen mit "-lprintf_flt" ja "-lm" in die Box rechts sowie die Zeile mit  "-uvfprintf" zu der //[Linker Options]// Sektion hinzu.
  
-**3.** Drücke OK und schließe das Konfigurationsfenster+**3.** Klicken Sie auf OK und schließen Sie das Konfigurationsfenster.
de/examples/setup/windows.1289346020.txt.gz · Last modified: 2020/07/20 09:00 (external edit)
CC Attribution-Share Alike 4.0 International
www.chimeric.de Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0