/* -----------------------------------------------------------------------------
 * mmio.h —— 扫雷程序的全部 MMIO 地址与编码定义（**只改这一个文件就能换地址**）
 *
 * 约定：本文件里的所有地址都是"数据空间"的字节地址，和 CPU 的 data_addr_o 一致。
 * 写用 *(volatile unsigned *)addr（sw 全字写）或 *(volatile unsigned char *)addr
 * （sb 字节写，显存必须用这个）。
 *
 * -----------------------------------------------------------------------------
 * 地址表（与 pipelined-cpu/srcs/rtl/cpu21_mmio.v 里的译码完全一致）：
 *
 *   0x0000_0000 - 0x0000_0FFF   数据 RAM（4 KB，栈 + 全局变量）
 *   0x0000_1000                 LED 数据寄存器（低 16 位点亮 LED）
 *   0x0000_1004                 七段数码管：8 位十六进制（低 4 位 = 最右）
 *   0x0000_1100 + 0x00  STATUS    [0] 事件FIFO非空 [5:1] 项数 [6] 中断使能 [7] 满
 *   0x0000_1100 + 0x04  DATA      [7:0] dx [15:8] dy [20:16] 按键（读无副作用）
 *   0x0000_1100 + 0x08  ACK       写任意值 -> 弹出一次事件
 *   0x0000_1100 + 0x0C  CTRL      [0] 鼠标中断使能
 *   0x0000_1100 + 0x10  INPUT     [15:0] 拨码开关 [20:16] 按键
 *   0x0000_1100 + 0x14  TIME      自由计数器（随机种子）
 *   0x0000_1100 + 0x18  FRAME     VGA 帧计数（闪烁用）
 *   0x0000_1100 + 0x1C  EVENTCNT  累计事件数
 *   0x0000_1100 + 0x20  LEVEL     写 1 -> 触发"关卡入口"软件中断（IRQ2）
 *   0x0000_1100 + 0x24  MAGIC     0xCAFE0002（自检：读得到说明 MMIO 活着）
 *   0x0000_1140 + 0x00  DISP_CTRL   [0] 光标可见 [6:4] 背景色
 *   0x0000_1140 + 0x04  DISP_CURSOR [5:0] 列 [13:8] 行
 *   0x0000_1140 + 0x08  DISP_MAGIC 0xCAFE0001
 *   0x0000_2000 - 0x0000_27FF   显存：40 列 x 30 行，每格 1 字节，共 1200 字节
 *
 * 鼠标事件单位：1/8 格（按键一次 = 8 = 移动一格；PS/2 鼠标用原始计数）。
 * 左键点击 -> 事件的 btn 位 0 置 1；右键（PS/2）-> 位 1。
 *
 * ⚠ 如果你的外设地址和上表不同：只改下面这几个宏，.c 文件不用动。
 * ⚠ 三个中断入口必须与 linker.ld 里 .text.isr1/2/3 的地址一致：
 *     IRQ1(0x100) = 关卡（游戏）入口，IRQ2(0x200) = 鼠标读取，IRQ3(0x300) = 备用。
 *   顶层 cpu21_board_top 的 IRQ1/2/3_VECTOR 参数也要跟着改（默认就是这个布局）。
 * ---------------------------------------------------------------------------*/
#ifndef SAOLEI_MMIO_H
#define SAOLEI_MMIO_H

/* ---- LED / 七段数码管 ---- */
#define LED_ADDR 0x00001000u
#define REG_SEG 0x00001004u

/* ---- 显存 ---- */
#define FB_BASE 0x00002000u /* 显存起始（字节地址） */
#define FB_PITCH 40u        /* 每行 40 格 */
#define FB_ROWS 30u         /* 30 行 */
#define GRID_COLS 40u
#define GRID_ROWS 30u

/* ---- 鼠标寄存器组 ---- */
#define REG_STATUS 0x00001100u
#define REG_MDATA 0x00001104u
#define REG_MACK 0x00001108u
#define REG_MCTRL 0x0000110Cu
#define REG_INPUT 0x00001110u
#define REG_TIME 0x00001114u
#define REG_FRAME 0x00001118u
#define REG_EVCNT 0x0000111Cu
#define REG_LEVEL 0x00001120u
#define REG_MMAGIC 0x00001124u

/* ---- 显示控制器寄存器 ---- */
#define REG_CTRL 0x00001140u
#define REG_CURSOR 0x00001144u
#define REG_DMAGIC 0x00001148u

/* ---- 访问宏 ---- */
#define REG_R(a) (*(volatile unsigned *)((unsigned)(a)))
#define REG_W(a) (*(volatile unsigned *)((unsigned)(a)))

/* 显存按字节写（只能 sb，不能 lb —— 这颗核没有 lb/lbu） */
static inline void fb_write(unsigned idx, unsigned val)
{
    *(volatile unsigned char *)(FB_BASE + idx) = (unsigned char)(val & 0xFFu);
}

/* ---- 格子编码：1 字节 = [3:0] 字形 [6:4] 颜色 [7] 保留 ---- */
#define G_BLANK 0u  /* 空 */
#define G_N1 1u     /* 数字 1..8 = 1..8 */
#define G_COVER 9u  /* 未揭开 */
#define G_FLAG 10u  /* 旗 */
#define G_MINE 11u  /* 雷 */
#define G_BOOM 12u  /* 爆炸 */
#define G_QUEST 13u /* 问号 */
#define G_BAR 14u   /* 横线 */
#define G_SOLID 15u /* 实心 */

#define C_BLACK 0u
#define C_BLUE 1u
#define C_GREEN 2u
#define C_CYAN 3u
#define C_RED 4u
#define C_MAGENTA 5u
#define C_YELLOW 6u
#define C_GRAY 7u

#define CELL(g, c) ((unsigned)((g) | ((c) << 4)))

/* ---- 软件事件环形队列：中断服务程序（isr.c）生产，主循环（saolei.c）消费 ---- */
#define EVQ_SIZE 64u
#define EVQ_MASK (EVQ_SIZE - 1u)
extern volatile unsigned g_evq[EVQ_SIZE];
extern volatile unsigned g_evq_head; /* 主循环消费 */
extern volatile unsigned g_evq_tail; /* 中断生产 */
extern volatile unsigned g_evq_lost; /* 队列满丢弃计数（调试用） */

#endif /* SAOLEI_MMIO_H */