fcdev 0.1.0 → 0.3.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/README.md +21 -2
- package/docs/01-/350/275/257/344/273/266/346/236/266/346/236/204/350/256/276/350/256/241.md +164 -0
- package/docs/02-/345/221/275/344/273/244/350/241/214/344/270/216/346/236/204/345/273/272.md +157 -0
- package/docs/03-/347/233/256/346/240/207/350/247/204/350/214/203.md +123 -0
- package/docs/04-cc65/345/267/245/345/205/267/351/223/276.md +51 -0
- package/docs/05-/346/250/241/346/213/237/345/231/250/344/270/216/350/260/203/350/257/225.md +100 -0
- package/docs/06-/345/217/215/346/261/207/347/274/226.md +103 -0
- package/docs/07-/345/210/233/345/273/272/345/214/205/344/270/216/346/250/241/346/235/277.md +74 -0
- package/docs/08-/346/265/213/350/257/225/344/270/216/351/252/214/350/257/201.md +72 -0
- package/docs/09-/345/217/221/345/270/203.md +67 -0
- package/docs/10-VS Code/346/211/251/345/261/225.md" +131 -0
- package/docs/nes/01-NES/347/233/256/346/240/207.md +52 -0
- package/docs/sb2000/01-/345/274/200/345/217/221/346/214/207/345/215/227.md +252 -0
- package/docs/sb2000/02-/347/263/273/347/273/237/350/260/203/347/224/250/346/211/213/345/206/214.md +797 -0
- package/docs/sb2000/03-/347/241/254/344/273/266/350/257/264/346/230/216.md +27 -0
- package/docs//345/276/205/345/212/236/345/244/207/345/277/230.md +46 -0
- package/docs//347/274/272/351/231/267/350/256/260/345/275/225.md +10 -0
- package/package.json +4 -3
- package/src/api/header-parser.mjs +78 -0
- package/src/api/index.mjs +128 -0
- package/src/build/bank-link-config.mjs +74 -0
- package/src/build/index.mjs +1 -0
- package/src/build/program-builder.mjs +5 -2
- package/src/cli/commands/api-command.mjs +62 -0
- package/src/cli/commands/docs-command.mjs +58 -0
- package/src/cli/index.mjs +6 -0
- package/src/docs/doc-index.mjs +101 -0
- package/src/docs/doc-topics.mjs +38 -0
- package/src/docs/index.mjs +10 -0
- package/src/targets/target-registry.mjs +38 -0
- package/targets/nes/lib/fcnes.lib +0 -0
- package/targets/nes/lib/nes-font.o +0 -0
- package/targets/sb2000/api-reference.md +3295 -0
- package/targets/sb2000/api-unwrapped.json +36 -0
- package/targets/sb2000/asminc/sb2000.inc +203 -1
- package/targets/sb2000/include/sb2000-bank.h +74 -0
- package/targets/sb2000/include/sb2000-clock.h +68 -0
- package/targets/sb2000/include/sb2000-disk.h +141 -0
- package/targets/sb2000/include/sb2000-display.h +352 -0
- package/targets/sb2000/include/sb2000-file.h +273 -0
- package/targets/sb2000/include/sb2000-ime.h +158 -0
- package/targets/sb2000/include/sb2000-input.h +192 -0
- package/targets/sb2000/include/sb2000-math.h +228 -0
- package/targets/sb2000/include/sb2000-memory.h +115 -0
- package/targets/sb2000/include/sb2000-printer.h +116 -0
- package/targets/sb2000/include/sb2000-sound.h +134 -0
- package/targets/sb2000/include/sb2000-symbols.h +397 -1
- package/targets/sb2000/include/sb2000-system.h +219 -0
- package/targets/sb2000/include/sb2000-text.h +99 -0
- package/targets/sb2000/include/sb2000.h +13 -20
- package/targets/sb2000/lib/crt0.o +0 -0
- package/targets/sb2000/lib/sb2000.lib +0 -0
- package/targets/sb2000/lib-build.json +1 -1
- package/targets/sb2000/link-banked.cfg +42 -0
- package/targets/sb2000/src/crt0.s +89 -4
- package/targets/sb2000/src/lib/bank/sb-bank-current.c +18 -0
- package/targets/sb2000/src/lib/bank/sb-bank-select.c +21 -0
- package/targets/sb2000/src/lib/bank/sbi-bank-trampoline.s +46 -0
- package/targets/sb2000/src/lib/clock/sb-clock-get-date.c +17 -0
- package/targets/sb2000/src/lib/clock/sb-clock-get-time.c +17 -0
- package/targets/sb2000/src/lib/clock/sb-clock-set-date.c +21 -0
- package/targets/sb2000/src/lib/clock/sb-clock-set-time.c +17 -0
- package/targets/sb2000/src/lib/clock/sbi-date-from-fat.c +20 -0
- package/targets/sb2000/src/lib/clock/sbi-date-to-fat.c +24 -0
- package/targets/sb2000/src/lib/clock/sbi-time-from-fat.c +20 -0
- package/targets/sb2000/src/lib/clock/sbi-time-to-fat.c +19 -0
- package/targets/sb2000/src/lib/disk/sb-disk-format-track.c +18 -0
- package/targets/sb2000/src/lib/disk/sb-disk-free-bytes.c +38 -0
- package/targets/sb2000/src/lib/disk/sb-disk-init.c +16 -0
- package/targets/sb2000/src/lib/disk/sb-disk-read-sector.c +24 -0
- package/targets/sb2000/src/lib/disk/sb-disk-read-sectors.c +17 -0
- package/targets/sb2000/src/lib/disk/sb-disk-scan-track.c +27 -0
- package/targets/sb2000/src/lib/disk/sb-disk-start.c +16 -0
- package/targets/sb2000/src/lib/disk/sb-disk-stop.c +16 -0
- package/targets/sb2000/src/lib/disk/sb-disk-write-sector.c +19 -0
- package/targets/sb2000/src/lib/disk/sb-disk-write-sectors.c +17 -0
- package/targets/sb2000/src/lib/disk/sbi-disk-batch.c +23 -0
- package/targets/sb2000/src/lib/disk/sbi-disk-call.c +17 -0
- package/targets/sb2000/src/lib/disk/sbi-disk-set-position.c +18 -0
- package/targets/sb2000/src/lib/display/sb-cell-address.c +20 -0
- package/targets/sb2000/src/lib/display/sb-cells-copy.c +27 -0
- package/targets/sb2000/src/lib/display/sb-cells-fill.c +25 -0
- package/targets/sb2000/src/lib/display/sb-cells-rect.c +20 -0
- package/targets/sb2000/src/lib/display/sb-display-mode.c +16 -0
- package/targets/sb2000/src/lib/display/sb-glyph-address.c +28 -0
- package/targets/sb2000/src/lib/display/sb-image-fill-rect.c +26 -0
- package/targets/sb2000/src/lib/display/sb-image-load-raw.c +22 -0
- package/targets/sb2000/src/lib/display/sb-image-show-full.c +20 -0
- package/targets/sb2000/src/lib/display/sb-image-show.c +25 -0
- package/targets/sb2000/src/lib/display/sb-image-unpack-map.c +28 -0
- package/targets/sb2000/src/lib/display/sb-image-unpack-tiles.c +20 -0
- package/targets/sb2000/src/lib/display/sb-image-unpack-to-memory.c +22 -0
- package/targets/sb2000/src/lib/display/sb-palette-write.c +20 -0
- package/targets/sb2000/src/lib/display/sb-screen-clear.c +19 -0
- package/targets/sb2000/src/lib/display/sb-screen-flush.c +16 -0
- package/targets/sb2000/src/lib/display/sb-text-draw.c +22 -0
- package/targets/sb2000/src/lib/display/sb-text-field-ascii.c +25 -0
- package/targets/sb2000/src/lib/display/sb-text-field.c +25 -0
- package/targets/sb2000/src/lib/display/sb-text-to-memory.c +27 -0
- package/targets/sb2000/src/lib/display/sb-vram-bank.c +17 -0
- package/targets/sb2000/src/lib/display/sb-vram-fill.c +21 -0
- package/targets/sb2000/src/lib/display/sb-vram-load.c +21 -0
- package/targets/sb2000/src/lib/display/sb-window-compact.c +16 -0
- package/targets/sb2000/src/lib/display/sb-window-init.c +16 -0
- package/targets/sb2000/src/lib/display/sb-window-restore.c +17 -0
- package/targets/sb2000/src/lib/display/sb-window-save.c +21 -0
- package/targets/sb2000/src/lib/file/sb-dir-change.c +21 -0
- package/targets/sb2000/src/lib/file/sb-dir-current.c +27 -0
- package/targets/sb2000/src/lib/file/sb-dir-make.c +21 -0
- package/targets/sb2000/src/lib/file/sb-dir-open.c +61 -0
- package/targets/sb2000/src/lib/file/sb-dir-read.c +87 -0
- package/targets/sb2000/src/lib/file/sb-dir-remove.c +21 -0
- package/targets/sb2000/src/lib/file/sb-file-close.c +21 -0
- package/targets/sb2000/src/lib/file/sb-file-delete.c +21 -0
- package/targets/sb2000/src/lib/file/sb-file-get-attr.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-get-date.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-get-time.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-load.c +50 -0
- package/targets/sb2000/src/lib/file/sb-file-open.c +26 -0
- package/targets/sb2000/src/lib/file/sb-file-read.c +52 -0
- package/targets/sb2000/src/lib/file/sb-file-rename.c +30 -0
- package/targets/sb2000/src/lib/file/sb-file-save.c +31 -0
- package/targets/sb2000/src/lib/file/sb-file-set-attr.c +22 -0
- package/targets/sb2000/src/lib/file/sb-file-set-date.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-set-time.c +22 -0
- package/targets/sb2000/src/lib/file/sb-file-size.c +27 -0
- package/targets/sb2000/src/lib/file/sb-file-write-all.c +32 -0
- package/targets/sb2000/src/lib/file/sb-file-write.c +60 -0
- package/targets/sb2000/src/lib/file/sbi-dir-state.c +15 -0
- package/targets/sb2000/src/lib/file/sbi-dos-call.c +17 -0
- package/targets/sb2000/src/lib/file/sbi-load-sector.c +18 -0
- package/targets/sb2000/src/lib/file/sbi-select-handle.c +20 -0
- package/targets/sb2000/src/lib/file/sbi-set-path.c +26 -0
- package/targets/sb2000/src/lib/ime/sb-ime-get-method.c +17 -0
- package/targets/sb2000/src/lib/ime/sb-ime-get-state.c +18 -0
- package/targets/sb2000/src/lib/ime/sb-ime-hex.c +20 -0
- package/targets/sb2000/src/lib/ime/sb-ime-init.c +26 -0
- package/targets/sb2000/src/lib/ime/sb-ime-key-wait.c +19 -0
- package/targets/sb2000/src/lib/ime/sb-ime-key.c +19 -0
- package/targets/sb2000/src/lib/ime/sb-ime-parse.c +23 -0
- package/targets/sb2000/src/lib/ime/sb-ime-resume.c +16 -0
- package/targets/sb2000/src/lib/ime/sb-ime-select.c +19 -0
- package/targets/sb2000/src/lib/ime/sb-ime-set-state.c +18 -0
- package/targets/sb2000/src/lib/ime/sb-ime-set-width.c +16 -0
- package/targets/sb2000/src/lib/ime/sb-ime-suspend.c +16 -0
- package/targets/sb2000/src/lib/input/sb-break-disable.c +16 -0
- package/targets/sb2000/src/lib/input/sb-break-enable.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-count.c +17 -0
- package/targets/sb2000/src/lib/input/sb-key-flush.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-init.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-modifiers.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-poll.c +17 -0
- package/targets/sb2000/src/lib/input/sb-key-wait.c +17 -0
- package/targets/sb2000/src/lib/input/sb-keyboard-reset.c +17 -0
- package/targets/sb2000/src/lib/input/sb-mouse-buttons.c +21 -0
- package/targets/sb2000/src/lib/input/sb-mouse-position.c +18 -0
- package/targets/sb2000/src/lib/input/sb-mouse-reset.c +17 -0
- package/targets/sb2000/src/lib/input/sb-mouse-set-double-click.c +17 -0
- package/targets/sb2000/src/lib/input/sb-mouse-set-limits.c +26 -0
- package/targets/sb2000/src/lib/input/sb-mouse-set-position.c +18 -0
- package/targets/sb2000/src/lib/input/sb-pad-init.c +17 -0
- package/targets/sb2000/src/lib/input/sb-pad-poll.c +17 -0
- package/targets/sb2000/src/lib/input/sb-pad-state.c +16 -0
- package/targets/sb2000/src/lib/input/sb-pad-wait.c +17 -0
- package/targets/sb2000/src/lib/math/sb-float-add.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-div.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-from-text.c +18 -0
- package/targets/sb2000/src/lib/math/sb-float-mul.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-sub.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-to-text.c +19 -0
- package/targets/sb2000/src/lib/math/sb-int24-add.c +21 -0
- package/targets/sb2000/src/lib/math/sb-int24-div.c +26 -0
- package/targets/sb2000/src/lib/math/sb-int24-mul.c +20 -0
- package/targets/sb2000/src/lib/math/sb-int24-sub.c +21 -0
- package/targets/sb2000/src/lib/math/sb-int40-from-text.c +19 -0
- package/targets/sb2000/src/lib/math/sb-int40-to-text.c +27 -0
- package/targets/sb2000/src/lib/math/sb-line-step.c +21 -0
- package/targets/sb2000/src/lib/math/sb-math-div16.c +27 -0
- package/targets/sb2000/src/lib/math/sb-math-time-text.c +21 -0
- package/targets/sb2000/src/lib/math/sb-random-next.c +20 -0
- package/targets/sb2000/src/lib/math/sb-random-seed.c +19 -0
- package/targets/sb2000/src/lib/math/sb-random-warm-up.c +16 -0
- package/targets/sb2000/src/lib/math/sbi-peek.c +20 -0
- package/targets/sb2000/src/lib/math/sbi-poke.c +20 -0
- package/targets/sb2000/src/lib/memory/sb-address-to-far.c +20 -0
- package/targets/sb2000/src/lib/memory/sb-far-read-byte.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-far-read.c +36 -0
- package/targets/sb2000/src/lib/memory/sb-far-write-byte.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-far-write.c +36 -0
- package/targets/sb2000/src/lib/memory/sb-page-alloc.c +19 -0
- package/targets/sb2000/src/lib/memory/sb-page-free.c +19 -0
- package/targets/sb2000/src/lib/memory/sb-page-largest-free.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-window-map-group.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-window-map.c +18 -0
- package/targets/sb2000/src/lib/memory/sbi-far-copy-in.s +17 -0
- package/targets/sb2000/src/lib/memory/sbi-far-copy-out.s +17 -0
- package/targets/sb2000/src/lib/memory/sbi-far-read-byte.s +19 -0
- package/targets/sb2000/src/lib/memory/sbi-far-write-byte.s +17 -0
- package/targets/sb2000/src/lib/printer/sb-printer-carriage-return.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-feed.c +17 -0
- package/targets/sb2000/src/lib/printer/sb-printer-graphics-mode.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-home.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-init-port.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-page-left.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-page-length.c +17 -0
- package/targets/sb2000/src/lib/printer/sb-printer-position.c +18 -0
- package/targets/sb2000/src/lib/printer/sb-printer-reset.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-send-byte.c +18 -0
- package/targets/sb2000/src/lib/printer/sb-printer-text.c +29 -0
- package/targets/sb2000/src/lib/sb-internal.h +111 -0
- package/targets/sb2000/src/lib/sound/sb-sound-effect-from.c +19 -0
- package/targets/sb2000/src/lib/sound/sb-sound-play-from.c +18 -0
- package/targets/sb2000/src/lib/sound/sb-sound-play-wav-from.c +18 -0
- package/targets/sb2000/src/lib/sound/sb-sound-play-wav.c +16 -0
- package/targets/sb2000/src/lib/sound/sb-sound-repeat-wav-from.c +19 -0
- package/targets/sb2000/src/lib/sound/sb-sound-status.c +17 -0
- package/targets/sb2000/src/lib/sound/sb-sound-stop.c +16 -0
- package/targets/sb2000/src/lib/sound/sb-sound-tempo.c +17 -0
- package/targets/sb2000/src/lib/sound/sb-sound-transpose.c +17 -0
- package/targets/sb2000/src/lib/sound/sb-speech-off.c +16 -0
- package/targets/sb2000/src/lib/sound/sb-speech-send-entry-from.c +21 -0
- package/targets/sb2000/src/lib/sound/sb-speech-send-from.c +19 -0
- package/targets/sb2000/src/lib/sound/sb-speech-send.c +16 -0
- package/targets/sb2000/src/lib/system/sb-call-banked.c +19 -0
- package/targets/sb2000/src/lib/system/sb-context-restore.c +16 -0
- package/targets/sb2000/src/lib/system/sb-context-save.c +19 -0
- package/targets/sb2000/src/lib/system/sb-display-off.c +16 -0
- package/targets/sb2000/src/lib/system/sb-display-on.c +16 -0
- package/targets/sb2000/src/lib/system/sb-display-option.c +18 -0
- package/targets/sb2000/src/lib/system/sb-exec.c +22 -0
- package/targets/sb2000/src/lib/system/sb-irq-enable.c +19 -0
- package/targets/sb2000/src/lib/system/sb-irq-hook-reset.c +20 -0
- package/targets/sb2000/src/lib/system/sb-irq-hook-set.c +39 -0
- package/targets/sb2000/src/lib/system/sb-irq-mask.c +19 -0
- package/targets/sb2000/src/lib/system/sb-jump-banked.s +25 -0
- package/targets/sb2000/src/lib/system/sb-nmi-disable.c +16 -0
- package/targets/sb2000/src/lib/system/sb-nmi-enable.c +16 -0
- package/targets/sb2000/src/lib/system/sb-nmi-hook-reset.c +20 -0
- package/targets/sb2000/src/lib/system/sb-nmi-hook-set.c +33 -0
- package/targets/sb2000/src/lib/system/sb-nmi-service.c +19 -0
- package/targets/sb2000/src/lib/system/sb-stack-pointer.s +18 -0
- package/targets/sb2000/src/lib/system/sb-system-init.c +16 -0
- package/targets/sb2000/src/lib/system/sb-system-state.c +20 -0
- package/targets/sb2000/src/lib/system/sb-wait-frames.s +19 -0
- package/targets/sb2000/src/lib/system/sbi-exec-run.s +43 -0
- package/targets/sb2000/src/lib/system/sbi-interrupts-off.s +19 -0
- package/targets/sb2000/src/lib/system/sbi-interrupts-restore.s +17 -0
- package/targets/sb2000/src/lib/text/sb-beep.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-column.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-left.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-right.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-row.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-set-column.c +18 -0
- package/targets/sb2000/src/lib/text/sb-cursor-up.c +16 -0
- package/targets/sb2000/src/lib/text/sb-print-hex.c +22 -0
- package/targets/sb2000/src/lib/text/sb-print-uint.c +25 -0
- package/targets/sb2000/src/lib/text/sb-print.c +35 -0
- package/targets/sb2000/src/lib/text/sb-putc.c +26 -0
- package/targets/sb2000/src/sb2000.s +0 -3
- package/targets/sb2000/target.json +14 -0
|
@@ -0,0 +1,219 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* ------------------------------------------------------------------------
|
|
3
|
+
* 名称:sb2000-system.h
|
|
4
|
+
* 说明:SB-DOS 程序的系统基础服务:等待帧、NMI 与中断控制、显示选项、状态查询、跨页调用、上下文保存。
|
|
5
|
+
* 作者:sungbin
|
|
6
|
+
* 邮箱:sungbin@3578.cn
|
|
7
|
+
* 日期:2026-11-11
|
|
8
|
+
* 备注:由 sb2000.h 引入,程序不必单独包含。程序最大 16K,装在 $8000-$BFFF 的 4 个窗口里;
|
|
9
|
+
* 页组指连续的 4 个扩展 RAM 页,程序自己的页组首页号是 SB_BYTE_AT(SB_PROGRAM_START_PAGE)。
|
|
10
|
+
* ------------------------------------------------------------------------
|
|
11
|
+
*/
|
|
12
|
+
#ifndef SB2000_SYSTEM_H
|
|
13
|
+
#define SB2000_SYSTEM_H
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* 等待指定数量的垂直消隐周期(帧)。
|
|
17
|
+
*
|
|
18
|
+
* @syscall $1B
|
|
19
|
+
* @param frames 帧数;0 按 256 计。
|
|
20
|
+
*/
|
|
21
|
+
void __fastcall__ sb_wait_frames(unsigned char frames);
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* 打开 NMI(垂直消隐中断)。NMI 里的各项服务(声音更新、读手柄等)要它开着才工作。
|
|
25
|
+
*
|
|
26
|
+
* @syscall $12/$80
|
|
27
|
+
*/
|
|
28
|
+
void sb_nmi_enable(void);
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* 关闭 NMI。磁盘读写这类要独占硬件的操作前后常成对使用。
|
|
32
|
+
*
|
|
33
|
+
* @syscall $12/$00
|
|
34
|
+
*/
|
|
35
|
+
void sb_nmi_disable(void);
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* 打开或关闭 NMI 里的一项服务。服务号用 SB_NMI_SERVICE_ 开头的常量:
|
|
39
|
+
* SB_NMI_SERVICE_BAR_ANIM 条带动画,SB_NMI_SERVICE_SOUND 声音引擎每帧更新,
|
|
40
|
+
* SB_NMI_SERVICE_HOOK5、SB_NMI_SERVICE_HOOK4 调用登记的钩子,SB_NMI_SERVICE_PAD 读手柄,
|
|
41
|
+
* SB_NMI_SERVICE_PALETTE 上传 $0700 缓冲到调色板。
|
|
42
|
+
* 打开 SB_NMI_SERVICE_PAD 时系统还把 $0634 置 $FF。服务号超出 1-6 时什么都不做。
|
|
43
|
+
*
|
|
44
|
+
* @syscall $12/$81-$86、$12/$01-$06
|
|
45
|
+
* @param service 服务号,1 到 6。
|
|
46
|
+
* @param enable 非 0 打开,0 关闭。
|
|
47
|
+
*/
|
|
48
|
+
void sb_nmi_service(unsigned char service, unsigned char enable);
|
|
49
|
+
|
|
50
|
+
/**
|
|
51
|
+
* 登记一个 NMI 钩子:对应的 NMI 服务(SB_NMI_SERVICE_HOOK4、SB_NMI_SERVICE_HOOK5)打开后,
|
|
52
|
+
* 每次 NMI 都会映射页组并调用入口例程。钩子是汇编例程,在中断里运行,以 RTS 返回,不能调用 C 函数。
|
|
53
|
+
* 钩子号不是 4 或 5 时什么都不做。
|
|
54
|
+
*
|
|
55
|
+
* @param hook 钩子号,4 或 5。
|
|
56
|
+
* @param group 钩子所在页组的首页号,自己程序里的例程传 SB_BYTE_AT(SB_PROGRAM_START_PAGE)。
|
|
57
|
+
* @param entry 入口例程的地址。
|
|
58
|
+
*/
|
|
59
|
+
void sb_nmi_hook_set(unsigned char hook, unsigned char group, unsigned int entry);
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* 把一个 NMI 钩子恢复成空钩子。钩子号不是 4 或 5 时什么都不做。
|
|
63
|
+
*
|
|
64
|
+
* @syscall $12/$88
|
|
65
|
+
* @param hook 钩子号,4 对应 SB_NMI_SERVICE_HOOK4,5 对应 SB_NMI_SERVICE_HOOK5。
|
|
66
|
+
*/
|
|
67
|
+
void sb_nmi_hook_reset(unsigned char hook);
|
|
68
|
+
|
|
69
|
+
/**
|
|
70
|
+
* 屏蔽一个中断源(不再响应它)。中断源用 SB_IRQ_SOURCE_ 开头的常量:
|
|
71
|
+
* 0 定时器,1 鼠标,2 键盘,3 中断 4,4 软驱,5 中断 2,6 中断 1。
|
|
72
|
+
* 屏蔽键盘时系统还向 $4022 写 $40。中断源超出 0-6 时什么都不做。
|
|
73
|
+
*
|
|
74
|
+
* @syscall $13/$00-$06
|
|
75
|
+
* @param source 中断源,0 到 6。
|
|
76
|
+
*/
|
|
77
|
+
void sb_irq_mask(unsigned char source);
|
|
78
|
+
|
|
79
|
+
/**
|
|
80
|
+
* 允许一个中断源。中断源编号同 sb_irq_mask。
|
|
81
|
+
* 允许定时器时系统设置定时器寄存器;允许鼠标时按鼠标是否接入更新 $0634。
|
|
82
|
+
* 注意:中断源 5、6 的允许,系统用的屏蔽值取自表后相邻字节(原程序的疏漏):
|
|
83
|
+
* 允许中断源 5 实际清掉的是中断源 6 的屏蔽位,允许中断源 6 会把除定时器外的全部屏蔽位清 0。
|
|
84
|
+
* 不建议对这两个中断源使用。
|
|
85
|
+
*
|
|
86
|
+
* @syscall $13/$80-$86
|
|
87
|
+
* @param source 中断源,0 到 6。
|
|
88
|
+
*/
|
|
89
|
+
void sb_irq_enable(unsigned char source);
|
|
90
|
+
|
|
91
|
+
/**
|
|
92
|
+
* 登记一个中断钩子:对应的中断发生后,系统映射页组并调用入口例程。钩子是汇编例程,在中断里运行,以 RTS 返回,不能调用 C 函数。
|
|
93
|
+
* 钩子号:0 定时器,1 中断 3(系统不会调用它),2 中断 1,3 中断 4,4 鼠标,5 键盘,6 中断 2。
|
|
94
|
+
* 钩子号超出 0-6 时什么都不做。
|
|
95
|
+
*
|
|
96
|
+
* @param hook 钩子号,0 到 6。
|
|
97
|
+
* @param group 钩子所在页组的首页号,自己程序里的例程传 SB_BYTE_AT(SB_PROGRAM_START_PAGE)。
|
|
98
|
+
* @param entry 入口例程的地址。
|
|
99
|
+
*/
|
|
100
|
+
void sb_irq_hook_set(unsigned char hook, unsigned char group, unsigned int entry);
|
|
101
|
+
|
|
102
|
+
/**
|
|
103
|
+
* 把一个中断钩子恢复成空钩子。钩子号:0 定时器,1 中断 3,2 中断 1,3 中断 4,4 鼠标,5 键盘。
|
|
104
|
+
* 钩子号超出 0-5 时什么都不做;系统不提供中断 2 钩子的复位。
|
|
105
|
+
*
|
|
106
|
+
* @syscall $13/$88
|
|
107
|
+
* @param hook 钩子号,0 到 5。
|
|
108
|
+
*/
|
|
109
|
+
void sb_irq_hook_reset(unsigned char hook);
|
|
110
|
+
|
|
111
|
+
/**
|
|
112
|
+
* 把值按位并入显示相关的硬件寄存器并写入硬件。选项与它修改的位:
|
|
113
|
+
* 0 扩展控制 $2008 的位 7;1 $2008 的位 0;2 $2008 的位 2、3;3 $2000 的低 2 位(名称表选择);
|
|
114
|
+
* 4 精灵显示:$2001 的位 4,同时值非 0 时打开 NMI 里的精灵 DMA;5 $2000 的位 5(8x16 精灵);
|
|
115
|
+
* 6 $2001 只保留位 1-4 再并入;7 $2001 的位 3(背景显示)。
|
|
116
|
+
* 值要已经放在寄存器相应的位上,如选项 7 打开背景显示传 0x08。
|
|
117
|
+
*
|
|
118
|
+
* @syscall $10
|
|
119
|
+
* @param option 选项,0 到 7。
|
|
120
|
+
* @param value 要并入的位。
|
|
121
|
+
* @return 0 成功;选项超出范围时为 $FF,寄存器不变。
|
|
122
|
+
*/
|
|
123
|
+
unsigned char sb_display_option(unsigned char option, unsigned char value);
|
|
124
|
+
|
|
125
|
+
/**
|
|
126
|
+
* 关闭 NMI,等到垂直消隐后关闭背景与精灵显示,用于大批量改显存前。
|
|
127
|
+
*
|
|
128
|
+
* @syscall $19
|
|
129
|
+
*/
|
|
130
|
+
void sb_display_off(void);
|
|
131
|
+
|
|
132
|
+
/**
|
|
133
|
+
* 等到垂直消隐后打开 NMI,并恢复背景与精灵显示。
|
|
134
|
+
*
|
|
135
|
+
* @syscall $1A
|
|
136
|
+
*/
|
|
137
|
+
void sb_display_on(void);
|
|
138
|
+
|
|
139
|
+
/**
|
|
140
|
+
* 查询显示与系统状态。查询号与结果(位类的结果保持在原来的位上,不移位):
|
|
141
|
+
* 0 $2008 的位 7;1 $2008 的位 0;2 $2008 的位 2、3;3 $2000 的低 2 位(名称表选择);
|
|
142
|
+
* 4 $2001 的位 4(精灵显示);5 $2000 的位 5(精灵尺寸);
|
|
143
|
+
* 6 显示模式号 0-3,同时把当前字库的位置放进系统的字库参数单元;
|
|
144
|
+
* 7 NMI 服务开关 $0630 的位 1-7,位 0 换成“NMI 是否开着”;8 中断屏蔽影子;
|
|
145
|
+
* 9 鼠标是否在线(1 在线);10 恒为 1;11 键盘自检结果;12 $2001 的位 3、4(背景与精灵是否显示)。
|
|
146
|
+
* 查询号超出 0-12 时不调用,返回 0。
|
|
147
|
+
*
|
|
148
|
+
* @syscall $1E
|
|
149
|
+
* @param query 查询号,0 到 12。
|
|
150
|
+
* @return 查询结果。
|
|
151
|
+
*/
|
|
152
|
+
unsigned char sb_system_state(unsigned char query);
|
|
153
|
+
|
|
154
|
+
/**
|
|
155
|
+
* 系统硬件与状态初始化:重设显示、中断屏蔽、定时器、各钩子、键盘手柄鼠标状态、系统时钟(12:00:00)、DOS 内部状态等。
|
|
156
|
+
* 程序一般不需要调用,调用后程序此前的显示与输入设置都会丢失。
|
|
157
|
+
*
|
|
158
|
+
* @syscall $18
|
|
159
|
+
*/
|
|
160
|
+
void sb_system_init(void);
|
|
161
|
+
|
|
162
|
+
/**
|
|
163
|
+
* 映射页组到 $8000-$BFFF 后调用其中的例程,例程以 RTS 返回,返回后窗口恢复成调用前的样子。
|
|
164
|
+
* 调用 ROM 里的运行库时页组为 0。要调用自己程序里的函数,页组传 SB_BYTE_AT(SB_PROGRAM_START_PAGE)。
|
|
165
|
+
*
|
|
166
|
+
* @syscall $25
|
|
167
|
+
* @param group 页组的首页号,连续 4 页。
|
|
168
|
+
* @param entry 例程在窗口里的地址。
|
|
169
|
+
*/
|
|
170
|
+
void sb_call_banked(unsigned char group, unsigned int entry);
|
|
171
|
+
|
|
172
|
+
/**
|
|
173
|
+
* 映射页组到 $8000-$BFFF 后跳转到其中的例程,不再回到本函数。
|
|
174
|
+
* 例程的 RTS 直接返回到调用本函数的位置,相当于尾调用。
|
|
175
|
+
*
|
|
176
|
+
* @syscall $26
|
|
177
|
+
* @param group 页组的首页号,连续 4 页。
|
|
178
|
+
* @param entry 例程在窗口里的地址。
|
|
179
|
+
*/
|
|
180
|
+
void __fastcall__ sb_jump_banked(unsigned char group, unsigned int entry);
|
|
181
|
+
|
|
182
|
+
/**
|
|
183
|
+
* 运行另一个程序,运行完返回。系统按文件大小分配扩展 RAM 页、读入文件、检查文件头魔数 AA 55,
|
|
184
|
+
* 运行完关闭文件并释放页;子程序以 RTS 返回,用的窗口与页都是它自己的,不影响本程序。
|
|
185
|
+
*
|
|
186
|
+
* @syscall $7F/$00
|
|
187
|
+
* @param path 程序的路径,零结尾,最长 28 个字符。
|
|
188
|
+
* @return 0 成功;SB_ERR_FILE_NOT_FOUND 文件不存在;$3E 文件头魔数不符;SB_ERR_NO_MEMORY 没有足够的连续空闲页。
|
|
189
|
+
*/
|
|
190
|
+
unsigned char sb_exec(const char *path);
|
|
191
|
+
|
|
192
|
+
/**
|
|
193
|
+
* 取硬件栈指针。返回的是本函数被调用之后的值,即调用者的栈指针减 2。
|
|
194
|
+
*
|
|
195
|
+
* @return 硬件栈指针的低字节(高字节固定为 $01)。
|
|
196
|
+
*/
|
|
197
|
+
unsigned char sb_stack_pointer(void);
|
|
198
|
+
|
|
199
|
+
/**
|
|
200
|
+
* 把一个恢复点压入系统的上下文栈(最多 10 项,满了不保存),类似 setjmp。
|
|
201
|
+
* 之后 sb_context_restore 或按 ESC 中断(sb_break_enable)会取出它,把硬件栈指针设成保存的值并跳到入口例程。
|
|
202
|
+
* 入口例程是新的执行起点,不要用 RTS 返回。
|
|
203
|
+
*
|
|
204
|
+
* @syscall $1C
|
|
205
|
+
* @param group 入口例程所在页组的首页号,自己程序里的例程传 SB_BYTE_AT(SB_PROGRAM_START_PAGE)。
|
|
206
|
+
* @param entry 入口例程的地址。
|
|
207
|
+
* @param stack_pointer 恢复时要设的硬件栈指针,通常取 sb_stack_pointer() 的返回值。
|
|
208
|
+
*/
|
|
209
|
+
void sb_context_save(unsigned char group, unsigned int entry, unsigned char stack_pointer);
|
|
210
|
+
|
|
211
|
+
/**
|
|
212
|
+
* 弹出上下文栈顶的恢复点并跳过去,类似 longjmp:关闭 NMI 里的各项服务与声音,恢复保存的栈指针后跳转。
|
|
213
|
+
* 栈里有恢复点时不会返回;栈空时直接返回。
|
|
214
|
+
*
|
|
215
|
+
* @syscall $1D
|
|
216
|
+
*/
|
|
217
|
+
void sb_context_restore(void);
|
|
218
|
+
|
|
219
|
+
#endif
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* ------------------------------------------------------------------------
|
|
3
|
+
* 名称:sb2000-text.h
|
|
4
|
+
* 说明:SB-DOS 程序的文字输出:在光标处显示字符串、字符、数字,移动光标,发提示音。
|
|
5
|
+
* 作者:sungbin
|
|
6
|
+
* 邮箱:sungbin@3578.cn
|
|
7
|
+
* 日期:2026-11-11
|
|
8
|
+
* 备注:由 sb2000.h 引入,程序不必单独包含。显示借用 ROM 里 DOS 的运行库,屏幕每行 32 列(列号从 1 起,可用 1-31),
|
|
9
|
+
* 字符码不小于 $A1 的两个字节按 GB2312 显示一个汉字,占 2 列。
|
|
10
|
+
* 字符串必须放在程序自己的窗口里($8000-$BFFF),程序的起始页号要是 4 的倍数(DOS 从 $80 起分配,一般成立);
|
|
11
|
+
* 返回 DOS 后 DOS 会清屏,所以输出完要先等键再返回。
|
|
12
|
+
* ------------------------------------------------------------------------
|
|
13
|
+
*/
|
|
14
|
+
#ifndef SB2000_TEXT_H
|
|
15
|
+
#define SB2000_TEXT_H
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* 从行首显示零结尾字符串并换行。
|
|
19
|
+
* 字符码不小于 0xA1 的两个字节按 GB2312 显示一个汉字。
|
|
20
|
+
*
|
|
21
|
+
* @param s 零结尾的字符串。
|
|
22
|
+
*/
|
|
23
|
+
void __fastcall__ sb_puts(const char *s);
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* 回到行首并换行,行满时自动滚动屏幕。
|
|
27
|
+
*/
|
|
28
|
+
void sb_newline(void);
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* 在光标处显示字符串,光标移到字符串之后,行满时自动换行。
|
|
32
|
+
*
|
|
33
|
+
* @param s 零结尾的字符串。
|
|
34
|
+
*/
|
|
35
|
+
void sb_print(const char *s);
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* 在光标处显示一个字符,光标右移一格。换行符 \n 换行,回车符 \r 回到行首。
|
|
39
|
+
*
|
|
40
|
+
* @param c 字符。
|
|
41
|
+
*/
|
|
42
|
+
void sb_putc(char c);
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* 在光标处显示一个字节的两位十六进制数(大写),光标移到它之后。
|
|
46
|
+
*
|
|
47
|
+
* @param value 要显示的字节。
|
|
48
|
+
*/
|
|
49
|
+
void sb_print_hex(unsigned char value);
|
|
50
|
+
|
|
51
|
+
/**
|
|
52
|
+
* 在光标处显示一个无符号十进制数,光标移到它之后。
|
|
53
|
+
*
|
|
54
|
+
* @param value 要显示的数,0 到 65535。
|
|
55
|
+
*/
|
|
56
|
+
void sb_print_uint(unsigned int value);
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* 光标左移一列,到行首时移到上一行的末尾。
|
|
60
|
+
*/
|
|
61
|
+
void sb_cursor_left(void);
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* 光标右移一列,到第 32 列时回到第 1 列并换行。
|
|
65
|
+
*/
|
|
66
|
+
void sb_cursor_right(void);
|
|
67
|
+
|
|
68
|
+
/**
|
|
69
|
+
* 光标移到上一行的末尾;已在第一行时不动。
|
|
70
|
+
*/
|
|
71
|
+
void sb_cursor_up(void);
|
|
72
|
+
|
|
73
|
+
/**
|
|
74
|
+
* 设置光标所在的列。列号超出 1-31 时不改。
|
|
75
|
+
*
|
|
76
|
+
* @param column 列号,1 到 31。
|
|
77
|
+
*/
|
|
78
|
+
void sb_cursor_set_column(unsigned char column);
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* 取光标所在的列。
|
|
82
|
+
*
|
|
83
|
+
* @return 列号,从 1 起。
|
|
84
|
+
*/
|
|
85
|
+
unsigned char sb_cursor_column(void);
|
|
86
|
+
|
|
87
|
+
/**
|
|
88
|
+
* 取光标所在的显示行。
|
|
89
|
+
*
|
|
90
|
+
* @return 行号,从 0 起。
|
|
91
|
+
*/
|
|
92
|
+
unsigned char sb_cursor_row(void);
|
|
93
|
+
|
|
94
|
+
/**
|
|
95
|
+
* 发一声提示音,用方波通道 2。
|
|
96
|
+
*/
|
|
97
|
+
void sb_beep(void);
|
|
98
|
+
|
|
99
|
+
#endif
|
|
@@ -13,6 +13,19 @@
|
|
|
13
13
|
#define SB2000_H
|
|
14
14
|
|
|
15
15
|
#include "sb2000-symbols.h"
|
|
16
|
+
#include "sb2000-system.h"
|
|
17
|
+
#include "sb2000-memory.h"
|
|
18
|
+
#include "sb2000-bank.h"
|
|
19
|
+
#include "sb2000-text.h"
|
|
20
|
+
#include "sb2000-input.h"
|
|
21
|
+
#include "sb2000-clock.h"
|
|
22
|
+
#include "sb2000-file.h"
|
|
23
|
+
#include "sb2000-disk.h"
|
|
24
|
+
#include "sb2000-display.h"
|
|
25
|
+
#include "sb2000-ime.h"
|
|
26
|
+
#include "sb2000-printer.h"
|
|
27
|
+
#include "sb2000-sound.h"
|
|
28
|
+
#include "sb2000-math.h"
|
|
16
29
|
|
|
17
30
|
/**
|
|
18
31
|
* 读写一个固定地址的字节,如 SB_BYTE_AT(SB_KEY_ASCII)。
|
|
@@ -21,26 +34,6 @@
|
|
|
21
34
|
*/
|
|
22
35
|
#define SB_BYTE_AT(address) (*(volatile unsigned char *)(address))
|
|
23
36
|
|
|
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
37
|
/**
|
|
45
38
|
* 调用系统服务,结果由调用者读各服务规定的变量。
|
|
46
39
|
*
|
|
Binary file
|
|
Binary file
|
|
@@ -0,0 +1,42 @@
|
|
|
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,在栈页(窗口 3)的顶端
|
|
18
|
+
__STACKSTART__: type = weak, value = $C000; # 栈从 $C000 向下增长
|
|
19
|
+
__ZPSTART__: type = weak, value = $0060; # C 运行库的零页
|
|
20
|
+
}
|
|
21
|
+
# 多页程序的链接配置模板:fcdev 按 targetOptions.banks 把 %BANK_MEMORY% 与 %BANK_SEGMENTS% 两行展开成库页 2 到 N。
|
|
22
|
+
# 文件里的页序:0、1 常驻,2 库页 1,3 栈页,4 起库页 2 到 N;各区都填满 4K 页,库页号与页序的换算见 sb-bank-select.c。
|
|
23
|
+
MEMORY {
|
|
24
|
+
ZP: file = "", define = yes, start = __ZPSTART__, size = $0020;
|
|
25
|
+
MAIN: file = %O, start = $8000, size = $2000, fill = yes; # 窗口 0、1
|
|
26
|
+
BANK1: file = %O, start = $A000, size = $1000, fill = yes; # 窗口 2,启动时的库页
|
|
27
|
+
STACK: file = %O, start = $B000, size = $1000, fill = yes; # 窗口 3,C 软件栈所在页,不放程序内容
|
|
28
|
+
%BANK_MEMORY%
|
|
29
|
+
}
|
|
30
|
+
SEGMENTS {
|
|
31
|
+
HEADER: load = MAIN, type = ro;
|
|
32
|
+
ZEROPAGE: load = ZP, type = zp;
|
|
33
|
+
STARTUP: load = MAIN, type = ro;
|
|
34
|
+
LOWCODE: load = MAIN, type = ro, optional = yes;
|
|
35
|
+
ONCE: load = MAIN, type = ro, optional = yes;
|
|
36
|
+
CODE: load = MAIN, type = rw;
|
|
37
|
+
RODATA: load = MAIN, type = rw;
|
|
38
|
+
DATA: load = MAIN, type = rw;
|
|
39
|
+
BSS: load = MAIN, type = bss, define = yes;
|
|
40
|
+
BANK1: load = BANK1, type = ro, optional = yes;
|
|
41
|
+
%BANK_SEGMENTS%
|
|
42
|
+
}
|
|
@@ -1,11 +1,14 @@
|
|
|
1
1
|
; ------------------------------------------------------------------------
|
|
2
2
|
; 名称:crt0.s
|
|
3
|
-
; 说明:SB-DOS
|
|
3
|
+
; 说明:SB-DOS 程序的启动代码:程序文件头,占住窗口的全部 4 页,初始化 C 运行库,调用 main,返回 DOS。
|
|
4
4
|
; 作者:sungbin
|
|
5
5
|
; 邮箱:sungbin@3578.cn
|
|
6
|
-
; 日期:2026-11-
|
|
6
|
+
; 日期:2026-11-11
|
|
7
7
|
; 备注:程序从 $8000 起装入,文件头为 4C lo hi AA 55,偏移 5、6 由 DOS 写成起始页号与页数,偏移 7 保留。
|
|
8
|
-
; C
|
|
8
|
+
; DOS 只按文件大小分配页,而 C 的数据(BSS)与软件栈在 $8000-$BFFF 的 4 个窗口里,文件之外的页没有人占用,
|
|
9
|
+
; 会被页分配服务分给别人,所以启动时把不足 4 页的部分紧接着程序的页再申请下来,返回 DOS 前释放;
|
|
10
|
+
; 申请不到连续的页时以“内存不足”返回 DOS。
|
|
11
|
+
; C 软件栈在窗口的顶端(link.cfg 里的 __STACKSTART__ 与 __STACKSIZE__);
|
|
9
12
|
; C 运行库的零页放在 $0060 起,这段零页在 BIOS 的符号表里没有任何引用,开机到提示符期间也没有写入,所以返回 DOS 前不需要恢复。
|
|
10
13
|
; main 的返回值被忽略,程序总是以 CLC、RTS 返回 DOS。
|
|
11
14
|
; ------------------------------------------------------------------------
|
|
@@ -16,6 +19,10 @@
|
|
|
16
19
|
.import __STACKSTART__ ; 链接器生成
|
|
17
20
|
|
|
18
21
|
.include "zeropage.inc"
|
|
22
|
+
.include "sb2000.inc"
|
|
23
|
+
|
|
24
|
+
; 窗口里的页数:$8000-$BFFF 共 4 个窗口
|
|
25
|
+
WINDOW_PAGES = 4
|
|
19
26
|
|
|
20
27
|
.segment "HEADER"
|
|
21
28
|
|
|
@@ -25,7 +32,13 @@
|
|
|
25
32
|
|
|
26
33
|
.segment "STARTUP"
|
|
27
34
|
|
|
28
|
-
start:
|
|
35
|
+
start: jsr claim_pages
|
|
36
|
+
bcc @ready
|
|
37
|
+
lda #ERR_NO_MEMORY ; 出错码放在 $6308,再带进位返回 DOS
|
|
38
|
+
sta LIB_GROUP
|
|
39
|
+
sec
|
|
40
|
+
rts
|
|
41
|
+
@ready: lda #<__STACKSTART__
|
|
29
42
|
ldx #>__STACKSTART__
|
|
30
43
|
sta c_sp
|
|
31
44
|
stx c_sp+1
|
|
@@ -33,5 +46,77 @@ start: lda #<__STACKSTART__
|
|
|
33
46
|
jsr initlib
|
|
34
47
|
jsr _main
|
|
35
48
|
_exit: jsr donelib
|
|
49
|
+
jsr release_pages
|
|
50
|
+
clc
|
|
51
|
+
rts
|
|
52
|
+
|
|
53
|
+
; 把窗口里文件之外的页申请下来:每次申请 1 页,必须正好是紧接着程序的页,否则释放已申请的并失败
|
|
54
|
+
; 输出:进位清 0 成功,置 1 失败(已释放)
|
|
55
|
+
claim_pages:
|
|
56
|
+
lda PROGRAM_PAGE_COUNT
|
|
57
|
+
cmp #WINDOW_PAGES
|
|
58
|
+
bcs @done
|
|
59
|
+
sta have
|
|
60
|
+
lda #WINDOW_PAGES
|
|
61
|
+
sec
|
|
62
|
+
sbc have
|
|
63
|
+
sta missing
|
|
64
|
+
ldy #$00
|
|
65
|
+
@loop: lda #$01
|
|
66
|
+
sta ALLOC_COUNT
|
|
67
|
+
lda #FN_PAGE
|
|
68
|
+
sta SYS_FUNCTION
|
|
69
|
+
lda #SUB_PAGE_ALLOC
|
|
70
|
+
sta SYS_SUBFUNCTION
|
|
71
|
+
jsr SYSCALL
|
|
72
|
+
lda DOS_ERROR
|
|
73
|
+
bne @fail
|
|
74
|
+
tya ; 预期的页号 = 起始页 + 文件占的页数 + 已申请的页数
|
|
75
|
+
clc
|
|
76
|
+
adc have
|
|
36
77
|
clc
|
|
78
|
+
adc PROGRAM_START_PAGE
|
|
79
|
+
cmp ALLOC_START
|
|
80
|
+
bne @mismatch
|
|
81
|
+
iny
|
|
82
|
+
cpy missing
|
|
83
|
+
bcc @loop
|
|
84
|
+
sty claimed
|
|
85
|
+
@done: clc
|
|
37
86
|
rts
|
|
87
|
+
@mismatch:
|
|
88
|
+
lda #$01 ; 申请到的页位置不对:释放它
|
|
89
|
+
sta ALLOC_COUNT
|
|
90
|
+
lda #FN_PAGE
|
|
91
|
+
sta SYS_FUNCTION
|
|
92
|
+
lda #SUB_PAGE_FREE
|
|
93
|
+
sta SYS_SUBFUNCTION
|
|
94
|
+
jsr SYSCALL
|
|
95
|
+
@fail: sty claimed ; 已申请的 Y 个页交给 release_pages 释放
|
|
96
|
+
jsr release_pages
|
|
97
|
+
sec
|
|
98
|
+
rts
|
|
99
|
+
|
|
100
|
+
; 释放启动时申请的页
|
|
101
|
+
release_pages:
|
|
102
|
+
lda claimed
|
|
103
|
+
beq @done
|
|
104
|
+
sta ALLOC_COUNT
|
|
105
|
+
lda have
|
|
106
|
+
clc
|
|
107
|
+
adc PROGRAM_START_PAGE
|
|
108
|
+
sta ALLOC_START
|
|
109
|
+
lda #FN_PAGE
|
|
110
|
+
sta SYS_FUNCTION
|
|
111
|
+
lda #SUB_PAGE_FREE
|
|
112
|
+
sta SYS_SUBFUNCTION
|
|
113
|
+
jsr SYSCALL
|
|
114
|
+
lda #$00
|
|
115
|
+
sta claimed
|
|
116
|
+
@done: rts
|
|
117
|
+
|
|
118
|
+
.segment "DATA"
|
|
119
|
+
|
|
120
|
+
have: .byte $00 ; DOS 按文件大小给程序的页数
|
|
121
|
+
missing: .byte $00 ; 还差的页数
|
|
122
|
+
claimed: .byte $00 ; 已申请下来的页数
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* ------------------------------------------------------------------------
|
|
3
|
+
* 名称:sb-bank-current.c
|
|
4
|
+
* 说明:sb_bank_current 的实现:取窗口 2 当前的库页号。
|
|
5
|
+
* 作者:sungbin
|
|
6
|
+
* 邮箱:sungbin@3578.cn
|
|
7
|
+
* 日期:2026-11-11
|
|
8
|
+
* 备注:库页号由 sb_bank_select 与调用蹦床维护,见 sb-bank-select.c。
|
|
9
|
+
* ------------------------------------------------------------------------
|
|
10
|
+
*/
|
|
11
|
+
#include "../sb-internal.h"
|
|
12
|
+
|
|
13
|
+
extern unsigned char sbi_bank_current;
|
|
14
|
+
|
|
15
|
+
unsigned char sb_bank_current(void)
|
|
16
|
+
{
|
|
17
|
+
return sbi_bank_current;
|
|
18
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* ------------------------------------------------------------------------
|
|
3
|
+
* 名称:sb-bank-select.c
|
|
4
|
+
* 说明:sb_bank_select 的实现:把一个库页换进窗口 2。
|
|
5
|
+
* 作者:sungbin
|
|
6
|
+
* 邮箱:sungbin@3578.cn
|
|
7
|
+
* 日期:2026-11-11
|
|
8
|
+
* 备注:库页 1 是程序文件的第 2 页,第 3 页是栈页,库页 n(n 不小于 2)是第 n+2 页;窗口 2 的页号 = 程序起始页 + 文件里的页序号。
|
|
9
|
+
* sbi_bank_current 记着窗口 2 当前的库页,程序启动时窗口 2 里就是库页 1。
|
|
10
|
+
* ------------------------------------------------------------------------
|
|
11
|
+
*/
|
|
12
|
+
#include "../sb-internal.h"
|
|
13
|
+
|
|
14
|
+
/** 窗口 2 当前的库页号,调用蹦床与 sb_bank_current 也读它 */
|
|
15
|
+
unsigned char sbi_bank_current = 1;
|
|
16
|
+
|
|
17
|
+
void sb_bank_select(unsigned char bank)
|
|
18
|
+
{
|
|
19
|
+
sbi_bank_current = bank;
|
|
20
|
+
sb_window_map(2, SB_BYTE_AT(SB_PROGRAM_START_PAGE) + (bank == 1 ? 2 : bank + 2));
|
|
21
|
+
}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
; ------------------------------------------------------------------------
|
|
2
|
+
; 名称:sbi-bank-trampoline.s
|
|
3
|
+
; 说明:库内部的汇编小例程:库页函数的调用蹦床,换入函数所在的库页,调用函数,返回后换回原来的库页。
|
|
4
|
+
; 作者:sungbin
|
|
5
|
+
; 邮箱:sungbin@3578.cn
|
|
6
|
+
; 日期:2026-11-11
|
|
7
|
+
; 备注:供 cc65 的 #pragma wrapped-call 使用:编译器在每次直接调用库页函数时,把库页号放进 tmp4、函数地址放进 ptr4,再 JSR 到本例程;
|
|
8
|
+
; 函数的参数(最后一个在 A、X,其余在 C 软件栈)原样传给函数,返回值原样带回。
|
|
9
|
+
; 原来的库页压在硬件栈里,所以库页函数之间可以嵌套调用;函数指针调用和变参函数不经过蹦床。
|
|
10
|
+
; ------------------------------------------------------------------------
|
|
11
|
+
.export _sbi_bank_trampoline
|
|
12
|
+
.import _sb_bank_select, _sbi_bank_current
|
|
13
|
+
|
|
14
|
+
.include "zeropage.inc"
|
|
15
|
+
|
|
16
|
+
.code
|
|
17
|
+
|
|
18
|
+
_sbi_bank_trampoline:
|
|
19
|
+
sta value ; 参数(或上一步的返回值)暂存,换页时会被改写
|
|
20
|
+
stx value+1
|
|
21
|
+
lda ptr4
|
|
22
|
+
sta target
|
|
23
|
+
lda ptr4+1
|
|
24
|
+
sta target+1
|
|
25
|
+
lda _sbi_bank_current
|
|
26
|
+
pha ; 原来的库页
|
|
27
|
+
lda tmp4
|
|
28
|
+
jsr _sb_bank_select
|
|
29
|
+
lda value
|
|
30
|
+
ldx value+1
|
|
31
|
+
jsr call
|
|
32
|
+
sta value ; 函数的返回值
|
|
33
|
+
stx value+1
|
|
34
|
+
pla
|
|
35
|
+
jsr _sb_bank_select
|
|
36
|
+
lda value
|
|
37
|
+
ldx value+1
|
|
38
|
+
rts
|
|
39
|
+
|
|
40
|
+
call: jmp (target)
|
|
41
|
+
|
|
42
|
+
.bss
|
|
43
|
+
|
|
44
|
+
.align 2 ; 间接跳转不能跨页读地址,保证 target 不落在页尾
|
|
45
|
+
target: .res 2
|
|
46
|
+
value: .res 2
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* ------------------------------------------------------------------------
|
|
3
|
+
* 名称:sb-clock-get-date.c
|
|
4
|
+
* 说明:sb_clock_get_date 的实现:取系统日期。
|
|
5
|
+
* 作者:sungbin
|
|
6
|
+
* 邮箱:sungbin@3578.cn
|
|
7
|
+
* 日期:2026-11-11
|
|
8
|
+
* 备注:功能 $7F 子功能 2,日期以 FAT 格式放在 FILE_DATE。
|
|
9
|
+
* ------------------------------------------------------------------------
|
|
10
|
+
*/
|
|
11
|
+
#include "../sb-internal.h"
|
|
12
|
+
|
|
13
|
+
void sb_clock_get_date(sb_date_t *date)
|
|
14
|
+
{
|
|
15
|
+
sb_syscall(SB_FN_CLOCK, SB_SUB_CLOCK_GET_DATE);
|
|
16
|
+
sbi_date_from_fat(date);
|
|
17
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* ------------------------------------------------------------------------
|
|
3
|
+
* 名称:sb-clock-get-time.c
|
|
4
|
+
* 说明:sb_clock_get_time 的实现:取系统时间。
|
|
5
|
+
* 作者:sungbin
|
|
6
|
+
* 邮箱:sungbin@3578.cn
|
|
7
|
+
* 日期:2026-11-11
|
|
8
|
+
* 备注:功能 $7F 子功能 4,时间以 FAT 格式放在 FILE_TIME。
|
|
9
|
+
* ------------------------------------------------------------------------
|
|
10
|
+
*/
|
|
11
|
+
#include "../sb-internal.h"
|
|
12
|
+
|
|
13
|
+
void sb_clock_get_time(sb_time_t *time)
|
|
14
|
+
{
|
|
15
|
+
sb_syscall(SB_FN_CLOCK, SB_SUB_CLOCK_GET_TIME);
|
|
16
|
+
sbi_time_from_fat(time);
|
|
17
|
+
}
|