View source for NanoPi Duo2

[[NanoPi Duo2/zh|查看中文]]

==Introduction==
[[File:NanoPi Duo2-1.jpg|thumb|frameless|300px|Overview]]
[[File:NanoPi Duo2-2.jpg|thumb|frameless|300px|Front]]
[[File:NanoPi Duo2-3.jpg|thumb|frameless|300px|Back]]
* The NanoPi Duo2("Duo2") is an ARM board designed and developed by FriendlyELEC for makers and hobbyists. It is only 55 x 25.4mm. It features Allwinner quad-core A7 processor H3, and has 256M/512M DDR3 RAM, onboard WiFi & bluetooth module and an OV5640 camera interface. It works with Linux variants such as Ubuntu Core.
* The NanoPi Duo2 is tiny and compact with rich interfaces and ports. It takes power input from its MicroUSB port and can be booted from a Micro SD card. It works with general bread-boards. Interface pins such as USB, SPI, UART, I2C, PWM, IR, audio input & output and Fast Ethernet etc are populated.
* The NanoPi Duo2 supports software utilities such as WiringNP and Python etc. These are all open source. It is suited for various IoT applications.

==Hardware Spec==
* CPU: Allwinner H3, Quad-core Cortex-A7 Up to 1.2GHz
* DDR3 RAM: 512M
* Connectivity: 10/100M Ethernet
* WiFi: 802.11b/g/n
* Bluetooth: Bluetooth V4.0 of 1, 2 and 3 Mbps.
* Camera: OV5640
* Key: GPIO Key
* USB Host: 2.54mm pin x2, exposed in 2.54mm pitch pin header
* MicroSD Slot x 1
* MicroUSB: OTG and power input 
* Debug Serial Interface: exposed in 2.54mm pitch pin header
* Audio input/output Interface: exposed in 2.54mm pitch pin header
* GPIO1: 2.54mm spacing 16pin. It includes UART, SPI, I2C, Audio etc
* GPIO2: 2.54mm spacing 16pin. It includes USB,10/100M Ethernet, IO etc
* PCB Dimension: 25.4 x 55mm
* Power Supply: DC 5V/2A
* Temperature measuring range: -40℃ to 80℃
* OS/Software: U-boot，Linux Kernel 4.11.2 (mainline) , Ubuntu 16.04.2 LTS (Xenial)
* Weight: xxg(With Pin-headers)

==Diagram, Layout and Dimension==
===Layout===
[[File:NanoPi-Duo2-layout.jpg |thumb|500px|NanoPi Duo2 Layout]]
[[File:Duo pinout2-02.jpg|thumb|frameless|500px|pinout]]
* '''GPIO Pin Spec'''
::{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="1"| '''Pin#''' || style="background: PaleTurquoise; color: black" colspan="1"| '''GPIO1'''|| style="background: PaleTurquoise; color: black" colspan="1"| '''Name'''|| style="background: PaleTurquoise; color: black" colspan="1"| '''Linux gpio'''|| || style="background: PaleTurquoise; color: black" colspan="1"| '''Pin#'''|| style="background: PaleTurquoise; color: black" colspan="1"| '''GPIO2'''|| style="background: PaleTurquoise; color: black" colspan="1"| '''Name'''|| style="background: PaleTurquoise; color: black" colspan="1"| '''Linux gpio''' 
|-
| 1 || 5V   || VDD_5V         ||     ||   || 2 || RXD  || DEBUG_RX(UART_RXD0)/GPIOA5/PWM0 || 5 
|-
| 3 || 5V   || VDD_5V         ||     ||   || 4 || TXD  || DEBUG_TX(UART_TXD0)/GPIOA4 ||  4 
|- 
| 5 || 3V3  || SYS_3.3V       ||     ||   || 6 || GND  || GND      ||  
|-
| 7 || GND  || GND            ||     ||   || 8 || SCL  || I2C0_SCL/GPIOA11 || 11   
|-
| 9 || IRRX || GPIOL11/IR-RX  || 363 ||   || 10 || SDA  || I2C0_SDA/GPIOA12 || 12
|-
| 11 || PG11 || GPIOG11        || 203 ||   || 12 || CS   || UART3_TX/SPI1_CS/GPIOA13 ||  13 
|-
| 13 || DM3  || USB-DM3        ||     ||   || 14 || CLK  || UART3_RX/SPI1_CLK/GPIOA14 ||  14 
|-
| 15 || DP3  || USB-DP3        ||     ||   || 16 ||MISO || UART3_CTS/SPI1_MISO/GPIOA16   ||  16
|-
| 17 || DM2  || USB-DM2        ||     ||   || 18 || MOSI || UART3_RTS/SPI1_MOSI/GPIOA15 ||  15  
|-
| 19 || DP2  || USB-DP2       ||     ||   || 20 || RX1  || UART1_RX/GPIOG7 || 199
|-
| 21 || RD-  || EPHY-RXN      ||     ||   || 22 || TX1  || UART1_TX/GPIOG6|| 198 
|-
| 23 || RD+  || EPHY-RXP      ||     ||   || 24 || CVBS || CVBS       || 
|-
| 25 || TD-  || EPHY-TXN      ||     ||   || 26 ||LL   || LINEOUT_L  ||  
|-
| 27 || TD+  || EPHY-TXP      ||     ||   || 28 ||LR   || LINEOUT_R  ||
|-
| 29 || LNK  || EPHY-LED-LINK ||     ||   || 30 || MP   || MIC_P   || 
|-
| 31 || SPD  || EPHY-LED-SPD  ||     ||   || 32 ||MN   || MIC_N   || 
|}

* '''Camera（OV5640）Pin Spec'''
::{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="1"| '''Pin#''' || style="background: PaleTurquoise; color: black" colspan="1"| '''Name'''
|-
| 1 || NC1    
|-
| 2 || AGND   
|-
| 3 || SIO-D  
|- 
| 4 || AVDD
|- 
| 5 || SIO-C
|- 
| 6 || RESER
|- 
| 7 || VSYNC
|- 
| 8 || PWDN
|- 
| 9 || HREF
|- 
| 10 || DVDD
|- 
| 11 || DOVDD
|- 
| 12 || Y9/MDP1
|- 
| 13 || XCLK
|- 
| 14 || Y8/MDN1
|- 
| 15 || DGND
|- 
| 16 || Y7/MCP
|- 
| 17 || PCLK
|- 
| 18 || Y6/MCN
|- 
| 19 || Y2
|- 
| 20 || Y5/MDP0
|- 
| 21 || Y3
|- 
| 22 || Y4/MDN0
|- 
| 23 || AF-VDD
|- 
| 24 || NC2
|}


:'''Note'''
::#SYS_3.3V: 3.3V power output
::#VDD_5V: 5V power input/output. When the external device’s power is greater than the MicroUSB's the external device is charging the board otherwise the board powers the external device. The input range is 4.7V ~ 5.6V.
::#All pins are 3.3V, output current is 5mA.
::#For more details refer to :[http://wiki.friendlyarm.com/wiki/images/c/c1/Schematic_NanoPi_Duo2-V1_0-1807.pdf  NanoPi Duo2 Schematic]

===Dimensional Diagram===
[[File:NanoPi-Duo2-V1.0_1807-dimensions.png|frameless|550px|]]

::For more details refer to :[http://wiki.friendlyarm.com/wiki/index.php/File:Dimensions_NanoPi_Duo2_V1.0_1807_PCB.rar NanoPi_Duo2_V1.0_1807 pcb in dxf format]

==Get Started==
===Essentials You Need===
Before starting to use your NanoPi NEO get the following items ready
* NanoPi Duo2
* microSD Card/TFCard: Class 10 or Above, minimum 8GB SDHC
* microUSB power. A 5V/2A power is a must
* A Host computer running Ubuntu 16.04 64 bit system
* A serial communication board

===TF Cards We Tested===
To make your NanoPi Duo2 boot and run fast we highly recommend you use a Class10 8GB SDHC TF card or a better one. The following cards are what we used in all our test cases presented here:
* SanDisk TF 8G Class10 Micro/SD TF card:
[[File:SanDisk MicroSD.png|frameless|100px|SanDisk MicroSD 8G]]
* SanDisk TF128G MicroSDXC TF 128G Class10 48MB/S:
[[File:SanDisk MicroSD-01.png|frameless|100px|SanDisk MicroSD 128G]]
* 川宇 8G C10 High Speed class10 micro SD card:
[[File:SanDisk MicroSD-02.png|frameless|100px|chuanyu MicroSD 8G]]

===Install OS===
====Get Image Files====
Visit this link [http://download.friendlyarm.com/nanopiduo2 download link] to download image files (under the official-ROMs directory) and the flashing utility(under the tools directory):<br />

::{| class="wikitable"
|-
|colspan=2|Image Files:
|-
|nanopi-duo2_sd_friendlycore-xenial_4.14_armhf_YYYYMMDD.img.zip || FriendlyCore (base on UbuntuCore) Image File, Kernel: Linux-4.14                   
|-
|colspan=2|Flash Utility:  
|-
|win32diskimager.rar || Windows utility for flashing Debian image. Under Linux users can use "dd"
|- 
|}

{{BurnOS-Allwinner|NanoPi-Duo2}}

===Work with NanoPi Duo2 IoT-Box Carrier Board===
FriendlyELEC developed a dedicated carrier board: NanoPi Duo2 IoT-Box. For more details about this carrier board refer to: [http://wiki.friendlyarm.com/wiki/index.php/NanoPi_Duo2_IoT-Box Introduction to NanoPi Duo2 IoT-Box]. How is a hardware setup:<br>
[[File:NanoPi_Duo2_NanoPi Duo2 IoT-Box.jpg|frameless|600px|NanoPi Duo2 IoT-Box_NanoPi_Duo2]]

{{FriendlyCoreGeneral|NanoPi-Duo2}}
{{FriendlyCoreAllwinnerH3|NanoPi-Duo2}}

==Make Your Own Linux System==
===使用Linux-4.14 BSP===
Duo2支持使用Linux-4.14内核，Linux-4.14内核主要由开源社区完善，在此基础上友善官方进行自家硬件的适配。<br>
关于H3芯片系列开发板使用主线U-boot和Linux-4.14的方法，请参考维基：[[Building U-boot and Linux for H5/H3/H2+/]] <br>

===使用Linux-3.4 BSP===
Linux3.4 BSP是由H3芯片厂商全志科技提供，在此基础上友善官方进行了自家硬件的适配。<br>

====Preparations====
Get lichee source:
<syntaxhighlight lang="bash">
$ git clone https://github.com/friendlyarm/h3_lichee.git lichee --depth 1
</syntaxhighlight>
Note: "lichee" is the project name named by Allwinner for its CPU's source code which contains the source code of U-boot, Linux kernel and various scripts.

====Install Cross Compiler====
Visit this site [http://download.friendlyarm.com/nanopim1plus download link], enter the "toolchain" directory, download the cross compiler "gcc-linaro-arm.tar.xz" and copy it to the "lichee/brandy/toochain/" directory.

====Compile lichee Source Code====
Compilation of the H3's BSP source code must be done under a PC running a 64-bit Linux.The following cases were tested on Ubuntu-14.04 LTS-64bit:
<syntaxhighlight lang="bash">
$ sudo apt-get install gawk git gnupg flex bison gperf build-essential \
zip curl libc6-dev libncurses5-dev:i386 x11proto-core-dev \
libx11-dev:i386 libreadline6-dev:i386 libgl1-mesa-glx:i386 \
libgl1-mesa-dev g++-multilib mingw32 tofrodos \
python-markdown libxml2-utils xsltproc zlib1g-dev:i386
</syntaxhighlight>

Enter the lichee directory and run the following command to compile the whole package:
<syntaxhighlight lang="bash">
$ cd lichee/fa_tools
$ ./build.sh -b nanopi-m1-plus -p linux -t all
</syntaxhighlight>
After this compilation succeeds a u-boot, Linux kernel and kernel modules will be generated<br>
Note: the lichee directory contains a cross-compiler we have setup. When you compile the source code it will automatically call this cross-compiler.

====Compile U-boot====
Note:you need to compile the whole lichee directory before you can compile U-boot individually.<br>
You can run the following commands to compile U-boot:
<syntaxhighlight lang="bash">
$ cd lichee/fa_tools/
$ ./build.sh -b nanopi-m1-plus -p linux -t u-boot
</syntaxhighlight>
The gen_script.sh script patches the U-boot with Allwinner features. A U-boot without these features cannot work.<br>
Type the following command to update the U-boot on the MicroSD card:
<syntaxhighlight lang="bash">
$ cd lichee/fa_tools/
$ ./fuse.sh -d /dev/sdX -p linux -t u-boot
</syntaxhighlight>
Note: you need to replace "/dev/sdx" with the device name in your system.

====Compile Linux Kernel====
Note:you need to compile the whole lichee directory before you can compile Linux kernel individually.<br>
If you want to compile the Linux kernel run the following command:
<syntaxhighlight lang="bash">
$ cd lichee/fa_tools/
$ ./build.sh -b nanopi-m1-plus -p linux -t kernel
</syntaxhighlight>
After the compilation is done a boot.img and its kernel modules will be generated under "linux-3.4/output".

====Clean Source Code====
<syntaxhighlight lang="bash">
$ cd lichee/fa_tools/
$ ./build.sh -b nanopi-m1-plus -p linux -t clean
</syntaxhighlight>

==Resources==
===Datasheets & Schematics===
* Schematic: [http://wiki.friendlyarm.com/wiki/images/c/c1/Schematic_NanoPi_Duo2-V1_0-1807.pdf  NanoPi Duo2 V1.0 1807 Schematic] 
* Dimensional Diagram: [http://wiki.friendlyarm.com/wiki/index.php/File:Dimensions_NanoPi_Duo2_V1.0_1807_PCB.rar  NanoPi Duo2 V1.0 1807 PCB Dimensional Diagram] 
*  H3's datasheet [http://wiki.friendlyarm.com/wiki/images/4/4b/Allwinner_H3_Datasheet_V1.2.pdf Allwinner_H3_Datasheet_V1.2.pdf]

==Hardware Update Versions==
===V1.0 1807===
First Version

{{H3ChangeLog|NanoPi-Duo2}}

==Update Log==
===Oct-10-2018===
* Released English Version