Difference between revisions of "Getting Started with BPI-M4 Berry"

From Banana Pi Wiki
Jump to: navigation, search
(→‎NoMachine Remote Desktop)
(→‎Install Image with USB tool)
 
(52 intermediate revisions by 4 users not shown)
Line 6: Line 6:
 
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]
 
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]
  
−
=development=
+
=Development=
 +
 
 +
==Android==
 +
===Prepare===
 +
 
 +
:1. Download latest [[Banana_Pi_BPI-M4_Berry#System_image | Android image]] and confirm that the checksum is correct before flashing.
 +
 
 +
:2. Download and Install [https://download.banana-pi.dev/d/ca025d76afd448aabc63/files/?p=%2FTools%2Fimage_download_tools%2Fphoenixsuit_V1.1.0_20150325.rar Allwinner Image Download Tools], PhoenixSuit is for window.
 +
 
 +
:3. Type-C cable, 5V/3A power supply.
 +
 
 +
:4. It's recommended that 4GB+32GB spec at least works well for M4 Berry/Zero android12.
 +
 
 +
===Install Image with USB tool===
 +
 
 +
:1. Open PhoenixSuit, click the Firmware icon to switching to firmware download panel, then click Image button and choose the Android Image file.
 +
 
 +
:[[File:m4-berry_android_1.jpg]]
 +
:[[File:m4-berry_android_2.jpg]]
 +
 
 +
:2. Press and hold the "FEL" button on M4 Berry while connecting to the computer using type-c, popup a warning dialog.Press Yes.
 +
 
 +
:[[File:m4-berry_android_3.jpg]]
 +
 
 +
:3. Download
 +
 
 +
:[[File:m4-berry_android_4.jpg]]
 +
 
 +
:4. Download finish
 +
 
 +
:[[File:m4-berry_android_5.jpg]]
 +
 
 +
===Build Android Source Code===
 +
 
 +
:Please read the source code [https://github.com/BPI-SINOVOIP/BPI-H618-Android12/blob/master/README.md README.md]
 +
 
 +
===Custom IR===
 +
:Wiki images support NEC protocol default.
 +
 
 +
:1. Execute getevent -l | grep MSC_SCAN in the serial port or adb shell, then press the corresponding button on the remote control to obtain the device ID and scancode.
 +
 
 +
:[[File:m4b_custom_ir_1.jpg]]
 +
 
 +
:The MSC_SCAN data is 32 bits.
 +
:Bits [31:24] represent the key press status, where 0 indicates release, and 1 indicates press.
 +
:Bits [23:8] represent the device ID. Use this ID to generate a keylayout file named customer_ir_xxxx.kl. For example, in this case, it would be customer_ir_fe01.kl.
 +
:Bits [7:0] represent the scancode.
 +
 
 +
:2. Based on the results of step one, create a new file named customer_ir_xxxx.kl with the following content:
 +
 
 +
:[[File:m4b_custom_ir_2.jpg]]
 +
 
 +
:Map the scancodes in the second column to Android keycodes.
 +
 
 +
:3. Use the adb command to push customer_ir_xxxx.kl to the system.
 +
 
 +
  $ adb root
 +
  $ adb remount
 +
  $ adb push customer_ir_xxxx.kl  /system/usr/keylayout/
 +
  $ adb reboot
 +
 
 +
:For source code porting, put the customer_ir_xxxx.kl to vendor/w/common/hardware/input/multi_ir/keylayout/ directory and build the source code.
 +
 
 +
===Custom Logo===
 +
:Change boot logo and bootanimation by adb command
 +
 
 +
:1. Boot logo
 +
 
 +
:Prepare a 24bit bootlogo.bmp file, resolution limited to 1280x720, then push it to android by adb
 +
  $ adb root
 +
  $ adb remount
 +
  $ adb push bootlogo.bmp /Reserve0/
 +
  $ adb reboot
 +
 
 +
:2. Bootanimation logo
 +
 
 +
:Create a folder named media, copy bootanimation.zip to media folder and push it to android by adb
 +
  $ adb root
 +
  $ adb remount
 +
  $ adb push media /system/
 +
  $ adb reboot
 +
 
 +
:Change boot logo and bootanimation by building android source code
 +
 
 +
:1. Boot logo
 +
 
 +
:Rename the logo file to bootlogo.bmp and put it in longan/device/config/chips/h618/boot-resource/boot-resource/ directory.
 +
 
 +
:2. Bootanimation logo
 +
 
 +
:Put bootanimation.zip to device/softwinner/apollo/common/media/bootanimation/ directory.
 +
 
 +
:3. Launcher logo for Box variant image
 +
 
 +
:Create a 270x110, 32 bit depth, png image and rename it to aw_logo.png, put it in vendor/aw/common/package/TVLauncher/res/drawable-xhdpi/ directory.
 +
 
 +
:Then build the source code and flash the image to your board.
 +
 
 +
===Install Play Store===
 +
:Install Play Store with Magisk, it's not recommended.
 +
 
 +
:1. Download the latest [https://magiskmanager.com/ Magisk app]
 +
:2. Download [https://sourceforge.net/projects/litegapps/files/litegapps/arm/31/lite/v2.5/ LiteGapps arm package] 
 +
:4. Copy Magisk apk file and LiteGapps zip package to SDcard and plugin it to the board.
 +
:5. Follow the process in the video to Install Google Play store.
 +
 
 +
:<youtube>pMKBVcJhsx4</youtube>
 +
 
 +
:Another way, you can build the android source code with OpenGApps google play include.
 +
 
 +
:1. Apply this patch to source code.
 +
  diff --git a/device/softwinner/apollo/common/opengapps/config.mk
 +
  b/device/softwinner/apollo/common/opengapps/config.mk
 +
  index 4c2a7f3..c7ff30e 100644
 +
  --- a/device/softwinner/apollo/common/opengapps/config.mk
 +
  +++ b/device/softwinner/apollo/common/opengapps/config.mk
 +
  @@ -1,4 +1,4 @@
 +
  -BOARD_BUILD_OPENGAPPS := false
 +
  +BOARD_BUILD_OPENGAPPS := true
 +
 +
  ifeq ($(BOARD_BUILD_OPENGAPPS), true)
 +
  GAPPS_VARIANT := pico
 +
 
 +
:3. Create /vendor/opengapps folder
 +
 
 +
:4. Download [https://github.com/opengapps/aosp_build OpenGApps aosp_build] project to /vendor/opengapps/build
 +
 
 +
:5. Create /vendor/opengapps/sources folder, download [https://gitlab.opengapps.org/opengapps OpenGApps projects] to /vendor/opengapps/sources/
 +
 
 +
:6. Build the source code and flash image to your board.
 +
 
 +
===Switch Audio Output===
 +
 
 +
: The default audio output channel is hdmi, switch it to jack output in Settings->Sound->Audio output channel
 +
 
 +
:[[File:m4b_audio_switch.jpg]]
  
 
==Linux==
 
==Linux==
 
===Prepare===
 
===Prepare===
−
:1. Linux image support SDcard or EMMC bootup, but you should read the [Boot_Sequence boot sequence] at first.
+
:1. Linux image support SDcard or EMMC bootup, and will boot from the SD card first.
  
 
:2. It’s recommended to use A1 rated cards, 8GB at least.
 
:2. It’s recommended to use A1 rated cards, 8GB at least.
Line 18: Line 153:
 
:4. Make sure SDcard is formatted without Linux image flashed if you want bootup from EMMC and use Sdcard as storage.
 
:4. Make sure SDcard is formatted without Linux image flashed if you want bootup from EMMC and use Sdcard as storage.
  
−
:5. Download latest [Linux Linux Image], and confirm that the md5 checksum is correct.
+
:5. Download latest [[Banana_Pi_BPI-M4_Berry#System_image | bananapi ubuntu/debian images]], and confirm that the md5 checksum is correct.
  
 
:6. Default login: pi/bananapi or root/bananapi
 
:6. Default login: pi/bananapi or root/bananapi
  
−
:7. The wiki guide is only for [bananapi 4.9 bsp ubuntu/debian images].
+
:7. The wiki guide is only for [[Banana_Pi_BPI-M4_Berry#System_image | bananapi ubuntu/debian images]].
 +
 
 +
:8. USB-Serial (3.3V). Baud: 115200.
  
 
===Install Image to SDcard===
 
===Install Image to SDcard===
Line 30: Line 167:
 
:[[File:m2s_linux_flash.png]]
 
:[[File:m2s_linux_flash.png]]
  
−
:2. Install Image with Balena Cli on Windows, Linux and MacOS.
+
===Install Image to eMMC===
−
:[https://github.com/balena-io/balena-cli Balena CLI] is a Command Line Interface for balenaCloud or openBalena. It can be used to flash linux image. Download the installer or standalone package from [https://github.com/balena-io/balena-cli/releases balena-io] and [https://github.com/balena-io/balena-cli/blob/master/INSTALL.md install] it correctly to your PC, then you can use the "[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]" command option of balena to flash a linux image to sdcard or usb drive.
+
 
 +
1. Make sure that the Linux image has been burned into an SD card and started normally.
 +
 
 +
2. Enter the following command in the terminal:
 +
<pre>
 +
sudo bananapi-config
 +
</pre>
 +
 
 +
3. By default, select the first item continuously and press the Enter key to install the Linux system image on the eMMC.
  
−
  sudo balena local flash path/to/xxx-bpi-m4-berry-xxx.img.zip
+
:[[File:Bpi_m4_berry_mobaxterm_12.jpg]]
−
  sudo balena local flash path/to/xxx-bpi-m4-berry-xxx.img.zip --drive /dev/disk2
+
:[[File:Bpi_m4_berry_mobaxterm_13.jpg]]
−
  sudo balena local flash path/to/xxx-bpi-m4-berry-xxx.img.zip --drive /dev/disk2 --yes
+
:[[File:Bpi_m4_berry_mobaxterm_14.jpg]]
 +
:[[File:Bpi_m4_berry_mobaxterm_15.jpg]]
 +
:[[File:Bpi_m4_berry_mobaxterm_16.jpg]]
 +
:[[File:Bpi_m4_berry_mobaxterm_17.jpg]]
 +
:[[File:Bpi_m4_berry_mobaxterm_18.jpg]]
  
−
:3. Install Image with dd command on Linux, umount SDcard device /dev/sdX partition if mounted automatically. Actually bpi-copy is the same as this dd command.
+
4. The last step is to shut down the computer. At this time, disconnect the power supply, remove the SD card, and power on again to boot from eMMC.
−
  sudo apt-get install pv unzip
 
−
  sudo unzip -p xxx-bpi-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer
 
  
−
:4. Install image with bpi-tools on Linux, plug SDcard to Linux PC and run
+
===Erase eMMC===
−
  sudo apt-get install pv unzip
 
−
  sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX
 
  
−
===Start===
+
1. Make sure the Linux image has been burned into an SD card and insert the SD card. By default it will boot from the SD card.
  
−
====Ubuntu Desktop====
+
2. Enter the command lsblk in the terminal to list the block device information in the system, such as hard disks, partitions, disks, etc.
 +
 
 +
<pre>
 +
pi@bpi-m4berry:~$ lsblk
 +
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS
 +
mmcblk0 179:0 0 7.4G 0 disk
 +
└─mmcblk0p1 179:1 0 7.2G 0 part /var/log.hdd
 +
                                        /
 +
mmcblk1 179:32 0 7.3G 0 disk
 +
└─mmcblk1p1 179:33 0 7.3G 0 part
 +
mmcblk1boot0 179:64 0 4M 1 disk
 +
mmcblk1boot1 179:96 0 4M 1 disk
 +
zram0 252:0 0 993.2M 0 disk [SWAP]
 +
zram1 252:1 0 50M 0 disk /var/log
 +
zram2 252:2 0 0B 0 disk
 +
</pre>
 +
 
 +
3. mmcblk0 is the SD card and mmcblk1 is the eMMC. Enter the following command in the terminal to erase the eMMC. This process takes several minutes and is irreversible. Be careful to back up important data.
 +
<pre>
 +
sudo dd if=/dev/zero of=/dev/mmcblk1
 +
</pre>
 +
 
 +
===Ubuntu Desktop===
  
 
:1. Using the Ubuntu desktop version system image, you can get a graphical operation interface.
 
:1. Using the Ubuntu desktop version system image, you can get a graphical operation interface.
Line 55: Line 222:
 
[[File:Bpi_m4_berry_ubuntu_1.jpg]]
 
[[File:Bpi_m4_berry_ubuntu_1.jpg]]
  
−
====Debug UART====
+
===Debug UART===
 
:1. Prepare a 3.3v USB to TTL module.
 
:1. Prepare a 3.3v USB to TTL module.
 
:2. Use the USB to TTL module to connect the PC USB port and the Debug UART port on the board.
 
:2. Use the USB to TTL module to connect the PC USB port and the Debug UART port on the board.
Line 65: Line 232:
 
[[File:bpi_m4_berry_mobaxterm_2.jpg]]
 
[[File:bpi_m4_berry_mobaxterm_2.jpg]]
  
−
====SSH====
+
===SSH===
 
:1. Prepare a network cable and a router.
 
:1. Prepare a network cable and a router.
 
:2. Use a network cable to connect the LAN port of the router to the BPI-M4 Berry, and also connect the PC to another LAN port.
 
:2. Use a network cable to connect the LAN port of the router to the BPI-M4 Berry, and also connect the PC to another LAN port.
Line 89: Line 256:
 
[[File:bpi_m4_berry_mobaxterm_4.jpg]]
 
[[File:bpi_m4_berry_mobaxterm_4.jpg]]
  
−
====NoMachine Remote Desktop====
+
===NoMachine Remote Desktop===
 
:1. Make sure BPI-M4 Berry is connected to the Internet and use the following command to download the nomachine DEB installation package in the system.
 
:1. Make sure BPI-M4 Berry is connected to the Internet and use the following command to download the nomachine DEB installation package in the system.
  
Line 126: Line 293:
  
 
   nmcli connection show #List network connection configuration
 
   nmcli connection show #List network connection configuration
−
   nmcli connection down [NAME] # Activate a connection
+
   nmcli connection down [NAME] # Deactivate a connection
−
   nmcli connection up [NAME] # Deactivate a connection
+
   nmcli connection up [NAME] # Activate a connection
 
   nmcli connection delete [SSID] #Delete a configuration and no longer save information and automatically connect
 
   nmcli connection delete [SSID] #Delete a configuration and no longer save information and automatically connect
  
Line 135: Line 302:
 
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli command reference document]
 
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli command reference document]
 
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli command reference examples]
 
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli command reference examples]
 +
 +
===Set static IP, DNS===
 +
:1. To set a static IP, you need to maintain the connection first. If you want to set an Ethernet static IP, you must first maintain the Ethernet connection; if you want to set a wireless network static IP, you must first maintain a connection to a WIFI.
 +
:2. If the upper-level router has assigned the IP address you want to set to other devices, please change it to an idle IP, or ask other devices to give up the IP.
 +
:3. Use the nmcli connection show command to display all connections, for example:
 +
  pi@bpi-m4berry:~$ nmcli connection show
 +
  NAME UUID TYPE DEVICE
 +
  TP-LINK_5G_7747 e4a49726-adf1-44d7-a621-0e3af96cc390 wifi wlx2cc3e6acd5d7
 +
  Wired connection 1 612eda94-55dc-3c85-b05e-f16c41775b4e ethernet --
 +
:4. Use the nmcli connection show [NAME] command to display all the properties of a specific connection, such as:
 +
  nmcli connection show TP-LINK_5G_7747 #If you want to see Ethernet, change to Wired connection 1
 +
 +
  #Only list three common items
 +
  ipv4.dns: 192.168.3.1 #The default is the gateway address
 +
  ipv4.addresses: 192.168.3.10/24 #The default is the IP address assigned by the router DHCP
 +
  ipv4.gateway: 192.168.3.1 #Gateway address, the default is the IP address of the router
 +
 +
:5.Set static IP:
 +
  nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
 +
:6.Set DNS:
 +
  nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
 +
:7.Reset:
 +
  reboot
 +
:8. After restarting, check whether the modification is successful:
 +
  ifconfig
 +
  nmcli connection show TP-LINK_5G_7747
  
 
===Network time synchronization===
 
===Network time synchronization===
Line 153: Line 346:
  
 
   date #View time
 
   date #View time
−
  sudo hwclock -w #Set hardware clock
 
−
  sudo hwclock -s #Set the system clock
 
 
   sudo hwclock -r #View hardware clock
 
   sudo hwclock -r #View hardware clock
  
Line 170: Line 361:
 
===Use USB disk===
 
===Use USB disk===
 
:1. Prepare a USB disk that has been partitioned normally and insert it into the USB interface of BPI-M4 Berry.
 
:1. Prepare a USB disk that has been partitioned normally and insert it into the USB interface of BPI-M4 Berry.
−
:2. In the Ubuntu desktop version, you can see that the USB flash drive has been recognized and can be opened in the file manager, or partition management can be performed through the GParted tool.
+
:2. In the Ubuntu desktop version, you can see that the USB disk has been recognized and can be opened in the file manager, or partition management can be performed through the GParted tool.
  
 
[[File:Bpi_m4_berry_ubuntu_3.jpg]]
 
[[File:Bpi_m4_berry_ubuntu_3.jpg]]
Line 180: Line 371:
 
   ls ~/mnt/ #After mounting, you can list the files in the USB disk
 
   ls ~/mnt/ #After mounting, you can list the files in the USB disk
 
   sudo umount -v /dev/sda1 #umount, then you can remove the USB disk
 
   sudo umount -v /dev/sda1 #umount, then you can remove the USB disk
 +
 +
===Use Audio Devices===
 +
: Prepare an audio file and copy it to the BPI-M4 Berry Ubuntu desktop system through a USB flash drive or SSH.
 +
====HDMI audio====
 +
:1. Prepare a monitor with HDMI audio input function, turn on the relevant functions in the monitor settings, and use an HDMI cable to connect the monitor.
 +
:2. Set the output device to HDMI Audio in the Sound column of the settings.
 +
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
 +
:3.Play audio.
 +
[[File:Bpi_m4_berry_ubuntu_5.jpg]]
 +
 +
====3.5mm audio jack====
 +
:1. Prepare a headset or other audio device that uses a 3.5mm plug, insert the plug into the 3.5mm jack of BPI-M4 Berry.
 +
:2. Set the output device to Audio Codec in the Sound column of the settings.
 +
[[File:Bpi_m4_berry_ubuntu_6.jpg]]
 +
:3. Play audio.
 +
 +
====Terminal command to play audio files====
 +
<pre>
 +
aplay -l #List devices
 +
aplay -D hw:0,0 [path] #Play the audio file of the specified path
 +
</pre>
 +
 +
===Use Bluetooth===
 +
:1. Open settings in the Ubuntu desktop and connect a Bluetooth device, such as a Bluetooth mouse or keyboard, in the Bluetooth bar.
 +
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
 +
:2. The method to connect the Bluetooth device through the command line in the terminal is as follows:
 +
<pre>
 +
pi@bpi-m4berry:~$ sudo bluetoothctl #Open the Bluetooth device management tool
 +
[sudo] password for pi:
 +
Agent registered
 +
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
 +
[bluetooth]# power on #Start the Bluetooth function, power off to turn it off
 +
Changing power on succeeded
 +
[bluetooth]# discoverable on #Allow this device to be discovered
 +
Changing discoverable on succeeded
 +
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
 +
[bluetooth]# pairable on #Allow device pairing
 +
Changing pairable on succeeded
 +
[bluetooth]# scan on #Start scanning
 +
Discovery started
 +
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
 +
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #The MAC address and device name of a Bluetooth mouse
 +
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
 +
[bluetooth]# pair D4:C4:85:A5:C6:B1 #Pair the MAC address of the Bluetooth device you want to connect to
 +
Attempting to pair with D4:C4:85:A5:C6:B1
 +
[CHG] Device D4:C4:85:A5:C6:B1 Connected: yes
 +
[DEL] Device A4:C1:38:9B:F6:FD SLPO20N20200059
 +
[CHG] Device D4:C4:85:A5:C6:B1 UUIDs: 00001800-0000-1000-8000-00805f9b34fb
 +
[CHG] Device D4:C4:85:A5:C6:B1 UUIDs: 00001801-0000-1000-8000-00805f9b34fb
 +
[CHG] Device D4:C4:85:A5:C6:B1 UUIDs: 0000180a-0000-1000-8000-00805f9b34fb
 +
[CHG] Device D4:C4:85:A5:C6:B1 UUIDs: 0000180f-0000-1000-8000-00805f9b34fb
 +
[CHG] Device D4:C4:85:A5:C6:B1 UUIDs: 00001812-0000-1000-8000-00805f9b34fb
 +
[CHG] Device D4:C4:85:A5:C6:B1 UUIDs: 00010000-0000-1000-8000-011f2000046d
 +
[CHG] Device D4:C4:85:A5:C6:B1 ServicesResolved: yes
 +
[CHG] Device D4:C4:85:A5:C6:B1 Paired: yes
 +
Pairing successful #pairing successfully
 +
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
 +
[bluetooth]# exit #Exit the Bluetooth device management tool
 +
pi@bpi-m4berry:~$
 +
</pre>
 +
 +
:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth reference document]
 +
 +
===Use IR Receiver===
 +
:1. You need to prepare an infrared remote control using NEC format.
 +
:2. Enter the following command in the terminal to start receiving infrared signals.
 +
  sudo ir-keytable -c -p NEC -t
 +
 +
  Old keytable cleared
 +
  Protocols changed to nec
 +
  Testing events. Please, press CTRL-C to abort.
 +
  258.553895: lirc protocol(nec): scancode = 0x45
 +
  258.553926: event type EV_MSC(0x04): scancode = 0x45
 +
  258.553926: event type EV_SYN(0x00).
 +
  260.667648: lirc protocol(nec): scancode = 0x46
 +
  260.667671: event type EV_MSC(0x04): scancode = 0x46
 +
  260.667671: event type EV_SYN(0x00).
 +
  260.719552: lirc protocol(nec): scancode = 0x46 repeat
 +
  260.719568: event type EV_MSC(0x04): scancode = 0x46
 +
  260.719568: event type EV_SYN(0x00).
 +
  273.263728: lirc protocol(nec): scancode = 0x47
 +
  273.263753: event type EV_MSC(0x04): scancode = 0x47
 +
  273.263753: event type EV_SYN(0x00).
 +
  273.315591: lirc protocol(nec): scancode = 0x47 repeat
 +
  273.315608: event type EV_MSC(0x04): scancode = 0x47
 +
  273.315608: event type EV_SYN(0x00).
 +
 +
For other commands and specific application methods, please see [https://manpages.ubuntu.com/manpages/focal/en/man1/ir-keytable.1.html ir-keytable reference document]
 +
 +
===Transfer files===
 +
====scp====
 +
scp (secure copy) command in Linux system is used to copy file(s) between servers in a secure way.
 +
 +
The SCP command or secure copy allows the secure transferring of files between the local host and the remote host or between two remote hosts.
 +
 +
It uses the same authentication and security as it is used in the Secure Shell (SSH) protocol.
 +
 +
You can copy files from a Windows terminal to a Linux system on the same LAN. Just make sure the Open SSH client is turned on and can be viewed in Settings > Applications > Optional Features.
 +
 +
If you want to copy files from Windows systems to Linux systems, you also need to enable the Open SSH server.
 +
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]
 +
 +
The scp command format is:
 +
 +
:<pre>scp [optionals] file_source file_target</pre>
 +
::1.<nowiki>[optionals]</nowiki> is an optional parameter, such as -r, which can be used to copy the entire directory recursively.
 +
 +
::2.file_source The file or directory to be copied.
 +
 +
::3.file_target will copy the past path and rename it if a specific file name is entered at the end.
 +
 +
Take copying local files from a Windows system to a Linux system as an example. In the Windows terminal, enter:
 +
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" [email protected]:"/home/pi/Downloads/"</pre>
 +
 +
You can also copy files in the Linux system to the local computer in the Windows terminal:
 +
:<pre>PS D:\temp\temp_4> scp [email protected]:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
 +
:: Where [email protected] is the user name in the Linux system and the IP address of the BPI-M4 Berry in the LAN.
 +
:: Where <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> is the file path in the Linux system.
 +
:: Where "D:\temp\temp_4" is the path in Windows system.
 +
 +
[https://www.geeksforgeeks.org/scp-command-in-linux-with-examples/ scp reference document]
 +
 +
====mobaxterm====
 +
Files can be managed through a graphical interface using mobaxterm or other similar software.
 +
:[https://mobaxterm.mobatek.net/download.html mobaxterm download]
 +
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux preview version]
 +
 +
As shown in the figure below, after establishing an SSH connection in mobaxterm, a file management window will appear on the left side of the interface, which supports copying and pasting by dragging and dropping files.
 +
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]
 +
 +
===40 pin interface GPIO, I2C, UART, SPI, and PWM testing===
 +
====GPIO====
 +
Control the GPIO port to light up the LED light.
 +
 +
 +
'''Set the high and low levels of GPIO'''
 +
 +
:[[File:M4_Berry_gpio.jpg]]
 +
 +
The following is a demonstration using 7 pin.
 +
 +
Insert the LED light and you can see that it is not lit up.
 +
 +
:[[File:M4_Berry_gpio_led_1.jpg]]
 +
 +
: 1.Execute
 +
gpio mode 2 out
 +
:to set it to output mode.
 +
 +
: 2.Execute
 +
gpio write 2 1
 +
:You can see that the LED light has been turned on.
 +
:[[File:M4_Berry_gpio_led_2.jpg]]
 +
 +
: 3.Execute
 +
gpio write 2 0
 +
:You can see that the LED light has been turned off.
 +
:[[File:M4_Berry_gpio_led_1.jpg]]
 +
 +
 +
'''Set pull-up and pull-down resistors'''
 +
: 1.Firstly, it is necessary to set the GPIO port to input mode
 +
gpio mode 2 in
 +
 +
: 2.Then set the GPIO port as an pull-up resistor
 +
gpio mode 2 up
 +
:The LED light is lit up again
 +
:[[File:M4_Berry_gpio_led_1.jpg]]
 +
 +
: 3.Finally, set the GPIO port to dropdown mode
 +
gpio mode 2 down
 +
:The LED light goes out again
 +
:[[File:M4_Berry_gpio_led_2.jpg]]
 +
 +
====I2C====
 +
 +
According to the schematic diagram, the available i2cs are i2c3 and i2c4
 +
:[[File:M4_Berry_gpio_i2c.png]]
 +
 +
: 1.Execute
 +
 +
sudo bananapi-config
 +
 +
: 2.Select "System"
 +
:[[File:M4 Berry-bananapi-config-1.jpg]]
 +
 +
: 3.Select "Hardware"
 +
:[[File:M4 Berry-bananapi-config-2.jpg]]
 +
 +
: 4.Use the keyboard directional keys to move, then use the spacebar to select.Select "pg-i2c3"and"pg-i2c4"
 +
:[[File:M4_Berry_bananapi_config_i2c.jpg]]
 +
 +
: 5.Select "Save", then select "Back"
 +
:[[File:M4 Berry-bananapi-config-3.jpg]]
 +
 +
: 6.Finally, choose Reboot.
 +
:[[File:M4 Berry-bananapi-config-4.jpg]]
 +
 +
: 7.After restarting, check if there are i2c-3 and i2c-4 nodes.
 +
pi@bpi-m4berry:~$ ls /dev/i2c-3
 +
/dev/i2c-3
 +
pi@bpi-m4berry:~$ ls /dev/i2c-4
 +
/dev/i2c-4
 +
 +
: 8. Execute
 +
 +
cd /usr/src/wiringPi/examples/
 +
gcc ./oled_demo.c -o oled -lwiringPi
 +
 +
: 9.Connect the i2c device to the pin of i2c3. Execute
 +
 +
sudo ./oled /dev/i2c-3
 +
 +
:[[File:M4_Berry_i2c_3_led.jpg]]
 +
 +
: 10.Connect the i2c device to the pin of i2c4. Execute
 +
 +
sudo ./oled /dev/i2c-4
 +
 +
:[[File:M4_Berry_i2c_4_led.jpg]]
 +
 +
====UART====
 +
By reviewing the schematic, it can be found that the available uart are uart1 and uart5.
 +
:[[File:M4_Berry_gpio_uart.png]]
 +
 +
: 1.Uart1 and Uart5 is closed by default and needs to be opened. Execute
 +
sudo bananapi-config
 +
 +
: 2.Select "System"
 +
:[[File:M4 Berry-bananapi-config-1.jpg]]
 +
 +
: 3.Select "Hardware"
 +
:[[File:M4 Berry-bananapi-config-2.jpg]]
 +
 +
: 4.Use the keyboard directional keys to move, then use the spacebar to select.If you want to use uart1,select"pg-uart1".If you want to use uart5,select"ph-uart5"
 +
:[[File:M4_Berry_bananapi_config_uart.jpg]]
 +
 +
: 5.Select "Save", then select "Back"
 +
:[[File:M4 Berry-bananapi-config-3.jpg]]
 +
 +
: 6.Finally, choose Reboot.
 +
:[[File:M4 Berry-bananapi-config-4.jpg]]
 +
 +
: 7.After restarting, check if there are ttyS5 nodes.
 +
pi@bpi-m4berry:~$ ls /dev/ttyS5
 +
/dev/ttyS5
 +
 +
: 8:Short circuit uart1 pin or uart5 and execute
 +
gpio serial /dev/ttyS1
 +
:[[File:M4_Berry_gpio_uart1.jpg]]
 +
:[[File:M4_Berry_gpio_uart5.jpg]]
 +
 +
====SPI====
 +
By reviewing the schematic, it can be found that the available spi is spi1.
 +
:[[File:M4 Berry-sch-gpio-spi.png]]
 +
 +
: 1.Execute
 +
 +
sudo bananapi-config
 +
 +
: 2.Select "System"
 +
:[[File:M4 Berry-bananapi-config-1.jpg]]
 +
 +
: 3.Select "Hardware"
 +
:[[File:M4 Berry-bananapi-config-2.jpg]]
 +
 +
: 4.Use the keyboard directional keys to move, then use the spacebar to select.Select "spi1-cs1-spidev"
 +
:[[File:M4 Berry-bananapi-config-spi.jpg]]
 +
 +
: 5.Select "Save", then select "Back"
 +
:[[File:M4 Berry-bananapi-config-3.jpg]]
 +
 +
: 6.Finally, choose Reboot.
 +
:[[File:M4 Berry-bananapi-config-4.jpg]]
 +
 +
: 7.After restarting, check if there are SPI nodes.
 +
pi@bpi-m4berry:~$ ls /dev/spidev1.1
 +
/dev/spidev1.1
 +
 +
: 8.Execute
 +
 +
sudo spidev_test -v -D /dev/spidev1.1
 +
 +
:[[File:M4 Berry-bananapi-config-spi-1.jpg]]
 +
 +
 +
:It can be seen that TX and RX are different. So, we need to short-circuit MOSI and MISO and execute the command again.
 +
 +
:[[File:M4 Berry-bananapi-config-spi-2.jpg]]
 +
 +
====PWM====
 +
 +
 +
===HDMI LCD===
 +
 +
:{| class="wikitable"
 +
|-
 +
| style="background: PaleTurquoise; color: black" colspan="4"| '''Bananapi M4 Berry Tested HDMI LCD'''
 +
|-
 +
|panel || Test Video
 +
|-
 +
| [https://www.waveshare.com/4inch-hdmi-lcd-c.htm Waveshare 4inch 720x720] || https://youtu.be/CRcjx6_29rA
 +
|-
 +
| [https://www.waveshare.com/5inch-hdmi-amoled.htm Waveshare 5inch 960x544] || https://youtu.be/0wZ3lWQQTkQ
 +
|-
 +
| [https://www.waveshare.com/5.5inch-1440x2560-lcd.htm Waveshare 5.5inch 1440x2560] || https://youtu.be/z9gTHa3i8Ag
 +
|-
 +
| [https://www.waveshare.com/8inch-1536x2048-LCD.htm Waveshare 8inch 1536x2048] || https://youtu.be/Qjwo4vVBQmo
 +
|-
 +
| [https://www.waveshare.com/8.8inch-Side-Monitor.htm Waveshare 8.8inch 480x1920] || https://youtu.be/SP9-HGrY6-M
 +
|-
 +
| [https://www.waveshare.com/11.9inch-HDMI-LCD.htm Waveshare 11.9inch 320x1480] || https://youtu.be/WA1yBGcYZds
 +
|-
 +
| [https://www.waveshare.com/12.3inch-hdmi-lcd.htm Waveshare 12.3inch 1920x720] || https://youtu.be/OJfqtHlgDvk
 +
|}

Latest revision as of 23:09, 31 July 2024

Banana Pi BPI-M4 Berry H618 design
Banana Pi BPI-M2 Berry A40i-H design
Banana Pi BPI-M2 Pro S905x3 design
Banana Pi BPI-M2S Amlogic A311D/S922 chip
Banana Pi BPI-M5 with S905x3 design

Development

Android

Prepare

1. Download latest Android image and confirm that the checksum is correct before flashing.
2. Download and Install Allwinner Image Download Tools, PhoenixSuit is for window.
3. Type-C cable, 5V/3A power supply.
4. It's recommended that 4GB+32GB spec at least works well for M4 Berry/Zero android12.

Install Image with USB tool

1. Open PhoenixSuit, click the Firmware icon to switching to firmware download panel, then click Image button and choose the Android Image file.
M4-berry android 1.jpg
M4-berry android 2.jpg
2. Press and hold the "FEL" button on M4 Berry while connecting to the computer using type-c, popup a warning dialog.Press Yes.
M4-berry android 3.jpg
3. Download
M4-berry android 4.jpg
4. Download finish
M4-berry android 5.jpg

Build Android Source Code

Please read the source code README.md

Custom IR

Wiki images support NEC protocol default.
1. Execute getevent -l | grep MSC_SCAN in the serial port or adb shell, then press the corresponding button on the remote control to obtain the device ID and scancode.
M4b custom ir 1.jpg
The MSC_SCAN data is 32 bits.
Bits [31:24] represent the key press status, where 0 indicates release, and 1 indicates press.
Bits [23:8] represent the device ID. Use this ID to generate a keylayout file named customer_ir_xxxx.kl. For example, in this case, it would be customer_ir_fe01.kl.
Bits [7:0] represent the scancode.
2. Based on the results of step one, create a new file named customer_ir_xxxx.kl with the following content:
M4b custom ir 2.jpg
Map the scancodes in the second column to Android keycodes.
3. Use the adb command to push customer_ir_xxxx.kl to the system.
 $ adb root
 $ adb remount
 $ adb push customer_ir_xxxx.kl  /system/usr/keylayout/
 $ adb reboot
For source code porting, put the customer_ir_xxxx.kl to vendor/w/common/hardware/input/multi_ir/keylayout/ directory and build the source code.

Change boot logo and bootanimation by adb command
1. Boot logo
Prepare a 24bit bootlogo.bmp file, resolution limited to 1280x720, then push it to android by adb
 $ adb root
 $ adb remount
 $ adb push bootlogo.bmp /Reserve0/
 $ adb reboot
2. Bootanimation logo
Create a folder named media, copy bootanimation.zip to media folder and push it to android by adb
 $ adb root
 $ adb remount
 $ adb push media /system/
 $ adb reboot
Change boot logo and bootanimation by building android source code
1. Boot logo
Rename the logo file to bootlogo.bmp and put it in longan/device/config/chips/h618/boot-resource/boot-resource/ directory.
2. Bootanimation logo
Put bootanimation.zip to device/softwinner/apollo/common/media/bootanimation/ directory.
3. Launcher logo for Box variant image
Create a 270x110, 32 bit depth, png image and rename it to aw_logo.png, put it in vendor/aw/common/package/TVLauncher/res/drawable-xhdpi/ directory.
Then build the source code and flash the image to your board.

Install Play Store

Install Play Store with Magisk, it's not recommended.
1. Download the latest Magisk app
2. Download LiteGapps arm package
4. Copy Magisk apk file and LiteGapps zip package to SDcard and plugin it to the board.
5. Follow the process in the video to Install Google Play store.
Another way, you can build the android source code with OpenGApps google play include.
1. Apply this patch to source code.
 diff --git a/device/softwinner/apollo/common/opengapps/config.mk 
 b/device/softwinner/apollo/common/opengapps/config.mk
 index 4c2a7f3..c7ff30e 100644
 --- a/device/softwinner/apollo/common/opengapps/config.mk
 +++ b/device/softwinner/apollo/common/opengapps/config.mk
 @@ -1,4 +1,4 @@
 -BOARD_BUILD_OPENGAPPS := false
 +BOARD_BUILD_OPENGAPPS := true

  ifeq ($(BOARD_BUILD_OPENGAPPS), true)
  GAPPS_VARIANT := pico
3. Create /vendor/opengapps folder
4. Download OpenGApps aosp_build project to /vendor/opengapps/build
5. Create /vendor/opengapps/sources folder, download OpenGApps projects to /vendor/opengapps/sources/
6. Build the source code and flash image to your board.

Switch Audio Output

The default audio output channel is hdmi, switch it to jack output in Settings->Sound->Audio output channel
M4b audio switch.jpg

Linux

Prepare

1. Linux image support SDcard or EMMC bootup, and will boot from the SD card first.
2. It’s recommended to use A1 rated cards, 8GB at least.
3. Make sure bootable EMMC is formatted if you want bootup from SDcard.
4. Make sure SDcard is formatted without Linux image flashed if you want bootup from EMMC and use Sdcard as storage.
5. Download latest bananapi ubuntu/debian images, and confirm that the md5 checksum is correct.
6. Default login: pi/bananapi or root/bananapi
7. The wiki guide is only for bananapi ubuntu/debian images.
8. USB-Serial (3.3V). Baud: 115200.

Install Image to SDcard

1. Install Image with Balena Etcher on Windows, Linux and MacOS.
Balena Etcher is an opensource GUI flash tool by Balena, Flash OS images to SDcard or USB drive.
M2s linux flash.png

Install Image to eMMC

1. Make sure that the Linux image has been burned into an SD card and started normally.

2. Enter the following command in the terminal: 

sudo bananapi-config

3. By default, select the first item continuously and press the Enter key to install the Linux system image on the eMMC.

Bpi m4 berry mobaxterm 12.jpg
Bpi m4 berry mobaxterm 13.jpg
Bpi m4 berry mobaxterm 14.jpg
Bpi m4 berry mobaxterm 15.jpg
Bpi m4 berry mobaxterm 16.jpg
Bpi m4 berry mobaxterm 17.jpg
Bpi m4 berry mobaxterm 18.jpg

4. The last step is to shut down the computer. At this time, disconnect the power supply, remove the SD card, and power on again to boot from eMMC.

Erase eMMC

1. Make sure the Linux image has been burned into an SD card and insert the SD card. By default it will boot from the SD card.

2. Enter the command lsblk in the terminal to list the block device information in the system, such as hard disks, partitions, disks, etc. 

pi@bpi-m4berry:~$ lsblk
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS
mmcblk0 179:0 0 7.4G 0 disk
└─mmcblk0p1 179:1 0 7.2G 0 part /var/log.hdd
                                        /
mmcblk1 179:32 0 7.3G 0 disk
└─mmcblk1p1 179:33 0 7.3G 0 part
mmcblk1boot0 179:64 0 4M 1 disk
mmcblk1boot1 179:96 0 4M 1 disk
zram0 252:0 0 993.2M 0 disk [SWAP]
zram1 252:1 0 50M 0 disk /var/log
zram2 252:2 0 0B 0 disk

3. mmcblk0 is the SD card and mmcblk1 is the eMMC. Enter the following command in the terminal to erase the eMMC. This process takes several minutes and is irreversible. Be careful to back up important data. 

sudo dd if=/dev/zero of=/dev/mmcblk1

Ubuntu Desktop

1. Using the Ubuntu desktop version system image, you can get a graphical operation interface.
2. You need to prepare a monitor with an HDMI interface and an HDMI cable.
3. Use an HDMI cable to connect the monitor and BPI-M4 Berry, switch the monitor input interface to the corresponding HDMI interface, power on, and wait a moment to see the desktop.

Bpi m4 berry ubuntu 1.jpg

Debug UART

1. Prepare a 3.3v USB to TTL module.
2. Use the USB to TTL module to connect the PC USB port and the Debug UART port on the board.
3. Open a serial terminal software on the PC, such as mobaxterm or putty.
4. Taking mobaxterm as an example, after setting the serial port number and 115200 baud rate, you can open the BPI-M4 Berry UART terminal.

Bpi m4 berry mobaxterm 1.jpg

Bpi m4 berry mobaxterm 2.jpg

SSH

1. Prepare a network cable and a router.
2. Use a network cable to connect the LAN port of the router to the BPI-M4 Berry, and also connect the PC to another LAN port.
3. Check the IP address of BPI-M4 Berry on the router management interface, or use the following command on the BPI-M4 Berry UART terminal to check the IP address.
  ifconfig

  eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500
        inet 192.168.3.10 netmask 255.255.255.0 broadcast 192.168.3.255
        inet6 fe80::3e1f:688f:81ab:d8b7 prefixlen 64 scopeid 0x20<link>
        ether 02:00:54:a0:d6:a6 txqueuelen 1000 (Ethernet)
        RX packets 553 bytes 92549 (92.5 KB)
        RX errors 0 dropped 0 overruns 0 frame 0
        TX packets 329 bytes 26023 (26.0 KB)
        TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0
        device interrupt 42
4. Open an SSH terminal software on the PC, such as mobaxterm or putty.
5. Taking mobaxterm as an example, fill in the obtained IP address, such as 192.168.3.10 above, in the IP address column and 22 in the Port port.

Bpi m4 berry mobaxterm 3.jpg

6. Open the SSH terminal and enter the login username/password: pi/bananapi or root/bananapi. There will be no prompt when entering the password. Please enter it normally and press Enter when finished.

Bpi m4 berry mobaxterm 4.jpg

NoMachine Remote Desktop

1. Make sure BPI-M4 Berry is connected to the Internet and use the following command to download the nomachine DEB installation package in the system.
  wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb
2. Or open NoMachine for ARM - arm64 download page in a PC browser, download the DEB installation package, and then copy it to BPI-M4 Berry user directory through SSH or USB disk.
3. After the download is completed, install it through the following command. Note that the file name is based on the actual downloaded file name.
  sudo dpkg -i nomachine_8.9.1_1_arm64.deb
4. PC side also needs to download and install NoMachine. NoMachine download page Select the installation package suitable for the PC operating system, download it locally and complete the installation.
5. Pay attention to keeping the PC and BPI-M4 Berry in the same LAN. You can try SSH connection first to ensure normal communication within the LAN.
6. Open NoMachine on the PC, click the Add button, enter the IP address of BPI-M4 Berry in the Host bar in the window after the jump, and then click the Add button.

Bpi m4 berry nomachine 1.jpg

7. Click the recognized port icon, enter the username/password in the new window that pops up, and then click the OK button.

Bpi m4 berry nomachine 2.jpg Bpi m4 berry nomachine 3.jpg

8. After completing the subsequent settings, you can see the desktop.

Bpi m4 berry nomachine 4.jpg

9. If no device is connected to the HDMI interface, the NoMachine remote desktop will display a black screen. It is recommended to keep the HDMI connection or connect an HDMI decoy device.

WiFi

Use the nmcli command to scan WiFi hotspots, connect to hotspots, and create AP hotspots.
  nmcli device #List devices
  nmcli device wifi list # List available wifi access points, list can be omitted
  nmcli device wifi connect [SSID] password [PASSWORD] # Connect to the hotspot mySSID. After the connection is successful, the configuration file will be automatically generated. If you want to connect again in the future, you can use the nmcli connection up [SSID] command.
  nmcli device disconnect [device name] # Disconnect wifi, use the wifi device name displayed in the nmcli device command
  nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # Create AP hotspot

  nmcli connection show #List network connection configuration
  nmcli connection down [NAME] # Deactivate a connection
  nmcli connection up [NAME] # Activate a connection
  nmcli connection delete [SSID] #Delete a configuration and no longer save information and automatically connect

  nmcli radio wifi off # Turn off wifi
  nmcli radio wifi on # Turn on wifi

Set static IP, DNS

1. To set a static IP, you need to maintain the connection first. If you want to set an Ethernet static IP, you must first maintain the Ethernet connection; if you want to set a wireless network static IP, you must first maintain a connection to a WIFI.
2. If the upper-level router has assigned the IP address you want to set to other devices, please change it to an idle IP, or ask other devices to give up the IP.
3. Use the nmcli connection show command to display all connections, for example:
  pi@bpi-m4berry:~$ nmcli connection show
  NAME UUID TYPE DEVICE
  TP-LINK_5G_7747 e4a49726-adf1-44d7-a621-0e3af96cc390 wifi wlx2cc3e6acd5d7
  Wired connection 1 612eda94-55dc-3c85-b05e-f16c41775b4e ethernet --
4. Use the nmcli connection show [NAME] command to display all the properties of a specific connection, such as:
  nmcli connection show TP-LINK_5G_7747 #If you want to see Ethernet, change to Wired connection 1

  #Only list three common items
  ipv4.dns: 192.168.3.1 #The default is the gateway address
  ipv4.addresses: 192.168.3.10/24 #The default is the IP address assigned by the router DHCP
  ipv4.gateway: 192.168.3.1 #Gateway address, the default is the IP address of the router
5.Set static IP:
  nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
6.Set DNS:
  nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
7.Reset:
  reboot
8. After restarting, check whether the modification is successful:
  ifconfig
  nmcli connection show TP-LINK_5G_7747

Network time synchronization

Chrony is an open source free Network Time Protocol NTP client and server software. It allows the computer to keep the system clock synchronized with the clock server (NTP), thus allowing your computer to maintain accurate time. Chrony can also be used as a server software to provide time synchronization services for other computers.
  timedatectl set-ntp false #Disable NTP-based network time synchronization

  sudo apt install chrony #Install chrony
  systemctl start chrony #Start chrony
  systemctl enable chrony
  systemctl status chrony
  systemctl restart chrony #Restart service

  timedatectl status #View time synchronization status
  timedatectl list-timezones #View time zone list
  timedatectl set-timezone Asia/Shanghai #Modify time zone
  timedatectl set-ntp true #Enable NTP network time synchronization

  date #View time
  sudo hwclock -r #View hardware clock

View hardware temperature

Enter the following command to view the temperature data returned by the sensor built into the chip on the BPI-M4 Berry board. 

  sensors

Modify HDMI output resolution

When using the Ubuntu desktop operating system, you can find the Displays column in Settings and modify the resolution.

Bpi m4 berry ubuntu 2.jpg

Use USB disk

1. Prepare a USB disk that has been partitioned normally and insert it into the USB interface of BPI-M4 Berry.
2. In the Ubuntu desktop version, you can see that the USB disk has been recognized and can be opened in the file manager, or partition management can be performed through the GParted tool.

Bpi m4 berry ubuntu 3.jpg

3. In the terminal, mount the USB disk to the local directory:
  mkdir mnt #Create a separate directory in the ~/user directory for mounting for easy management
  cat /proc/partitions | grep "sd*" #List partitions starting with sd
  sudo mount /dev/sda1 ~/mnt/ #Mount /dev/sda1 to ~/mnt/
  ls ~/mnt/ #After mounting, you can list the files in the USB disk
  sudo umount -v /dev/sda1 #umount, then you can remove the USB disk

Use Audio Devices

Prepare an audio file and copy it to the BPI-M4 Berry Ubuntu desktop system through a USB flash drive or SSH.

HDMI audio

1. Prepare a monitor with HDMI audio input function, turn on the relevant functions in the monitor settings, and use an HDMI cable to connect the monitor.
2. Set the output device to HDMI Audio in the Sound column of the settings.

Bpi m4 berry ubuntu 4.jpg

3.Play audio.

Bpi m4 berry ubuntu 5.jpg

3.5mm audio jack

1. Prepare a headset or other audio device that uses a 3.5mm plug, insert the plug into the 3.5mm jack of BPI-M4 Berry.
2. Set the output device to Audio Codec in the Sound column of the settings.

Bpi m4 berry ubuntu 6.jpg

3. Play audio.

Terminal command to play audio files

aplay -l #List devices
aplay -D hw:0,0 [path] #Play the audio file of the specified path

Use Bluetooth

1. Open settings in the Ubuntu desktop and connect a Bluetooth device, such as a Bluetooth mouse or keyboard, in the Bluetooth bar.

Bpi m4 berry ubuntu 7.jpg

2. The method to connect the Bluetooth device through the command line in the terminal is as follows:
pi@bpi-m4berry:~$ sudo bluetoothctl #Open the Bluetooth device management tool
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #Start the Bluetooth function, power off to turn it off
Changing power on succeeded
[bluetooth]# discoverable on #Allow this device to be discovered
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #Allow device pairing
Changing pairable on succeeded
[bluetooth]# scan on #Start scanning
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #The MAC address and device name of a Bluetooth mouse
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #Pair the MAC address of the Bluetooth device you want to connect to
Attempting to pair with D4:C4:85:A5:C6:B1
[CHG] Device D4:C4:85:A5:C6:B1 Connected: yes
[DEL] Device A4:C1:38:9B:F6:FD SLPO20N20200059
[CHG] Device D4:C4:85:A5:C6:B1 UUIDs: 00001800-0000-1000-8000-00805f9b34fb
[CHG] Device D4:C4:85:A5:C6:B1 UUIDs: 00001801-0000-1000-8000-00805f9b34fb
[CHG] Device D4:C4:85:A5:C6:B1 UUIDs: 0000180a-0000-1000-8000-00805f9b34fb
[CHG] Device D4:C4:85:A5:C6:B1 UUIDs: 0000180f-0000-1000-8000-00805f9b34fb
[CHG] Device D4:C4:85:A5:C6:B1 UUIDs: 00001812-0000-1000-8000-00805f9b34fb
[CHG] Device D4:C4:85:A5:C6:B1 UUIDs: 00010000-0000-1000-8000-011f2000046d
[CHG] Device D4:C4:85:A5:C6:B1 ServicesResolved: yes
[CHG] Device D4:C4:85:A5:C6:B1 Paired: yes
Pairing successful #pairing successfully
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #Exit the Bluetooth device management tool
pi@bpi-m4berry:~$
archlinux bluetooth reference document

Use IR Receiver

1. You need to prepare an infrared remote control using NEC format.
2. Enter the following command in the terminal to start receiving infrared signals.
  sudo ir-keytable -c -p NEC -t

  Old keytable cleared
  Protocols changed to nec
  Testing events. Please, press CTRL-C to abort.
  258.553895: lirc protocol(nec): scancode = 0x45
  258.553926: event type EV_MSC(0x04): scancode = 0x45
  258.553926: event type EV_SYN(0x00).
  260.667648: lirc protocol(nec): scancode = 0x46
  260.667671: event type EV_MSC(0x04): scancode = 0x46
  260.667671: event type EV_SYN(0x00).
  260.719552: lirc protocol(nec): scancode = 0x46 repeat
  260.719568: event type EV_MSC(0x04): scancode = 0x46
  260.719568: event type EV_SYN(0x00).
  273.263728: lirc protocol(nec): scancode = 0x47
  273.263753: event type EV_MSC(0x04): scancode = 0x47
  273.263753: event type EV_SYN(0x00).
  273.315591: lirc protocol(nec): scancode = 0x47 repeat
  273.315608: event type EV_MSC(0x04): scancode = 0x47
  273.315608: event type EV_SYN(0x00).

For other commands and specific application methods, please see ir-keytable reference document

Transfer files

scp

scp (secure copy) command in Linux system is used to copy file(s) between servers in a secure way.

The SCP command or secure copy allows the secure transferring of files between the local host and the remote host or between two remote hosts.

It uses the same authentication and security as it is used in the Secure Shell (SSH) protocol.

You can copy files from a Windows terminal to a Linux system on the same LAN. Just make sure the Open SSH client is turned on and can be viewed in Settings > Applications > Optional Features.

If you want to copy files from Windows systems to Linux systems, you also need to enable the Open SSH server.

Bpi m4 berry mobaxterm 6.jpg

The scp command format is: 

scp [optionals] file_source file_target
1.[optionals] is an optional parameter, such as -r, which can be used to copy the entire directory recursively.
2.file_source The file or directory to be copied.
3.file_target will copy the past path and rename it if a specific file name is entered at the end.

Take copying local files from a Windows system to a Linux system as an example. In the Windows terminal, enter: 

PS D:\temp\temp_4> scp ".\hello.txt" [email protected]:"/home/pi/Downloads/"

You can also copy files in the Linux system to the local computer in the Windows terminal: 

PS D:\temp\temp_4> scp [email protected]:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"
Where [email protected] is the user name in the Linux system and the IP address of the BPI-M4 Berry in the LAN.
Where :"/home/pi/Downloads/hello.txt" is the file path in the Linux system.
Where "D:\temp\temp_4" is the path in Windows system.

scp reference document

mobaxterm

Files can be managed through a graphical interface using mobaxterm or other similar software.

mobaxterm download
mobaxterm-linux preview version

As shown in the figure below, after establishing an SSH connection in mobaxterm, a file management window will appear on the left side of the interface, which supports copying and pasting by dragging and dropping files.

Bpi m4 berry mobaxterm 7.jpg

40 pin interface GPIO, I2C, UART, SPI, and PWM testing

GPIO

Control the GPIO port to light up the LED light.


Set the high and low levels of GPIO

M4 Berry gpio.jpg

The following is a demonstration using 7 pin.

Insert the LED light and you can see that it is not lit up.

M4 Berry gpio led 1.jpg
1.Execute
gpio mode 2 out
to set it to output mode.
2.Execute
gpio write 2 1
You can see that the LED light has been turned on.
M4 Berry gpio led 2.jpg
3.Execute
gpio write 2 0
You can see that the LED light has been turned off.
M4 Berry gpio led 1.jpg


Set pull-up and pull-down resistors

1.Firstly, it is necessary to set the GPIO port to input mode
gpio mode 2 in
2.Then set the GPIO port as an pull-up resistor
gpio mode 2 up
The LED light is lit up again
M4 Berry gpio led 1.jpg
3.Finally, set the GPIO port to dropdown mode
gpio mode 2 down
The LED light goes out again
M4 Berry gpio led 2.jpg

I2C

According to the schematic diagram, the available i2cs are i2c3 and i2c4

M4 Berry gpio i2c.png
1.Execute
sudo bananapi-config
2.Select "System"
M4 Berry-bananapi-config-1.jpg
3.Select "Hardware"
M4 Berry-bananapi-config-2.jpg
4.Use the keyboard directional keys to move, then use the spacebar to select.Select "pg-i2c3"and"pg-i2c4"
M4 Berry bananapi config i2c.jpg
5.Select "Save", then select "Back"
M4 Berry-bananapi-config-3.jpg
6.Finally, choose Reboot.
M4 Berry-bananapi-config-4.jpg
7.After restarting, check if there are i2c-3 and i2c-4 nodes.
pi@bpi-m4berry:~$ ls /dev/i2c-3
/dev/i2c-3
pi@bpi-m4berry:~$ ls /dev/i2c-4
/dev/i2c-4
8. Execute
cd /usr/src/wiringPi/examples/
gcc ./oled_demo.c -o oled -lwiringPi
9.Connect the i2c device to the pin of i2c3. Execute
sudo ./oled /dev/i2c-3
M4 Berry i2c 3 led.jpg
10.Connect the i2c device to the pin of i2c4. Execute
sudo ./oled /dev/i2c-4
M4 Berry i2c 4 led.jpg

UART

By reviewing the schematic, it can be found that the available uart are uart1 and uart5.

M4 Berry gpio uart.png
1.Uart1 and Uart5 is closed by default and needs to be opened. Execute
sudo bananapi-config
2.Select "System"
M4 Berry-bananapi-config-1.jpg
3.Select "Hardware"
M4 Berry-bananapi-config-2.jpg
4.Use the keyboard directional keys to move, then use the spacebar to select.If you want to use uart1,select"pg-uart1".If you want to use uart5,select"ph-uart5"
M4 Berry bananapi config uart.jpg
5.Select "Save", then select "Back"
M4 Berry-bananapi-config-3.jpg
6.Finally, choose Reboot.
M4 Berry-bananapi-config-4.jpg
7.After restarting, check if there are ttyS5 nodes.
pi@bpi-m4berry:~$ ls /dev/ttyS5
/dev/ttyS5
8:Short circuit uart1 pin or uart5 and execute
gpio serial /dev/ttyS1
M4 Berry gpio uart1.jpg
M4 Berry gpio uart5.jpg

SPI

By reviewing the schematic, it can be found that the available spi is spi1.

M4 Berry-sch-gpio-spi.png
1.Execute
sudo bananapi-config
2.Select "System"
M4 Berry-bananapi-config-1.jpg
3.Select "Hardware"
M4 Berry-bananapi-config-2.jpg
4.Use the keyboard directional keys to move, then use the spacebar to select.Select "spi1-cs1-spidev"
M4 Berry-bananapi-config-spi.jpg
5.Select "Save", then select "Back"
M4 Berry-bananapi-config-3.jpg
6.Finally, choose Reboot.
M4 Berry-bananapi-config-4.jpg
7.After restarting, check if there are SPI nodes.
pi@bpi-m4berry:~$ ls /dev/spidev1.1
/dev/spidev1.1
8.Execute
sudo spidev_test -v -D /dev/spidev1.1
M4 Berry-bananapi-config-spi-1.jpg


It can be seen that TX and RX are different. So, we need to short-circuit MOSI and MISO and execute the command again.
M4 Berry-bananapi-config-spi-2.jpg

PWM

HDMI LCD

Bananapi M4 Berry Tested HDMI LCD
panel Test Video
Waveshare 4inch 720x720 https://youtu.be/CRcjx6_29rA
Waveshare 5inch 960x544 https://youtu.be/0wZ3lWQQTkQ
Waveshare 5.5inch 1440x2560 https://youtu.be/z9gTHa3i8Ag
Waveshare 8inch 1536x2048 https://youtu.be/Qjwo4vVBQmo
Waveshare 8.8inch 480x1920 https://youtu.be/SP9-HGrY6-M
Waveshare 11.9inch 320x1480 https://youtu.be/WA1yBGcYZds
Waveshare 12.3inch 1920x720 https://youtu.be/OJfqtHlgDvk
Retrieved from "https://wiki.banana-pi.org/index.php?title=Getting_Started_with_BPI-M4_Berry&oldid=17303"