fcdev 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +201 -0
- package/README.md +81 -2
- package/bin/fcdev.mjs +17 -0
- package/package.json +38 -4
- package/src/build/build-plan.mjs +92 -0
- package/src/build/dependency-file.mjs +24 -0
- package/src/build/disk-builder.mjs +36 -0
- package/src/build/index.mjs +31 -0
- package/src/build/program-builder.mjs +209 -0
- package/src/build/source-collector.mjs +54 -0
- package/src/build/tool-arguments.mjs +83 -0
- package/src/cli/args-parser.mjs +84 -0
- package/src/cli/commands/build-command.mjs +34 -0
- package/src/cli/commands/debug-command.mjs +70 -0
- package/src/cli/commands/disasm-command.mjs +65 -0
- package/src/cli/commands/disk-command.mjs +34 -0
- package/src/cli/commands/info-command.mjs +33 -0
- package/src/cli/commands/project-info.mjs +57 -0
- package/src/cli/commands/run-command.mjs +68 -0
- package/src/cli/commands/sync-command.mjs +85 -0
- package/src/cli/index.mjs +100 -0
- package/src/config/config-loader.mjs +132 -0
- package/src/config/index.mjs +9 -0
- package/src/disasm/analysis.mjs +97 -0
- package/src/disasm/cdl.mjs +35 -0
- package/src/disasm/disassembler.mjs +114 -0
- package/src/disasm/index.mjs +16 -0
- package/src/disasm/info-writer.mjs +72 -0
- package/src/disasm/loaders.mjs +69 -0
- package/src/disasm/opcode-table.mjs +268 -0
- package/src/disasm/roundtrip.mjs +69 -0
- package/src/disasm/symbols.mjs +30 -0
- package/src/disasm/trace.mjs +25 -0
- package/src/emulator/debug-client.mjs +125 -0
- package/src/emulator/emulator-launcher.mjs +80 -0
- package/src/emulator/emulator-locator.mjs +62 -0
- package/src/emulator/index.mjs +11 -0
- package/src/packagers/fat-floppy.mjs +22 -0
- package/src/packagers/fat12-image.mjs +245 -0
- package/src/packagers/flat-binary.mjs +53 -0
- package/src/packagers/index.mjs +54 -0
- package/src/packagers/ines.mjs +38 -0
- package/src/shared/errors.mjs +25 -0
- package/src/shared/fs-utils.mjs +66 -0
- package/src/shared/index.mjs +11 -0
- package/src/shared/process.mjs +50 -0
- package/src/targets/index.mjs +17 -0
- package/src/targets/name-rules.mjs +33 -0
- package/src/targets/target-registry.mjs +187 -0
- package/src/toolchain/index.mjs +16 -0
- package/src/toolchain/toolchain-locator.mjs +104 -0
- package/targets/nes/asminc/fcnes.inc +16 -0
- package/targets/nes/chr/ascii-8x8.chr +0 -0
- package/targets/nes/chr/font8x8_basic.h +152 -0
- package/targets/nes/include/fcnes.h +45 -0
- package/targets/nes/lib/fcnes.lib +0 -0
- package/targets/nes/lib/nes-font.o +0 -0
- package/targets/nes/lib-build.json +9 -0
- package/targets/nes/src/fcnes.s +91 -0
- package/targets/nes/src/nes-font.s +12 -0
- package/targets/nes/target.json +27 -0
- package/targets/sb2000/asminc/sb2000.inc +216 -0
- package/targets/sb2000/include/sb2000-symbols.h +380 -0
- package/targets/sb2000/include/sb2000.h +52 -0
- package/targets/sb2000/lib/crt0.o +0 -0
- package/targets/sb2000/lib/sb2000.lib +0 -0
- package/targets/sb2000/lib-build.json +8 -0
- package/targets/sb2000/link.cfg +35 -0
- package/targets/sb2000/src/crt0.s +37 -0
- package/targets/sb2000/src/sb2000.s +67 -0
- package/targets/sb2000/target.json +28 -0
|
@@ -0,0 +1,380 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* ------------------------------------------------------------------------
|
|
3
|
+
* 名称:sb2000-symbols.h
|
|
4
|
+
* 说明:SB-DOS 程序接口的符号常量:系统调用变量地址、功能号、子功能号、出错码、文件打开方式、运行库入口。
|
|
5
|
+
* 作者:sungbin
|
|
6
|
+
* 邮箱:sungbin@3578.cn
|
|
7
|
+
* 日期:2026-11-10
|
|
8
|
+
* 备注:由 tools/gen-sb2000-header.mjs 从 asminc/sb2000.inc 生成,不要手工修改(DO NOT EDIT);注释里的符号名省略 SB_ 前缀。
|
|
9
|
+
* ------------------------------------------------------------------------
|
|
10
|
+
*/
|
|
11
|
+
#ifndef SB2000_SYMBOLS_H
|
|
12
|
+
#define SB2000_SYMBOLS_H
|
|
13
|
+
|
|
14
|
+
/* 系统调用:JSR SYSCALL,功能号写 SYS_FUNCTION */
|
|
15
|
+
/** 系统调用入口,JSR 到这里 */
|
|
16
|
+
#define SB_SYSCALL 0xFFF0
|
|
17
|
+
/** 功能号,调用前写入 */
|
|
18
|
+
#define SB_SYS_FUNCTION 0x063E
|
|
19
|
+
/** 子功能号,有子功能的服务才用 */
|
|
20
|
+
#define SB_SYS_SUBFUNCTION 0x063F
|
|
21
|
+
/** 状态,调用开头清 0,子功能越界时为 $FF */
|
|
22
|
+
#define SB_SYS_STATUS 0x0640
|
|
23
|
+
/** 页号:功能 $29 要映射的页,或远指针的页 */
|
|
24
|
+
#define SB_SYS_PAGE 0x0641
|
|
25
|
+
/** 页组的首页号,连续 4 页 */
|
|
26
|
+
#define SB_SYS_GROUP 0x0642
|
|
27
|
+
/** 窗口号 0-3,功能 $29 用 */
|
|
28
|
+
#define SB_SYS_WINDOW 0x0653
|
|
29
|
+
|
|
30
|
+
/* 零页:系统调用与运行库使用的单元 */
|
|
31
|
+
/** 调用地址低字节,功能 $25、$26 用 */
|
|
32
|
+
#define SB_PROG_ENTRY_LO 0x0C
|
|
33
|
+
/** 调用地址高字节 */
|
|
34
|
+
#define SB_PROG_ENTRY_HI 0x0D
|
|
35
|
+
/** 远指针的页内偏移低字节 */
|
|
36
|
+
#define SB_FAR_OFFSET_LO 0x14
|
|
37
|
+
/** 远指针的页内偏移高字节 */
|
|
38
|
+
#define SB_FAR_OFFSET_HI 0x15
|
|
39
|
+
/** 字符串地址低字节,LIB_PRINT_STRING 用 */
|
|
40
|
+
#define SB_STR_PTR_LO 0x4B
|
|
41
|
+
/** 字符串地址高字节 */
|
|
42
|
+
#define SB_STR_PTR_HI 0x4C
|
|
43
|
+
|
|
44
|
+
/* 不经 SYSCALL、直接 JSR 的内核入口 */
|
|
45
|
+
/** 把页组窗口地址处的数据复制到 $0700 缓冲 */
|
|
46
|
+
#define SB_FAR_COPY_IN 0xFFEA
|
|
47
|
+
/** 把 $0700 缓冲的数据复制到页组窗口地址 */
|
|
48
|
+
#define SB_FAR_COPY_OUT 0xFFED
|
|
49
|
+
/** 读远指针加 Y 处的一个字节,结果在 A */
|
|
50
|
+
#define SB_FAR_READ_BYTE 0xFFF3
|
|
51
|
+
/** 把 A 写到远指针加 Y 处 */
|
|
52
|
+
#define SB_FAR_WRITE_BYTE 0xFFF6
|
|
53
|
+
|
|
54
|
+
/* 功能号(写入 SYS_FUNCTION) */
|
|
55
|
+
/** 画面控制:开关 NMI 及其中的各项服务 */
|
|
56
|
+
#define SB_FN_PPU_CONTROL 0x12
|
|
57
|
+
/** 中断屏蔽:允许或屏蔽各中断源 */
|
|
58
|
+
#define SB_FN_IRQ_MASK 0x13
|
|
59
|
+
/** 鼠标复位,是否接入放在 $0633 */
|
|
60
|
+
#define SB_FN_MOUSE_RESET 0x14
|
|
61
|
+
/** 等待 X 个垂直消隐周期(帧) */
|
|
62
|
+
#define SB_FN_WAIT_FRAMES 0x1B
|
|
63
|
+
/** 保存上下文,类似 setjmp */
|
|
64
|
+
#define SB_FN_SAVE_CONTEXT 0x1C
|
|
65
|
+
/** 恢复上下文并跳转,不返回,类似 longjmp */
|
|
66
|
+
#define SB_FN_RESTORE_CONTEXT 0x1D
|
|
67
|
+
/** 按远指针读一个字节到 $0653,指针后移 */
|
|
68
|
+
#define SB_FN_FAR_READ_NEXT 0x24
|
|
69
|
+
/** 映射页组并调用 PROG_ENTRY 处的例程 */
|
|
70
|
+
#define SB_FN_CALL_BANKED 0x25
|
|
71
|
+
/** 同上,但直接跳转,不再返回 */
|
|
72
|
+
#define SB_FN_JUMP_BANKED 0x26
|
|
73
|
+
/** 把页 SYS_PAGE 映射到窗口 SYS_WINDOW */
|
|
74
|
+
#define SB_FN_MAP_WINDOW 0x29
|
|
75
|
+
/** 把窗口地址换算成远指针 */
|
|
76
|
+
#define SB_FN_ADDR_TO_FAR 0x2C
|
|
77
|
+
/** 声音服务 */
|
|
78
|
+
#define SB_FN_SOUND 0x65
|
|
79
|
+
/** 键盘输入服务 */
|
|
80
|
+
#define SB_FN_INPUT 0x6B
|
|
81
|
+
/** 鼠标服务 */
|
|
82
|
+
#define SB_FN_MOUSE 0x6C
|
|
83
|
+
/** 手柄服务 */
|
|
84
|
+
#define SB_FN_GAMEPAD 0x6A
|
|
85
|
+
/** 文件服务:打开、关闭、设置当前目录 */
|
|
86
|
+
#define SB_FN_FILE 0x7B
|
|
87
|
+
/** 句柄服务:读写、大小、日期、属性 */
|
|
88
|
+
#define SB_FN_FILE_HANDLE 0x7C
|
|
89
|
+
/** 目录服务:创建、删除、整理名称 */
|
|
90
|
+
#define SB_FN_DIR 0x7D
|
|
91
|
+
/** 内存页服务:分配、释放 */
|
|
92
|
+
#define SB_FN_PAGE 0x7E
|
|
93
|
+
/** 日期、时间与运行程序 */
|
|
94
|
+
#define SB_FN_CLOCK 0x7F
|
|
95
|
+
/** 磁盘服务:读写扇区、软驱停转 */
|
|
96
|
+
#define SB_FN_DISK 0x80
|
|
97
|
+
|
|
98
|
+
/* 子功能号(写入 SYS_SUBFUNCTION) */
|
|
99
|
+
|
|
100
|
+
/* 子功能:键盘输入(FN_INPUT) */
|
|
101
|
+
/** 复位键盘与鼠标,清空按键队列 */
|
|
102
|
+
#define SB_SUB_KEY_INIT 0x00
|
|
103
|
+
/** 之后按 ESC 会中断程序 */
|
|
104
|
+
#define SB_SUB_KEY_ESC_ON 0x01
|
|
105
|
+
/** 按 ESC 不再中断程序 */
|
|
106
|
+
#define SB_SUB_KEY_ESC_OFF 0x02
|
|
107
|
+
/** 取一个按键,没有按键时结果为 0 */
|
|
108
|
+
#define SB_SUB_KEY_GET_NOWAIT 0x03
|
|
109
|
+
/** 等到有按键再取 */
|
|
110
|
+
#define SB_SUB_KEY_GET_WAIT 0x04
|
|
111
|
+
/** 清空按键队列 */
|
|
112
|
+
#define SB_SUB_KEY_FLUSH 0x05
|
|
113
|
+
/** 队列里的按键数,放在 KEY_ASCII */
|
|
114
|
+
#define SB_SUB_KEY_COUNT 0x06
|
|
115
|
+
|
|
116
|
+
/* 子功能:画面与中断控制(FN_PPU_CONTROL、FN_IRQ_MASK) */
|
|
117
|
+
/** FN_PPU_CONTROL:打开 NMI 中读手柄 */
|
|
118
|
+
#define SB_SUB_NMI_PAD_ON 0x85
|
|
119
|
+
/** FN_PPU_CONTROL:关闭 NMI 中读手柄 */
|
|
120
|
+
#define SB_SUB_NMI_PAD_OFF 0x05
|
|
121
|
+
/** FN_IRQ_MASK:允许鼠标中断 */
|
|
122
|
+
#define SB_SUB_IRQ_MOUSE_ON 0x81
|
|
123
|
+
|
|
124
|
+
/* 子功能:手柄(FN_GAMEPAD) */
|
|
125
|
+
/** 初始化手柄状态 */
|
|
126
|
+
#define SB_SUB_PAD_INIT 0x00
|
|
127
|
+
/** 取按键码,不等待,没有键时为 $FF */
|
|
128
|
+
#define SB_SUB_PAD_GET 0x01
|
|
129
|
+
/** 等到有按键再返回 */
|
|
130
|
+
#define SB_SUB_PAD_WAIT 0x02
|
|
131
|
+
|
|
132
|
+
/* 子功能:鼠标(FN_MOUSE) */
|
|
133
|
+
/** 设置坐标范围,上下限在 $0646-$0649 */
|
|
134
|
+
#define SB_SUB_MOUSE_SET_LIMITS 0x00
|
|
135
|
+
/** 取坐标:X 在 $0646,Y 在 $0647 */
|
|
136
|
+
#define SB_SUB_MOUSE_GET_POS 0x02
|
|
137
|
+
/** 整理按键状态到 MOUSE_BTN_BASE 起 */
|
|
138
|
+
#define SB_SUB_MOUSE_GET_BUTTONS 0x03
|
|
139
|
+
/** 设置坐标:X 取自 $0652,Y 取自 $0653 */
|
|
140
|
+
#define SB_SUB_MOUSE_SET_POS 0x04
|
|
141
|
+
|
|
142
|
+
/* 子功能:文件服务(FN_FILE) */
|
|
143
|
+
/** 按 FILE_MODE 打开 PATH_BUFFER 里的路径 */
|
|
144
|
+
#define SB_SUB_FS_OPEN 0x09
|
|
145
|
+
/** 关闭 FILE_HANDLE_OFFSET 指定的句柄 */
|
|
146
|
+
#define SB_SUB_FS_CLOSE 0x0A
|
|
147
|
+
/** 设置当前目录,相当于 CD */
|
|
148
|
+
#define SB_SUB_FS_FIND_ENTRY 0x0B
|
|
149
|
+
/** 把 4 个句柄全部置为空闲 */
|
|
150
|
+
#define SB_SUB_FS_RESET 0x13
|
|
151
|
+
|
|
152
|
+
/* 子功能:句柄服务(FN_FILE_HANDLE) */
|
|
153
|
+
/** 关闭句柄,并让软驱停转 */
|
|
154
|
+
#define SB_SUB_FH_CLOSE_FLUSH 0x02
|
|
155
|
+
/** 按偏移与长度读到扩展 RAM 页 */
|
|
156
|
+
#define SB_SUB_FH_READ_AT 0x05
|
|
157
|
+
/** 按偏移与长度从扩展 RAM 页写入 */
|
|
158
|
+
#define SB_SUB_FH_WRITE_AT 0x06
|
|
159
|
+
/** 取文件大小到 FILE_SIZE */
|
|
160
|
+
#define SB_SUB_FH_GET_SIZE 0x0D
|
|
161
|
+
/** 把整个文件读入扩展 RAM 页 */
|
|
162
|
+
#define SB_SUB_FH_READ_FILE 0x0F
|
|
163
|
+
/** 把扩展 RAM 页的内容整个写入文件 */
|
|
164
|
+
#define SB_SUB_FH_WRITE_FILE 0x10
|
|
165
|
+
|
|
166
|
+
/* 子功能:目录服务(FN_DIR) */
|
|
167
|
+
/** 把当前目录名整理成 \NAME.EXT 放入 PATH_BUFFER */
|
|
168
|
+
#define SB_SUB_DIR_FORMAT_NAME 0x01
|
|
169
|
+
/** 创建目录 */
|
|
170
|
+
#define SB_SUB_DIR_MAKE 0x02
|
|
171
|
+
/** 删除目录,目录必须为空 */
|
|
172
|
+
#define SB_SUB_DIR_DELETE 0x03
|
|
173
|
+
|
|
174
|
+
/* 子功能:内存页服务(FN_PAGE) */
|
|
175
|
+
/** 按 ALLOC_COUNT 分配连续页,起始页号在 ALLOC_START */
|
|
176
|
+
#define SB_SUB_PAGE_ALLOC 0x00
|
|
177
|
+
/** 释放 ALLOC_START 起的 ALLOC_COUNT 个页 */
|
|
178
|
+
#define SB_SUB_PAGE_FREE 0x01
|
|
179
|
+
/** 求最长连续空闲页数,放在 ALLOC_COUNT */
|
|
180
|
+
#define SB_SUB_PAGE_LARGEST 0x02
|
|
181
|
+
|
|
182
|
+
/* 子功能:日期、时间与运行程序(FN_CLOCK) */
|
|
183
|
+
/** 运行 PATH_BUFFER 里的程序 */
|
|
184
|
+
#define SB_SUB_CLOCK_EXEC 0x00
|
|
185
|
+
/** 用 FILE_DATE 设置系统日期 */
|
|
186
|
+
#define SB_SUB_CLOCK_SET_DATE 0x01
|
|
187
|
+
/** 取系统日期到 FILE_DATE */
|
|
188
|
+
#define SB_SUB_CLOCK_GET_DATE 0x02
|
|
189
|
+
/** 用 FILE_TIME 设置系统时间 */
|
|
190
|
+
#define SB_SUB_CLOCK_SET_TIME 0x03
|
|
191
|
+
/** 取系统时间到 FILE_TIME */
|
|
192
|
+
#define SB_SUB_CLOCK_GET_TIME 0x04
|
|
193
|
+
|
|
194
|
+
/* 子功能:磁盘服务(FN_DISK) */
|
|
195
|
+
/** 按 DISK_ 参数连续读扇区 */
|
|
196
|
+
#define SB_SUB_DISK_READ 0x04
|
|
197
|
+
/** 按 DISK_ 参数连续写扇区 */
|
|
198
|
+
#define SB_SUB_DISK_WRITE 0x05
|
|
199
|
+
/** 软驱停转,每次文件操作之后都要调用 */
|
|
200
|
+
#define SB_SUB_DISK_STOP 0x07
|
|
201
|
+
|
|
202
|
+
/* 子功能:声音服务(FN_SOUND) */
|
|
203
|
+
/** 播放内存里的 WAV,播完才返回 */
|
|
204
|
+
#define SB_SUB_SOUND_PLAY_WAV 0x0C
|
|
205
|
+
|
|
206
|
+
/* 变量:出错码、命令行与显示(扩展 RAM) */
|
|
207
|
+
/** 出错码,0 为成功,每次调用开头清 0 */
|
|
208
|
+
#define SB_DOS_ERROR 0x6300
|
|
209
|
+
/** 运行库显示字符串所在的页组,高 6 位有效 */
|
|
210
|
+
#define SB_LIB_GROUP 0x6308
|
|
211
|
+
/** 光标列,从 1 起,每行 32 列 */
|
|
212
|
+
#define SB_CURSOR_COL 0x630C
|
|
213
|
+
/** 光标所在的显示行 */
|
|
214
|
+
#define SB_CURSOR_ROW 0x630D
|
|
215
|
+
/** 字形缓冲行,由运行库维护,程序不要改 */
|
|
216
|
+
#define SB_GLYPH_ROW 0x630E
|
|
217
|
+
/** 命令行参数的起点,大写、0 结尾,首字节是空格 */
|
|
218
|
+
#define SB_CMD_TAIL 0x6364
|
|
219
|
+
/** 字号 */
|
|
220
|
+
#define SB_FONT_SIZE 0x6428
|
|
221
|
+
|
|
222
|
+
/* 变量:文件与目录(扩展 RAM) */
|
|
223
|
+
/** 当前目录的 11 字节名称,不要随便改写 */
|
|
224
|
+
#define SB_DIR_NAME83 0x651D
|
|
225
|
+
/** 路径,0 结尾的 ASCII,可带 A: 与 \ */
|
|
226
|
+
#define SB_PATH_BUFFER 0x6543
|
|
227
|
+
/** 打开方式,0-5 */
|
|
228
|
+
#define SB_FILE_MODE 0x6560
|
|
229
|
+
/** 当前句柄在句柄表里的偏移 */
|
|
230
|
+
#define SB_FILE_HANDLE_OFFSET 0x6561
|
|
231
|
+
/** 文件内偏移,3 字节,低字节在前 */
|
|
232
|
+
#define SB_FILE_OFFSET_0 0x6565
|
|
233
|
+
/** 文件内偏移第 2 字节 */
|
|
234
|
+
#define SB_FILE_OFFSET_1 0x6566
|
|
235
|
+
/** 文件内偏移第 3 字节 */
|
|
236
|
+
#define SB_FILE_OFFSET_2 0x6567
|
|
237
|
+
/** 文件大小或读写长度,3 字节,低字节在前 */
|
|
238
|
+
#define SB_FILE_SIZE_0 0x6568
|
|
239
|
+
/** 文件大小或读写长度第 2 字节 */
|
|
240
|
+
#define SB_FILE_SIZE_1 0x6569
|
|
241
|
+
/** 文件大小或读写长度第 3 字节 */
|
|
242
|
+
#define SB_FILE_SIZE_2 0x656A
|
|
243
|
+
/** 读写整个文件或一段数据时的扩展 RAM 起始页号 */
|
|
244
|
+
#define SB_FILE_START_PAGE 0x656B
|
|
245
|
+
/** 日期低字节,FAT 格式:年(自 1980)、月、日 */
|
|
246
|
+
#define SB_FILE_DATE_LO 0x656E
|
|
247
|
+
/** 日期高字节 */
|
|
248
|
+
#define SB_FILE_DATE_HI 0x656F
|
|
249
|
+
/** 时间低字节,FAT 格式:时、分、秒的一半 */
|
|
250
|
+
#define SB_FILE_TIME_LO 0x6570
|
|
251
|
+
/** 时间高字节 */
|
|
252
|
+
#define SB_FILE_TIME_HI 0x6571
|
|
253
|
+
/** 属性:位 0 只读,位 3 卷标,位 4 目录,位 5 存档 */
|
|
254
|
+
#define SB_FILE_ATTR 0x6572
|
|
255
|
+
|
|
256
|
+
/* 变量:内存页分配(扩展 RAM) */
|
|
257
|
+
/** 要分配或释放的页数 */
|
|
258
|
+
#define SB_ALLOC_COUNT 0x65A6
|
|
259
|
+
/** 分配得到的起始页号,或要释放的起始页号 */
|
|
260
|
+
#define SB_ALLOC_START 0x65A7
|
|
261
|
+
|
|
262
|
+
/* 变量:磁盘参数(扩展 RAM) */
|
|
263
|
+
/** 面,0 或 1 */
|
|
264
|
+
#define SB_DISK_HEAD 0x6200
|
|
265
|
+
/** 起始扇区,1-18 */
|
|
266
|
+
#define SB_DISK_SECTOR 0x6201
|
|
267
|
+
/** 磁道,0-79 */
|
|
268
|
+
#define SB_DISK_TRACK 0x6202
|
|
269
|
+
/** 缓冲所在的扩展 RAM 页号 */
|
|
270
|
+
#define SB_DISK_PAGE 0x6203
|
|
271
|
+
/** 缓冲从页内第几个 512 字节起,0-7 */
|
|
272
|
+
#define SB_DISK_PAGE_SECTOR 0x6204
|
|
273
|
+
/** 扇区数低字节 */
|
|
274
|
+
#define SB_DISK_COUNT_LO 0x6205
|
|
275
|
+
/** 扇区数高字节 */
|
|
276
|
+
#define SB_DISK_COUNT_HI 0x6206
|
|
277
|
+
/** 方式:$80 出错时立即返回 */
|
|
278
|
+
#define SB_DISK_MODE 0x6207
|
|
279
|
+
/** 结果状态,0 为成功 */
|
|
280
|
+
#define SB_DISK_STATUS 0x6208
|
|
281
|
+
|
|
282
|
+
/* 变量:键盘、手柄、鼠标(内核 RAM) */
|
|
283
|
+
/** 取到的按键的 ASCII 码,没有字符的键为 0 */
|
|
284
|
+
#define SB_KEY_ASCII 0x034B
|
|
285
|
+
/** 取到的按键的扫描码 */
|
|
286
|
+
#define SB_KEY_SCAN 0x034C
|
|
287
|
+
/** 手柄按键码,$FF 为没有键 */
|
|
288
|
+
#define SB_PAD_KEY 0x034D
|
|
289
|
+
/** 1 号手柄的原始状态,位 7 是 A,位 0 是右 */
|
|
290
|
+
#define SB_PAD1_BITS 0x034E
|
|
291
|
+
/** 2 号手柄的原始状态 */
|
|
292
|
+
#define SB_PAD2_BITS 0x034F
|
|
293
|
+
/** 鼠标光标的 X 坐标 */
|
|
294
|
+
#define SB_MOUSE_X 0x0354
|
|
295
|
+
/** 鼠标光标的 Y 坐标 */
|
|
296
|
+
#define SB_MOUSE_Y 0x0355
|
|
297
|
+
/** 鼠标按键状态的起点,共 8 个字节 */
|
|
298
|
+
#define SB_MOUSE_BTN_BASE 0x0360
|
|
299
|
+
/** 鼠标是否接入,0 为没有 */
|
|
300
|
+
#define SB_MOUSE_PRESENT 0x0633
|
|
301
|
+
|
|
302
|
+
/* 变量:系统调用的参数单元,含义随服务而定(内核 RAM) */
|
|
303
|
+
/** 鼠标 X 下限,或显存地址高字节 */
|
|
304
|
+
#define SB_PARAM_0646 0x0646
|
|
305
|
+
/** 鼠标 Y 下限,或显存地址低字节 */
|
|
306
|
+
#define SB_PARAM_0647 0x0647
|
|
307
|
+
/** 鼠标 X 上限,或屏幕缓冲的列 */
|
|
308
|
+
#define SB_PARAM_0648 0x0648
|
|
309
|
+
/** 鼠标 Y 上限,或屏幕缓冲的行 */
|
|
310
|
+
#define SB_PARAM_0649 0x0649
|
|
311
|
+
/** 通用参数,多数服务从这里取输入 */
|
|
312
|
+
#define SB_PARAM_0652 0x0652
|
|
313
|
+
/** 通用参数或返回值,如读到的字节 */
|
|
314
|
+
#define SB_PARAM_0653 0x0653
|
|
315
|
+
|
|
316
|
+
/* 文件打开方式(FILE_MODE) */
|
|
317
|
+
/** 打开已有文件 */
|
|
318
|
+
#define SB_MODE_OPEN 0x00
|
|
319
|
+
/** 创建文件,已存在则覆盖 */
|
|
320
|
+
#define SB_MODE_CREATE 0x01
|
|
321
|
+
/** 打开已有文件,可按偏移写,关闭时写回目录项 */
|
|
322
|
+
#define SB_MODE_UPDATE 0x02
|
|
323
|
+
/** 删除文件:标为已删除并释放簇链 */
|
|
324
|
+
#define SB_MODE_DELETE_ENTRY 0x03
|
|
325
|
+
/** 取得目录项,只对根目录与子目录成功 */
|
|
326
|
+
#define SB_MODE_ENTRY 0x04
|
|
327
|
+
/** 创建目录项 */
|
|
328
|
+
#define SB_MODE_MAKE_DIR 0x05
|
|
329
|
+
|
|
330
|
+
/* 出错码(DOS_ERROR) */
|
|
331
|
+
/** 无错 */
|
|
332
|
+
#define SB_ERR_NONE 0x00
|
|
333
|
+
/** 无效的功能调用号 */
|
|
334
|
+
#define SB_ERR_BAD_FUNCTION 0x01
|
|
335
|
+
/** 文件未找到 */
|
|
336
|
+
#define SB_ERR_FILE_NOT_FOUND 0x02
|
|
337
|
+
/** 路径未找到 */
|
|
338
|
+
#define SB_ERR_PATH_NOT_FOUND 0x03
|
|
339
|
+
/** 打开的文件过多,4 个句柄都在用 */
|
|
340
|
+
#define SB_ERR_TOO_MANY_FILES 0x04
|
|
341
|
+
/** 访问被拒绝,如写只读文件 */
|
|
342
|
+
#define SB_ERR_ACCESS_DENIED 0x05
|
|
343
|
+
/** 无足够内存,没有足够的连续空闲页 */
|
|
344
|
+
#define SB_ERR_NO_MEMORY 0x08
|
|
345
|
+
/** 无效的内存地址,页号不合法 */
|
|
346
|
+
#define SB_ERR_BAD_ADDRESS 0x09
|
|
347
|
+
/** 驱动器未准备好 */
|
|
348
|
+
#define SB_ERR_NOT_READY 0x15
|
|
349
|
+
/** 文件已经存在 */
|
|
350
|
+
#define SB_ERR_FILE_EXISTS 0x20
|
|
351
|
+
/** 参数无效 */
|
|
352
|
+
#define SB_ERR_BAD_PARAMETER 0x25
|
|
353
|
+
/** 文件名或目录名错误 */
|
|
354
|
+
#define SB_ERR_BAD_NAME 0x27
|
|
355
|
+
/** 文件打开方式错误 */
|
|
356
|
+
#define SB_ERR_BAD_OPEN_MODE 0x28
|
|
357
|
+
/** 磁盘空间不够 */
|
|
358
|
+
#define SB_ERR_NO_SPACE 0x2C
|
|
359
|
+
/** 文件未打开 */
|
|
360
|
+
#define SB_ERR_NOT_OPEN 0x2E
|
|
361
|
+
|
|
362
|
+
/* 运行库入口(ROM 页组 0,经 FN_CALL_BANKED 且 SYS_GROUP=0 调用) */
|
|
363
|
+
/** 显示 A 的十六进制,经功能 $25 调用时 A 传不进去,不能用 */
|
|
364
|
+
#define SB_LIB_PRINT_HEX 0x8047
|
|
365
|
+
/** 发一声提示音 */
|
|
366
|
+
#define SB_LIB_BEEP 0x802D
|
|
367
|
+
/** 光标左移一列,到行首移到上一行末尾 */
|
|
368
|
+
#define SB_LIB_CURSOR_LEFT 0x8081
|
|
369
|
+
/** 光标右移一列,到第 32 列换行 */
|
|
370
|
+
#define SB_LIB_CURSOR_RIGHT 0x80CF
|
|
371
|
+
/** 换行,行满滚屏;调用前 CURSOR_COL 要置 1 */
|
|
372
|
+
#define SB_LIB_NEWLINE 0x80E2
|
|
373
|
+
/** 等待按键,结果在 KEY_ASCII、KEY_SCAN */
|
|
374
|
+
#define SB_LIB_GET_KEY 0x81F4
|
|
375
|
+
/** 显示消息号为 LIB_GROUP 值的内置消息 */
|
|
376
|
+
#define SB_LIB_PRINT_MESSAGE 0x8202
|
|
377
|
+
/** 在光标处显示 STR_PTR 指向的字符串,不移动光标 */
|
|
378
|
+
#define SB_LIB_PRINT_STRING 0x8262
|
|
379
|
+
|
|
380
|
+
#endif
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* ------------------------------------------------------------------------
|
|
3
|
+
* 名称:sb2000.h
|
|
4
|
+
* 说明:SB-DOS(小霸王学习机 SB2000)程序的 C 接口:显示、按键、直接调用系统服务,以及常用内存变量的访问宏。
|
|
5
|
+
* 作者:sungbin
|
|
6
|
+
* 邮箱:sungbin@3578.cn
|
|
7
|
+
* 日期:2026-11-10
|
|
8
|
+
* 备注:程序从 $8000 起装入,最大 16K,main 返回后总是回到 DOS,返回值被忽略;返回 DOS 后 DOS 会清屏,所以显示后要先等待按键。
|
|
9
|
+
* 只封装已在模拟器里验证过的系统调用;其他服务用 sb_syscall 加 sb2000-symbols.h 里的常量自行调用。
|
|
10
|
+
* ------------------------------------------------------------------------
|
|
11
|
+
*/
|
|
12
|
+
#ifndef SB2000_H
|
|
13
|
+
#define SB2000_H
|
|
14
|
+
|
|
15
|
+
#include "sb2000-symbols.h"
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* 读写一个固定地址的字节,如 SB_BYTE_AT(SB_KEY_ASCII)。
|
|
19
|
+
*
|
|
20
|
+
* @param address 字节的地址,可以用 sb2000-symbols.h 里的常量。
|
|
21
|
+
*/
|
|
22
|
+
#define SB_BYTE_AT(address) (*(volatile unsigned char *)(address))
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* 从行首显示零结尾字符串并换行。
|
|
26
|
+
* 字符码不小于 0xA1 的两个字节按 GB2312 显示一个汉字。
|
|
27
|
+
*
|
|
28
|
+
* @param s 零结尾的字符串。
|
|
29
|
+
*/
|
|
30
|
+
void __fastcall__ sb_puts(const char *s);
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* 回到行首并换行,行满时自动滚动屏幕。
|
|
34
|
+
*/
|
|
35
|
+
void sb_newline(void);
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* 等待按键并返回它的 ASCII 码。
|
|
39
|
+
*
|
|
40
|
+
* @return 按键的 ASCII 码;没有字符的键(如功能键)为 0。
|
|
41
|
+
*/
|
|
42
|
+
unsigned char sb_getkey(void);
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* 调用系统服务,结果由调用者读各服务规定的变量。
|
|
46
|
+
*
|
|
47
|
+
* @param function 功能号,如 SB_FN_INPUT。
|
|
48
|
+
* @param sub 子功能号,如 SB_SUB_KEY_GET_WAIT;没有子功能的服务可以写 0。
|
|
49
|
+
*/
|
|
50
|
+
void __fastcall__ sb_syscall(unsigned char function, unsigned char sub);
|
|
51
|
+
|
|
52
|
+
#endif
|
|
Binary file
|
|
Binary file
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
FEATURES {
|
|
2
|
+
CONDES: type = constructor,
|
|
3
|
+
label = __CONSTRUCTOR_TABLE__,
|
|
4
|
+
count = __CONSTRUCTOR_COUNT__,
|
|
5
|
+
segment = ONCE;
|
|
6
|
+
CONDES: type = destructor,
|
|
7
|
+
label = __DESTRUCTOR_TABLE__,
|
|
8
|
+
count = __DESTRUCTOR_COUNT__,
|
|
9
|
+
segment = RODATA;
|
|
10
|
+
CONDES: type = interruptor,
|
|
11
|
+
label = __INTERRUPTOR_TABLE__,
|
|
12
|
+
count = __INTERRUPTOR_COUNT__,
|
|
13
|
+
segment = RODATA,
|
|
14
|
+
import = __CALLIRQ__;
|
|
15
|
+
}
|
|
16
|
+
SYMBOLS {
|
|
17
|
+
__STACKSIZE__: type = weak, value = $0400; # C 软件栈 1K,在程序窗口的顶端
|
|
18
|
+
__STACKSTART__: type = weak, value = $C000; # 栈从 $C000 向下增长
|
|
19
|
+
__ZPSTART__: type = weak, value = $0060; # C 运行库的零页
|
|
20
|
+
}
|
|
21
|
+
MEMORY {
|
|
22
|
+
ZP: file = "", define = yes, start = __ZPSTART__, size = $0020;
|
|
23
|
+
MAIN: file = %O, start = $8000, size = __STACKSTART__ - __STACKSIZE__ - $8000;
|
|
24
|
+
}
|
|
25
|
+
SEGMENTS {
|
|
26
|
+
HEADER: load = MAIN, type = ro;
|
|
27
|
+
ZEROPAGE: load = ZP, type = zp;
|
|
28
|
+
STARTUP: load = MAIN, type = ro;
|
|
29
|
+
LOWCODE: load = MAIN, type = ro, optional = yes;
|
|
30
|
+
ONCE: load = MAIN, type = ro, optional = yes;
|
|
31
|
+
CODE: load = MAIN, type = rw;
|
|
32
|
+
RODATA: load = MAIN, type = rw;
|
|
33
|
+
DATA: load = MAIN, type = rw;
|
|
34
|
+
BSS: load = MAIN, type = bss, define = yes;
|
|
35
|
+
}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
; ------------------------------------------------------------------------
|
|
2
|
+
; 名称:crt0.s
|
|
3
|
+
; 说明:SB-DOS 程序的启动代码:程序文件头,初始化 C 运行库,调用 main,返回 DOS。
|
|
4
|
+
; 作者:sungbin
|
|
5
|
+
; 邮箱:sungbin@3578.cn
|
|
6
|
+
; 日期:2026-11-10
|
|
7
|
+
; 备注:程序从 $8000 起装入,文件头为 4C lo hi AA 55,偏移 5、6 由 DOS 写成起始页号与页数,偏移 7 保留。
|
|
8
|
+
; C 软件栈在 $8000-$BFFF 窗口的顶端(link.cfg 里的 __STACKSTART__ 与 __STACKSIZE__);
|
|
9
|
+
; C 运行库的零页放在 $0060 起,这段零页在 BIOS 的符号表里没有任何引用,开机到提示符期间也没有写入,所以返回 DOS 前不需要恢复。
|
|
10
|
+
; main 的返回值被忽略,程序总是以 CLC、RTS 返回 DOS。
|
|
11
|
+
; ------------------------------------------------------------------------
|
|
12
|
+
.export _exit
|
|
13
|
+
.export __STARTUP__ : absolute = 1 ; 标记本文件是启动代码
|
|
14
|
+
.import zerobss, _main
|
|
15
|
+
.import initlib, donelib
|
|
16
|
+
.import __STACKSTART__ ; 链接器生成
|
|
17
|
+
|
|
18
|
+
.include "zeropage.inc"
|
|
19
|
+
|
|
20
|
+
.segment "HEADER"
|
|
21
|
+
|
|
22
|
+
jmp start
|
|
23
|
+
.byte $AA, $55 ; 魔数
|
|
24
|
+
.byte $00, $00, $00 ; 偏移 5、6 由 DOS 改写,偏移 7 保留
|
|
25
|
+
|
|
26
|
+
.segment "STARTUP"
|
|
27
|
+
|
|
28
|
+
start: lda #<__STACKSTART__
|
|
29
|
+
ldx #>__STACKSTART__
|
|
30
|
+
sta c_sp
|
|
31
|
+
stx c_sp+1
|
|
32
|
+
jsr zerobss
|
|
33
|
+
jsr initlib
|
|
34
|
+
jsr _main
|
|
35
|
+
_exit: jsr donelib
|
|
36
|
+
clc
|
|
37
|
+
rts
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
; ------------------------------------------------------------------------
|
|
2
|
+
; 名称:sb2000.s
|
|
3
|
+
; 说明:sb2000.h 里各函数的实现:显示字符串、换行、等待按键、直接调用系统服务。
|
|
4
|
+
; 作者:sungbin
|
|
5
|
+
; 邮箱:sungbin@3578.cn
|
|
6
|
+
; 日期:2026-11-10
|
|
7
|
+
; 备注:C 调用约定为 cc65 的 fastcall:最后一个参数在 A(低字节)与 X(高字节),其余参数在 C 栈上,由被调用者弹出。
|
|
8
|
+
; 显示借用 ROM 页组 0 里的运行库,经功能 $25 调用;LIB_PRINT_STRING 在光标当前列显示字符串,不移动光标,
|
|
9
|
+
; 所以 sb_puts 先把光标列置 1(行首)再显示,显示后换行。字符串在程序所在的页组里,页组首页号取自文件头偏移 5(DOS 装入时写入)。
|
|
10
|
+
; ------------------------------------------------------------------------
|
|
11
|
+
.include "sb2000.inc"
|
|
12
|
+
.export _sb_puts, _sb_newline, _sb_getkey, _sb_syscall
|
|
13
|
+
.import popa
|
|
14
|
+
|
|
15
|
+
; 程序文件头偏移 5:DOS 写入的起始页号
|
|
16
|
+
PROGRAM_START_PAGE = $8005
|
|
17
|
+
|
|
18
|
+
.code
|
|
19
|
+
|
|
20
|
+
; void sb_puts(const char *s):从行首显示字符串并换行
|
|
21
|
+
_sb_puts:
|
|
22
|
+
pha
|
|
23
|
+
lda #$01
|
|
24
|
+
sta CURSOR_COL
|
|
25
|
+
pla
|
|
26
|
+
sta STR_PTR_LO
|
|
27
|
+
stx STR_PTR_HI
|
|
28
|
+
lda PROGRAM_START_PAGE
|
|
29
|
+
sta LIB_GROUP
|
|
30
|
+
lda #<LIB_PRINT_STRING
|
|
31
|
+
ldx #>LIB_PRINT_STRING
|
|
32
|
+
jsr rom_call
|
|
33
|
+
|
|
34
|
+
; void sb_newline(void):回到行首并换行,行满时由运行库滚动屏幕
|
|
35
|
+
_sb_newline:
|
|
36
|
+
lda #$01
|
|
37
|
+
sta CURSOR_COL
|
|
38
|
+
lda #<LIB_NEWLINE
|
|
39
|
+
ldx #>LIB_NEWLINE
|
|
40
|
+
|
|
41
|
+
; 经功能 FN_CALL_BANKED 调用 ROM 页组 0 里 X:A 处的例程,返回后回到调用者
|
|
42
|
+
rom_call:
|
|
43
|
+
sta PROG_ENTRY_LO
|
|
44
|
+
stx PROG_ENTRY_HI
|
|
45
|
+
lda #FN_CALL_BANKED
|
|
46
|
+
sta SYS_FUNCTION
|
|
47
|
+
lda #$00
|
|
48
|
+
sta SYS_GROUP
|
|
49
|
+
jmp SYSCALL
|
|
50
|
+
|
|
51
|
+
; unsigned char sb_getkey(void):等待按键,返回它的 ASCII 码
|
|
52
|
+
_sb_getkey:
|
|
53
|
+
lda #FN_INPUT
|
|
54
|
+
sta SYS_FUNCTION
|
|
55
|
+
lda #SUB_KEY_GET_WAIT
|
|
56
|
+
sta SYS_SUBFUNCTION
|
|
57
|
+
jsr SYSCALL
|
|
58
|
+
lda KEY_ASCII
|
|
59
|
+
ldx #$00
|
|
60
|
+
rts
|
|
61
|
+
|
|
62
|
+
; void sb_syscall(unsigned char function, unsigned char sub):调用系统服务,结果由调用者读各服务规定的变量
|
|
63
|
+
_sb_syscall:
|
|
64
|
+
sta SYS_SUBFUNCTION
|
|
65
|
+
jsr popa
|
|
66
|
+
sta SYS_FUNCTION
|
|
67
|
+
jmp SYSCALL
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "sb2000",
|
|
3
|
+
"title": "小霸王学习机 SB2000(SB-DOS)",
|
|
4
|
+
"cpu": "6502",
|
|
5
|
+
"cc65Target": "none",
|
|
6
|
+
"linkConfig": "link.cfg",
|
|
7
|
+
"startup": ["lib/crt0.o"],
|
|
8
|
+
"libraries": ["lib/sb2000.lib", "toolchain:lib/none.lib"],
|
|
9
|
+
"include": ["include"],
|
|
10
|
+
"asminclude": ["asminc"],
|
|
11
|
+
"defines": {
|
|
12
|
+
"__SB2000__": 1
|
|
13
|
+
},
|
|
14
|
+
"packager": "flat-exe",
|
|
15
|
+
"packagerOptions": {
|
|
16
|
+
"header": "4C????AA55",
|
|
17
|
+
"maxSize": 16384
|
|
18
|
+
},
|
|
19
|
+
"extension": ".EXE",
|
|
20
|
+
"nameRule": "dos-8.3",
|
|
21
|
+
"disk": {
|
|
22
|
+
"packager": "fat-floppy"
|
|
23
|
+
},
|
|
24
|
+
"run": {
|
|
25
|
+
"emulator": "virtuanes",
|
|
26
|
+
"mode": "firmware-disk"
|
|
27
|
+
}
|
|
28
|
+
}
|