diff mbox series

[v2,48/54] lasips2: add QEMU interface comment

Message ID	20220624134109.881989-49-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, deller@gmx.de, mst@redhat.com, pbonzini@redhat.com, peter.maydell@linaro.org, hpoussin@reactos.org, aleksandar.rikalo@syrmia.com, f4bug@amsat.org, jiaxun.yang@flygoat.com, qemu-arm@nongnu.org, qemu-devel@nongnu.org Date: Fri, 24 Jun 2022 14:41:03 +0100 Message-Id: <20220624134109.881989-49-mark.cave-ayland@ilande.co.uk> In-Reply-To: <20220624134109.881989-1-mark.cave-ayland@ilande.co.uk> References: <20220624134109.881989-1-mark.cave-ayland@ilande.co.uk> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [PATCH v2 48/54] lasips2: 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	PS2 device QOMification - part 1 \| expand [v2,00/54] PS2 device QOMification - part 1 [v2,01/54] ps2: checkpatch fixes [v2,02/54] ps2: QOMify PS2State [v2,03/54] ps2: QOMify PS2KbdState [v2,04/54] ps2: QOMify PS2MouseState [v2,05/54] ps2: move QOM type definitions from ps2.c to ps2.h [v2,06/54] ps2: improve function prototypes in ps2.c and ps2.h [v2,07/54] ps2: introduce PS2DeviceClass [v2,08/54] ps2: implement ps2_reset() for the PS2_DEVICE QOM type based upon ps2_common_reset() [v2,09/54] ps2: remove duplicate setting of scancode_set in ps2_kbd_init() [v2,10/54] ps2: implement ps2_kbd_realize() and use it to register ps2_keyboard_handler [v2,11/54] ps2: implement ps2_mouse_realize() and use it to register ps2_mouse_handler [v2,12/54] ps2: don't use vmstate_register() in ps2_kbd_init() [v2,13/54] ps2: don't use vmstate_register() in ps2_mouse_init() [v2,14/54] pl050: checkpatch fixes [v2,15/54] pl050: split pl050_update_irq() into separate pl050_set_irq() and pl050_update_irq() fun… [v2,16/54] lasips2: spacing fixes [v2,17/54] lasips2: rename ps2dev_update_irq() to lasips2_port_set_irq() [v2,18/54] pckbd: checkpatch fixes [v2,19/54] pckbd: move KBDState from pckbd.c to i8042.h [v2,20/54] pckbd: move ISAKBDState from pckbd.c to i8042.h [v2,21/54] pckbd: introduce new I8042_MMIO QOM type [v2,22/54] pckbd: implement i8042_mmio_reset() for I8042_MMIO device [v2,23/54] pckbd: add mask qdev property to I8042_MMIO device [v2,24/54] pckbd: add size qdev property to I8042_MMIO device [v2,25/54] pckbd: implement i8042_mmio_realize() function [v2,26/54] pckbd: implement i8042_mmio_init() function [v2,27/54] pckbd: alter i8042_mm_init() to return a I8042_MMIO device [v2,28/54] pckbd: move mapping of I8042_MMIO registers to MIPS magnum machine [v2,29/54] pckbd: more vmstate_register() from i8042_mm_init() to i8042_mmio_realize() [v2,30/54] pckbd: move ps2_kbd_init() and ps2_mouse_init() to i8042_mmio_realize() [v2,31/54] ps2: make ps2_raise_irq() function static [v2,32/54] ps2: use ps2_raise_irq() instead of calling update_irq() directly [v2,33/54] ps2: introduce ps2_lower_irq() instead of calling update_irq() directly [v2,34/54] ps2: add gpio for output IRQ and optionally use it in ps2_raise_irq() and ps2_lower_irq() [v2,35/54] pckbd: replace irq_kbd and irq_mouse with qemu_irq array in KBDState [v2,36/54] pl050: switch over from update_irq() function to PS2 device gpio [v2,37/54] pl050: add QEMU interface comment [v2,38/54] lasips2: QOMify LASIPS2State [v2,39/54] lasips2: move lasips2 QOM types from lasips2.c to lasips2.h [v2,40/54] lasips2: rename lasips2_init() to lasips2_initfn() and update it to return the LASIPS2 d… [v2,41/54] lasips2: implement lasips2_init() function [v2,42/54] lasips2: move mapping of LASIPS2 registers to HPPA machine [v2,43/54] lasips2: move initialisation of PS2 ports from lasi_initfn() to lasi_init() [v2,44/54] lasips2: add base property [v2,45/54] lasips2: implement lasips2_realize() [v2,46/54] lasips2: use sysbus IRQ for output IRQ [v2,47/54] lasips2: switch over from update_irq() function to PS2 device gpio [v2,48/54] lasips2: add QEMU interface comment [v2,49/54] pckbd: switch I8042_MMIO device from update_irq() function to PS2 device gpio [v2,50/54] pckbd: add QEMU interface comment for I8042_MMIO device [v2,51/54] pckbd: add i8042_reset() function to I8042 device [v2,52/54] pckbd: switch I8042 device from update_irq() function to PS2 device gpio [v2,53/54] pckbd: add QEMU interface comment for I8042 device [v2,54/54] ps2: remove update_irq() function and update_arg parameter

Commit Message

Mark Cave-Ayland June 24, 2022, 1:41 p.m. UTC

This describes the LASI PS2 device interface implemented within QEMU.

Signed-off-by: Mark Cave-Ayland <mark.cave-ayland@ilande.co.uk>
---
 include/hw/input/lasips2.h | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

Comments

Peter Maydell June 24, 2022, 3:11 p.m. UTC | #1

On Fri, 24 Jun 2022 at 14:44, Mark Cave-Ayland
<mark.cave-ayland@ilande.co.uk> wrote:
>
> This describes the LASI PS2 device interface implemented within QEMU.
>
> Signed-off-by: Mark Cave-Ayland <mark.cave-ayland@ilande.co.uk>

Reviewed-by: Peter Maydell <peter.maydell@linaro.org>

thanks
-- PMM

diff mbox series

Patch

diff --git a/include/hw/input/lasips2.h b/include/hw/input/lasips2.h
index 7e4437b925..03f0c9e9f9 100644
--- a/include/hw/input/lasips2.h
+++ b/include/hw/input/lasips2.h
@@ -4,6 +4,20 @@ 
  * Copyright (c) 2019 Sven Schnelle
  *
  */
+
+/*
+ * QEMU interface:
+ * + sysbus MMIO region 0: MemoryRegion defining the LASI PS2 keyboard
+ *   registers
+ * + sysbus MMIO region 1: MemoryRegion defining the LASI PS2 mouse
+ *   registers
+ * + sysbus IRQ 0: LASI PS2 output irq
+ * + Named GPIO input "ps2-kbd-input-irq": set to 1 if the downstream PS2
+ *   keyboard device has asserted its irq
+ * + Named GPIO input "ps2-mouse-input-irq": set to 1 if the downstream PS2
+ *   mouse device has asserted its irq
+ */
+
 #ifndef HW_INPUT_LASIPS2_H
 #define HW_INPUT_LASIPS2_H