6.星空加速卡X3教程--RainBuilder安装(win)



  • 星空加速卡X3教程01--RainBuilder安装(win)

    通过本教程,用户能够了解或掌握:

    1. 星空加速卡X3的驱动程序的安装
    2. 加速卡编译器RainBuilder安装方法

    一、资料下载

    星空加速卡X3相关的工程文件下载地址如下:

    文件名 下载地址
    *X3-win ftp://cloud.corerain.com/X3-win/

    X3-win下载连接中包含每一次的发行版文件夹,其路径结构如下。

     X3-win
    ├─ archive
    │   ├─ X30012345win
    │   │   ├─ pcie-driver.zip
    │   │   ├─ rainbuilder-pkg.zip
    │   │   ├─ device-manager.zip
    │   │	   ├─ uc-cr-example.zip
    │   │   └─ uc-pyruntime.zip
    │   │
    │   ├─ X300xxxxxwin
    │   └─ ...
    │   
    └─ X30023456win
    ├─ device-manager.zip
    ├─ pcie-driver.zip
    ├─ rainbuilder-pkg.zip
    ├─ uc-cr-example.zip
    └─ uc-pyruntime.zip
    

    二、安装PCIE驱动

    以管理员模式运行CMD,在CMD中输入如下命令并重启设备,以开启测试模式。重启后若屏幕右下角出现测试模式的水印,即说明测试模式开启成功。

    bcdedit /set testsigning on
    

    在开启测试模式后,请遵循以下流程来加载PCIE驱动:

    1. 在发行版文件夹中找到PCIE驱动工程(/pcie-driver/MV_PCIE.zip)并解压。

    2. 打开设备管理器,在“其他设备”中找到“PCI设备”;

    3. 右击该设备,点击“更新驱动程序”;

    4. 选择“浏览我的计算机以查找驱动程序软件”;

    5. 点击“浏览”,选中发行版文件夹中的MV_PCIE文件夹,勾选“包括子文件夹”,之后点击“下一步”;

    6. 在弹出的Windows安全中心中选择“始终安装此驱动程序软件”。

    至此,便已完成PCIE驱动的安装。

    三、安装Device Manager

    DeviceManager能够支持多网络切换运行,并支持板卡状态管理。打开CMD,在发行版文件夹中进入device-manager文件夹中,运行DeviceManagerServer.exe,执行后应有如下打印:

    .\DeviceManagerServer.exe
    
    version: 0x72902668
    X3/X6/X9 device ddr init successfully.
    #  |   STATE  |       hw_id        | license
    0  |   idle   |  0x00000000000000  |  valid
    device memory table size: 64
    

    若PCIE驱动加载正常,打印中会列出当前所有加速卡设备的运行状态。

    同时DeivceManager还提供了板卡状态管理工具rdbm。通过rdbm,用户能够进行板卡状态查询,并能通过重置板卡来解决因某些外部错误导致板卡运行出错的问题。其中,rdbm中的did指板卡id。

    rbdm.exe --help
    
    Usage:
    -----------------------------------------------------------
    rbdm -l            	| list all the device and it's state
    rbdm -m did state  	| change did's state to state
    rbdm -c did       	| check license for did
    rbdm -r did        	| reset did
    rbdm -u did        	| dump all the user of did
    rbdm -k did uid    	| remove uid from did
    

    Note:

    1.DeviceManagerServer.exe需在加载PCIE驱动后加载。

    2. 运行板卡时,需要DevicaManager保持开启。

    3.为了保证宿主机环境与加速卡环境的隔离,驱动程序不会在系统启动后自动加载,用户可根据需要自行设置。

    四、安装RainBuilder

    在安装Rainbuilder前,用户需要确认主机系统上已经正确安装了如下程序:

    软件名称 版本号
    Git 2.25.1
    python 3.6.x
    opencv-python 4.2.0
    numpy ≥1.16.0
    cmake ≥3.1
    Visual Studio 2017或2019

    4.1、安装RbCompiler

    在安装RbCompiler前,用户需要安装最新支持的 Visual C++可再发行软件包vc_redist.x64.exe

    在此链接(https://support.microsoft.com/zh-cn/help/2977003/the-latest-supported-visual-c-downloads)进行redist.x64.exe的下载,也可从我们发布的包中获取。下载完成后双击安装后会提示重启电脑,选择立即重启即可。

    打开Git bash,进入到/rainbuilder-pkg路径下,执行安装对应的脚本即可,以CPU版本RainBuilder为例。

    cd /rainbuilder-pkg
    ./install_compiler.sh
    

    Note:

    注意:rainbuilder中的RbCompiler默认安装TensorFlow的解析模块。在rainbuilder-pkg安装包内的compiler_addons内,有caffeONNX以及PyTorch的解析模块安装包,如有需要请使用pip进行安装,其中PyTorch的解析模块需要首先在环境中安装PyTorch的1.4.0版本,具体安装方法参考https://pytorch.org/get-started/locally/

    4.2、安装RbRuntime

    解压/rainbuilder-pkg/runtime_cpu/
    路径下的两个压缩包,WinRbRuntimeCPUvcpkg-export-20190823-112009。之后将如下两个文件路径添加至系统变量中:

    • WinRbRuntimeCPU\\x64-Release\\dll

    • vcpkg-export-20190823-112009\\vcpkg-export-20190823-112009\\installed\\x64-windows\\bin

    具体步骤如下图所示:

    • 在控制面板中进入“系统与安全 > 系统“,点击高级系统设置

    • 点击右下角的“环境变量“

    • 在下方的系统变量中选中“path“,之后点击”编辑

    • 在“编辑环境变量“中点击右侧的”新建“,并将上述dll文件和bin文件所在的绝对路径分别复制至空白处。(图中路径仅作为样例说明)

    最后点击确认即可。

    Note:

    注意:RbRuntime GPU版本仅支持CUDA10.0。

    windows_runtime_install.png

    完成以上操作后,X3加速卡及其开发、运行环境便已部署完成。


登录后回复