Guides

Version:
1.0
Author:
Lee Bendall
Software
Beginner
Download Guide Files

AsmToDsk Installation Instructions

The TatungBytes AsmToDsk tool is a wrapper for z88dk and Mame, allowing you to quickly assemble your code, create a .dsk image with your compiled program, and mount that .dsk image in M.A.M.E. to see your program running on the Tatung Einstein.

So lets begin with the setup of the pre-requisites, which at first glance may appear a little daunting, but rest assured if you follow the instructions outlined this is quite a painless process.

Pre-requisites

1. Having downloaded the AsmToDsk tool from the Tatung Bytes website, you now need to extract it to your folder of choice. Once done please follow the rest of the pre-requisite instructions.

2. Z88DK

2.1. Download the latest version of z88dk from https://github.com/z88dk/z88dk/releases  and then unzip the file to your folder of choice. If you would like more information on what this program does or how to use it from the command line then please visit their website https://z88dk.org/site/ where they have a wealth of information available.

2.2. You now need to add “your folder of choice” from step one to your systems path by clicking on the windows “Search” field at the bottom of your screen and typing "environment variables. The following screen will appear.

2.3 Select “Path” in the top window click "Edit," the following screen will appear.

2.4 Click on “New” and enter the path to “your folder of choice”. For example if you folder of choice was C:\users\Dave\z88dk this is what needs to be entered here.

2.5 Now click on OK for both windows. Note: if you already had a windows command prompt window open you will need to restart it in order for these change to take effect.

3. MAME

3.1 If you have M.A.M.E. installed already then proceed to Step 4 if not then you need to download it from the following link - https://www.mamedev.org/release.html, Once downloaded you need to extract the contents to a directory of your choice.

3.2 In your M.A.M.E installation directory you now need to navigate to the ROMS folder and need to create a folder called ‘einstein’.

3.3 Now extract the contents of the “einstein.zip” located in the AsmToDsk folder you created in step one to the einstein folder you just created.

4. Python

4.1 If you have Python installed already then proceed to Step 5 if not then you can either download and install the latest version from here https://www.python.org/downloads/ or use the Python installer in the AsmToDsk folder. IMPORTANT - when installing Python for the first time, you must click the Add Python.exe to PATH check box shown below.

That Completes the Pre-requisites Section - Please proceed to the next guide "AsmToDsk part 2" where we will setup the AsmToDsk Program.