D1-h development board - Introduction to Nezha development

  Background

last year  Linux-Lab v0.9  Ready to add  RISC-V  Support for , I also applied for one  D1  Development board .

Probably in  2021 year 8 month , I am here  

Notion

  Recorded how to press the official document to test  D1  Development board .

In the later stage, for many reasons , Did not continue to participate in the following development tests .

This article is going to sort out the previous notes , Formally participate in  Linux RISC-V  In the project to .

Today, when I download the source code again , Find out  

repo

  Initialization failed , After reading the online message, there may be something wrong with the Zhuhai server .

You can go here  

https://pan.baidu.com/s/1v55AKMFripaEu22tJ92lmw?pwd=awol

  Download full version  code.

2 Tina Linux  System introduction

【 Which zha 】 Quanzhi online is based on Quanzhi Technology  D1-H  Chip customized  AIoT  Development board , It's the world's first support  64bit RISC-V Instruction set and support  Linux  The mass production development board of the system .

D1-H  By default, Nezha development board comes with  Tina Linux  System . Tina Linux  Quanzhi technology is based on  Linux  Embedded software system for intelligent hardware products developed by kernel .Tina Linux  be based on  openwrt-14.07  Version of the software development package , Contains  Linux  Kernel source code used in system development 、 drive 、 Tools 、 System middleware and application package .

openwrt  It is a well-known open source embedded system  Linux  The system automatically builds the framework , By  Makefile  Scripts and  Kconfig  Configuration file . Make it possible for users to access  menuconfig  To configure , Compile a complete one that can be written directly to the machine  Linux  Systems software .

Tina  The system software architecture is shown in the figure above .

From the bottom to the top  Kernel && Driver、Libraries、System Services、Applications  four layers .

3  Introduction to development

3.1  Source download

3.1.1  The official website of Quanzhi customer service platform ：

Quanzhi customer service platform

  register .

V2.0 SDK  Warehouse download instructions

• Upload public key

• install  repo  Boot script

• Download code

The download server is unified as ：

Please pay attention to downloading ： if there be  lichee  and  android  Two warehouses , Be sure to put it in the same directory

3.1.2  Upload public key

First step ： Generate public key

Use SSH Protocol download , Avoid entering passwords through public key authentication ：

The client generates a public key and private key pair on the machine （ Use command  

ssh-keygen

, Keep going back , Do not enter password ）.

Success will be in  

~/.ssh/

  Generate under directory  id_rsa.pub  and  id_rsa  Two documents .

The second step ： Upload public key

take  id_rsa.pub  Copy the contents of the public key file , Click on   Download resources -> Public key management -> establish , Upload the currently generated public key to the server . After the public key is uploaded successfully , You can download the code .

matters needing attention ：

• Public and private key files must be saved , Can't delete . It is best to back up these two files , It can be recovered in case of accidental deletion .

• When the customer downloads the code , If the command line is preceded by  
  sudo
  , Then the command to generate the public key  
  ssh-keygen
    front   Noodles should also be added  
  sudo
  （ That is, either add  
  sudo
  , Or not at all , Must be consistent ）.

3.1.3  install  repo  Boot script

Out of commission  google  Of , You need to use all wills .

• Download and install from Quanzhi server  repo  Boot script , take  username  Replace with the user name of the customer's download account

$ git clone ssh://[email protected]/git_repo/repo.git

• modify  
  repo/repo
    The next line in the file , take  username  Replace with the user name of the customer's download account

REPO_URL='ssh://[email protected]/git_repo/repo.git'

• hold  repo  Add the boot script to your computer environment variable

$ cp repo/repo /usr/bin/repo$ chmod 777 /usr/bin/repo

3.1.4  The code download

I'll use  Python2, If installed by default  Python3, Need to switch back  Python2.

$ mkdir tina-d1-h$ cd tina-d1-h$ python2.7 /usr/bin/repo init -u ssh://<username>@sdk.allwinnertech.com/git_repo/D1_Tina_Open/manifest.git -b master -m tina-d1-h.xml$ python2.7 /usr/bin/repo sync$ python2.7 /usr/bin/repo start product-smartx-d1-h-tina-stable-v2.0 --all #  After the download is complete , Create a branch

3.2  Compile environment configuration

Embedded product development process , There are usually two key steps , Compile source code and burn firmware . Source code compilation needs to prepare the compilation environment , Firmware burning requires the manufacturer to provide special burning tools . This article mainly introduces how to build an environment to realize  Tina sdk  Compilation and packaging of .

A typical embedded development environment includes local development host and target hardware board ：

The local development host acts as the compilation server , Need to provide  Linux  Operating environment , Build cross compile environment , Provide code update and download for software development , Code cross compilation service .

Local development host through serial port or  USB  Connect to the target hardware board , The compiled image file can be burned to the target hardware board ,  And debug the system or application .

Compilation environment requirements

Tina Linux SDK  Is in  Ubuntu14.04  Development testing , Recommended  Ubuntu 14.04  Host environment for source code compilation .

$ sudo apt-get update$ sudo apt-get install build-essential subversion git-core libncurses5-dev zlib1g-dev gawk flex quilt libssl-dev xsltproc libxml-parser-perl mercurial bzr ecj cvs unzip lib32z1 lib32z1-dev lib32stdc++6 libstdc++6 -y

I tested in  Ubuntu 20.04  It can also be used normally ：

$ sudo apt-get install libc6-i386 libstdc++6-i386-cross lib32ncurses6 lib32z1 -y

3.3  Compile and burn

3.3.1  compile

The compilation and packaging commands are as follows ：

source build/envsetup.shlunch d1_nezha-tinamake -j32pack

among ：

• source build/envsetup.sh
   ： Get environment variables

• lunch d1_nezha-tina
    choice  d1_nezha-tina  programme , You can also directly  
  lunch
  , There will be options to choose , among  
  lunch d1_nezha-tina
    yes  
  d1_nezha-tina
    The standard solution for ,
  lunch d1_nezha_min-tina
    It is the smallest system solution that can only make the system run .

• make -j32
   ： compile , among  -j  The following numerical parameters are the number of threads used for compilation , It can be compiled according to the developer  PC  Choose... According to the actual situation .

• pack
   :  pack , Package the compiled firmware into a  .img  Format firmware , Firmware path  
  /out/d1_nezha-tina/tina_d1-nezha_uart0.img
  .

3.3.2  burning

burning , The compiled and packaged firmware will be downloaded to the device

Introduction to burning method

Quanzhi platform provides developers with a variety of burning methods and tools ：

（1） PhoenixSuit： be based on  Windows  System burning tool , It is the most commonly used burning tool , Through the data line  PC  Connect with the development board , Burn the firmware on the development board , Support partition burning , Suitable for development and small-scale production . It is recommended that developers use this tool to upgrade firmware during development .

（2）LiveSuit： be based on  Ubuntu  System burning tool , Through the data line  PC  Connect with the development board , Burn the firmware on the development board , namely  Ubuntu  Version of  PhoenixSuit, Apply to  Ubuntu  System developers develop and write .

（3）PhoenixUSBpro： be based on  Windows  System burning tool , Through the data line  PC  Connect with the development board , Burn the firmware on the development board , a  PC  Can be connected at the same time  8  device , Control them to burn respectively , Applicable to mass production of production line .

（4）PhoenixCard： be based on  Windows  Mass production of the system  SD  Card making tools , You can put ordinary  .img  The firmware is made into  SD  Card mass production firmware , Insert mass production at the equipment end during production  SD  The card will automatically burn the firmware , For tape  SD  The equipment of card slot is mass produced .

（5） Mass burn production of memory devices ： Use proprietary equipment to burn the firmware to the memory device that is not pasted in advance （ Such as  emmc、nand、nor  etc. ） On , Then put it on the machine , It can improve the production efficiency of the equipment , It is necessary to pull through the memory device before the joint commissioning of the customized equipment of the original factory and Quanzhi , It is suitable for mass production of super large-scale products .

3.4  Introduction to development board hardware

D1-H  Nezha development board , Like a Swiss Army knife , Many external devices can be connected .

3.5  Compile the first program ：Hello World

hello_world.c

#include <stdio.h>int main(int argc, char const *argv[]){ printf(&quot;Hello NeZha\n&quot;); return 0;}

Cross compilation

Cross compilation refers to our  PC  Compile executable program files that can run on the development board on the machine , Because it is compiled on the upper computer , Then run on development boards with different architectures , So called  

Cross compilation

.

./prebuilt/gcc/linux-x86/riscv/toolchain-thead-glibc/riscv64-glibc-gcc-thead_20200702/bin/riscv64-unknown-linux-gnu-gcc -o hello_world hello_world.c

download  Hello World  file

After compilation, the compiled  hello_world  Download the file to the development board and run .

There are many ways to import files , Different people have different opinions . The available methods are listed in the flyer ：

• ADB  Tools

• nfs  Mount file system

• Use  SD  Card mount

$ adb push hello_world ./

3.6 USB  Take pictures with the camera  Demo

USB Camera demo  Code package , Download address ：

D1-H USB camera demo source code

Use the company's  UVC（webcam)  Camera test can capture images .

More examples follow , I didn't test them one by one .

4  Reference documents

• D1-H  Chip introduction

• D1_SDK_Howto

• ADB Download - Get the latest version of ADB and fastboot