Xunlong Orange Pi

Orange Pi is A20 based development board produced by Xunlong. The Orange Pi was released in November 2014 and featured a standard TF card slot and a 26 pin GPIO connector (similar to the Raspberry Pi A/B). The Orange Pi franchise has later been supplemented with other Orange Pi boards, but only the original Orange Pi and Orange Pi Mini are actually based on A20.

= Identification = The PCB has the following silkscreened on it: Orange Pi

= Sunxi support =

Current status
Supported, but no longer manufactured by Xunlong. (2016-05-24)

Note: Orange Pi's GMAC is not supported in the community kernel. A commit within Orange Pi Github fork of linux-sunxi-3.4 seems to provide GMAC support for Orange Pi. This has to be proved and merged into linux-sunxi.

Xunlong seems to use an important tweak of both the Linux 3.4 kernel and U-Boot networking code for the Orange Pi: The GMAC driver is specifically modified to set the GMAC_TX_DELAY parameter to 3. This adjusts the relative timing of the clock and data signals to the PHY in order to compensate for differing trace lengths on the PCB (details; the pcDuino3 Nano has the same problem). Without this modification, the Ethernet port will work at 100Mbit, but not (or not reliably) at 1000Mbit. Upstream U-Boot now sets this parameter itself, so the kernel patch isn't needed any more (patch).

Manual build
You can build things for yourself by following our Manual build howto and by choosing from the configurations available below.

Sunxi/Legacy U-Boot
The .fex file can be found in sunxi-boards as orangepi.fex

Mainline U-Boot
For building u-boot, use the orangepi target.

Mainline kernel
Use the sun7i-a20-orangepi.dtb device-tree file for the mainline kernel

= Expansion Port =

The Orange Pi has a 26-pin, 0.1" connector with several low-speed interfaces.

The Orange Pi also has a 18-pin, 0.1" connector with several low-speed interfaces.

= Tips, Tricks, Caveats =

FEL mode
The button marked SW2, located between the VGA and USB host connectors, triggers FEL mode when pressed during boot. (SW2 pulls the A20 BOOTSEL pin to low level.)

If no SD card is present, the A20 will automatically fall back to FEL mode (as this device has no other means of booting, like e.g. onboard NAND flash). So if you want to enforce FEL mode, you may simply remove the SD card and connect to the Orange Pi via the DC input(the one next to the audio output). This also supplies power to the board at the same time.

To verify you have successfully entered FEL mode, check the output of. For the Orange Pi, it should look like: AWUSBFEX soc=00001651(A20) 00000001 ver=0001 44 08 scratchpad=00007e00 00000000 00000000

LEDs
For those with a transparent case (or no case at all) the Orange Pi's LED activity is good. The red power LED (D2) can be turned off.

SATA
If you wish to connect a SATA drive (2.5" mobile harddisk or SSD) to the Orange Pi: Make sure your power supply is connected to the "DC-IN" port, and can deliver sufficient current (e.g. 5V/2000mA). Using the OTG port or an inadequate power supply might result in your SATA device not being detected.

= Adding a serial port =

While the GPIO pinout of the Orange Pi is designed to be compatible to the Raspberry Pi, it's important to notice subtle differences in the serial ports. The Orange Pi has some additional pins that already provide two more serial ports.

The default serial port /dev/ttyS0, used for (bootstrap) debugging and the serial console, is located at J11 - refer to the picture and instructions below. The Raspberry's "original" serial port on GPIO 14 and 15 (CON3, pins 8 and 10) can usually be accessed as /dev/ttyS2 on the Orange Pi. J12 also provides another serial port on pins 4 (RXD) and 6 (TXD), which should map to /dev/ttyS3.

Note: The actual mapping between physical pins, UART numbers and/or device names may depend on the specific kernel and configuration used. If in doubt, check the boot messages:



Locating the UART
The UART pins are located in the upper right corner of the board. They are marked as TX, RX and GND on the PCB. Just attach some leads according to our UART Howto. Do not connect the red wire (VCC or 3.3V/5V), as that might damage your board.

= Pictures =

= Variants =

A20 based

 * The Xunlong Orange Pi Mini was released in November 2014, too. It has two TF card slots and only has 2 USB Host.

Other SoCs

 * The Orange Pi Plus was presented in February 2015. It's a new board, and it uses the AllWinner H3 SoC. It Has a 8GB EMMC Flash, Onboard Network(10/100/1000M Ethernet RJ45), Onboard WIFI(Realtek RTL8189ETV, IEEE 802.11 b/g/n), Video Outputs(Supports HDMI CEC, Supports HDMI 3D function, Integrated CVBS, Supports simultaneous output of HDMI and CVBS) and a 40 pin GPIO header (that mimics the Raspberry Pi A+/B+ models).
 * The Orange Pi 2 and Orange Pi Mini 2 are released in March 2015. They are both based on a quad-core H3 CPU, and offer TF card slot, onboard Network(10/100M Ethernet RJ45), 40 pin GPIO and 4 USB type A connectors. They are difference in onboard wifi. Orange Pi 2 has wifi module, while Orange Pi Mini 2 does not have. However, the two kinds of devices do not have SATA any more.

= Also known as =

= See also = There are several websites about Orange Pi and claiming to support it. It has to be clarified, what is "official" and who is behind this sites.


 * Xunlong Orange Pi site
 * "Official" Github Repository.
 * "Official" Orange Pi Form.
 * Manual for building an SD-card image

Manufacturer images
A various amount of prebuilt images is provided via OrangePi's Website.