3.6 KiB
MG's DaveX Utilities
This is a collection utilities for davex, mostly centered around AppleTalk, but also a few others including fixed or enhanced versions of a few existing davex.
Utilities
See the source or generated help files for each utility, for further information/options/etc.
AppleTalk
afp.sessions
Displays AFP sessions.
afp.userprefix
Print or set the AFP user prefix.
at.boot
Boots over Appletalk.
at.info
Display some AppleTalk info
at.zones
Display AppleTalk zone information.
nbp.lookup
Look up NBP names registered on the network.
nbp.parse
Parse an NBP name and display the parts. Mainly used for testing the parsing routine.
tardis
Get time from TimeLord server.
Fixed/Enhanced
alias
This is a fixed version of the alias command included in davex 1.30p.
deschw
This has been enhanced to identify the CPU and to detect emulation. If an emulator supporting EMUBYTE is found, displays its name and version if known.
See idemu for more comprehensive emulator detection.
There are also a few other enhancements around SmartPort device info.
Misc
diskinfo
Display information on mounted disks/volumes.
dmem
Displays info on davex "dynamic memory." Mainly for testing purposes.
fastchip (beta)
Controls the A2Heaven FastChip //e.
idemu
Identifies emulators. If a positive ID on EMUBYTE can be used, uses it. Otherwise, attempts to use the various emulators' idiosynchracies regarding emulator ROM and I/O space to make the identification. It does not interact with any slot hardware.
iie.card
Display or change the speed of the 65C02 on the Apple //e Card for Macintosh LC.
Optionally, use undocumented features to display the user-selected startup slot.
mig.insp
View the contents of the Apple IIc Plus MIG RAM.
setyear
Patches the ProDOS ThunderClock driver year table in-memory.
Experimental
dxforth
This is a Forth 2012 implementation. See dxforth.txt for more information.
Caution: This will not work with a stock Davex as built from the Sourceforge project, as it uses the documented, but unimplemented, xgetln2 Davex call. If you just want the other tools, remove dxforth.p8c from the Makefile.
Building
Building the utilities requires a Unix-like environment with GNU Make and the usual set of Unix utilities such as sed, awk, egrep, etc.
A working installtion of cc65 must be present and in the PATH (for ca65, ld65, od65).
The davex source code (link at top) must be present somewhere, and the DAVEX variable in the Makefile should point to it.
In order to build the default target (a ShrinkIt file), nulib2 must be present and in the PATH.
In order to build a disk image, you must have AppleCommander CLI version set up and must modify the Makefile.
The utilities are developed on macOS X.
Interesting make targets
all: build shrinkit file DAVEX.MG.SHKdisk: build davex.mg.poemulate: builds disk and attempts to open with Virtual ][. Set BOOTDSK in Makefile first.
Developing
Fork it, send pull requests, etc.
I created a custom set of macros and tools for doing davex external commands. These are in davex-mg.inc and in the utils directory.
In particular, the macros along with utils/auto_origin.sh allow automatically meeting the davex external command loading recommendations, which are "load on a page boundary so that the end of the file loads between $AF00 and $AFFF."
Additionaly, utils/gen_help.sh is used to extract the help file contents from the source code of each utility.