60 lines
2.7 KiB
C
60 lines
2.7 KiB
C
/* host_main.h — Deshab 桌面 Linux 宿主接口
|
||
*
|
||
* 仅在 -DDESHAB_HOST 编译时使用。提供 SDL2 窗口（模拟 framebuffer）、
|
||
* 鼠标/键盘事件（模拟 PS/2）、deshab.img 文件 block 后端、单调时钟
|
||
* （替代 rDTSC）与当天秒数（替代 RTC CMOS）。
|
||
*
|
||
* desktop/main.c 通过 #ifdef DESHAB_HOST 调用本接口；裸机构建不包含本头。
|
||
*/
|
||
#ifndef DESHAB_HOST_MAIN_H
|
||
#define DESHAB_HOST_MAIN_H
|
||
|
||
#include <utsm/types.h>
|
||
|
||
/* dsk_entry 由 desktop/main.c 提供，host_main.c 构造好 ctx 后调用。 */
|
||
struct dsk_boot_context;
|
||
void dsk_entry(const struct dsk_boot_context *ctx);
|
||
|
||
/* ---- 日志（替代 COM1 串口 sputc/swrite/slog） ---- */
|
||
void host_log(const char *s); /* 输出字符串到 stderr */
|
||
void host_log_char(char c); /* 输出单字符到 stderr */
|
||
|
||
/* ---- 时间 ---- */
|
||
/* 单调时钟微秒，替代 rdtsc。供 tsc_calibrate/g_last_click_tsc 使用。
|
||
* g_tsc_per_sec 应设为 1000000。 */
|
||
u64 host_now_us(void);
|
||
/* 当天秒数（0..86399），替代 rtc_day_sec。 */
|
||
int host_rtc_seconds(void);
|
||
|
||
/* ---- 鼠标（替代 ps2_mouse_poll） ----
|
||
* 从 SDL 事件累积的鼠标状态生成一次快照。
|
||
* px/py : 输出当前绝对坐标（已钳位到 [0,max]）
|
||
* pbtn : 输出按键位（bit0=左 bit1=右）
|
||
* p_left_pressed / p_left_released / p_right_pressed : 边沿事件（1 表示本次发生）
|
||
* max_x/max_y : 坐标上界（g_fb_w - CURSOR_SIZE 等）
|
||
* 返回 1 表示有移动或按键变化，0 表示无事件。 */
|
||
int host_mouse_poll(int *px, int *py, int *pbtn,
|
||
int *p_left_pressed, int *p_left_released,
|
||
int *p_right_pressed, int max_x, int max_y);
|
||
|
||
/* ---- 键盘（替代 inb(0x64)/inb(0x60) 扫描码轮询） ----
|
||
* 取一个 PS/2 set-1 扫描码（make 码；break 码为 |0x80）。
|
||
* 返回 1 表示取到，0 表示队列空。 */
|
||
int host_kb_poll(u8 *out_sc);
|
||
|
||
/* ---- 帧末：pump SDL 事件 + present back buffer ----
|
||
* 在主循环末尾调用（替代 __asm__("pause"))。
|
||
* 1. 把 back buffer（g_host_backbuf）上传到 SDL texture 并 RenderPresent
|
||
* 2. SDL_PollEvent 排空：鼠标/键盘事件入内部状态，SDL_QUIT 返回非 0
|
||
* 返回非 0 表示收到退出请求（窗口关闭），调用方应置 g_quit。 */
|
||
int host_pump_and_present(void);
|
||
|
||
/* ---- host 分配的缓冲（替代裸机硬编码物理地址） ----
|
||
* g_host_sprite : sprite 渲染缓冲（替代 SPRITE_BUF_ADDR 0x7000000）
|
||
* g_host_backbuf: 真实 framebuffer 对应的 back buffer（替代 g_real_fb 指向的显存）
|
||
* 大小均为 width*height*4 字节，由 host_main.c 在初始化时分配。 */
|
||
extern u8 *g_host_sprite;
|
||
extern u8 *g_host_backbuf;
|
||
|
||
#endif /* DESHAB_HOST_MAIN_H */
|