[[zh:Linbian使用指南]]
== Terminal ==

On Linbian OS, the default terminal application is LXTerminal.

[[File:Lxterminal.png|frameless]]

You can open it from '''Application Menu''' -> '''System Tools'''.

== Camera Module ==
===download source code from github===
*ldcam developed base on gstreamer
:git clone https://github.com/lindenis-org/ldcam-gst.git
===compile===
*compile on v5 board===
::you can execute "make" directly
*compile on your own env
::you should create the Makefile by yourself
===user commd===
:you can use "./ldcam -?" or "./ldcam --help" to get the cmd instructions

== Webcams ==

== Gstreamer ==
=== Camera source ===
*'''lindeniv4l2src: Video (video4linux2) Source''' 
Use for CSI Camera 
Example: 
sudo gst-launch-1.0 lindeniv4l2src device=/dev/video1 ! video/x-raw,width=1920,height=1080,format=I420 ! videoconvert ! sunxifbsink video-memory=24

=== Omx hardware H.264 decoder and encoder ===
*'''omxh264dec: OpenMAX H.264 Video Decoder''' 
Example: 
sudo gst-launch-1.0 filesrc location=1c.mp4 ! qtdemux name=demux demux.video_0 ! queue ! h264parse ! omxh264dec ! videoconvert ! sunxifbsink

*'''omxh264videoenc: OpenMAX H.264 Video Encoder''' 
Example: 
sudo gst-launch-1.0 lindeniv4l2src device=/dev/video1 ! video/x-raw,width=1920,height=1080,format=I420 ! videoconvert ! omxh264videoenc target-bitrate=5000000 ! mpegtsmux ! filesink location=1.ts

=== Display sink ===
*'''sunxifbsink: Accelerated console framebuffer video sink for sunxi-based devices''' 
Example: 
sudo gst-launch-1.0 -v videotestsrc pattern=ball name=left ! sunxifbsink

== Play Video ==

== Play Audio ==

== Python ==

== GPIO ==

== MPP ==

MPP is the media process platform of Allwinner V5, including following components.
* system control, API family: AW_MPI_SYS
: This component deal with the media hardware initialization, other components initialization and component state management and etc.
* video input, API family: AW_MPI_VI
* video output, API family: AW_MPI_VO
* image stitch engine, API family: AW_MPI_ISE
* video encode, API family: AW_MPI_VENC
* video decode, API family: AW_MPI_VDEC
* mux, API family: AW_MPI_MUX
* demux, API family: AW_MPI_DEMUX
* audio input, API family: AW_MPI_AI
* audio output, API family: AW_MPI_AO
* audio endode, API family: AW_MPI_AENC
* audio output, API family: AW_MPI_AOUT
* Region, API family: AW_MPI_RGN

=== Allwinner official documents ===
* MPP Application Development Reference Manual, [http://files.lindeni.org/lindenis-v5/documents/soft_design/MPP/AW%20IPC%e5%aa%92%e4%bd%93%e5%a4%84%e7%90%86%e8%bd%af%e4%bb%b6%e5%bc%80%e5%8f%91%e5%8f%82%e8%80%83.pdf Chinese version].
* ISP Module User Guide, [http://files.lindeni.org/lindenis-v5/documents/soft_design/MPP/MPP_ISP%20%e6%a8%a1%e5%9d%97%e7%94%a8%e6%88%b7%e6%8c%87%e5%8d%97.pdf Chinese version], [http://files.lindeni.org/lindenis-v5/documents/soft_design/MPP/MPP_ISP%20Development%20User%20Guide.pdf English version].
* EVE Application Development Reference Manual, [http://files.lindeni.org/lindenis-v5/documents/soft_design/MPP/EVE%e5%ba%94%e7%94%a8API%e5%8f%82%e8%80%83%e6%89%8b%e5%86%8c.pdf Chinese version], [http://files.lindeni.org/lindenis-v5/documents/soft_design/MPP/EVE%c2%a0Application%c2%a0API%c2%a0Reference%c2%a0Manual_%e5%85%ad%e7%82%b9%e7%a7%91%e6%8a%80.pdf English version].
* Human Counting Application Development Reference Manual, [http://files.lindeni.org/lindenis-v5/documents/soft_design/MPP/AIE_CVE%e4%ba%ba%e5%91%98%e8%ae%a1%e6%95%b0API%e5%8f%82%e8%80%83%e6%89%8b%e5%86%8c.pdf Chinese version]
* Motion Detection Application Development Reference Manual, [http://files.lindeni.org/lindenis-v5/documents/soft_design/MPP/AIE_CVE%e8%bf%90%e5%8a%a8%e7%9b%ae%e6%a0%87%e8%af%86%e5%88%ab%e7%ae%97%e6%b3%95API%e5%8f%82%e8%80%83%e6%89%8b%e5%86%8c.pdf Chinese version]
* Binocular depth of field (DOF) Application Development Reference Manual, [http://files.lindeni.org/lindenis-v5/documents/soft_design/MPP/AIE_CVE%e5%8f%8c%e7%9b%ae%e6%b7%b1%e5%ba%a6%e4%bf%a1%e6%81%af%e7%ae%97%e6%b3%95API%e5%8f%82%e8%80%83%e6%89%8b%e5%86%8c.pdf Chinese version]

=== Samples ===

Please refer to [[#Demo_programs | Demo programs]].

== Demo programs ==

Allwinner release a series of MPP samples. You can download from [https://github.com/lindenis-org/mpp_sample Github].
<pre>
$ git clone https://github.com/lindenis-org/mpp_sample ~/mpp_sample
</pre>

After downloading, You will get the following directory.
<pre>
app/
Makefile.param
README.md
sample_adec/
sample_aenc/
sample_ai/
......
</pre>

'''app/''' includes a set of MPP samples with a command line based menu. '''sample_xxx/''' is a separate sample of the scene. Root privileges is required when run these sample. e.g.
<pre>
$ sudo ./app/release/app_mpp_sample

***************************************************************
1 : vi+(venc+rtsp)+vo
2 : vi+(venc+rtsp)
3 : vi+vo
4 : vi+ise+(venc+rtsp)+vo
5 : [vi+venc+vo]+[ai+aenc+ao]+rtsp
6 : vi->yuv+venc+rtsp
7 : vi+venc+mux
8 : vi+(venc+mux)+vo
9 : demux+vdec+vo
10 : ai+aenc+mux+ao
11 : demux+adec+ao
12 : Quit
***************************************************************
Please choice 1~12 num:
</pre>

=== RTSP ===

==== Location ====

app_mpp_sample

==== Building ====

<pre>
$ cd ~/mpp_sample/app
$ make
</pre>

==== Running ====

<pre>
$ sudo ./release/app_mpp_sample
</pre>
There will shows the following message when you execultive the cmd, and type the num according the menu.
<pre>
***************************************************************
1 : vi+(venc+rtsp)+vo
2 : vi+(venc+rtsp)
3 : vi+vo
4 : vi+ise+(venc+rtsp)+vo
5 : [vi+venc+vo]+[ai+aenc+ao]+rtsp
6 : vi->yuv+venc+rtsp
7 : vi+venc+mux
8 : vi+(venc+mux)+vo
9 : demux+vdec+vo
10 : ai+aenc+mux+ao
11 : demux+adec+ao
12 : Quit
***************************************************************
Please choice 1~12 num: 1

***************************************************************
1 : Set VI+VENC scene (Resolution, default:4K@25fps+720P@25fps)
2 : Set VENC Payload Type (H264/H265, default:H264)
3 : Set VENC RC Mode (CBR/VBR/FIXQP, default:CBR)
4 : Set VENC Profile (BL/MP/HP, default:Main Profile)
5 : Set VENC rotate (0/90/180/270, default:rotate_0)
6 : Save confige and run this sample
***************************************************************
Please choice 1~6 num: 1

***************** Choice VI+VENC scene **************************
[0]:VI_4K@30fps + VENC(4K@30fps+VGA@30fps)
[1]:VI_4K@25fps + VENC(4K@25fps+720P@25fps) [default]
[2]:VI_2K@30fps + VENC(2K@30fps+720P@30fps)
[3]:VI_1080P@30fps + VENC(1080P@30fps+720P@30fps)
[4]:VI_2880x2160@30fps + VENC(2880x2160@30fps+1080P@30fps)
[5]:VI_2592x1944@30fps + VENC(2592x1944@30fps+1080P@30fps)
Please choose VI+VENC scene ID 0~3 or (q-Quit): 1

***************************************************************
1 : Set VI+VENC scene (Resolution, default:4K@25fps+720P@25fps)
2 : Set VENC Payload Type (H264/H265, default:H264)
3 : Set VENC RC Mode (CBR/VBR/FIXQP, default:CBR)
4 : Set VENC Profile (BL/MP/HP, default:Main Profile)
5 : Set VENC rotate (0/90/180/270, default:rotate_0)
6 : Save confige and run this sample
***************************************************************
Please choice 1~6 num: 6
</pre>

=== Face detection ===

Face detection based on EVE.

==== Location ====

sample_face_detect

==== Building ====

<pre>
$ cd ~/mpp_sample/sample_face_detect
$ make
</pre>

==== Running ====

<pre>
$ sudo ./sample_face_detect
</pre>

The picture of face crop and store at '''./pic''' directory when detected.

==== Test result ====
[[File:Face detect.jpg|frameless]]

=== Motion detection ===

Motion detection based on CVE.

==== Location ====

sample_AILib/sample_vi2MOD

==== Building ====

<pre>
$ cd ~/mpp_sample/sample_AILib/sample_vi2MOD
$ make
</pre>

==== Running ====

<pre>
$ sudo ./sample_vi2MOD -path sample_vi2MOD.conf
</pre>

The information of detected target was stored at ./DTCAResult.bin .

=== Human counting ===

Hunman counting based on CVE.

==== Location ====

sample_AILib/sample_vi2HCNT

==== Building ====

<pre>
$ cd ~/mpp_sample/sample_AILib/sample_vi2HCNT
$ make
</pre>

==== Running ====

<pre>
$ sudo ./sample_vi2HCNT -path sample_vi2HCNT.conf
</pre>

The information of detected target was stored at ./HCNTResult.bin .

=== VLPR ===

VLPR based on CVE.

==== Location ====

sample_AILib/sample_vi2VLPR

==== Building ====

<pre>
$ cd ~/mpp_sample/sample_AILib/sample_vi2VLPR
$ make
</pre>

==== Running ====

<pre>
$ sudo ./sample_vi2VLPR -path sample_vi2VLPR.conf
</pre>

The information of detected vehicle license plate was stored at ./VLPRResult.bin .

=== Binocular depth information image ===

BDII based on CVE.

==== Location ====

sample_AILib/sample_BDII

==== Building ====

<pre>
$ cd ~/mpp_sample/sample_AILib/sample_vi2BDII
$ make
</pre>

==== Running ====

<pre>
$ sudo ./sample_vi2BDII -path sample_vi2BDII.conf
</pre>

The output is a 8bit-gray-scale picture, stored at ./BDIIResult.bin .

=== Image stitch ===

Camera module is in development.

Linbian Usage Guide

2019-01-23T02:50:50Z

Ardon: /* Demo programs */

Ardon: /* Add Service In Running Environment */

Linbian Configuration

2018-09-04T07:50:59Z

Ardon: /* Add Service In Running Environment */

Linbian Configuration

2018-09-04T07:45:32Z

Ardon: /* Wi-Fi */