AVR-Simulation
SimulAVR
SimulAVR ist ein Simulator, der einige Prozessoren der AVR-Familie auf einem PC-Hostsystem (Windows, Linux, Mac OS X) simulieren kann. Dieser Simulator ist auch im WinAVR-Paket enthalten (/WinAVR/bin/simulavr.exe).
Eine Verwendung von SimulAVR ist das sog. Signal Tracing, d.h. das aufzeichnen von Änderungen der diversen Register (z.B. der Pins eines I/O-Ports) in eine VCD-Datei. Auch wenn die Laufzeit des Simulators oft langsamer als die der Hardware ist, entsprechen diese Aufzeichnungen auf den CPU-Takt genau dem, was auf der Hardware passieren würde. Wie diese Aufzeichnungen gemacht werden ist bei SimulAVR selbst kaum dokumentiert, doch bei RepRap gibt es eine kleine SimulAVR Anleitung, die eine gute Passage dazu enthält.
Die Hauptanwendung von SimulAVR dürfte das Debuggen sein. Dafür wird SimulAVR über ein dazu passendes Frontend bedient. GDB und Insight sind zwei, ebenfalls in WinAVR enthaltene, Programme, die ein solches Frontend bilden.
Wer "textorientiertes" Debugging mag, oder beispielsweise emacs als Frontend verwenden möchte, der nutzt den GDB, den GNU Debugger. Er ist im WinAVR-Paket enthalten (/WinAVR/bin/avr-gdb.exe). Wer gleich eine grafische Benutzeroberfläche (GUI) verwenden möchte, nutzt Insight (welches intern ebenfalls den GDB verwendet).
Beide Debugger, also GDB oder Insight, benötigen ein Backend. Entweder handelt es sich dabei um einen ICE/JTAG-Debugger wie z. B. AVaRICE als Interface zu einem realen AVR-Mikrocontroller oder um einen Simulator.
Starten von SimulAVR
Um SimulAVR mit default-Parametern zu starten, reicht es aus, folgende Zeile in einer Shell/Eingabeaufforderung einzugeben:
$ simulavr -g -d <AVR-Prozessortyp>
SimulAVR startet dann mit den defaultparametern und stellt einen GDBServer-Prozess auf dem lokalen oder entfernten Host auf Port 1212 zur Verfügung. Das Backend der Simulation ist nun Einsatzbereit.
Eine weitere Möglichkeit ist, SimulAVR mit Display zu starten. Dann werden während der Ausführung die Werte der Register und dem RAM angezeigt (siehe Bild).
$ simulavr -g -P simulavr-disp -d <AVR-Prozessortyp>
Eine Übersicht der unterstützten AVR-Prozessoren und der SimulAVR spezifischen Parameter bekommt man durch folgende Zeile:
$ simulavr --help
Starten des GDB
Um das (vorläufige) Frontend GDB zu starten, reicht folgende Zeile:
$ avr-gdb
Der GDB meldet sich mit folgendem Bildschirm:
Current directory is c:/WinAVR/testprj4/ GNU gdb 6.1 Copyright 2004 Free Software Foundation, Inc. GDB is free software, covered by the GNU General Public License, and you are welcome to change it and/or distribute copies of it under certain conditions. Type "show copying" to see the conditions. There is absolutely no warranty for GDB. Type "show warranty" for details. This GDB was configured as "--host=i686-pc-cygwin --target=avr". (gdb)
(gdb) ist der Prompt.
Soll während dem Debuggen der Quellcode angezeigt werden, der zur Zeit ausgeführt wird, kann GDB wie folgt gestartet werden.
$ avr-gdb -tui
Beim (gdb) prompt dann das Layout auf Assembler umschalten.,
(gdb) layout asm
Simulieren/Debuggen
Im ersten Schritt muss dem GDB die gewünschte Datei (vorher mittels entsprechendem Makefile erzeugt) bekannt gemacht werden. Es ist darauf zu achten, dass das Programm mit Debugsymbolen kompiliert wurde.
(gdb) file main.elf Reading symbols from main.elf...done.
Als nächstes muss dem GDB mitgeteilt werden, welches Ziel (target) er als Backend verwenden soll:
(gdb) target remote localhost:1212
oder kürzer:
(gdb) targ rem :1212 Remote debugging using :1212 0x00000000 in __vectors ()
Jetzt muss das Programm in den Simulator geladen werden:
(gdb) load Loading section .data, size 0x32 lma 0x1bc Loading section .text, size 0x1bc lma 0x0 Start address 0x0, load size 494 Transfer rate: 3952 bits in <1 sec, 30 bytes/write.
Damit der Simulator nicht das gesamte Programm abarbeitet, sollte man breakpoints setzen. Den Ersten am besten bei main:
(gdb) b main Breakpoint 1 at 0xd2: file main.c, line 16.
Jetzt kann man das Programm im Simulator mit continue starten:
(gdb) c Continuing.
Bei Erreichen des zuvor gesetzten breakpoints stoppt GDB und meldet:
Breakpoint 1, main () at main.c:16 (gdb)
Eine Liste der verfügbaren debug-befehle des GDB findet sich durch die Eingabe von help.
[TODO] Einige häufige GDB-Commands als Beispiel einfügen.
VMLab
VMLab ist eine komplette Freeware-IDE mit Debugger und Simulator für MS-Windows. VMLab arbeitet mit WinAVR zusammen und kann AVR-Peripheriehardware simulieren. Leider hat der Autor von VMLab die Entwicklung im Jahr 2006 eingestellt, da dem Projekt nicht der gewünschte kommerzielle Erfolg vergönnt war. Die aktuelle Version ist 3.15 von Oktober 2009.
Siehe auch:
- Forumsbeitrag VMLAB Bug bei Stackpointer/Interrupt?
- Workaround
AVR Studio
AVR Studio von Atmel enthält neben dem Übersetzungsteil, dem Debuggingteil auch einen Simulatorteil. Eine Übersicht über alle drei Programmteile gibt der Powerpoint-Vortrag AVR Studio: The comprehensive tutorial (MS PowerPoint 2007) von Jeremy Gummeson und Brendan Kemp.
Wenn nur ein Breakpoint gesetzt ist, kann mit F5 das Programm einen Abarbeitungszyklus machen. Die Bearbeitung bleibt dann wieder beim Breakpoint stehen. Mit der Stoppuhr kann dann die Zeit für den abgearbeiteten Programmteil gemessen werden. Mit der rechten Mouse-Taste kann die Stoppuhr zurückgesetzt werden.
Ausführliche Anleitung zum Ablauf einer Simulation: Tutorial der Purdue University (engl., PDF) (link tot!)
Externe Signale können mit den Tools HAPSIM oder über eine Stimulidatei in den Simulator eingespeist werden.
Zu beachten ist, dass sich mit der Einführung des AVR Simulator 2, welcher Vorteile wie Unterstützung von TWI bietet, das Datenformat für extern zugeführte Stimuli-Files geändert hat. Eine kleine Einführung inkl. Beispiel bietet die im AVR-Studio enthaltene Hilfe:
- AVR Studio Help → AVR Tools User Guide → Simulator → Simulator2 Stimuli
HAPSIM
HAPSIM (Helmis AVR Periphery Simulator) ist ein Tool zur graphischen Simulation von Tasten, LED, LCD und Terminalfunktionen in AVR Studio. (deutsch/engl., Windows, Freeware). Hinweise zur Installation von Hapsim nach einem AVR Studio Update stehen im Forum. HAPSIM kann nur mit AVRStudio 4.x verwendet werden, für den Fall, dass die Domain selbst nicht funktioniert kann folgender Direktlink verwendet werden.
Stimuli
Über eine sog. Stimuli-Datei lassen sich von ausserhalb Signale dem AVR Studio zuführen. Informationen zum Aufbau einer Stimulidatei finden sich in obigem "AVR Studio: The comprehensive tutorial" und bei Atmel (What is the format of the AVR Studio simulator stimuli files?). Der Stimuli Generator for AVR Studio ist eine Freeware für die Erzeugung von Stimulidateien und deren grafischen Darstellung. Für dieses Programm ist .NET 1.1 oder 2.0 erforderlich.
LogAnalyser
LogAnalyser v1.00 (c) 2008 Jon Escombe is a graphical "logic analyser" style display of Atmel AVR Studio simulator log files. The project is built using the (excellent) zedGraph charting class library, and the source code is made available under GPL license. Requires Windows XP and .NET framework 2.0 to run.
TCPSimDBG
TCPSimDBG ist ein Plugin für AVR-Studio um Remote Simulating/Debugging über TCP/IP durchzuführen. Ein TCP/IP-Terminal oder Serverprogramm kann sich mit dem Simulator/Debugger von AVR-Studio verbinden und Informationen aus dem Debugprozess abrufen und ändern. Damit lassen sich virtuelle Geräte (Devices) eingerichten. (Atmel SDK Lizenz, Windows XP, 2003, Vista .NET 3.5 erforderlich)
AVR Logic Analyzer
AVR Logic Analyzer von Coyne Technology Systems ist ein AVR Studio Plugin zur grafischen Anzeige der simulierten I/O-Ports. (kommerziell)
Avrora
Avrora, a research project of the UCLA Compilers Group, is a set of simulation and analysis tools for programs written for the AVR microcontroller produced by Atmel and the Mica2 sensor nodes. Avrora contains a flexible framework for simulating and analyzing assembly programs, providing a clean Java API and infrastructure for experimentation, profiling, and analysis.
Proteus VSM for Atmel AVR
Proteus VSM for Atmel AVR ist ein kommerzieller AVR Simulator.
In der Codesammlung gibt es dafür ein Virtuelles AVR Funk Pollin Simulationsmodell von Daniel Cagara.
CrossWorks for AVR
CrossWorks for AVR besitzt einen core simulator für AVRs. (Windows, Mac OS X, Linux, Solaris)
simavr
simavr is a new AVR simulator from Michel "buserror" Pollet for linux, or any platform that uses avr-gcc. It uses avr-gcc own register definition to simplify creating new targets for supported AVR devices.
The status of the project is the core works at about 98% (ie, it works, but there is a known bug). The supported IOs are eeprom, IO ports (including pin interupts), 8 bits timers (well, one of mode of the myriad) and a simple UART that makes “printf” work.
gdb support is planned next.
Lizenz: GPL v3
Diskussion bei avrfreaks.net
avrtest
avrtest ist ein freier AVR Core-Simulator, der zur Ausführung der avr-gcc Testsuite verwendet wird. Über spezielle "magische SFRs" können bestimmte Aktionen ausgelöst werden wie z.B. definierter Programmabbruch oder die Ausgabe eines Zeichens auf Console, so daß ein Programm wie
#include <stdio.h>
int main()
{
printf ("Hallo Welt!\n");
return 0;
}
analoge Resultate bringt wie ein Programm, das nativ auf dem Rechner ausgeführt wird.
avrtest ist Open Source, einfach gehalten und auf Geschwindigkeit getrimmt. Die Eingabe von Stimuli ist nicht möglich, und interne Peripherie wird nicht unterstützt.
- Lizenz: GPL v2 oder höher
- Betriebssysteme: Windows, Linux, etc. Eigentlich keine Einschränkung, da es sich um ein Open-Source Projekt handelt.
Weblinks
BASCOM AVR
In BASCOM AVR ist ein Simulatorteil enthalten und damit ist auch die Simulation von Geräten (LCD, UART) möglich. BASCOM AVR wird von MCS Electronics verkauft (89€) und ist ein unter Windows laufender BASIC Compiler für Atmel AVR Mikrocontroller. Eine auf 4 KB Codegröße eingeschränkte Demoversion ist kostenlos erhältlich.
ldi r16,0x10
LDI r17,0x12
ADD R16,R17
strt : rjmp strt
MacSim - AVR simulator for OS X
Einschränkungen u.A.: "There are currently no timers, interrupts, or EEPROM. The processor is 'generic' and has fixed size data and instruction memories."