Difference between revisions of "Getting Started with M4"

From Banana Pi Wiki
Jump to: navigation, search
(Install Android)
(Install Linux Image)
 
(46 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
[[zh:快速上手 香蕉派 BPI-M4]]
 
[[zh:快速上手 香蕉派 BPI-M4]]
 +
 
=Introduction=
 
=Introduction=
 
==BPI-M4==
 
==BPI-M4==
[[File:M4_respbian.png|thumb|Overview: BPI-M4 respbian linux]]
+
[[File:Banana_Pi_BPI-M4_1.jpg|thumb|Overview [[Banana Pi BPI-M4]]]]
 +
[[File:Banana_Pi_BPI-M4_2.jpg|thumb|Overview:Realtek RTD1395]]
  
 
   Banana Pi BPI-M4 use [https://drive.google.com/file/d/1Jt8qUwEjLinMqURMftC3db0Xg9MIWIhu/view?usp=sharing Realtek RTD1395] chp design ,it is a 64-bit quad-core A53 mini single board computer. It features 1 GB of RAM and 8 GB eMMC. It also has onboard WiFi for b/g/n/ac and BT 4.2. On the ports side, the BPI-M4 has 4 USB 2.0 ports, 1 USB TYPE C port, 1 HDMI port, 1 audio jack. support M.2 Key E PCIE 2.0 interface.  
 
   Banana Pi BPI-M4 use [https://drive.google.com/file/d/1Jt8qUwEjLinMqURMftC3db0Xg9MIWIhu/view?usp=sharing Realtek RTD1395] chp design ,it is a 64-bit quad-core A53 mini single board computer. It features 1 GB of RAM and 8 GB eMMC. It also has onboard WiFi for b/g/n/ac and BT 4.2. On the ports side, the BPI-M4 has 4 USB 2.0 ports, 1 USB TYPE C port, 1 HDMI port, 1 audio jack. support M.2 Key E PCIE 2.0 interface.  
Line 19: Line 21:
  
 
=Development For Android=
 
=Development For Android=
==Basic Development==
+
===Install Android Image===
===Install Android===
 
  
1.Install bootcode (in bpi-m4_bootcode&bootloader_20190625.zip)
+
Download the latest [https://download.banana-pi.dev/d/3ebbfa04265d4dddb81b/?p=%2FImages%2FBPI-M4%2Fandroid8&mode=list android image]
  
1.1 Connect BPI-M4 and PC with debug console, Switch BPI-M4 SW2 to 1, open "hypertrm.exe" on PC.
+
Download [https://download.banana-pi.dev/d/3ebbfa04265d4dddb81b/files/?p=%2FTools%2Fimage_download_tools%2Fm4_android_usb_download_tool.zip BPI-M4 USB flash tool]
[[Image:M4_install_pic1.jpg]]
 
1.2 Set Baud rate: 115200, data bit: 8 bit, stop bit: 1 bit, Parity: NONE, Flow control: NONE
 
[[Image:M4_install_pic2.jpg]]
 
  
1.3 Press "Ctrl+q" on PC, then power on BPI-M4, hypertrm will print "/d/g/r"
+
Note:
[[Image:M4_install_pic3.jpg]]
 
  
1.4 Press “h” button on PC,choose Transfer->Send File in the menu, then choose file ”
+
  1. BPI-M4 Android8 image only support 2GB ddr board.
bootcode/android_2133/hwsetting.bin”(or RTD1395_hwsetting_BOOT_2DDR4_
+
  2. BPI-M4 USB flash tool is a usb download tool for flashing android image to board emmc, and only support Windows platform.
8Gb_s2133.bin) , protocol choose “Ymodem-G”.  
+
  3. Make sure SW2 (board bottom near sd slot) switch to '''1'''
[[Image:M4_install_pic4.jpg]]
+
  4. Read document/bananapi_m4_usb_download_tool_guide.doc in usb flash tool package before flashing image.
[[Image:M4_install_pic5.jpg]]
 
  
1.5 After send file, if transfer successfully, you will see the following picture:
+
=Development For Linux=
[[Image:M4_install_pic6.jpg]]
+
===Install Linux Image===
 
 
1.6 Press “d” button on PC,choose Transfer->Send File in the menu, then choose file ”
 
bootcode/android_2133/recovery.bin(or Recovery-bananapi-0001-RTD1395
 
_hwsetting_BOOT_2DDR4_8Gb_s2133.bin) , choose “Ymodem-G”.
 
[[Image:M4_install_pic7.jpg]]
 
  
1.7 After transfer these two files, press “g” to execute it.
+
Download the latest [https://download.banana-pi.dev/d/3ebbfa04265d4dddb81b/?p=%2FImages%2FBPI-M4%2Flinux&mode=list Linux image]  
[[Image:M4_install_pic8.jpg]]
 
  
2.Install bootloader (in bpi-m4_bootcode&bootloader_20190625.zip)
+
:Note:
 +
::1. Board SW2 (board bottom near sd slot)  switch to '''0'''
 +
::2. For the compatibility of new 2GB and 1GB board with one Linux image, the old batch (before May, 2020) 1GB board must [https://download.banana-pi.dev/d/3ebbfa04265d4dddb81b/?p=%2FImages%2FBPI-M4%2Flinux-spiloader&mode=list update the spirom firmware], so it can run the new release image.
 +
::3. Login user/password: pi/bananapi or root/bananapi
  
2.1Press “Esc” button on PC, power on BPI-M4 to enter boot command line.
+
Install Image to SD Card On Linux PC with bpi-tools
[[Image:M4_install_pic9.jpg]]
 
  
2.2Input “Realtek> usb start” to recognise udisk
+
:1.Install bpi-tools on your linux
 +
    $ apt-get install pv
 +
    $ curl -sL https://github.com/BPI-SINOVOIP/bpi-tools/raw/master/bpi-tools | sudo -E bash
 +
:If you can't access this URL or any other problems, please go to [https://github.com/BPI-SINOVOIP/bpi-tools bpi-tools repo] and install this tools manually.
  
2.3Input “Realtek> fatload usb 0:1 0x01500000 bootloader.bin ” to load bootloader from udisk
+
:2.Insert your TF card into your PC
 +
    $ bpi-copy xxx.img /dev/sdX
 +
:Actually bpi-copy is the same as this dd command
 +
    $ sudo unzip -p xxx-bpi-m4-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer
  
2.4Input “Realtek> chain 0x01500000 ” to install bootloader
+
Install Image to SD Card with Etcher on Windows, Linux and MacOS
  
3.Install Android Image (In bpi-m4_Android_8_1_system.zip)
+
:[https://www.balena.io/etcher/ Balena Etcher] is an open source project by Balena, Flash OS images to SD cards & USB drives
3.1Unzip bpi-m4_Android_8_1_system.zip, then copy these files in to udisk, then plug udisk on Bpi-M4
 
  
3.2Reset Bpi-M4,enter to boot command line
+
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 bpi-copy command to install image on Emmc.
 +
    $ sudo bpi-copy xxx-bpi-m4-xxx.img.zip /dev/mmcblk1
 +
:Actually bpi-copy is the same as this dd command
 +
    $ sudo unzip -p xxx-bpi-m4-xxx.img.zip | pv | dd of=/dev/mmcblk1 bs=10M status=noxfer
 +
:4.After success install, power off the board, eject the sdcard and power on with emmc boot.
  
3.3Input “Realtek> usb start” to recognise udisk
+
===Enable SPI===
 +
Without device-tree overlay support, 40pin header SPI function is disabled default because pins multiplexing with uart2, it can be enabled according to this topic
  
3.4Input “Realtek> fatload usb 0:1 0x02100000 rescue.emmc.dtb ” to load rescue.emmc.dtb from udisk
+
:https://forum.banana-pi.org/t/banana-pi-bpi-m4-how-to-get-i2c-and-spi-running-tutorial/12824
  
3.4 Input “Realtek> fatload usb 0:1 0x03000000 emmc.uImage ” to load emmc.uImage from udisk
+
or by fdtput command without building kernel. Make sure boot partition mounted before doing this.
  
3.5 Input “Realtek> fatload usb 0:1 0x02200000 rescue.root.emmc.cpio.gz_pad.img” to load rescue.root.emmc.cpio.gz_pad.img from udisk
+
  # fdtput -t s /media/pi/BPI-BOOT/bananapi/bpi-m4/linux/rtd-1395-bananapi-m4-2GB.dtb /spi@9801BD00 status okay
 +
  # fdtput -t s /media/pi/BPI-BOOT/bananapi/bpi-m4/linux/rtd-1395-bananapi-m4-1GB.dtb /spi@9801BD00 status okay
 +
  # reboot
  
3.6 Input “Realtek>fatload usb 0:1 0x0f900000 bluecore.audio.enc.A01” to load bluecore.audio.enc.A01  from udisk
 
 
3.7 Input “Realtek> boot k”, you will wait for around 5-10 mins, please do not operate during the debug console print log, it will reboot after this.
 
 
=Development For Linux=
 
==Basic Development==
 
==Advanced Development==
 
 
===Installed Docker===
 
===Installed Docker===
 
To have a test, if docker has installed in your image.
 
To have a test, if docker has installed in your image.
  
 
* sudo docker run --rm hello-world
 
* sudo docker run --rm hello-world
 +
 
===EMAC===
 
===EMAC===
 
Use iperf3 to test gmac
 
Use iperf3 to test gmac

Latest revision as of 00:52, 25 May 2023


Introduction

BPI-M4

Overview:Realtek RTD1395
 Banana Pi BPI-M4 use Realtek RTD1395 chp design ,it is a 64-bit quad-core A53 mini single board computer. It features 1 GB of RAM and 8 GB eMMC. It also has onboard WiFi for b/g/n/ac and BT 4.2. On the ports side, the BPI-M4 has 4 USB 2.0 ports, 1 USB TYPE C port, 1 HDMI port, 1 audio jack. support M.2 Key E PCIE 2.0 interface. 

Key Features

  • Realtek RTD1395 ARM Cortex-A53 Quad-Core 64 Bit
  • Mali 470 MP4 GPU OpenGL ES 1.1/2.0 H.264 H.265,2K4K
  • Onboard1 GB DDR4 (option 2 GB)
  • 8G eMMC flash (max 64 GB)
  • 10/100 Mbit/s Ethernet and RTL8821 module support Wi-Fi 802.11 b/g/n/AC + Bluetooth 4.2
  • USB 2.0 TYPE C
  • M.2 Key E slot PCIE 2.0 and USB 2.0
  • PoE function support

Development For Android

Install Android Image

Download the latest android image

Download BPI-M4 USB flash tool

Note:

 1. BPI-M4 Android8 image only support 2GB ddr board.
 2. BPI-M4 USB flash tool is a usb download tool for flashing android image to board emmc, and only support Windows platform.
 3. Make sure SW2 (board bottom near sd slot) switch to 1
 4. Read document/bananapi_m4_usb_download_tool_guide.doc in usb flash tool package before flashing image.

Development For Linux

Install Linux Image

Download the latest Linux image

Note:
1. Board SW2 (board bottom near sd slot) switch to 0
2. For the compatibility of new 2GB and 1GB board with one Linux image, the old batch (before May, 2020) 1GB board must update the spirom firmware, so it can run the new release image.
3. Login user/password: pi/bananapi or root/bananapi

Install Image to SD Card On Linux PC with bpi-tools

1.Install bpi-tools on your linux
    $ apt-get install pv
    $ curl -sL https://github.com/BPI-SINOVOIP/bpi-tools/raw/master/bpi-tools | 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 TF card into your PC
    $ bpi-copy xxx.img /dev/sdX
Actually bpi-copy is the same as this dd command
    $ sudo unzip -p xxx-bpi-m4-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

Install Image to SD Card with Etcher 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 bpi-copy command to install image on Emmc.
    $ sudo bpi-copy xxx-bpi-m4-xxx.img.zip /dev/mmcblk1
Actually bpi-copy is the same as this dd command
    $ sudo unzip -p xxx-bpi-m4-xxx.img.zip | pv | dd of=/dev/mmcblk1 bs=10M status=noxfer
4.After success install, power off the board, eject the sdcard and power on with emmc boot.

Enable SPI

Without device-tree overlay support, 40pin header SPI function is disabled default because pins multiplexing with uart2, it can be enabled according to this topic

https://forum.banana-pi.org/t/banana-pi-bpi-m4-how-to-get-i2c-and-spi-running-tutorial/12824

or by fdtput command without building kernel. Make sure boot partition mounted before doing this.

 # fdtput -t s /media/pi/BPI-BOOT/bananapi/bpi-m4/linux/rtd-1395-bananapi-m4-2GB.dtb /spi@9801BD00 status okay
 # fdtput -t s /media/pi/BPI-BOOT/bananapi/bpi-m4/linux/rtd-1395-bananapi-m4-1GB.dtb /spi@9801BD00 status okay
 # reboot

Installed Docker

To have a test, if docker has installed in your image.

  • sudo docker run --rm hello-world

EMAC

Use iperf3 to test gmac

1. On PC Terminal:

  • Execute "iperf3 -s"

2. On M3 console:

  • TCP test: "iperf3 -c serverIP"
  • UDP test: "iperf3 -u -c serverIP"

M4 Emac test.jpg

Bluetooth

You have two ways to setup BT

1. Use commands to setup BT

  • 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:

M4 bluetooth.jpg

2. Use UI interface to setup BT

WiFi on M4

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/wpa_supplicant/wpa_supplicant.conf
 network={    
 ssid="ssid"    
 psk="password"    
 priority=1 
 }
  • wpa_supplicant -iwlan0 -c /etc/wpa_supplicant/wpa_supplicant.conf
  • dhclient wlan0

2. Use UI interface to setup WiFi Client

M4 WiFi iperf3.jpg