Getting Started with P2-Zero

From Banana Pi Wiki
Revision as of 02:16, 2 September 2020 by Dangku (talk | contribs) (Install Linux Image on P2 Zero)
Jump to: navigation, search


Overview: BPI-M2Z raspbian

BPI-P2 Zero

Banana Pi BPI-P2 Zero is an ultra compact single board computer measures only 65mm*52.5mm. It uses quad-core Cortex A7 allwinner H2+ processor(Option : H3 and H5), with 512MB RAM memory.8G eMMC flash,100M LAN,add PoE function support , It's ideal for light-weight systems with some space-limited applications. Like other members of Banana Pi, it supports both linux and android operating system.

Key Features

  • CPU: Allwinner H2+, Quad-core Cortex-A7
  • 512MB DDR 3 SDRAM
  • WiFi (AP6212) & Bluetooth onboard
  • Mini HDMI
  • 40 PIN GPIO, It includes UART, SPI, I2C, IO etc
  • 100M LAN
  • IEEE 802.3af PoE standard PoE module support
  • 8G eMMC flash onboard


Basic Development

Prepare to develop

 * Prepare 8G/above TF card, USB-Serial interface, PC with Ubuntu System
 * Using your USB-Serial Connect debug console on P2 Zero
 Debug console wire.png
 P2 Zero debug console.jpg

Install Linux Image on P2 Zero

Download latest Linux image, default login user/password is pi/bananapi or root/bananapi.

Install Image to SDcard on Linux PC with bpi-tools

1. Install bpi-tools on your system
   $ apt-get install pv
   $ curl -sL | sudo -E bash
If you can't access this URL or any other problems, please go to bpi-tools repo and install this tools manually.
2. Insert your SDcard into your PC
   $ bpi-copy xxx.img /dev/sdx

Install Image to SDcard with Ether on Windows, Linux and MacOS

Balena Etcher is an open source project by Balena, Flash OS images to SD cards & USB drives

Install Image to EMMC with SD Ubuntu

1.Prepare a sd which is installed ubuntu image and bootup with sdcard
2.Copy emmc image to udisk, plug in board, then mount udisk.
3.After mount udisk, use command "bpi-copy xxx-emmc-xxx.img" to install image on Emmc.
4.After success install, power off the board, eject the sdcard and poweron with emmc boot.

Update your image

1. Get the p2 zero bsp source code
   $ git clone
2. Build the source code according to the, and update the packages to the sdcard with bpi image flashed.

Advanced Development

How to create an image

  • Prepare a SD card which have installed system(Ubuntu/Raspbian/..)
  • Boot your SD card with M2 Zero, after M2 Zero finish starting, copy your files and config your system, then poweroff M2 Zero. [If you don't want to config your system, you can skip this step]
  • Plug your SD card in PC(which is running Linux), "cd /media", then "ln -s <your account> pi"
  • Execute "bpi-migrate -c bpi-m2z.conf -c ubuntu-mate-from-sd.conf -d /dev/sdx"
  • Then you could get your own image now


1. On M2 Zero console:

  • Execute "./", then execute "ps -ax | grep adbd" to see if adbd is set up

2. On PC terminal:

  • If adbd was succeed to set up, insert OTG-USB interface to M2 Zero and PC(with Ubuntu system)
  • Execute "adb devices" to see if PC has recognised M2 ZeroP OTG
  • If yes, we could execute "adb shell" to connect M2 Zero by adb now


  • Use iperf3 to test network

P2Zero network.jpg


  • Use bluetoothctl tool to operate BT
  • Execute "bluetoothctl"
  • If you don't know how to use bluetoothctl, type "help", you will see more commands
  • Execute these commands:

M2Zero bluetooth.png

WiFi Client

You have two ways to setup WiFi Client

1. Use commands to setup WiFi client

  • ip link set wlan0 up
  • iw dev wlan0 scan | grep SSID
  • vim /etc/wpasupplicant/wpa_supplicant.conf
  • wpa_supplicant -iwlan0 -c /etc/wpa_supplicant/wpa_supplicant.conf
  • dhclient wlan0

2. Use UI interface to setup WiFi Client

Clear boot

Camara function

We use HDF5640 camara.

Ov5640 camara.png


  • Use your UI interface to operate camara
  • Applications -> Sound & Video -> guvcview


  • We also have built-in command in /usr/local/bin to test camara
  • "./" to test picture taking function
  • "./" to test video recording function


How to change display resolution

For Example: we change M2Z HDMI display 1080P.

1. First, mount /dev/mmcblk0p1 /mnt, then enter to /mnt/bananapi/bpi-m2z/linux, find "sys_config.fex";

2. "vim sys_config.fex", change "screen0_output_mode = 5" to "screen0_output_mode = 10"

Display output.png

3. After save changed, use "fex2bin" command to transfer sys_config.fex to bin file, "fex2bin sys_config.fex script.bin ", reboot.

parameters meaning:

Display mode.png


Install Bpi-tools

Update Bpi-tools

  • Execute "bpi-tools"



Install RPi.GPIO

  • Execute "git clone"
  • after clone the repo, cd RPi,GPIO
  • Execute "sudo apt-get update"
  • Execute "sudo apt-get install python-dev python3-dev"
  • Execute "sudo python install" or "sudo python3 install" to install the module

Using RPi.GPIO

  • cd /usr/local/bin
  • Execute "./" to test RPi.GPIO

RPi GPIO.png


How to Update WiringPi

  • Execute "bpi-update -c pkglist.conf"

Update Pkglist.png

  • Execute "bpi-update -c bpi-pkg-bpi-wiringpi.conf"

Update WringPi.png

RGB 1602 LCD

  • Execute "/usr/local/bin/"

0.96 Inch OLED Display

  • Execute "/usr/local/bin/"

8x8 RGB LED Martix

  • Firstly you need a GPIO Extend Board for 8x8 LED Martix

WringPi LED Martix Extend Board.png

  • Execute "/usr/local/bin/"