[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH rc5 32/32] target/avr: Add section into QEMU documentation
From: |
Aleksandar Markovic |
Subject: |
[PATCH rc5 32/32] target/avr: Add section into QEMU documentation |
Date: |
Fri, 7 Feb 2020 02:58:00 +0100 |
From: Michael Rolnik <address@hidden>
The new section explains basic ways of using AVR target in QEMU.
Signed-off-by: Michael Rolnik <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>
Reviewed-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 a1ef6b6..79c9e3a 100644
--- a/qemu-doc.texi
+++ b/qemu-doc.texi
@@ -1719,6 +1719,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
@@ -2487,6 +2488,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,
avr4,
+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
@url{https://github.com/seharris/qemu-avr-tests/blob/master/free-rtos/Demo/AVR_ATMega2560_GCC/demo.elf,,demo})
+
+Following are examples of possible usages, assuming demo.elf is compiled for
+AVR cpu
+@itemize
+
+@item Continuous non interrupted execution
+@example
+qemu-system-avr -machine mega2560 -bios demo.elf
+@end example
+
+@item Continuous non interrupted execution with serial output into telnet
window
+@example
+qemu-system-avr -machine mega2560 -bios demo.elf -serial
tcp::5678,server,nowait -nographic
+@end example
+and then in another shell
+@example
+telnet localhost 5678
+@end example
+
+@item Debugging wit GDB debugger
+@example
+qemu-system-avr -machine mega2560 -bios demo.elf -s -S
+@end example
+and then in another shell
+@example
+avr-gdb demo.elf
+@end example
+and then within GDB shell
+@example
+target remote :1234
+@end example
+
+@item Print out executed instructions
+@example
+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
--
2.7.4
- Re: [PATCH] !fixup "target/avr: Add defintions of AVR core types", (continued)
- [PATCH rc5 18/32] target/avr: Add support for disassembling via option '-d in_asm', Aleksandar Markovic, 2020/02/06
- [PATCH rc5 12/32] target/avr: Add instruction translation - Branch Instructions, Aleksandar Markovic, 2020/02/06
- [PATCH rc5 17/32] target/avr: Initialize TCG register variables, Aleksandar Markovic, 2020/02/06
- [PATCH rc5 30/32] .travis.yml: Run the AVR acceptance tests, Aleksandar Markovic, 2020/02/06
- [PATCH rc5 27/32] tests/machine-none: Add AVR support, Aleksandar Markovic, 2020/02/06
- [PATCH rc5 23/32] hw/avr: Add support for loading ELF/raw binaries, Aleksandar Markovic, 2020/02/06
- [PATCH rc5 25/32] hw/avr: Add limited support for some Arduino boards, Aleksandar Markovic, 2020/02/06
- [PATCH rc5 22/32] target/avr: Register AVR support with the rest of QEMU, Aleksandar Markovic, 2020/02/06
- [PATCH rc5 28/32] tests/boot-serial: Test some Arduino boards (AVR based), Aleksandar Markovic, 2020/02/06
- [PATCH rc5 32/32] target/avr: Add section into QEMU documentation,
Aleksandar Markovic <=
- [PATCH rc5 29/32] tests/acceptance: Test the Arduino MEGA2560 board, Aleksandar Markovic, 2020/02/06
- [PATCH rc5 10/32] target/avr: Add instruction translation - Register definitions, Aleksandar Markovic, 2020/02/06
- [PATCH rc5 31/32] target/avr: Simplify sections in MAINTAINERS file, Aleksandar Markovic, 2020/02/06
- [PATCH rc5 09/32] target/avr: Add instruction helpers, Aleksandar Markovic, 2020/02/06
- [PATCH rc5 21/32] hw/misc: avr: Add limited support for power reduction device, Aleksandar Markovic, 2020/02/06
- [PATCH rc5 11/32] target/avr: Add instruction translation - Arithmetic and Logic Instructions, Aleksandar Markovic, 2020/02/06
- [PATCH rc5 26/32] target/avr: Update build system, Aleksandar Markovic, 2020/02/06
- [PATCH rc5 19/32] hw/char: avr: Add limited support for USART peripheral, Aleksandar Markovic, 2020/02/06
- [PATCH rc5 24/32] hw/avr: Add some ATmega microcontrollers, Aleksandar Markovic, 2020/02/06
- [PATCH rc5 13/32] target/avr: Add instruction translation - Data Transfer Instructions, Aleksandar Markovic, 2020/02/06