From nobody Wed Feb 11 02:12:18 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org ARC-Seal: i=1; a=rsa-sha256; t=1598973312; cv=none; d=zohomail.com; s=zohoarc; b=AcvfOFX1TIfMuVGwWg0CvsiVYd3U22cldL4IMF9D2ZjkJbnAPasfdZ/ZFuF0ehEKHaCbvEH5aJP3cwK62ExVtVURAghwDZ8LxW91WfVgzRGb6AnHaGqe7ZEcZ6DaoHQRQNdWviCdNCKYb/mS0RWsI+/MihmeheCRoG7yWeJeONI= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1598973312; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=oBXZOgzl9cPO7mKEMvfFYYFnjLnT2Kaf+JNsAXhUe98=; b=W/Kx7BWF9NT2kLj+yrtZtD6HuwtQhySu6GEXK34E078dgBOXl5KRH3IYB4UjtWmsSqLLHx3DX0wVxaYb+Ru389tSB25zP0P2wkQLCmrkwZhNg1Z5HP003bUdnS/n6Me+AHaVQMgqGiyT5PV0uL2I2CTFq4sV3tRvZNjFBQyBqvk= ARC-Authentication-Results: i=1; mx.zohomail.com; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1598973312987867.7123989247842; Tue, 1 Sep 2020 08:15:12 -0700 (PDT) Received: from localhost ([::1]:59008 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kD7AY-0004Hs-Dm for importer@patchew.org; Tue, 01 Sep 2020 10:21:54 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:55364) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kD6zO-0005bm-Jy; Tue, 01 Sep 2020 10:10:22 -0400 Received: from mout.kundenserver.de ([212.227.126.187]:34691) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kD6zJ-0003q1-D6; Tue, 01 Sep 2020 10:10:22 -0400 Received: from localhost.localdomain ([82.252.135.186]) by mrelayeu.kundenserver.de (mreue009 [212.227.15.167]) with ESMTPSA (Nemesis) id 1MO9qz-1jxuYe0rxx-00Oajk; Tue, 01 Sep 2020 16:10:13 +0200 From: Laurent Vivier To: qemu-devel@nongnu.org Subject: [PULL 24/44] docs/system/target-avr: Improve the AVR docs and add to MAINTAINERS Date: Tue, 1 Sep 2020 16:09:34 +0200 Message-Id: <20200901140954.889743-25-laurent@vivier.eu> X-Mailer: git-send-email 2.26.2 In-Reply-To: <20200901140954.889743-1-laurent@vivier.eu> References: <20200901140954.889743-1-laurent@vivier.eu> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Provags-ID: V03:K1:ZE42EJ6lYk1XVAUwqnV+LgGkzDrF5g9Ly3o1vyWJimPTCjldwak iJHMQZrCkahow97Y6AyWM+yiRPLBlYDynHsFP/w6/VPH1brAdXBU+I0luWw2Qo+61V63VE/ MTpDNbc11aydduTmcmZZiHfEdf1uLltgX+n2xH47ju7q8S2FjLnP553wlZW2g0KSKl7L1Lq v3nAsVgSTR/RNh3+EfGqg== X-UI-Out-Filterresults: notjunk:1;V03:K0:8Jck6vwPhoE=:aV8pTtyIC3Fjp9TYUWZ8up Whet0dcX+K+smqDbdey9NOSvOvNy3XFBiTjrhNhcAetJ2KVYkQZkgagjnYRphEK3J8MYo6gmu ZpLd3xLyAfg+rqpaBVRoz1lxLaFuJFpeUycp/czE4emRwQqgvOI2c/SuxdkAI3j48APZA50aS DlIE8VLVA7RZilP3W6PYeQh6wu7KNCOLMRCuKvXhQY617oiHk9wkmcD+qDF3j6dXBHWAso9Ef 44TA3xgIIOfmui9yaiwlMwM2vDwz5LZzmhwfUqpryjsDO/aUnOqZRix/Nm7W2EJ1bbHCloMDm V+VA7jj/tLEos56UkIaeYnlJWXIBYKCXhfrOR3fMUUsIIzP2BztHA7/D94RkDdZAhdqrokxjW zVpT5eZynuRTRuXo7DnkBhkJPdmKhhBeF16Ln83ekbn5G34Q6fCyNjWlf6kNKpTJx5akUofED I5sP7BEQNlLGuRlox+FoN96pN75YlUco6wMvKC3OLbmHegqKIVPPAWgmZgg3EOQYJo5iwxSj/ So+R0pW9ZRR1g70zYWx9saP2v2TnhgnGhITXnmiaWgFJ7G/dCBnpKNEOw0aF/h/9oboYezcJK Hpziw9NabLWCTw1e7YggoTZK1O4xScshuLulabfgQlyVF3AIgC34wJpPvC4qm+y6EOvP38+Ji yzh3W9RyuaQn5Ux9Gb/doU4ZJ47Q4Vb/GmCElMcXEh38g80fQOzdyqEnnCm5g9yr4L+czLoa3 attttfAYF/cnvFIfxIiq1vBFbW0P/9rgQ0i5q4BwK5iXgdJkZUEUNHr2PLi0XPyU6FjzQ3/PL x02rEhbqb9Q/s7r9x8z3DbCkjoO/4ycJskAsYmTT8KAxuTC0NPHC+qVHwX3ibqJyHvOl8yQ Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: none client-ip=212.227.126.187; envelope-from=laurent@vivier.eu; helo=mout.kundenserver.de X-detected-operating-system: by eggs.gnu.org: First seen = 2020/09/01 10:09:57 X-ACL-Warn: Detected OS = Linux 2.2.x-3.x [generic] X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_NONE=0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: qemu-trivial@nongnu.org, Thomas Huth , Richard Henderson , Laurent Vivier , Michael Rolnik Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" Content-Type: text/plain; charset="utf-8" From: Thomas Huth The examples look nicer when using "::" code blocks. Also mention that "-d in_asm" only outputs instructions that have not been translated by the JIT layer yet. And while we're at it, also add the AVR doc file to the MAINTAINERS file. Signed-off-by: Thomas Huth Reviewed-by: Richard Henderson Reviewed-by: Michael Rolnik Message-Id: <20200812155304.18016-1-huth@tuxfamily.org> Signed-off-by: Laurent Vivier --- MAINTAINERS | 1 + docs/system/target-avr.rst | 47 +++++++++++++++++++++++--------------- 2 files changed, 30 insertions(+), 18 deletions(-) diff --git a/MAINTAINERS b/MAINTAINERS index 5a22c8be4296..b5ba553ee01a 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -171,6 +171,7 @@ AVR TCG CPUs M: Michael Rolnik R: Sarah Harris S: Maintained +F: docs/system/target-avr.rst F: gdb-xml/avr-cpu.xml F: target/avr/ F: tests/acceptance/machine_avr6.py diff --git a/docs/system/target-avr.rst b/docs/system/target-avr.rst index dc99afc895d0..eb5c513cce09 100644 --- a/docs/system/target-avr.rst +++ b/docs/system/target-avr.rst @@ -17,21 +17,32 @@ https://github.com/seharris/qemu-avr-tests/blob/master/= free-rtos/Demo/AVR_ATMega Following are examples of possible usages, assuming demo.elf is compiled f= or AVR cpu =20 - - Continuous non interrupted execution: - ``qemu-system-avr -machine mega2560 -bios demo.elf`` - - - Continuous non interrupted execution with serial output into telnet win= dow: - ``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`` +- Continuous non interrupted execution:: + + qemu-system-avr -machine mega2560 -bios demo.elf + +- Continuous non interrupted execution with serial output into telnet wind= ow:: + + qemu-system-avr -M mega2560 -bios demo.elf -nographic \ + -serial tcp::5678,server,nowait + + 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 (that have not been translated by the JIT + compiler yet):: + + qemu-system-avr -machine mega2560 -bios demo.elf -d in_asm --=20 2.26.2