|
|
|
@ -26,7 +26,7 @@ In summary, the process involves the 4 steps below: |
|
|
|
4) Burn the resultant ROM image and try it. |
|
|
|
|
|
|
|
The process is really very simple. In fact, you can |
|
|
|
essentially skip steps 1 & 2 if yoiu want to try simply |
|
|
|
essentially skip steps 1 & 2 if you want to try simply |
|
|
|
building one of the existing configurations. |
|
|
|
|
|
|
|
Each of the 4 steps above is described in more detail |
|
|
|
@ -42,20 +42,20 @@ need to modify an existing configuration file or |
|
|
|
create your own. |
|
|
|
|
|
|
|
If you look in the Source directory, you will see |
|
|
|
a series of files named config_xxxxxx.asm. Each of |
|
|
|
a series of files named config_xxxx_yyyy.asm. Each of |
|
|
|
them corresponds to one of the standard configurations |
|
|
|
listed in the ROMList.txt file. |
|
|
|
|
|
|
|
You have two choices. You can simply modify the existing |
|
|
|
configuration file that is closest to your situation, or |
|
|
|
you can copy it to a new config_xxxxx.asm file and modify |
|
|
|
you can copy it to a new config_xxxx_yyyy.asm file and modify |
|
|
|
that. I recommend that you copy one to your own name so |
|
|
|
that you will always have the unmodified standard configuration |
|
|
|
files left in place. So, for example, you could just |
|
|
|
copy config_zeta.asm to config_wayne.asm. You MUST |
|
|
|
name your config file as congig_xxxxxx.asm. The xxxx's |
|
|
|
can be whatever you want, but the rest must be exactly |
|
|
|
as indicated. |
|
|
|
copy config_ZETA_std.asm to config_ZETA_wayne.asm. You MUST |
|
|
|
name your config file as config_xxxx_yyyy.asm. The xxxx's |
|
|
|
must match your platform (N8VEM, ZETA, N8, S2I, or S100). |
|
|
|
The yyyy's can be whatever you want. |
|
|
|
|
|
|
|
The config files are simply text files with various |
|
|
|
settings. Open your target config file with your |
|
|
|
@ -94,25 +94,19 @@ space available for the ROM drive. |
|
|
|
|
|
|
|
Second, all files from the directory that corresponds to |
|
|
|
your configuration file will be included. If you build |
|
|
|
the "zeta" configuration, all files in cfg_zeta will |
|
|
|
the "ZETA_std" configuration, all files in cfg_ZETA_std will |
|
|
|
be added. Note that these files will be in addition |
|
|
|
to the files from the std_XXXKB directory. |
|
|
|
|
|
|
|
If you created your own config file (like config_wayne.asm |
|
|
|
If you created your own config file (like config_ZETA_wayne.asm |
|
|
|
described above), you MUST create a subdirectory within |
|
|
|
the RomDsk directory and populate it with the files |
|
|
|
you want added. Normally, you would include the |
|
|
|
files from the original standard config. So, if |
|
|
|
you created config_wayne.asm from config_zeta.asm, |
|
|
|
you created config_ZETA_wayne.asm from config_ZETA_std.asm, |
|
|
|
then you would create a subdirectory in RomDsk called |
|
|
|
cfg_wayne and copy all the files from cfg_zeta to |
|
|
|
cfg_wayne. |
|
|
|
|
|
|
|
Finally, you will notice another subdirectory called |
|
|
|
RomApps. This is directory is used to place a set of |
|
|
|
RomWBW apps provided by Douglas Goodall. The driectory |
|
|
|
will be populated automatically and the files will be |
|
|
|
included automatically. |
|
|
|
cfg_ZETA_wayne and copy all the files from cfg_ZETA_std to |
|
|
|
cfg_ZETA_wayne. |
|
|
|
|
|
|
|
3. Run the Build Process |
|
|
|
------------------------ |
|
|
|
@ -137,7 +131,7 @@ in red text. |
|
|
|
|
|
|
|
If you immediately receive the error "the execution of |
|
|
|
scripts is disabled on this system", then you will need to |
|
|
|
change the PowerShell Execution-Polcy to "Unrestricted". |
|
|
|
change the PowerShell Execution-Polcy to "RemoteSigned". |
|
|
|
To do this, you need to right-click on FixPowerShell.cmd and |
|
|
|
choose "Run as Administrator" to make the change. If is |
|
|
|
critical that you right-click and use "Run as Administrator" |
|
|
|
@ -148,12 +142,17 @@ use "Run as Administrator". |
|
|
|
The build script will prompt you for the following information |
|
|
|
which you will need to provide (don't worry, it is simple): |
|
|
|
|
|
|
|
Platform: |
|
|
|
|
|
|
|
Respond with the name of the platform that you are targeting. |
|
|
|
It must be one of N8VEM, ZETA, N8, S2I, or S100. |
|
|
|
|
|
|
|
Configuration: |
|
|
|
|
|
|
|
Respond with the name of the configuration you wish to build. |
|
|
|
A list of all available configurations is displayed for your |
|
|
|
convenience. For example, if you are buidling the provided |
|
|
|
zeta configuration, just enter "zeta". If you have created a |
|
|
|
convenience. For example, if you are building the provided |
|
|
|
ZETA_std configuration, just enter "std". If you have created a |
|
|
|
custom configuration as described above, you would enter |
|
|
|
"wayne". |
|
|
|
|
|
|
|
@ -165,12 +164,6 @@ It is important that you choose a ROM size that is no larger than |
|
|
|
the szie of the ROM you will ultimately be burning. This is |
|
|
|
dependant on your hardware. |
|
|
|
|
|
|
|
CPU Type Z[80|180]: |
|
|
|
|
|
|
|
Respond with "80" if the ROM is for Z80 hardware such as the |
|
|
|
N8VEM Z80 SBC or for Zeta. Respond with "180" if the ROM is |
|
|
|
for Z180 based hardware such as the N8. |
|
|
|
|
|
|
|
System [CPM|ZSYS]: |
|
|
|
|
|
|
|
Respond with the type of system you wish to create. If you are |
|
|
|
@ -222,7 +215,7 @@ command, you can specify the options right on the command line. |
|
|
|
|
|
|
|
For example: |
|
|
|
|
|
|
|
Build zeta 512 80 CPM |
|
|
|
Build ZETA std 512 CPM |
|
|
|
|
|
|
|
In this case, you will not be prompted. This is useful if you |
|
|
|
wish to automate your build process. |
|
|
|
@ -230,102 +223,117 @@ wish to automate your build process. |
|
|
|
Example Build Run |
|
|
|
----------------- |
|
|
|
|
|
|
|
C:\Users\WWarthen\N8VEM\Build\RomWBW>build |
|
|
|
C:\Users\WWarthen\Projects\N8VEM\Build\RomWBW>Build.cmd |
|
|
|
Platform [N8VEM|ZETA|N8|S2I|S100]: ZETA |
|
|
|
Configurations available: |
|
|
|
> n8 |
|
|
|
> n8vem |
|
|
|
> n8vem_dide |
|
|
|
> n8vem_diskio |
|
|
|
> n8vem_diskio3 |
|
|
|
> n8vem_ppide |
|
|
|
> n8vem_vdu |
|
|
|
> n8vem_vdux |
|
|
|
> simh |
|
|
|
> zeta |
|
|
|
Configuration: zeta |
|
|
|
> ppp |
|
|
|
> std |
|
|
|
Configuration: std |
|
|
|
ROM Size [512|1024]: 512 |
|
|
|
CPU Type Z[80|180]: 80 |
|
|
|
System [CPM|ZSYS]: CPM |
|
|
|
|
|
|
|
Building zeta: 512KB ROM configuration zeta for Z80... |
|
|
|
Building ZETA_std: 512KB ROM configuration std for Z80... |
|
|
|
|
|
|
|
tasm -t80 -b -g3 -fFF ccpb03.asm cp.bin |
|
|
|
tasm -t80 -g3 ccpb03.asm cp.bin |
|
|
|
TASM Z80 Assembler. Version 3.2 September, 2001. |
|
|
|
Copyright (C) 2001 Squak Valley Software |
|
|
|
tasm: pass 1 complete. |
|
|
|
tasm: pass 2 complete. |
|
|
|
tasm: Number of errors = 0 |
|
|
|
tasm -t80 -b -g3 -fFF bdosb01.asm dos.bin |
|
|
|
tasm -t80 -g3 bdosb01.asm dos.bin |
|
|
|
TASM Z80 Assembler. Version 3.2 September, 2001. |
|
|
|
Copyright (C) 2001 Squak Valley Software |
|
|
|
tasm: pass 1 complete. |
|
|
|
tasm: pass 2 complete. |
|
|
|
tasm: Number of errors = 0 |
|
|
|
tasm -t80 -b -g3 -fFF -dBLD_SYS=SYS_CPM data.asm data.bin |
|
|
|
tasm -t80 -g3 syscfg.asm syscfg.bin |
|
|
|
TASM Z80 Assembler. Version 3.2 September, 2001. |
|
|
|
Copyright (C) 2001 Squak Valley Software |
|
|
|
tasm: pass 1 complete. |
|
|
|
Configuration: ZETA Z80 SBC, FLOPPY (AUTOSIZE), PPIDE |
|
|
|
UTIL_DATA occupies 16 bytes. |
|
|
|
FD_DATA occupies 427 bytes. |
|
|
|
PPIDE_DATA occupies 584 bytes. |
|
|
|
DATA space remaining: 23 bytes. |
|
|
|
Configuration: ZETA Z80 SBC, FLOPPY (AUTOSIZE), PPIDE (STD) |
|
|
|
tasm: pass 2 complete. |
|
|
|
tasm: Number of errors = 0 |
|
|
|
tasm -t80 -b -g3 -fFF -dBLD_SYS=SYS_CPM cbios.asm cbios.bin |
|
|
|
tasm -t80 -g3 -dBLD_SYS=SYS_CPM cbios.asm cbios.bin |
|
|
|
TASM Z80 Assembler. Version 3.2 September, 2001. |
|
|
|
Copyright (C) 2001 Squak Valley Software |
|
|
|
tasm: pass 1 complete. |
|
|
|
Configuration: ZETA Z80 SBC, FLOPPY (AUTOSIZE), PPIDE |
|
|
|
CNFGDATA occupies 69 bytes. |
|
|
|
DSKMAP occupies 6 bytes. |
|
|
|
UART occupies 77 bytes. |
|
|
|
FD occupies 1991 bytes. |
|
|
|
PPIDE occupies 832 bytes. |
|
|
|
UTIL occupies 381 bytes. |
|
|
|
CBIOS space remaining: 165 bytes. |
|
|
|
Configuration: ZETA Z80 SBC, FLOPPY (AUTOSIZE), PPIDE (STD) |
|
|
|
INFOLIST occupies 18 bytes. |
|
|
|
UTIL occupies 484 bytes. |
|
|
|
FD_DATA occupies 340 bytes. |
|
|
|
PPIDE_DATA occupies 1116 bytes. |
|
|
|
CBIOS space remaining: 2092 bytes. |
|
|
|
tasm: pass 2 complete. |
|
|
|
tasm: Number of errors = 0 |
|
|
|
tasm -t80 -b -g3 -fFF dbgmon.asm dbgmon.bin |
|
|
|
tasm -t80 -g3 dbgmon.asm dbgmon.bin |
|
|
|
TASM Z80 Assembler. Version 3.2 September, 2001. |
|
|
|
Copyright (C) 2001 Squak Valley Software |
|
|
|
tasm: pass 1 complete. |
|
|
|
Configuration: ZETA Z80 SBC, FLOPPY (AUTOSIZE), PPIDE |
|
|
|
DBGMON space remaining: 831 bytes. |
|
|
|
Configuration: ZETA Z80 SBC, FLOPPY (AUTOSIZE), PPIDE (STD) |
|
|
|
DBGMON space remaining: 795 bytes. |
|
|
|
tasm: pass 2 complete. |
|
|
|
tasm: Number of errors = 0 |
|
|
|
tasm -t80 -b -g3 -fFF bloader.asm bloader.bin |
|
|
|
tasm -t80 -g3 prefix.asm prefix.bin |
|
|
|
TASM Z80 Assembler. Version 3.2 September, 2001. |
|
|
|
Copyright (C) 2001 Squak Valley Software |
|
|
|
tasm: pass 1 complete. |
|
|
|
Configuration: ZETA Z80 SBC, FLOPPY (AUTOSIZE), PPIDE |
|
|
|
BOOT LOADER space remaining: 3522 bytes. |
|
|
|
Configuration: ZETA Z80 SBC, FLOPPY (AUTOSIZE), PPIDE (STD) |
|
|
|
tasm: pass 2 complete. |
|
|
|
tasm: Number of errors = 0 |
|
|
|
tasm -t80 -b -g3 -fFF romx.asm romx.bin |
|
|
|
tasm -t80 -g3 bootrom.asm bootrom.bin |
|
|
|
TASM Z80 Assembler. Version 3.2 September, 2001. |
|
|
|
Copyright (C) 2001 Squak Valley Software |
|
|
|
tasm: pass 1 complete. |
|
|
|
Configuration: ZETA Z80 SBC, FLOPPY (AUTOSIZE), PPIDE |
|
|
|
ROMX space remaining: 8191 bytes. |
|
|
|
Configuration: ZETA Z80 SBC, FLOPPY (AUTOSIZE), PPIDE (STD) |
|
|
|
tasm: pass 2 complete. |
|
|
|
tasm: Number of errors = 0 |
|
|
|
tasm -t80 -g3 bootapp.asm bootapp.bin |
|
|
|
TASM Z80 Assembler. Version 3.2 September, 2001. |
|
|
|
Copyright (C) 2001 Squak Valley Software |
|
|
|
tasm: pass 1 complete. |
|
|
|
Configuration: ZETA Z80 SBC, FLOPPY (AUTOSIZE), PPIDE (STD) |
|
|
|
tasm: pass 2 complete. |
|
|
|
tasm: Number of errors = 0 |
|
|
|
tasm -t80 -g3 loader.asm loader.bin |
|
|
|
TASM Z80 Assembler. Version 3.2 September, 2001. |
|
|
|
Copyright (C) 2001 Squak Valley Software |
|
|
|
tasm: pass 1 complete. |
|
|
|
Configuration: ZETA Z80 SBC, FLOPPY (AUTOSIZE), PPIDE (STD) |
|
|
|
LOADER space remaining: 1205 bytes. |
|
|
|
tasm: pass 2 complete. |
|
|
|
tasm: Number of errors = 0 |
|
|
|
tasm -t80 -g3 pgzero.asm pgzero.bin |
|
|
|
TASM Z80 Assembler. Version 3.2 September, 2001. |
|
|
|
Copyright (C) 2001 Squak Valley Software |
|
|
|
tasm: pass 1 complete. |
|
|
|
tasm: pass 2 complete. |
|
|
|
tasm: Number of errors = 0 |
|
|
|
tasm -t80 -g3 hbios.asm hbios.bin |
|
|
|
TASM Z80 Assembler. Version 3.2 September, 2001. |
|
|
|
Copyright (C) 2001 Squak Valley Software |
|
|
|
tasm: pass 1 complete. |
|
|
|
Configuration: ZETA Z80 SBC, FLOPPY (AUTOSIZE), PPIDE (STD) |
|
|
|
UART occupies 146 bytes. |
|
|
|
FD occupies 2071 bytes. |
|
|
|
PPIDE occupies 809 bytes. |
|
|
|
HBIOS space remaining: 24428 bytes. |
|
|
|
STACK space remaining: 145 bytes. |
|
|
|
tasm: pass 2 complete. |
|
|
|
tasm: Number of errors = 0 |
|
|
|
tasm -t80 -b -g3 -fFF prefix.asm prefix.bin |
|
|
|
tasm -t80 -g3 hbfill.asm hbfill.bin |
|
|
|
TASM Z80 Assembler. Version 3.2 September, 2001. |
|
|
|
Copyright (C) 2001 Squak Valley Software |
|
|
|
tasm: pass 1 complete. |
|
|
|
Configuration: ZETA Z80 SBC, FLOPPY (AUTOSIZE), PPIDE |
|
|
|
Configuration: ZETA Z80 SBC, FLOPPY (AUTOSIZE), PPIDE (STD) |
|
|
|
tasm: pass 2 complete. |
|
|
|
tasm: Number of errors = 0 |
|
|
|
tasm -t80 -b -g3 -fFF loader.asm loader.bin |
|
|
|
tasm -t80 -g3 romfill.asm romfill.bin |
|
|
|
TASM Z80 Assembler. Version 3.2 September, 2001. |
|
|
|
Copyright (C) 2001 Squak Valley Software |
|
|
|
tasm: pass 1 complete. |
|
|
|
Configuration: ZETA Z80 SBC, FLOPPY (AUTOSIZE), PPIDE |
|
|
|
BOOT LOADER space remaining: 3522 bytes. |
|
|
|
tasm: pass 2 complete. |
|
|
|
tasm: Number of errors = 0 |
|
|
|
Building zeta output files... |
|
|
|
Building 512KB zeta ROM disk data file... |
|
|
|
Building ZETA_std output files... |
|
|
|
Building 512KB ZETA_std ROM disk data file... |
|
|
|
|
|
|
|
C:\Users\WWarthen\N8VEM\Build\RomWBW> |
|
|
|
C:\Users\WWarthen\Projects\N8VEM\Build\RomWBW> |