Installation

Get BMNNSDK

You can freely downloaded the BMNNSDK installation package at BitMian website https://sophon.cn/drive/35.html or:
1
git clone https://github.com/BM1880-BIRD/bm1880-bmnnsdk-usb.git
Copied!
BM1880 supports three types of run mode, they are USB mode, Cmodel and SoC mode, and we provide compression package, installation package and docker image for each of them.
    Compression package: you can unzip and install manually, making it easy to debug and install.
    Installation package: one-click installation, regardness of installation details.
    Docker image:you can use it directly without changing the host environment.(only for usb mode)
You can choose one that suits your need and download.
    USB Compression package:bmtap2-bm1880-usb_x.y.z.tar.gz

Contents

BMNNSDK installation package contains driver, runtime library, header, tools and example codes.
1
BMNNSDK
2
|-- bin // related tools
3
|-- documents // related documents
4
|-- include // runtime library headerfile, for secondary development
5
|-- lib // runtime library, for runtime and secondary development
6
|-- driver // device driver
7
|-- test // test program
8
|-- example // example code
9
|-- python // Python api
10
|-- install.sh
11
|-- uninstall.sh
Copied!

BMNNSDK installation

We support three types of runtime mode for 1880, they are Cmodel, USB and SoC mode, we will describe how to install and test the SDK for each mode as follow.

USB Mode

In USB mode, BMNNSDK is installed on the X86 host, and calling chip’s computing for deep learning, the environment requirement are as follows.
    Hardware environment: X86 host with usb, BM1880 Neural Network Stick.
    Operating system: Ubuntu/CentOS.
    Package: dkms、libgoogle-glog-dev、libboost-all-dev、libprotobuf-dev, libusb.
    Ubuntu 16.04 is recommended, you can execute below commands to install package.
1
$ sudo apt-get install dkms libgoogle-glog-dev libboost-all-dev libprotobuf-dev
Copied!
Please execute below commands to install package on CentOS(>=7.2)host.

Compression package

Compression package include installation script, please copy the compression package to x86, unzip and execute the script install.sh.
1
$ tar zxvf bmtap2-bm1880-usb-x.y.z.tar.gz
2
$ cd bmtap2-bm1880-usb-x.y.z
3
$ sudo ./install.sh
Copied!
The script will install the BMNNSDK to default directory: /opt/bmtap2, and Symbolic Link will be created in the system content, it also will automatically compile and load the BM1880’s USB device by DKMS, which will drive the bmdnn.ko:
1
// you will see the installation folder in the/opt/bmtap2 after successful installation
2
$ ls /opt/bmtap2
3
4
// symbolic link will be found in /usr/bin、/usr/lib、/usr/include
5
$ ls -alh /usr/bin/bm*
6
$ ls –alh /usr/lib/bm*
7
$ ls –alh /usr/include/bmtap2
8
9
// use lsmod to find driver information
10
$ lsmod | grep bmdnn
11
bmdnn
12
13
// if the host has BM1880 NNS,you will find device fold in the directory/dev
14
$ ls /dev/bm*
15
/dev/bm180-dev0
Copied!
To uninstall the BMNNSDK ,simply execute the uninstall script in the installation directory.
1
$ sudo /opt/bmtap2/bm1880-usb-x.y.z/uninstall.sh
Copied!

Installation package

Installation package is a self-extracting file that can be run directly. Please copy the installation package to x86 host and run it.
1
$ chmod +x bmtap2-bm1880-usb_x.y.z.run
2
$ sudo ./bmtap2-bm1880-usb -x.y.z.run
Copied!
The installation package will install the BMNNSDK to default directory: /opt/bmtap2, and Symbolic Link will be created in the system content, it also will automatically compile and load the BM1880’s USB device by DKMS, which will drive the bmdnn.ko:
1
// you will see the installation folder in the directory /opt/bmtap2 after successful installation
2
$ ls /opt/bmtap2
3
4
// symbolic link will be found in /usr/bin、/usr/lib、/usr/include
5
$ ls -alh /usr/bin/bm*
6
$ ls –alh /usr/lib/bm*
7
$ ls –alh /usr/include/bmtap2
8
9
// use lsmod to find driver information
10
$ lsmod | grep bmdnn
11
bmdnn
12
13
// if the host has BM1880 NNS, you will find the device file in the /dev directory
14
15
$ ls /dev/bm*
16
/dev/bm1880-dev0
Copied!
To uninstall the BMNNSDK ,simply execute the uninstall script in the installation directory.
1
$ sudo /opt/bmtap2/bm1880- pcie-x.y.z/uninstall.sh
Copied!

SoC Mode

In SoC mode, BMNNSDK is installed on the BM1880 Developer Board, use the compluting resources on the BM1880 SoC board to accelerate the deep learning calculation, the environment requirements are as follows.
    Hardware environment:BM1880 SoC board
    Operating system:BM1880 Linux Release

Compression package

Compression package contains the installation script, please copy it to the SoC board, unzip and execute the script install.sh in the directory.
1
$ tar zxvf bmtap2-bm1880-SoC-x.y.z.tar.gz
2
$ cd bmtap2-bm1880-SoC-x.y.z
3
$ sudo ./install.sh
Copied!
The script will install the BMNNSDK to default directory: /opt/bmtap2, and Symbolic Link will be created in the system content, it also will load the BM1880’s TPU driver by insmod, which will drive the bmdnn.ko:
1
// you will see the installation folder in the/opt/bmtap2 after successful installation
2
3
$ ls /opt/bmtap2
4
5
// symbolic link will be found in /usr/bin、/usr/lib、/usr/include
6
$ ls -alh /usr/bin/bm*
7
$ ls –alh /usr/lib/bm*
8
$ ls –alh /usr/include/bmtap2
9
10
// use lsmod to find driver information
11
$ lsmod | grep bmnpu
12
bmnpu
13
14
// you will find device file in the /dev directory
15
$ ls /dev/bm*
16
/dev/bm-npu
Copied!
To uninstall the BMNNSDK ,simply execute the uninstall script in the installation directory.
1
$ sudo /opt/bmtap2/bm1880-SoC-x.y.z/uninstall.sh
Copied!

Installation package

Installation package is a self-extracting file that can be run directly. Please copy the installation package to BM1880 SoC board and run it.
1
$ chmod +x bmtap2-bm1880-SoC_x.y.z.run
2
$ sudo ./bmtap2-bm1880-SoC-x.y.z.run
Copied!
The installation package will install the BMNNSDK to default directory: /opt/bmtap2, and Symbolic Link will be created in the system directory, it also will load the BM1880’s TPU device by insmod, which will drive the bmdnn.ko:
1
// you will see the installation folder in the directory /opt/bmtap2 after successful installation
2
$ ls /opt/bmtap2
3
4
// symbolic link will be found in /usr/bin、/usr/bin、/usr/include
5
6
$ ls -alh /usr/bin/bm*
7
$ ls –alh /usr/lib/bm*
8
$ ls –alh /usr/include/bmtap2
9
10
// use lsmod to find driver information
11
$ lsmod | grep bmnpu
12
bmnpu
13
14
// you will find the device file in the /dev directory
15
$ ls /dev/bm*
16
/dev/bm-npu
Copied!
To uninstall the BMNNSDK ,simply execute the uninstall script in the installation directory.
1
$ sudo /opt/bmtap2/bm1880- SoC-x.y.z/uninstall.sh
Copied!

CModel

In CModel, BMNNSDK use the host’s CPU for deeplearning compulting, you can use the BMNNSDK or develop the BMNNSDK application without BM1880 device. And the environment requirements are as follows:
    Hardware:X86 host
    Operating:Ubuntu/CentOS
    Software package:libgoogle-glog-dev、libboost-all-dev、libprotobuf-dev
1
$ sudo apt-get install libgoogle-glog-dev libboost-all-dev libprotobuf-dev
Copied!

Compression package

Compression package contains the installation script, please copy it to the x86 host, unzip and execute the script install.sh in the directory.
1
$ tar zxvf bmtap2-bm1880-cmodel-x.y.z.tar.gz
2
$ cd bmtap2-bm1880- cmodel-x.y.z
3
$ sudo ./install.sh
Copied!
The script will install the BMNNSDK to default directory: /opt/bmtap2, and Symbolic Link will be created in the system content.
1
// you will see the installation folder in the/opt/bmtap2 after successful installation
2
3
$ ls /opt/bmtap2
4
5
// symbolic link will be found in /usr/bin、/usr/lib、/usr/include
6
$ ls -alh /usr/bin/bm*
7
$ ls –alh /usr/lib/bm*
8
$ ls –alh /usr/include/bmtap2
Copied!
To uninstall the BMNNSDK ,simply execute the uninstall script in the installation directory.
1
$ sudo /opt/bmtap2/bm1880-cmodel-x.y.z/uninstall.sh
Copied!

Installation package

Installation package is a self-extracting file that can be run directly. Please copy the installation package to x86 host and run it.
1
$ chmod +x bmtap2-bm1880-cmodel_x.y.z.run
2
$ sudo ./bmtap2-bm1880- cmodel -x.y.z.run
Copied!
The installation package will install the BMNNSDK to default directory: /opt/bmtap2, and Symbolic Link will be created in the system directory.
1
// you will see the installation folder in the directory /opt/bmtap2 after successful installation
2
$ ls /opt/bmtap2
3
4
// symbolic link will be found in /usr/bin、/usr/bin、/usr/include
5
$ ls -alh /usr/bin/bm*
6
$ ls –alh /usr/lib/bm*
7
$ ls –alh /usr/include/bmtap2
Copied!
To uninstall the BMNNSDK ,simply execute the uninstall script in the installation directory.
1
$ sudo /opt/bmtap2/bm1880- cmodel-x.y.z/uninstall.sh
Copied!
Last modified 2yr ago