Devector is a multi-platform emulator of a Soviet personal computer Vector06c. It is designed to simplify the development process and speed up the work. Currently, it is in the early stages of development, so please use it on your own risk.

• A multi-platform precise emulator of a Soviet personal computer Vector06c
• Debugging functionality
• FDD support
• Up to 8 RAM Disk support
• AY & bipper & 3-channel timer support
• Recording a playback with options to store, load, and play it

To run the emulator: ./Devector.exe <-settingsPath settings.json> <-path rom_fdd_rec_file>

Requirements:

• VS 2019+ C++ development environment
• MSYS2 with MinGW-w64 toolchain

Steps:

1. Install MSYS2 from https://www.msys2.org/
2. Run MSYS2 UCRT64 terminal
3. Install the MinGW-w64 toolchain:

   pacman -S --needed base-devel mingw-w64-ucrt-x86_64-toolchain mingw-w64-ucrt-x86_64-cmake mingw-w64-ucrt-x86_64-ninja

   Enter Y when prompted
4. Update your system PATH environment variable by adding:

   C:\msys64\ucrt64\bin
   

5. Clone the repository and build:

   mkdir build
   cd build
   cmake .. -G "MinGW Makefiles"
   cmake --build . --config Release

Requirements:

• GCC 13+ or compatible compiler
• CMake 3.22+
• Development packages for X11, OpenGL, and audio

Steps:

1. Install dependencies:

   sudo apt update
   sudo apt-get install -y \
     build-essential \
     cmake \
     ninja-build \
     pkg-config \
     git \
     libx11-dev \
     libxcursor-dev \
     libxrandr-dev \
     libxinerama-dev \
     libxi-dev \
     libxext-dev \
     libxfixes-dev \
     libgl1-mesa-dev \
     libglu1-mesa-dev \
     libasound2-dev \
     libpulse-dev \
     libudev-dev \
     libdbus-1-dev \
     libusb-1.0-0-dev \
     libwayland-dev \
     wayland-protocols \
     libxkbcommon-dev \
     libegl1-mesa-dev \
     libdrm-dev \
     libxss-dev \
     libgbm-dev

2. Clone the repository and build:

   mkdir build
   cd build
   cmake .. -G Ninja
   ninja

   Alternative using Make:

   mkdir build
   cd build
   cmake ..
   cmake --build . --config Release

• The project uses C++20 standard
• CMake automatically downloads and builds dependencies (SDL3, ImGui, LuaJIT, etc.)
• The executable and required files will be placed in the bin/ directory after building
• Use the run target to automatically execute after building: cmake --build . --target run

Requirements:

• VS 2019+ C++ development environment

Steps:

1. Open DevectorWPF.sln in Visual Studio
2. Install required NuGet package:
   • Tools → NuGet Package Manager → Package Manager Console
   • Run: Install-Package ModernWpfUI
3. Build the solution

Scripts are short code excerpts written in Lua. They are executed on every CPU command and can:

• Access memory and registers
• Interact with hardware state
• Interrupt execution
• Draw primitives on the screen

You can add a script in the Debug Data window under the Scripts tab.

GetCC()      -- Get CPU cycles
GetPC()      -- Get Program Counter
GetSP()      -- Get Stack Pointer
GetPSW()     -- Get Program Status Word
GetBC()      -- Get BC register pair
GetDE()      -- Get DE register pair
GetHL()      -- Get HL register pair
GetA()       -- Get A register
GetF()       -- Get Flags register
GetB(), GetC(), GetD(), GetE(), GetH(), GetL() -- Individual registers

GetFlagS()   -- Sign flag
GetFlagZ()   -- Zero flag
GetFlagAC()  -- Auxiliary Carry flag
GetFlagP()   -- Parity flag
GetFlagC()   -- Carry flag
GetINTE()    -- Interrupt Enable
GetIFF()     -- Interrupt Flip-Flop state
GetHLTA()    -- Temporary HL register
GetMachineCycles() -- Current machine cycles

GetOpcode()  -- Current opcode

GetByteGlobal(addr) -- Read a byte at a global memory address

Break() -- Stop CPU execution

• DrawText

DrawText(id, "TEXT", x, y, <color=0xFFFFFFFF>, <vectorScreenCoords=true>)

• color: RGBA (e.g., 0xFFFFFFFF)

• Negative x/y: origin from right/bottom

• vectorScreenCoords:

  • true: Vector06C screen coordinates (active screen only)
  • false: Full display window

• DrawRect

DrawRect(id, x, y, width, height, <color=0xFFFFFFFF>, <vectorScreenCoords=true>)

• DrawRectFilled

DrawRectFilled(id, x, y, width, height, <color=0xFFFFFFFF>, <vectorScreenCoords=true>)

• GetLabelAddr

addr = GetLabelAddr(labelName) -- Get Label's addr (addr<0 - fail, addr=>0 - success)

local sp = GetSP()
if sp > 0x7FBE and sp < 0x7FFE then return end
local opcode = GetOpcode()
if opcode > 0x4F then return end
if opcode > 0x0E and opcode < 0x40 then return end

local opcodesToSkip = {
    [0x00] = true,
    [0x02] = true,
    [0x07] = true,
    [0x08] = true,
    [0x09] = true,
    [0x0A] = true,
}
if opcodesToSkip[opcode] then return end
if not GetINTE() then return end
if GetByteGlobal(0x38) ~= 0xC3 or GetByteGlobal(0x39) ~= 0x78 or GetByteGlobal(0x3A) ~= 0x05 then return end

print("Warning! Overwriting BC in a stack critical section")
print(string.format("PC = %04X", GetPC()))
print(string.format("Opcode = %02X", opcode))
Break()

local pc = GetPC()
if pc ~= 0x5CB then return end

local fpsL = GetByteGlobal(0x5CC)
local fpsH = GetByteGlobal(0x5CD)
local fps = fpsH * 256 + fpsL

DrawText(0, string.format("FPS %d", fps), 0, 0, 0xFFFFFFFF, false)

local pc = GetPC()
if pc ~= 0x5CB then return end

DrawRect(1, 0, 0, 16, 16, 0xFFFFFF80)

• Each function like GetSP() or GetHL() is expensive to call repeatedly.
• Store results in local variables:

local sp = GetSP()

To create an annotated Git tag locally and publish it to the remote (this will commonly trigger CI workflows set to run on tags):

# create an annotated tag with a message
git tag -a v9.4.2 -m "Release v9.4.2"

# push the single tag to origin
git push origin v9.4.2

# alternatively push all tags
git push --tags

Contributions are welcome! If you find a bug or have an idea for a feature, please create an issue or submit a pull request.

Devector is licensed under the MIT License. See the LICENSE file for more information.

Special thanks to the following people for their contributions:

• Svofski
• Viktor Pykhonin
• Yuri Larin
• zx-pk.ru comunity