9 Star 15 Fork 8

lovingascend / ADKInstaller

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
Readme_EN.md 14.67 KB
一键复制 编辑 原始数据 按行查看 历史
xyttaotao 提交于 2021-08-21 22:58 . update readme

English|中文

ADKInstaller

The ADKInstaller tool runs on an Ubuntu, x86 environment. It is used to set up the PC environment and board environment for the Atlas 200 DK.

Note: The ADK version that this tool is adapted to is version 1.3x, that is, the installation tool when the 200DK operating environment is ubuntu16.04. And the current version of Shengteng official website is no longer maintained, and the warehouse is no longer maintained. For more information, please refer to Ascend's official document https://www.hiascend.com/document and Ascend's official sample repository is https://gitee.com/ascend/samples.

Environment Setup Overview

The following figure shows the functions of ADKInstaller and the process of setting up the environment.

Figure 1 Environment setup flowchart

NOTE:

  • If it is your first time to use Atlas 200 DK, you need to learn the basics about the Atlas 200 DK and prepare the environment.
  • If a prepared SD card is included in your Atlas 200 DK, you can skip the SD card making step.

Preparing for Environment Setup

  1. Learn about the Atlas 200 DK.

    Huawei Atlas 200 Developer Kit (Atlas 200 DK for short) is a developer board product based on the Huawei Ascend 310 processor. It enables one-stop development of AI applications.

    The following figure shows the system block diagram of the Atlas 200 DK.

    Figure 2 Connection between the Atlas 200 DK developer board and Mind Studio

    NOTE:
    The IP address 192.168.1.2/192.168.0.2 in the figure is the IP address of the developer board, which can be selected during SD card making.

    The Atlas 200 DK developer board consists of the Hi3559 camera module and Atlas 200 AI accelerator module. The PC installed with the IDE Mind Studio connects to the Atlas 200 DK developer board over the USB port or Ethernet port.

    Mind Studio provides the device development kit (DDK) and a range of tool modules for model management, operator and model building, and log analysis. The DDK contains the library files required for building on the device side, as well as the tools, dependent libraries, and common header files required on the user's development machine.

  2. Prepare the environment.

    Before starting ADKInstaller, prepare the hardware and environment as follows:

    1). Prepare the Atlas 200 DK, including an SD card for creating the Atlas 200 DK system boot disk, an SD card reader, a Type-C cable used for connecting to the Ubuntu server, and a camera.

    2). Install the Ubuntu 16.04 OS on the server for deploying Mind Studio.

    3). Check if at least 20 GB is available on the Ubuntu OS.

    4). Check if the Ubuntu system memory is at least 4 GB.

Setting up the Environment

  1. Obtain ADKInstaller.

    Log in to the Ubuntu OS, switch to the common user (user who installs the Atlas 200 DK development environment), and run the following command in the command line to download the ADKInstaller software package:

    wget https://obs-book.obs.cn-east-2.myhuaweicloud.com/temp/ADKInstaller.0.0.1.tar.gz

    Run the following commands to decompress the software package and go to the directory where the decompressed file is stored:

    tar -xzvf ADKInstaller.0.0.1.tar.gz

    cd ADKInstaller

    Run the following commands to switch to the root user and grant the sudo permission to the common user:

    su root

    ./add_sudo.sh username

    exit

    NOTE:

    • Replace username with the user name of the common user who installs the Atlas 200DK development environment, for example, ascend.
    • You need to grant the sudo permission to the common user for environment setup. You can run the ./del_sudo.sh username command as the root user to remove its sudo permission afterwards.
  2. Start ADKInstaller.

    During installation, please refer to FAQ for problems( https://gitee.com/lovingascend/ADKInstaller/blob/master/FAQ.md )Solve it.

    Run the following command as the common user in the Ubuntu OS to start ADKInstaller:

    ./ADKInstaller

    Figure 3 shows the ADKInstaller login window.

    Figure 3 Login window

    Enter your user name and password to log in to ADKInstaller. The default language is English. You can change the language as required. If ADKInstaller is started by the root user or an incorrect password is entered, you will not be able to proceed.

    Figure 4 shows the home page after successful login. ADKInstaller will walk you through the major steps of environment setup: SD card making, DK connection, and Mind Studio installation. You will start with STEP 01 Make SD Card.

    Figure 4 ADKInstaller home page

  3. Make an SD card.

    NOTE:
    If you already have your SD card made, check if the developer board can be started properly using this SD card. If yes, click Skip to skip this step.

    1. After login, on the STEP 01 Make SD Card page:

      Confirm the software copyright as shown in Figure 5 and click OK to proceed.

      Figure 5 Software copyright

    2. Click Make SD on the lower right as shown in Figure 6. The environment dependencies will be automatically downloaded and installed.

      When you place the cursor on SD INFO, you can view the IP addresses of the USB NIC and physical NIC of the target developer board. The default IP address of the USB NIC is 192.168.158.2, and that of the physical NIC is 192.168.157.2.

      Figure 6 Start making SD card

    3. In the dialog box (Figure 7) displayed on the click of Make SD, perform the following operations:

      Figure 7 Settings of SD card making

      1. Connect the SD card reader with an SD card inserted to the PC, click Refresh, and select the name of the SD card.
      2. Select the USB NIC IP address (default: 192.168.158.2) and physical NIC IP address of the developer board. The physical NIC IP address is bound to the USB NIC IP address and will be automatically updated with the USB NIC IP address.
      3. Click OK to start SD card making.
    4. After SD card making is completed, a dialog box is displayed, as shown in Figure 8. Click OK.

      Figure 8 SD card making completed

  4. Connect to the Atlas 200 DK.

    NOTE:
    If the Atlas 200 DK has been connected, click Skip to skip this step.

    1. Insert the prepared SD card into the Atlas 200 DK.

    2. Connect the PC and the Atlas 200 DK using a Type-C cable.

    3. Power on the Atlas 200 DK. Wait until all the four LEDs on the board are on (about 15 minutes), indicating that the DK is started successfully.

    4. Click STEP 02 Connect Atlas 200 DK on the left. Click Refresh to refresh the network. The virtual NIC is automatically selected. If there are multiple DKs, select the target virtual NIC. Select the IP address of the Atlas 200 DK. Click Connect to connect to the Atlas 200 DK.

    If you have any questions about DK connection, click tips to view the detailed connection description.

  5. Install Mind Studio.

    1. Click STEP 03 Setup Mind Studio, as shown in Figure 9. Confirm the Mind Studio copyright and click OK.

      Figure 9 Mind Studio copyright

    2. Click Setup in the lower right, as shown in Figure 10. The environment dependencies will be automatically downloaded and installed.

      Figure 10 Preparing for Mind Studio installation

    3. As shown in Figure 11, the environment is ready for Mind Studio installation. Click OK to start to install Mind Studio.

      Figure 11 Mind Studio installation started

    4. After Mind Studio is installed, the message "Mind Studio install successfully" is displayed, as shown in Figure 12.

      Figure 12 Mind Studio installed successfully

    5. Click OK, starting Mind Studio.

      The subsequent operations must be performed in Mind Studio. During Mind Studio startup, you need to confirm whether to import previous configurations.

    NOTE:
    All operations with ADKInstaller are complete. You can run the ./del_sudo.sh username command as the root user to remove the sudo permission.

  6. Configure the DDK and developer board.

    1. Configure the DDK.

      Configure the DDK by referring to the following link:

      https://www.huaweicloud.com/ascend/doc/mindstudio/2.1.0(beta)/zh/zh-cn_topic_0200347960.html

    2. Configure the DK.

      Configure the DK by referring to the following link:

      https://www.huaweicloud.com/ascend/doc/mindstudio/2.1.0(beta)/zh/zh-cn_topic_0200347922.html

    3. Upgrade the DK.

      Upgrade the DK as required by referring to the following link:

      https://www.huaweicloud.com/ascend/doc/mindstudio/2.1.0(beta)/zh/zh-cn_topic_0200348044.html

      You can also perform manual upgrade by referring to the following link (in the case of an upgrade failure):

      https://www.huaweicloud.com/ascend/doc/Atlas200DK/1.31.0.0(beta)/zh/zh-cn_topic_0182634979.html

    4. Synchronize the library files by referring to the following link:

      https://www.huaweicloud.com/ascend/doc/mindstudio/2.1.0(beta)/zh/zh-cn_topic_0201537270.html

Hands-on Your First AI Application

Build your first AI application by referring to the following link:

https://www.huaweicloud.com/ascend/doc/mindstudio/2.1.0(beta)/zh/zh-cn_topic_0200347819.html

Appendix

FAQ

https://gitee.com/lovingascend/ADKInstaller/blob/master/FAQ.md

Python
1
https://gitee.com/lovingascend/ADKInstaller.git
git@gitee.com:lovingascend/ADKInstaller.git
lovingascend
ADKInstaller
ADKInstaller
master

搜索帮助