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.
Files changed (71) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +81 -2
  3. package/bin/fcdev.mjs +17 -0
  4. package/package.json +38 -4
  5. package/src/build/build-plan.mjs +92 -0
  6. package/src/build/dependency-file.mjs +24 -0
  7. package/src/build/disk-builder.mjs +36 -0
  8. package/src/build/index.mjs +31 -0
  9. package/src/build/program-builder.mjs +209 -0
  10. package/src/build/source-collector.mjs +54 -0
  11. package/src/build/tool-arguments.mjs +83 -0
  12. package/src/cli/args-parser.mjs +84 -0
  13. package/src/cli/commands/build-command.mjs +34 -0
  14. package/src/cli/commands/debug-command.mjs +70 -0
  15. package/src/cli/commands/disasm-command.mjs +65 -0
  16. package/src/cli/commands/disk-command.mjs +34 -0
  17. package/src/cli/commands/info-command.mjs +33 -0
  18. package/src/cli/commands/project-info.mjs +57 -0
  19. package/src/cli/commands/run-command.mjs +68 -0
  20. package/src/cli/commands/sync-command.mjs +85 -0
  21. package/src/cli/index.mjs +100 -0
  22. package/src/config/config-loader.mjs +132 -0
  23. package/src/config/index.mjs +9 -0
  24. package/src/disasm/analysis.mjs +97 -0
  25. package/src/disasm/cdl.mjs +35 -0
  26. package/src/disasm/disassembler.mjs +114 -0
  27. package/src/disasm/index.mjs +16 -0
  28. package/src/disasm/info-writer.mjs +72 -0
  29. package/src/disasm/loaders.mjs +69 -0
  30. package/src/disasm/opcode-table.mjs +268 -0
  31. package/src/disasm/roundtrip.mjs +69 -0
  32. package/src/disasm/symbols.mjs +30 -0
  33. package/src/disasm/trace.mjs +25 -0
  34. package/src/emulator/debug-client.mjs +125 -0
  35. package/src/emulator/emulator-launcher.mjs +80 -0
  36. package/src/emulator/emulator-locator.mjs +62 -0
  37. package/src/emulator/index.mjs +11 -0
  38. package/src/packagers/fat-floppy.mjs +22 -0
  39. package/src/packagers/fat12-image.mjs +245 -0
  40. package/src/packagers/flat-binary.mjs +53 -0
  41. package/src/packagers/index.mjs +54 -0
  42. package/src/packagers/ines.mjs +38 -0
  43. package/src/shared/errors.mjs +25 -0
  44. package/src/shared/fs-utils.mjs +66 -0
  45. package/src/shared/index.mjs +11 -0
  46. package/src/shared/process.mjs +50 -0
  47. package/src/targets/index.mjs +17 -0
  48. package/src/targets/name-rules.mjs +33 -0
  49. package/src/targets/target-registry.mjs +187 -0
  50. package/src/toolchain/index.mjs +16 -0
  51. package/src/toolchain/toolchain-locator.mjs +104 -0
  52. package/targets/nes/asminc/fcnes.inc +16 -0
  53. package/targets/nes/chr/ascii-8x8.chr +0 -0
  54. package/targets/nes/chr/font8x8_basic.h +152 -0
  55. package/targets/nes/include/fcnes.h +45 -0
  56. package/targets/nes/lib/fcnes.lib +0 -0
  57. package/targets/nes/lib/nes-font.o +0 -0
  58. package/targets/nes/lib-build.json +9 -0
  59. package/targets/nes/src/fcnes.s +91 -0
  60. package/targets/nes/src/nes-font.s +12 -0
  61. package/targets/nes/target.json +27 -0
  62. package/targets/sb2000/asminc/sb2000.inc +216 -0
  63. package/targets/sb2000/include/sb2000-symbols.h +380 -0
  64. package/targets/sb2000/include/sb2000.h +52 -0
  65. package/targets/sb2000/lib/crt0.o +0 -0
  66. package/targets/sb2000/lib/sb2000.lib +0 -0
  67. package/targets/sb2000/lib-build.json +8 -0
  68. package/targets/sb2000/link.cfg +35 -0
  69. package/targets/sb2000/src/crt0.s +37 -0
  70. package/targets/sb2000/src/sb2000.s +67 -0
  71. package/targets/sb2000/target.json +28 -0
@@ -0,0 +1,152 @@
1
+ /**
2
+ * 8x8 monochrome bitmap fonts for rendering
3
+ * Author: Daniel Hepper <daniel@hepper.net>
4
+ *
5
+ * License: Public Domain
6
+ *
7
+ * Based on:
8
+ * // Summary: font8x8.h
9
+ * // 8x8 monochrome bitmap fonts for rendering
10
+ * //
11
+ * // Author:
12
+ * // Marcel Sondaar
13
+ * // International Business Machines (public domain VGA fonts)
14
+ * //
15
+ * // License:
16
+ * // Public Domain
17
+ *
18
+ * Fetched from: http://dimensionalrift.homelinux.net/combuster/mos3/?p=viewsource&file=/modules/gfx/font8_8.asm
19
+ **/
20
+
21
+ // Constant: font8x8_basic
22
+ // Contains an 8x8 font map for unicode points U+0000 - U+007F (basic latin)
23
+ char font8x8_basic[128][8] = {
24
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0000 (nul)
25
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0001
26
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0002
27
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0003
28
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0004
29
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0005
30
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0006
31
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0007
32
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0008
33
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0009
34
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+000A
35
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+000B
36
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+000C
37
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+000D
38
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+000E
39
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+000F
40
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0010
41
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0011
42
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0012
43
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0013
44
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0014
45
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0015
46
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0016
47
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0017
48
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0018
49
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0019
50
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+001A
51
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+001B
52
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+001C
53
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+001D
54
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+001E
55
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+001F
56
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0020 (space)
57
+ { 0x18, 0x3C, 0x3C, 0x18, 0x18, 0x00, 0x18, 0x00}, // U+0021 (!)
58
+ { 0x36, 0x36, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0022 (")
59
+ { 0x36, 0x36, 0x7F, 0x36, 0x7F, 0x36, 0x36, 0x00}, // U+0023 (#)
60
+ { 0x0C, 0x3E, 0x03, 0x1E, 0x30, 0x1F, 0x0C, 0x00}, // U+0024 ($)
61
+ { 0x00, 0x63, 0x33, 0x18, 0x0C, 0x66, 0x63, 0x00}, // U+0025 (%)
62
+ { 0x1C, 0x36, 0x1C, 0x6E, 0x3B, 0x33, 0x6E, 0x00}, // U+0026 (&)
63
+ { 0x06, 0x06, 0x03, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0027 (')
64
+ { 0x18, 0x0C, 0x06, 0x06, 0x06, 0x0C, 0x18, 0x00}, // U+0028 (()
65
+ { 0x06, 0x0C, 0x18, 0x18, 0x18, 0x0C, 0x06, 0x00}, // U+0029 ())
66
+ { 0x00, 0x66, 0x3C, 0xFF, 0x3C, 0x66, 0x00, 0x00}, // U+002A (*)
67
+ { 0x00, 0x0C, 0x0C, 0x3F, 0x0C, 0x0C, 0x00, 0x00}, // U+002B (+)
68
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x0C, 0x0C, 0x06}, // U+002C (,)
69
+ { 0x00, 0x00, 0x00, 0x3F, 0x00, 0x00, 0x00, 0x00}, // U+002D (-)
70
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x0C, 0x0C, 0x00}, // U+002E (.)
71
+ { 0x60, 0x30, 0x18, 0x0C, 0x06, 0x03, 0x01, 0x00}, // U+002F (/)
72
+ { 0x3E, 0x63, 0x73, 0x7B, 0x6F, 0x67, 0x3E, 0x00}, // U+0030 (0)
73
+ { 0x0C, 0x0E, 0x0C, 0x0C, 0x0C, 0x0C, 0x3F, 0x00}, // U+0031 (1)
74
+ { 0x1E, 0x33, 0x30, 0x1C, 0x06, 0x33, 0x3F, 0x00}, // U+0032 (2)
75
+ { 0x1E, 0x33, 0x30, 0x1C, 0x30, 0x33, 0x1E, 0x00}, // U+0033 (3)
76
+ { 0x38, 0x3C, 0x36, 0x33, 0x7F, 0x30, 0x78, 0x00}, // U+0034 (4)
77
+ { 0x3F, 0x03, 0x1F, 0x30, 0x30, 0x33, 0x1E, 0x00}, // U+0035 (5)
78
+ { 0x1C, 0x06, 0x03, 0x1F, 0x33, 0x33, 0x1E, 0x00}, // U+0036 (6)
79
+ { 0x3F, 0x33, 0x30, 0x18, 0x0C, 0x0C, 0x0C, 0x00}, // U+0037 (7)
80
+ { 0x1E, 0x33, 0x33, 0x1E, 0x33, 0x33, 0x1E, 0x00}, // U+0038 (8)
81
+ { 0x1E, 0x33, 0x33, 0x3E, 0x30, 0x18, 0x0E, 0x00}, // U+0039 (9)
82
+ { 0x00, 0x0C, 0x0C, 0x00, 0x00, 0x0C, 0x0C, 0x00}, // U+003A (:)
83
+ { 0x00, 0x0C, 0x0C, 0x00, 0x00, 0x0C, 0x0C, 0x06}, // U+003B (;)
84
+ { 0x18, 0x0C, 0x06, 0x03, 0x06, 0x0C, 0x18, 0x00}, // U+003C (<)
85
+ { 0x00, 0x00, 0x3F, 0x00, 0x00, 0x3F, 0x00, 0x00}, // U+003D (=)
86
+ { 0x06, 0x0C, 0x18, 0x30, 0x18, 0x0C, 0x06, 0x00}, // U+003E (>)
87
+ { 0x1E, 0x33, 0x30, 0x18, 0x0C, 0x00, 0x0C, 0x00}, // U+003F (?)
88
+ { 0x3E, 0x63, 0x7B, 0x7B, 0x7B, 0x03, 0x1E, 0x00}, // U+0040 (@)
89
+ { 0x0C, 0x1E, 0x33, 0x33, 0x3F, 0x33, 0x33, 0x00}, // U+0041 (A)
90
+ { 0x3F, 0x66, 0x66, 0x3E, 0x66, 0x66, 0x3F, 0x00}, // U+0042 (B)
91
+ { 0x3C, 0x66, 0x03, 0x03, 0x03, 0x66, 0x3C, 0x00}, // U+0043 (C)
92
+ { 0x1F, 0x36, 0x66, 0x66, 0x66, 0x36, 0x1F, 0x00}, // U+0044 (D)
93
+ { 0x7F, 0x46, 0x16, 0x1E, 0x16, 0x46, 0x7F, 0x00}, // U+0045 (E)
94
+ { 0x7F, 0x46, 0x16, 0x1E, 0x16, 0x06, 0x0F, 0x00}, // U+0046 (F)
95
+ { 0x3C, 0x66, 0x03, 0x03, 0x73, 0x66, 0x7C, 0x00}, // U+0047 (G)
96
+ { 0x33, 0x33, 0x33, 0x3F, 0x33, 0x33, 0x33, 0x00}, // U+0048 (H)
97
+ { 0x1E, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0x1E, 0x00}, // U+0049 (I)
98
+ { 0x78, 0x30, 0x30, 0x30, 0x33, 0x33, 0x1E, 0x00}, // U+004A (J)
99
+ { 0x67, 0x66, 0x36, 0x1E, 0x36, 0x66, 0x67, 0x00}, // U+004B (K)
100
+ { 0x0F, 0x06, 0x06, 0x06, 0x46, 0x66, 0x7F, 0x00}, // U+004C (L)
101
+ { 0x63, 0x77, 0x7F, 0x7F, 0x6B, 0x63, 0x63, 0x00}, // U+004D (M)
102
+ { 0x63, 0x67, 0x6F, 0x7B, 0x73, 0x63, 0x63, 0x00}, // U+004E (N)
103
+ { 0x1C, 0x36, 0x63, 0x63, 0x63, 0x36, 0x1C, 0x00}, // U+004F (O)
104
+ { 0x3F, 0x66, 0x66, 0x3E, 0x06, 0x06, 0x0F, 0x00}, // U+0050 (P)
105
+ { 0x1E, 0x33, 0x33, 0x33, 0x3B, 0x1E, 0x38, 0x00}, // U+0051 (Q)
106
+ { 0x3F, 0x66, 0x66, 0x3E, 0x36, 0x66, 0x67, 0x00}, // U+0052 (R)
107
+ { 0x1E, 0x33, 0x07, 0x0E, 0x38, 0x33, 0x1E, 0x00}, // U+0053 (S)
108
+ { 0x3F, 0x2D, 0x0C, 0x0C, 0x0C, 0x0C, 0x1E, 0x00}, // U+0054 (T)
109
+ { 0x33, 0x33, 0x33, 0x33, 0x33, 0x33, 0x3F, 0x00}, // U+0055 (U)
110
+ { 0x33, 0x33, 0x33, 0x33, 0x33, 0x1E, 0x0C, 0x00}, // U+0056 (V)
111
+ { 0x63, 0x63, 0x63, 0x6B, 0x7F, 0x77, 0x63, 0x00}, // U+0057 (W)
112
+ { 0x63, 0x63, 0x36, 0x1C, 0x1C, 0x36, 0x63, 0x00}, // U+0058 (X)
113
+ { 0x33, 0x33, 0x33, 0x1E, 0x0C, 0x0C, 0x1E, 0x00}, // U+0059 (Y)
114
+ { 0x7F, 0x63, 0x31, 0x18, 0x4C, 0x66, 0x7F, 0x00}, // U+005A (Z)
115
+ { 0x1E, 0x06, 0x06, 0x06, 0x06, 0x06, 0x1E, 0x00}, // U+005B ([)
116
+ { 0x03, 0x06, 0x0C, 0x18, 0x30, 0x60, 0x40, 0x00}, // U+005C (\)
117
+ { 0x1E, 0x18, 0x18, 0x18, 0x18, 0x18, 0x1E, 0x00}, // U+005D (])
118
+ { 0x08, 0x1C, 0x36, 0x63, 0x00, 0x00, 0x00, 0x00}, // U+005E (^)
119
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFF}, // U+005F (_)
120
+ { 0x0C, 0x0C, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+0060 (`)
121
+ { 0x00, 0x00, 0x1E, 0x30, 0x3E, 0x33, 0x6E, 0x00}, // U+0061 (a)
122
+ { 0x07, 0x06, 0x06, 0x3E, 0x66, 0x66, 0x3B, 0x00}, // U+0062 (b)
123
+ { 0x00, 0x00, 0x1E, 0x33, 0x03, 0x33, 0x1E, 0x00}, // U+0063 (c)
124
+ { 0x38, 0x30, 0x30, 0x3e, 0x33, 0x33, 0x6E, 0x00}, // U+0064 (d)
125
+ { 0x00, 0x00, 0x1E, 0x33, 0x3f, 0x03, 0x1E, 0x00}, // U+0065 (e)
126
+ { 0x1C, 0x36, 0x06, 0x0f, 0x06, 0x06, 0x0F, 0x00}, // U+0066 (f)
127
+ { 0x00, 0x00, 0x6E, 0x33, 0x33, 0x3E, 0x30, 0x1F}, // U+0067 (g)
128
+ { 0x07, 0x06, 0x36, 0x6E, 0x66, 0x66, 0x67, 0x00}, // U+0068 (h)
129
+ { 0x0C, 0x00, 0x0E, 0x0C, 0x0C, 0x0C, 0x1E, 0x00}, // U+0069 (i)
130
+ { 0x30, 0x00, 0x30, 0x30, 0x30, 0x33, 0x33, 0x1E}, // U+006A (j)
131
+ { 0x07, 0x06, 0x66, 0x36, 0x1E, 0x36, 0x67, 0x00}, // U+006B (k)
132
+ { 0x0E, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0x1E, 0x00}, // U+006C (l)
133
+ { 0x00, 0x00, 0x33, 0x7F, 0x7F, 0x6B, 0x63, 0x00}, // U+006D (m)
134
+ { 0x00, 0x00, 0x1F, 0x33, 0x33, 0x33, 0x33, 0x00}, // U+006E (n)
135
+ { 0x00, 0x00, 0x1E, 0x33, 0x33, 0x33, 0x1E, 0x00}, // U+006F (o)
136
+ { 0x00, 0x00, 0x3B, 0x66, 0x66, 0x3E, 0x06, 0x0F}, // U+0070 (p)
137
+ { 0x00, 0x00, 0x6E, 0x33, 0x33, 0x3E, 0x30, 0x78}, // U+0071 (q)
138
+ { 0x00, 0x00, 0x3B, 0x6E, 0x66, 0x06, 0x0F, 0x00}, // U+0072 (r)
139
+ { 0x00, 0x00, 0x3E, 0x03, 0x1E, 0x30, 0x1F, 0x00}, // U+0073 (s)
140
+ { 0x08, 0x0C, 0x3E, 0x0C, 0x0C, 0x2C, 0x18, 0x00}, // U+0074 (t)
141
+ { 0x00, 0x00, 0x33, 0x33, 0x33, 0x33, 0x6E, 0x00}, // U+0075 (u)
142
+ { 0x00, 0x00, 0x33, 0x33, 0x33, 0x1E, 0x0C, 0x00}, // U+0076 (v)
143
+ { 0x00, 0x00, 0x63, 0x6B, 0x7F, 0x7F, 0x36, 0x00}, // U+0077 (w)
144
+ { 0x00, 0x00, 0x63, 0x36, 0x1C, 0x36, 0x63, 0x00}, // U+0078 (x)
145
+ { 0x00, 0x00, 0x33, 0x33, 0x33, 0x3E, 0x30, 0x1F}, // U+0079 (y)
146
+ { 0x00, 0x00, 0x3F, 0x19, 0x0C, 0x26, 0x3F, 0x00}, // U+007A (z)
147
+ { 0x38, 0x0C, 0x0C, 0x07, 0x0C, 0x0C, 0x38, 0x00}, // U+007B ({)
148
+ { 0x18, 0x18, 0x18, 0x00, 0x18, 0x18, 0x18, 0x00}, // U+007C (|)
149
+ { 0x07, 0x0C, 0x0C, 0x38, 0x0C, 0x0C, 0x07, 0x00}, // U+007D (})
150
+ { 0x6E, 0x3B, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // U+007E (~)
151
+ { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00} // U+007F
152
+ };
@@ -0,0 +1,45 @@
1
+ /*
2
+ * ------------------------------------------------------------------------
3
+ * 名称:fcnes.h
4
+ * 说明:fcdev 的 NES 辅助函数:画面开关、调色板、文字显示、等待垂直消隐。
5
+ * 作者:sungbin
6
+ * 邮箱:sungbin@3578.cn
7
+ * 日期:2026-11-10
8
+ * 备注:文字用 ASCII 字库(图块号等于字符码),背景图案表为 $0000;画面关闭时才能写显存。
9
+ * ------------------------------------------------------------------------
10
+ */
11
+ #ifndef FCNES_H
12
+ #define FCNES_H
13
+
14
+ /**
15
+ * 关闭画面,之后可以写显存。
16
+ */
17
+ void nes_screen_off(void);
18
+
19
+ /**
20
+ * 打开背景显示,并把滚动位置复位到 (0, 0)。
21
+ */
22
+ void nes_screen_on(void);
23
+
24
+ /**
25
+ * 写入 32 字节调色板:前 16 字节为背景,后 16 字节为精灵。
26
+ *
27
+ * @param colors 32 字节的颜色表。
28
+ */
29
+ void __fastcall__ nes_set_palette(const unsigned char *colors);
30
+
31
+ /**
32
+ * 在名称表的指定位置写零结尾字符串,要先关闭画面。
33
+ *
34
+ * @param x 列,0 到 31。
35
+ * @param y 行,0 到 29。
36
+ * @param s 零结尾的字符串。
37
+ */
38
+ void __fastcall__ nes_print(unsigned char x, unsigned char y, const char *s);
39
+
40
+ /**
41
+ * 等待下一次垂直消隐开始。
42
+ */
43
+ void nes_wait_vblank(void);
44
+
45
+ #endif
Binary file
Binary file
@@ -0,0 +1,9 @@
1
+ {
2
+ "libraries": {
3
+ "lib/fcnes.lib": ["src/fcnes.s"]
4
+ },
5
+ "objects": {
6
+ "lib/nes-font.o": "src/nes-font.s"
7
+ },
8
+ "binIncludeDirs": ["chr"]
9
+ }
@@ -0,0 +1,91 @@
1
+ ; ------------------------------------------------------------------------
2
+ ; 名称:fcnes.s
3
+ ; 说明:fcnes.h 里各函数的实现:画面开关、调色板、文字显示、等待垂直消隐。
4
+ ; 作者:sungbin
5
+ ; 邮箱:sungbin@3578.cn
6
+ ; 日期:2026-11-10
7
+ ; 备注:C 调用约定为 cc65 的 fastcall:最后一个参数在 A(低字节)与 X(高字节),其余参数在 C 栈上,由被调用者弹出。
8
+ ; ------------------------------------------------------------------------
9
+ .include "fcnes.inc"
10
+ .export _nes_screen_off, _nes_screen_on, _nes_set_palette, _nes_print, _nes_wait_vblank
11
+ .import popa
12
+ .importzp ptr1, tmp1, tmp2
13
+
14
+ ; 背景与精灵都显示,包括最左 8 列
15
+ SHOW_ALL = $1E
16
+
17
+ .code
18
+
19
+ ; void nes_screen_off(void)
20
+ _nes_screen_off:
21
+ lda #0
22
+ sta PPUMASK
23
+ rts
24
+
25
+ ; void nes_screen_on(void):先复位滚动,再打开显示
26
+ _nes_screen_on:
27
+ lda PPUSTATUS
28
+ lda #0
29
+ sta PPUSCROLL
30
+ sta PPUSCROLL
31
+ sta PPUCTRL
32
+ lda #SHOW_ALL
33
+ sta PPUMASK
34
+ rts
35
+
36
+ ; void nes_set_palette(const unsigned char *colors):把 32 字节写到 $3F00
37
+ _nes_set_palette:
38
+ sta ptr1
39
+ stx ptr1+1
40
+ lda PPUSTATUS
41
+ lda #$3F
42
+ sta PPUADDR
43
+ lda #$00
44
+ sta PPUADDR
45
+ ldy #0
46
+ @loop: lda (ptr1),y
47
+ sta PPUDATA
48
+ iny
49
+ cpy #32
50
+ bne @loop
51
+ rts
52
+
53
+ ; void nes_print(unsigned char x, unsigned char y, const char *s)
54
+ ; 名称表地址 = $2000 + y*32 + x
55
+ _nes_print:
56
+ sta ptr1
57
+ stx ptr1+1
58
+ jsr popa
59
+ sta tmp1 ; y
60
+ jsr popa
61
+ sta tmp2 ; x
62
+ lda PPUSTATUS
63
+ lda tmp1
64
+ lsr a
65
+ lsr a
66
+ lsr a
67
+ clc
68
+ adc #$20
69
+ sta PPUADDR ; 高字节:$20 加上 y 除以 8
70
+ lda tmp1
71
+ and #$07
72
+ asl a
73
+ asl a
74
+ asl a
75
+ asl a
76
+ asl a
77
+ ora tmp2
78
+ sta PPUADDR ; 低字节:y 的低 3 位乘 32 再加 x
79
+ ldy #0
80
+ @next: lda (ptr1),y
81
+ beq @done
82
+ sta PPUDATA
83
+ iny
84
+ bne @next
85
+ @done: rts
86
+
87
+ ; void nes_wait_vblank(void)
88
+ _nes_wait_vblank:
89
+ @wait: bit PPUSTATUS
90
+ bpl @wait
91
+ rts
@@ -0,0 +1,12 @@
1
+ ; ------------------------------------------------------------------------
2
+ ; 名称:nes-font.s
3
+ ; 说明:把 ASCII 字库放进 CHR 图块:图块号等于字符码,$20 之前的 32 个图块空着。
4
+ ; 作者:sungbin
5
+ ; 邮箱:sungbin@3578.cn
6
+ ; 日期:2026-11-10
7
+ ; 备注:字库数据来自公有领域的 font8x8_basic(Daniel Hepper,原文件在 chr/font8x8_basic.h),已转成 chr/ascii-8x8.chr;目标选项 font 为 true 时链接本文件。
8
+ ; ------------------------------------------------------------------------
9
+ .segment "CHARS"
10
+
11
+ .res $200, $00
12
+ .incbin "ascii-8x8.chr"
@@ -0,0 +1,27 @@
1
+ {
2
+ "name": "nes",
3
+ "title": "任天堂红白机(NES)",
4
+ "cpu": "6502",
5
+ "cc65Target": "nes",
6
+ "linkConfig": "toolchain:cfg/nes.cfg",
7
+ "startup": [],
8
+ "forceImports": ["__STARTUP__"],
9
+ "libraries": ["lib/fcnes.lib", "toolchain:lib/nes.lib"],
10
+ "include": ["include"],
11
+ "asminclude": ["asminc"],
12
+ "defines": {},
13
+ "packager": "ines",
14
+ "extension": ".nes",
15
+ "nameRule": null,
16
+ "run": {
17
+ "emulator": "virtuanes",
18
+ "mode": "rom"
19
+ },
20
+ "options": {
21
+ "font": {
22
+ "type": "boolean",
23
+ "default": true,
24
+ "links": ["lib/nes-font.o"]
25
+ }
26
+ }
27
+ }
@@ -0,0 +1,216 @@
1
+ ; ------------------------------------------------------------------------
2
+ ; 名称:sb2000.inc
3
+ ; 说明:SB-DOS 程序接口的符号定义:系统调用变量、功能号、子功能号、出错码、文件打开方式、运行库入口,便于直接用名字写程序。
4
+ ; 作者:sungbin
5
+ ; 邮箱:sungbin@3578.cn
6
+ ; 日期:2026-11-10
7
+ ; 备注:ca65 程序用 .include "sb2000.inc" 引入,只含符号定义,不占空间;值不超过 $FF 的符号汇编时按零页寻址。
8
+ ; C 程序用的常量由 tools/gen-sb2000-header.mjs 从本文件生成到 include/sb2000-symbols.h,改本文件后要重新生成。
9
+ ; ------------------------------------------------------------------------
10
+
11
+ ; ---- 系统调用:JSR SYSCALL,功能号写 SYS_FUNCTION ----
12
+ SYSCALL = $FFF0 ; 系统调用入口,JSR 到这里
13
+ SYS_FUNCTION = $063E ; 功能号,调用前写入
14
+ SYS_SUBFUNCTION = $063F ; 子功能号,有子功能的服务才用
15
+ SYS_STATUS = $0640 ; 状态,调用开头清 0,子功能越界时为 $FF
16
+ SYS_PAGE = $0641 ; 页号:功能 $29 要映射的页,或远指针的页
17
+ SYS_GROUP = $0642 ; 页组的首页号,连续 4 页
18
+ SYS_WINDOW = $0653 ; 窗口号 0-3,功能 $29 用
19
+
20
+ ; ---- 零页:系统调用与运行库使用的单元 ----
21
+ PROG_ENTRY_LO = $0C ; 调用地址低字节,功能 $25、$26 用
22
+ PROG_ENTRY_HI = $0D ; 调用地址高字节
23
+ FAR_OFFSET_LO = $14 ; 远指针的页内偏移低字节
24
+ FAR_OFFSET_HI = $15 ; 远指针的页内偏移高字节
25
+ STR_PTR_LO = $4B ; 字符串地址低字节,LIB_PRINT_STRING 用
26
+ STR_PTR_HI = $4C ; 字符串地址高字节
27
+
28
+ ; ---- 不经 SYSCALL、直接 JSR 的内核入口 ----
29
+ FAR_COPY_IN = $FFEA ; 把页组窗口地址处的数据复制到 $0700 缓冲
30
+ FAR_COPY_OUT = $FFED ; 把 $0700 缓冲的数据复制到页组窗口地址
31
+ FAR_READ_BYTE = $FFF3 ; 读远指针加 Y 处的一个字节,结果在 A
32
+ FAR_WRITE_BYTE = $FFF6 ; 把 A 写到远指针加 Y 处
33
+
34
+ ; ---- 功能号(写入 SYS_FUNCTION)----
35
+ FN_PPU_CONTROL = $12 ; 画面控制:开关 NMI 及其中的各项服务
36
+ FN_IRQ_MASK = $13 ; 中断屏蔽:允许或屏蔽各中断源
37
+ FN_MOUSE_RESET = $14 ; 鼠标复位,是否接入放在 $0633
38
+ FN_WAIT_FRAMES = $1B ; 等待 X 个垂直消隐周期(帧)
39
+ FN_SAVE_CONTEXT = $1C ; 保存上下文,类似 setjmp
40
+ FN_RESTORE_CONTEXT = $1D ; 恢复上下文并跳转,不返回,类似 longjmp
41
+ FN_FAR_READ_NEXT = $24 ; 按远指针读一个字节到 $0653,指针后移
42
+ FN_CALL_BANKED = $25 ; 映射页组并调用 PROG_ENTRY 处的例程
43
+ FN_JUMP_BANKED = $26 ; 同上,但直接跳转,不再返回
44
+ FN_MAP_WINDOW = $29 ; 把页 SYS_PAGE 映射到窗口 SYS_WINDOW
45
+ FN_ADDR_TO_FAR = $2C ; 把窗口地址换算成远指针
46
+ FN_SOUND = $65 ; 声音服务
47
+ FN_INPUT = $6B ; 键盘输入服务
48
+ FN_MOUSE = $6C ; 鼠标服务
49
+ FN_GAMEPAD = $6A ; 手柄服务
50
+ FN_FILE = $7B ; 文件服务:打开、关闭、设置当前目录
51
+ FN_FILE_HANDLE = $7C ; 句柄服务:读写、大小、日期、属性
52
+ FN_DIR = $7D ; 目录服务:创建、删除、整理名称
53
+ FN_PAGE = $7E ; 内存页服务:分配、释放
54
+ FN_CLOCK = $7F ; 日期、时间与运行程序
55
+ FN_DISK = $80 ; 磁盘服务:读写扇区、软驱停转
56
+
57
+ ; ---- 子功能号(写入 SYS_SUBFUNCTION)----
58
+ ; ---- 子功能:键盘输入(FN_INPUT)----
59
+ SUB_KEY_INIT = $00 ; 复位键盘与鼠标,清空按键队列
60
+ SUB_KEY_ESC_ON = $01 ; 之后按 ESC 会中断程序
61
+ SUB_KEY_ESC_OFF = $02 ; 按 ESC 不再中断程序
62
+ SUB_KEY_GET_NOWAIT = $03 ; 取一个按键,没有按键时结果为 0
63
+ SUB_KEY_GET_WAIT = $04 ; 等到有按键再取
64
+ SUB_KEY_FLUSH = $05 ; 清空按键队列
65
+ SUB_KEY_COUNT = $06 ; 队列里的按键数,放在 KEY_ASCII
66
+
67
+ ; ---- 子功能:画面与中断控制(FN_PPU_CONTROL、FN_IRQ_MASK)----
68
+ SUB_NMI_PAD_ON = $85 ; FN_PPU_CONTROL:打开 NMI 中读手柄
69
+ SUB_NMI_PAD_OFF = $05 ; FN_PPU_CONTROL:关闭 NMI 中读手柄
70
+ SUB_IRQ_MOUSE_ON = $81 ; FN_IRQ_MASK:允许鼠标中断
71
+
72
+ ; ---- 子功能:手柄(FN_GAMEPAD)----
73
+ SUB_PAD_INIT = $00 ; 初始化手柄状态
74
+ SUB_PAD_GET = $01 ; 取按键码,不等待,没有键时为 $FF
75
+ SUB_PAD_WAIT = $02 ; 等到有按键再返回
76
+
77
+ ; ---- 子功能:鼠标(FN_MOUSE)----
78
+ SUB_MOUSE_SET_LIMITS = $00 ; 设置坐标范围,上下限在 $0646-$0649
79
+ SUB_MOUSE_GET_POS = $02 ; 取坐标:X 在 $0646,Y 在 $0647
80
+ SUB_MOUSE_GET_BUTTONS = $03 ; 整理按键状态到 MOUSE_BTN_BASE 起
81
+ SUB_MOUSE_SET_POS = $04 ; 设置坐标:X 取自 $0652,Y 取自 $0653
82
+
83
+ ; ---- 子功能:文件服务(FN_FILE)----
84
+ SUB_FS_OPEN = $09 ; 按 FILE_MODE 打开 PATH_BUFFER 里的路径
85
+ SUB_FS_CLOSE = $0A ; 关闭 FILE_HANDLE_OFFSET 指定的句柄
86
+ SUB_FS_FIND_ENTRY = $0B ; 设置当前目录,相当于 CD
87
+ SUB_FS_RESET = $13 ; 把 4 个句柄全部置为空闲
88
+
89
+ ; ---- 子功能:句柄服务(FN_FILE_HANDLE)----
90
+ SUB_FH_CLOSE_FLUSH = $02 ; 关闭句柄,并让软驱停转
91
+ SUB_FH_READ_AT = $05 ; 按偏移与长度读到扩展 RAM 页
92
+ SUB_FH_WRITE_AT = $06 ; 按偏移与长度从扩展 RAM 页写入
93
+ SUB_FH_GET_SIZE = $0D ; 取文件大小到 FILE_SIZE
94
+ SUB_FH_READ_FILE = $0F ; 把整个文件读入扩展 RAM 页
95
+ SUB_FH_WRITE_FILE = $10 ; 把扩展 RAM 页的内容整个写入文件
96
+
97
+ ; ---- 子功能:目录服务(FN_DIR)----
98
+ SUB_DIR_FORMAT_NAME = $01 ; 把当前目录名整理成 \NAME.EXT 放入 PATH_BUFFER
99
+ SUB_DIR_MAKE = $02 ; 创建目录
100
+ SUB_DIR_DELETE = $03 ; 删除目录,目录必须为空
101
+
102
+ ; ---- 子功能:内存页服务(FN_PAGE)----
103
+ SUB_PAGE_ALLOC = $00 ; 按 ALLOC_COUNT 分配连续页,起始页号在 ALLOC_START
104
+ SUB_PAGE_FREE = $01 ; 释放 ALLOC_START 起的 ALLOC_COUNT 个页
105
+ SUB_PAGE_LARGEST = $02 ; 求最长连续空闲页数,放在 ALLOC_COUNT
106
+
107
+ ; ---- 子功能:日期、时间与运行程序(FN_CLOCK)----
108
+ SUB_CLOCK_EXEC = $00 ; 运行 PATH_BUFFER 里的程序
109
+ SUB_CLOCK_SET_DATE = $01 ; 用 FILE_DATE 设置系统日期
110
+ SUB_CLOCK_GET_DATE = $02 ; 取系统日期到 FILE_DATE
111
+ SUB_CLOCK_SET_TIME = $03 ; 用 FILE_TIME 设置系统时间
112
+ SUB_CLOCK_GET_TIME = $04 ; 取系统时间到 FILE_TIME
113
+
114
+ ; ---- 子功能:磁盘服务(FN_DISK)----
115
+ SUB_DISK_READ = $04 ; 按 DISK_ 参数连续读扇区
116
+ SUB_DISK_WRITE = $05 ; 按 DISK_ 参数连续写扇区
117
+ SUB_DISK_STOP = $07 ; 软驱停转,每次文件操作之后都要调用
118
+
119
+ ; ---- 子功能:声音服务(FN_SOUND)----
120
+ SUB_SOUND_PLAY_WAV = $0C ; 播放内存里的 WAV,播完才返回
121
+
122
+ ; ---- 变量:出错码、命令行与显示(扩展 RAM)----
123
+ DOS_ERROR = $6300 ; 出错码,0 为成功,每次调用开头清 0
124
+ LIB_GROUP = $6308 ; 运行库显示字符串所在的页组,高 6 位有效
125
+ CURSOR_COL = $630C ; 光标列,从 1 起,每行 32 列
126
+ CURSOR_ROW = $630D ; 光标所在的显示行
127
+ GLYPH_ROW = $630E ; 字形缓冲行,由运行库维护,程序不要改
128
+ CMD_TAIL = $6364 ; 命令行参数的起点,大写、0 结尾,首字节是空格
129
+ FONT_SIZE = $6428 ; 字号
130
+
131
+ ; ---- 变量:文件与目录(扩展 RAM)----
132
+ DIR_NAME83 = $651D ; 当前目录的 11 字节名称,不要随便改写
133
+ PATH_BUFFER = $6543 ; 路径,0 结尾的 ASCII,可带 A: 与 \
134
+ FILE_MODE = $6560 ; 打开方式,0-5
135
+ FILE_HANDLE_OFFSET = $6561 ; 当前句柄在句柄表里的偏移
136
+ FILE_OFFSET_0 = $6565 ; 文件内偏移,3 字节,低字节在前
137
+ FILE_OFFSET_1 = $6566 ; 文件内偏移第 2 字节
138
+ FILE_OFFSET_2 = $6567 ; 文件内偏移第 3 字节
139
+ FILE_SIZE_0 = $6568 ; 文件大小或读写长度,3 字节,低字节在前
140
+ FILE_SIZE_1 = $6569 ; 文件大小或读写长度第 2 字节
141
+ FILE_SIZE_2 = $656A ; 文件大小或读写长度第 3 字节
142
+ FILE_START_PAGE = $656B ; 读写整个文件或一段数据时的扩展 RAM 起始页号
143
+ FILE_DATE_LO = $656E ; 日期低字节,FAT 格式:年(自 1980)、月、日
144
+ FILE_DATE_HI = $656F ; 日期高字节
145
+ FILE_TIME_LO = $6570 ; 时间低字节,FAT 格式:时、分、秒的一半
146
+ FILE_TIME_HI = $6571 ; 时间高字节
147
+ FILE_ATTR = $6572 ; 属性:位 0 只读,位 3 卷标,位 4 目录,位 5 存档
148
+
149
+ ; ---- 变量:内存页分配(扩展 RAM)----
150
+ ALLOC_COUNT = $65A6 ; 要分配或释放的页数
151
+ ALLOC_START = $65A7 ; 分配得到的起始页号,或要释放的起始页号
152
+
153
+ ; ---- 变量:磁盘参数(扩展 RAM)----
154
+ DISK_HEAD = $6200 ; 面,0 或 1
155
+ DISK_SECTOR = $6201 ; 起始扇区,1-18
156
+ DISK_TRACK = $6202 ; 磁道,0-79
157
+ DISK_PAGE = $6203 ; 缓冲所在的扩展 RAM 页号
158
+ DISK_PAGE_SECTOR = $6204 ; 缓冲从页内第几个 512 字节起,0-7
159
+ DISK_COUNT_LO = $6205 ; 扇区数低字节
160
+ DISK_COUNT_HI = $6206 ; 扇区数高字节
161
+ DISK_MODE = $6207 ; 方式:$80 出错时立即返回
162
+ DISK_STATUS = $6208 ; 结果状态,0 为成功
163
+
164
+ ; ---- 变量:键盘、手柄、鼠标(内核 RAM)----
165
+ KEY_ASCII = $034B ; 取到的按键的 ASCII 码,没有字符的键为 0
166
+ KEY_SCAN = $034C ; 取到的按键的扫描码
167
+ PAD_KEY = $034D ; 手柄按键码,$FF 为没有键
168
+ PAD1_BITS = $034E ; 1 号手柄的原始状态,位 7 是 A,位 0 是右
169
+ PAD2_BITS = $034F ; 2 号手柄的原始状态
170
+ MOUSE_X = $0354 ; 鼠标光标的 X 坐标
171
+ MOUSE_Y = $0355 ; 鼠标光标的 Y 坐标
172
+ MOUSE_BTN_BASE = $0360 ; 鼠标按键状态的起点,共 8 个字节
173
+ MOUSE_PRESENT = $0633 ; 鼠标是否接入,0 为没有
174
+
175
+ ; ---- 变量:系统调用的参数单元,含义随服务而定(内核 RAM)----
176
+ PARAM_0646 = $0646 ; 鼠标 X 下限,或显存地址高字节
177
+ PARAM_0647 = $0647 ; 鼠标 Y 下限,或显存地址低字节
178
+ PARAM_0648 = $0648 ; 鼠标 X 上限,或屏幕缓冲的列
179
+ PARAM_0649 = $0649 ; 鼠标 Y 上限,或屏幕缓冲的行
180
+ PARAM_0652 = $0652 ; 通用参数,多数服务从这里取输入
181
+ PARAM_0653 = $0653 ; 通用参数或返回值,如读到的字节
182
+
183
+ ; ---- 文件打开方式(FILE_MODE)----
184
+ MODE_OPEN = $00 ; 打开已有文件
185
+ MODE_CREATE = $01 ; 创建文件,已存在则覆盖
186
+ MODE_UPDATE = $02 ; 打开已有文件,可按偏移写,关闭时写回目录项
187
+ MODE_DELETE_ENTRY = $03 ; 删除文件:标为已删除并释放簇链
188
+ MODE_ENTRY = $04 ; 取得目录项,只对根目录与子目录成功
189
+ MODE_MAKE_DIR = $05 ; 创建目录项
190
+
191
+ ; ---- 出错码(DOS_ERROR)----
192
+ ERR_NONE = $00 ; 无错
193
+ ERR_BAD_FUNCTION = $01 ; 无效的功能调用号
194
+ ERR_FILE_NOT_FOUND = $02 ; 文件未找到
195
+ ERR_PATH_NOT_FOUND = $03 ; 路径未找到
196
+ ERR_TOO_MANY_FILES = $04 ; 打开的文件过多,4 个句柄都在用
197
+ ERR_ACCESS_DENIED = $05 ; 访问被拒绝,如写只读文件
198
+ ERR_NO_MEMORY = $08 ; 无足够内存,没有足够的连续空闲页
199
+ ERR_BAD_ADDRESS = $09 ; 无效的内存地址,页号不合法
200
+ ERR_NOT_READY = $15 ; 驱动器未准备好
201
+ ERR_FILE_EXISTS = $20 ; 文件已经存在
202
+ ERR_BAD_PARAMETER = $25 ; 参数无效
203
+ ERR_BAD_NAME = $27 ; 文件名或目录名错误
204
+ ERR_BAD_OPEN_MODE = $28 ; 文件打开方式错误
205
+ ERR_NO_SPACE = $2C ; 磁盘空间不够
206
+ ERR_NOT_OPEN = $2E ; 文件未打开
207
+
208
+ ; ---- 运行库入口(ROM 页组 0,经 FN_CALL_BANKED 且 SYS_GROUP=0 调用)----
209
+ LIB_PRINT_HEX = $8047 ; 显示 A 的十六进制,经功能 $25 调用时 A 传不进去,不能用
210
+ LIB_BEEP = $802D ; 发一声提示音
211
+ LIB_CURSOR_LEFT = $8081 ; 光标左移一列,到行首移到上一行末尾
212
+ LIB_CURSOR_RIGHT = $80CF ; 光标右移一列,到第 32 列换行
213
+ LIB_NEWLINE = $80E2 ; 换行,行满滚屏;调用前 CURSOR_COL 要置 1
214
+ LIB_GET_KEY = $81F4 ; 等待按键,结果在 KEY_ASCII、KEY_SCAN
215
+ LIB_PRINT_MESSAGE = $8202 ; 显示消息号为 LIB_GROUP 值的内置消息
216
+ LIB_PRINT_STRING = $8262 ; 在光标处显示 STR_PTR 指向的字符串,不移动光标