commit 13d2d8e700888bed3670f7de21fbc75da170bb76 Author: Justin Unterreiner Date: Thu Apr 30 20:18:29 2020 -0700 Initial project layout diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..a60467c --- /dev/null +++ b/.gitignore @@ -0,0 +1,276 @@ + +# Created by https://www.gitignore.io/api/aspnetcore +# Edit at https://www.gitignore.io/?templates=aspnetcore + +### ASPNETCore ### +## Ignore Visual Studio temporary files, build results, and +## files generated by popular Visual Studio add-ons. + +# User-specific files +*.suo +*.user +*.userosscache +*.sln.docstates +*.DS_Store + +# User-specific files (MonoDevelop/Xamarin Studio) +*.userprefs + +# Build results +[Dd]ebug/ +[Dd]ebugPublic/ +[Rr]elease/ +[Rr]eleases/ +x64/ +x86/ +bld/ +[Bb]in/ +[Oo]bj/ +[Ll]og/ + +# Visual Studio 2015 cache/options directory +.vs/ +# Uncomment if you have tasks that create the project's static files in wwwroot +#wwwroot/ + +# MSTest test Results +[Tt]est[Rr]esult*/ +[Bb]uild[Ll]og.* + +# NUNIT +*.VisualState.xml +TestResult.xml + +# Build Results of an ATL Project +[Dd]ebugPS/ +[Rr]eleasePS/ +dlldata.c + +# DNX +project.lock.json +project.fragment.lock.json +artifacts/ + +*_i.c +*_p.c +*_i.h +*.ilk +*.meta +*.obj +*.pch +*.pdb +*.pgc +*.pgd +*.rsp +*.sbr +*.tlb +*.tli +*.tlh +*.tmp +*.tmp_proj +*.log +*.vspscc +*.vssscc +.builds +*.pidb +*.svclog +*.scc + +# Chutzpah Test files +_Chutzpah* + +# Visual C++ cache files +ipch/ +*.aps +*.ncb +*.opendb +*.opensdf +*.sdf +*.cachefile +*.VC.db +*.VC.VC.opendb + +# Visual Studio profiler +*.psess +*.vsp +*.vspx +*.sap + +# TFS 2012 Local Workspace +$tf/ + +# Guidance Automation Toolkit +*.gpState + +# ReSharper is a .NET coding add-in +_ReSharper*/ +*.[Rr]e[Ss]harper +*.DotSettings.user + +# JustCode is a .NET coding add-in +.JustCode + +# TeamCity is a build add-in +_TeamCity* + +# DotCover is a Code Coverage Tool +*.dotCover + +# Visual Studio code coverage results +*.coverage +*.coveragexml + +# NCrunch +_NCrunch_* +.*crunch*.local.xml +nCrunchTemp_* + +# MightyMoose +*.mm.* +AutoTest.Net/ + +# Web workbench (sass) +.sass-cache/ + +# Installshield output folder +[Ee]xpress/ + +# DocProject is a documentation generator add-in +DocProject/buildhelp/ +DocProject/Help/*.HxT +DocProject/Help/*.HxC +DocProject/Help/*.hhc +DocProject/Help/*.hhk +DocProject/Help/*.hhp +DocProject/Help/Html2 +DocProject/Help/html + +# Click-Once directory +publish/ + +# Publish Web Output +*.[Pp]ublish.xml +*.azurePubxml +# TODO: Comment the next line if you want to checkin your web deploy settings +# but database connection strings (with potential passwords) will be unencrypted +*.pubxml +*.publishproj + +# Microsoft Azure Web App publish settings. Comment the next line if you want to +# checkin your Azure Web App publish settings, but sensitive information contained +# in these scripts will be unencrypted +PublishScripts/ + +# NuGet Packages +*.nupkg +# The packages folder can be ignored because of Package Restore +**/packages/* +# except build/, which is used as an MSBuild target. +!**/packages/build/ +# Uncomment if necessary however generally it will be regenerated when needed +#!**/packages/repositories.config +# NuGet v3's project.json files produces more ignoreable files +*.nuget.props +*.nuget.targets + +# Microsoft Azure Build Output +csx/ +*.build.csdef + +# Microsoft Azure Emulator +ecf/ +rcf/ + +# Windows Store app package directories and files +AppPackages/ +BundleArtifacts/ +Package.StoreAssociation.xml +_pkginfo.txt + +# Visual Studio cache files +# files ending in .cache can be ignored +*.[Cc]ache +# but keep track of directories ending in .cache +!*.[Cc]ache/ + +# Others +ClientBin/ +~$* +*~ +*.dbmdl +*.dbproj.schemaview +*.jfm +*.pfx +*.publishsettings +node_modules/ +orleans.codegen.cs + +# Since there are multiple workflows, uncomment next line to ignore bower_components +# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622) +#bower_components/ + +# RIA/Silverlight projects +Generated_Code/ + +# Backup & report files from converting an old project file +# to a newer Visual Studio version. Backup files are not needed, +# because we have git ;-) +_UpgradeReport_Files/ +Backup*/ +UpgradeLog*.XML +UpgradeLog*.htm + +# SQL Server files +*.mdf +*.ldf + +# Business Intelligence projects +*.rdl.data +*.bim.layout +*.bim_*.settings + +# Microsoft Fakes +FakesAssemblies/ + +# GhostDoc plugin setting file +*.GhostDoc.xml + +# Node.js Tools for Visual Studio +.ntvs_analysis.dat + +# Visual Studio 6 build log +*.plg + +# Visual Studio 6 workspace options file +*.opt + +# Visual Studio LightSwitch build output +**/*.HTMLClient/GeneratedArtifacts +**/*.DesktopClient/GeneratedArtifacts +**/*.DesktopClient/ModelManifest.xml +**/*.Server/GeneratedArtifacts +**/*.Server/ModelManifest.xml +_Pvt_Extensions + +# Paket dependency manager +.paket/paket.exe +paket-files/ + +# FAKE - F# Make +.fake/ + +# JetBrains Rider +.idea/ +*.sln.iml + +# CodeRush +.cr/ + +# Python Tools for Visual Studio (PTVS) +__pycache__/ +*.pyc + +# Cake - Uncomment if you are using it +# tools/ + +# End of https://www.gitignore.io/api/aspnetcore diff --git a/.vscode/launch.json b/.vscode/launch.json new file mode 100644 index 0000000..d0ba248 --- /dev/null +++ b/.vscode/launch.json @@ -0,0 +1,54 @@ +{ + // Use IntelliSense to find out which attributes exist for C# debugging + // Use hover for the description of the existing attributes + // For further information visit https://github.com/OmniSharp/omnisharp-vscode/blob/master/debugger-launchjson.md + "version": "0.2.0", + "configurations": [ + { + "name": ".NET Core Launch (emulator)", + "type": "coreclr", + "request": "launch", + "preLaunchTask": "build emulator", + // If you have changed target frameworks, make sure to update the program path. + "program": "${workspaceFolder}/emulator/bin/Debug/netcoreapp3.1/emulator.dll", + "args": [ + "run", + "${workspaceFolder}/roms", + "-sfx", + "${workspaceFolder}/roms", + "--debug", + "-a", + "${workspaceFolder}/roms/annotations.txt", + // "--rewind", + // "--load-state", + // "ufo_soon3.state", + // "--break", + // "0x15D3", // DrawSprite: + ], + "cwd": "${workspaceFolder}/emulator", + // For more information about the 'console' field, see https://aka.ms/VSCode-CS-LaunchJson-Console + // "console": "internalConsole", + "console": "externalTerminal", + "stopAtEntry": false + }, + { + "name": ".NET Core Launch (disassembler)", + "type": "coreclr", + "request": "launch", + "preLaunchTask": "build disassembler", + // If you have changed target frameworks, make sure to update the program path. + "program": "${workspaceFolder}/disassembler/bin/Debug/netcoreapp3.1/disassembler.dll", + "args": [], + "cwd": "${workspaceFolder}/disassembler", + // For more information about the 'console' field, see https://aka.ms/VSCode-CS-LaunchJson-Console + "console": "internalConsole", + "stopAtEntry": false + }, + { + "name": ".NET Core Attach", + "type": "coreclr", + "request": "attach", + "processId": "${command:pickProcess}" + } + ] +} diff --git a/.vscode/settings.json b/.vscode/settings.json new file mode 100644 index 0000000..7896e96 --- /dev/null +++ b/.vscode/settings.json @@ -0,0 +1,12 @@ +{ + "editor.tabSize": 4, + "editor.insertSpaces": true, + "files.insertFinalNewline": true, + + "search.exclude": { + "**/bin": true, + "**/obj": true + }, + "csharp.referencesCodeLens.enabled": false, + "dotnet-test-explorer.testProjectPath": "**/*.tests.csproj" +} diff --git a/.vscode/tasks.json b/.vscode/tasks.json new file mode 100644 index 0000000..aa8b848 --- /dev/null +++ b/.vscode/tasks.json @@ -0,0 +1,123 @@ +{ + "version": "2.0.0", + "tasks": [ + { + "label": "build emulator", + "command": "dotnet", + "type": "process", + "args": [ + "build", + "${workspaceFolder}/emulator/emulator.csproj", + "/property:GenerateFullPaths=true", + "/consoleloggerparameters:NoSummary" + ], + "problemMatcher": "$msCompile", + "group": { + "kind": "build", + "isDefault": true + } + }, + { + "label": "build emulator.tests", + "command": "dotnet", + "type": "process", + "args": [ + "build", + "${workspaceFolder}/emulator.tests/emulator.tests.csproj", + "/property:GenerateFullPaths=true", + "/consoleloggerparameters:NoSummary" + ], + "problemMatcher": "$msCompile", + "group": "build" + }, + { + "label": "run emulator.tests", + "command": "dotnet", + "type": "process", + "args": [ + "test", + "${workspaceFolder}/emulator.tests/emulator.tests.csproj", + "/property:GenerateFullPaths=true", + "/consoleloggerparameters:NoSummary" + ], + "problemMatcher": "$msCompile", + "group": { + "kind": "test", + "isDefault": true + } + }, + { + "label": "publish emulator", + "command": "dotnet", + "type": "process", + "args": [ + "publish", + "${workspaceFolder}/emulator/emulator.csproj", + "/property:GenerateFullPaths=true", + "/consoleloggerparameters:NoSummary" + ], + "problemMatcher": "$msCompile" + }, + { + "label": "build Z80", + "command": "dotnet", + "type": "process", + "args": [ + "build", + "${workspaceFolder}/Z80/Z80.csproj", + "/property:GenerateFullPaths=true", + "/consoleloggerparameters:NoSummary" + ], + "problemMatcher": "$msCompile", + "group": { + "kind": "build", + "isDefault": true + } + }, + { + "label": "build Z80.tests", + "command": "dotnet", + "type": "process", + "args": [ + "build", + "${workspaceFolder}/Z80.tests/Z80.tests.csproj", + "/property:GenerateFullPaths=true", + "/consoleloggerparameters:NoSummary" + ], + "problemMatcher": "$msCompile", + "group": "build" + }, + { + "label": "run Z80.tests", + "command": "dotnet", + "type": "process", + "args": [ + "test", + "${workspaceFolder}/Z80.tests/Z80.tests.csproj", + "/property:GenerateFullPaths=true", + "/consoleloggerparameters:NoSummary" + ], + "problemMatcher": "$msCompile", + "group": { + "kind": "test", + "isDefault": true + } + }, + { + "label": "build disassembler", + "command": "dotnet", + "type": "process", + "args": [ + "build", + "${workspaceFolder}/disassembler/disassembler.csproj", + "/property:GenerateFullPaths=true", + "/consoleloggerparameters:NoSummary" + ], + "problemMatcher": "$msCompile", + "group": { + "kind": "build", + "isDefault": true + } + }, + ] +} diff --git a/README.md b/README.md new file mode 100644 index 0000000..bf8171f --- /dev/null +++ b/README.md @@ -0,0 +1,7 @@ +# Pac-Man Emulator + +An emulator for the [Zilog Z80](https://en.wikipedia.org/wiki/Zilog_Z80) CPU and hardware specific to the 1980 arcade game: Pac-Man. + +This is based on the Intel 8080 CPU core from my [Space Invaders emulator](https://github.com/Justin-Credible/space-invaders-emulator). + +🚧 Work in progress! 🚧 diff --git a/assembler/README.md b/assembler/README.md new file mode 100644 index 0000000..fc72a99 --- /dev/null +++ b/assembler/README.md @@ -0,0 +1,8 @@ + +# Assmebler for unit tests + +This directory contains the zasm assembler binary, which is used by the unit test suite. + +More information: + +https://k1.spdns.de/Develop/Projects/zasm/Distributions/ diff --git a/assembler/zasm-4.2.4-Linux64/zasm b/assembler/zasm-4.2.4-Linux64/zasm new file mode 100644 index 0000000..06a2fb8 Binary files /dev/null and b/assembler/zasm-4.2.4-Linux64/zasm differ diff --git a/assembler/zasm-4.2.4-macos10.12/zasm b/assembler/zasm-4.2.4-macos10.12/zasm new file mode 100755 index 0000000..cbf9bf6 Binary files /dev/null and b/assembler/zasm-4.2.4-macos10.12/zasm differ