[中文指南] (Scroll down to see guide in English)
**********************************************
**                                          **
** HqFpga 安装说明                          **
**                                          **
**********************************************
HqFpga支持如下操作系统:
    Windows Win8/Win10/Win11 64位系统

用户只需将HqFpga软件包直接解压缩至目标目录，即可完成安装。

注意目标目录不推荐置于特殊目录（例如桌面）, 带空格的目录（例如"Program files"），
含中文或特殊字符的目录（例如“新建文件夹”）之下。用HqFpga进行设计时创建的工程
目录也需尽量遵循此规则。

在Windows平台上，如果提供了安装程序（名为"setup_hqfpga.exe"或相似名称的程序），
用户可直接运行该安装程序并按照相应指示完成安装。

HqFpga的图形用户界面程序是:
    <hqfpga安装目录>/build/<platform>/hqui/hqui[.exe]

HqFpga的主运行程序是:
    <hqfpga安装目录>/build/<platform>/bin/hqfpga[.exe]

其中 <platform> 为以下之一：
    win_x64         Windows 64位操作系统


HqFpga安装后的目录结构如下所示：
    build/      HqFpga可执行文件及器件文件
    doc/        HqFpga用户手册
    samples/    设计示范例
    driver/     FPGA下载线驱动程序


其中build/目录包含如下子目录:
    + -- common/        公用文件目录，包含器件文件、消息文件等
    + -- ipcreator/     IP 工具相关文件目录
    + -- HqInsight/     FPGA 实时调试器相关文件目录
    + -- <platform>/    平台相关（如win_x64）文件目录
           + -- bin/        主执行程序文件目录
           + -- hqui/       主图形用户界面目录
           + -- lib/        库文件目录

!!!!!!!!
【注意】
!!!!!!!!
多数HqFpga图形用户界面组件依赖于微软Visual C++ 2015-2022 x86和x64再发行
组件包(32位和64位都需要)，用户可以从微软网站下载并安装这两个组件包：
  https://learn.microsoft.com/zh-cn/cpp/windows/latest-supported-vc-redist?view=msvc-140
从该页面上可以找到相关下载链接。或者可以用下面链接直接下载：
  https://aka.ms/vs/17/release/vc_redist.x86.exe  (32位)
  https://aka.ms/vs/17/release/vc_redist.x64.exe  (64位)


[English Guide]
**********************************************
**                                          **
** HqFpga Installation Guide                **
**                                          **
**********************************************
HqFpga runs on the following operating systems:
    Windows Win8/Win10/Win11  64bit platform

Users just needs to de-compress the hqfpga package to a target directory
to complete the installation.

[NOTE] The target directory is not recommended to be set under system
paths, e.g Desktop of users. Also the path name is not recommended to
contain non-ASCII characters or whitespace character (e.g. "Program Files") .
The same naming convention applies to design project path of HqFpga.

On Windows platforms, if there is a setup utility "setup_hqfpga.exe" (or
like-named executable) available, user can also launch it and follow its
on-screen instructions to complete installation process.

The GUI executable of HqFpga is:
    <hqfpga_install_dir>/build/<platform>/hqui/hqui[.exe]

The main executable of HqFpga is:
    <hqfpga_install_dir>/build/<platform>/bin/hqfpga[.exe]

where <platform> is be one the following:
    win_x64         For Windows 64-bit OS

The directory structure after HqFpga installation is as follows:
    build/      HqFpga binary and device files
    doc/        HqFpga user manual
    samples/    samples for quick start
    driver/     FPGA download cable driver

Several sub directories are in build directory:
    + -- common/        HqFpga message, scripts, devices files..., etc.
    + -- ipcreator      HqFpga IP Creator tool
    + -- HqInsight      HqFpga HqInsight FPGA real-time debugging tool
    + -- <platform>/    HqFpga binary for different platforms :
           + -- bin/       Main executable
           + -- hqui/      GUI
           + -- lib/       Library files


!!!!!!!!!!
!! NOTE !!
!!!!!!!!!!
Microsoft Visual C++ 2015-2022 Redistributable x86 and x64, i.e.
BOTH 32 and 64 platform, packages are required for running some of
HqFpga GUI components on Windows platform.

Please download and install the packages from :
  https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-140
where download links can be found.

Or the folowing links can be directly clicked for download:
  https://aka.ms/vs/17/release/vc_redist.x86.exe  (32bit)
  https://aka.ms/vs/17/release/vc_redist.x64.exe  (64bit)