ZXCC

Introduction

This is John Elliott's CP/M 2/3 emulator for cross-compiling and running CP/M tools under Microsoft Windows and Linux/Unix/macOS. The ability to run under MS-DOS/DR-DOS is no longer supported.

This repository has been initially extracted from John Elliott's Stable version 0.5.7 source-code at

http://www.seasip.info/Unix/Zxcc/zxcc-0.5.7.tar.gz

I have some updates that will be applied soon to remedy some issues that I found when using the latest version of the HI-TECH Z80 C compiler v3.09-x - obtainable from the repository at

https://github.com/agn453/HI-TECH-Z80-C

I welcome bug reports/fixes and additional commentry and discussion.

You can raise an issue here on GitHub or contact me directly via e-mail at [email protected].

Updates

• An apparent error in the source of the CP/M BDOS function 10 (read console buffer) emulation - courtesy of @tsupplis from his repository at https://github.com/tsupplis/zxccp

• The C compiler (zxc) front-end was not accepting HI-TECH C-style command options that require filenames. It now accepts the following

  -efile.com     CP/M executable file name
  -ffile.sym     Symbol-table for debugger or overlay creation
  -idirectory    Include directory (in native format)
  -mfile.map     Linker map file
  -crfile.crf    Cross-reference listing

• The linker (zxlink) should use the renamed HI-TECH linker (now linq.com).

• Fix compilation warnings

• Emulation of CP/M BDOS function 60 (call resident system extension) should be disabled and return 0xFF in both the A and L registers.

• Change cpm_bdos_10() to return an unsigned result to avoid buffer size being interpreted as negative.

• Fix the emulation of Z80 opcodes for IN (HL),(C) and OUT (C),(HL) - opcodes 0xED,0x70 and 0xED,0x71 respectively. This is noted in Fred Weigel's AM9511 arithmetic processing unit emulation from https://github.com/ratboy666/am9511 in the howto.txt description. NB: I have not included Fred's am9511 support at this time into ZXCC.

• Russell Marks contributed a fix to the emulation of the Z80 DAA (decimal adjust) instruction - based on code from the yaze 1.10 emulator. The original code in ZXCC was based on incorrect documentation of the DAA instruction in the Zilog and Mostek programming manuals (and even in Rodney Zaks "Programming the Z80" book). The most recent documentation from Zilog has the correct description¹. With this fix in-place ZXCC is able to run the Z80 instruction emulator test suite ZEXDOC from yaze-ag². You can download a copy of the CP/M binary for ZEXDOC from https://raw.githubusercontent.com/agn453/ZEXALL/main/zexdoc.com

• Mark Ogden (@ogdenpm) has supplied some modifications to allow stdin redirection from a file, as well as a fix to the BDOS function 10 bdos_rdline() routine to process new-line '\n' and '\r\n' correctly from file input.

• Further tweaks from Mark Ogden for Console Line input. A NULL character can now be read, and long-lines are truncated (as they would be on a real CP/M computer). Control characters are also echoed using the ^ prefix. For example, Ctrl-Z echoes as ^Z (and is read by the emulated program as on real CP/M).

• More updates from Mark Ogden - this time to keep track of open files. CP/M does not care if you don't close a file open for input - whereas under ZXCC the operating system keeps a file handle for each open file. This can have an effect when files are deleted or renamed. There's a symbol FILETRACKER that's been added to the configuration file config.h. Undefine this if you wish to restore the previous behaviour.

• Michal Tomek has added environment variables for BINDIR80, INCDIR80 and LIBDIR80 to allow overriding the compiled-in defaults. Also, the bios.bin file can be in the same directory as the ZXCC executable or with the CP/M .COM files.

• More from Michal Tomek - Fix compilation under Cygwin on Windows and correct BDOS function 40 (Write with Zero-fill).

• Mark Ogden has added the capability to build the ZXCC command-line programs under Microsoft Windows (using Visual Studio). You'll find build instructions in the winbuild/README.md file. Further details concerning the changes are in changes.md.

• A fix was made so that any reference to the P: drive is now redirected to the local default directory. Also, filenames under Windows can use either a forward slash / or back-slash \ in the directory path.

• Mark Ogden has cleaned up a number of warnings for the Windows build using Visual Studio and fixed some issues with the install script when it encountered spaces in a Windows directory pathname and the CPMDIR80 environment variable determining the search paths for the CP/M binaries, libraries and include files.

• Modified the compiler front-end (zxc) to support environment variables for INCDIR80 or CPMDIR80 and more changes to build with Cygwin on Windows from Mark Ogden.

• Finally fixed by Mark Ogden (much appreciated) is an issue that affected the processing of the $$exec.$$$ file by HI-TECH C's batch processing. This changes the way ZXCC implements "exact file size" handling to match that of Jon Saxton's and HI-TECH C (see the README.md file for details). Also, user area specifications on CP/M filenames have been removed - since they're not implemented by ZXCC.

• Fix parsing of spaces in the FCBs - resolving issue #39.

• Look for CP/M COM file in current directory (emulated drive P:) before the binaries (in BINDIR80 emulated as drive A:).

• The search for bios.bin on macOS should not use Linux-style /proc path.

• Add some hints on where to find some extra files. In addition to the previous locations for .COM binaries, .LIB libraries and object files .OBJ (in the bin80 and lib80 locations), ZXCC now searches for .HLP, .MSG and .OVR files in bin80, .REL in lib80 and .H header files in include80. The Microsoft BASIC-80 compiler run-time BCLOAD. can be in the lib80, and HI-TECH C options help OPTIONS in the bin80 locations.

• The exact file size changes have been reverted to behave like the original John Elliott version - and now use the DOS Plus convention. The HI-TECH Z80 C behaviour has been altered too as at v3.09-13 to support this. Please see the HI TECH Z80 C repository at https://github.com/agn453/HI-TECH-Z80-C for details and to update to the latest version.

• Jim Burlingame provided updates to the autotools build system to allow building under recent versions of Linux/macOS using the .configure ; make ; make install method. This has been tested and verified to work with Debian Bookworm (and variants) and macOS Sonoma (x86 and arm).

--

Tony Nicholson 06-Sep-2024

Footnotes

1. The most recent Zilog Z80 Family CPU User Manual (UM008001-1000) can be found at http://www.zilog.com/docs/z80/z80cpu_um.pdf ↩

2. You'll find the final version of yaze-ag 2.51.1 (as curated by Andreas Gerlich) at http://www.mathematik.uni-ulm.de/users/ag/yaze-ag ↩