NEMU如何实现串口输入？

[zzzhang2001]

NEMU standalone运行linux，根据inittab，所有命令完成之后应该进入ash，即交互式shell，但是没有找到输入命令的方式；

::sysinit:/bin/busybox mount -t proc proc /proc
::sysinit:/bin/busybox mount -t sysfs sysfs /sys
::sysinit:/bin/busybox mount -t tmpfs tmpfs /tmp
::sysinit:/bin/busybox mount -o remount,rw /dev/htifbd0 /
::sysinit:/bin/busybox --install -s
::sysinit:/bin/mkdir -p /dev/pts
::sysinit:/bin/echo /bin/mdev > /proc/sys/kernel/hotplug
::sysinit:/sbin/mdev -s
/dev/console::sysinit:-/bin/ash

默认配置的是uartlite，在config中开启CONFIG_UARTLITE_INPUT_FIFO=y，编译nemu会出错

CC src/device/uartlite.c
src/device/uartlite.c: In function ‘serial_rx_ready_flag’:
src/device/uartlite.c:83:24: error: ‘LSR_RX_READY’ undeclared (first use in this function)
83 | return (f == r ? 0 : LSR_RX_READY);
| ^~~~~~~~~~~~
src/device/uartlite.c:83:24: note: each undeclared identifier is reported only once for each function it appears in
src/device/uartlite.c: At top level:
src/device/uartlite.c:53:13: error: ‘serial_dequeue’ defined but not used [-Werror=unused-function]
53 | static char serial_dequeue() {
| ^~~~~~~~~~~~~~
cc1: all warnings being treated as errors

修掉之后通过nemu运行linux，确实会生成 /tmp/nemu-serial，但是echo命令没有任何反应

是否uartlite_input_fifo这一串口输入方式还受支持？如果不支持应该使用什么方式串口输入？

[cebarobot]

NEMU 的串口输入已经很久没有人用和维护了。今年的 OSPP 中我们给了一个题目，希望有同学能帮助我们维修改进 UART 的处理，但什么时候能完成还是未知数。

在我们一般的自动化测试流程中，通常不使用 UART 输入，而是直接让 busybox 根据预设的脚本（/etc/init.d/rcS）执行程序。建议尝试这种办法。

The UART input function of NEMU has not been used of maintained for a while. In this year's OSPP program, we have proposed a project of fixing and improving UART handling, but it is not still unknown when this will be completed.

In our usual automated testing program, we don't use UART input. Instead, we let busybox to run applications according to a preset script (/etc/init.d/rcS). Please try this.

[zzzhang2001]

好的，感谢，rcs我已经使用过了，希望测试交互式是因为想上fpga测试cpu；
我还有一个小问题，NEMU现在支持哪些串口方式？config里有serial，uartlite，uart_snps;
我尝试切换为UART_SNPS（这个应该是16550a？）但是执行linux没有输出，我在设备树里指定的是ns16550a

[cebarobot]

目前验证有效的串口方式只有 uartlite（我们现在一般用这个）。serial 对应的应该是 8250/16550，印象中不是很好使；uart snps 是 Xilinx fpga 上的一个，很久没人用过了。

[hardworkibgverney]

解决NEMU Shell交互问题 总结：

问题根源
NEMU原始实现中中断链路断开，导致键盘输入无法传递到Linux内核：

• UART设备只支持输出，无输入处理
• PLIC中断控制器为空实现
• CPU缺乏外部中断接口

修改文件对比分析

1. src/device/plic.c - 从空实现到完整PLIC控制器

原始代码（仅14行）：
`static void plic_io_handler(uint32_t offset, int len, bool is_write) {
// Fake plic handler, empty now
return;
}

void init_plic(const char *flash_img) {
printf("init_plic\n");
plic_base = new_space(PLIC_SIZE);
add_mmio_map("plic", CONFIG_PLIC_ADDRESS, plic_base, PLIC_SIZE, plic_io_handler);
}`
修改后（170+行）新增内容：

寄存器定义：PRIORITY、PENDING、ENABLE、THRESHOLD、CLAIM寄存器
状态管理：多个静态数组管理中断状态
核心功能：
plic_raise_irq() - 设备触发中断
plic_update_interrupts() - 更新CPU中断状态
完整的寄存器读写处理
Claim/Complete机制实现

关键新增内容：
`// 新增PLIC寄存器定义
#define PLIC_PRIORITY_BASE 0x000000
#define PLIC_PENDING_BASE 0x001000
#define PLIC_ENABLE_BASE 0x002000
#define PLIC_ENABLE_STRIDE 0x80
#define PLIC_THRESHOLD_BASE 0x200000
#define PLIC_CLAIM_BASE 0x200004
#define PLIC_CONTEXT_STRIDE 0x1000

// 新增PLIC配置
#define PLIC_MAX_IRQ 64
#define PLIC_MAX_CONTEXT 2

// 新增状态变量
static uint32_t plic_priority[PLIC_MAX_IRQ];
static uint32_t plic_pending = 0;
static uint32_t plic_enable[PLIC_MAX_CONTEXT];
static uint32_t plic_threshold[PLIC_MAX_CONTEXT];
static uint32_t plic_claim[PLIC_MAX_CONTEXT];

// 新增外部函数声明
extern void riscv64_set_seip(bool value);

// 新增中断更新函数
static void plic_update_interrupts() {
bool should_interrupt = false;

for (int context = 0; context < PLIC_MAX_CONTEXT; context++) {
uint32_t max_priority = 0;
uint32_t max_irq = 0;

// 查找最高优先级的待处理中断
for (int irq = 1; irq < PLIC_MAX_IRQ; irq++) {
  if ((plic_pending & (1U << irq)) && 
      (plic_enable[context] & (1U << irq)) &&
      (plic_priority[irq] > plic_threshold[context]) &&
      (plic_priority[irq] > max_priority)) {
    max_priority = plic_priority[irq];
    max_irq = irq;
  }
}

// S-mode上下文设置CPU中断
if (context == 1 && max_irq > 0) {
  should_interrupt = true;
}

}

riscv64_set_seip(should_interrupt);
}

// 新增中断触发函数
void plic_raise_irq(uint32_t irq) {
if (irq > 0 && irq < PLIC_MAX_IRQ) {
plic_pending |= (1U << irq);

if (plic_priority[irq] == 0) {
  plic_priority[irq] = 1;  // 默认优先级
}

plic_update_interrupts();

}
}`

2. src/device/uartlite.c - 从只读到双向交互

原始代码（39行）特点：

只处理TX_FIFO输出
只有简单的状态寄存器处理
无输入机制
修改后（280+行）新增内容：
输入缓冲系统
终端配置：配置主机终端为原始模式，支持实时输入
中断触发：enqueue_char()函数调用plic_raise_irq(12)
完整寄存器处理：RX_FIFO、TX_FIFO、STAT_REG、CTRL_REG
实时输入处理：process_host_input()函数
演示命令注入：自动执行ls、pwd等命令

新增关键内容
`// 新增头文件
#include <fcntl.h>
#include <sys/stat.h>
#include <sys/types.h>
#include <unistd.h>
#include <errno.h>
#include <termios.h>
#include <stdlib.h>

// 新增宏定义
#define UART_IRQ_NUM 12 // UART interrupt number in PLIC

// 新增输入缓冲系统
#define QUEUE_SIZE 1024
static char input_queue[QUEUE_SIZE] = {};
static int queue_front = 0, queue_rear = 0;
static bool rx_interrupt_enabled = true;

// 新增终端配置变量
static struct termios old_termios;
static bool terminal_configured = false;

// 新增外部函数声明
extern void plic_raise_irq(uint32_t irq);

// 新增队列操作函数
static bool queue_is_empty() {
return queue_front == queue_rear;
}

static bool queue_is_full() {
return ((queue_rear + 1) % QUEUE_SIZE) == queue_front;
}

static void enqueue_char(char ch) {
if (!queue_is_full()) {
input_queue[queue_rear] = ch;
queue_rear = (queue_rear + 1) % QUEUE_SIZE;

// 触发UART中断
if (rx_interrupt_enabled) {
  plic_raise_irq(UART_IRQ_NUM);
}

}
}

static char dequeue_char() {
if (!queue_is_empty()) {
char ch = input_queue[queue_front];
queue_front = (queue_front + 1) % QUEUE_SIZE;
return ch;
}
return 0;
}

// 新增终端配置函数
static void configure_terminal() {
if (!terminal_configured && isatty(STDIN_FILENO)) {
tcgetattr(STDIN_FILENO, &old_termios);

struct termios new_termios = old_termios;
new_termios.c_lflag &= ~(ICANON | ECHO);  // 禁用规范模式和回显
new_termios.c_cc[VMIN] = 0;   // 非阻塞读取
new_termios.c_cc[VTIME] = 0;  // 无超时

tcsetattr(STDIN_FILENO, TCSANOW, &new_termios);

// 设置stdin为非阻塞
int flags = fcntl(STDIN_FILENO, F_GETFL, 0);
fcntl(STDIN_FILENO, F_SETFL, flags | O_NONBLOCK);

terminal_configured = true;

}
}

// 新增主机输入处理函数
static void process_host_input() {
char ch;
while (read(STDIN_FILENO, &ch, 1) == 1) {
if (ch == 3) { // Ctrl+C
restore_terminal();
exit(0);
}
if (ch == 127) { // Backspace
ch = 8;
}
enqueue_char(ch);
}
}`

3. include/isa.h - 新增CPU接口声明

新增内容：
void riscv64_set_seip(bool value);

4. src/device/device.c - 新增PLIC接口声明

新增内容：
void plic_raise_irq(uint32_t irq);

5. src/isa/riscv64/system/priv.c - 新增CPU中断接口

新增函数：
void riscv64_set_seip(bool value) { if (value) { cpu.non_reg_interrupt_pending.platform_irp_seip = 1; } else { cpu.non_reg_interrupt_pending.platform_irp_seip = 0; } }
中断链路实现
完整流程：

关键技术点
UART中断号12：与设备树配置一致
PLIC上下文管理：支持M-mode和S-mode
非阻塞输入：配置终端ICANON和ECHO标志
状态同步：RX_VALID位实时反映输入队列状态
优雅退出：Ctrl+C处理和终端设置恢复
结果验证
修复后功能：

✅ 系统正常启动到shell
✅ 键盘输入实时响应
✅ 命令执行正常（ls、pwd、mkdir等）
✅ 自动演示命令工作正常
总代码变化：从原始的约100行增加到600+行，实现了完整的UART-PLIC-CPU中断链路。

[cyyself]

默认配置的是uartlite，在config中开启CONFIG_UARTLITE_INPUT_FIFO=y，编译nemu会出错

已在 #963 中解决。现在已经可以通过 echo "your_command" > /tmp/nemu-serial 这样的操作来完成输入。