[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH rc1 14/24] target/avr: Add section about AVR into QEMU documentat
From: |
Richard Henderson |
Subject: |
[PATCH rc1 14/24] target/avr: Add section about AVR into QEMU documentation |
Date: |
Wed, 22 Jan 2020 14:02:57 -1000 |
From: Michael Rolnik <address@hidden>
Signed-off-by: Michael Rolnik <address@hidden>
Message-Id: <address@hidden>
Signed-off-by: Richard Henderson <address@hidden>
---
qemu-doc.texi | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 51 insertions(+)
diff --git a/qemu-doc.texi b/qemu-doc.texi
index 39f950471f..515aacfae9 100644
--- a/qemu-doc.texi
+++ b/qemu-doc.texi
@@ -1741,6 +1741,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
@@ -2514,6 +2515,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 does not support any real MCUs. However, it does support a
"sample" board for educational and testing purposes. This "sample" board hosts
USART & 16 bit timer devices and it's enought to run FreeRTOS based applicaton
(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 program.elf is compiled
for AVR cpu
+@itemize
+
+@item Continious non interrupted execution
+@example
+qemu-system-avr -kernel program.elf
+@end example
+
+@item Continious non interrupted execution with serial output into telnet
window
+@example
+qemu-system-avr -kernel program.elf -serial tcp::5678,server,nowait -nographic
+@end example
+and then in another shell
+@example
+telent localhost 5678
+@end example
+
+@item Continious non interrupted execution with serial output into stdout
+@example
+qemu-system-avr -kernel program.elf -serial stdio
+@end example
+
+@item Debugging wit GDB debugger
+@example
+qemu-system-avr -kernel program.elf -s -S
+@end example
+and then in another shell
+@example
+avr-gdb program.elf
+@end example
+and then within GDB shell
+@example
+target remote :1234
+@end example
+
+@item Print out executed instructions
+@example
+qemu-system-avr -kernel program.elf -d in_asm
+@end example
+
+@end itemize
+
@node QEMU User space emulator
@chapter QEMU User space emulator
--
2.20.1
- [PATCH rc1 05/24] target/avr: Add instruction translation - Branch Instructions, (continued)
- [PATCH rc1 05/24] target/avr: Add instruction translation - Branch Instructions, Richard Henderson, 2020/01/22
- [PATCH rc1 03/24] target/avr: Add instruction translation - Registers definition, Richard Henderson, 2020/01/22
- [PATCH rc1 01/24] target/avr: Add outward facing interfaces and core CPU logic, Richard Henderson, 2020/01/22
- [PATCH rc1 06/24] target/avr: Add instruction translation - Data Transfer Instructions, Richard Henderson, 2020/01/22
- [PATCH rc1 08/24] target/avr: Add instruction translation - MCU Control Instructions, Richard Henderson, 2020/01/22
- [PATCH rc1 11/24] hw/char: Add limited support for Atmel USART peripheral, Richard Henderson, 2020/01/22
- [PATCH rc1 04/24] target/avr: Add instruction translation - Arithmetic and Logic Instructions, Richard Henderson, 2020/01/22
- [PATCH rc1 07/24] target/avr: Add instruction translation - Bit and Bit-test Instructions, Richard Henderson, 2020/01/22
- [PATCH rc1 09/24] target/avr: Add instruction translation - CPU main translation function, Richard Henderson, 2020/01/22
- [PATCH rc1 10/24] target/avr: Add instruction disassembly function, Richard Henderson, 2020/01/22
- [PATCH rc1 14/24] target/avr: Add section about AVR into QEMU documentation,
Richard Henderson <=
- [PATCH rc1 16/24] target/avr: Add machine none test, Richard Henderson, 2020/01/22
- [PATCH rc1 20/24] hw/avr: Add some Arduino boards, Richard Henderson, 2020/01/22
- [PATCH rc1 12/24] hw/timer: Add limited support for Atmel 16 bit timer peripheral, Richard Henderson, 2020/01/22
- [PATCH rc1 18/24] hw/avr: Introduce ATMEL_ATMEGA_MCU config, Richard Henderson, 2020/01/22