diff mbox series

[PULL,37/55] pl050: add QEMU interface comment

Message ID	20220626174531.969187-38-mark.cave-ayland@ilande.co.uk (mailing list archive)
State	New, archived
Headers	show Return-Path: <qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org> From: Mark Cave-Ayland <mark.cave-ayland@ilande.co.uk> To: richard.henderson@linaro.org, qemu-devel@nongnu.org Date: Sun, 26 Jun 2022 18:45:13 +0100 Message-Id: <20220626174531.969187-38-mark.cave-ayland@ilande.co.uk> In-Reply-To: <20220626174531.969187-1-mark.cave-ayland@ilande.co.uk> References: <20220626174531.969187-1-mark.cave-ayland@ilande.co.uk> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [PULL 37/55] pl050: add QEMU interface comment Received-SPF: pass client-ip=2001:41c9:1:41f::167; envelope-from=mark.cave-ayland@ilande.co.uk; helo=mail.ilande.co.uk X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action Precedence: list Errors-To: qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org Sender: "Qemu-devel" <qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org>
Series	[PULL,01/55] ps2: checkpatch fixes \| expand [PULL,01/55] ps2: checkpatch fixes [PULL,02/55] ps2: QOMify PS2State [PULL,03/55] ps2: QOMify PS2KbdState [PULL,04/55] ps2: QOMify PS2MouseState [PULL,05/55] ps2: move QOM type definitions from ps2.c to ps2.h [PULL,06/55] ps2: improve function prototypes in ps2.c and ps2.h [PULL,07/55] ps2: introduce PS2DeviceClass [PULL,08/55] ps2: implement ps2_reset() for the PS2_DEVICE QOM type based upon ps2_common_reset() [PULL,09/55] ps2: remove duplicate setting of scancode_set in ps2_kbd_init() [PULL,10/55] ps2: implement ps2_kbd_realize() and use it to register ps2_keyboard_handler [PULL,11/55] ps2: implement ps2_mouse_realize() and use it to register ps2_mouse_handler [PULL,12/55] ps2: don't use vmstate_register() in ps2_kbd_init() [PULL,13/55] ps2: don't use vmstate_register() in ps2_mouse_init() [PULL,14/55] pl050: checkpatch fixes [PULL,15/55] pl050: split pl050_update_irq() into separate pl050_set_irq() and pl050_update_irq() f… [PULL,16/55] lasips2: spacing fixes [PULL,17/55] lasips2: rename ps2dev_update_irq() to lasips2_port_set_irq() [PULL,18/55] pckbd: checkpatch fixes [PULL,19/55] pckbd: move KBDState from pckbd.c to i8042.h [PULL,20/55] pckbd: move ISAKBDState from pckbd.c to i8042.h [PULL,21/55] pckbd: introduce new I8042_MMIO QOM type [PULL,22/55] pckbd: implement i8042_mmio_reset() for I8042_MMIO device [PULL,23/55] pckbd: add mask qdev property to I8042_MMIO device [PULL,24/55] pckbd: add size qdev property to I8042_MMIO device [PULL,25/55] pckbd: implement i8042_mmio_realize() function [PULL,26/55] pckbd: implement i8042_mmio_init() function [PULL,27/55] pckbd: alter i8042_mm_init() to return a I8042_MMIO device [PULL,28/55] pckbd: move mapping of I8042_MMIO registers to MIPS magnum machine [PULL,29/55] pckbd: more vmstate_register() from i8042_mm_init() to i8042_mmio_realize() [PULL,30/55] pckbd: move ps2_kbd_init() and ps2_mouse_init() to i8042_mmio_realize() [PULL,31/55] ps2: make ps2_raise_irq() function static [PULL,32/55] ps2: use ps2_raise_irq() instead of calling update_irq() directly [PULL,33/55] ps2: introduce ps2_lower_irq() instead of calling update_irq() directly [PULL,34/55] ps2: add gpio for output IRQ and optionally use it in ps2_raise_irq() and ps2_lower_ir… [PULL,35/55] pckbd: replace irq_kbd and irq_mouse with qemu_irq array in KBDState [PULL,36/55] pl050: switch over from update_irq() function to PS2 device gpio [PULL,37/55] pl050: add QEMU interface comment [PULL,38/55] lasips2: QOMify LASIPS2State [PULL,39/55] lasips2: move lasips2 QOM types from lasips2.c to lasips2.h [PULL,40/55] lasips2: rename lasips2_init() to lasips2_initfn() and update it to return the LASIPS2… [PULL,41/55] lasips2: implement lasips2_init() function [PULL,42/55] lasips2: move mapping of LASIPS2 registers to HPPA machine [PULL,43/55] lasips2: move initialisation of PS2 ports from lasi_initfn() to lasi_init() [PULL,44/55] lasips2: add base property [PULL,45/55] lasips2: implement lasips2_realize() [PULL,46/55] lasips2: use sysbus IRQ for output IRQ [PULL,47/55] lasips2: switch over from update_irq() function to PS2 device gpio [PULL,48/55] lasips2: add QEMU interface comment [PULL,49/55] pckbd: switch I8042_MMIO device from update_irq() function to PS2 device gpio [PULL,50/55] pckbd: add QEMU interface comment for I8042_MMIO device [PULL,51/55] pckbd: add i8042_reset() function to I8042 device [PULL,52/55] pckbd: switch I8042 device from update_irq() function to PS2 device gpio [PULL,53/55] pckbd: add QEMU interface comment for I8042 device [PULL,54/55] ps2: remove update_irq() function and update_arg parameter [PULL,55/55] artist: set memory region owners for buffers to the artist device

Commit Message

Mark Cave-Ayland June 26, 2022, 5:45 p.m. UTC

This describes the PL050 device interface implemented within QEMU.

Signed-off-by: Mark Cave-Ayland <mark.cave-ayland@ilande.co.uk>
Message-Id: <20220624134109.881989-38-mark.cave-ayland@ilande.co.uk>
Reviewed-by: Peter Maydell <peter.maydell@linaro.org>
---
 hw/input/pl050.c | 8 ++++++++
 1 file changed, 8 insertions(+)

diff mbox series

Patch

diff --git a/hw/input/pl050.c b/hw/input/pl050.c
index c665a4fc99..ffaa72dea4 100644
--- a/hw/input/pl050.c
+++ b/hw/input/pl050.c
@@ -7,6 +7,14 @@ 
  * This code is licensed under the GPL.
  */
 
+/*
+ * QEMU interface:
+ * + sysbus MMIO region 0: MemoryRegion defining the PL050 registers
+ * + Named GPIO input "ps2-input-irq": set to 1 if the downstream PS2 device
+ *   has asserted its irq
+ * + sysbus IRQ 0: PL050 output irq
+ */
+
 #include "qemu/osdep.h"
 #include "hw/sysbus.h"
 #include "migration/vmstate.h"