Devector

Overview

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.

Features

• 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

Usage

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

Build

ImGui frontend:

On Windows

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
   

On Linux

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
   

Cross-platform Notes

• 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

WPF frontend:

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

FAQ

Scripts Window

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

---

How can I add a script?

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

---

What functionality do scripts support?

CPU State Access

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

Memory Access

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

Execution Control

Break() -- Stop CPU execution

UI Drawing

• 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)

---

Script Examples

1. Check if BC is overwritten in a critical stack section

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()

2. Draw FPS Counter

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)

3. Draw a Rectangle

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

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

---

Tips

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

local sp = GetSP()

Tagging & publishing

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

Contributing

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

License

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

Acknowledgements

Special thanks to the following people for their contributions:

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