[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH rc6 30/30] target/avr: Add section into QEMU documentation
From: |
Thomas Huth |
Subject: |
[PATCH rc6 30/30] target/avr: Add section into QEMU documentation |
Date: |
Sun, 5 Jul 2020 16:03:15 +0200 |
The new section explains basic ways of using AVR target in QEMU.
Signed-off-by: Michael Rolnik <mrolnik@gmail.com>
[thuth: Converted doc from texi to Sphinx syntax]
Signed-off-by: Thomas Huth <huth@tuxfamily.org>
---
docs/system/target-avr.rst | 37 +++++++++++++++++++++++++++++++++++++
docs/system/targets.rst | 1 +
2 files changed, 38 insertions(+)
create mode 100644 docs/system/target-avr.rst
diff --git a/docs/system/target-avr.rst b/docs/system/target-avr.rst
new file mode 100644
index 0000000000..40d212a9a7
--- /dev/null
+++ b/docs/system/target-avr.rst
@@ -0,0 +1,37 @@
+.. _AVR-System-emulator:
+
+AVR System emulator
+-------------------
+
+Use the executable ``qemu-system-avr`` to emulate a AVR 8 bit based machine.
+These can have one of 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
+https://github.com/seharris/qemu-avr-tests/blob/master/free-rtos/Demo/AVR_ATMega2560_GCC/demo.elf
+).
+
+Following are examples of possible usages, assuming demo.elf is compiled for
+AVR cpu
+
+ - Continuous non interrupted execution:
+ ``qemu-system-avr -machine mega2560 -bios demo.elf``
+
+ - Continuous non interrupted execution with serial output into telnet window:
+ ``qemu-system-avr -machine mega2560 -bios demo.elf -serial
+ tcp::5678,server,nowait -nographic``
+ and then in another shell
+ ``telnet localhost 5678``
+
+ - Debugging wit GDB debugger:
+ ``qemu-system-avr -machine mega2560 -bios demo.elf -s -S``
+ and then in another shell
+ ``avr-gdb demo.elf``
+ and then within GDB shell
+ ``target remote :1234``
+
+ - Print out executed instructions:
+ ``qemu-system-avr -machine mega2560 -bios demo.elf -d in_asm``
diff --git a/docs/system/targets.rst b/docs/system/targets.rst
index 99435a3eba..560783644d 100644
--- a/docs/system/targets.rst
+++ b/docs/system/targets.rst
@@ -19,3 +19,4 @@ Contents:
target-xtensa
target-s390x
target-rx
+ target-avr
--
2.26.2
- Re: [PATCH rc6 22/30] target/avr: Register AVR support with the rest of QEMU, (continued)
- [PATCH rc6 26/30] target/avr: Update build system, Thomas Huth, 2020/07/05
- [PATCH rc6 24/30] hw/avr: Add some ATmega microcontrollers, Thomas Huth, 2020/07/05
- [PATCH rc6 28/30] tests/boot-serial: Test some Arduino boards (AVR based), Thomas Huth, 2020/07/05
- [PATCH rc6 27/30] tests/machine-none: Add AVR support, Thomas Huth, 2020/07/05
- [PATCH rc6 23/30] hw/avr: Add support for loading ELF/raw binaries, Thomas Huth, 2020/07/05
- [PATCH rc6 25/30] hw/avr: Add limited support for some Arduino boards, Thomas Huth, 2020/07/05
- [PATCH rc6 29/30] tests/acceptance: Test the Arduino MEGA2560 board, Thomas Huth, 2020/07/05
- [PATCH rc6 30/30] target/avr: Add section into QEMU documentation,
Thomas Huth <=
- Re: [PATCH rc6 00/30] target/avr merger, no-reply, 2020/07/05
- Re: [PATCH rc6 00/30] target/avr merger, Philippe Mathieu-Daudé, 2020/07/07