View source for Linux BSP User Guide for jetson series

== Linux BSP Version ==

Ubuntu 18.04

Kernel 4.9.201

== Build Environment on Host ==

Currently, we adopt [https://www.docker.com/ Docker] as build environment.

You can get the latest version of advrisc/u18.04-imx8lbv1 Docker image for developing nVidia jetson&nbsp;projects.

Docker command:
<pre>$ docker pull advrisc/u18.04-imx8lbv1</pre>

== Run Docker example ==

Step1 Run docker container (example)
<pre>sudo docker run -it --name jetson_linux_risc -v /home/bsp/myLinux:/home/adv/BSP:rw --privileged advrisc/u18.04-imx8lbv1:latest /bin/bash
</pre>

Step2 In container, change the user. (example)
<pre> adv@7cc0fa834366:~$ sudo chown adv:adv -R BSP</pre>

== Install Some tools ==
<pre>$sudo apt-get install expect 
</pre>

== Getting Linux Source Code ==

EPC-R7200
<pre>$ cd ~/BSP
$ mkdir jetson_linux_risc
$ cd jetson_linux_risc
$ git config --global user.name "Your Name"
$ git config --global user.email you@example.com
$ ../repo/repo init -u https://gitlab.wise-paas.com/epc-r7200/manifests.git
$ ../repo/repo sync
</pre>

AIR-020
<pre>$ cd ~/BSP
$ mkdir jetson_linux_risc
$ cd jetson_linux_risc
$ git config --global user.name "Your Name"
$ git config --global user.email you@example.com
$ ../repo/repo init -u https://gitlab.wise-paas.com/air-020/manifests.git
$ ../repo/repo sync
</pre>

== Build Image ( EPC-R7200 / AIR-020 ) ==

Xavier NX / TX2 NX
<pre>$ cd $TOP
$ sudo ./scripts/build.sh -s 186
</pre>

Nano
<pre>$ cd $TOP
$ sudo ./scripts/build.sh -s 210
</pre>

== Build Kernel ==

Xavier NX / TX2 NX
<pre>$ cd $TOP
$ sudo ./scripts/build_kernel.sh -s 186
</pre>

Nano
<pre>$ cd $TOP
$ sudo ./scripts/build_kernel.sh -s 210</pre>

== Flash Image ==

Before flashing the image, power off the DUT, press recovery button and power on.

{| border="1" cellspacing="1" cellpadding="1" style="width: 891px;"
|-
! scope="row" | <br/>
! scope="col" style="width: 389px;" | EPC-R7200<br/>
! scope="col" style="width: 438px;" | AIR-020<br/>
|-
! scope="row" | Xavier NX<br/>
| style="width: 389px;" | $ cd $TOP/Linux_for_Tegra/186/<br/>$ sudo ./flash.sh -d <span style="color:#800080;">./bootloader/</span><span style="color:#0000FF;">tegra194-epcr7200.dtb</span><span style="color:#0000FF;"></span> &nbsp;<span style="color:#0000FF;">jetson-xavier-nx-devkit-emmc</span> mmcblk0p1<br/>
| style="width: 438px;" | $ cd $TOP/Linux_for_Tegra/186/<br/>$ sudo ./flash.sh <span style="color:#0000FF;">jetson-xavier-nx-devkit-emmc</span> mmcblk0p1
|-
! scope="row" | TX2 NX<br/>
| style="width: 389px;" | $ cd $TOP/Linux_for_Tegra/186/<br/>$ sudo ./flash.sh -d ./<span style="color:#800080;">bootloader/</span><span style="color:#0000FF;">tegra186-epcr7200.dtb</span> &nbsp;<span style="color:#0000FF;">jetson-xavier-nx-devkit-tx2-nx</span> mmcblk0p1<br/>
| style="width: 438px;" | $ cd $TOP/Linux_for_Tegra/186/<br/>$ sudo ./flash.sh <span style="color:#0000FF;">jetson-xavier-nx-devkit-tx2-nx</span> mmcblk0p1<br/>
|-
! scope="row" | Nano
| style="width: 389px;" | $ cd $TOP/Linux_for_Tegra/210/<br/>$ sudo ./flash.sh -d ./<span style="color:#800080;">bootloader/</span><span style="color:#0000FF;">tegra210-epcr7200.dtb</span> &nbsp;<span style="color:#0000FF;">jetson-nano-devkit-emmc</span> mmcblk0p1<br/>
| style="width: 438px;" | $ cd $TOP/Linux_for_Tegra/210/<br/>$ sudo ./flash.sh <span style="color:#0000FF;">jetson-nano-devkit-emmc</span> mmcblk0p1<br/>
|}

== Flash DTB ==

==== Xavier NX ====

EPC-R7200
<pre>$ cd $TOP/Linux_for_Tegra/186/
$ sudo ./flash.sh -r -k kernel-dtb xavier-nx-epcr7200 mmcblk0p1
</pre>

AIR-020
<pre>$ cd $TOP/Linux_for_Tegra/186/
$ sudo ./flash.sh -r -k kernel-dtb jetson-xavier-nx-devkit-emmc mmcblk0p1
</pre>

==== TX2 NX ====

EPC-R7200
<pre>$ cd $TOP/Linux_for_Tegra/186/
$ sudo ./flash.sh -r -k kernel-dtb tx2-nx-epcr7200 mmcblk0p1
</pre>

AIR-020
<pre>$ cd $TOP/Linux_for_Tegra/186/
$ sudo ./flash.sh -r -k kernel-dtb jetson-xavier-nx-devkit-tx2-nx mmcblk0p1
</pre>

==== Nano ====

EPC-R7200
<pre>$ cd $TOP/Linux_for_Tegra/210/
$ sudo ./flash.sh -r -k DTB nano-epcr7200 mmcblk0p1
</pre>

AIR-020
<pre>$ cd $TOP/Linux_for_Tegra/210/
$ sudo ./flash.sh -r -k kernel-dtb jetson-nano-devkit-emmc mmcblk0p1
</pre>