Integrate AStar with VCC Plus disk builds and verified run
Add the vccplus-disk packaging target, project settings, playable AStar.DSK, actual MCP framebuffer screenshot and build-43 validation. Preserve upstream C sources and Makefile unchanged.
This commit is contained in:
1 parent
aa048c556d
commit
0c3f8c0324
10 files changed
+211
-16
No files matched your search
@@ -0,0 +1,3 @@
|
||||
*.DSK binary
|
||||
*.dsk binary
|
||||
*.png binary
|
||||
+18
@@ -0,0 +1,18 @@
|
||||
.DS_Store
|
||||
._*
|
||||
__pycache__/
|
||||
*.pyc
|
||||
*.o
|
||||
*.a
|
||||
*.bin
|
||||
*.map
|
||||
*.lst
|
||||
*.link
|
||||
*.i
|
||||
*.hex
|
||||
*.dsk
|
||||
*.DSK
|
||||
!/AStar.DSK
|
||||
build/
|
||||
.build/
|
||||
.cache/
|
||||
@@ -1,30 +1,48 @@
|
||||
AStar: A demo of the A* search algorithm
|
||||
========================================
|
||||
# AStar pathfinding demo
|
||||
|
||||
By Pierre Sarrazin (http://sarrazip.com/).
|
||||
An implementation of the A* search algorithm with a rectangular-grid demonstration,
|
||||
by **Pierre Sarrazin**. This repository contains version **0.1.0** with a
|
||||
VCC Plus project and disk launcher.
|
||||
|
||||
CMOC Home Page: http://sarrazip.com/dev/cmoc.html
|
||||

|
||||
|
||||
Version 0.1.0 - 202?-??-?? - First public release.
|
||||
## Download and run
|
||||
|
||||
Download [AStar.DSK](AStar.DSK), a ready-to-run Disk BASIC image. Mount a writable
|
||||
copy in drive 0 of a **512 KB CoCo 3 / 6809 / Disk BASIC** machine, then type:
|
||||
|
||||
# Introduction
|
||||
```basic
|
||||
LOADM"ASTAR":EXEC
|
||||
```
|
||||
|
||||
[A\*](https://en.wikipedia.org/wiki/A*_search_algorithm)
|
||||
is a graph traversal and path search algorithm.
|
||||
The demonstration draws its grid and the path **A B C G F J K L**. Press any key
|
||||
to finish and return to BASIC.
|
||||
|
||||
This package presents an implementation that assumes that the graph
|
||||
is a rectangular grid.
|
||||
## Build in VCC Plus
|
||||
|
||||
See `astar-demo.c` for the demo. It uses `astar.h` and `astar.c`.
|
||||
1. Open this repository’s root folder in **Develop → C Development → Open**.
|
||||
2. Select **Release**, then choose **Build Disk**.
|
||||
3. Use **Show Build Products** to find `AStar.DSK` and `astar.bin` in the build
|
||||
snapshot, then launch the disk with the command above.
|
||||
|
||||
The project selects `VCCPlus.mk`, which includes the original `Makefile` and adds
|
||||
the `vccplus-disk` target. It uses VCC Plus’s bundled CMOC and disk tools.
|
||||
|
||||
# Building the demo
|
||||
The disk build and the illustrated run were verified through the public MCP
|
||||
interface in **VCC Plus 3.5.0 build 43**, using the configuration above.
|
||||
[Validation details](docs/VALIDATION.md) describe the checked behavior and limits.
|
||||
|
||||
After installing CMOC, type `make`, which should build the library
|
||||
(`libastar.a`) and the demo executable (`astar.bin`).
|
||||
## Original source
|
||||
|
||||
- Author: [Pierre Sarrazin](http://sarrazip.com/).
|
||||
- [CMOC project index](http://sarrazip.com/dev/cmoc.html).
|
||||
- [AStar 0.1.0 source archive](http://sarrazip.com/dev/astar-0.1.0.tar.gz).
|
||||
- Archive SHA-256: `acd2d5e2ad709892cb7609f5e53387cbbfe7364e675abb5e4f2a5c806cd0fc7c`.
|
||||
|
||||
# License
|
||||
The [original README](docs/UPSTREAM_README.md) and source notices are preserved.
|
||||
See [source provenance](docs/PROVENANCE.md) for the import and integration history.
|
||||
|
||||
This package and library are in the public domain.
|
||||
## License
|
||||
|
||||
The upstream package and library are in the public domain, as stated in the
|
||||
original README. Original author notices remain in the source.
|
||||
@@ -0,0 +1,9 @@
|
||||
# VCC Plus disk packaging; the upstream build rules remain in Makefile.
|
||||
include Makefile
|
||||
|
||||
.PHONY: vccplus-disk
|
||||
vccplus-disk: AStar.DSK
|
||||
|
||||
AStar.DSK: astar.bin
|
||||
perl -e 'print chr(255) x (35*18*256)' > $@
|
||||
writecocofile $@ astar.bin
|
||||
@@ -0,0 +1,35 @@
|
||||
# Source provenance
|
||||
|
||||
## Original package
|
||||
|
||||
- Original author: **Pierre Sarrazin**.
|
||||
- Package: **AStar 0.1.0**.
|
||||
- [Author index](http://sarrazip.com/dev/cmoc.html).
|
||||
- [Source archive](http://sarrazip.com/dev/astar-0.1.0.tar.gz).
|
||||
- Archive SHA-256: `acd2d5e2ad709892cb7609f5e53387cbbfe7364e675abb5e4f2a5c806cd0fc7c`.
|
||||
- Upstream terms: the package and library are explicitly dedicated to the
|
||||
public domain in the [original README](UPSTREAM_README.md).
|
||||
|
||||
The checksum identifies the original source archive used for this import.
|
||||
A current matching download link is not a separate authenticity guarantee or
|
||||
proof of the original download event.
|
||||
|
||||
## Git history and VCC Plus integration
|
||||
|
||||
This is a source-archive import, not an upstream Git checkout. The initial
|
||||
commit, `aa048c556d77e44c3f7706b11a92268afd554cea`, contains the archive’s original files before
|
||||
VCC Plus integration. The original README is also preserved byte-for-byte in
|
||||
`UPSTREAM_README.md`. Source author notices remain intact.
|
||||
|
||||
The integration keeps the upstream C/header files and `Makefile` unchanged.
|
||||
It adds `VCCPlus.mk`, which includes the original Makefile and packages the
|
||||
compiled demo into `AStar.DSK`; `vccplus-project.json` selects that disk target
|
||||
and the Disk BASIC launch command. The public README, actual running screenshot,
|
||||
validation record and Git output exclusions accompany those integration files.
|
||||
The top-level disk is an intentionally delivered playable artifact, rather than
|
||||
an incidental object-file cache.
|
||||
|
||||
The original source archive and earlier local project were not modified by this
|
||||
import. The [validation record](VALIDATION.md) documents the completed installed
|
||||
build-43 public MCP disk build and displayed path result. This repository’s
|
||||
source history is distinct from later hosting or repository-avatar updates.
|
||||
@@ -0,0 +1,30 @@
|
||||
AStar: A demo of the A* search algorithm
|
||||
========================================
|
||||
|
||||
By Pierre Sarrazin (http://sarrazip.com/).
|
||||
|
||||
CMOC Home Page: http://sarrazip.com/dev/cmoc.html
|
||||
|
||||
Version 0.1.0 - 202?-??-?? - First public release.
|
||||
|
||||
|
||||
# Introduction
|
||||
|
||||
[A\*](https://en.wikipedia.org/wiki/A*_search_algorithm)
|
||||
is a graph traversal and path search algorithm.
|
||||
|
||||
This package presents an implementation that assumes that the graph
|
||||
is a rectangular grid.
|
||||
|
||||
See `astar-demo.c` for the demo. It uses `astar.h` and `astar.c`.
|
||||
|
||||
|
||||
# Building the demo
|
||||
|
||||
After installing CMOC, type `make`, which should build the library
|
||||
(`libastar.a`) and the demo executable (`astar.bin`).
|
||||
|
||||
|
||||
# License
|
||||
|
||||
This package and library are in the public domain.
|
||||
@@ -0,0 +1,57 @@
|
||||
# AStar installed-app validation
|
||||
|
||||
Verified **November 9, 2026** through the installed VCC Plus public MCP build
|
||||
and disposable-playtest interface. This records the selected demonstration;
|
||||
it is not a full library regression suite.
|
||||
|
||||
## Configuration
|
||||
|
||||
- VCC Plus **3.5.0 build 43** and its bundled CMOC/Make/disk tools.
|
||||
- An isolated native copy of the installed application was used to preserve the
|
||||
active CoCoMan workspace. Its emulator code was unchanged; the bundle identity
|
||||
was changed and the copy was ad-hoc signed for isolation.
|
||||
- **Release** configuration; **512 KB RAM, MC6809, Disk BASIC**.
|
||||
- Approved Make recipe: `VCCPlus.mk`, including upstream `Makefile`.
|
||||
- Public build action: `disk`; declared target: `vccplus-disk`.
|
||||
- Declared launch command: `LOADM"ASTAR":EXEC`.
|
||||
|
||||
## Build evidence
|
||||
|
||||
- Project ID: `963A54EE-D02A-4701-B53A-92FC0BB62D02`; source revision: `0`.
|
||||
- Recipe ID: `ae0576ed455aa0f6ef31e0372662312b63aa633b175928b7115e9df71267cb88`.
|
||||
- Build ID: `7237D773-A262-4AE3-9F67-674F2300FC8B`; result: **succeeded**.
|
||||
- Artifact ID: `1158FAAB-2636-487E-9FB7-68DD272F8CCF`.
|
||||
- `astar.bin`: **4,540 bytes**; SHA-256
|
||||
`a967c02ebdb8f5dff0e94d9768fdb0fd37071c22542a9feedc0444c6903e6722`.
|
||||
- Delivered `AStar.DSK`: **161,280 bytes**; SHA-256
|
||||
`48c532dee5a302f7b0841f9353c218ae61bee23af0d1bac576e41d11cde3e502`.
|
||||
|
||||
CMOC emitted two existing warnings in `astar-demo.c`, at lines **183** and
|
||||
**242**, about assignment used as a condition. The original source was not
|
||||
changed to suppress them. Compilation, linking and disk packaging completed.
|
||||
|
||||
## Execution and screenshot
|
||||
|
||||
The MCP-owned run `321CD4AD-E480-4BB8-95A6-271182F20B74` reached the actual
|
||||
running demonstration. Its framebuffer showed the grid, a drawn path and the
|
||||
text **FOUND PATH: A B C G F J K L**. The capture was taken after **1,072 emulated
|
||||
video fields**, with **5,120 bytes read from disk**, zero disk writes and the
|
||||
same disk SHA-256 as the verified artifact. The run was then stopped and its
|
||||
test disk retained by VCC Plus.
|
||||
|
||||
[The screenshot](screenshots/running.png) is the actual **640 × 480** framebuffer
|
||||
returned by MCP. SHA-256:
|
||||
`689f47c217418b2b0702aa37bf4055bf16ad81e3eb805c2f5544be4a049302b0`.
|
||||
It is not an illustration, an old distribution disk capture or a build log.
|
||||
|
||||
The source waits for a key and returns to BASIC after the displayed result;
|
||||
this capture session stopped the owned run rather than separately testing that
|
||||
key-to-BASIC transition.
|
||||
|
||||
## Scope
|
||||
|
||||
This establishes a fresh Release disk build and a successful displayed result
|
||||
for the specified MC6809 configuration. It does not claim HD6309 execution,
|
||||
Intel/Rosetta qualification, physical CoCo hardware, audio listening,
|
||||
comprehensive library tests or all possible pathfinding inputs. No private
|
||||
connection grant or raw host log is included in this repository.
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 8.8 KiB |
@@ -0,0 +1,25 @@
|
||||
{
|
||||
"entrySource": "astar-demo.c",
|
||||
"makefile": "VCCPlus.mk",
|
||||
"buildTarget": "all",
|
||||
"binary": "astar.bin",
|
||||
"launchMode": "disk",
|
||||
"configurations": [
|
||||
{
|
||||
"name": "Debug",
|
||||
"makeArguments": [
|
||||
"INTERMEDIATE=--intermediate"
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "Release",
|
||||
"makeArguments": []
|
||||
}
|
||||
],
|
||||
"jobs": 4,
|
||||
"diskTarget": "vccplus-disk",
|
||||
"diskImage": "AStar.DSK",
|
||||
"launchCommands": [
|
||||
"LOADM\"ASTAR\":EXEC"
|
||||
]
|
||||
}
|
||||
Reference in new issue
Block a user