Robert Allan JamesandClaude Sonnet 5
a373c9124a
Punch list §25 item 4.3.5e complete. Extended virtio_input.c with a GIC-routed interrupt path alongside 4.3.5c's PLIC one -- same capability walk, feature negotiation, eventq handling (confirming §27.5.1's prediction that these items would share most of the driver). aarch64_irq_handler() dispatches to virtio_input_isr() before its EOIR write, same claim-dispatch-complete ordering riscv64 uses. Verified with a real QEMU sendkey keypress: exact KEY_A/press match, two real interrupts serviced, identical result to riscv64. Found (not fixed) an unrelated pre-existing bug: BYE's cold-reset path faults on aarch64, discovered incidentally since nobody had exercised it from a monitored session before. Three-arch acceptance boot clean. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
50 lines
1.6 KiB
C
50 lines
1.6 KiB
C
/*
|
||
StarForth — Steady-State Virtual Machine Runtime
|
||
|
||
Copyright (c) 2023–2025 Robert A. James
|
||
All rights reserved.
|
||
|
||
Licensed under the StarForth License, Version 1.0
|
||
*/
|
||
|
||
#ifndef KEYBOARD_WORDS_H
|
||
#define KEYBOARD_WORDS_H
|
||
|
||
#include "vm.h"
|
||
|
||
/**
|
||
* @defgroup keyboard_words Keyboard Words
|
||
* @{
|
||
*
|
||
* @brief Raw hardware-boundary FORTH word for verifying the interrupt-driven
|
||
* keyboard path (FABRIC.md item 4.3.5). Deliberately a diagnostic peek at
|
||
* the raw scancode ring buffer -- no set-2 translation, no REPL wiring.
|
||
* Those belong to the later REPL keyboard-input work noted in FABRIC.md.
|
||
*
|
||
* Kernel-only, amd64-only today (i8042 is amd64 hardware); no-op elsewhere
|
||
* so dictionary parity across all three architectures is unaffected.
|
||
*
|
||
* @par KBD-SCAN ( -- c -1 | 0 )
|
||
* Pop one raw scancode off the interrupt-fed ring buffer. Pushes the
|
||
* scancode and -1 (true) if one was available, or just 0 (false) if the
|
||
* buffer was empty.
|
||
*
|
||
* @par KBD-DEBUG ( -- isr_count spurious_count )
|
||
* Standing diagnostic: count of real keyboard IRQs serviced and count of
|
||
* LAPIC spurious-vector interrupts, both since boot.
|
||
*
|
||
* @par VKBD-EVENT ( -- code value -1 | 0 )
|
||
* Items 4.3.5c (riscv64) / 4.3.5e (aarch64). Pop one decoded EV_KEY event
|
||
* (Linux input-event code/value pair) off the virtio-input interrupt-fed
|
||
* ring buffer. Kernel-only, riscv64/aarch64 (virtio-keyboard-pci); no-op
|
||
* on amd64 (i8042 hardware instead, see KBD-SCAN).
|
||
*
|
||
* @par VKBD-DEBUG ( -- isr_count )
|
||
* Standing diagnostic: count of virtio-input ISR invocations since boot.
|
||
* @}
|
||
*/
|
||
|
||
void register_keyboard_words(VM *vm);
|
||
|
||
#endif /* KEYBOARD_WORDS_H */
|