Getting Started Linux

A lot of this is outdated. Documentation is slowly moving over to sap1emu.net/Docs/Docs

Download the Files

To get started, download the latest release for your system at the Releases page.
The following platforms will be supported:

• Linux-x64
• Linux-ARM (Raspberry Pi)
• Linux-MUSL-x64 (not common)

In addition to the command-line programs, the SAP1Emu Project will also support a single GUI using Electron.NET, a wrapper around Electron allowing for ASP.NET Core Linkage.
This GUI should be able to run on Windows, Linux, and OSX with x64-bit architecture. ARM will most likely not be supported.

The GUI program is still under development, but instructions for installing it will be found here.

Extracting the Files

The files come in .tar file to save space when uploading. You will need tar installed on your system to extract the files.

Run the following commands

wget https://github.com/rbaker26/SAP1EMU/releases/download/1.10.2-beta/SAP1Emu-CLI-linux-x64.tar
tar -xvf ./SAP1Emu-CLI-linux-x64.tar
mv linux-x64/ SAP1Emu-CLI-linux-x64/
cd SAP1Emu-CLI-linux-x64/
ls -l

You should see the following output:

<name>@<system>:~/SAP1Emu-CLI-linux-x64$ ls -l
total 376
-rwxr-xr-x 1 name name   204800 Jan  1 19:01 CommandLine.dll
-rwxr-xr-x 1 name name     7168 Apr 30 14:16 SAP1EMU.Assembler.dll
-rwxr-xr-x 1 name name     1676 Apr 30 14:16 SAP1EMU.Assembler.pdb
-rwxr-xr-x 1 name name     7168 Apr 30 14:16 SAP1EMU.Engine.dll
-rwxr-xr-x 1 name name     1644 Apr 30 14:16 SAP1EMU.Engine.pdb
-rwxr-xr-x 1 name name    20992 Apr 30 14:16 SAP1EMU.Lib.dll
-rwxr-xr-x 1 name name     8332 Apr 30 14:16 SAP1EMU.Lib.pdb
-rwxr-xr-x 1 name name    86424 Apr 30 14:16 SAP1Emu
-rwxr-xr-x 1 name name     1950 Apr 30 14:16 SAP1Emu.deps.json
-rwxr-xr-x 1 name name    14336 Apr 30 14:16 SAP1Emu.dll
-rwxr-xr-x 1 name name     2952 Apr 30 14:16 SAP1Emu.pdb
-rwxr-xr-x 1 name name      146 Apr 30 14:16 SAP1Emu.runtimeconfig.json

Installing the .Net Core Runtime

Use the links below to install the .Net Core Runtimes:

• Linux
• Ubuntu 19.04

Testing the Download

The SAP1Emu command-line tools are "run in place". This means, once downloaded, you can just run the files without running an installer.

The SAP1Emu GUI will have an all-in-one installer.

To test the download, follow these steps:

From the SAP1Emu-CLI-linux-x64/ directory, run the following:

./SAP1Emu 

You should see the following output:

C:\Users\007ds\Documents\GitHub\SAP1EMU\SAP1EMU.Engine-CLI\bin\Release\netcoreapp3.1>SAP1Emu.exe
SAP1Emu 1.10.2
2020 Bob Baker

ERROR(S):
  Required option 's, source-file' is missing.

  -s, --source-file     Required.
                        <FileName>.s Input file containing assembly code.
                        <FileName>.b Input file containing compilied binary.

  -o, --output-file     (Default: a.txt) Place the output into <file>.

  -v, --verbose         Set output to verbose.
                        (inlcudes debug statements from the engine)

  -V, --very-verbose    Set output to very verbose.
                        (includes debug statements from the engine and the input file in output)

  -f, --fframe          Include final frame in the output file.

  -F, --Fframe          Include all frames in the output file.

  -O, --FOframe         Include Snapshots of the Output Register in the output file.
                        Parameters:
                          std           Outputs with formatting
                          no-format     Outputs wil no formatting

  -d, --debug           Turns on Debug Mode

  --help                Display this help screen.

  --version             Display version information.

If you see an error regarding .Net Core Runtimes, please refer to these install links (duplicated from above)

• Linux
• Ubuntu 19.04

You're Done

Please see the Your First Program page to learn how to make the assembly files.