[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[PATCH rc3 19/30] target/avr: Add section about AVR into QEMU documentat

From: Aleksandar Markovic
Subject: [PATCH rc3 19/30] target/avr: Add section about AVR into QEMU documentation
Date: Sun, 26 Jan 2020 23:55:00 +0100

From: Michael Rolnik <address@hidden>

Explains basic ways of using AVR target in QEMU.

Signed-off-by: Michael Rolnik <address@hidden>
Message-Id: <address@hidden>
Signed-off-by: Richard Henderson <address@hidden>
[PMD: Fixed typos]
Signed-off-by: Philippe Mathieu-Daudé <address@hidden>
Signed-off-by: Aleksandar Markovic <address@hidden>
 qemu-doc.texi | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/qemu-doc.texi b/qemu-doc.texi
index 2328e7e..aaf4e54 100644
--- a/qemu-doc.texi
+++ b/qemu-doc.texi
@@ -1723,6 +1723,7 @@ differences are mentioned in the following sections.
 * Microblaze System emulator::
 * SH4 System emulator::
 * Xtensa System emulator::
+* AVR System emulator::
 @end menu
 @node PowerPC System emulator
@@ -2496,6 +2497,56 @@ so should only be used with trusted guest OS.
 @c man end
+@node AVR System emulator
+@section AVR System emulator
+@cindex system emulation (AVR)
+Use the executable @file{qemu-system-avr} to emulates a AVR 8 bit based machine
+having one for the following cores: avr1, avr2, avr25, avr3, avr31, avr35, 
+avr5, avr51, avr6, avrtiny, xmega2, xmega3, xmega4, xmega5, xmega6 and xmega7.
+As for now it supports few Arduino boards for educational and testing purposes.
+These boards use a ATmega controller, which model is limited to USART & 16 bit
+timer devices, enought to run FreeRTOS based applications (like this 
+Following are examples of possible usages, assuming demo.elf is compiled for
+AVR cpu
+@item Continuous non interrupted execution
+qemu-system-avr -machine mega2560 -bios demo.elf
+@end example
+@item Continuous non interrupted execution with serial output into telnet 
+qemu-system-avr -machine mega2560 -bios demo.elf -serial 
tcp::5678,server,nowait -nographic
+@end example
+and then in another shell
+telnet localhost 5678
+@end example
+@item Debugging wit GDB debugger
+qemu-system-avr -machine mega2560 -bios demo.elf -s -S
+@end example
+and then in another shell
+avr-gdb demo.elf
+@end example
+and then within GDB shell
+target remote :1234
+@end example
+@item Print out executed instructions
+qemu-system-avr -machine mega2560 -bios demo.elf -d in_asm
+@end example
+@end itemize
 @node QEMU User space emulator
 @chapter QEMU User space emulator

reply via email to

[Prev in Thread] Current Thread [Next in Thread]