mirror of https://github.com/wwarthen/RomWBW.git
Wayne Warthen
3 years ago
4 changed files with 1690 additions and 277 deletions
File diff suppressed because it is too large
@ -0,0 +1,110 @@ |
|||
This tree now contains makefiles and tools to build on Linux and |
|||
macOS. Linux is rather more thoroughly tested compared to macOS. |
|||
|
|||
To get here, TASM and the propeller generation tools needed to be |
|||
replaced, and since the unix filesystem is usually case-sensitive, |
|||
and CP/M and windows are not, the cpm tools were made case-insensitive. |
|||
|
|||
TASM was replaced with uz80as, which implements a subset of TASM and |
|||
fixes some bugs. However, I needed to add some functionality to make |
|||
it build the sources as they exist in this tree. In particular, one |
|||
thing to be very careful of is that TASM is not entirely consistent |
|||
with respect to the .DS directive. it's usually a bad idea to mix |
|||
.DS, .FILL, .DB with .ORG. |
|||
|
|||
.DS n is best thought of as .ORG $ + n |
|||
.ORG changes the memory pointer, but does not change the file |
|||
output point. It works a lot more like M80, SLR* .PHASE |
|||
|
|||
It assumes that you have some standard system tools and libraries |
|||
installed, specifically: gcc, gnu make, libncurses, and srecord. |
|||
Typically, something like this will take care of adding all |
|||
required packages in Linux: |
|||
|
|||
sudo apt install build-essential libncurses-dev srecord |
|||
|
|||
For MacOS, you will need: |
|||
|
|||
brew install srecord |
|||
|
|||
To build: |
|||
cd to the top directory and type "make". |
|||
|
|||
By default, this will generate all of the standard configurations of |
|||
RomWBW for all platforms. If you just want to build the ROM for a |
|||
specific platform and configuration you can use |
|||
|
|||
make ROM_PLATFORM=<platform> ROM_CONFIG=<config> |
|||
|
|||
where <platform> is one of the supported platforms such as SBC, RCZ80, |
|||
etc. and <config> is a configuration of that platform. For example, |
|||
to build the "126" configuration of the "SCZ180" platform: |
|||
|
|||
make ROM_PLATFORM=SCZ180 ROM_CONFIG=126 |
|||
|
|||
Please be aware that the make-based build does have a few deficiencies. |
|||
|
|||
First and most important, the Makefiles do not handle reruns very well. |
|||
To ensure a full buld, use "make clean" from the top level directory |
|||
before running the actual build. |
|||
|
|||
Second, there are some build failures that will not stop the make |
|||
process. Most of this is because real CP/M 2.2 tools are used in |
|||
places and CP/M 2.2 does not allow programs to return a result code. |
|||
|
|||
Third, not all dependencies are properly handled. So, changes to some |
|||
files will not cause things to rebuild as appropriate. In general, I |
|||
recommend doing a "make clean" before running "make" to ensure that |
|||
everything is fully rebuilt. |
|||
|
|||
For macOS users, you may encounter a failure reading or writing files. |
|||
This is caused by protection features in macOS (at least, in Catalina) |
|||
that prevent programs built on your local system (unsigned) from |
|||
running. To disable this feature: |
|||
|
|||
1) Make sure you exit System Preferences. |
|||
2) Open a terminal session and type the following. You will need to |
|||
authenticate with an admin account. sudo spctl --master-disable |
|||
3) Exit terminal |
|||
4) Go into System Preferences and choose Security and Privacy |
|||
5) Select the General tab if it isn't already selected |
|||
6) You should now see a third selection under |
|||
"Allow apps downloaded from:" of Anywhere - select this. |
|||
7) Now you can run the build successfully. |
|||
|
|||
DISCLAIMER: You do this at your own risk. I highly recommend that you |
|||
return the settings back to normal immediately after doing a build. |
|||
|
|||
Heavy use is made of make's include facility and pattern rules. The |
|||
master rule set is in Tools/Makefile.inc. Changes here will affect |
|||
almost every Makefile, and where exceptions are needed, the overrides |
|||
are applied in the lower Makefiles. |
|||
|
|||
These tools can run a windows-linux regression test, where all the |
|||
binaries are compared to a baseline windows build. |
|||
|
|||
Credit: |
|||
|
|||
uz80as was written by Jorge Giner Cordero, |
|||
jorge.giner@hotmail.com, and the original source can be found |
|||
at https://github.com/jorgicor/uz80as. |
|||
|
|||
The propeller tools use bstc and openspin, parallax tools from |
|||
http://www.fnarfbargle.com/bst.html |
|||
https://github.com/parallaxinc/OpenSpin Note that bst is not |
|||
open source or even currently maintained, so I could not |
|||
generate a version for 64 bit macOS. |
|||
|
|||
cpmtools were the most current I could find, and it has been |
|||
hacked to do case-insensitivity. These are not marked, and are |
|||
not extensive. |
|||
|
|||
zxcc is from the distributed version, and also has local hacks |
|||
for case insensitivity. |
|||
|
|||
Both zxcc and cpmtools ship with an overly complicated makefile |
|||
generation system and this is ignored. |
|||
|
|||
This whole Linux build framework is the work of Curt Mayer, |
|||
curt@zen-room.org. Use it for whatever you like; this is not |
|||
my day job. |
|||
Loading…
Reference in new issue