MIX

• MIX UI (debugger) progress
• Translating "FIRST FIVE HUNDRED PRIMES"
• Executing "FIRST FIVE HUNDRED PRIMES"
• Integration with GNU MIX Development Kit (MDK)
• Building
• Dependencies
• mixal command-line help
• TODO

MIX UI (debugger) progress

Translating "FIRST FIVE HUNDRED PRIMES"

mixal --hide-details --interactive --file src/tests/mixal_code/program_primes.mixal

3000: |+| 0000|00|18|35|
3003: |+| 0001|00|00|49|
3004: |+| 0499|01|05|26|
3006: |+| 0002|00|00|50|
3007: |+| 0002|00|02|51|
3008: |+| 0000|00|02|48|
3009: |+| 0000|02|02|55|
3010: |-| 0001|03|05|04|
3011: |+| 3006|00|01|47|
3012: |-| 0001|03|05|56|
3013: |+| 0001|00|00|51|
3014: |+| 3008|00|06|39|
3015: |+| 3003|00|00|39|
3005: |+| 3016|00|01|41|
3017: |+| 2035|00|02|52|
3018: |-| 0050|00|02|53|
3019: |+| 0501|00|00|53|
3020: |-| 0001|05|05|08|
3021: |+| 0000|00|01|05|
3022: |+| 0000|04|12|31|
3023: |+| 0001|00|01|52|
3024: |+| 0050|00|01|53|
3025: |+| 3020|00|02|45|
3026: |+| 0000|04|18|37|
3027: |+| 0024|04|05|12|
3028: |+| 3019|00|00|45|
3029: |+| 0000|00|02|05|
   0: |+|             2|
3016: |+| 1995|00|18|37|
1995: |+|06|09|19|22|23|
1996: |+|00|06|09|25|05|
1997: |+|00|08|24|15|04|
1998: |+|19|05|04|00|17|
1999: |+|19|09|14|05|22|
2024: |+|          2035|
2049: |+|          2010|
3001: |+| 2050|00|05|09|
3002: |+| 2051|00|05|10|
2050: |-|           499|
2051: |+|             3|

Executing "FIRST FIVE HUNDRED PRIMES"

mixal --file src/tests/mixal_code/program_primes.mixal

Integration with GNU MIX Development Kit (MDK)

There is much more powerful project, called "MDK" that can be viewed as IDE for MIX (no support for Windows).

Now, you can compile MIXAL code into MIX byte-code using MDK compiler and then execute compiled program using interpreter from this project.

Here is how:

# Compile MIXAL code on Linux, using MDK
mixasm program_primes.mixal
# or the same, but without debug symbols
mixasm --ndebug program_primes.mixal
# (this will output compiled code in program_primes.mix file)
# now, execute it, using interpreter
#
mixal.exe --execute --mdk --file program_primes.mix

Building

Name	Version	Actual compiler	Version	CMake command
Visual Studio 2019	16.2.3	cl.exe	19.22.27905	-G "Visual Studio 16 2019" -A x64
Clang (VS 2019)	16.2.3	clang-cl.exe	8.0.0	-G "Visual Studio 16 2019" -A x64 -T LLVM
GCC (STL/nuwen.net)	7.3.0	gcc.exe	7.3.0	-G "Unix Makefiles"
GCC (WSL)	7.3.0	gcc	7.3.0	-G "Unix Makefiles"

Third-party dependencies will be downloaded and compiled during the build if they are missing.

I.e, you can install them to speed-up usual edit/compile/run cycle using Vcpkg:

vcpkg install gl3w
vcpkg install sdl2
vcpkg install gtest

Examples:

:: Usual MSVC/x64
cmake -G "Visual Studio 16 2019" ^
  -DCMAKE_INSTALL_PREFIX=install ^
  -A x64 ^
  ..
:: Clang on Windows/x64
cmake -G "Visual Studio 16 2019" ^
  -A x64 ^
  -T LLVM ^
  ..
:: MSVC/x64 with Vcpkg dependencies
:: (Vcpkg installed to C:/libs/vcpkg)
cmake -G "Visual Studio 16 2019" ^
  -A x64 ^
  -DCMAKE_TOOLCHAIN_FILE=C:/libs/vcpkg/scripts/buildsystems/vcpkg.cmake ^
  ..
:: MinGW with custom install folder, Release configuration
:: (MinGW installed to C:\Programs\mingw_gcc_7.3.0)
set path=%path%;C:\Programs\mingw_gcc_7.3.0\bin
cmake -G "Unix Makefiles" ^
  -DCMAKE_BUILD_TYPE=Release ^
  -DCMAKE_INSTALL_PREFIX=install ^
  ..

To build use either generated .sln file or CMake:

cmake --build . --config Release
:: ... and additionally install all targets
cmake --build . --config Release --target install

Dependencies

Core stuff (MIX VM, interpreter, parser, assembler) have no dependencies.
Other things (tools, UI, tests) dependencies listed in third_party/ folder:

• (for command line tools) cxxopts: https://github.com/jarro2783/cxxopts.git
• (for, obviously, tests) gtest : https://github.com/google/googletest.git
• (for debugger UI) imgui : https://github.com/ocornut/imgui.git
• (for imgui) gl3w : https://github.com/skaslev/gl3w.git
• (for imgui) sdl2 : https://github.com/SDL-mirror/SDL.git
• (for imgui, implicitly) opengl

mixal command-line help

MIX interpreter/emulator/compilator
Usage:
  mixal [OPTION...]

  -h, --help          Show this help and exit
  -e, --execute       Compile and execute file with MIXAL code
  -i, --interactive   Compile MIXAL code line by line and print formatted MIX
                      byte-code
  -x, --hide-details  Hide additional information during interactive compile
  -f, --file arg      Input file (either MIXAL code or MIX byte-code)
  -m, --mdk           Interpret <file> as file with GNU MIX Development Kit
                      (MDK) format

TODO

• write debugger/UI, see MDK for reference
• fix static/shared libraries build (with & without Vcpkg):

  cmake -G "Visual Studio 16 2019" ^
    -DBUILD_SHARED_LIBS=ON ^
    -DCMAKE_WINDOWS_EXPORT_ALL_SYMBOLS=ON ..
  

  CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS should not be there (?)
• use Rx & ImGui to build debugger UI
• add index register influence to LD/ST/ADD/SUB and similar tests: LDA 2000,3(1:3)
• add Travis CI build support for Clang
• port everything to WASM (Emscripten)
• clean-up CMake scripts