[pull] master from lnis-uofu:master

VERSION.md

@@ -1 +1 @@
-1.2.4212
+1.2.4223

docs/source/tutorials/getting_started/compile.rst

@@ -12,14 +12,21 @@ How to Compile
 Supported Operating Systems
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-OpenFPGA is continously tested with Ubuntu 22.04, Ubuntu 24.04 and CentOS 9
+OpenFPGA is continously tested on
+
+- Windows 2025 server (compatible to Windows 10 and Windows 11)
+- Ubuntu 22.04
+- Ubuntu 24.04
+- CentOS 9
+
 It might work with earlier versions and other distributions.
 
 In addition to continous integration, our community users have tested OpenFPGA on their local machines using the following operating systems:
 
 - CentOS 7.8
 - CentOS 7.9
 - CentOS 8
+- Redhat 8
 - Ubuntu 18.04
 - Ubuntu 21.04
 - Ubuntu 20.04 
@@ -35,7 +42,7 @@ In general, please follow the steps to compile
   cd OpenFPGA
   make all
 
-.. note:: OpenFPGA requires gcc/g++ version >= 11 and clang version >= 17.
+.. note:: OpenFPGA requires gcc/g++ version >= 11 or clang version >= 17 or MSVC version >= 14.
 
 .. note:: cmake3.12+ is recommended to compile OpenFPGA with GUI
 
@@ -160,6 +167,32 @@ If your OS is CentOS 9, we offer the script to install all the dependencies.
 .. include:: centos9_dependencies.sh
   :code: shell
 
+Windows (Mingw64)
+^^^^^^^^^^^^^^^^^
+
+If your OS is Msys2 in Windows, we offer the script to install all the dependencies
+
+.. note:: We support only MINGW64 on Msys2. 
+
+.. include:: win_msys2_mingw64.sh
+  :code: shell
+
+Yosys build is not supported yet on Msys2. Please disable it during the build by adding to cmake flags (See details in :ref:`tutorial_compile_build_options`)
+
+.. code-block::
+
+  make all CMAKE_FLAGS="-DOPENFPGA_WITH_YOSYS=OFF -DWITH_ABC=OFF"
+
+Instead, please use the prebuilt version of Yosys at 
+`mingw-w64-x86_64-yosys <https://packages.msys2.org/packages/mingw-w64-x86_64-yosys>`_.
+
+
+Windows (MSVC)
+^^^^^^^^^^^^^^
+
+If your OS is Windows and use Microsoft Visual C++ as compiler, you need to install packages through ``vcpkg``, ``chocolatery`` etc.
+You may refer to the section ``win_msvc_installer`` in ``.github/workflows/build.yml`` for full details.
+
 Running with pre-built docker image
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

docs/source/tutorials/getting_started/win_msys2_mingw64.sh

@@ -0,0 +1 @@
+../../../../.github/workflows/build_dependency_win-msys2-MINGW64.sh