Banana Pi Wiki - User contributions [en]

Banana Pi BPI-F3

2024-10-16T02:18:28Z

Qubot: /* Hardware Spec */

[[zh:香蕉派_BPI-F3]]

= BPI-F3 Introduction =

Banana Pi BPI-F3 is a industrial grade RISC-V development board, it design with SpacemiT K1 8 core RISC-V chip, CPU integrates 2.0 TOPs AI computing power. 2/4/8/16G DDR and 8/16/32/128G eMMC onboard.2x GbE Ethernet prot, 4x USB 3.0 and PCIe for M.2 interface, support HDMI and Dual MIPI-CSI Camera.

[[File:banana_pi_bpi-f3_banner_4.jpg]]

== about SpacemiT K1 8 core RISC-V chip ==

SpacemiT K1 is an octa-core 64-bit RISC-V AI CPU. Base on RISC-V open instruction set architecture,we are committed to create more energy efficient and more commonly used AI processor platform,promote global open source and open ecological computing power construction.

SpacemiT K1 is mainly used for single board computer,network storage,cloud computer,smart robort,industrial control,edge computer,etc.

[https://docs.banana-pi.org/en/BPI-F3/SpacemiT_K1 SpacemiT K1 8 core RISC-V chip Brief]

[https://docs.banana-pi.org/en/BPI-F3/SpacemiT_K1_datasheet SpacemiT K1 8 core RISC-V chip datasheet]

== Key Features==

* 8 core RISC-V chip, CPU integrates 2.0 TOPs AI computing power

* Single-core general computing power equivalent to 1.3 times Cortex-A55

* Supports 32-bit LPDDR4/4X, with a maximum of 16GB of memory

* 4K decoding and encoding

* 5-lane PCIE2.1 expansion capability

* 1x USB 3.0 + 2x USB 2.0 interfaces

* 12x UART serial ports

* Operating temperature range: -40°C to 85°C

== Application direction==

* NAS
* Laptop
* Intelligent robotics
* Industrial control
* AI edge computing

== Getting Start==

[https://docs.banana-pi.org/en/BPI-F3/GettingStarted_BPI-F3 Getting Started BPI-F3]

= Hardware=

== Hardware Interface==

[[File:bananna_pi_bpi-f3_interface.jpg]]

[[File:bpi-f3_sch.png]]

== Hardware Spec==
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="2"| '''HardWare Specification of Banana Pi BPI-F3 RISC-V SBC'''
|-
| CPU || SpacemiT K1 8 core RISC-V chip
|-
| AI || 2.0Tops from RlSC-V Core
|-
| Memory || 2/4/8/16 GB LPDDR4 (Supports up to 16G LPDDR4)
|-
| Storage || 8/16/32/128G eMMC flash(Optional 4M SPI NOR,32M SPI NAD)
|-
| SD card || MicroSD card slot (Greater than 256MB)
|-
| Wireless || 2.4G/5G WiFi and Bluetooth 4.2
|-
| Ethernet || 2x GbE Ethernet port(supports PoE with add-on PoE HAT)
|-
| HDMI || 1x full-size HDMI digital Audio output(HDMI1.4,up to 1080p@60fps )
|-
| Audio || Speaker，Mic， Earphone
|-
| Camera || MIPI-CSI, Dual-shot support
|-
| USB || 4x USB 3.0 Type-A HOST, 1x USB 2.0 Type-C OTG
|-
| PCIe || PCIE2.1 2lane * 2.
|-
| || PCIEB 2lane connect M.2 KEY M( Support JMB582 expansion card to SATA )
|-
| || PCIEC 1lane connect MINI PCIE
|-
| GPIO || 26-pin header
|-
| Buttons || Reset, Power and Burn
|-
| LED || Power Status
|-
| Power || DC in and TYPE-C in
|-
| Size || 148x100 mm
|-
| Weight || 200g
|}

== GPIO Pin Define==

=== 26 PIN GPIO===
{| class="wikitable" style="text-align:center;"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''40-pin header define and GPIO Alternative Functions Assignments'''
|-
! PIN
! Function
! Function
! PIN
|-
|1
|VCC3V3_SYS
|VCC5V0_OUT
|2
|-
|3
|AP_I2C4_SDA_3V3
|VCC5V0_OUT
|4
|-
|5
|AP_I2C4_SCL_3V3
|GND
|6
|-
|7
|GPIO_70_3V3
|R_UART0_TXD_3V3
|8
|-
|9
|GND
|R_UART0_RXD_3V3
|10
|-
|11
|GPIO_71_3V3
|GPIO_74_3V3
|12
|-
|13
|GPIO_72_3V3
|GND
|14
|-
|15
|GPIO_73_3V3
|GPIO_91_3V3
|16
|-
|17
|VCC3V3_SYS
|GPIO_92_3V3
|18
|-
|19
|SPI3_MOSI_3V3
|GND
|20
|-
|21
|SPI3_MISO_3V3
|GPIO_49_3V3
|22
|-
|23
|SPI3_SCLK_3V3
|SPI3_CS_3V3
|24
|-
|25
|GND
|GPIO_50_3V3
|2
|-
|}

=== MIPI DSI screen connection socket===
Holding a 1080P screen (JL-M101N013-P12WU-M402632), the screen socket model is FH35C-31S-0.3SHW (50)

{| class="wikitable" style="text-align:center;"
|-
! PIN
! Function
! Function
! PIN
|-
|1
|MIPI_DSI1_LANE0_DN
|MIPI_DSI1_LANE0_DP
|2
|-
|3
|GND
|MIPI_DSI1_LANE1_DN
|4
|-
|5
|MIPI_DSI1_LANE1_DP
|GND
|6
|-
|7
|MIPI_DSI1_CLK_N
|MIPI_DSI1_CLK_P
|8
|-
|9
|GND
|MIPI_DSI1_LANE2_DN
|10
|-
|11
|MIPI_DSI1_LANE2_DP
|GND
|12
|-
|13
|MIPI_DSI1_LANE3_DN
|MIPI_DSI1_LANE3_DP
|14
|-
|15
|GND
|MIPI_LCD_ADC_1V8
|16
|-
|17
|LCD_PWR_EN_1V8
|LCD_RST_1V8
|18
|-
|19
|LCD_BL_EN_1V8
|LCD_BL_PWM_1V8
|20
|-
|21
|GND
|TP_INT_1V8
|22
|-
|23
|TP_RST_1V8
|AP_I2C6_SCL
|24
|-
|25
|AP_I2C6_SDA
|LCD_VCC18
|26
|-
|27
|GND
|GND
|28
|-
|29
|LCD_VCC5V0
|LCD_VCC5V0
|30
|-
|31
|LCD_VCC5V0
|
|
|-
|}

=== Camera module base===

By default, it supports a 16M camera module, which can be modified
After blocking the configuration, hold the 8M camera module and adopt a uniform spacing
0.4mm 30 pin socket (model QG1330421Y-M08-7H).

'''16M camera：'''
{| class="wikitable" style="text-align:center;"
|-
! PIN
! Function
! Function
! PIN
|-
|1
|GND
|GND
|2
|-
|3
|GND
|FS_DUALCAM
|4
|-
|5
|CAM_MCLK0
|GND
|6
|-
|7
|GND
|CAMERA0_RST
|8
|-
|9
|MIPI_CSI1_DN0
|CAMERA0_PDN
|10
|-
|11
|MIPI_CSI1_DP0
|CAM_I2C0_SDA
|12
|-
|13
|GND
|CAM_I2C0_SCL
|14
|-
|15
|MIPI_CSI1_CLKN
|CSI_DVDD12
|16
|-
|17
|MIPI_CSI1_CLKP
|CSI_VCCIO18
|18
|-
|19
|GND
|GND
|20
|-
|21
|MIPI_CSI1_DN1
|CSI_AVDD28
|22
|-
|23
|MIPI_CSI1_DP1
|CSI_AFVCC28
|24
|-
|25
|GND
|GND
|26
|-
|27
|MIPI_CSI1_DN2
|MIPI_CSI1_DP3
|28
|-
|29
|MIPI_CSI1_DP2
|MIPI_CSI1_DN3
|30
|-
|}

'''8M camera:'''

{| class="wikitable" style="text-align:center;"
|-
! PIN
! Function
! Function
! PIN
|-
|1
|MIPI_CSI3_DP3
|CAM_MCLK1
|2
|-
|3
|MIPI_CSI3_DN3
|CAMERA1_RST
|4
|-
|5
|GND
|CAMERA1_PDN
|6
|-
|7
|MIPI_CSI3_DP2
|GND
|8
|-
|9
|MIPI_CSI3_DN2
|CAM_I2C1_SDA
|10
|-
|11
|GND
|CAM_I2C1_SCL
|12
|-
|13
|MIPI_CSI3_DP1
|GND
|14
|-
|15
|MIPI_CSI3_DN1
|CSI_VCCIO18
|16
|-
|17
|GND
|CSI_AVDD28
|18
|-
|19
|MIPI_CSI3_CLKP
|CSI_AFVCC28
|20
|-
|21
|MIPI_CSI3_CLKN
|CSI_DVDD12
|22
|-
|23
|GND
|FLASH_LED0+
|24
|-
|25
|MIPI_CSI3_DP0
|FLASH_LED1+
|26
|-
|27
|MIPI_CSI3_DN0
|GND
|28
|-
|29
|GND
|GND
|30
|-
|}

== POE support==
We design PoE function for BPI-F3 ,so easy to add PoE module to support PoE function.After welding the POE module, it is powered by the RJ45-2 interface.

[[File:BPI-F3 POE power supply.jpg]]

== 4G module==

After connecting to the MINI PCIE interface and inserting the SIM card, it can be used.

= Development=

== Source Code==

=== Linux BSP Source Code===

* pi-opensbi: https://github.com/BPI-SINOVOIP/pi-opensbi/tree/v1.3-k1

* u-boot: https://github.com/BPI-SINOVOIP/pi-u-boot/tree/v2022.10-k1

* kernel: https://github.com/BPI-SINOVOIP/pi-linux/tree/linux-6.1.15-k1

* Armbian: https://github.com/BPI-SINOVOIP/armbian-build/tree/v24.04.30

== Resources==
*BPI-F3 schematic:
:Baidu cloud: https://pan.baidu.com/s/1CMp7kVKa5aeSdgB3Ri1PJw?pwd=8888 (pincode:8888)
:Google drive: https://drive.google.com/file/d/19iLJ5xnCB_oK8VeQjkPGjzAn39WYyylv/view?usp=sharing

* BPI-F3 DXF file:
:Baidu cloud: https://pan.baidu.com/s/1igwBjsLC54KbGH_y54tZQA?pwd=8888 (pincode:8888)
:Google drive:https://drive.google.com/file/d/1Y29kMCUNRPPsj4ELMnQTls74owiXcPKx/view?usp=sharing

* BPI-F3 run Ubuntu Linux test 8 Core CPU performance and AI function: https://www.youtube.com/watch?v=Ym-VcJgaGIY

* BPI-F3 SpacemiT K1 run OpenWRT: https://www.youtube.com/watch?v=ejV5KFww8Xo

* BPI-F3 run visual AI+ large models simultaneously: https://www.youtube.com/watch?v=Kn7GYiOxato

= System Image=
== Tools==
* Windows PC: https://download.banana-pi.dev/d/ca025d76afd448aabc63/files/?p=%2FTools%2Fimage_download_tools%2Ftitantools_for_windows-1.0.35-beta.zip

* Linux PC: https://download.banana-pi.dev/d/ca025d76afd448aabc63/files/?p=%2FTools%2Fimage_download_tools%2Ftitantools_for_linux-1.0.35-beta.zip

== Linux==

===Bianbu===
* Bianbu-23.10-k1-v1.0rc3-release-20240525131412.img

:Baidu cloud: https://pan.baidu.com/s/1H0ww8qVIgHRuuA43JszF6g?pwd=8888 (pincode: 8888)
:Google drive: https://drive.google.com/drive/folders/1eEfMkzNzHyDwz3_Ox8i2acvU4W5CowiW?usp=sharing
:Account/Password: root/bianbu

* Bianbu-23.10-nas-k1-v1.0rc1-release-20240429192450.img
:Baidu cloud: https://pan.baidu.com/s/15owwUEjIU_i26cI1iigAew?pwd=8888 (pincode: 8888)
:Google drive: https://drive.google.com/drive/folders/1LQoioz6N5YQpSOxY47OmetnPX4yggtT0?usp=sharing
:Account/Password: root/bianbu

* Bianbu-23.10-desktop-k1-v1.0rc1-release-20240429194149.img
:Baidu cloud: https://pan.baidu.com/s/1zvFkX92f5gpZdKjP-vGJvA?pwd=8888 (pincode: 8888)
:Google drive: https://drive.google.com/drive/folders/1kCHiMwjnhvZaRBy5vkj6UlPeAlpRQ14P?usp=sharing
:Account/Password: root/bianbu

=== Debian ===
* 2024-06-14-Armbian-bpi-SpacemiT_24.5.0-trunk_Bananapif3_sid_legacy_6.1.15_xfce_desktop.img
:Baidu cloud: https://pan.baidu.com/s/19ehNuer2pMatZTt6PIs0kg?pwd=8888 (pincode: 8888)
:Google drive: https://drive.google.com/file/d/1BvfYttXv9BGazzbyekMzI0zp7SGxHb2M/view?usp=sharing

* 2024-06-14-Armbian-bpi-SpacemiT_24.5.0-trunk_Bananapif3_sid_legacy_6.1.15.img
:Baidu cloud: https://pan.baidu.com/s/1HsroEhKmeFCQU_1lKZxL1A?pwd=8888 (pincode: 8888)
:Google drive: https://drive.google.com/file/d/1gyUtVZL4S--KCQoXxXDlC-IqbvAn1mSR/view?usp=sharing

=== Armbian ===
* 2024-06-11-Armbian-bpi-SpacemiT_24.5.0-trunk_Bananapif3_noble_legacy_6.1.15_xfce_desktop.img

:Baidu cloud: https://pan.baidu.com/s/1ebteWqsmkImaLGQ2mJkJnA?pwd=8888 (pincode: 8888)

:Google drive: https://drive.google.com/file/d/16zKsqISzMm5Xwx7ssJHynZe2PZFQ21-i/view?usp=sharing

=== Fedora ===

* Fedora.riscv64-40-20240429.n.0.raw.zst-bpi-f3-3356MB.img

:Baidu cloud: https://pan.baidu.com/s/1EFcLInWYxLi032gmhueiWw?pwd=8888 (pincode: 8888)

:Google drive： https://drive.google.com/file/d/1v-nHZA3AyFLaLRs6bt22XjIh7OVczI9d/view?usp=sharing

= Easy to buy=
*SINOVOIP Aliexpress shop: https://www.aliexpress.com/item/3256806735430070.html
*BPI Aliexpress shop: https://www.aliexpress.com/item/3256806735645440.html
*Taobao Shop:https://item.taobao.com/item.htm?id=789483353026&spm=a213gs.v2success.0.0.220c4831vddhXz
*OEM&ODM, please contact: judyhuang@banana-pi.com

Getting Started with BPI-M4 Berry

2024-01-26T06:30:38Z

Qubot: /* HDMI LCD */

[[zh:快速上手_BPI-M4_Berry]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]
[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[Banana Pi BPI-M2 Berry]] A40i-H design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[Banana Pi BPI-M2S]] Amlogic A311D/S922 chip]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=Development=

==Android==
===Prepare===

:1. Download latest [[Banana_Pi_BPI-M4_Berry#System_image | Android image]].

: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 power supply.

===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 SW2 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===

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

: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==
===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 [[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

: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===
:1. Install Image with Balena Etcher on Windows, Linux and MacOS.
:[https://balena.io/etcher Balena Etcher] is an opensource GUI flash tool by Balena, Flash OS images to SDcard or USB drive.

:[[File: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:
<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.

:[[File:Bpi_m4_berry_mobaxterm_12.jpg]]
:[[File:Bpi_m4_berry_mobaxterm_13.jpg]]
:[[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]]

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.

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

[[File: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 [https://mobaxterm.mobatek.net/ mobaxterm] or [https://www.putty.org/ 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.

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File: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 [https://mobaxterm.mobatek.net/ mobaxterm] or [https://www.putty.org/ 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.

[[File: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.

[[File: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 [https://downloads.nomachine.com/download/?id=117&distro=ARM 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. [https://download.nomachine.com 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.
[[File: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.
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8. After completing the subsequent settings, you can see the desktop.
[[File: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

:* [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]

===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

:* [https://chrony-project.org/documentation.html Chrony reference documentation]

===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.

[[File: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.

[[File: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.
[[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" pi@192.168.3.12:"/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 pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: Where pi@192.168.3.12 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
|}

Getting Started with BPI-M4 Berry

2024-01-26T06:21:19Z

Qubot: /* HDMI LCD */

[[zh:快速上手_BPI-M4_Berry]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]
[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[Banana Pi BPI-M2 Berry]] A40i-H design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[Banana Pi BPI-M2S]] Amlogic A311D/S922 chip]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=Development=

==Android==
===Prepare===

:1. Download latest [[Banana_Pi_BPI-M4_Berry#System_image | Android image]].

: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 power supply.

===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 SW2 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===

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

: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==
===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 [[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

: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===
:1. Install Image with Balena Etcher on Windows, Linux and MacOS.
:[https://balena.io/etcher Balena Etcher] is an opensource GUI flash tool by Balena, Flash OS images to SDcard or USB drive.

:[[File: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:
<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.

:[[File:Bpi_m4_berry_mobaxterm_12.jpg]]
:[[File:Bpi_m4_berry_mobaxterm_13.jpg]]
:[[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]]

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.

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

[[File: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 [https://mobaxterm.mobatek.net/ mobaxterm] or [https://www.putty.org/ 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.

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File: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 [https://mobaxterm.mobatek.net/ mobaxterm] or [https://www.putty.org/ 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.

[[File: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.

[[File: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 [https://downloads.nomachine.com/download/?id=117&distro=ARM 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. [https://download.nomachine.com 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.
[[File: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.
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8. After completing the subsequent settings, you can see the desktop.
[[File: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

:* [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]

===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

:* [https://chrony-project.org/documentation.html Chrony reference documentation]

===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.

[[File: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.

[[File: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.
[[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" pi@192.168.3.12:"/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 pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: Where pi@192.168.3.12 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/3.5inch-hdmi-lcd.htm Waveshare 3.5inch 480x320] ||
|-
| [https://www.waveshare.com/3.5inch-hdmi-lcd-e.htm Waveshare 3.5inch 640x480] ||
|-
| [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/5inch-hdmi-lcd-h.htm Waveshare 5inch 800x480] ||
|-
| [https://www.waveshare.com/5.5inch-1440x2560-lcd.htm Waveshare 5.5inch 1440x2560] || https://youtu.be/z9gTHa3i8Ag
|-
| [https://www.waveshare.com/7inch-hdmi-lcd-b.htm Waveshare 7inch 800x480] ||
|-
| [https://www.waveshare.com/7inch-hdmi-lcd-c.htm Waveshare 7inch 1024x600] ||
|-
| [https://www.waveshare.com/7.9inch-HDMI-LCD.htm Waveshare 7.9inch 400x1280] ||
|-
| [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/9inch-2560x1600-Monitor.htm Waveshare 9inch 2560x1600] ||
|-
| [https://www.waveshare.com/10.1inch-HDMI-LCD-E.htm Waveshare 10.1inch 1024x600] ||
|-
| [https://www.waveshare.com/10.1inch-hdmi-lcd-b-with-case.htm Waveshare 10.1inch 1280x800] ||
|-
| [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
|-
| [https://www.waveshare.com/13.3inch-HDMI-LCD-H.htm Waveshare 13.3inch 1920x1080] ||
|-
| [https://www.waveshare.com/15.6inch-hdmi-lcd-h-with-case.htm Waveshare 15.6inch 1920x1080] ||
|}

Getting Started with BPI-M4 Berry

2024-01-26T06:20:40Z

Qubot: /* HDMI LCD */

[[zh:快速上手_BPI-M4_Berry]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]
[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[Banana Pi BPI-M2 Berry]] A40i-H design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[Banana Pi BPI-M2S]] Amlogic A311D/S922 chip]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=Development=

==Android==
===Prepare===

:1. Download latest [[Banana_Pi_BPI-M4_Berry#System_image | Android image]].

: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 power supply.

===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 SW2 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===

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

: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==
===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 [[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

: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===
:1. Install Image with Balena Etcher on Windows, Linux and MacOS.
:[https://balena.io/etcher Balena Etcher] is an opensource GUI flash tool by Balena, Flash OS images to SDcard or USB drive.

:[[File: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:
<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.

:[[File:Bpi_m4_berry_mobaxterm_12.jpg]]
:[[File:Bpi_m4_berry_mobaxterm_13.jpg]]
:[[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]]

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.

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

[[File: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 [https://mobaxterm.mobatek.net/ mobaxterm] or [https://www.putty.org/ 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.

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File: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 [https://mobaxterm.mobatek.net/ mobaxterm] or [https://www.putty.org/ 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.

[[File: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.

[[File: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 [https://downloads.nomachine.com/download/?id=117&distro=ARM 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. [https://download.nomachine.com 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.
[[File: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.
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8. After completing the subsequent settings, you can see the desktop.
[[File: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

:* [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]

===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

:* [https://chrony-project.org/documentation.html Chrony reference documentation]

===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.

[[File: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.

[[File: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.
[[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" pi@192.168.3.12:"/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 pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: Where pi@192.168.3.12 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/3.5inch-hdmi-lcd.htm Waveshare 3.5inch 480x320] ||
|-
| [https://www.waveshare.com/3.5inch-hdmi-lcd-e.htm Waveshare 3.5inch 640x480] ||
|-
| [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/5inch-hdmi-lcd-h.htm Waveshare 5inch 800x480] ||
|-
| [https://www.waveshare.com/5.5inch-1440x2560-lcd.htm Waveshare 5.5inch 1440x2560] || https://youtu.be/z9gTHa3i8Ag
|-
| [https://www.waveshare.com/7inch-hdmi-lcd-b.htm Waveshare 7inch 800x480] ||
|-
| [https://www.waveshare.com/7inch-hdmi-lcd-c.htm Waveshare 7inch 1024x600] ||
|-
| [https://www.waveshare.com/7.9inch-HDMI-LCD.htm Waveshare 7.9inch 400x1280] ||
|-
| [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/9inch-2560x1600-Monitor.htm Waveshare 9inch 2560x1600] || setenv display_autodetect "false"
setenv hdmimode "2560x1600p60hz"
|-
| [https://www.waveshare.com/10.1inch-HDMI-LCD-E.htm Waveshare 10.1inch 1024x600] ||
|-
| [https://www.waveshare.com/10.1inch-hdmi-lcd-b-with-case.htm Waveshare 10.1inch 1280x800] ||
|-
| [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
|-
| [https://www.waveshare.com/13.3inch-HDMI-LCD-H.htm Waveshare 13.3inch 1920x1080] ||
|-
| [https://www.waveshare.com/15.6inch-hdmi-lcd-h-with-case.htm Waveshare 15.6inch 1920x1080] ||
|}

Getting Started with BPI-M4 Berry

2024-01-26T06:20:16Z

Qubot:

[[zh:快速上手_BPI-M4_Berry]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]
[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[Banana Pi BPI-M2 Berry]] A40i-H design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[Banana Pi BPI-M2S]] Amlogic A311D/S922 chip]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=Development=

==Android==
===Prepare===

:1. Download latest [[Banana_Pi_BPI-M4_Berry#System_image | Android image]].

: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 power supply.

===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 SW2 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===

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

: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==
===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 [[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

: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===
:1. Install Image with Balena Etcher on Windows, Linux and MacOS.
:[https://balena.io/etcher Balena Etcher] is an opensource GUI flash tool by Balena, Flash OS images to SDcard or USB drive.

:[[File: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:
<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.

:[[File:Bpi_m4_berry_mobaxterm_12.jpg]]
:[[File:Bpi_m4_berry_mobaxterm_13.jpg]]
:[[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]]

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.

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

[[File: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 [https://mobaxterm.mobatek.net/ mobaxterm] or [https://www.putty.org/ 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.

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File: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 [https://mobaxterm.mobatek.net/ mobaxterm] or [https://www.putty.org/ 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.

[[File: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.

[[File: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 [https://downloads.nomachine.com/download/?id=117&distro=ARM 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. [https://download.nomachine.com 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.
[[File: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.
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8. After completing the subsequent settings, you can see the desktop.
[[File: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

:* [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]

===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

:* [https://chrony-project.org/documentation.html Chrony reference documentation]

===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.

[[File: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.

[[File: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.
[[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" pi@192.168.3.12:"/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 pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: Where pi@192.168.3.12 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/3.5inch-hdmi-lcd.htm Waveshare 3.5inch 480x320] ||
|-
| [https://www.waveshare.com/3.5inch-hdmi-lcd-e.htm Waveshare 3.5inch 640x480] ||
|-
| [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/5inch-hdmi-lcd-h.htm Waveshare 5inch 800x480] ||
|-
| [https://www.waveshare.com/5.5inch-1440x2560-lcd.htm Waveshare 5.5inch 1440x2560] || https://youtu.be/z9gTHa3i8Ag
|-
| [https://www.waveshare.com/7inch-hdmi-lcd-b.htm Waveshare 7inch 800x480] ||
|-
| [https://www.waveshare.com/7inch-hdmi-lcd-c.htm Waveshare 7inch 1024x600] ||
|-
| [https://www.waveshare.com/7.9inch-HDMI-LCD.htm Waveshare 7.9inch 400x1280] ||
|-
| [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/9inch-2560x1600-Monitor.htm Waveshare 9inch 2560x1600] || setenv display_autodetect "false"
setenv hdmimode "2560x1600p60hz"
|-
| [https://www.waveshare.com/10.1inch-HDMI-LCD-E.htm Waveshare 10.1inch 1024x600] ||
|-
| [https://www.waveshare.com/10.1inch-hdmi-lcd-b-with-case.htm Waveshare 10.1inch 1280x800] ||
|-
| [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
|-
| [https://www.waveshare.com/13.3inch-HDMI-LCD-H.htm Waveshare 13.3inch 1920x1080] ||
|-
| [https://www.waveshare.com/15.6inch-hdmi-lcd-h-with-case.htm Waveshare 15.6inch 1920x1080] ||
|}

: backlight control

https://github.com/Dangku/Waveshare-USB-Brightness

Getting Started with BPI-M4 Berry

2024-01-17T07:39:28Z

Qubot: /* UART */

[[zh:快速上手_BPI-M4_Berry]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]
[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[Banana Pi BPI-M2 Berry]] A40i-H design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[Banana Pi BPI-M2S]] Amlogic A311D/S922 chip]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=development=

==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 [[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

: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===
:1. Install Image with Balena Etcher on Windows, Linux and MacOS.
:[https://balena.io/etcher Balena Etcher] is an opensource GUI flash tool by Balena, Flash OS images to SDcard or USB drive.

:[[File: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:
<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.

:[[File:Bpi_m4_berry_mobaxterm_12.jpg]]
:[[File:Bpi_m4_berry_mobaxterm_13.jpg]]
:[[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]]

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.

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

[[File: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 [https://mobaxterm.mobatek.net/ mobaxterm] or [https://www.putty.org/ 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.

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File: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 [https://mobaxterm.mobatek.net/ mobaxterm] or [https://www.putty.org/ 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.

[[File: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.

[[File: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 [https://downloads.nomachine.com/download/?id=117&distro=ARM 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. [https://download.nomachine.com 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.
[[File: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.
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8. After completing the subsequent settings, you can see the desktop.
[[File: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

:* [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]

===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

:* [https://chrony-project.org/documentation.html Chrony reference documentation]

===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.

[[File: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.

[[File: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.
[[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" pi@192.168.3.12:"/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 pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: Where pi@192.168.3.12 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====

Getting Started with BPI-M4 Berry

2024-01-17T07:37:49Z

Qubot: /* UART */

[[zh:快速上手_BPI-M4_Berry]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]
[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[Banana Pi BPI-M2 Berry]] A40i-H design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[Banana Pi BPI-M2S]] Amlogic A311D/S922 chip]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=development=

==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 [[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

: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===
:1. Install Image with Balena Etcher on Windows, Linux and MacOS.
:[https://balena.io/etcher Balena Etcher] is an opensource GUI flash tool by Balena, Flash OS images to SDcard or USB drive.

:[[File: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:
<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.

:[[File:Bpi_m4_berry_mobaxterm_12.jpg]]
:[[File:Bpi_m4_berry_mobaxterm_13.jpg]]
:[[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]]

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.

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

[[File: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 [https://mobaxterm.mobatek.net/ mobaxterm] or [https://www.putty.org/ 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.

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File: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 [https://mobaxterm.mobatek.net/ mobaxterm] or [https://www.putty.org/ 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.

[[File: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.

[[File: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 [https://downloads.nomachine.com/download/?id=117&distro=ARM 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. [https://download.nomachine.com 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.
[[File: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.
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8. After completing the subsequent settings, you can see the desktop.
[[File: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

:* [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]

===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

:* [https://chrony-project.org/documentation.html Chrony reference documentation]

===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.

[[File: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.

[[File: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.
[[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" pi@192.168.3.12:"/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 pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: Where pi@192.168.3.12 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 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====

Getting Started with BPI-M4 Berry

2024-01-17T07:36:07Z

Qubot: /* UART */

[[zh:快速上手_BPI-M4_Berry]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]
[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[Banana Pi BPI-M2 Berry]] A40i-H design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[Banana Pi BPI-M2S]] Amlogic A311D/S922 chip]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=development=

==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 [[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

: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===
:1. Install Image with Balena Etcher on Windows, Linux and MacOS.
:[https://balena.io/etcher Balena Etcher] is an opensource GUI flash tool by Balena, Flash OS images to SDcard or USB drive.

:[[File: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:
<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.

:[[File:Bpi_m4_berry_mobaxterm_12.jpg]]
:[[File:Bpi_m4_berry_mobaxterm_13.jpg]]
:[[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]]

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.

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

[[File: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 [https://mobaxterm.mobatek.net/ mobaxterm] or [https://www.putty.org/ 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.

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File: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 [https://mobaxterm.mobatek.net/ mobaxterm] or [https://www.putty.org/ 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.

[[File: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.

[[File: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 [https://downloads.nomachine.com/download/?id=117&distro=ARM 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. [https://download.nomachine.com 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.
[[File: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.
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8. After completing the subsequent settings, you can see the desktop.
[[File: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

:* [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]

===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

:* [https://chrony-project.org/documentation.html Chrony reference documentation]

===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.

[[File: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.

[[File: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.
[[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" pi@192.168.3.12:"/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 pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: Where pi@192.168.3.12 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 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 uart1,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====

BPI-Pico-RP2040

2024-01-09T02:43:32Z

Qubot: /* Hardware Size */

[[zh:BPI-Pico-RP2040_开发板]]

= Introduction =
[[File:BPI-Pico-RP2040_banner.png|750px]]

[[File:PICO-1000-7.jpg|thumb|[[BPI-PicoW-S3 ]]with ESP32-S3]]
[[File:PICO-1000-5.png|thumb|[[BPI-PicoW-S3 ]]with ESP32-S3]]
[[File:Leaf-S3-incline-front.jpg|thumb|[[BPI-Leaf-S3]] with ESP32-S3]]
[[File:Smart-01-03.gif|thumb|[[BPI-Smart ]]with ESP8266]]
[[File:Webduino_gif.gif|thumb|[[BPI-Bit]] with ESP32]]
[[File:BPI-AI_1.JPG|thumb|[[BPI-AI]] Kendryte K210 RISC-V]]
[[File:ESP32_6.JPG|thumb|[[BPI-UNO32]] with ESP32 design]]

The Banana Pi Pico series is a low-power microcontroller development board designed for the Internet of Things.

BPI-Pico-RP2040 is a microcontroller development board launched by Banana Pi equipped with RP2040 chip. Its most notable feature is to add a Onboard WS2812 color LED; replace the 3-Pin DEBUG interface with a JST SH 1mm 4-Pin socket, which can be connected with Qwiic & STEMMA QT or any possible peripherals; replace the micro-USB socket with a USB Type-C socket , supports reversible insertion, and is compatible with the USB Type-C cable of most modern smartphones, no additional purchase is required.

== key features ==

* Dual-core ARM Cortex M0+ CPU cores (up to 133 MHz)
* 264K SRAM
* 2MB Flash
* 26 available GPIO pins, 4 of which support ADC analog input
* 1 x LED
* 1 x Neopixel LED
* 1 × SH 1.0 4-Pin socket
* 1 × USB Type-C socket

= Hardware =

== Hardware interface ==

[[File:BPI-Pico-RP2040-V0.2-IO_800.jpg|800px]]

== Hardware spec ==

{| class="wikitable"
|-
! colspan="2" style="background-color:#ffcb2f;" | BPI-Pico-RP2040 Spec Sheet
|-
| Main Chip
| RP2040,Dual-core ARM Cortex M0+ CPU cores
|-
| Frequency
| 133MHz MAX
|-
| Operating temperature
| -20℃~+85℃
|-
| On-chip SRAM
| 264 KB
|-
| On-board FLASH
| 2MB
|-
| GPIO
| 26 GPIO
|-
| ADC
| 4 analogue inputs
|-
| rowspan="6" | PIO
| I2C
|-
| SPI,DSPI,QSPI
|-
| UART
|-
| SDIO (SD card)
|-
| I2S
|-
| 8080 and 6800 parallel port
|-
| USB input voltage
| 5V
|-
| 3V3 output current
| 2A MAX
|-
| Neopixel LED
| 1
|-
| LED
| 1
|-
| USB Type-C socket
| 1
|-
| SH 1.0 4-pin socket
| 1
|}

== Hardware Size ==

[[File:BPI-Pico-RP2040-V0.2-dimension.jpg|800px]]

{| class="wikitable"
|-
!colspan="2" style=" background-color:#ffcb2f;" | BPI-Pico-RP2040 size chart
|-
| Pin spacing
| 2.54mm
|-
| Mounting hole spacing
| 17.6mm/ 11.4mm
|-
| Mounting hole size
| Inner diameter 2.1mm/outer diameter 3.4mm
|-
| Mainboard size
| 11.4 × 55.8(mm)
|-
| Thickness
| 1.2mm
|}

The pin spacing is compatible with universal boards (hole boards, dot matrix boards) and breadboards, which is convenient for debugging applications.

= Software =

==MicroPython==

[[File:Mircopython.png | 800px]]

MicroPython implements most of the features and syntax of Python 3, which is easy to learn and use, and can be downloaded directly into the chip to run the verification program without compiling.

Regardless of whether you have a programming foundation or not, MicroPython is far less difficult to get started with than other programming languages. Its code is easy to read, and the open source community has accumulated rich resources over the years. Just like Python, it has strong vitality and application value.

* [https://bpi-steam.com/Pico_RP2040_doc/en/Programming/MicroPython_Gettingstart.html BPI-Pico-RP2040 MicroPython Getting Started[BPI-STEAM]]

* [https://datasheets.raspberrypi.com/pico/raspberry-pi-pico-python-sdk.pdf Raspberry Pi Pico Python SDK]

==Arduino==

[[File:Arduino_logo_1200x350.png | 800px]]

Arduino is an open source embedded software and hardware development platform for users to create interactive embedded projects.

* [https://bpi-steam.com/Pico_RP2040_doc/en/Programming/Arduino_Gettingstart.html BPI-Pico-RP2040 Arduino Getting Started[BPI-STEAM]]

* [https://arduino-pico.readthedocs.io/en/latest/ RP2040 Arduino documentation]

= Reference Resources =

* [https://github.com/BPI-STEAM/BPI-Pico-RP2040-Doc/blob/main/BPI-Pico-RP2040-V0.2-SCH.pdf GitHub: BPI-Pico-RP2040 Schematic diagram of development board PDF]

* [https://datasheets.raspberrypi.com/rp2040/rp2040-datasheet.pdf rp2040-datasheet.pdf]

* [https://datasheets.raspberrypi.com/rp2040/rp2040-product-brief.pdf rp2040-product-brief.pdf]

=Easy to buy sample=
*BIPAI Aliexress shop:https://www.aliexpress.com/item/1005005083258994.html?
*SINOVOIP Aliexpress shop : https://www.aliexpress.us/item/3256804896912828.html?gatewayAdapt=glo2usa4itemAdapt&_randl_shipto=US
*Taobao Shop: https://item.taobao.com/item.htm?spm=a1z10.5-c-s.w4002-24708246124.11.774a3ce5S1Yvbl&id=695456693140
*OEM&ODM,please contact: judyhuang@banana-pi.com

Banana Pi BPI-M4 Berry

2023-11-23T10:14:12Z

Qubot: /* BPI-M4 Berry VS Raspberry Pi 4b */

[[zh:香蕉派_BPI-M4_Berry]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]

[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[Banana Pi BPI-M2 Berry]] A40i-H design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[Banana Pi BPI-M2S]] Amlogic A311D/S922 chip]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=Introduction=

BPI-M4 Berry development board stands as a powerful Single Board Computer (SBC), harnessing the capabilities of the Allwinner H618 System-on-Chip (SoC) to provide developers with impressive performance and a wealth of features. Similar to the Raspberry Pi 4b, the BPI-M4 Berry boasts comparable CPU prowess, 2G LPDDR4 memory and 8G eMMC, integrated WiFi and Bluetooth functionalities, and a familiar 40-pin header layout, alongside 4 USB interfaces and a GbE RJ45 port.

Characterized by its robust performance, versatile features, and remarkable image processing capabilities, stands as an exemplary SBC development platform for professionals within the embedded and computing industries. Equipped with 8GB eMMC flash storage, high-performance decoding and encoding capabilities, and an array of interface options, it caters to a wide spectrum of application domains, including media processing, IoT, and entertainment. Whether catering to novices or seasoned developers, the BPI-M4 Berry development board offers an ideal toolset for realizing creative visions and project objectives.

[[File:Banana_Pi_M4-Berry_banner_3.jpg]]

=Key Features=
* Allwinner H618, Quad-core ARM Cortex™-A53 processor
* ARM Mali G31 GPU
* WIFI & Bluetooth
* 2G LPDDR4 RAM
* 8G eMMC flash memory
* 1x USB2.0 Type-C OTG, 5V power supply
* 4x USB2.0 Type-A
* 1x HDMI 2.0a
* 1x 3.5mm Audio & TVE jack socket
* 1x GbE Ethernet port

=Getting Start=
*[[Getting Started with BPI-M4 Berry]]

=Hardware=
==Hardware interface==
[[File:BPI-M4 Berry interface.jpg]]

==Hardware spec==
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="2"| '''Hardware Specification of Banana pi BPI-M4 Berry'''
|-
| CPU || Allwinner H618, Quad-core ARM Cortex™-A53 processor, 64-bit, up to 1.5GHz
|-
| GPU ||ARM Mali G31 GPU
|-
| Memory || 2 GB LPDDR4
|-
| Storage || 8G eMMC flash
|-
| SD card || MicroSD card slot
|-
| Wireless || 2.4G/5G WiFi and Bluetooth 4.2
|-
| Ethernet || 1x GbE Ethernet port(supports PoE with add-on PoE HAT)
|-
| HDMI || 1x full-size HDMI 2.0a (up to 4K@60Hz with HDR10, CEC, DDC, SCDC), HDMI digital Audio output
|-
| Audio || 1x 3.5mm Audio & TVE jack socket
|-
| IR || 1x CIR
|-
| USB || 4x USB2.0 Type-A HOST, 1x USB2.0 Type-C OTG
|-
| rowspan="2" | 40-pin header
| 28 pins GPIO and Power (+5V, +3.3V and GND)
|-
| UART, SPI, TWI/I²C, PWM, PCM/I²S
|-
|Buttons|| Reset, FEL and User
|-
| LED || Power Status and Activity status
|-
| Power || 5V@3A via USB Type-C
|-
|Size || 85x56 mm
|-
|Weight || 60g
|}

==BPI-M4 Berry VS Raspberry Pi 4b ==
{| class="wikitable"
! module !! Raspberry Pi 4B !! Banana Pi BPI-M4 Berry
|-
| CPU || 1.5GHz Quad-Core BroadcomBCM2711(Cortex A72) || H618,64 Bit Cortex™-A53 Quad-Core
|-
| GPU || 500 MHz VideoCore Vl || ARM Mali G31 GPU
|-
| Memory || 1-4GB DDR4 || 2GB LPDDR4(up to 4G)
|-
| Onboard Storage || MicroSD (TF) card || MicroSD (TF) card / MMC card slot ,eMMC 8GB
|-
| Network || 10/100/1000 Ethernet || 10/100/1000 Ethernet
|-
| Onboard WIFI &BT || IEEE 802.11a/b/g/n/ac & BT5.0 || IEEE 802.11a/b/g/n/ac & BT4.2
|-
| Display || HDMI || HDMI
|-
| Camera || CSI || N/A
|-
| Video Outputs || 2*Micro-HDMI || HDMI 2.0a 4K@60fps
|-
| Audio Output || 3.5 mm Jack and HDM || 3.5 mm Jack and HDMI
|-
| Audio In || N/A || N/A
|-
| GPIO || 40-PIN: PWM,GPIO,UART,I²C bus,I²S bus,SPI bus,+3.3v,+5v,ground. CAN bus || 40-PIN: PWM,GPIO,UART,I²C bus,I²S bus,SPI bus,+3.3v,+5v,ground. CAN bus
|-
| Remote || N/A || IR reciever
|-
| USB Ports || 2*USB3.0+2USB2.0 || 2 * USB 2.0 1* USB Otg
|-
| Buttons || N/A || Reset button, User button, Uboot button
|-
| LED || Power led Status led || Power led Status led Wifi led
|-
| Power || DC 5V/3A || DC 5V/2A
|-
| Board Size || 88mmx58mm || 88mmx58mm
|}

==PIN define ==

===BPI-M4 Berry 40-pin header===
{| class="wikitable" style="text-align:center;"
|-
| style="background: PaleTurquoise; color: black" colspan="6"| '''40-pin header define and GPIO Alternative Functions Assignments'''
|-
! Pin Num
! Pin Name
! ALT0
! ALT1
! ALT2
! ALT3
|-
| 1
| 3.3V
|
|
|
|
|-
| 2
| 5V
|
|
|
|
|-
| 3
| PG16
| UART2_RX
|
|
| TWI4_SDA
|-
| 4
| 5V
|
|
|
|
|-
| 5
| PG15
| UART2_TX
|
|
| TWI4_SCK
|-
| 6
| GND
|
|
|
|
|-
| 7
| PG19
|
|
| PWM1
|
|-
| 8
| PG6
| UART1_TX
|
|
|
|-
| 9
| GND
|
|
|
|
|-
| 10
| PG7
| UART1_RX
|
|
|
|-
| 11
| PH2
| UART5_TX
|
| PWM2
|
|-
| 12
| PG11
| H_I2S2_BCLK
|
|
|
|-
| 13
| PH3
| UART5_RX
|
| PWM1
|
|-
| 14
| GND
|
|
|
|
|-
| 15
| PG2
|
|
|
|
|-
| 16
| PG8
| UART1_RTS
|
|
|
|-
| 17
| 3.3V
|
|
|
|
|-
| 18
| PG9
| UART1_CTS
|
|
|
|-
| 19
| PH7
| UART2_RTS
| H_I2S3_LRCK
| SPI1_MOSI
|
|-
| 20
| GND
|
|
|
|
|-
| 21
| PH8
| UART2_CTS
| H_I2S3_DOUT0
| SPI1_MISO
| H_I2S3_DIN1
|-
| 22
| PG1
|
|
|
|
|-
| 23
| PH6
| UART2_RX
| H_I2S3_BCLK
| SPI1_CLK
|
|-
| 24
| PH5
| UART2_TX
| H_I2S3_MCLK
| SPI1_CS0
|
|-
| 25
| GND
|
|
|
|
|-
| 26
| PH9
|
| H_I2S3_DIN0
| SPI1_CS1
| H_I2S3_DOUT1
|-
| 27
| PG18
| UART2_CTS
|
|
| TWI3_SDA
|-
| 28
| PG17
| UART2_RTS
|
|
| TWI3_SCK
|-
| 29
| PG3
|
|
|
|
|-
| 30
| GND
|
|
|
|
|-
| 31
| PG4
|
|
|
|
|-
| 32
| PG0
|
|
|
|
|-
| 33
| PG5
|
|
|
|
|-
| 34
| GND
|
|
|
|
|-
| 35
| PG12
| H_I2S2_LRCK
|
|
|
|-
| 36
| PH4
|
|
|
|
|-
| 37
| PG10
| H_I2S2_MCLK
|
|
|
|-
| 38
| PG14
| H_I2S2_DIN0
| H_I2S2_DOUT1
|
|
|-
| 39
| GND
|
|
|
|
|-
| 40
| PG13
| H_I2S2_DOUT0
| H_I2S2_DIN1
|
| style="text-align:left;" |
|}

===BPI-M4 Berry Debug UART===
{| class="wikitable"
|-
| 1 || GND
|-
| 2 || UART0_RX
|-
| 3 || UART0_TX
|-
|}

=Development=
==Source code==

*u-boot for H618 : https://github.com/BPI-SINOVOIP/pi-u-boot/tree/v2021.07-sunxi
*kernel for H618 : https://github.com/BPI-SINOVOIP/pi-linux/tree/pi-6.1-sunxi

== Resources==
*BPI-M4 Berry Allwinner H618 SBC burn Ubuntu desktop image:https://www.youtube.com/watch?v=GAZsUDYL0DE
*BPI-M4 Berry DXF file
:Baidu Cloud: https://pan.baidu.com/s/1qS-_3d3IpoMBWJe8aI8JFA?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/13wsY0cMZGfz5MdTqlo19DtmlZfdOGLI4/view?usp=sharing

*BPI-M4 Berry SBC bench test: http://forum.banana-pi.org/t/bpi-m4-sbc-bench-test/9469

*Allwinner H618 Datasheet
:Baidu Cloud: https://pan.baidu.com/s/10Rk4xLMOhIkk-gIoQx9DQw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/1N6oWF9PHTcxXC1JY4x3Malr3twFv2wWZ/view?usp=sharing

=System image=

==Linux==
===Ubuntu===
*2023-11-09 Bpi-m4berry_0.0.1_beta_ubuntu_jammy_minimal_linux6.1.31
:Baidu Cloud: https://pan.baidu.com/s/1Mh8E6Zh-x8dAPkb00iX9Rw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/159Y7p8j067snqTG4oaUA2CP4aY4t6uyt/view?usp=sharing

*2023-11-09 Bpi-m4berry_0.0.1_beta_ubuntu_jammy_desktop_xfce_linux6.1.31
:Baidu Cloud: https://pan.baidu.com/s/1_sN137hKZt4DaawVsfO5Nw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/10wXnsgGtLWwf9J-dvLHW2mxsPKOrdHmJ/view?usp=sharing

=Easy to buy=
*Aliexpress shop:
:SINOVOIP Aliexpress shop: https://www.aliexpress.us/item/1005006212355480.html?spm
:Bipai Aliexpress shop: https://www.aliexpress.us/item/1005006212128000.html?gatewayAdapt=glo2usa
:Taobao Shop: https://item.taobao.com/item.htm?spm=a1z10.5-c-s.w4002-25059194413.11.489155c8Addsck&id=747425760994
:OEM&ODM, please contact: judyhuang@banana-pi.com

Banana Pi BPI-M4 Berry

2023-11-23T08:48:16Z

Qubot: /* BPI-M4 Berry VS Raspberry Pi 4b */

[[zh:香蕉派_BPI-M4_Berry]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]

[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[Banana Pi BPI-M2 Berry]] A40i-H design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[Banana Pi BPI-M2S]] Amlogic A311D/S922 chip]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=Introduction=

BPI-M4 Berry development board stands as a powerful Single Board Computer (SBC), harnessing the capabilities of the Allwinner H618 System-on-Chip (SoC) to provide developers with impressive performance and a wealth of features. Similar to the Raspberry Pi 4b, the BPI-M4 Berry boasts comparable CPU prowess, 2G LPDDR4 memory and 8G eMMC, integrated WiFi and Bluetooth functionalities, and a familiar 40-pin header layout, alongside 4 USB interfaces and a GbE RJ45 port.

Characterized by its robust performance, versatile features, and remarkable image processing capabilities, stands as an exemplary SBC development platform for professionals within the embedded and computing industries. Equipped with 8GB eMMC flash storage, high-performance decoding and encoding capabilities, and an array of interface options, it caters to a wide spectrum of application domains, including media processing, IoT, and entertainment. Whether catering to novices or seasoned developers, the BPI-M4 Berry development board offers an ideal toolset for realizing creative visions and project objectives.

[[File:Banana_Pi_M4-Berry_banner_3.jpg]]

=Key Features=
* Allwinner H618, Quad-core ARM Cortex™-A53 processor
* ARM Mali G31 GPU
* WIFI & Bluetooth
* 2G LPDDR4 RAM
* 8G eMMC flash memory
* 1x USB2.0 Type-C OTG, 5V power supply
* 4x USB2.0 Type-A
* 1x HDMI 2.0a
* 1x 3.5mm Audio & TVE jack socket
* 1x GbE Ethernet port

=Getting Start=
*[[Getting Started with BPI-M4 Berry]]

=Hardware=
==Hardware interface==
[[File:BPI-M4 Berry interface.jpg]]

==Hardware spec==
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="2"| '''Hardware Specification of Banana pi BPI-M4 Berry'''
|-
| CPU || Allwinner H618, Quad-core ARM Cortex™-A53 processor, 64-bit, up to 1.5GHz
|-
| GPU ||ARM Mali G31 GPU
|-
| Memory || 2 GB LPDDR4
|-
| Storage || 8G eMMC flash
|-
| SD card || MicroSD card slot
|-
| Wireless || 2.4G/5G WiFi and Bluetooth 4.2
|-
| Ethernet || 1x GbE Ethernet port(supports PoE with add-on PoE HAT)
|-
| HDMI || 1x full-size HDMI 2.0a (up to 4K@60Hz with HDR10, CEC, DDC, SCDC), HDMI digital Audio output
|-
| Audio || 1x 3.5mm Audio & TVE jack socket
|-
| IR || 1x CIR
|-
| USB || 4x USB2.0 Type-A HOST, 1x USB2.0 Type-C OTG
|-
| rowspan="2" | 40-pin header
| 28 pins GPIO and Power (+5V, +3.3V and GND)
|-
| UART, SPI, TWI/I²C, PWM, PCM/I²S
|-
|Buttons|| Reset, FEL and User
|-
| LED || Power Status and Activity status
|-
| Power || 5V@3A via USB Type-C
|-
|Size || 85x56 mm
|-
|Weight || 60g
|}

==BPI-M4 Berry VS Raspberry Pi 4b ==
{| class="wikitable"
! module !! Raspberry Pi 4B !! Banana Pi BPI-M4 Berry
|-
| CPU || 1.5GHz Quad-Core BroadcomBCM2711(Cortex A72) || H618,64 Bit Cortex™-A53 Quad-Core
|-
| GPU || 500 MHz VideoCore Vl || ARM Mali G31 GPU
|-
| Memory || 1-4GB DDR4 || 2GB LPDDR4(up to 4G)
|-
| Onboard Storage || MicroSD (TF) card || MicroSD (TF) card / MMC card slot ,eMMC 8GB
|-
| Network || 10/100/1000 Ethernet || 10/100/1000 Ethernet
|-
| Onboard WIFI &BT || IEEE 802.11a/b/g/n/ac & BT5.0 || IEEE 802.11a/b/g/n/ac & BT4.2
|-
| Display || HDMI || HDMI
|-
| Camera || N/A || N/A
|-
| Video Outputs || 2*Micro-HDMI || HDMI 2.0a 4K@60fps
|-
| Audio Output || 3.5 mm Jack and HDM || 3.5 mm Jack and HDMI
|-
| Audio In || N/A || N/A
|-
| GPIO || 40-PIN: PWM,GPIO,UART,I²C bus,I²S bus,SPI bus,+3.3v,+5v,ground. CAN bus || 40-PIN: PWM,GPIO,UART,I²C bus,I²S bus,SPI bus,+3.3v,+5v,ground. CAN bus
|-
| Remote || N/A || IR reciever
|-
| USB Ports || 2*USB3.0+2USB2.0 || 2 * USB 2.0 1* USB Otg
|-
| Buttons || N/A || Reset button, User button, Uboot button
|-
| LED || Power led Status led || Power led Status led Wifi led
|-
| Power || DC 5V/3A || DC 5V/2A
|-
| Board Size || 88mmx58mm || 88mmx58mm
|}

==PIN define ==

===BPI-M4 Berry 40-pin header===
{| class="wikitable" style="text-align:center;"
|-
| style="background: PaleTurquoise; color: black" colspan="6"| '''40-pin header define and GPIO Alternative Functions Assignments'''
|-
! Pin Num
! Pin Name
! ALT0
! ALT1
! ALT2
! ALT3
|-
| 1
| 3.3V
|
|
|
|
|-
| 2
| 5V
|
|
|
|
|-
| 3
| PG16
| UART2_RX
|
|
| TWI4_SDA
|-
| 4
| 5V
|
|
|
|
|-
| 5
| PG15
| UART2_TX
|
|
| TWI4_SCK
|-
| 6
| GND
|
|
|
|
|-
| 7
| PG19
|
|
| PWM1
|
|-
| 8
| PG6
| UART1_TX
|
|
|
|-
| 9
| GND
|
|
|
|
|-
| 10
| PG7
| UART1_RX
|
|
|
|-
| 11
| PH2
| UART5_TX
|
| PWM2
|
|-
| 12
| PG11
| H_I2S2_BCLK
|
|
|
|-
| 13
| PH3
| UART5_RX
|
| PWM1
|
|-
| 14
| GND
|
|
|
|
|-
| 15
| PG2
|
|
|
|
|-
| 16
| PG8
| UART1_RTS
|
|
|
|-
| 17
| 3.3V
|
|
|
|
|-
| 18
| PG9
| UART1_CTS
|
|
|
|-
| 19
| PH7
| UART2_RTS
| H_I2S3_LRCK
| SPI1_MOSI
|
|-
| 20
| GND
|
|
|
|
|-
| 21
| PH8
| UART2_CTS
| H_I2S3_DOUT0
| SPI1_MISO
| H_I2S3_DIN1
|-
| 22
| PG1
|
|
|
|
|-
| 23
| PH6
| UART2_RX
| H_I2S3_BCLK
| SPI1_CLK
|
|-
| 24
| PH5
| UART2_TX
| H_I2S3_MCLK
| SPI1_CS0
|
|-
| 25
| GND
|
|
|
|
|-
| 26
| PH9
|
| H_I2S3_DIN0
| SPI1_CS1
| H_I2S3_DOUT1
|-
| 27
| PG18
| UART2_CTS
|
|
| TWI3_SDA
|-
| 28
| PG17
| UART2_RTS
|
|
| TWI3_SCK
|-
| 29
| PG3
|
|
|
|
|-
| 30
| GND
|
|
|
|
|-
| 31
| PG4
|
|
|
|
|-
| 32
| PG0
|
|
|
|
|-
| 33
| PG5
|
|
|
|
|-
| 34
| GND
|
|
|
|
|-
| 35
| PG12
| H_I2S2_LRCK
|
|
|
|-
| 36
| PH4
|
|
|
|
|-
| 37
| PG10
| H_I2S2_MCLK
|
|
|
|-
| 38
| PG14
| H_I2S2_DIN0
| H_I2S2_DOUT1
|
|
|-
| 39
| GND
|
|
|
|
|-
| 40
| PG13
| H_I2S2_DOUT0
| H_I2S2_DIN1
|
| style="text-align:left;" |
|}

===BPI-M4 Berry Debug UART===
{| class="wikitable"
|-
| 1 || GND
|-
| 2 || UART0_RX
|-
| 3 || UART0_TX
|-
|}

=Development=
==Source code==

*u-boot for H618 : https://github.com/BPI-SINOVOIP/pi-u-boot/tree/v2021.07-sunxi
*kernel for H618 : https://github.com/BPI-SINOVOIP/pi-linux/tree/pi-6.1-sunxi

== Resources==
*BPI-M4 Berry Allwinner H618 SBC burn Ubuntu desktop image:https://www.youtube.com/watch?v=GAZsUDYL0DE
*BPI-M4 Berry DXF file
:Baidu Cloud: https://pan.baidu.com/s/1qS-_3d3IpoMBWJe8aI8JFA?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/13wsY0cMZGfz5MdTqlo19DtmlZfdOGLI4/view?usp=sharing

*BPI-M4 Berry SBC bench test: http://forum.banana-pi.org/t/bpi-m4-sbc-bench-test/9469

*Allwinner H618 Datasheet
:Baidu Cloud: https://pan.baidu.com/s/10Rk4xLMOhIkk-gIoQx9DQw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/1N6oWF9PHTcxXC1JY4x3Malr3twFv2wWZ/view?usp=sharing

=System image=

==Linux==
===Ubuntu===
*2023-11-09 Bpi-m4berry_0.0.1_beta_ubuntu_jammy_minimal_linux6.1.31
:Baidu Cloud: https://pan.baidu.com/s/1Mh8E6Zh-x8dAPkb00iX9Rw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/159Y7p8j067snqTG4oaUA2CP4aY4t6uyt/view?usp=sharing

*2023-11-09 Bpi-m4berry_0.0.1_beta_ubuntu_jammy_desktop_xfce_linux6.1.31
:Baidu Cloud: https://pan.baidu.com/s/1_sN137hKZt4DaawVsfO5Nw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/10wXnsgGtLWwf9J-dvLHW2mxsPKOrdHmJ/view?usp=sharing

=Easy to buy=
*Aliexpress shop:
:SINOVOIP Aliexpress shop: https://www.aliexpress.us/item/1005006212355480.html?spm
:Bipai Aliexpress shop: https://www.aliexpress.us/item/1005006212128000.html?gatewayAdapt=glo2usa
:Taobao Shop: https://item.taobao.com/item.htm?spm=a1z10.5-c-s.w4002-25059194413.11.489155c8Addsck&id=747425760994
:OEM&ODM, please contact: judyhuang@banana-pi.com

Banana Pi BPI-M4 Berry

2023-11-23T08:47:56Z

Qubot: /* BPI-M4 Berry VS Raspberry Pi 4b */

[[zh:香蕉派_BPI-M4_Berry]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]

[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[Banana Pi BPI-M2 Berry]] A40i-H design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[Banana Pi BPI-M2S]] Amlogic A311D/S922 chip]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=Introduction=

BPI-M4 Berry development board stands as a powerful Single Board Computer (SBC), harnessing the capabilities of the Allwinner H618 System-on-Chip (SoC) to provide developers with impressive performance and a wealth of features. Similar to the Raspberry Pi 4b, the BPI-M4 Berry boasts comparable CPU prowess, 2G LPDDR4 memory and 8G eMMC, integrated WiFi and Bluetooth functionalities, and a familiar 40-pin header layout, alongside 4 USB interfaces and a GbE RJ45 port.

Characterized by its robust performance, versatile features, and remarkable image processing capabilities, stands as an exemplary SBC development platform for professionals within the embedded and computing industries. Equipped with 8GB eMMC flash storage, high-performance decoding and encoding capabilities, and an array of interface options, it caters to a wide spectrum of application domains, including media processing, IoT, and entertainment. Whether catering to novices or seasoned developers, the BPI-M4 Berry development board offers an ideal toolset for realizing creative visions and project objectives.

[[File:Banana_Pi_M4-Berry_banner_3.jpg]]

=Key Features=
* Allwinner H618, Quad-core ARM Cortex™-A53 processor
* ARM Mali G31 GPU
* WIFI & Bluetooth
* 2G LPDDR4 RAM
* 8G eMMC flash memory
* 1x USB2.0 Type-C OTG, 5V power supply
* 4x USB2.0 Type-A
* 1x HDMI 2.0a
* 1x 3.5mm Audio & TVE jack socket
* 1x GbE Ethernet port

=Getting Start=
*[[Getting Started with BPI-M4 Berry]]

=Hardware=
==Hardware interface==
[[File:BPI-M4 Berry interface.jpg]]

==Hardware spec==
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="2"| '''Hardware Specification of Banana pi BPI-M4 Berry'''
|-
| CPU || Allwinner H618, Quad-core ARM Cortex™-A53 processor, 64-bit, up to 1.5GHz
|-
| GPU ||ARM Mali G31 GPU
|-
| Memory || 2 GB LPDDR4
|-
| Storage || 8G eMMC flash
|-
| SD card || MicroSD card slot
|-
| Wireless || 2.4G/5G WiFi and Bluetooth 4.2
|-
| Ethernet || 1x GbE Ethernet port(supports PoE with add-on PoE HAT)
|-
| HDMI || 1x full-size HDMI 2.0a (up to 4K@60Hz with HDR10, CEC, DDC, SCDC), HDMI digital Audio output
|-
| Audio || 1x 3.5mm Audio & TVE jack socket
|-
| IR || 1x CIR
|-
| USB || 4x USB2.0 Type-A HOST, 1x USB2.0 Type-C OTG
|-
| rowspan="2" | 40-pin header
| 28 pins GPIO and Power (+5V, +3.3V and GND)
|-
| UART, SPI, TWI/I²C, PWM, PCM/I²S
|-
|Buttons|| Reset, FEL and User
|-
| LED || Power Status and Activity status
|-
| Power || 5V@3A via USB Type-C
|-
|Size || 85x56 mm
|-
|Weight || 60g
|}

==BPI-M4 Berry VS Raspberry Pi 4b ==
{| class="wikitable"
! module !! Raspberry Pi 4B !! Banana Pi BPI-M4 Berry
|-
| CPU || 1.5GHz Quad-Core BroadcomBCM2711(Cortex A72) || H618,64 Bit Cortex™-A53 Quad-Core
|-
| GPU || 500 MHz VideoCore Vl || ARM Mali G31 GPU
|-
| Memory $SDRAM$ || 1-4GB DDR4 || 2GB LPDDR4(up to 4G)
|-
| Onboard Storage || MicroSD (TF) card || MicroSD (TF) card / MMC card slot ,eMMC 8GB
|-
| Network || 10/100/1000 Ethernet || 10/100/1000 Ethernet
|-
| Onboard WIFI &BT || IEEE 802.11a/b/g/n/ac & BT5.0 || IEEE 802.11a/b/g/n/ac & BT4.2
|-
| Display || HDMI || HDMI
|-
| Camera || N/A || N/A
|-
| Video Outputs || 2*Micro-HDMI || HDMI 2.0a 4K@60fps
|-
| Audio Output || 3.5 mm Jack and HDM || 3.5 mm Jack and HDMI
|-
| Audio In || N/A || N/A
|-
| GPIO || 40-PIN: PWM,GPIO,UART,I²C bus,I²S bus,SPI bus,+3.3v,+5v,ground. CAN bus || 40-PIN: PWM,GPIO,UART,I²C bus,I²S bus,SPI bus,+3.3v,+5v,ground. CAN bus
|-
| Remote || N/A || IR reciever
|-
| USB Ports || 2*USB3.0+2USB2.0 || 2 * USB 2.0 1* USB Otg
|-
| Buttons || N/A || Reset button, User button, Uboot button
|-
| LED || Power led Status led || Power led Status led Wifi led
|-
| Power || DC 5V/3A || DC 5V/2A
|-
| Board Size || 88mmx58mm || 88mmx58mm
|}

==PIN define ==

===BPI-M4 Berry 40-pin header===
{| class="wikitable" style="text-align:center;"
|-
| style="background: PaleTurquoise; color: black" colspan="6"| '''40-pin header define and GPIO Alternative Functions Assignments'''
|-
! Pin Num
! Pin Name
! ALT0
! ALT1
! ALT2
! ALT3
|-
| 1
| 3.3V
|
|
|
|
|-
| 2
| 5V
|
|
|
|
|-
| 3
| PG16
| UART2_RX
|
|
| TWI4_SDA
|-
| 4
| 5V
|
|
|
|
|-
| 5
| PG15
| UART2_TX
|
|
| TWI4_SCK
|-
| 6
| GND
|
|
|
|
|-
| 7
| PG19
|
|
| PWM1
|
|-
| 8
| PG6
| UART1_TX
|
|
|
|-
| 9
| GND
|
|
|
|
|-
| 10
| PG7
| UART1_RX
|
|
|
|-
| 11
| PH2
| UART5_TX
|
| PWM2
|
|-
| 12
| PG11
| H_I2S2_BCLK
|
|
|
|-
| 13
| PH3
| UART5_RX
|
| PWM1
|
|-
| 14
| GND
|
|
|
|
|-
| 15
| PG2
|
|
|
|
|-
| 16
| PG8
| UART1_RTS
|
|
|
|-
| 17
| 3.3V
|
|
|
|
|-
| 18
| PG9
| UART1_CTS
|
|
|
|-
| 19
| PH7
| UART2_RTS
| H_I2S3_LRCK
| SPI1_MOSI
|
|-
| 20
| GND
|
|
|
|
|-
| 21
| PH8
| UART2_CTS
| H_I2S3_DOUT0
| SPI1_MISO
| H_I2S3_DIN1
|-
| 22
| PG1
|
|
|
|
|-
| 23
| PH6
| UART2_RX
| H_I2S3_BCLK
| SPI1_CLK
|
|-
| 24
| PH5
| UART2_TX
| H_I2S3_MCLK
| SPI1_CS0
|
|-
| 25
| GND
|
|
|
|
|-
| 26
| PH9
|
| H_I2S3_DIN0
| SPI1_CS1
| H_I2S3_DOUT1
|-
| 27
| PG18
| UART2_CTS
|
|
| TWI3_SDA
|-
| 28
| PG17
| UART2_RTS
|
|
| TWI3_SCK
|-
| 29
| PG3
|
|
|
|
|-
| 30
| GND
|
|
|
|
|-
| 31
| PG4
|
|
|
|
|-
| 32
| PG0
|
|
|
|
|-
| 33
| PG5
|
|
|
|
|-
| 34
| GND
|
|
|
|
|-
| 35
| PG12
| H_I2S2_LRCK
|
|
|
|-
| 36
| PH4
|
|
|
|
|-
| 37
| PG10
| H_I2S2_MCLK
|
|
|
|-
| 38
| PG14
| H_I2S2_DIN0
| H_I2S2_DOUT1
|
|
|-
| 39
| GND
|
|
|
|
|-
| 40
| PG13
| H_I2S2_DOUT0
| H_I2S2_DIN1
|
| style="text-align:left;" |
|}

===BPI-M4 Berry Debug UART===
{| class="wikitable"
|-
| 1 || GND
|-
| 2 || UART0_RX
|-
| 3 || UART0_TX
|-
|}

=Development=
==Source code==

*u-boot for H618 : https://github.com/BPI-SINOVOIP/pi-u-boot/tree/v2021.07-sunxi
*kernel for H618 : https://github.com/BPI-SINOVOIP/pi-linux/tree/pi-6.1-sunxi

== Resources==
*BPI-M4 Berry Allwinner H618 SBC burn Ubuntu desktop image:https://www.youtube.com/watch?v=GAZsUDYL0DE
*BPI-M4 Berry DXF file
:Baidu Cloud: https://pan.baidu.com/s/1qS-_3d3IpoMBWJe8aI8JFA?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/13wsY0cMZGfz5MdTqlo19DtmlZfdOGLI4/view?usp=sharing

*BPI-M4 Berry SBC bench test: http://forum.banana-pi.org/t/bpi-m4-sbc-bench-test/9469

*Allwinner H618 Datasheet
:Baidu Cloud: https://pan.baidu.com/s/10Rk4xLMOhIkk-gIoQx9DQw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/1N6oWF9PHTcxXC1JY4x3Malr3twFv2wWZ/view?usp=sharing

=System image=

==Linux==
===Ubuntu===
*2023-11-09 Bpi-m4berry_0.0.1_beta_ubuntu_jammy_minimal_linux6.1.31
:Baidu Cloud: https://pan.baidu.com/s/1Mh8E6Zh-x8dAPkb00iX9Rw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/159Y7p8j067snqTG4oaUA2CP4aY4t6uyt/view?usp=sharing

*2023-11-09 Bpi-m4berry_0.0.1_beta_ubuntu_jammy_desktop_xfce_linux6.1.31
:Baidu Cloud: https://pan.baidu.com/s/1_sN137hKZt4DaawVsfO5Nw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/10wXnsgGtLWwf9J-dvLHW2mxsPKOrdHmJ/view?usp=sharing

=Easy to buy=
*Aliexpress shop:
:SINOVOIP Aliexpress shop: https://www.aliexpress.us/item/1005006212355480.html?spm
:Bipai Aliexpress shop: https://www.aliexpress.us/item/1005006212128000.html?gatewayAdapt=glo2usa
:Taobao Shop: https://item.taobao.com/item.htm?spm=a1z10.5-c-s.w4002-25059194413.11.489155c8Addsck&id=747425760994
:OEM&ODM, please contact: judyhuang@banana-pi.com

Banana Pi BPI-M4 Berry

2023-11-23T08:44:50Z

Qubot: /* BPI-M4 Berry VS Raspberry Pi 4b */

[[zh:香蕉派_BPI-M4_Berry]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]

[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[Banana Pi BPI-M2 Berry]] A40i-H design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[Banana Pi BPI-M2S]] Amlogic A311D/S922 chip]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=Introduction=

BPI-M4 Berry development board stands as a powerful Single Board Computer (SBC), harnessing the capabilities of the Allwinner H618 System-on-Chip (SoC) to provide developers with impressive performance and a wealth of features. Similar to the Raspberry Pi 4b, the BPI-M4 Berry boasts comparable CPU prowess, 2G LPDDR4 memory and 8G eMMC, integrated WiFi and Bluetooth functionalities, and a familiar 40-pin header layout, alongside 4 USB interfaces and a GbE RJ45 port.

Characterized by its robust performance, versatile features, and remarkable image processing capabilities, stands as an exemplary SBC development platform for professionals within the embedded and computing industries. Equipped with 8GB eMMC flash storage, high-performance decoding and encoding capabilities, and an array of interface options, it caters to a wide spectrum of application domains, including media processing, IoT, and entertainment. Whether catering to novices or seasoned developers, the BPI-M4 Berry development board offers an ideal toolset for realizing creative visions and project objectives.

[[File:Banana_Pi_M4-Berry_banner_3.jpg]]

=Key Features=
* Allwinner H618, Quad-core ARM Cortex™-A53 processor
* ARM Mali G31 GPU
* WIFI & Bluetooth
* 2G LPDDR4 RAM
* 8G eMMC flash memory
* 1x USB2.0 Type-C OTG, 5V power supply
* 4x USB2.0 Type-A
* 1x HDMI 2.0a
* 1x 3.5mm Audio & TVE jack socket
* 1x GbE Ethernet port

=Getting Start=
*[[Getting Started with BPI-M4 Berry]]

=Hardware=
==Hardware interface==
[[File:BPI-M4 Berry interface.jpg]]

==Hardware spec==
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="2"| '''Hardware Specification of Banana pi BPI-M4 Berry'''
|-
| CPU || Allwinner H618, Quad-core ARM Cortex™-A53 processor, 64-bit, up to 1.5GHz
|-
| GPU ||ARM Mali G31 GPU
|-
| Memory || 2 GB LPDDR4
|-
| Storage || 8G eMMC flash
|-
| SD card || MicroSD card slot
|-
| Wireless || 2.4G/5G WiFi and Bluetooth 4.2
|-
| Ethernet || 1x GbE Ethernet port(supports PoE with add-on PoE HAT)
|-
| HDMI || 1x full-size HDMI 2.0a (up to 4K@60Hz with HDR10, CEC, DDC, SCDC), HDMI digital Audio output
|-
| Audio || 1x 3.5mm Audio & TVE jack socket
|-
| IR || 1x CIR
|-
| USB || 4x USB2.0 Type-A HOST, 1x USB2.0 Type-C OTG
|-
| rowspan="2" | 40-pin header
| 28 pins GPIO and Power (+5V, +3.3V and GND)
|-
| UART, SPI, TWI/I²C, PWM, PCM/I²S
|-
|Buttons|| Reset, FEL and User
|-
| LED || Power Status and Activity status
|-
| Power || 5V@3A via USB Type-C
|-
|Size || 85x56 mm
|-
|Weight || 60g
|}

==BPI-M4 Berry VS Raspberry Pi 4b ==
{| class="wikitable"
! module !! Raspberry Pi 4B !! Banana Pi BPI-M4 Berry
|-
| CPU || 1.5GHz 4核 BroadcomBCM2711(Cortex A72) || H618,64 Bit Cortex™-A53 Quad-Core
|-
| GPU || 500 MHz VideoCore Vl || ARM Mali G31 GPU
|-
| Memory $SDRAM$ || 1-4GB DDR4 || 2GB LPDDR4(up to 4G)
|-
| Onboard Storage || MicroSD (TF) card || MicroSD (TF) card / MMC card slot ,eMMC 8GB
|-
| Network || 10/100/1000 Ethernet || 10/100/1000 Ethernet
|-
| Onboard WIFI &BT || IEEE 802.11a/b/g/n/ac & BT5.0 || IEEE 802.11a/b/g/n/ac & BT4.2
|-
| Display || HDMI || HDMI
|-
| Camera || N/A || N/A
|-
| Video Outputs || 2*Micro-HDMI || HDMI 2.0a 4K@60fps
|-
| Audio Output || 3.5 mm Jack and HDM || 3.5 mm Jack and HDMI
|-
| Audio In || N/A || N/A
|-
| GPIO || 40-PIN: PWM,GPIO,UART,I²C bus,I²S bus,SPI bus,+3.3v,+5v,ground. CAN bus || 40-PIN: PWM,GPIO,UART,I²C bus,I²S bus,SPI bus,+3.3v,+5v,ground. CAN bus
|-
| Remote || N/A || IR reciever
|-
| USB Ports || 2*USB3.0+2USB2.0 || 2 * USB 2.0 1* USB Otg
|-
| Buttons || N/A || Reset button, User button, Uboot button
|-
| LED || Power led Status led || Power led Status led Wifi led
|-
| Power || DC 5V/3A || DC 5V/2A
|-
| Board Size || 88mmx58mm || 88mmx58mm
|}

==PIN define ==

===BPI-M4 Berry 40-pin header===
{| class="wikitable" style="text-align:center;"
|-
| style="background: PaleTurquoise; color: black" colspan="6"| '''40-pin header define and GPIO Alternative Functions Assignments'''
|-
! Pin Num
! Pin Name
! ALT0
! ALT1
! ALT2
! ALT3
|-
| 1
| 3.3V
|
|
|
|
|-
| 2
| 5V
|
|
|
|
|-
| 3
| PG16
| UART2_RX
|
|
| TWI4_SDA
|-
| 4
| 5V
|
|
|
|
|-
| 5
| PG15
| UART2_TX
|
|
| TWI4_SCK
|-
| 6
| GND
|
|
|
|
|-
| 7
| PG19
|
|
| PWM1
|
|-
| 8
| PG6
| UART1_TX
|
|
|
|-
| 9
| GND
|
|
|
|
|-
| 10
| PG7
| UART1_RX
|
|
|
|-
| 11
| PH2
| UART5_TX
|
| PWM2
|
|-
| 12
| PG11
| H_I2S2_BCLK
|
|
|
|-
| 13
| PH3
| UART5_RX
|
| PWM1
|
|-
| 14
| GND
|
|
|
|
|-
| 15
| PG2
|
|
|
|
|-
| 16
| PG8
| UART1_RTS
|
|
|
|-
| 17
| 3.3V
|
|
|
|
|-
| 18
| PG9
| UART1_CTS
|
|
|
|-
| 19
| PH7
| UART2_RTS
| H_I2S3_LRCK
| SPI1_MOSI
|
|-
| 20
| GND
|
|
|
|
|-
| 21
| PH8
| UART2_CTS
| H_I2S3_DOUT0
| SPI1_MISO
| H_I2S3_DIN1
|-
| 22
| PG1
|
|
|
|
|-
| 23
| PH6
| UART2_RX
| H_I2S3_BCLK
| SPI1_CLK
|
|-
| 24
| PH5
| UART2_TX
| H_I2S3_MCLK
| SPI1_CS0
|
|-
| 25
| GND
|
|
|
|
|-
| 26
| PH9
|
| H_I2S3_DIN0
| SPI1_CS1
| H_I2S3_DOUT1
|-
| 27
| PG18
| UART2_CTS
|
|
| TWI3_SDA
|-
| 28
| PG17
| UART2_RTS
|
|
| TWI3_SCK
|-
| 29
| PG3
|
|
|
|
|-
| 30
| GND
|
|
|
|
|-
| 31
| PG4
|
|
|
|
|-
| 32
| PG0
|
|
|
|
|-
| 33
| PG5
|
|
|
|
|-
| 34
| GND
|
|
|
|
|-
| 35
| PG12
| H_I2S2_LRCK
|
|
|
|-
| 36
| PH4
|
|
|
|
|-
| 37
| PG10
| H_I2S2_MCLK
|
|
|
|-
| 38
| PG14
| H_I2S2_DIN0
| H_I2S2_DOUT1
|
|
|-
| 39
| GND
|
|
|
|
|-
| 40
| PG13
| H_I2S2_DOUT0
| H_I2S2_DIN1
|
| style="text-align:left;" |
|}

===BPI-M4 Berry Debug UART===
{| class="wikitable"
|-
| 1 || GND
|-
| 2 || UART0_RX
|-
| 3 || UART0_TX
|-
|}

=Development=
==Source code==

*u-boot for H618 : https://github.com/BPI-SINOVOIP/pi-u-boot/tree/v2021.07-sunxi
*kernel for H618 : https://github.com/BPI-SINOVOIP/pi-linux/tree/pi-6.1-sunxi

== Resources==
*BPI-M4 Berry Allwinner H618 SBC burn Ubuntu desktop image:https://www.youtube.com/watch?v=GAZsUDYL0DE
*BPI-M4 Berry DXF file
:Baidu Cloud: https://pan.baidu.com/s/1qS-_3d3IpoMBWJe8aI8JFA?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/13wsY0cMZGfz5MdTqlo19DtmlZfdOGLI4/view?usp=sharing

*BPI-M4 Berry SBC bench test: http://forum.banana-pi.org/t/bpi-m4-sbc-bench-test/9469

*Allwinner H618 Datasheet
:Baidu Cloud: https://pan.baidu.com/s/10Rk4xLMOhIkk-gIoQx9DQw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/1N6oWF9PHTcxXC1JY4x3Malr3twFv2wWZ/view?usp=sharing

=System image=

==Linux==
===Ubuntu===
*2023-11-09 Bpi-m4berry_0.0.1_beta_ubuntu_jammy_minimal_linux6.1.31
:Baidu Cloud: https://pan.baidu.com/s/1Mh8E6Zh-x8dAPkb00iX9Rw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/159Y7p8j067snqTG4oaUA2CP4aY4t6uyt/view?usp=sharing

*2023-11-09 Bpi-m4berry_0.0.1_beta_ubuntu_jammy_desktop_xfce_linux6.1.31
:Baidu Cloud: https://pan.baidu.com/s/1_sN137hKZt4DaawVsfO5Nw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/10wXnsgGtLWwf9J-dvLHW2mxsPKOrdHmJ/view?usp=sharing

=Easy to buy=
*Aliexpress shop:
:SINOVOIP Aliexpress shop: https://www.aliexpress.us/item/1005006212355480.html?spm
:Bipai Aliexpress shop: https://www.aliexpress.us/item/1005006212128000.html?gatewayAdapt=glo2usa
:Taobao Shop: https://item.taobao.com/item.htm?spm=a1z10.5-c-s.w4002-25059194413.11.489155c8Addsck&id=747425760994
:OEM&ODM, please contact: judyhuang@banana-pi.com

Banana Pi BPI-M4 Berry

2023-11-23T08:44:40Z

Qubot: /* BPI-M4 Berry VS Raspberry Pi 4b */

[[zh:香蕉派_BPI-M4_Berry]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]

[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[Banana Pi BPI-M2 Berry]] A40i-H design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[Banana Pi BPI-M2S]] Amlogic A311D/S922 chip]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=Introduction=

BPI-M4 Berry development board stands as a powerful Single Board Computer (SBC), harnessing the capabilities of the Allwinner H618 System-on-Chip (SoC) to provide developers with impressive performance and a wealth of features. Similar to the Raspberry Pi 4b, the BPI-M4 Berry boasts comparable CPU prowess, 2G LPDDR4 memory and 8G eMMC, integrated WiFi and Bluetooth functionalities, and a familiar 40-pin header layout, alongside 4 USB interfaces and a GbE RJ45 port.

Characterized by its robust performance, versatile features, and remarkable image processing capabilities, stands as an exemplary SBC development platform for professionals within the embedded and computing industries. Equipped with 8GB eMMC flash storage, high-performance decoding and encoding capabilities, and an array of interface options, it caters to a wide spectrum of application domains, including media processing, IoT, and entertainment. Whether catering to novices or seasoned developers, the BPI-M4 Berry development board offers an ideal toolset for realizing creative visions and project objectives.

[[File:Banana_Pi_M4-Berry_banner_3.jpg]]

=Key Features=
* Allwinner H618, Quad-core ARM Cortex™-A53 processor
* ARM Mali G31 GPU
* WIFI & Bluetooth
* 2G LPDDR4 RAM
* 8G eMMC flash memory
* 1x USB2.0 Type-C OTG, 5V power supply
* 4x USB2.0 Type-A
* 1x HDMI 2.0a
* 1x 3.5mm Audio & TVE jack socket
* 1x GbE Ethernet port

=Getting Start=
*[[Getting Started with BPI-M4 Berry]]

=Hardware=
==Hardware interface==
[[File:BPI-M4 Berry interface.jpg]]

==Hardware spec==
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="2"| '''Hardware Specification of Banana pi BPI-M4 Berry'''
|-
| CPU || Allwinner H618, Quad-core ARM Cortex™-A53 processor, 64-bit, up to 1.5GHz
|-
| GPU ||ARM Mali G31 GPU
|-
| Memory || 2 GB LPDDR4
|-
| Storage || 8G eMMC flash
|-
| SD card || MicroSD card slot
|-
| Wireless || 2.4G/5G WiFi and Bluetooth 4.2
|-
| Ethernet || 1x GbE Ethernet port(supports PoE with add-on PoE HAT)
|-
| HDMI || 1x full-size HDMI 2.0a (up to 4K@60Hz with HDR10, CEC, DDC, SCDC), HDMI digital Audio output
|-
| Audio || 1x 3.5mm Audio & TVE jack socket
|-
| IR || 1x CIR
|-
| USB || 4x USB2.0 Type-A HOST, 1x USB2.0 Type-C OTG
|-
| rowspan="2" | 40-pin header
| 28 pins GPIO and Power (+5V, +3.3V and GND)
|-
| UART, SPI, TWI/I²C, PWM, PCM/I²S
|-
|Buttons|| Reset, FEL and User
|-
| LED || Power Status and Activity status
|-
| Power || 5V@3A via USB Type-C
|-
|Size || 85x56 mm
|-
|Weight || 60g
|}

==BPI-M4 Berry VS Raspberry Pi 4b ==
{| class="wikitable"
! module !! Raspberry Pi 4B !! Banana Pi BPI-M4 Berry
|-
| CPU || 1.5GHz 4核 BroadcomBCM2711(Cortex A72) || H618,64 Bit Cortex™-A53 Quad-Core
|-
| GPU || 500 MHz VideoCore Vl || ARM Mali G31 GPU
|-
| Memory $SDRAM$ || 1-4GB DDR4 || 2GB LPDDR4(up to 4G)
|-
| Onboard Storage || MicroSD (TF) card || MicroSD (TF) card / MMC card slot ,eMMC 8GB
|-
| Network || 10/100/1000 Ethernet || 10/100/1000 Ethernet
|-
| Onboard WIFI &BT || IEEE 802.11a/b/g/n/ac & BT5.0 || IEEE 802.11a/b/g/n/ac & BT4.2
|-
| Display || HDMI || HDMI
|-
| Camera || N/A || N/A
|-
| Video Outputs || 2*Micro-HDMI || "HDMI 2.0a 4K@60fps"
|-
| Audio Output || 3.5 mm Jack and HDM || 3.5 mm Jack and HDMI
|-
| Audio In || N/A || N/A
|-
| GPIO || 40-PIN: PWM,GPIO,UART,I²C bus,I²S bus,SPI bus,+3.3v,+5v,ground. CAN bus || 40-PIN: PWM,GPIO,UART,I²C bus,I²S bus,SPI bus,+3.3v,+5v,ground. CAN bus
|-
| Remote || N/A || IR reciever
|-
| USB Ports || 2*USB3.0+2USB2.0 || 2 * USB 2.0 1* USB Otg
|-
| Buttons || N/A || Reset button, User button, Uboot button
|-
| LED || Power led Status led || Power led Status led Wifi led
|-
| Power || DC 5V/3A || DC 5V/2A
|-
| Board Size || 88mmx58mm || 88mmx58mm
|}

==PIN define ==

===BPI-M4 Berry 40-pin header===
{| class="wikitable" style="text-align:center;"
|-
| style="background: PaleTurquoise; color: black" colspan="6"| '''40-pin header define and GPIO Alternative Functions Assignments'''
|-
! Pin Num
! Pin Name
! ALT0
! ALT1
! ALT2
! ALT3
|-
| 1
| 3.3V
|
|
|
|
|-
| 2
| 5V
|
|
|
|
|-
| 3
| PG16
| UART2_RX
|
|
| TWI4_SDA
|-
| 4
| 5V
|
|
|
|
|-
| 5
| PG15
| UART2_TX
|
|
| TWI4_SCK
|-
| 6
| GND
|
|
|
|
|-
| 7
| PG19
|
|
| PWM1
|
|-
| 8
| PG6
| UART1_TX
|
|
|
|-
| 9
| GND
|
|
|
|
|-
| 10
| PG7
| UART1_RX
|
|
|
|-
| 11
| PH2
| UART5_TX
|
| PWM2
|
|-
| 12
| PG11
| H_I2S2_BCLK
|
|
|
|-
| 13
| PH3
| UART5_RX
|
| PWM1
|
|-
| 14
| GND
|
|
|
|
|-
| 15
| PG2
|
|
|
|
|-
| 16
| PG8
| UART1_RTS
|
|
|
|-
| 17
| 3.3V
|
|
|
|
|-
| 18
| PG9
| UART1_CTS
|
|
|
|-
| 19
| PH7
| UART2_RTS
| H_I2S3_LRCK
| SPI1_MOSI
|
|-
| 20
| GND
|
|
|
|
|-
| 21
| PH8
| UART2_CTS
| H_I2S3_DOUT0
| SPI1_MISO
| H_I2S3_DIN1
|-
| 22
| PG1
|
|
|
|
|-
| 23
| PH6
| UART2_RX
| H_I2S3_BCLK
| SPI1_CLK
|
|-
| 24
| PH5
| UART2_TX
| H_I2S3_MCLK
| SPI1_CS0
|
|-
| 25
| GND
|
|
|
|
|-
| 26
| PH9
|
| H_I2S3_DIN0
| SPI1_CS1
| H_I2S3_DOUT1
|-
| 27
| PG18
| UART2_CTS
|
|
| TWI3_SDA
|-
| 28
| PG17
| UART2_RTS
|
|
| TWI3_SCK
|-
| 29
| PG3
|
|
|
|
|-
| 30
| GND
|
|
|
|
|-
| 31
| PG4
|
|
|
|
|-
| 32
| PG0
|
|
|
|
|-
| 33
| PG5
|
|
|
|
|-
| 34
| GND
|
|
|
|
|-
| 35
| PG12
| H_I2S2_LRCK
|
|
|
|-
| 36
| PH4
|
|
|
|
|-
| 37
| PG10
| H_I2S2_MCLK
|
|
|
|-
| 38
| PG14
| H_I2S2_DIN0
| H_I2S2_DOUT1
|
|
|-
| 39
| GND
|
|
|
|
|-
| 40
| PG13
| H_I2S2_DOUT0
| H_I2S2_DIN1
|
| style="text-align:left;" |
|}

===BPI-M4 Berry Debug UART===
{| class="wikitable"
|-
| 1 || GND
|-
| 2 || UART0_RX
|-
| 3 || UART0_TX
|-
|}

=Development=
==Source code==

*u-boot for H618 : https://github.com/BPI-SINOVOIP/pi-u-boot/tree/v2021.07-sunxi
*kernel for H618 : https://github.com/BPI-SINOVOIP/pi-linux/tree/pi-6.1-sunxi

== Resources==
*BPI-M4 Berry Allwinner H618 SBC burn Ubuntu desktop image:https://www.youtube.com/watch?v=GAZsUDYL0DE
*BPI-M4 Berry DXF file
:Baidu Cloud: https://pan.baidu.com/s/1qS-_3d3IpoMBWJe8aI8JFA?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/13wsY0cMZGfz5MdTqlo19DtmlZfdOGLI4/view?usp=sharing

*BPI-M4 Berry SBC bench test: http://forum.banana-pi.org/t/bpi-m4-sbc-bench-test/9469

*Allwinner H618 Datasheet
:Baidu Cloud: https://pan.baidu.com/s/10Rk4xLMOhIkk-gIoQx9DQw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/1N6oWF9PHTcxXC1JY4x3Malr3twFv2wWZ/view?usp=sharing

=System image=

==Linux==
===Ubuntu===
*2023-11-09 Bpi-m4berry_0.0.1_beta_ubuntu_jammy_minimal_linux6.1.31
:Baidu Cloud: https://pan.baidu.com/s/1Mh8E6Zh-x8dAPkb00iX9Rw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/159Y7p8j067snqTG4oaUA2CP4aY4t6uyt/view?usp=sharing

*2023-11-09 Bpi-m4berry_0.0.1_beta_ubuntu_jammy_desktop_xfce_linux6.1.31
:Baidu Cloud: https://pan.baidu.com/s/1_sN137hKZt4DaawVsfO5Nw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/10wXnsgGtLWwf9J-dvLHW2mxsPKOrdHmJ/view?usp=sharing

=Easy to buy=
*Aliexpress shop:
:SINOVOIP Aliexpress shop: https://www.aliexpress.us/item/1005006212355480.html?spm
:Bipai Aliexpress shop: https://www.aliexpress.us/item/1005006212128000.html?gatewayAdapt=glo2usa
:Taobao Shop: https://item.taobao.com/item.htm?spm=a1z10.5-c-s.w4002-25059194413.11.489155c8Addsck&id=747425760994
:OEM&ODM, please contact: judyhuang@banana-pi.com

Banana Pi BPI-M4 Berry

2023-11-23T08:43:47Z

Qubot: /* BPI-M4 Berry VS Raspberry Pi 4b */

[[zh:香蕉派_BPI-M4_Berry]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]

[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[Banana Pi BPI-M2 Berry]] A40i-H design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[Banana Pi BPI-M2S]] Amlogic A311D/S922 chip]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=Introduction=

BPI-M4 Berry development board stands as a powerful Single Board Computer (SBC), harnessing the capabilities of the Allwinner H618 System-on-Chip (SoC) to provide developers with impressive performance and a wealth of features. Similar to the Raspberry Pi 4b, the BPI-M4 Berry boasts comparable CPU prowess, 2G LPDDR4 memory and 8G eMMC, integrated WiFi and Bluetooth functionalities, and a familiar 40-pin header layout, alongside 4 USB interfaces and a GbE RJ45 port.

Characterized by its robust performance, versatile features, and remarkable image processing capabilities, stands as an exemplary SBC development platform for professionals within the embedded and computing industries. Equipped with 8GB eMMC flash storage, high-performance decoding and encoding capabilities, and an array of interface options, it caters to a wide spectrum of application domains, including media processing, IoT, and entertainment. Whether catering to novices or seasoned developers, the BPI-M4 Berry development board offers an ideal toolset for realizing creative visions and project objectives.

[[File:Banana_Pi_M4-Berry_banner_3.jpg]]

=Key Features=
* Allwinner H618, Quad-core ARM Cortex™-A53 processor
* ARM Mali G31 GPU
* WIFI & Bluetooth
* 2G LPDDR4 RAM
* 8G eMMC flash memory
* 1x USB2.0 Type-C OTG, 5V power supply
* 4x USB2.0 Type-A
* 1x HDMI 2.0a
* 1x 3.5mm Audio & TVE jack socket
* 1x GbE Ethernet port

=Getting Start=
*[[Getting Started with BPI-M4 Berry]]

=Hardware=
==Hardware interface==
[[File:BPI-M4 Berry interface.jpg]]

==Hardware spec==
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="2"| '''Hardware Specification of Banana pi BPI-M4 Berry'''
|-
| CPU || Allwinner H618, Quad-core ARM Cortex™-A53 processor, 64-bit, up to 1.5GHz
|-
| GPU ||ARM Mali G31 GPU
|-
| Memory || 2 GB LPDDR4
|-
| Storage || 8G eMMC flash
|-
| SD card || MicroSD card slot
|-
| Wireless || 2.4G/5G WiFi and Bluetooth 4.2
|-
| Ethernet || 1x GbE Ethernet port(supports PoE with add-on PoE HAT)
|-
| HDMI || 1x full-size HDMI 2.0a (up to 4K@60Hz with HDR10, CEC, DDC, SCDC), HDMI digital Audio output
|-
| Audio || 1x 3.5mm Audio & TVE jack socket
|-
| IR || 1x CIR
|-
| USB || 4x USB2.0 Type-A HOST, 1x USB2.0 Type-C OTG
|-
| rowspan="2" | 40-pin header
| 28 pins GPIO and Power (+5V, +3.3V and GND)
|-
| UART, SPI, TWI/I²C, PWM, PCM/I²S
|-
|Buttons|| Reset, FEL and User
|-
| LED || Power Status and Activity status
|-
| Power || 5V@3A via USB Type-C
|-
|Size || 85x56 mm
|-
|Weight || 60g
|}

==BPI-M4 Berry VS Raspberry Pi 4b ==
{| class="wikitable"
! module !! Raspberry Pi 4B !! Banana Pi BPI-M4 Berry
|-
| CPU || 1.5GHz 4核 BroadcomBCM2711(Cortex A72) || H618,64 Bit Cortex™-A53 Quad-Core
|-
| GPU || 500 MHz VideoCore Vl || ARM Mali G31 GPU
|-
| Memory $SDRAM$ || 1-4GB DDR4 || 2GB LPDDR4(up to 4G)
|-
| Onboard Storage || MicroSD (TF) card || MicroSD (TF) card / MMC card slot ,eMMC 8GB
|-
| Network || 10/100/1000 Ethernet || 10/100/1000 Ethernet
|-
| Onboard WIFI &BT || IEEE 802.11a/b/g/n/ac & BT5.0 || IEEE 802.11a/b/g/n/ac & BT4.2
|-
| Display || HDMI || HDMI
|-
| Camera || N/A || N/A
|-
| Video Outputs || 2*Micro-HDMI || "HDMI 2.0a 4K@60fps"
|-
| Audio Output || 2*Micro-HDMI || 3.5 mm Jack and HDMI
|-
| Audino In || N/A || N/A
|-
| GPIO || 40-PIN: PWM,GPIO,UART,I²C bus,I²S bus,SPI bus,+3.3v,+5v,ground. CAN bus || 40-PIN: PWM,GPIO,UART,I²C bus,I²S bus,SPI bus,+3.3v,+5v,ground. CAN bus
|-
| Remote || N/A || IR reciever
|-
| USB Ports || 2*USB3.0+2USB2.0 || 2 * USB 2.0 1* USB Otg
|-
| Buttons || N/A || Reset button, User button, Uboot button
|-
| LED || Power led Status led || Power led Status led Wifi led
|-
| Power || DC 5V/3A || DC 5V/2A
|-
| Board Size || 88mmx58mm || 88mmx58mm
|}

==PIN define ==

===BPI-M4 Berry 40-pin header===
{| class="wikitable" style="text-align:center;"
|-
| style="background: PaleTurquoise; color: black" colspan="6"| '''40-pin header define and GPIO Alternative Functions Assignments'''
|-
! Pin Num
! Pin Name
! ALT0
! ALT1
! ALT2
! ALT3
|-
| 1
| 3.3V
|
|
|
|
|-
| 2
| 5V
|
|
|
|
|-
| 3
| PG16
| UART2_RX
|
|
| TWI4_SDA
|-
| 4
| 5V
|
|
|
|
|-
| 5
| PG15
| UART2_TX
|
|
| TWI4_SCK
|-
| 6
| GND
|
|
|
|
|-
| 7
| PG19
|
|
| PWM1
|
|-
| 8
| PG6
| UART1_TX
|
|
|
|-
| 9
| GND
|
|
|
|
|-
| 10
| PG7
| UART1_RX
|
|
|
|-
| 11
| PH2
| UART5_TX
|
| PWM2
|
|-
| 12
| PG11
| H_I2S2_BCLK
|
|
|
|-
| 13
| PH3
| UART5_RX
|
| PWM1
|
|-
| 14
| GND
|
|
|
|
|-
| 15
| PG2
|
|
|
|
|-
| 16
| PG8
| UART1_RTS
|
|
|
|-
| 17
| 3.3V
|
|
|
|
|-
| 18
| PG9
| UART1_CTS
|
|
|
|-
| 19
| PH7
| UART2_RTS
| H_I2S3_LRCK
| SPI1_MOSI
|
|-
| 20
| GND
|
|
|
|
|-
| 21
| PH8
| UART2_CTS
| H_I2S3_DOUT0
| SPI1_MISO
| H_I2S3_DIN1
|-
| 22
| PG1
|
|
|
|
|-
| 23
| PH6
| UART2_RX
| H_I2S3_BCLK
| SPI1_CLK
|
|-
| 24
| PH5
| UART2_TX
| H_I2S3_MCLK
| SPI1_CS0
|
|-
| 25
| GND
|
|
|
|
|-
| 26
| PH9
|
| H_I2S3_DIN0
| SPI1_CS1
| H_I2S3_DOUT1
|-
| 27
| PG18
| UART2_CTS
|
|
| TWI3_SDA
|-
| 28
| PG17
| UART2_RTS
|
|
| TWI3_SCK
|-
| 29
| PG3
|
|
|
|
|-
| 30
| GND
|
|
|
|
|-
| 31
| PG4
|
|
|
|
|-
| 32
| PG0
|
|
|
|
|-
| 33
| PG5
|
|
|
|
|-
| 34
| GND
|
|
|
|
|-
| 35
| PG12
| H_I2S2_LRCK
|
|
|
|-
| 36
| PH4
|
|
|
|
|-
| 37
| PG10
| H_I2S2_MCLK
|
|
|
|-
| 38
| PG14
| H_I2S2_DIN0
| H_I2S2_DOUT1
|
|
|-
| 39
| GND
|
|
|
|
|-
| 40
| PG13
| H_I2S2_DOUT0
| H_I2S2_DIN1
|
| style="text-align:left;" |
|}

===BPI-M4 Berry Debug UART===
{| class="wikitable"
|-
| 1 || GND
|-
| 2 || UART0_RX
|-
| 3 || UART0_TX
|-
|}

=Development=
==Source code==

*u-boot for H618 : https://github.com/BPI-SINOVOIP/pi-u-boot/tree/v2021.07-sunxi
*kernel for H618 : https://github.com/BPI-SINOVOIP/pi-linux/tree/pi-6.1-sunxi

== Resources==
*BPI-M4 Berry Allwinner H618 SBC burn Ubuntu desktop image:https://www.youtube.com/watch?v=GAZsUDYL0DE
*BPI-M4 Berry DXF file
:Baidu Cloud: https://pan.baidu.com/s/1qS-_3d3IpoMBWJe8aI8JFA?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/13wsY0cMZGfz5MdTqlo19DtmlZfdOGLI4/view?usp=sharing

*BPI-M4 Berry SBC bench test: http://forum.banana-pi.org/t/bpi-m4-sbc-bench-test/9469

*Allwinner H618 Datasheet
:Baidu Cloud: https://pan.baidu.com/s/10Rk4xLMOhIkk-gIoQx9DQw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/1N6oWF9PHTcxXC1JY4x3Malr3twFv2wWZ/view?usp=sharing

=System image=

==Linux==
===Ubuntu===
*2023-11-09 Bpi-m4berry_0.0.1_beta_ubuntu_jammy_minimal_linux6.1.31
:Baidu Cloud: https://pan.baidu.com/s/1Mh8E6Zh-x8dAPkb00iX9Rw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/159Y7p8j067snqTG4oaUA2CP4aY4t6uyt/view?usp=sharing

*2023-11-09 Bpi-m4berry_0.0.1_beta_ubuntu_jammy_desktop_xfce_linux6.1.31
:Baidu Cloud: https://pan.baidu.com/s/1_sN137hKZt4DaawVsfO5Nw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/10wXnsgGtLWwf9J-dvLHW2mxsPKOrdHmJ/view?usp=sharing

=Easy to buy=
*Aliexpress shop:
:SINOVOIP Aliexpress shop: https://www.aliexpress.us/item/1005006212355480.html?spm
:Bipai Aliexpress shop: https://www.aliexpress.us/item/1005006212128000.html?gatewayAdapt=glo2usa
:Taobao Shop: https://item.taobao.com/item.htm?spm=a1z10.5-c-s.w4002-25059194413.11.489155c8Addsck&id=747425760994
:OEM&ODM, please contact: judyhuang@banana-pi.com

Banana Pi BPI-M4 Berry

2023-11-23T08:40:17Z

Qubot: /* BPI-M4 Berry VS Raspberry Pi 4b */

[[zh:香蕉派_BPI-M4_Berry]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]

[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[Banana Pi BPI-M2 Berry]] A40i-H design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[Banana Pi BPI-M2S]] Amlogic A311D/S922 chip]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=Introduction=

BPI-M4 Berry development board stands as a powerful Single Board Computer (SBC), harnessing the capabilities of the Allwinner H618 System-on-Chip (SoC) to provide developers with impressive performance and a wealth of features. Similar to the Raspberry Pi 4b, the BPI-M4 Berry boasts comparable CPU prowess, 2G LPDDR4 memory and 8G eMMC, integrated WiFi and Bluetooth functionalities, and a familiar 40-pin header layout, alongside 4 USB interfaces and a GbE RJ45 port.

Characterized by its robust performance, versatile features, and remarkable image processing capabilities, stands as an exemplary SBC development platform for professionals within the embedded and computing industries. Equipped with 8GB eMMC flash storage, high-performance decoding and encoding capabilities, and an array of interface options, it caters to a wide spectrum of application domains, including media processing, IoT, and entertainment. Whether catering to novices or seasoned developers, the BPI-M4 Berry development board offers an ideal toolset for realizing creative visions and project objectives.

[[File:Banana_Pi_M4-Berry_banner_3.jpg]]

=Key Features=
* Allwinner H618, Quad-core ARM Cortex™-A53 processor
* ARM Mali G31 GPU
* WIFI & Bluetooth
* 2G LPDDR4 RAM
* 8G eMMC flash memory
* 1x USB2.0 Type-C OTG, 5V power supply
* 4x USB2.0 Type-A
* 1x HDMI 2.0a
* 1x 3.5mm Audio & TVE jack socket
* 1x GbE Ethernet port

=Getting Start=
*[[Getting Started with BPI-M4 Berry]]

=Hardware=
==Hardware interface==
[[File:BPI-M4 Berry interface.jpg]]

==Hardware spec==
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="2"| '''Hardware Specification of Banana pi BPI-M4 Berry'''
|-
| CPU || Allwinner H618, Quad-core ARM Cortex™-A53 processor, 64-bit, up to 1.5GHz
|-
| GPU ||ARM Mali G31 GPU
|-
| Memory || 2 GB LPDDR4
|-
| Storage || 8G eMMC flash
|-
| SD card || MicroSD card slot
|-
| Wireless || 2.4G/5G WiFi and Bluetooth 4.2
|-
| Ethernet || 1x GbE Ethernet port(supports PoE with add-on PoE HAT)
|-
| HDMI || 1x full-size HDMI 2.0a (up to 4K@60Hz with HDR10, CEC, DDC, SCDC), HDMI digital Audio output
|-
| Audio || 1x 3.5mm Audio & TVE jack socket
|-
| IR || 1x CIR
|-
| USB || 4x USB2.0 Type-A HOST, 1x USB2.0 Type-C OTG
|-
| rowspan="2" | 40-pin header
| 28 pins GPIO and Power (+5V, +3.3V and GND)
|-
| UART, SPI, TWI/I²C, PWM, PCM/I²S
|-
|Buttons|| Reset, FEL and User
|-
| LED || Power Status and Activity status
|-
| Power || 5V@3A via USB Type-C
|-
|Size || 85x56 mm
|-
|Weight || 60g
|}

==BPI-M4 Berry VS Raspberry Pi 4b ==
{| class="wikitable"
! module !! Raspberry Pi 4B !! Banana Pi BPI-M4 Berry
|-
| CPU || 1.5GHz 4核 BroadcomBCM2711(Cortex A72) || H618,64 Bit Cortex™-A53 Quad-Core
|-
| GPU || 500 MHz VideoCore Vl || ARM Mali G31 GPU
|-
| Memory $SDRAM$ || 1-4GB DDR4 || 2GB LPDDR4(up to 4G)
|-
| Onboard Storage || MicroSD (TF) card || MicroSD (TF) card / MMC card slot ,eMMC 8GB
|-
| Network || 10/100/1000 Ethernet || 10/100/1000 Ethernet
|-
| Onboard WIFI &BT || IEEE 802.11a/b/g/n/ac & BT5.0 || IEEE 802.11a/b/g/n/ac & BT4.2
|-
| Display || HDMI || HDMI
|-
| Camera || N/A || N/A
|-
| Video Outputs || 2*Micro-HDMI || "HDMI 2.0a
|-
| 4K@60fps" || ||
|-
| Audio Output || 2*Micro-HDMI || 3.5 mm Jack and HDMI
|-
| Audino In || N/A || N/A
|-
| GPIO || 40-PIN: PWM,GPIO,UART,I²C bus,I²S bus,SPI bus,+3.3v,+5v,ground. CAN bus || 40-PIN: PWM,GPIO,UART,I²C bus,I²S bus,SPI bus,+3.3v,+5v,ground. CAN bus
|-
| Remote || N/A || IR reciever
|-
| USB Ports || 2*USB3.0+2USB2.0 || 2 * USB 2.0 1* USB Otg
|-
| Buttons || N/A || Reset button, User button, Uboot button
|-
| LED || Power led Status led || Power led Status led Wifi led
|-
| Power || DC 5V/3A || DC 5V/2A
|-
| Board Size || 88mmx58mm || 88mmx58mm
|}

==PIN define ==

===BPI-M4 Berry 40-pin header===
{| class="wikitable" style="text-align:center;"
|-
| style="background: PaleTurquoise; color: black" colspan="6"| '''40-pin header define and GPIO Alternative Functions Assignments'''
|-
! Pin Num
! Pin Name
! ALT0
! ALT1
! ALT2
! ALT3
|-
| 1
| 3.3V
|
|
|
|
|-
| 2
| 5V
|
|
|
|
|-
| 3
| PG16
| UART2_RX
|
|
| TWI4_SDA
|-
| 4
| 5V
|
|
|
|
|-
| 5
| PG15
| UART2_TX
|
|
| TWI4_SCK
|-
| 6
| GND
|
|
|
|
|-
| 7
| PG19
|
|
| PWM1
|
|-
| 8
| PG6
| UART1_TX
|
|
|
|-
| 9
| GND
|
|
|
|
|-
| 10
| PG7
| UART1_RX
|
|
|
|-
| 11
| PH2
| UART5_TX
|
| PWM2
|
|-
| 12
| PG11
| H_I2S2_BCLK
|
|
|
|-
| 13
| PH3
| UART5_RX
|
| PWM1
|
|-
| 14
| GND
|
|
|
|
|-
| 15
| PG2
|
|
|
|
|-
| 16
| PG8
| UART1_RTS
|
|
|
|-
| 17
| 3.3V
|
|
|
|
|-
| 18
| PG9
| UART1_CTS
|
|
|
|-
| 19
| PH7
| UART2_RTS
| H_I2S3_LRCK
| SPI1_MOSI
|
|-
| 20
| GND
|
|
|
|
|-
| 21
| PH8
| UART2_CTS
| H_I2S3_DOUT0
| SPI1_MISO
| H_I2S3_DIN1
|-
| 22
| PG1
|
|
|
|
|-
| 23
| PH6
| UART2_RX
| H_I2S3_BCLK
| SPI1_CLK
|
|-
| 24
| PH5
| UART2_TX
| H_I2S3_MCLK
| SPI1_CS0
|
|-
| 25
| GND
|
|
|
|
|-
| 26
| PH9
|
| H_I2S3_DIN0
| SPI1_CS1
| H_I2S3_DOUT1
|-
| 27
| PG18
| UART2_CTS
|
|
| TWI3_SDA
|-
| 28
| PG17
| UART2_RTS
|
|
| TWI3_SCK
|-
| 29
| PG3
|
|
|
|
|-
| 30
| GND
|
|
|
|
|-
| 31
| PG4
|
|
|
|
|-
| 32
| PG0
|
|
|
|
|-
| 33
| PG5
|
|
|
|
|-
| 34
| GND
|
|
|
|
|-
| 35
| PG12
| H_I2S2_LRCK
|
|
|
|-
| 36
| PH4
|
|
|
|
|-
| 37
| PG10
| H_I2S2_MCLK
|
|
|
|-
| 38
| PG14
| H_I2S2_DIN0
| H_I2S2_DOUT1
|
|
|-
| 39
| GND
|
|
|
|
|-
| 40
| PG13
| H_I2S2_DOUT0
| H_I2S2_DIN1
|
| style="text-align:left;" |
|}

===BPI-M4 Berry Debug UART===
{| class="wikitable"
|-
| 1 || GND
|-
| 2 || UART0_RX
|-
| 3 || UART0_TX
|-
|}

=Development=
==Source code==

*u-boot for H618 : https://github.com/BPI-SINOVOIP/pi-u-boot/tree/v2021.07-sunxi
*kernel for H618 : https://github.com/BPI-SINOVOIP/pi-linux/tree/pi-6.1-sunxi

== Resources==
*BPI-M4 Berry Allwinner H618 SBC burn Ubuntu desktop image:https://www.youtube.com/watch?v=GAZsUDYL0DE
*BPI-M4 Berry DXF file
:Baidu Cloud: https://pan.baidu.com/s/1qS-_3d3IpoMBWJe8aI8JFA?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/13wsY0cMZGfz5MdTqlo19DtmlZfdOGLI4/view?usp=sharing

*BPI-M4 Berry SBC bench test: http://forum.banana-pi.org/t/bpi-m4-sbc-bench-test/9469

*Allwinner H618 Datasheet
:Baidu Cloud: https://pan.baidu.com/s/10Rk4xLMOhIkk-gIoQx9DQw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/1N6oWF9PHTcxXC1JY4x3Malr3twFv2wWZ/view?usp=sharing

=System image=

==Linux==
===Ubuntu===
*2023-11-09 Bpi-m4berry_0.0.1_beta_ubuntu_jammy_minimal_linux6.1.31
:Baidu Cloud: https://pan.baidu.com/s/1Mh8E6Zh-x8dAPkb00iX9Rw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/159Y7p8j067snqTG4oaUA2CP4aY4t6uyt/view?usp=sharing

*2023-11-09 Bpi-m4berry_0.0.1_beta_ubuntu_jammy_desktop_xfce_linux6.1.31
:Baidu Cloud: https://pan.baidu.com/s/1_sN137hKZt4DaawVsfO5Nw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/10wXnsgGtLWwf9J-dvLHW2mxsPKOrdHmJ/view?usp=sharing

=Easy to buy=
*Aliexpress shop:
:SINOVOIP Aliexpress shop: https://www.aliexpress.us/item/1005006212355480.html?spm
:Bipai Aliexpress shop: https://www.aliexpress.us/item/1005006212128000.html?gatewayAdapt=glo2usa
:Taobao Shop: https://item.taobao.com/item.htm?spm=a1z10.5-c-s.w4002-25059194413.11.489155c8Addsck&id=747425760994
:OEM&ODM, please contact: judyhuang@banana-pi.com

Banana Pi BPI-M4 Berry

2023-11-23T08:40:02Z

Qubot: /* BPI-M4 Berry VS Raspberry Pi 4b */

[[zh:香蕉派_BPI-M4_Berry]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]

[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[Banana Pi BPI-M2 Berry]] A40i-H design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[Banana Pi BPI-M2S]] Amlogic A311D/S922 chip]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=Introduction=

BPI-M4 Berry development board stands as a powerful Single Board Computer (SBC), harnessing the capabilities of the Allwinner H618 System-on-Chip (SoC) to provide developers with impressive performance and a wealth of features. Similar to the Raspberry Pi 4b, the BPI-M4 Berry boasts comparable CPU prowess, 2G LPDDR4 memory and 8G eMMC, integrated WiFi and Bluetooth functionalities, and a familiar 40-pin header layout, alongside 4 USB interfaces and a GbE RJ45 port.

Characterized by its robust performance, versatile features, and remarkable image processing capabilities, stands as an exemplary SBC development platform for professionals within the embedded and computing industries. Equipped with 8GB eMMC flash storage, high-performance decoding and encoding capabilities, and an array of interface options, it caters to a wide spectrum of application domains, including media processing, IoT, and entertainment. Whether catering to novices or seasoned developers, the BPI-M4 Berry development board offers an ideal toolset for realizing creative visions and project objectives.

[[File:Banana_Pi_M4-Berry_banner_3.jpg]]

=Key Features=
* Allwinner H618, Quad-core ARM Cortex™-A53 processor
* ARM Mali G31 GPU
* WIFI & Bluetooth
* 2G LPDDR4 RAM
* 8G eMMC flash memory
* 1x USB2.0 Type-C OTG, 5V power supply
* 4x USB2.0 Type-A
* 1x HDMI 2.0a
* 1x 3.5mm Audio & TVE jack socket
* 1x GbE Ethernet port

=Getting Start=
*[[Getting Started with BPI-M4 Berry]]

=Hardware=
==Hardware interface==
[[File:BPI-M4 Berry interface.jpg]]

==Hardware spec==
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="2"| '''Hardware Specification of Banana pi BPI-M4 Berry'''
|-
| CPU || Allwinner H618, Quad-core ARM Cortex™-A53 processor, 64-bit, up to 1.5GHz
|-
| GPU ||ARM Mali G31 GPU
|-
| Memory || 2 GB LPDDR4
|-
| Storage || 8G eMMC flash
|-
| SD card || MicroSD card slot
|-
| Wireless || 2.4G/5G WiFi and Bluetooth 4.2
|-
| Ethernet || 1x GbE Ethernet port(supports PoE with add-on PoE HAT)
|-
| HDMI || 1x full-size HDMI 2.0a (up to 4K@60Hz with HDR10, CEC, DDC, SCDC), HDMI digital Audio output
|-
| Audio || 1x 3.5mm Audio & TVE jack socket
|-
| IR || 1x CIR
|-
| USB || 4x USB2.0 Type-A HOST, 1x USB2.0 Type-C OTG
|-
| rowspan="2" | 40-pin header
| 28 pins GPIO and Power (+5V, +3.3V and GND)
|-
| UART, SPI, TWI/I²C, PWM, PCM/I²S
|-
|Buttons|| Reset, FEL and User
|-
| LED || Power Status and Activity status
|-
| Power || 5V@3A via USB Type-C
|-
|Size || 85x56 mm
|-
|Weight || 60g
|}

==BPI-M4 Berry VS Raspberry Pi 4b ==
{| class="wikitable"
! module !! Raspberry Pi 4B !! Banana Pi BPI-M4 Berry
|-
| CPU || 1.5GHz.4核 BroadcomBCM2711(Cortex A72) || H618,64 Bit Cortex™-A53 Quad-Core
|-
| GPU || 500 MHz VideoCore Vl || ARM Mali G31 GPU
|-
| Memory $SDRAM$ || 1-4GB DDR4 || 2GB LPDDR4(up to 4G)
|-
| Onboard Storage || MicroSD (TF) card || MicroSD (TF) card / MMC card slot ,eMMC 8GB
|-
| Network || 10/100/1000 Ethernet || 10/100/1000 Ethernet
|-
| Onboard WIFI &BT || IEEE 802.11a/b/g/n/ac & BT5.0 || IEEE 802.11a/b/g/n/ac & BT4.2
|-
| Display || HDMI || HDMI
|-
| Camera || N/A || N/A
|-
| Video Outputs || 2*Micro-HDMI || "HDMI 2.0a
|-
| 4K@60fps" || ||
|-
| Audio Output || 2*Micro-HDMI || 3.5 mm Jack and HDMI
|-
| Audino In || N/A || N/A
|-
| GPIO || 40-PIN: PWM,GPIO,UART,I²C bus,I²S bus,SPI bus,+3.3v,+5v,ground. CAN bus || 40-PIN: PWM,GPIO,UART,I²C bus,I²S bus,SPI bus,+3.3v,+5v,ground. CAN bus
|-
| Remote || N/A || IR reciever
|-
| USB Ports || 2*USB3.0+2USB2.0 || 2 * USB 2.0 1* USB Otg
|-
| Buttons || N/A || Reset button, User button, Uboot button
|-
| LED || Power led Status led || Power led Status led Wifi led
|-
| Power || DC 5V/3A || DC 5V/2A
|-
| Board Size || 88mmx58mm || 88mmx58mm
|}

==PIN define ==

===BPI-M4 Berry 40-pin header===
{| class="wikitable" style="text-align:center;"
|-
| style="background: PaleTurquoise; color: black" colspan="6"| '''40-pin header define and GPIO Alternative Functions Assignments'''
|-
! Pin Num
! Pin Name
! ALT0
! ALT1
! ALT2
! ALT3
|-
| 1
| 3.3V
|
|
|
|
|-
| 2
| 5V
|
|
|
|
|-
| 3
| PG16
| UART2_RX
|
|
| TWI4_SDA
|-
| 4
| 5V
|
|
|
|
|-
| 5
| PG15
| UART2_TX
|
|
| TWI4_SCK
|-
| 6
| GND
|
|
|
|
|-
| 7
| PG19
|
|
| PWM1
|
|-
| 8
| PG6
| UART1_TX
|
|
|
|-
| 9
| GND
|
|
|
|
|-
| 10
| PG7
| UART1_RX
|
|
|
|-
| 11
| PH2
| UART5_TX
|
| PWM2
|
|-
| 12
| PG11
| H_I2S2_BCLK
|
|
|
|-
| 13
| PH3
| UART5_RX
|
| PWM1
|
|-
| 14
| GND
|
|
|
|
|-
| 15
| PG2
|
|
|
|
|-
| 16
| PG8
| UART1_RTS
|
|
|
|-
| 17
| 3.3V
|
|
|
|
|-
| 18
| PG9
| UART1_CTS
|
|
|
|-
| 19
| PH7
| UART2_RTS
| H_I2S3_LRCK
| SPI1_MOSI
|
|-
| 20
| GND
|
|
|
|
|-
| 21
| PH8
| UART2_CTS
| H_I2S3_DOUT0
| SPI1_MISO
| H_I2S3_DIN1
|-
| 22
| PG1
|
|
|
|
|-
| 23
| PH6
| UART2_RX
| H_I2S3_BCLK
| SPI1_CLK
|
|-
| 24
| PH5
| UART2_TX
| H_I2S3_MCLK
| SPI1_CS0
|
|-
| 25
| GND
|
|
|
|
|-
| 26
| PH9
|
| H_I2S3_DIN0
| SPI1_CS1
| H_I2S3_DOUT1
|-
| 27
| PG18
| UART2_CTS
|
|
| TWI3_SDA
|-
| 28
| PG17
| UART2_RTS
|
|
| TWI3_SCK
|-
| 29
| PG3
|
|
|
|
|-
| 30
| GND
|
|
|
|
|-
| 31
| PG4
|
|
|
|
|-
| 32
| PG0
|
|
|
|
|-
| 33
| PG5
|
|
|
|
|-
| 34
| GND
|
|
|
|
|-
| 35
| PG12
| H_I2S2_LRCK
|
|
|
|-
| 36
| PH4
|
|
|
|
|-
| 37
| PG10
| H_I2S2_MCLK
|
|
|
|-
| 38
| PG14
| H_I2S2_DIN0
| H_I2S2_DOUT1
|
|
|-
| 39
| GND
|
|
|
|
|-
| 40
| PG13
| H_I2S2_DOUT0
| H_I2S2_DIN1
|
| style="text-align:left;" |
|}

===BPI-M4 Berry Debug UART===
{| class="wikitable"
|-
| 1 || GND
|-
| 2 || UART0_RX
|-
| 3 || UART0_TX
|-
|}

=Development=
==Source code==

*u-boot for H618 : https://github.com/BPI-SINOVOIP/pi-u-boot/tree/v2021.07-sunxi
*kernel for H618 : https://github.com/BPI-SINOVOIP/pi-linux/tree/pi-6.1-sunxi

== Resources==
*BPI-M4 Berry Allwinner H618 SBC burn Ubuntu desktop image:https://www.youtube.com/watch?v=GAZsUDYL0DE
*BPI-M4 Berry DXF file
:Baidu Cloud: https://pan.baidu.com/s/1qS-_3d3IpoMBWJe8aI8JFA?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/13wsY0cMZGfz5MdTqlo19DtmlZfdOGLI4/view?usp=sharing

*BPI-M4 Berry SBC bench test: http://forum.banana-pi.org/t/bpi-m4-sbc-bench-test/9469

*Allwinner H618 Datasheet
:Baidu Cloud: https://pan.baidu.com/s/10Rk4xLMOhIkk-gIoQx9DQw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/1N6oWF9PHTcxXC1JY4x3Malr3twFv2wWZ/view?usp=sharing

=System image=

==Linux==
===Ubuntu===
*2023-11-09 Bpi-m4berry_0.0.1_beta_ubuntu_jammy_minimal_linux6.1.31
:Baidu Cloud: https://pan.baidu.com/s/1Mh8E6Zh-x8dAPkb00iX9Rw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/159Y7p8j067snqTG4oaUA2CP4aY4t6uyt/view?usp=sharing

*2023-11-09 Bpi-m4berry_0.0.1_beta_ubuntu_jammy_desktop_xfce_linux6.1.31
:Baidu Cloud: https://pan.baidu.com/s/1_sN137hKZt4DaawVsfO5Nw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/10wXnsgGtLWwf9J-dvLHW2mxsPKOrdHmJ/view?usp=sharing

=Easy to buy=
*Aliexpress shop:
:SINOVOIP Aliexpress shop: https://www.aliexpress.us/item/1005006212355480.html?spm
:Bipai Aliexpress shop: https://www.aliexpress.us/item/1005006212128000.html?gatewayAdapt=glo2usa
:Taobao Shop: https://item.taobao.com/item.htm?spm=a1z10.5-c-s.w4002-25059194413.11.489155c8Addsck&id=747425760994
:OEM&ODM, please contact: judyhuang@banana-pi.com

Banana Pi BPI-M4 Berry

2023-11-01T06:39:41Z

Qubot: /* Source code */

[[zh:香蕉派_BPI-M4_Berry]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]

[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[Banana Pi BPI-M2 Berry]] A40i-H design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[Banana Pi BPI-M2S]] Amlogic A311D/S922 chip]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=Introduction=
[[File:Banana_Pi_M4-Berry_banner_3.jpg]]

The BPI-M4 Berry development board stands as a powerful Single Board Computer (SBC), harnessing the capabilities of the Allwinner H618 System-on-Chip (SoC) to provide developers with impressive performance and a wealth of features. Similar to the Raspberry Pi 4b, the BPI-M4 Berry boasts comparable CPU prowess, LPDDR4 memory support, integrated WiFi and Bluetooth functionalities, and a familiar 40-pin header layout, alongside 4 USB interfaces and a GbE RJ45 port.

Characterized by its robust performance, versatile features, and remarkable image processing capabilities, stands as an exemplary SBC development platform for professionals within the embedded and computing industries. Equipped with 8GB eMMC flash storage, high-performance decoding and encoding capabilities, and an array of interface options, it caters to a wide spectrum of application domains, including media processing, IoT, and entertainment. Whether catering to novices or seasoned developers, the BPI-M4 Berry development board offers an ideal toolset for realizing creative visions and project objectives.

=Key Features=
* Allwinner H618, Quad-core ARM Cortex™-A53 processor
* ARM Mali G31 GPU
* WIFI & Bluetooth
* 2G LPDDR4 RAM
* 8G eMMC flash memory
* 1x USB2.0 Type-C OTG, 5V power supply
* 4x USB2.0 Type-A
* 1x HDMI 2.0a
* 1x 3.5mm Audio & TVE jack socket
* 1x GbE Ethernet port

=Getting Start=
*[[Getting Started with BPI-M4 Berry]]

=Hardware=
==Hardware interface==
[[File:BPI-M4 Berry interface.jpg]]

==Hardware spec==
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="2"| '''Hardware Specification of Banana pi BPI-M4 Berry'''
|-
| CPU || Allwinner H618, Quad-core ARM Cortex™-A53 processor, 64-bit, up to 1.5GHz
|-
| GPU ||ARM Mali G31 GPU
|-
| Memory || 2 GB LPDDR4
|-
| Storage || 8G eMMC flash
|-
| SD card || MicroSD card slot
|-
| Wireless || 2.4G/5G WiFi and Bluetooth 4.2
|-
| Ethernet || 1x GbE Ethernet port(supports PoE with add-on PoE HAT)
|-
| HDMI || 1x full-size HDMI 2.0a (up to 4K@60Hz with HDR10, CEC, DDC, SCDC), HDMI digital Audio output
|-
| Audio || 1x 3.5mm Audio & TVE jack socket
|-
| IR || 1x CIR
|-
| USB || 4x USB2.0 Type-A HOST, 1x USB2.0 Type-C OTG
|-
| rowspan="2" | GPIO
| 40-pin header, 28 pins GPIO and Power (+5V, +3.3V and GND)
|-
| UART, SPI, TWI/I²C, PWM, PCM/I²S
|-
|Buttons|| Reset, FEL and User
|-
| LED || Power Status and Activity status
|-
| Power || 5V@3A via USB Type-C
|-
|Size || 85x56 mm
|-
|Weight || 60g
|}

==BPI-M4 Berry VS Raspberry Pi 4b ==

==PIN define ==

===BPI-M4 Berry 40-pin header===
{| class="wikitable" style="text-align:center;"
|-
| style="background: PaleTurquoise; color: black" colspan="6"| '''40-pin header define and GPIO Alternative Functions Assignments'''
|-
! Pin Num
! Pin Name
! ALT0
! ALT1
! ALT2
! ALT3
|-
| 1
| 3.3V
|
|
|
|
|-
| 2
| 5V
|
|
|
|
|-
| 3
| PG16
| UART2_RX
|
|
| TWI4_SDA
|-
| 4
| 5V
|
|
|
|
|-
| 5
| PG15
| UART2_TX
|
|
| TWI4_SCK
|-
| 6
| GND
|
|
|
|
|-
| 7
| PG19
|
|
| PWM1
|
|-
| 8
| PG6
| UART1_TX
|
|
|
|-
| 9
| GND
|
|
|
|
|-
| 10
| PG7
| UART1_RX
|
|
|
|-
| 11
| PH2
| UART5_TX
|
| PWM2
|
|-
| 12
| PG11
| H_I2S2_BCLK
|
|
|
|-
| 13
| PH3
| UART5_RX
|
| PWM1
|
|-
| 14
| GND
|
|
|
|
|-
| 15
| PG2
|
|
|
|
|-
| 16
| PG8
| UART1_RTS
|
|
|
|-
| 17
| 3.3V
|
|
|
|
|-
| 18
| PG9
| UART1_CTS
|
|
|
|-
| 19
| PH7
| UART2_RTS
| H_I2S3_LRCK
| SPI1_MOSI
|
|-
| 20
| GND
|
|
|
|
|-
| 21
| PH8
| UART2_CTS
| H_I2S3_DOUT0
| SPI1_MISO
| H_I2S3_DIN1
|-
| 22
| PG1
|
|
|
|
|-
| 23
| PH6
| UART2_RX
| H_I2S3_BCLK
| SPI1_CLK
|
|-
| 24
| PH5
| UART2_TX
| H_I2S3_MCLK
| SPI1_CS0
|
|-
| 25
| GND
|
|
|
|
|-
| 26
| PH9
|
| H_I2S3_DIN0
| SPI1_CS1
| H_I2S3_DOUT1
|-
| 27
| PG18
| UART2_CTS
|
|
| TWI3_SDA
|-
| 28
| PG17
| UART2_RTS
|
|
| TWI3_SCK
|-
| 29
| PG3
|
|
|
|
|-
| 30
| GND
|
|
|
|
|-
| 31
| PG4
|
|
|
|
|-
| 32
| PG0
|
|
|
|
|-
| 33
| PG5
|
|
|
|
|-
| 34
| GND
|
|
|
|
|-
| 35
| PG12
| H_I2S2_LRCK
|
|
|
|-
| 36
| PH4
|
|
|
|
|-
| 37
| PG10
| H_I2S2_MCLK
|
|
|
|-
| 38
| PG14
| H_I2S2_DIN0
| H_I2S2_DOUT1
|
|
|-
| 39
| GND
|
|
|
|
|-
| 40
| PG13
| H_I2S2_DOUT0
| H_I2S2_DIN1
|
| style="text-align:left;" |
|}

===BPI-M4 Berry Debug UART===
{| class="wikitable"
|-
| 1 || GND
|-
| 2 || UART0_RX
|-
| 3 || UART0_TX
|-
|}

=Development=
==Source code==

*u-boot for H618 : https://github.com/BPI-SINOVOIP/pi-u-boot/tree/v2021.07-sunxi
*kernel for H618 : https://github.com/BPI-SINOVOIP/pi-linux/tree/pi-6.1-sunxi

== Resources==
*BPI-M4 Berry Allwinner H618 SBC burn Ubuntu desktop image:https://www.youtube.com/watch?v=GAZsUDYL0DE
*BPI-M4 Berry DXF file
:Baidu Cloud: https://pan.baidu.com/s/1qS-_3d3IpoMBWJe8aI8JFA?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/13wsY0cMZGfz5MdTqlo19DtmlZfdOGLI4/view?usp=sharing

*BPI-M4 Berry SBC bench test: http://forum.banana-pi.org/t/bpi-m4-sbc-bench-test/9469

*Allwinner H618 Datasheet
:Baidu Cloud: https://pan.baidu.com/s/10Rk4xLMOhIkk-gIoQx9DQw?pwd=8888 (pincode:8888)
:Google Drive: https://drive.google.com/file/d/1N6oWF9PHTcxXC1JY4x3Malr3twFv2wWZ/view?usp=sharing

=System image=

=Easy to buy=

香蕉派 BPI-R3 Mini

2023-10-30T01:43:27Z

Qubot: /* OpenWRT */

[[en:Banana Pi BPI-R3 Mini]]
=概述=

[[File:Banana_Pi_BPI-R3_Mini__1.jpg|thumb|[[香蕉派 BPI-R3 Mini]] with MediaTek MT7986(Filogic 830)]]
[[File:Banana_Pi_BPI-R3_Mini__case_1.jpg|thumb|[[香蕉派 BPI-R3 Mini]] with MediaTek MT7986(Filogic 830)]]
[[File:Banana_Pi_BPI-R3_Router_2.jpg|thumb|[[香蕉派 BPI-R3]] with MediaTek MT7986(Filogic 830)]]
[[File:Banana_Pi_BPI-R2_Pro_1_750.jpg|thumb|[[香蕉派 BPI-R2 Pro]] Rockchip RK3568 design]]
[[File:BPI-R64_3.JPG|thumb|[[香蕉派 BPI-R64]] with MediaTek MT7622]]
[[File:BPI-R2_3.JPG|thumb|[[香蕉派 BPI-R2]] with MTK MT7623N chip design]]
[[File:O2A0500.jpg|thumb|[[香蕉派 BPI-W2]] with Realtek RTK1296 chip design]]
[[File:Banana_pi_BPI-R1_1.JPG|thumb|[[香蕉派 BPI-R1]] with allwinner A20 chip design]]
[[File:Bpi-r3_Metal_case.jpg|thumb|[[香蕉派 BPI-R3 ]] Metal case ]]

[[File:Banana Pi BPI-R3 Mini banner 1.jpg]]
==BPI-R3 mini介绍==

香蕉派BPI-R3 Mini开源路由器开发板采用联发科MT7986 (Filogic 830)四核 ARMA53 + MT7531A芯片设计,板载2G DDR内存与8G eMMC存储,这是一个非常高性能开源路由器开发板,支持WIFI6, 2.4G Wifi无线使用MT7975N芯片, 5G Wifi使用MT7975P芯片,支持2个2.5网口。

==MediaTek MT7986(Filogic 830)芯片介绍==

联发科技Filogic 830 Filogic 830 整合四个主频高达2GHz 的Arm Cortex-A53 核心，处理能力高达18,000 DMIPs，双4x4 Wi-Fi 6/6E 连接速率可达6Gbps，并拥有两个2.5G 乙太网路介面和串列周边介面（SPI）。Filogic 830 内建硬体加速引擎，可实现快速且可靠的Wi-Fi卸载（offloading）及无线网路连结。此外，该晶片支援联发科技FastPath™ 技术，可适用于游戏、AR/VR 等低延迟应用。Wi-Fi 6E 与前几代相比具有许多优势，包括更低的延迟、更大的频宽容量和更快的传送速率。支援6GHz 频段的无线网路设备主要运用160MHz 宽通道和6GHz 的未拥塞频宽，以提供千兆级（multigigabit）传输和低延迟的Wi-Fi 连接，可为串流媒体、游戏、AR/VR 等应用提供可靠的无线连网。

==应用方向==
* 互联网服务路由器
* 无线路由器
* 无线中继器
* 家庭安全网关
* 家庭自动化
* NAS设备
* 网络和通信应用

==关键特征==
*联发科(MediaTek) MT7986(Filogic 830) 四核ARM Cortex A53 chip
*Wifi 6 2.4G/5G（MT7976C）
*2G DDR 内存
*8G eMMC 存储
*128MB Nand 存储
*2x 2.5GbE 网络接口
*1xM.2 Key B 接口
*1xM.2 KEY M PCIe 接口
*1xUSB 接口

==快速上手==
*[[Getting Started with BPI-R3 MINI]]

=硬件=
==硬件示意图==
[[File:BPI-R3_MINI_interface.jpg]]

==硬件规格==
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''HardWare Specification of Banana pi BPI-R3 Mini'''
|-
| CPU ||MediaTek MT7986(Filogic 830) Quad core ARM Cortex A53 chip design
|-
| SDRAM || 2 GB DDR4
|-
| On board Storage || Nand flash,8GB eMMC onboard
|-
| On board Network || 2 2.5GbE Ethernet
|-
| Wifi || Wifi 6 4x4 2.4G Wifi(MT7976) +4x4 5G Wifi(MT7976)
|-
| M.2 Key B| 1x M.2 Key B interface
|-
|M.2 Key M ||1x M.2 KEY-M PCIe inerface
|-
| USB || 1 USB 2.0
|-
| Buttons || Reset button,WPS botton, boot switch
|-
| 5 Leds || Power ,System, Wifi 2G ,Wifi 5G ,4G Lte ,SSD
|-
| DC Power || 20W/12V TypeC PD
|-
| Sizes ||
|-
| Weight || 100g
|-
|}

=开发资源=
==软件源代码==

*开源驱动的BSP
:https://github.com/BPI-SINOVOIP/BPI-R3MINI-OPENWRT-V21.02.3

==参考文档==
*BPI-R3 Mini DXF 文档
:Google Drive: https://drive.google.com/file/d/1FgNVjR-kPdFVNZBPkAF8xTIZ4YauJ_2O/view?usp=sharing
:Baidu Cloud: https://pan.baidu.com/s/1t1hZjNdg7rMBJcqVEZN-Ag?pwd=8888 (pincode:8888)
*BPI-R3 Mini原理图
:Google Drive:https://drive.google.com/file/d/1wvovcYf0OtvQl5fekJku25QNeER1D7cM/view?usp=sharing
:Baidu Cloud: https://pan.baidu.com/s/1HohHjd2w-mqLlBhwsXR87A?pwd=8888 (pincode:8888)
*MT7986A_Datasheet_1.15 : https://drive.google.com/file/d/1t_nuPTeoAcFb1dmEe4kJVlLWdHcAA6OB/view?usp=sharing
*MT7986A_Reference_Manual_for_BPI-R3 : https://drive.google.com/file/d/1biSJmxnIpNzQroYDg9mtPtSTAv4i0DFf/view?usp=sharing
*[Tutorial] Build, customize and use MediaTek open-source U-Boot and ATF : https://forum.banana-pi.org/t/tutorial-build-customize-and-use-mediatek-open-source-u-boot-and-atf/13785

=镜像发布=
==OpenWRT==
*bl2_emmc.img
:Google Drive:https://drive.google.com/file/d/1L5lVyg8dDl60eyzkqBr-8aeG2Weq5ouo/view?usp=sharing
:Baidu Cloud:https://pan.baidu.com/s/1vdnCKqr0GSzQid7Y3ADCKw?pwd=8888 (pincode:8888)

*2023-09-12 BPI-R3 Mini OpenWRT image with Opensource Driver BSP (support Quectel RM500U-CN & RM520N-GL 5G Modules)
:Google Drive: https://drive.google.com/drive/folders/1o6JGM61eZQycuYPFlror4IwNa5cGzyIa?usp=sharing
:Baidu Cloud: https://pan.baidu.com/s/1vAJC-n37Yt_aHEZU9PL7Sw?pwd=8888 (pincode:8888)

*2023-09-12 BPI-R3 Mini OpenWRT image with MTK vendor driver, Not OpenSource Driver BSP (support Quectel RM500U-CN & RM520N-GL 5G Modules)
:Google Drive:https://drive.google.com/drive/folders/15iXMvzaZFb1M5HHfotew3NMdMEjOEtTJ?usp=sharing
:Baidu Cloud: https://pan.baidu.com/s/1qAiIqHxhUwuRUp8CIcrPTw?pwd=8888 (pincode:8888)

=FAQ=

=样品购买=

*BIPAI Aliexpress shop : https://www.aliexpress.com/item/1005005873750368.html?
*SINOVOIP Aliexpress shop: https://www.aliexpress.com/store/group/BPI-R3-Mini/1100417230_40000004378662.html?
*Taobao shop : https://item.taobao.com/item.htm?spm=a213gs.success.result.1.1bd14831HTwBxZ&id=730610953668
*OEM &ODM定制服务，请联系：judyhuang@banana-pi.com

Getting Started with M5/M2Pro

2023-08-04T07:14:37Z

Qubot: /* Wifi/BT support */

=Introduction=
[[File:Banana_Pi_BPI-M5_4.JPG|thumb|[[Banana Pi BPI-M5]]]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|Amlogic S905X3 Processor]]
[[File:Banana_Pi_BPI-M5_2.jpg|thumb|Amlogic S905X3 Processor]]

Banana Pi M5 is a new generation single board computer design , use Amlogic S905X3 Quad-Core Cortex-A55 (2.0xxGHz) Processor. Mali-G31 MP2 GPU with 4 x Execution Engines (650Mhz). support 4GB LPDDR4 and 16G eMMC flash. it have 4 USB 3.0 port,1GbE LAN port, IR Reciver, Audio Jack, 1 HDMI Out and USB type-c power supply.

Banana Pi M2Pro is the same SOC with M5, but different board layout. 2GB LPDDR4 and 16G eMMC flash, 2 USB 3.0 port,1GbE LAN port, rtl8821cu usb wifi/bt onboard, IR Reciver, 1 HDMI Out, 1 MicroUSB port, DC power supply.

=specifications=

*SoC – Amlogic S905X3 quad-core Cortex-A55 processor @ up to 2.0 GHz with
*Mali-G31 MP2 GPU @ 650Mhz
*System Memory – 4GB LPDDR4
*Storage – 16GB eMMC flash (option up to 64GB), MicroSD slot up to 2TB
*Video Output – HDMI 2.1 up to 4Kp60 with HDR, CEC, EDID
*Audio – 3.5mm audio jack, digital HDMI audio
*Connectivity – Gigabit Ethernet
*USB – 4x USB 3.0 ports via VL817 hub controller, 1x USB-C port (for power only?)
*Expansion – 40-pin Raspberry Pi header with 28x GPIO, UART, I2C, SPI, PWM, and power signal (+5V, +3.3V, GND).
*Debugging – 3-pin debug header
*Misc – Reset, Power, and U-boot button; power and activity LED’s; IR receiver
*Power Supply – 5V @3A via USB Type-C port
*Dimensions – 92x60mm (Not the same as Raspberry Pi PCB size, but they probably included the connectors during measurement)
*Weight – 48grams

=development=

==Prepare==
:1. Prepare a usb-serial cable, a 5V/3A adaptor type-c power supply. The serial cable is used for console debug and type-c cable is used for android image download and ADB debug. M2pro is used Micro-usb port for android image download and ADB debug.
:2. Prepare a SDcard at least 8GB for linux development, android only support emmc boot.
:3. The SOC rom first boot media is emmc, so board can't bootup from SDcard if the emmc is bootable with any image flashed, more info please refer to board [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Boot_Sequence boot sequence].
:4. In Android SDcard is mmc0, emmc is mmc1, but in Linux SDcard is mmc1, emmc is mmc0.

==Android==
===Prepare===

:1. Download and install the [https://download.banana-pi.dev/d/3ebbfa04265d4dddb81b/files/?p=%2FTools%2Fimage_download_tools%2Faml_usb_burning_tool_V2_setup_v2.2.3.3.zip AML Usb Burning Tool] for android image download via USB type-c on M5 and Micro-usb on M2pro, only support windows.
:2. Download the latest [http://wiki.banana-pi.org/Banana_Pi_BPI-M5#Android_2 android image], and confirm that the md5 checksum is correct.
:3. M5 and M2pro are compatiable with same android image.

===Install Image with Usb Burning Tool===

:1. Open USB_Burning_Tool.exe, select menu File->Import image, choose the android image file aml_upgrade_package.img.

:[[File:m5_android_install_1.png]]

:2. M5/M2pro board disconnect power, press and hold SW4 button beside 40pin header, plugin type-c usb cable(microUSB on m2pro) to PC

:[[File:m5_android_install_2.png]]

:3. Click the Start button and wait for upgrade complete.

:[[File:m5_android_install_3.png]]

:4. After Burning successfull, Unplug the usb and connect to power supply adaptor to startup.

:[[File:m5_android_install_4.png]]

:5. Click the Stop button to cancel the upgrade process and close the USB Buring Tool.

===Install Image with Aml Flash Tool===
:[https://github.com/Dangku/aml-flash-tool aml-flash-tool] is a linux platform opensource image flash util for Amlogic android.

$ ./flash-tool.sh --img=/path/to/aml_upgrade_package.img --parts=all --wipe --soc=g12a --reset=y

:[[File:m5_linux_flash.PNG]]

===Build Android Source Code===
:1. Get Android 9.0 source code

$ git clone https://github.com/BPI-SINOVOIP/BPI-S905X3-Android9

:or you can get the source code tar archive from [https://pan.baidu.com/s/1TmmR_075b49lPSt1Phq0ag?pwd=8888 Baidu Pan(pincode: 8888)] or [https://drive.google.com/drive/folders/1RuvazYcr46HKMvNBxSqQftdyWa0tK9f7?usp=share_link Google Drive]

:2. Build the Android 9.0 Source code

:Please read the source code [https://github.com/BPI-SINOVOIP/BPI-S905X3-Android9/blob/master/README.md README.md]

===Android DTB overlay===

:Bananapi M5/M2Pro DTBO idx value table, default idx value is 0 in release image.

:{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''Bananapi M5/M2pro DTBO idx value table'''
|-
|idx value|| device tree overlay || description
|-
| 0|| android_p_overlay|| default dtbo, no use
|-
| 1|| wifi_bt_rtl8822cs|| enable bpi rtl8822cs wifi/bt module
|-
| 2|| i2c2|| enable i2c 2
|-
| 3|| i2c3|| enable i2c 3
|-
| 4|| sdio|| enable sdio
|-
| 5|| uart1|| enable 2 pins uart 1
|-
| 6|| uart1_cts_rts|| enable 4 pins uart 1
|-
| 7|| uart2|| enable 2 pins uart 2
|-
| 8|| hifi_pcm5122|| enable i2s [https://shumeipai.nxez.com/hifidac-hat-for-raspberry-pi pcm5122 HiFi DAC]
|}

:'''How to apply a new dtbo'''

:1. ADB command via sysfs

root@dangku-desktop:/tmp# adb root
restarting adbd as root
root@dangku-desktop:/tmp# adb remount
remount succeeded
root@dangku-desktop:/tmp# adb shell
bananapi_m5:/ # echo dtbo > /sys/class/unifykeys/name
bananapi_m5:/ # echo "1" > /sys/class/unifykeys/write
bananapi_m5:/ # reboot

:2. Uart console command via sysfs

console:/ $
console:/ $ su
console:/ # echo dtbo > /sys/class/unifykeys/name
[ 115.702781@0] unifykey: name_store() 1302, name dtbo, 4
[ 115.702856@0] unifykey: name_store() 1311
console:/ #
console:/ # echo "1" > /sys/class/unifykeys/write
[ 129.262659@0] unifykey: write_store() is a string
[ 129.262733@0] unifykey: dtbo, 1, 1
[ 129.265312@0] unifykey: amlkey_write 393
[ 129.292347@1] emmc_key_write:149, write ok
console:/ #
console:/ # reboot

:3. Settings App(To-Do)

:Check the bootup uart debug message and confirm which dtbo is loaded actually, here "1" means set idx=1 to apply wifi_bt_rtl8822cs dtbo.

load dtb from 0x1000000 ......
Amlogic multi-dtb tool
Single dtb detected
find 2 dtbos
dtbos to be applied: 1
Apply dtbo 1

:Unifykeys is stored in a specific emmc part, "Normal erase" selected in USB_Burning_Tool will not erase this data for next update, you must select "Erase all" if you want the default dtbo idx to be applied after image download.

:[[File:m5_android_erase_all.png]]

:'''Build Android image with a specific DTBO default'''.

:1. Default build-in overlays are defined in device/amlogic/bananapi_m5/Kernel.mk, you can add a new overlay dtbo here.
DTBO_DEVICETREE := android_p_overlay wifi_bt_rtl8822cs i2c2 i2c3 sdio uart1 uart1_cts_rts uart2 hifi_pcm5122

:2. Default apply DTBO idx is defined in device/amlogic/bananapi_m5/BoardConfig.mk, you can change the idx value to set which overlay dtbo will be applied default.
BOARD_KERNEL_CMDLINE += androidboot.dtbo_idx=0

:3. DTS files are in common/arch/arm/boot/dts/amlogic/overlay/bananapi_m5/

:More info about android device tree overlays, please refer to [https://source.android.com/devices/architecture/dto google android offical site]

===Install OpenGapps===

:1. Download install package from [https://opengapps.org/ OpenGapps], Android release image is arm/android 9.0 variant.

[[File:opengapps.PNG]]

:2. Download [https://download.banana-pi.dev/d/ca025d76afd448aabc63/files/?p=%2FTools%2Fapps%2Fdevice_id_v1.3.2.apk device_id.apk].
:3. Copy the OpenGapp package to a udisk or sdcard root directory.
:4. Create a txt file named '''factory_update_param.aml''' in udisk or sdcard root directory with the following android recovery parameter content, and replace the file name with the actual downloaded package.
::udisk:
--wipe_cache
--update_package=/udisk/open_gapps-arm-9.0-pico-20210327.zip

::sdcard:
--wipe_cache
--update_package=/sdcard/open_gapps-arm-9.0-pico-20210327.zip

:5. Plugin the udisk or sdcard to the board and poweron.

:6.OpenGapps install and certify.
:<youtube>fXOKmWfpqF8</youtube>
:watch this video on [https://www.bilibili.com/video/BV13y4y1s77i/ bilibili]

===IR Remote Control Custom===
:Before starting this work, some android basic concepts and knowledge need to be known.

:*Linux kernel input key event.
:*Android keycode.
:*Linux keycode map to android keycode.
:*Android Adb function work on your PC

:1. pull the remote files from device
# adb pull /vendor/etc/remote.cfg
# adb pull /vendor/etc/remote.tab

:2. modify remote.cfg to enable remote debug message
:[[File:remotecfg.png]]

:push remote.cfg back

# adb root
# adb remount
# adb push remote.cfg /vendor/etc/
# adb shell
m5_mbox:/ # chmod 644 /vendor/etc/remote.cfg
m5_mbox:/ # remotecfg -c /vendor/etc/remote.cfg -d
cfgdir = /vendor/etc/remote.cfg
work_mode = 1
repeat_enable = 0
debug_enable = 1
max_frame_time = 1000

:3. Get the remote keycode
:Press your remote key one by one and then print the dmesg to get the remote custom_code and each remote key code.

# adb shell dmesg | grep framecode=
:[[File:keycode.png]]

:custom_code = 0xfe01
:keycode = 0x00, 0x01, 0x09, 0x02, 0x0a, 0x05, 0x04 0x06, 0x03, 0x0b, 0x40, 0x48, 0x44

:4. Modify remote.tab to map the scancode to android keycode
:[[File:remotetab.png]]

:push remote.tab and test each key whether works

# adb root
# adb remount
# adb push remote.tab1 /vendor/etc/
# adb shell
m5_mbox:/ # chmod 644 /vendor/etc/remote.tab
m5_mbox:/ # remotecfg -c /vendor/etc/remote.cfg -t /vendor/etc/remote.tab -d
cfgdir = /vendor/etc/remote.cfg
work_mode = 1
repeat_enable = 0
debug_enable = 1
max_frame_time = 1000
tabdir = /vendor/etc/remote.tab
custom_name = nec-test
fn_key_scancode = 0xffff
cursor_left_scancode = 0xffff
cursor_right_scancode = 0xffff
cursor_up_scancode = 0xffff
cursor_down_scancode = 0xffff
cursor_ok_scancode = 0xffff
custom_code = 0xfe01
release_delay = 80
map_size = 13
key[0] = 0x74
key[1] = 0x1008b
key[2] = 0x90066
key[3] = 0x20069
key[4] = 0xa006a
key[5] = 0x50067
key[6] = 0x4006c
key[7] = 0x6001c
key[8] = 0x30072
key[9] = 0xb0073
key[10] = 0x40009e
key[11] = 0x4800a4
key[12] = 0x440071

:5. Reboot the board

==Linux==
===Prepare===
:1. Linux image support SDcard or EMMC bootup, but you should read the [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Boot_Sequence boot sequence] at first.

:2. It’s recommended to use A1 rated cards, 8GB at least.

:3. M5 and M2pro are compatiable with same Linux image.

:4. Make sure bootable EMMC is formatted if you want bootup from SDcard, more info refer to [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Erase_EMMC_for_SDcard_Bootup Erase EMMC for SDcard Bootup]

:5. Make sure SDcard is formatted without Linux image flashed if you want bootup from EMMC and use Sdcard as storage.

:6. Install bpi-tools on your Linux PC(if [https://wiki.banana-pi.org/Getting_Started_with_M5/M2Pro#Install_Image_to_SDcard flash image] with other tools, ignore this step). If you can't access this URL or any other install problem, please go to [https://github.com/bpi-sinovoip/bpi-tools bpi-tools] source repo, download and install this tools manually.
$ apt-get install pv
$ curl -sL https://github.com/BPI-SINOVOIP/bpi-tools/raw/master/bpi-tools | sudo -E bash

:7. Download latest [http://wiki.banana-pi.org/Banana_Pi_BPI-M5#Linux Linux Image], and confirm that the md5 checksum is correct.

:8. Default login: pi/bananapi or root/bananapi

:9. The wiki guide is only for [https://wiki.banana-pi.org/Banana_Pi_BPI-M5#Linux bananapi 4.9 bsp ubuntu/debian images].

===Install Image to SDcard===
:1. Install Image with Balena Etcher on Windows, Linux and MacOS.
:[https://balena.io/etcher Balena Etcher] is an opensource GUI flash tool by Balena, Flash OS images to SDcard or USB drive

:[[File:m2s_linux_flash.png]]

:2. Install Image with Balena Cli on Windows, Linux and MacOS.
:[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.

$ sudo balena local flash path/to/xxx-bpi-m5-xxx.img.zip
$ sudo balena local flash path/to/xxx-bpi-m5-xxx.img.zip --drive /dev/disk2
$ sudo balena local flash path/to/xxx-bpi-m5-xxx.img.zip --drive /dev/disk2 --yes

: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.
$ sudo apt-get install pv unzip
$ sudo unzip -p xxx-bpi-m5-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
$ sudo apt-get install pv unzip
$ sudo bpi-copy xxx-bpi-m5-xxx.img.zip /dev/sdX

===Install Image to EMMC===
:1. Prepare a [https://wiki.banana-pi.org/Getting_Started_with_BPI-M5/M2Pro#Install_Image_to_SDcard SDcard with Linux image] flashed and bootup board with this SDcard.

:2. Copy Linux image to udisk, plug the udisk to board and mount it.

:3. There are two ways to install the linux image to board.
3.1 Install with dd command, umount mmcblk0p1 and mmcblk0p2 partition if mounted automatically. Actually bpi-copy is the same as this dd command.
$ sudo apt-get install pv unzip
$ sudo unzip -p xxx-bpi-m5-xxx.img.zip | pv | dd of=/dev/mmcblk0 bs=10M status=noxfer

3.2 Install the linux image in udisk with bpi-tools command
$ sudo apt-get install pv unzip
$ sudo bpi-copy xxx-bpi-m5-xxx.img.zip /dev/mmcblk0

:4. After download complete, power off safely and eject the SDcard.

===Build Linux Source Code===
:1. Get the Linux bsp source code
$ git clone https://github.com/BPI-SINOVOIP/BPI-M5-bsp
:2. Build the bsp source code

::Please read the source code [https://github.com/BPI-SINOVOIP/BPI-M5-bsp/blob/master/README.md README.md]

:3. If you want build uboot and kernel separately, please download the [https://github.com/Dangku/amlogic-u-boot/tree/odroidg12-v2015.01-c4-m5 u-boot] the [https://github.com/Dangku/amlogic-linux/tree/odroidg12-4.9.y-c4-m5 kernel] only, get the toolchains, boot script and other configuration files from [https://github.com/BPI-SINOVOIP/BPI-M5-bsp BPI-M5-bsp]

===DTB overlay===
:1. DTB overlay is used for 40pin gpios multi-function configuration and install in vfat boot partition, you can check the mount point with mount command.
root@bananapi:~# ls /boot/overlays/
custom_ir.dtbo pwm_b-backlight.dtbo spi0.dtbo
ds3231.dtbo pwm_c-beeper.dtbo uart1_cts_rts.dtbo
hifi_pcm5102a.dtbo pwm_cd-c.dtbo uart1.dtbo
hifi_pcm5122.dtbo pwm_cd.dtbo uart2.dtbo
i2c0.dtbo pwm_ef.dtbo waveshare_tft24_lcd.dtbo
i2c1.dtbo pwm_ef-f.dtbo waveshare_tft35c_lcd.dtbo
pwm_ab.dtbo sdio.dtbo waveshare_tft35c_rtp.dtbo

:2. Update the overlays env in vfat /boot/boot.ini to enable what you want. Default i2c0, spi0 and uart1 enabled.

# Overlays to load
# Example combinations:
# spi0 i2c0 i2c1 uart0
# hktft32
# hktft35
setenv overlays "i2c0 spi0 uart1"

:3. Must be restart the board for overlay dtb loaded.

===WiringPi===
: Note: This WiringPi only support set 40pin gpio to output, input or software pwm, for io functions as i2c, spi, pwm..., you must enable dtb overlay in boot.ini

:1. Build and install wiringPi, for debian, you must [https://wiki.banana-pi.org/Getting_Started_with_M5/M2Pro#Enable_sudo_for_Debian install sudo] before build
$ sudo apt-get update
$ sudo apt-get install build-essential git
$ git clone https://github.com/BPI-SINOVOIP/amlogic-wiringPi
$ cd amlogic-wiringPi
$ chmod a+x build
$ sudo ./build

:2. Run '''gpio readall''' to show all 40pins status.
[[File:m5_wiringpi.png]]

:3. BPI GPIO Extend board and examples in [https://github.com/BPI-SINOVOIP/amlogic-wiringPi/tree/master/examples amlogic-wiringPi/examples]

:blinkall, blink all pin header gpios, no extend board.
:lcd-bpi, [http://wiki.banana-pi.org/BPI_LCD_1602_display_module BPI LCD 1602 display module] example.
:52pi-bpi, [http://wiki.banana-pi.org/BPI_OLED_Display_Module BPI OLED Display Module] example.
:matrixled-bpi, [http://wiki.banana-pi.org/BPI_RGB_LED_Matrix_Expansion_Module BPI RGB LED Matrix Expansion Module] example.
:berryclip-bpi, [http://wiki.banana-pi.org/BPI_BerryClip_Module BPI BerryClip Module]

===RPi.GPIO===

: Build and install, for debian, you must [https://wiki.banana-pi.org/Getting_Started_with_M5/M2Pro#Enable_sudo_for_Debian install sudo] before build
$ sudo apt-get update
$ sudo apt-get install build-essential python3 python3-pip python3-dev python3-setuptools git
$ git clone https://github.com/Dangku/RPi.GPIO-Amlogic.git
$ cd RPi.GPIO-Amlogic
$ sudo python3 setup.py clean --all
$ sudo python3 setup.py install

: Create and install wheel package
$ sudo python3 setup.py bdist_wheel
$ sudo pip3 install dist/RPi.GPIO-XXX.whl

: Install from git source directly without development
$ sudo pip3 install git+https://github.com/Dangku/RPi.GPIO-Amlogic.git

: If the package is already installed, it should be uninstalled before installing the new one, or installing the new one with --force-reinstall option.

===WiringPi2-Python===

: Build and install, for debian, you must [https://wiki.banana-pi.org/Getting_Started_with_M5/M2Pro#Enable_sudo_for_Debian install sudo] before build
$ sudo apt-get update
$ sudo apt-get install build-essential python3 python3-dev python3-setuptools swig git
$ git clone --recursive https://github.com/Dangku/WiringPi2-Python-Amlogic.git
$ cd WiringPi2-Python-Amlogic
$ sudo python3 setup.py install

===Luma.Examples===
:[https://github.com/rm-hull/luma.examples luma.examples] use GPIO.BCM gpio mode default, so you should map 40pin header pins to bcm gpio number and connect the hardware correctly.

:1. build and install RPi.GPIO

$ sudo apt-get update
$ sudo apt-get install build-essential python3 python3-dev python3-setuptools git
$ git clone https://github.com/Dangku/RPi.GPIO-Amlogic.git
$ cd RPi.GPIO-Amlogic
$ sudo python3 setup.py clean --all
$ sudo python3 setup.py install

:you can change the bcmledpin variable in test/led.py to your hardware backlight gpio and run it to check RPi.GPIO works well.

$ sudo python3 test/led.py

:hardware backlight will repeat on and off

:2. luma.examples libs install

$ sudo usermod -a -G i2c,spi,gpio pi

:if group does not exist, the following command will create it:

$ sudo groupadd --system xxx

$ sudo apt-get install python3-dev python3-pip libfreetype6-dev libjpeg-dev build-essential
$ sudo apt-get install libsdl-dev libportmidi-dev libsdl-ttf2.0-dev libsdl-mixer1.2-dev libsdl-image1.2-dev
$ git clone https://github.com/rm-hull/luma.examples.git
$ cd luma.examples

:install luma.core, luma.emulator, luma.lcd, luma.le-matrix, luma.oled pip libs, make sure this step without error or downloading interrupted, try again if get errors
$ sudo -H pip install -e .
:or
$ sudo -H pip3 install -e .

:for debian buster(python 3.7) which does not include /usr/bin/pip in package python3-pip, and will get the following errors when install luma packages with pip3

...
WARNING, No "Setup" File Exists, Running "buildconfig/config.py"
Using UNIX configuration...

/bin/sh: 1: sdl2-config: not found
/bin/sh: 1: sdl2-config: not found
/bin/sh: 1: sdl2-config: not found
...

:install sdl2 related packages to fix this issue, then install luma libs again with pip3
$ sudo apt-get install libsdl2-dev libsdl2-ttf-dev libsdl2-mixer-dev libsdl2-image-dev
$ sudo -H pip3 install -e .

:check installed luma pip libs
$ pip3 list | grep luma

luma.core 2.4.0
luma.emulator 1.4.0
luma.lcd 2.10.0
luma.led-matrix 1.7.0
luma.oled 3.11.0

:3. examples test
:Enable i2c or spi [https://wiki.banana-pi.org/Getting_Started_with_M5/M2Pro#DTB_overlay overlays] before running test examples
$ cd examples
$ sudo python3 bounce.py --config ../conf/ili9341.conf

===HDMI LCD===

:{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''Bananapi M5/M2pro Tested HDMI LCD'''
|-
|panel || /boot/boot.ini
|-
| [https://www.waveshare.com/3.5inch-hdmi-lcd.htm Waveshare 3.5inch 480x320] || setenv display_autodetect "false"
setenv hdmimode "480x320p60hz"
|-
| [https://www.waveshare.com/3.5inch-hdmi-lcd-e.htm Waveshare 3.5inch 640x480] ||
|-
| [https://www.waveshare.com/4inch-hdmi-lcd-c.htm Waveshare 4inch 720x720]
|-
| [https://www.waveshare.com/5inch-hdmi-amoled.htm Waveshare 5inch 960x544] ||
|-
| [https://www.waveshare.com/5inch-hdmi-lcd-h.htm Waveshare 5inch 800x480] ||
|-
| [https://www.waveshare.com/5.5inch-1440x2560-lcd.htm Waveshare 5.5inch 1440x2560] || setenv display_autodetect "false"
setenv hdmimode "1440x2560p60hz"
|-
| [https://www.waveshare.com/7inch-hdmi-lcd-b.htm Waveshare 7inch 800x480] ||
|-
| [https://www.waveshare.com/7inch-hdmi-lcd-c.htm Waveshare 7inch 1024x600] ||
|-
| [https://www.waveshare.com/7.9inch-HDMI-LCD.htm Waveshare 7.9inch 400x1280] ||
|-
| [https://www.waveshare.com/8inch-1536x2048-LCD.htm Waveshare 8inch 1536x2048] || setenv display_autodetect "false"
setenv hdmimode "1536x2048p60hz"
|-
| [https://www.waveshare.com/8.8inch-Side-Monitor.htm Waveshare 8.8inch 480x1920] ||
|-
| [https://www.waveshare.com/9inch-2560x1600-Monitor.htm Waveshare 9inch 2560x1600] || setenv display_autodetect "false"
setenv hdmimode "2560x1600p60hz"
|-
| [https://www.waveshare.com/10.1inch-HDMI-LCD-E.htm Waveshare 10.1inch 1024x600] ||
|-
| [https://www.waveshare.com/10.1inch-hdmi-lcd-b-with-case.htm Waveshare 10.1inch 1280x800] ||
|-
| [https://www.waveshare.com/11.9inch-HDMI-LCD.htm Waveshare 11.9inch 320x1480] ||
|-
| [https://www.waveshare.com/12.3inch-hdmi-lcd.htm Waveshare 12.3inch 1920x720] ||
|-
| [https://www.waveshare.com/13.3inch-HDMI-LCD-H.htm Waveshare 13.3inch 1920x1080] ||
|-
| [https://www.waveshare.com/15.6inch-hdmi-lcd-h-with-case.htm Waveshare 15.6inch 1920x1080] ||
|}

: backlight control

https://github.com/Dangku/Waveshare-USB-Brightness

===Boot Linux from USB drive===

:S905x3 is not support usb boot in soc rom, so the only way for booting linux from usb drive is create a bootable sdcard or emmc with bootloader flashed, then load boot and rootfs from usb drive. After bootup, everything will run from usb drive.

:1. The simple way is [https://wiki.banana-pi.org/Getting_Started_with_M5/M2Pro#Install_Image_to_SDcard flash the M5/M2Pro Linux image to sdcard or emmc] for bootable and also flash it to the usb drive for loading boot and rootfs.
:2. Bootup the M5/M2pro board with [https://wiki.banana-pi.org/Getting_Started_with_M5/M2Pro#Boot_Sequence sdcard or emmc], copy /boot/boot.ini to /boot/boot.ini.org so that bootloader load boot.ini fail and then try to load it from usb drive boot partition.
:3. Reboot the system, bootscript and rootfs will load from usb drive.
:[[File:m5_boot_from_usb.png]]

:4. Test performance
:You can verify the performance of your usb drive on Pi Benchmarks using the following command:
sudo curl https://raw.githubusercontent.com/TheRemote/PiBenchmarks/master/Storage.sh | sudo bash

:Test results for sd, emmc and usb drive
:{| class="wikitable"
|-
| Category || Test || Sdcard Test Result || Emmc Test Result || Usb Drive Test Result
|-
| HDParm || Disk Read || 67.91 MB/s || 156.64 MB/s || 253.40 MB/s
|-
| HDParm || Cached Disk Read || 57.39 MB/s || 126.53 MB/s || 253.52 MB/s
|-
| DD || Disk Write || 13.0 MB/s || 48.8 MB/s || 149 MB/s
|-
| FIO || 4k random read || 2456 IOPS (9826 KB/s) || 9701 IOPS (38806 KB/s) || 5474 IOPS (21897 KB/s)
|-
| FIO || 4k random write || 938 IOPS (3753 KB/s) || 12888 IOPS (51554 KB/s) || 6980 IOPS (27920 KB/s)
|-
| IOZone || 4k read || 10615 KB/s || 29568 KB/s || 23770 KB/s
|-
| IOZone || 4k write || 4276 KB/s || 33585 KB/s || 18598 KB/s
|-
| IOZone || 4k random read || 8661 KB/s || 29637 KB/s || 19982 KB/s
|-
| IOZone || 4k random write || 4795 KB/s || 38177 KB/s || 22134 KB/s
|-
| || || Score: 1300 || Score: 7811 || Score: 5879
|}

==Other Development==

===Custom Linux Boot Logo===
:Linux uboot limit boot logo fb size to 1080p60hz/1920x1080 default, so oversize resolution will not be supported by default image, but you can modify uboot source code to support it.

:1. Prepare a 24bit bmp file and named boot-logo.bmp
:2. Compress the bmp file to boot-logo.bmp.gz
$ gzip boot-logo.bmp
:3. copy the target file to BPI-BOOT partition of linux image
$ cp boot-logo.bmp.gz /media/xxx/BPI-BOOT/

===Custom Android Boot Logo===
:Android bootloader limit boot logo fb display size is 1080p60hz/1920x1080 default, and android kernel dtb partition table limit boot logo partition size to 16MB default .

:1. Prepare a 24bit bmp file and named boot-logo.bmp

:2. Compress the bmp file to boot-logo.bmp.gz
$ gzip boot-logo.bmp

:3. Download [https://download.banana-pi.dev/d/3ebbfa04265d4dddb81b/files/?p=%2FTools%2Flogo_create_tools%2Fm5_android_bootlogo_tool.zip m5_android_bootlogo_tool.zip]

:4. Extract this tool
$ unzip m5_android_bootlogo_tool.zip
$ cd m5_android_bootlogo_tool/
$ cp -a logo_img_files logo //logo_img_files is the origin bootlogo resource in android source and copy from <android-source-dir>/devices/amlogic/bananapi_m5/log_img_files
$ ls -l logo/
-rwxr--r-- 1 dangku dangku 525054 Sep 25 16:54 bootup.bmp
-rwxr--r-- 1 dangku dangku 525054 Sep 25 16:54 bootup_X3.bmp
-rwxr--r-- 1 dangku dangku 184 May 19 2020 upgrade_bar.bmp
-rwxr--r-- 1 dangku dangku 180072 May 19 2020 upgrade_error.bmp
-rwxr--r-- 1 dangku dangku 180072 May 19 2020 upgrade_fail.bmp
-rwxr--r-- 1 dangku dangku 180072 May 19 2020 upgrade_logo.bmp
-rwxr--r-- 1 dangku dangku 180072 May 19 2020 upgrade_success.bmp
-rwxr--r-- 1 dangku dangku 184 May 19 2020 upgrade_unfocus.bmp
-rwxr--r-- 1 dangku dangku 180072 May 19 2020 upgrade_upgrading.bmp

:5. Copy the boot-logo.bmp.gz
$ cp boot-logo.bmp.gz logo/bootup.bmp
$ cp boot-logo.bmp.gz logo/bootup_X3.bmp

:6. Create target logo.img with img pack tool, the binary and related libs of m5_android_bootlogo_tool are copy from <android-source-dir>/out/host/linux-x86
$ ./logo_img_packer -r logo logo.img

:7. Flash boot logo with fastboot
$ adb root
$ adb remount
$ adb reboot fastboot
:Wait few seconds and check whether fastboot connected
$ fastboot device
1234567890 fastboot
$ fastboot flashing unlock_critical
$ fastboot flashing unlock
$ fastboot flash logo logo.img
$ fastboot reboot

===Boot Sequence===

:[[File:m5_linux_boot_squence.png]]

:Check bootloader loaded from SDcard or EMMC at the beginning of the console debug messages

:1. Rom load bootloader from SDcard (Linux log example)
...

BL2 Built : 15:21:42, Mar 26 2020. g12a g486bc38 - gongwei.chen@droid11-sz

Board ID = 1
Set cpu clk to 24M
Set clk81 to 24M
Use GP1_pll as DSU clk.
DSU clk: 1200 Mhz
CPU clk: 1200 MHz
Set clk81 to 166.6M
board id: 1
'''Load FIP HDR DDR from SD''', src: 0x00010200, des: 0xfffd0000, size: 0x00004000, part: 0
fw parse done
PIEI prepare done
fastboot data verify
result: 255
Cfg max: 12, cur: 1. Board id: 255. Force loop cfg
DDR4 probe

...

:2. Rom load bootloader from EMMC(Android Log example)

...

Board ID = 1
Set cpu clk to 24M
Set clk81 to 24M
Use GP1_pll as DSU clk.
DSU clk: 1200 Mhz
CPU clk: 1200 MHz
Set clk81 to 166.6M
eMMC boot @ 0
sw8 s
board id: 1
'''Load FIP HDR DDR from eMMC''', src: 0x00010200, des: 0xfffd0000, size: 0x00004000, part: 0
fw parse done
PIEI prepare done
00000000
emmc switch 1 ok
ddr saved addr:00016000
Load ddr parameter from eMMC, src: 0x02c00000, des: 0xfffd0000, size: 0x00001000, part: 0
00000000

...

===Erase EMMC for SDcard Bootup===
:There are four possible scenarios should be pay attention to, EMMC already flashed Android image, EMMC already flashed Linux image, boot process hangup in BL2 and EMMC empty.

:1. Bootable EMMC with Android image flashed

::a). Using usb burning tool, unplug the download usb cable while the download process at '''7% formatting'''

::[[File:m5_android_format.png]]

::b). Using Android Fastboot tool, make sure the adb/fastboot tools is work on your PC before doing this.

root@dangku-desktop:/tmp# '''adb root'''
adbd is already running as root
root@dangku-desktop:/tmp# '''adb remount'''
remount succeeded
root@dangku-desktop:/tmp# '''adb shell'''
bananapi_m5:/ # '''reboot fastboot'''
::Wait a few seconds for board reboot to fastboot mode
root@dangku-desktop:/tmp# '''fastboot devices'''
1234567890 fastboot
root@dangku-desktop:/tmp# '''fastboot flashing unlock_critical'''
...
OKAY [ 0.044s]
finished. total time: 0.044s
root@dangku-desktop:/tmp# '''fastboot flashing unlock'''
...
OKAY [ 0.047s]
finished. total time: 0.047s
root@dangku-desktop:/tmp# '''fastboot erase bootloader'''
erasing 'bootloader'...
OKAY [ 0.059s]
finished. total time: 0.059s
root@dangku-desktop:/tmp# '''fastboot erase bootloader-boot0'''
erasing 'bootloader-boot0'...
OKAY [ 0.036s]
finished. total time: 0.036s
root@dangku-desktop:/tmp# '''fastboot erase bootloader-boot1'''
erasing 'bootloader-boot1'...
OKAY [ 0.035s]
finished. total time: 0.035s

::c). Using uboot command, connect a debug console cable and press ESC while power on to enter uboot command line

bananapi_m5_v1#'''amlmmc erase 1'''
emmckey_is_protected(): protect
start = 0,end = 57343
start = 221184,end = 30535679
Erasing blocks 0 to 8192 @ boot0
start = 0,end = 8191
Erasing blocks 0 to 8192 @ boot1
start = 0,end = 8191
bananapi_m5_v1#'''reset'''
resetting ...
SM1:BL:511f6b:81ca2f;FEAT:A0F83180:20282000;POC:F;RCY:0;EMMC:0;READ:0;CHK:1F;READ:0;CHK:1F;READ:0;CHK;

::These two ways actually erase the bootloader part of EMMC android, After bootup from SDcard Linux, You'd better [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Erase_Emmc_Android_by_dd_command format the whole EMMC by dd command].

::d). The simplest way is insert the SDcard with Linux image flashed before power on, the Android bootloader will check boot.ini file whether exist in SDcard vfat partition, so that the SDcard Linux will bootup. After bootup, you can [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Erase_Emmc_Android_by_dd_command format the whole EMMC by dd command] and then flash the Linux image to EMMC.

...
BPI: try boot from sdcard
reading boot.ini
5699 bytes read in 3 ms (1.8 MiB/s)
## Executing script at 01b00000
...
reading Image.gz
9143358 bytes read in 510 ms (17.1 MiB/s)
reading meson64_bananapi_m5.dtb
70850 bytes read in 8 ms (8.4 MiB/s)
reading uInitrd
11704481 bytes read in 655 ms (17 MiB/s)
reading overlays/i2c0.dtbo
223 bytes read in 6 ms (36.1 KiB/s)
reading overlays/spi0.dtbo
516 bytes read in 6 ms (84 KiB/s)
reading overlays/uart1.dtbo
225 bytes read in 5 ms (43.9 KiB/s)

:2. Bootable EMMC with Linux image flashed

::a). Using uboot command, connect a debug console cable and press ESC while power on to enter uboot command line

bananapi_m5# mmc erase 0 1000

::b). Linux u-boot also check boot.ini file whether exist in SDcard vfat partition so that the SDcard Linux will bootup. After bootup, you can format the whole EMMC by dd command or flash the Linux image directly to EMMC.

:3. A extreme situation is bootloader or uboot corrupted, Rom load it from EMMC but hangup in u-boot or BL2, for example the boot process will hangup in BL2 of EMMC if dram init failed, The only way is format the EMMC with usb burning tool, or download the Android image completely and then try other ways to erase EMMC or flash Linux image to EMMC.

:4. Rom will try to load bootloader from SDcard directly if EMMC is empty.

===Erase Emmc Android by dd command===
:If the board is flashed android before, the whole emmc must be erased by these commands if you want bootup it with SDcard Linux image.
$ sudo dd if=/dev/zero of=/dev/mmcblk0boot0 bs=1M status=noxfer
$ sudo dd if=/dev/zero of=/dev/mmcblk0boot1 bs=1M status=noxfer
$ sudo dd if=/dev/zero of=/dev/mmcblk0 bs=1M status=noxfer
$ sync

===Wifi/BT support===

:1. Android test and support.
rtl8723bu wifi/bt(usb)
rtl8188eu wifi(usb)
[http://forum.banana-pi.org/t/banana-pi-wifi-bt-4-2-expansion-board-standard-usb-interface/12162 rtl8821cu wifi/bt(usb)]
[http://forum.banana-pi.org/t/bpi-m5-wifi-bt-board-sdio-interface-802-11-a-b-g-n-ac-2t2r-wifi-and-bluectooch-5-0/11846 rtl8822cs wifi/bt(sdio/uart)]
rtl8814au wifi(usb), please get the [https://github.com/aircrack-ng/rtl8814au aircrack-ng] driver and install.

:'''How to enable Android Wifi/BT'''

:USB type: Plug-in the usb dongle to usb host port and reboot the system, After bootup, you can enable or disable wifi and bluetooth in Settings app.
:SDIO/UART type: Connect the hardware module to 40pin header correctly and [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5/M2Pro#Android_DTB_overlay configure the Android DTB overlay] to enable it.

:'''Note''': Android is not support that ethernet and wifi are both connected at the same time, Ethernet have a higher prioprity than wifi, it means wifi can't connect network if ethernet already connected, and wifi will drop connection if ethernet cable plugin.

:2. Linux test and support.
rtl8188eu wifi(usb)
rtl8192eu wifi(usb)
rtl8723bu wifi/bt(usb)
rtl8811au wifi(usb)
rtl8812au wifi(usb)
rtl8812bu wifi(usb)
[http://forum.banana-pi.org/t/banana-pi-wifi-bt-4-2-expansion-board-standard-usb-interface/12162 rtl8821cu wifi/bt(usb)]
[http://forum.banana-pi.org/t/bpi-m5-wifi-bt-board-sdio-interface-802-11-a-b-g-n-ac-2t2r-wifi-and-bluectooch-5-0/11846 rtl8822cs wifi/bt(sdio/uart)]

:'''How to enable Linux Wifi'''

:Wifi module drivers are already prebuild in the release images.

:USB type: Plug-in the usb dongle to usb host port and driver will be loaded automatically.
:SDIO/UART type:
::1). Connect the hardware module to 40pin header correctly.
::2). Configure the [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5/M2Pro#DTB_overlay dtb overlay]
# Overlays to load
# Example combinations:
# spi0 i2c0 i2c1 uart0
# hktft32
# hktft35
setenv overlays "wifi_bt_rtl8822cs"
::3). Add the wifi module name to /etc/modules for loaded automatically next boot.
# This file contains the names of kernel modules that should be loaded
# at boot time, one per line. Lines beginning with "#" are ignored.
88x2cs

:'''How to enable Linux Bluetooth'''

::1). Please download [https://github.com/Dangku/m5-rtk-linux-bt-driver rtk-linux-bt-driver] source code, build and install usb or uart rtk linux bluetooth drivers/firmwares to your image.
::2). For USB type, plug-in the usb dongle to usb host port and driver will be loaded automatically.
::3). For UART type, Configure the dtb overlay as the same as wifi before install the bluetooth drivers/firmwares. hci_uart driver will be loaded when rtk-hciuart.service start.

===Linux Server Image Network Configuration===

:[https://netplan.io Netplan]

:'''Linux Wifi STA mode'''

:A sample wifi sta mode netplan configuration file, 01-wlan0-sta.yaml
network:
version: 2
renderer: networkd
wifis:
wlan0:
dhcp4: true
access-points:
"bananapi":
password: "123456789"

:'''Linux Wifi AP mode'''

:1. Prepare the setup the [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Wifi.2FBT_support wifi adater] correctly.

:2. Get the wifi adapter Band, Frequencies, Channel, HT Capability, VHT Capability or other properties
$ iw list

:3. Manage wifi access point mode with [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Linux_Server_Image_Network_Configuration Netplan] and Network-Manager.

:Install NetworkManager because ap is only supported with NetworkManager renderer
$ sudo apt install network-manager

:A sample 2.4G wifi ap mode netplan configuration file, 01-wlan0-ap-2.4g.yaml
network:
version: 2
renderer: NetworkManager
wifis:
wlan0:
dhcp4: no
access-points:
"bananapi":
mode: ap
band: 2.4GHz
channel: 6
auth:
key-management: psk
password: "123456789"

:A sample 5G wifi ap mode netplan configuration file, 01-wlan0-ap-5g.yaml
network:
version: 2
renderer: NetworkManager
wifis:
wlan0:
dhcp4: no
access-points:
"bananapi":
mode: ap
band: 5GHz
channel: 36
auth:
key-management: psk
password: "123456789"

:4. Manage wifi access point mode with [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Linux_Server_Image_Network_Configuration Netplan] and Hostapd.

:1). Create a netplan configuration file, 01-wlan0-ap-hostapd.yaml
network:
version: 2
renderer: networkd
ethernets:
wlan0:
dhcp4: no
addresses:
- 192.168.11.1/24

:2). Install hostapd
$ sudo apt install hostapd

:Create hostapd configuration file /etc/hostapd/hostapd.conf, for example
interface=wlan0
ssid=bananapi

driver=nl80211

auth_algs=1
wpa=2
wpa_passphrase=123456789
wpa_key_mgmt=WPA-PSK
rsn_pairwise=CCMP

#bridge=br0
beacon_int=500
#SSID not hidden
ignore_broadcast_ssid=0

hw_mode=a
channel=36
max_num_sta=8

### IEEE 802.11n
ieee80211n=1
#require_vht=0
ht_capab=[HT20][HT40+][SHORT-GI-20][SHORT-GI-40][SHORT-GI-80][DSSS_CCK-40]

### IEEE 802.11ac
ieee80211ac=1
#require_vht=0
#vht_capab=[MAX-MPDU-3895][SHORT-GI-80][SU-BEAMFORMEE]
#vht_oper_chwidth=1
#vht_oper_centr_freq_seg0_idx=42

### WMM
wmm_enabled=1

:3). To support 80MHz channel width you need load driver with '''rtw_vht_enable=2''' option, Or you can create /etc/modprobe.d/8822cs.conf with content
options 88x2cs rtw_vht_enable=2

:4). Install and configure dhcp server service, use isc-dhcp-server for example

$ sudo apt install isc-dhcp-server

:Configure dhcp server interface in /etc/default/isc-dhcp-server
# On what interfaces should the DHCP server (dhcpd) serve DHCP requests?
# Separate multiple interfaces with spaces, e.g. "eth0 eth1".
INTERFACESv4="wlan0"

:Configure dhcp subnet and dns in /etc/dhcp/dhcpd.conf
...
option domain-name "example.org";
option domain-name-servers 8.8.8.8, 114.114.114.114;
...
# No service will be given on this subnet, but declaring it helps the
# DHCP server to understand the network topology.
subnet 192.168.11.0 netmask 255.255.255.0 {
range dynamic-bootp 192.168.11.1 192.168.11.100;
option broadcast-address 192.168.11.255;
option routers 192.168.11.1;
}

:5). Start Service
$ sudo hostapd /etc/hostapd/hostapd.conf -B
$ sudo systemctl restart isc-dhcp-server

:6). Routing configuration.
sysctl net.ipv4.ip_forward=1
iptables -t nat -A POSTROUTING -s 192.168.11.0/24 -o eth0 -j MASQUERADE

===Disable Cloud-init&Snap===
:Cloud-init and Snap service are enabled default, you can disable or remove them.

:1. disable or remove cloud-init
$ sudo touch /etc/cloud/cloud-init.disabled
:or
$ sudo apt purge cloud-init

:2. disable or remove snap
$ sudo apt purge snapd

===Enable rc-local===
:The systemd service rc-local.service already exists in release image, but there is no [Install] part in the unit file. As a result, Systemd is unable to enable it. First, we must update the file.

$ sudo nano /lib/systemd/system/rc-local.service

[Unit]
Description=/etc/rc.local Compatibility
Documentation=man:systemd-rc-local-generator(8)
ConditionFileIsExecutable=/etc/rc.local
After=network.target

[Service]
Type=forking
ExecStart=/etc/rc.local start
TimeoutSec=0
RemainAfterExit=yes
GuessMainPID=no

[Install]
WantedBy=multi-user.target
Alias=rc-local.service

:Create /etc/rc.local file.

sudo nano /etc/rc.local

#!/bin/sh
#
# rc.local
#
# This script is executed at the end of each multiuser runlevel.
# Make sure that the script will "exit 0" on success or any other
# value on error.
#
# In order to enable or disable this script just change the execution
# bits.
#
# By default this script does nothing.

exit 0

:Add executable permission to /etc/rc.local

$ sudo chmod +x /etc/rc.local

:Enable rc-local.service and reboot

$ sudo systemctl enable rc-local.service
$ sudo reboot

===Enable sudo for Debian===
:The release Debian image do not install sudo default, with "su -" command, user can change to root. If you like sudo, you can install it.

$ su root
Password:(enter bananapi)

# apt-get update
# apt-get install sudo
# adduser pi sudo

: Then please do logout and login again

===Install Docker Engine===
:Install Docker Engine on Ubuntu 20.04 Server

:1. Set up the repository

:Update the apt package index and install packages to allow apt to use a repository over HTTPS:
$ sudo apt-get update
$ sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release

:Add Docker’s official GPG key:
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

:Set up the stable repository
$ echo \
"deb [arch=arm64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

:2. Install Docker Engine
$ sudo apt-get update
$ sudo apt-get install docker-ce docker-ce-cli containerd.io

:3. Verify the Docker Engine is installed correctly by running the hello-world image.
$ sudo docker run hello-world

:[[File:docker-test.png]]

Install docker with a simple command

$ curl -sSL get.docker.com | sudo sh

[https://docs.docker.com/engine/install/ Install Docker Engine] on other Linux distributions

Getting Started with M5/M2Pro

2023-08-04T07:14:00Z

Qubot: /* Wifi/BT support */

=Introduction=
[[File:Banana_Pi_BPI-M5_4.JPG|thumb|[[Banana Pi BPI-M5]]]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|Amlogic S905X3 Processor]]
[[File:Banana_Pi_BPI-M5_2.jpg|thumb|Amlogic S905X3 Processor]]

Banana Pi M5 is a new generation single board computer design , use Amlogic S905X3 Quad-Core Cortex-A55 (2.0xxGHz) Processor. Mali-G31 MP2 GPU with 4 x Execution Engines (650Mhz). support 4GB LPDDR4 and 16G eMMC flash. it have 4 USB 3.0 port,1GbE LAN port, IR Reciver, Audio Jack, 1 HDMI Out and USB type-c power supply.

Banana Pi M2Pro is the same SOC with M5, but different board layout. 2GB LPDDR4 and 16G eMMC flash, 2 USB 3.0 port,1GbE LAN port, rtl8821cu usb wifi/bt onboard, IR Reciver, 1 HDMI Out, 1 MicroUSB port, DC power supply.

=specifications=

*SoC – Amlogic S905X3 quad-core Cortex-A55 processor @ up to 2.0 GHz with
*Mali-G31 MP2 GPU @ 650Mhz
*System Memory – 4GB LPDDR4
*Storage – 16GB eMMC flash (option up to 64GB), MicroSD slot up to 2TB
*Video Output – HDMI 2.1 up to 4Kp60 with HDR, CEC, EDID
*Audio – 3.5mm audio jack, digital HDMI audio
*Connectivity – Gigabit Ethernet
*USB – 4x USB 3.0 ports via VL817 hub controller, 1x USB-C port (for power only?)
*Expansion – 40-pin Raspberry Pi header with 28x GPIO, UART, I2C, SPI, PWM, and power signal (+5V, +3.3V, GND).
*Debugging – 3-pin debug header
*Misc – Reset, Power, and U-boot button; power and activity LED’s; IR receiver
*Power Supply – 5V @3A via USB Type-C port
*Dimensions – 92x60mm (Not the same as Raspberry Pi PCB size, but they probably included the connectors during measurement)
*Weight – 48grams

=development=

==Prepare==
:1. Prepare a usb-serial cable, a 5V/3A adaptor type-c power supply. The serial cable is used for console debug and type-c cable is used for android image download and ADB debug. M2pro is used Micro-usb port for android image download and ADB debug.
:2. Prepare a SDcard at least 8GB for linux development, android only support emmc boot.
:3. The SOC rom first boot media is emmc, so board can't bootup from SDcard if the emmc is bootable with any image flashed, more info please refer to board [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Boot_Sequence boot sequence].
:4. In Android SDcard is mmc0, emmc is mmc1, but in Linux SDcard is mmc1, emmc is mmc0.

==Android==
===Prepare===

:1. Download and install the [https://download.banana-pi.dev/d/3ebbfa04265d4dddb81b/files/?p=%2FTools%2Fimage_download_tools%2Faml_usb_burning_tool_V2_setup_v2.2.3.3.zip AML Usb Burning Tool] for android image download via USB type-c on M5 and Micro-usb on M2pro, only support windows.
:2. Download the latest [http://wiki.banana-pi.org/Banana_Pi_BPI-M5#Android_2 android image], and confirm that the md5 checksum is correct.
:3. M5 and M2pro are compatiable with same android image.

===Install Image with Usb Burning Tool===

:1. Open USB_Burning_Tool.exe, select menu File->Import image, choose the android image file aml_upgrade_package.img.

:[[File:m5_android_install_1.png]]

:2. M5/M2pro board disconnect power, press and hold SW4 button beside 40pin header, plugin type-c usb cable(microUSB on m2pro) to PC

:[[File:m5_android_install_2.png]]

:3. Click the Start button and wait for upgrade complete.

:[[File:m5_android_install_3.png]]

:4. After Burning successfull, Unplug the usb and connect to power supply adaptor to startup.

:[[File:m5_android_install_4.png]]

:5. Click the Stop button to cancel the upgrade process and close the USB Buring Tool.

===Install Image with Aml Flash Tool===
:[https://github.com/Dangku/aml-flash-tool aml-flash-tool] is a linux platform opensource image flash util for Amlogic android.

$ ./flash-tool.sh --img=/path/to/aml_upgrade_package.img --parts=all --wipe --soc=g12a --reset=y

:[[File:m5_linux_flash.PNG]]

===Build Android Source Code===
:1. Get Android 9.0 source code

$ git clone https://github.com/BPI-SINOVOIP/BPI-S905X3-Android9

:or you can get the source code tar archive from [https://pan.baidu.com/s/1TmmR_075b49lPSt1Phq0ag?pwd=8888 Baidu Pan(pincode: 8888)] or [https://drive.google.com/drive/folders/1RuvazYcr46HKMvNBxSqQftdyWa0tK9f7?usp=share_link Google Drive]

:2. Build the Android 9.0 Source code

:Please read the source code [https://github.com/BPI-SINOVOIP/BPI-S905X3-Android9/blob/master/README.md README.md]

===Android DTB overlay===

:Bananapi M5/M2Pro DTBO idx value table, default idx value is 0 in release image.

:{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''Bananapi M5/M2pro DTBO idx value table'''
|-
|idx value|| device tree overlay || description
|-
| 0|| android_p_overlay|| default dtbo, no use
|-
| 1|| wifi_bt_rtl8822cs|| enable bpi rtl8822cs wifi/bt module
|-
| 2|| i2c2|| enable i2c 2
|-
| 3|| i2c3|| enable i2c 3
|-
| 4|| sdio|| enable sdio
|-
| 5|| uart1|| enable 2 pins uart 1
|-
| 6|| uart1_cts_rts|| enable 4 pins uart 1
|-
| 7|| uart2|| enable 2 pins uart 2
|-
| 8|| hifi_pcm5122|| enable i2s [https://shumeipai.nxez.com/hifidac-hat-for-raspberry-pi pcm5122 HiFi DAC]
|}

:'''How to apply a new dtbo'''

:1. ADB command via sysfs

root@dangku-desktop:/tmp# adb root
restarting adbd as root
root@dangku-desktop:/tmp# adb remount
remount succeeded
root@dangku-desktop:/tmp# adb shell
bananapi_m5:/ # echo dtbo > /sys/class/unifykeys/name
bananapi_m5:/ # echo "1" > /sys/class/unifykeys/write
bananapi_m5:/ # reboot

:2. Uart console command via sysfs

console:/ $
console:/ $ su
console:/ # echo dtbo > /sys/class/unifykeys/name
[ 115.702781@0] unifykey: name_store() 1302, name dtbo, 4
[ 115.702856@0] unifykey: name_store() 1311
console:/ #
console:/ # echo "1" > /sys/class/unifykeys/write
[ 129.262659@0] unifykey: write_store() is a string
[ 129.262733@0] unifykey: dtbo, 1, 1
[ 129.265312@0] unifykey: amlkey_write 393
[ 129.292347@1] emmc_key_write:149, write ok
console:/ #
console:/ # reboot

:3. Settings App(To-Do)

:Check the bootup uart debug message and confirm which dtbo is loaded actually, here "1" means set idx=1 to apply wifi_bt_rtl8822cs dtbo.

load dtb from 0x1000000 ......
Amlogic multi-dtb tool
Single dtb detected
find 2 dtbos
dtbos to be applied: 1
Apply dtbo 1

:Unifykeys is stored in a specific emmc part, "Normal erase" selected in USB_Burning_Tool will not erase this data for next update, you must select "Erase all" if you want the default dtbo idx to be applied after image download.

:[[File:m5_android_erase_all.png]]

:'''Build Android image with a specific DTBO default'''.

:1. Default build-in overlays are defined in device/amlogic/bananapi_m5/Kernel.mk, you can add a new overlay dtbo here.
DTBO_DEVICETREE := android_p_overlay wifi_bt_rtl8822cs i2c2 i2c3 sdio uart1 uart1_cts_rts uart2 hifi_pcm5122

:2. Default apply DTBO idx is defined in device/amlogic/bananapi_m5/BoardConfig.mk, you can change the idx value to set which overlay dtbo will be applied default.
BOARD_KERNEL_CMDLINE += androidboot.dtbo_idx=0

:3. DTS files are in common/arch/arm/boot/dts/amlogic/overlay/bananapi_m5/

:More info about android device tree overlays, please refer to [https://source.android.com/devices/architecture/dto google android offical site]

===Install OpenGapps===

:1. Download install package from [https://opengapps.org/ OpenGapps], Android release image is arm/android 9.0 variant.

[[File:opengapps.PNG]]

:2. Download [https://download.banana-pi.dev/d/ca025d76afd448aabc63/files/?p=%2FTools%2Fapps%2Fdevice_id_v1.3.2.apk device_id.apk].
:3. Copy the OpenGapp package to a udisk or sdcard root directory.
:4. Create a txt file named '''factory_update_param.aml''' in udisk or sdcard root directory with the following android recovery parameter content, and replace the file name with the actual downloaded package.
::udisk:
--wipe_cache
--update_package=/udisk/open_gapps-arm-9.0-pico-20210327.zip

::sdcard:
--wipe_cache
--update_package=/sdcard/open_gapps-arm-9.0-pico-20210327.zip

:5. Plugin the udisk or sdcard to the board and poweron.

:6.OpenGapps install and certify.
:<youtube>fXOKmWfpqF8</youtube>
:watch this video on [https://www.bilibili.com/video/BV13y4y1s77i/ bilibili]

===IR Remote Control Custom===
:Before starting this work, some android basic concepts and knowledge need to be known.

:*Linux kernel input key event.
:*Android keycode.
:*Linux keycode map to android keycode.
:*Android Adb function work on your PC

:1. pull the remote files from device
# adb pull /vendor/etc/remote.cfg
# adb pull /vendor/etc/remote.tab

:2. modify remote.cfg to enable remote debug message
:[[File:remotecfg.png]]

:push remote.cfg back

# adb root
# adb remount
# adb push remote.cfg /vendor/etc/
# adb shell
m5_mbox:/ # chmod 644 /vendor/etc/remote.cfg
m5_mbox:/ # remotecfg -c /vendor/etc/remote.cfg -d
cfgdir = /vendor/etc/remote.cfg
work_mode = 1
repeat_enable = 0
debug_enable = 1
max_frame_time = 1000

:3. Get the remote keycode
:Press your remote key one by one and then print the dmesg to get the remote custom_code and each remote key code.

# adb shell dmesg | grep framecode=
:[[File:keycode.png]]

:custom_code = 0xfe01
:keycode = 0x00, 0x01, 0x09, 0x02, 0x0a, 0x05, 0x04 0x06, 0x03, 0x0b, 0x40, 0x48, 0x44

:4. Modify remote.tab to map the scancode to android keycode
:[[File:remotetab.png]]

:push remote.tab and test each key whether works

# adb root
# adb remount
# adb push remote.tab1 /vendor/etc/
# adb shell
m5_mbox:/ # chmod 644 /vendor/etc/remote.tab
m5_mbox:/ # remotecfg -c /vendor/etc/remote.cfg -t /vendor/etc/remote.tab -d
cfgdir = /vendor/etc/remote.cfg
work_mode = 1
repeat_enable = 0
debug_enable = 1
max_frame_time = 1000
tabdir = /vendor/etc/remote.tab
custom_name = nec-test
fn_key_scancode = 0xffff
cursor_left_scancode = 0xffff
cursor_right_scancode = 0xffff
cursor_up_scancode = 0xffff
cursor_down_scancode = 0xffff
cursor_ok_scancode = 0xffff
custom_code = 0xfe01
release_delay = 80
map_size = 13
key[0] = 0x74
key[1] = 0x1008b
key[2] = 0x90066
key[3] = 0x20069
key[4] = 0xa006a
key[5] = 0x50067
key[6] = 0x4006c
key[7] = 0x6001c
key[8] = 0x30072
key[9] = 0xb0073
key[10] = 0x40009e
key[11] = 0x4800a4
key[12] = 0x440071

:5. Reboot the board

==Linux==
===Prepare===
:1. Linux image support SDcard or EMMC bootup, but you should read the [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Boot_Sequence boot sequence] at first.

:2. It’s recommended to use A1 rated cards, 8GB at least.

:3. M5 and M2pro are compatiable with same Linux image.

:4. Make sure bootable EMMC is formatted if you want bootup from SDcard, more info refer to [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Erase_EMMC_for_SDcard_Bootup Erase EMMC for SDcard Bootup]

:5. Make sure SDcard is formatted without Linux image flashed if you want bootup from EMMC and use Sdcard as storage.

:6. Install bpi-tools on your Linux PC(if [https://wiki.banana-pi.org/Getting_Started_with_M5/M2Pro#Install_Image_to_SDcard flash image] with other tools, ignore this step). If you can't access this URL or any other install problem, please go to [https://github.com/bpi-sinovoip/bpi-tools bpi-tools] source repo, download and install this tools manually.
$ apt-get install pv
$ curl -sL https://github.com/BPI-SINOVOIP/bpi-tools/raw/master/bpi-tools | sudo -E bash

:7. Download latest [http://wiki.banana-pi.org/Banana_Pi_BPI-M5#Linux Linux Image], and confirm that the md5 checksum is correct.

:8. Default login: pi/bananapi or root/bananapi

:9. The wiki guide is only for [https://wiki.banana-pi.org/Banana_Pi_BPI-M5#Linux bananapi 4.9 bsp ubuntu/debian images].

===Install Image to SDcard===
:1. Install Image with Balena Etcher on Windows, Linux and MacOS.
:[https://balena.io/etcher Balena Etcher] is an opensource GUI flash tool by Balena, Flash OS images to SDcard or USB drive

:[[File:m2s_linux_flash.png]]

:2. Install Image with Balena Cli on Windows, Linux and MacOS.
:[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.

$ sudo balena local flash path/to/xxx-bpi-m5-xxx.img.zip
$ sudo balena local flash path/to/xxx-bpi-m5-xxx.img.zip --drive /dev/disk2
$ sudo balena local flash path/to/xxx-bpi-m5-xxx.img.zip --drive /dev/disk2 --yes

: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.
$ sudo apt-get install pv unzip
$ sudo unzip -p xxx-bpi-m5-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
$ sudo apt-get install pv unzip
$ sudo bpi-copy xxx-bpi-m5-xxx.img.zip /dev/sdX

===Install Image to EMMC===
:1. Prepare a [https://wiki.banana-pi.org/Getting_Started_with_BPI-M5/M2Pro#Install_Image_to_SDcard SDcard with Linux image] flashed and bootup board with this SDcard.

:2. Copy Linux image to udisk, plug the udisk to board and mount it.

:3. There are two ways to install the linux image to board.
3.1 Install with dd command, umount mmcblk0p1 and mmcblk0p2 partition if mounted automatically. Actually bpi-copy is the same as this dd command.
$ sudo apt-get install pv unzip
$ sudo unzip -p xxx-bpi-m5-xxx.img.zip | pv | dd of=/dev/mmcblk0 bs=10M status=noxfer

3.2 Install the linux image in udisk with bpi-tools command
$ sudo apt-get install pv unzip
$ sudo bpi-copy xxx-bpi-m5-xxx.img.zip /dev/mmcblk0

:4. After download complete, power off safely and eject the SDcard.

===Build Linux Source Code===
:1. Get the Linux bsp source code
$ git clone https://github.com/BPI-SINOVOIP/BPI-M5-bsp
:2. Build the bsp source code

::Please read the source code [https://github.com/BPI-SINOVOIP/BPI-M5-bsp/blob/master/README.md README.md]

:3. If you want build uboot and kernel separately, please download the [https://github.com/Dangku/amlogic-u-boot/tree/odroidg12-v2015.01-c4-m5 u-boot] the [https://github.com/Dangku/amlogic-linux/tree/odroidg12-4.9.y-c4-m5 kernel] only, get the toolchains, boot script and other configuration files from [https://github.com/BPI-SINOVOIP/BPI-M5-bsp BPI-M5-bsp]

===DTB overlay===
:1. DTB overlay is used for 40pin gpios multi-function configuration and install in vfat boot partition, you can check the mount point with mount command.
root@bananapi:~# ls /boot/overlays/
custom_ir.dtbo pwm_b-backlight.dtbo spi0.dtbo
ds3231.dtbo pwm_c-beeper.dtbo uart1_cts_rts.dtbo
hifi_pcm5102a.dtbo pwm_cd-c.dtbo uart1.dtbo
hifi_pcm5122.dtbo pwm_cd.dtbo uart2.dtbo
i2c0.dtbo pwm_ef.dtbo waveshare_tft24_lcd.dtbo
i2c1.dtbo pwm_ef-f.dtbo waveshare_tft35c_lcd.dtbo
pwm_ab.dtbo sdio.dtbo waveshare_tft35c_rtp.dtbo

:2. Update the overlays env in vfat /boot/boot.ini to enable what you want. Default i2c0, spi0 and uart1 enabled.

# Overlays to load
# Example combinations:
# spi0 i2c0 i2c1 uart0
# hktft32
# hktft35
setenv overlays "i2c0 spi0 uart1"

:3. Must be restart the board for overlay dtb loaded.

===WiringPi===
: Note: This WiringPi only support set 40pin gpio to output, input or software pwm, for io functions as i2c, spi, pwm..., you must enable dtb overlay in boot.ini

:1. Build and install wiringPi, for debian, you must [https://wiki.banana-pi.org/Getting_Started_with_M5/M2Pro#Enable_sudo_for_Debian install sudo] before build
$ sudo apt-get update
$ sudo apt-get install build-essential git
$ git clone https://github.com/BPI-SINOVOIP/amlogic-wiringPi
$ cd amlogic-wiringPi
$ chmod a+x build
$ sudo ./build

:2. Run '''gpio readall''' to show all 40pins status.
[[File:m5_wiringpi.png]]

:3. BPI GPIO Extend board and examples in [https://github.com/BPI-SINOVOIP/amlogic-wiringPi/tree/master/examples amlogic-wiringPi/examples]

:blinkall, blink all pin header gpios, no extend board.
:lcd-bpi, [http://wiki.banana-pi.org/BPI_LCD_1602_display_module BPI LCD 1602 display module] example.
:52pi-bpi, [http://wiki.banana-pi.org/BPI_OLED_Display_Module BPI OLED Display Module] example.
:matrixled-bpi, [http://wiki.banana-pi.org/BPI_RGB_LED_Matrix_Expansion_Module BPI RGB LED Matrix Expansion Module] example.
:berryclip-bpi, [http://wiki.banana-pi.org/BPI_BerryClip_Module BPI BerryClip Module]

===RPi.GPIO===

: Build and install, for debian, you must [https://wiki.banana-pi.org/Getting_Started_with_M5/M2Pro#Enable_sudo_for_Debian install sudo] before build
$ sudo apt-get update
$ sudo apt-get install build-essential python3 python3-pip python3-dev python3-setuptools git
$ git clone https://github.com/Dangku/RPi.GPIO-Amlogic.git
$ cd RPi.GPIO-Amlogic
$ sudo python3 setup.py clean --all
$ sudo python3 setup.py install

: Create and install wheel package
$ sudo python3 setup.py bdist_wheel
$ sudo pip3 install dist/RPi.GPIO-XXX.whl

: Install from git source directly without development
$ sudo pip3 install git+https://github.com/Dangku/RPi.GPIO-Amlogic.git

: If the package is already installed, it should be uninstalled before installing the new one, or installing the new one with --force-reinstall option.

===WiringPi2-Python===

: Build and install, for debian, you must [https://wiki.banana-pi.org/Getting_Started_with_M5/M2Pro#Enable_sudo_for_Debian install sudo] before build
$ sudo apt-get update
$ sudo apt-get install build-essential python3 python3-dev python3-setuptools swig git
$ git clone --recursive https://github.com/Dangku/WiringPi2-Python-Amlogic.git
$ cd WiringPi2-Python-Amlogic
$ sudo python3 setup.py install

===Luma.Examples===
:[https://github.com/rm-hull/luma.examples luma.examples] use GPIO.BCM gpio mode default, so you should map 40pin header pins to bcm gpio number and connect the hardware correctly.

:1. build and install RPi.GPIO

$ sudo apt-get update
$ sudo apt-get install build-essential python3 python3-dev python3-setuptools git
$ git clone https://github.com/Dangku/RPi.GPIO-Amlogic.git
$ cd RPi.GPIO-Amlogic
$ sudo python3 setup.py clean --all
$ sudo python3 setup.py install

:you can change the bcmledpin variable in test/led.py to your hardware backlight gpio and run it to check RPi.GPIO works well.

$ sudo python3 test/led.py

:hardware backlight will repeat on and off

:2. luma.examples libs install

$ sudo usermod -a -G i2c,spi,gpio pi

:if group does not exist, the following command will create it:

$ sudo groupadd --system xxx

$ sudo apt-get install python3-dev python3-pip libfreetype6-dev libjpeg-dev build-essential
$ sudo apt-get install libsdl-dev libportmidi-dev libsdl-ttf2.0-dev libsdl-mixer1.2-dev libsdl-image1.2-dev
$ git clone https://github.com/rm-hull/luma.examples.git
$ cd luma.examples

:install luma.core, luma.emulator, luma.lcd, luma.le-matrix, luma.oled pip libs, make sure this step without error or downloading interrupted, try again if get errors
$ sudo -H pip install -e .
:or
$ sudo -H pip3 install -e .

:for debian buster(python 3.7) which does not include /usr/bin/pip in package python3-pip, and will get the following errors when install luma packages with pip3

...
WARNING, No "Setup" File Exists, Running "buildconfig/config.py"
Using UNIX configuration...

/bin/sh: 1: sdl2-config: not found
/bin/sh: 1: sdl2-config: not found
/bin/sh: 1: sdl2-config: not found
...

:install sdl2 related packages to fix this issue, then install luma libs again with pip3
$ sudo apt-get install libsdl2-dev libsdl2-ttf-dev libsdl2-mixer-dev libsdl2-image-dev
$ sudo -H pip3 install -e .

:check installed luma pip libs
$ pip3 list | grep luma

luma.core 2.4.0
luma.emulator 1.4.0
luma.lcd 2.10.0
luma.led-matrix 1.7.0
luma.oled 3.11.0

:3. examples test
:Enable i2c or spi [https://wiki.banana-pi.org/Getting_Started_with_M5/M2Pro#DTB_overlay overlays] before running test examples
$ cd examples
$ sudo python3 bounce.py --config ../conf/ili9341.conf

===HDMI LCD===

:{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''Bananapi M5/M2pro Tested HDMI LCD'''
|-
|panel || /boot/boot.ini
|-
| [https://www.waveshare.com/3.5inch-hdmi-lcd.htm Waveshare 3.5inch 480x320] || setenv display_autodetect "false"
setenv hdmimode "480x320p60hz"
|-
| [https://www.waveshare.com/3.5inch-hdmi-lcd-e.htm Waveshare 3.5inch 640x480] ||
|-
| [https://www.waveshare.com/4inch-hdmi-lcd-c.htm Waveshare 4inch 720x720]
|-
| [https://www.waveshare.com/5inch-hdmi-amoled.htm Waveshare 5inch 960x544] ||
|-
| [https://www.waveshare.com/5inch-hdmi-lcd-h.htm Waveshare 5inch 800x480] ||
|-
| [https://www.waveshare.com/5.5inch-1440x2560-lcd.htm Waveshare 5.5inch 1440x2560] || setenv display_autodetect "false"
setenv hdmimode "1440x2560p60hz"
|-
| [https://www.waveshare.com/7inch-hdmi-lcd-b.htm Waveshare 7inch 800x480] ||
|-
| [https://www.waveshare.com/7inch-hdmi-lcd-c.htm Waveshare 7inch 1024x600] ||
|-
| [https://www.waveshare.com/7.9inch-HDMI-LCD.htm Waveshare 7.9inch 400x1280] ||
|-
| [https://www.waveshare.com/8inch-1536x2048-LCD.htm Waveshare 8inch 1536x2048] || setenv display_autodetect "false"
setenv hdmimode "1536x2048p60hz"
|-
| [https://www.waveshare.com/8.8inch-Side-Monitor.htm Waveshare 8.8inch 480x1920] ||
|-
| [https://www.waveshare.com/9inch-2560x1600-Monitor.htm Waveshare 9inch 2560x1600] || setenv display_autodetect "false"
setenv hdmimode "2560x1600p60hz"
|-
| [https://www.waveshare.com/10.1inch-HDMI-LCD-E.htm Waveshare 10.1inch 1024x600] ||
|-
| [https://www.waveshare.com/10.1inch-hdmi-lcd-b-with-case.htm Waveshare 10.1inch 1280x800] ||
|-
| [https://www.waveshare.com/11.9inch-HDMI-LCD.htm Waveshare 11.9inch 320x1480] ||
|-
| [https://www.waveshare.com/12.3inch-hdmi-lcd.htm Waveshare 12.3inch 1920x720] ||
|-
| [https://www.waveshare.com/13.3inch-HDMI-LCD-H.htm Waveshare 13.3inch 1920x1080] ||
|-
| [https://www.waveshare.com/15.6inch-hdmi-lcd-h-with-case.htm Waveshare 15.6inch 1920x1080] ||
|}

: backlight control

https://github.com/Dangku/Waveshare-USB-Brightness

===Boot Linux from USB drive===

:S905x3 is not support usb boot in soc rom, so the only way for booting linux from usb drive is create a bootable sdcard or emmc with bootloader flashed, then load boot and rootfs from usb drive. After bootup, everything will run from usb drive.

:1. The simple way is [https://wiki.banana-pi.org/Getting_Started_with_M5/M2Pro#Install_Image_to_SDcard flash the M5/M2Pro Linux image to sdcard or emmc] for bootable and also flash it to the usb drive for loading boot and rootfs.
:2. Bootup the M5/M2pro board with [https://wiki.banana-pi.org/Getting_Started_with_M5/M2Pro#Boot_Sequence sdcard or emmc], copy /boot/boot.ini to /boot/boot.ini.org so that bootloader load boot.ini fail and then try to load it from usb drive boot partition.
:3. Reboot the system, bootscript and rootfs will load from usb drive.
:[[File:m5_boot_from_usb.png]]

:4. Test performance
:You can verify the performance of your usb drive on Pi Benchmarks using the following command:
sudo curl https://raw.githubusercontent.com/TheRemote/PiBenchmarks/master/Storage.sh | sudo bash

:Test results for sd, emmc and usb drive
:{| class="wikitable"
|-
| Category || Test || Sdcard Test Result || Emmc Test Result || Usb Drive Test Result
|-
| HDParm || Disk Read || 67.91 MB/s || 156.64 MB/s || 253.40 MB/s
|-
| HDParm || Cached Disk Read || 57.39 MB/s || 126.53 MB/s || 253.52 MB/s
|-
| DD || Disk Write || 13.0 MB/s || 48.8 MB/s || 149 MB/s
|-
| FIO || 4k random read || 2456 IOPS (9826 KB/s) || 9701 IOPS (38806 KB/s) || 5474 IOPS (21897 KB/s)
|-
| FIO || 4k random write || 938 IOPS (3753 KB/s) || 12888 IOPS (51554 KB/s) || 6980 IOPS (27920 KB/s)
|-
| IOZone || 4k read || 10615 KB/s || 29568 KB/s || 23770 KB/s
|-
| IOZone || 4k write || 4276 KB/s || 33585 KB/s || 18598 KB/s
|-
| IOZone || 4k random read || 8661 KB/s || 29637 KB/s || 19982 KB/s
|-
| IOZone || 4k random write || 4795 KB/s || 38177 KB/s || 22134 KB/s
|-
| || || Score: 1300 || Score: 7811 || Score: 5879
|}

==Other Development==

===Custom Linux Boot Logo===
:Linux uboot limit boot logo fb size to 1080p60hz/1920x1080 default, so oversize resolution will not be supported by default image, but you can modify uboot source code to support it.

:1. Prepare a 24bit bmp file and named boot-logo.bmp
:2. Compress the bmp file to boot-logo.bmp.gz
$ gzip boot-logo.bmp
:3. copy the target file to BPI-BOOT partition of linux image
$ cp boot-logo.bmp.gz /media/xxx/BPI-BOOT/

===Custom Android Boot Logo===
:Android bootloader limit boot logo fb display size is 1080p60hz/1920x1080 default, and android kernel dtb partition table limit boot logo partition size to 16MB default .

:1. Prepare a 24bit bmp file and named boot-logo.bmp

:2. Compress the bmp file to boot-logo.bmp.gz
$ gzip boot-logo.bmp

:3. Download [https://download.banana-pi.dev/d/3ebbfa04265d4dddb81b/files/?p=%2FTools%2Flogo_create_tools%2Fm5_android_bootlogo_tool.zip m5_android_bootlogo_tool.zip]

:4. Extract this tool
$ unzip m5_android_bootlogo_tool.zip
$ cd m5_android_bootlogo_tool/
$ cp -a logo_img_files logo //logo_img_files is the origin bootlogo resource in android source and copy from <android-source-dir>/devices/amlogic/bananapi_m5/log_img_files
$ ls -l logo/
-rwxr--r-- 1 dangku dangku 525054 Sep 25 16:54 bootup.bmp
-rwxr--r-- 1 dangku dangku 525054 Sep 25 16:54 bootup_X3.bmp
-rwxr--r-- 1 dangku dangku 184 May 19 2020 upgrade_bar.bmp
-rwxr--r-- 1 dangku dangku 180072 May 19 2020 upgrade_error.bmp
-rwxr--r-- 1 dangku dangku 180072 May 19 2020 upgrade_fail.bmp
-rwxr--r-- 1 dangku dangku 180072 May 19 2020 upgrade_logo.bmp
-rwxr--r-- 1 dangku dangku 180072 May 19 2020 upgrade_success.bmp
-rwxr--r-- 1 dangku dangku 184 May 19 2020 upgrade_unfocus.bmp
-rwxr--r-- 1 dangku dangku 180072 May 19 2020 upgrade_upgrading.bmp

:5. Copy the boot-logo.bmp.gz
$ cp boot-logo.bmp.gz logo/bootup.bmp
$ cp boot-logo.bmp.gz logo/bootup_X3.bmp

:6. Create target logo.img with img pack tool, the binary and related libs of m5_android_bootlogo_tool are copy from <android-source-dir>/out/host/linux-x86
$ ./logo_img_packer -r logo logo.img

:7. Flash boot logo with fastboot
$ adb root
$ adb remount
$ adb reboot fastboot
:Wait few seconds and check whether fastboot connected
$ fastboot device
1234567890 fastboot
$ fastboot flashing unlock_critical
$ fastboot flashing unlock
$ fastboot flash logo logo.img
$ fastboot reboot

===Boot Sequence===

:[[File:m5_linux_boot_squence.png]]

:Check bootloader loaded from SDcard or EMMC at the beginning of the console debug messages

:1. Rom load bootloader from SDcard (Linux log example)
...

BL2 Built : 15:21:42, Mar 26 2020. g12a g486bc38 - gongwei.chen@droid11-sz

Board ID = 1
Set cpu clk to 24M
Set clk81 to 24M
Use GP1_pll as DSU clk.
DSU clk: 1200 Mhz
CPU clk: 1200 MHz
Set clk81 to 166.6M
board id: 1
'''Load FIP HDR DDR from SD''', src: 0x00010200, des: 0xfffd0000, size: 0x00004000, part: 0
fw parse done
PIEI prepare done
fastboot data verify
result: 255
Cfg max: 12, cur: 1. Board id: 255. Force loop cfg
DDR4 probe

...

:2. Rom load bootloader from EMMC(Android Log example)

...

Board ID = 1
Set cpu clk to 24M
Set clk81 to 24M
Use GP1_pll as DSU clk.
DSU clk: 1200 Mhz
CPU clk: 1200 MHz
Set clk81 to 166.6M
eMMC boot @ 0
sw8 s
board id: 1
'''Load FIP HDR DDR from eMMC''', src: 0x00010200, des: 0xfffd0000, size: 0x00004000, part: 0
fw parse done
PIEI prepare done
00000000
emmc switch 1 ok
ddr saved addr:00016000
Load ddr parameter from eMMC, src: 0x02c00000, des: 0xfffd0000, size: 0x00001000, part: 0
00000000

...

===Erase EMMC for SDcard Bootup===
:There are four possible scenarios should be pay attention to, EMMC already flashed Android image, EMMC already flashed Linux image, boot process hangup in BL2 and EMMC empty.

:1. Bootable EMMC with Android image flashed

::a). Using usb burning tool, unplug the download usb cable while the download process at '''7% formatting'''

::[[File:m5_android_format.png]]

::b). Using Android Fastboot tool, make sure the adb/fastboot tools is work on your PC before doing this.

root@dangku-desktop:/tmp# '''adb root'''
adbd is already running as root
root@dangku-desktop:/tmp# '''adb remount'''
remount succeeded
root@dangku-desktop:/tmp# '''adb shell'''
bananapi_m5:/ # '''reboot fastboot'''
::Wait a few seconds for board reboot to fastboot mode
root@dangku-desktop:/tmp# '''fastboot devices'''
1234567890 fastboot
root@dangku-desktop:/tmp# '''fastboot flashing unlock_critical'''
...
OKAY [ 0.044s]
finished. total time: 0.044s
root@dangku-desktop:/tmp# '''fastboot flashing unlock'''
...
OKAY [ 0.047s]
finished. total time: 0.047s
root@dangku-desktop:/tmp# '''fastboot erase bootloader'''
erasing 'bootloader'...
OKAY [ 0.059s]
finished. total time: 0.059s
root@dangku-desktop:/tmp# '''fastboot erase bootloader-boot0'''
erasing 'bootloader-boot0'...
OKAY [ 0.036s]
finished. total time: 0.036s
root@dangku-desktop:/tmp# '''fastboot erase bootloader-boot1'''
erasing 'bootloader-boot1'...
OKAY [ 0.035s]
finished. total time: 0.035s

::c). Using uboot command, connect a debug console cable and press ESC while power on to enter uboot command line

bananapi_m5_v1#'''amlmmc erase 1'''
emmckey_is_protected(): protect
start = 0,end = 57343
start = 221184,end = 30535679
Erasing blocks 0 to 8192 @ boot0
start = 0,end = 8191
Erasing blocks 0 to 8192 @ boot1
start = 0,end = 8191
bananapi_m5_v1#'''reset'''
resetting ...
SM1:BL:511f6b:81ca2f;FEAT:A0F83180:20282000;POC:F;RCY:0;EMMC:0;READ:0;CHK:1F;READ:0;CHK:1F;READ:0;CHK;

::These two ways actually erase the bootloader part of EMMC android, After bootup from SDcard Linux, You'd better [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Erase_Emmc_Android_by_dd_command format the whole EMMC by dd command].

::d). The simplest way is insert the SDcard with Linux image flashed before power on, the Android bootloader will check boot.ini file whether exist in SDcard vfat partition, so that the SDcard Linux will bootup. After bootup, you can [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Erase_Emmc_Android_by_dd_command format the whole EMMC by dd command] and then flash the Linux image to EMMC.

...
BPI: try boot from sdcard
reading boot.ini
5699 bytes read in 3 ms (1.8 MiB/s)
## Executing script at 01b00000
...
reading Image.gz
9143358 bytes read in 510 ms (17.1 MiB/s)
reading meson64_bananapi_m5.dtb
70850 bytes read in 8 ms (8.4 MiB/s)
reading uInitrd
11704481 bytes read in 655 ms (17 MiB/s)
reading overlays/i2c0.dtbo
223 bytes read in 6 ms (36.1 KiB/s)
reading overlays/spi0.dtbo
516 bytes read in 6 ms (84 KiB/s)
reading overlays/uart1.dtbo
225 bytes read in 5 ms (43.9 KiB/s)

:2. Bootable EMMC with Linux image flashed

::a). Using uboot command, connect a debug console cable and press ESC while power on to enter uboot command line

bananapi_m5# mmc erase 0 1000

::b). Linux u-boot also check boot.ini file whether exist in SDcard vfat partition so that the SDcard Linux will bootup. After bootup, you can format the whole EMMC by dd command or flash the Linux image directly to EMMC.

:3. A extreme situation is bootloader or uboot corrupted, Rom load it from EMMC but hangup in u-boot or BL2, for example the boot process will hangup in BL2 of EMMC if dram init failed, The only way is format the EMMC with usb burning tool, or download the Android image completely and then try other ways to erase EMMC or flash Linux image to EMMC.

:4. Rom will try to load bootloader from SDcard directly if EMMC is empty.

===Erase Emmc Android by dd command===
:If the board is flashed android before, the whole emmc must be erased by these commands if you want bootup it with SDcard Linux image.
$ sudo dd if=/dev/zero of=/dev/mmcblk0boot0 bs=1M status=noxfer
$ sudo dd if=/dev/zero of=/dev/mmcblk0boot1 bs=1M status=noxfer
$ sudo dd if=/dev/zero of=/dev/mmcblk0 bs=1M status=noxfer
$ sync

===Wifi/BT support===

:1. Android test and support.
rtl8723bu wifi/bt(usb)
rtl8188eu wifi(usb)
[http://forum.banana-pi.org/t/banana-pi-wifi-bt-4-2-expansion-board-standard-usb-interface/12162 rtl8821cu wifi/bt(usb)]
[http://forum.banana-pi.org/t/bpi-m5-wifi-bt-board-sdio-interface-802-11-a-b-g-n-ac-2t2r-wifi-and-bluectooch-5-0/11846 rtl8822cs wifi/bt(sdio/uart)]
rtl8814au wifi(usb), please get the [https://github.com/aircrack-ng/rtl8814au aircrack-ng] driver and install.

:'''How to enable Android Wifi/BT'''

:USB type: Plug-in the usb dongle to usb host port and reboot the system, After bootup, you can enable or disable wifi and bluetooth in Settings app.
:SDIO/UART type: Connect the hardware module to 40pin header correctly and [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5/M2Pro#Android_DTB_overlay configure the Android DTB overlay] to enable it.

:'''Note''': Android is not support that ethernet and wifi are both connected at the same time, Ethernet have a higher prioprity than wifi, it means wifi can't connect network if ethernet already connected, and wifi will drop connection if ethernet cable plugin.

:2. Linux test and support.
rtl8188eu wifi(usb)
rtl8192eu wifi(usb)
rtl8723bu wifi/bt(usb)
rtl8811au wifi(usb)
rtl8812au wifi(usb)
rtl8812bu wifi(usb)
[http://forum.banana-pi.org/t/banana-pi-wifi-bt-4-2-expansion-board-standard-usb-interface/12162 rtl8821cu wifi/bt(usb)]
[http://forum.banana-pi.org/t/bpi-m5-wifi-bt-board-sdio-interface-802-11-a-b-g-n-ac-2t2r-wifi-and-bluectooch-5-0/11846 rtl8822cs wifi/bt(sdio/uart)]

:'''How to enable Linux Wifi'''

:Wifi module drivers are already prebuild in the release images.

:USB type: Plug-in the usb dongle to usb host port and driver will be loaded automatically.
:SDIO/UART type:
::1). Connect the hardware module to 40pin header correctly.
::2). Configure the [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#DTB_overlay dtb overlay]
# Overlays to load
# Example combinations:
# spi0 i2c0 i2c1 uart0
# hktft32
# hktft35
setenv overlays "wifi_bt_rtl8822cs"
::3). Add the wifi module name to /etc/modules for loaded automatically next boot.
# This file contains the names of kernel modules that should be loaded
# at boot time, one per line. Lines beginning with "#" are ignored.
88x2cs

:'''How to enable Linux Bluetooth'''

::1). Please download [https://github.com/Dangku/m5-rtk-linux-bt-driver rtk-linux-bt-driver] source code, build and install usb or uart rtk linux bluetooth drivers/firmwares to your image.
::2). For USB type, plug-in the usb dongle to usb host port and driver will be loaded automatically.
::3). For UART type, Configure the dtb overlay as the same as wifi before install the bluetooth drivers/firmwares. hci_uart driver will be loaded when rtk-hciuart.service start.

===Linux Server Image Network Configuration===

:[https://netplan.io Netplan]

:'''Linux Wifi STA mode'''

:A sample wifi sta mode netplan configuration file, 01-wlan0-sta.yaml
network:
version: 2
renderer: networkd
wifis:
wlan0:
dhcp4: true
access-points:
"bananapi":
password: "123456789"

:'''Linux Wifi AP mode'''

:1. Prepare the setup the [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Wifi.2FBT_support wifi adater] correctly.

:2. Get the wifi adapter Band, Frequencies, Channel, HT Capability, VHT Capability or other properties
$ iw list

:3. Manage wifi access point mode with [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Linux_Server_Image_Network_Configuration Netplan] and Network-Manager.

:Install NetworkManager because ap is only supported with NetworkManager renderer
$ sudo apt install network-manager

:A sample 2.4G wifi ap mode netplan configuration file, 01-wlan0-ap-2.4g.yaml
network:
version: 2
renderer: NetworkManager
wifis:
wlan0:
dhcp4: no
access-points:
"bananapi":
mode: ap
band: 2.4GHz
channel: 6
auth:
key-management: psk
password: "123456789"

:A sample 5G wifi ap mode netplan configuration file, 01-wlan0-ap-5g.yaml
network:
version: 2
renderer: NetworkManager
wifis:
wlan0:
dhcp4: no
access-points:
"bananapi":
mode: ap
band: 5GHz
channel: 36
auth:
key-management: psk
password: "123456789"

:4. Manage wifi access point mode with [http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Linux_Server_Image_Network_Configuration Netplan] and Hostapd.

:1). Create a netplan configuration file, 01-wlan0-ap-hostapd.yaml
network:
version: 2
renderer: networkd
ethernets:
wlan0:
dhcp4: no
addresses:
- 192.168.11.1/24

:2). Install hostapd
$ sudo apt install hostapd

:Create hostapd configuration file /etc/hostapd/hostapd.conf, for example
interface=wlan0
ssid=bananapi

driver=nl80211

auth_algs=1
wpa=2
wpa_passphrase=123456789
wpa_key_mgmt=WPA-PSK
rsn_pairwise=CCMP

#bridge=br0
beacon_int=500
#SSID not hidden
ignore_broadcast_ssid=0

hw_mode=a
channel=36
max_num_sta=8

### IEEE 802.11n
ieee80211n=1
#require_vht=0
ht_capab=[HT20][HT40+][SHORT-GI-20][SHORT-GI-40][SHORT-GI-80][DSSS_CCK-40]

### IEEE 802.11ac
ieee80211ac=1
#require_vht=0
#vht_capab=[MAX-MPDU-3895][SHORT-GI-80][SU-BEAMFORMEE]
#vht_oper_chwidth=1
#vht_oper_centr_freq_seg0_idx=42

### WMM
wmm_enabled=1

:3). To support 80MHz channel width you need load driver with '''rtw_vht_enable=2''' option, Or you can create /etc/modprobe.d/8822cs.conf with content
options 88x2cs rtw_vht_enable=2

:4). Install and configure dhcp server service, use isc-dhcp-server for example

$ sudo apt install isc-dhcp-server

:Configure dhcp server interface in /etc/default/isc-dhcp-server
# On what interfaces should the DHCP server (dhcpd) serve DHCP requests?
# Separate multiple interfaces with spaces, e.g. "eth0 eth1".
INTERFACESv4="wlan0"

:Configure dhcp subnet and dns in /etc/dhcp/dhcpd.conf
...
option domain-name "example.org";
option domain-name-servers 8.8.8.8, 114.114.114.114;
...
# No service will be given on this subnet, but declaring it helps the
# DHCP server to understand the network topology.
subnet 192.168.11.0 netmask 255.255.255.0 {
range dynamic-bootp 192.168.11.1 192.168.11.100;
option broadcast-address 192.168.11.255;
option routers 192.168.11.1;
}

:5). Start Service
$ sudo hostapd /etc/hostapd/hostapd.conf -B
$ sudo systemctl restart isc-dhcp-server

:6). Routing configuration.
sysctl net.ipv4.ip_forward=1
iptables -t nat -A POSTROUTING -s 192.168.11.0/24 -o eth0 -j MASQUERADE

===Disable Cloud-init&Snap===
:Cloud-init and Snap service are enabled default, you can disable or remove them.

:1. disable or remove cloud-init
$ sudo touch /etc/cloud/cloud-init.disabled
:or
$ sudo apt purge cloud-init

:2. disable or remove snap
$ sudo apt purge snapd

===Enable rc-local===
:The systemd service rc-local.service already exists in release image, but there is no [Install] part in the unit file. As a result, Systemd is unable to enable it. First, we must update the file.

$ sudo nano /lib/systemd/system/rc-local.service

[Unit]
Description=/etc/rc.local Compatibility
Documentation=man:systemd-rc-local-generator(8)
ConditionFileIsExecutable=/etc/rc.local
After=network.target

[Service]
Type=forking
ExecStart=/etc/rc.local start
TimeoutSec=0
RemainAfterExit=yes
GuessMainPID=no

[Install]
WantedBy=multi-user.target
Alias=rc-local.service

:Create /etc/rc.local file.

sudo nano /etc/rc.local

#!/bin/sh
#
# rc.local
#
# This script is executed at the end of each multiuser runlevel.
# Make sure that the script will "exit 0" on success or any other
# value on error.
#
# In order to enable or disable this script just change the execution
# bits.
#
# By default this script does nothing.

exit 0

:Add executable permission to /etc/rc.local

$ sudo chmod +x /etc/rc.local

:Enable rc-local.service and reboot

$ sudo systemctl enable rc-local.service
$ sudo reboot

===Enable sudo for Debian===
:The release Debian image do not install sudo default, with "su -" command, user can change to root. If you like sudo, you can install it.

$ su root
Password:(enter bananapi)

# apt-get update
# apt-get install sudo
# adduser pi sudo

: Then please do logout and login again

===Install Docker Engine===
:Install Docker Engine on Ubuntu 20.04 Server

:1. Set up the repository

:Update the apt package index and install packages to allow apt to use a repository over HTTPS:
$ sudo apt-get update
$ sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release

:Add Docker’s official GPG key:
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

:Set up the stable repository
$ echo \
"deb [arch=arm64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

:2. Install Docker Engine
$ sudo apt-get update
$ sudo apt-get install docker-ce docker-ce-cli containerd.io

:3. Verify the Docker Engine is installed correctly by running the hello-world image.
$ sudo docker run hello-world

:[[File:docker-test.png]]

Install docker with a simple command

$ curl -sSL get.docker.com | sudo sh

[https://docs.docker.com/engine/install/ Install Docker Engine] on other Linux distributions

Getting Started with M2 Zero

2023-07-11T08:58:07Z

Qubot: /* Introduction */

[[zh:快速上手香蕉派 BPI-M2 Zero]]
=Introduction=
[[File:BPI-M2_zero_11.JPG|thumb|Overview [[Banana Pi BPI-M2 ZERO]]]]
[[File:M2Zero_raspbian.png|thumb|Overview: BPI-M2Z raspbian]]
[[File:BPI-M2_zero_android_4.4.JPG|thumb|Android 4.4]]
[[File:BPI-M2_zero_ubuntu.JPG|thumb|Ubuntu Linux]]

*Read more about : [[Banana_Pi_BPI-M2_ZERO]]

==BPI-M2 Zero==

Banana Pi M2 Zero is an ultra compact single board computer measures only 60mm*30mm. It uses quad-core Cortex A7 allwinner H2+ processor, with 512MB RAM memory. 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===
* Quad Core ARM Cortex A7 CPU H2+
* 512MB SDRAM.
* WiFi (AP6212) & Bluetooth onboard.
* Mini HDMI.

=Development=
==Basic Development==
===Load your first Android image on M2 Zero===
1.You could download latest image from our forum.

2.Put your TF card into a TF-USB adapter, and then plug adapter in your Windows PC usb interface.

3.Prepare your image, and download image burning tools PhoenixCard.exe.

4.Use "PhoenixCard.exe" to burn android image to TF card.

[[Image:M3_Android_Burning.png | 600px]]

* Download PhoenixCard: https://pan.baidu.com/s/1-fjvPqtG_zewVzqnXf1AHw?pwd=eid9

===Prepare to develop===
* Prepare 8G/above TF card, USB-Serial interface, PC with Ubuntu System
* Using your USB-Serial Connect debug console on M2 Zero

[[Image:Debug_console_wire.png]]

[[Image:M2_Zero_debug_console.png]]

===Install Linux Image on M2 Zero===
Download [http://wiki.banana-pi.org/Banana_Pi_BPI-M2_ZERO#Linux 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 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. Insert your SDcard into your PC
$ bpi-copy xxx.img /dev/sdx

Install Image to SDcard with Ether on Windows, Linux and MacOS
:[https://www.balena.io/etcher/ 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 m2 zero bsp source code
$ git clone https://github.com/BPI-SINOVOIP/BPI-M2P-bsp-4.4

:2. Build the source code according to the README.md, 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

===OTG===
1. On M2 Zero console:
* Execute "./adbd.sh", 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

===USB Ethernet===
* Prepare a USB to OTG wire, usb ethernet adapter

[[Image:M2Zero_usb_network_wire.png]]

* Use iperf3 to test network
[[Image:M2Zero_network.png]]

===Bluetooth===
* 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:
[[Image: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/wpa_supplicant/wpa_supplicant.conf
network={
ssid="ssid"
psk="password"
priority=1
}
* wpa_supplicant -i wlan0 -c /etc/wpa_supplicant/wpa_supplicant.conf
* dhclient wlan0

2. Use UI interface to setup WiFi Client

===Clear boot===
* git clone https://github.com/BPI-SINOVOIP/BPI-files/tree/master/SD/100MB
* bpi-bootsel BPI-cleanboot-8k.img.gz /dev/sdX

===Camara function===
We use HDF5640 camara.

[[Image:ov5640_camara.png]]
====Guvcview====
* Use your UI interface to operate camara
* Applications -> Sound & Video -> guvcview
====Shell====
* We also have built-in command in /usr/local/bin to test camara
* "./test_ov5640_image_mode.sh" to test picture taking function
* "./cameratest.sh" to test video recording function

===Display===
====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"

[[Image: 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：

[[Image: display_mode.png]]

===BPI-Tools===
====Install Bpi-tools====
* Execute "curl -sL https://github.com/BPI-SINOVOIP/bpi-tools/raw/master/bpi-tools | sudo -E bash - "

====Update Bpi-tools====
* Execute "bpi-tools"
[[Image: Bpi-tools.png]]

===RPi.GPIO===
====Install RPi.GPIO====
* Execute "git clone https://github.com/BPI-SINOVOIP/RPi.GPIO"
* after clone the repo, cd RPi,GPIO
* Execute "sudo apt-get update"
* Execute "sudo apt-get install python-dev python3-dev"
* Execute "sudo python setup.py install" or "sudo python3 setup.py install" to install the module

====Using RPi.GPIO====
* cd /usr/local/bin
* Execute "./bpi_test_g40.py" to test RPi.GPIO

[[Image: RPi_GPIO.png]]

===WiringPi===
* GitHub: https://github.com/BPI-SINOVOIP/BPI-WiringPi2.git
* We also have built-in test command in "/usr/local/bin"

====How to Update WiringPi====
* Execute "bpi-update -c pkglist.conf"
[[Image: Update_Pkglist.png]]

* Execute "bpi-update -c bpi-pkg-bpi-wiringpi.conf"
[[Image: Update_WringPi.png]]

====RGB 1602 LCD====
* Execute "/usr/local/bin/bpi_test_lcd1602.sh"

====0.96 Inch OLED Display====
* Execute "/usr/local/bin/bpi_test_52pi.sh"

====8x8 RGB LED Martix====
* Firstly you need a GPIO Extend Board for 8x8 LED Martix
[[Image: WringPi_LED_Martix_Extend_Board.png]]

* Execute "/usr/local/bin/bpi_test_gpio40.sh"

Banana Pi BPI-P2 Zero

2023-07-06T01:59:37Z

Qubot: /* Getting Start */

[[zh:香蕉派_BPI-P2_Zero]]
=Introduction=

[[File:BPI-F2_zero_1.JPG|thumb|Overview BPI-P2 Zero with Allwinner H2+ chip]]
[[File:BPI-F2_zero_2.JPG|thumb|Overview BPI-P2 zero PoE support]]
[[File:Banana_Pi_BPI-P2_Pro_1.jpg|thumb|[[Banana Pi BPI-P2 Pro]] with Rockchip RK3308]]
[[File:BPI-M2_zero_11.JPG|thumb|[[Banana Pi BPI-M2 ZERO]] with Allwinner H2+ chip]]
[[File:BPI-9600_POE_4.JPG|thumb|Banana Pi BPI-P2 Zero with BPI-9600 POE module]]
[[File:BPi-9600 Poe 4.jpg|thumb|[[BPI-9600 IEEE 802.3af PoE module]]]]
[[File:Newwork_scu.JPG|thumb|BPI-4.0 OEM&ODM [[Successful case]] H3 for Network security information analysis instrument]]
[[File:BPI-P2_Zero_case.JPG|thumb|BPI-P2 Zero Case]]

Banana Pi BPI-P2 Zero is an ultra compact single board computer measures only 65mm*52.5mm. It uses quad-core Cortex A7 allwinner H3/H2+ processor(Option : 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.

Banana Pi BPI-P2 Maker, base on BPI-P2 ZERO, without 8GB eMMC/ Wifi & Bluetooth/40PIN GPIO, all other functions are same as BPI-P2 ZERO.

[[File:Banana_Pi_BPI-P2_zero.jpg]]

==Key Features==

* CPU: Allwinner H3/H2+, Quad-core Cortex-A7.
* 512MB DDR 3 SDRAM.
* WiFi (AP6212/K016) & BT 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.

==Getting Start==
::Quick strart your BPI-M2 zero : [[Quick Start Banana pi SBC]]
::How to development : [[Getting Started with P2-Zero]]

=Hardware=

BPI-P2 Zero, just 3 change on BPI-M2 Zero . other hadware design same as BPI-M2 Zero.so all software is same .

* 1,add 8G eMMC flash support onboard, easy to do IoT gateway.
* 2,BPI-P2 Zero with 100M LAN interface ,BPI-M2 Zero with PIN define for 100M lan , use way is same.
* 3,PoE function support on board.

==Hardware interface==

[[File:BPI-P2_zero_interface.jpg]]

==Hardware spec==

{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''HardWare Specification of Banana pi BPI-P2 Zero VS BPI-M2 zero VS Raspberry Pi Zero W'''
|-
|Module||'''Banana Pi BPI-P2 Zero'''|| '''Banana Pi BPI-M2 Zero''' || '''Raspberry Pi Zero W'''
|-
|CPU ||Allwinner H3/H2+ Quad-core Cortex-A7 H265/HEVC 1080P ||Allwinner H3/H2+ Quad-core Cortex-A7 H265/HEVC 1080P ||Broadcom BCM2835 32 Bit 1 GHz ARM1176JZF-S single-core
|-
|GPU || Mali400MP2 GPU @600MHz,Supports OpenGL ES 2.0|| Mali400MP2 GPU @600MHz,Supports OpenGL ES 2.0 ||VideoCore IV
|-
| Memory $SDRAM$ || 512M DDR3(shared with GPU)||512M DDR3(shared with GPU) ||512 MB DDR2
|-
| Onboard Storage ||TF card $Max. 64GB$ ||TF card $Max. 64GB$ ||TF card $Max. 64GB$
|-
| Onboard Network || 100M LAN||NOPE (but can extension with PIN define) ||NOPE
|-
| PoE power || PoE function support ||NOPE ||NOPE
|-
| Onboard flash || 8G eMMC||NOPE||NOPE
|-
| Onboard WIFI ||K016/SDIO AP6212（option AP6181、AP6335） ||K016/SDIO AP6212（option AP6181、AP6335） ||802.11n wireless, Bluetooth 4.1
|-
|Video decoding ||1080p@60fps,H.264 Video encoding 1080p@30fps,H.264|| 1080p@60fps,H.264 Video encoding 1080p@30fps,H.264 || 1080p30 H.264/MPEG-4 AVC high-profile decoder and encoder
|-
| Video input || A CSI input connector Camera||A CSI input connector Camera || CSI camera connector
|-
| Video Outputs || mini HDMI 1.4,1080P@30fps, DHCP||mini HDMI 1.4,1080P@30fps, DHCP ||Mini HDMI and USB On-The-Go ports
|-
| Audio Output || Mini HDMI ||Mini HDMI ||Mini HDMI
|-
| Power Source || Micro USB with 5V/2A or PoE power||Micro USB with 5V/2A ||5V/2A
|-
| USB 2.0 Ports || one USB 2.0 OTG ||one USB 2.0 OTG ||one USB 2.0 OTG
|-
| Buttons || Power Button, Reset Button ||Power Button, Reset Button ||Composite video and reset headers
|-
| Low-level peripherals || 40 Pins Header,compatible with Raspberry Pi 3 ||40 Pins Header,compatible with Raspberry Pi 3 ||40 PIN
|-
| uart GPIO$1x3$ pin || UART, ground ||UART, ground ||UART
|-
| LED ||Power led & Status led|| Power led & Status led ||Power Status LED
|-
| IR ||N/A|| N/A ||N/A
|-
| Supported OS ||android linux|| android linx|| Linux
|-
| Product size || 65mm X 52.5mm||65mm × 30mm ||65mm x 30mm
|-
| Weight ||30g|| 15g ||9g
|-
|}

==GPIO PIN define ==

Banana Pi BPI-P2 zero GPIO same as BPI-M2 Zero ,it has a 40-pin GPIO header that matches that of the Model Raspberry Pi 3. Following is the Banana Pi GPIO Pinout:

{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''40 PIN GPIO of Banana pi BPI-P2 Zero'''
|-
| GPIO Pin Name || Default Function || Function2：GPIO || Function3
|-
| CON2-P01 || VCC-3V3 || ||
|-
| CON2-P02 || VCC-5V || ||
|-
| CON2-P03 || TWI0-SDA || PA12-EINT12 ||
|-
| CON2-P04 || VCC-5V || ||
|-
| CON2-P05 || TWI0-SCK || PA11-EINT11||
|-
| CON2-P06 || GND || ||
|-
| CON2-P07 || PWM1 || PA6-EINT6||
|-
| CON2-P08 || UART3-TX || PA13-EINT13 || SPI1-CS
|-
| CON2-P09 || GND || ||
|-
| CON2-P10 || UART3-RX || PA14-EINT14 || SPI1-CLK
|-
| CON2-P11 || UART2-RX || PA1-EINT1 ||
|-
| CON2-P12 || UART3-CTS || PA16-EINT16 || SPI1-MISO
|-
| CON2-P13 || UART2-TX || PA0-EINT0 ||
|-
| CON2-P14 || GND || ||
|-
| CON2-P15 || UART2-CTS || PA3-EINT3 ||
|-
| CON2-P16 || UART3-RTS || PA15-EINT15 || SPI1-MOSI
|-
| CON2-P17 || VCC-3V3 || ||
|-
| CON2-P18 || PC4 || PC4 ||
|-
| CON2-P19 || SPI0-MOSI || PC0 ||
|-
| CON2-P20 || GND || ||
|-
| CON2-P21 || SPI0-MISO || PC1 ||
|-
| CON2-P22 || UART2-RTS || PA2-EINT2 ||
|-
| CON2-P23 || SPI0-CLK || PC2 ||
|-
| CON2-P24 || SPI0-CS || PC3 ||
|-
| CON2-P25 || GND || ||
|-
| CON2-P26 || PC7 || PC7 ||
|-
| CON2-P27 || TWI1-SDA || PA19-EINT19 ||
|-
| CON2-P28 || TWI1-SCK || PA18-EINT18 ||
|-
| CON2-P29 || PA7-EINT7 || PA7-EINT7 ||
|-
| CON2-P30 || GND || ||
|-
| CON2-P31 || PA8-EINT8 || PA8-EINT8 ||
|-
| CON2-P32 || PL2-S-EINT2 || PL2-S-EINT2 ||
|-
| CON2-P33 || PA9-EINT9 || PA9-EINT9 ||
|-
| CON2-P34 || GND || ||
|-
| CON2-P35 || PA10-EINT10 || PA10-EINT10 ||
|-
| CON2-P36 || PL4-S-EINT4 || PL4-S-EINT4 ||
|-
| CON2-P37 || PA17-EINT17 || PA17-EINT17 || SPDIF-OUT
|-
| CON2-P38 || PA21-EINT21 || PA21-EINT21 ||
|-
| CON2-P39 || GND || ||
|-
| CON2-P40 || PA20-EINT20 || PA20-EINT20 ||
|-
|}

'''CSI Camera Connector specification:'''

The CSI Camera Connector is a 24-pin FPC connector which can connect external camera module with proper signal pin mappings. The pin definitions of the CSI interface are shown as below. This is marked on the Banana Pi board as “CSI″.

{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''24 PIN CSI Camera connector of Banana pi BPI-P2 Zero'''
|-
| CSI Pin Name || Default Function || Function2：GPIO
|-
| CN3-P01 || NC ||
|-
| CN3-P02 || GND ||
|-
| CN3-P03 || CSI0-SDA || PE13
|-
| CN3-P04 || CSI0-AVDD ||
|-
| CN3-P05 || CSI0-SCK || PE12
|-
| CN3-P06 || CSI0-Reset || PE14
|-
| CN3-P07 || CSI0-VSYNC || PE3
|-
| CN3-P08 || CSI0-PWDN || PE15
|-
| CN3-P09 || CSI0-HSYNC || PE2
|-
| CN3-P10 || CSI0-DVDD ||
|-
| CN3-P11 || CSI0-DOVDD||
|-
| CN3-P12 || CSI0-D7 || PE11
|-
| CN3-P13 || CSI0-MCLK || PE1
|-
| CN3-P14 || CSI0-D6 || PE10
|-
| CN3-P15 || GND ||
|-
| CN3-P16 || CSI0-D5 || PE9
|-
| CN3-P17 || CSI0-PCLK || PE0
|-
| CN3-P18 || CSI0-D4 || PE8
|-
| CN3-P19 || CSI0-D0 || PE4
|-
| CN3-P20 || CSI0-D3 || PE7
|-
| CN3-P21 || CSI0-D1 || PE5
|-
| CN3-P22 || CSI0-D2 || PE6
|-
| CN3-P23 || GND ||
|-
| CN3-P24 || CSI0-DOVDD ||
|-
|}

'''UART specification:'''

The jumper CON3 is the UART interface. For developers of Banana Pi, this is an easy way to get the UART console output to check the system status and log message.

{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''jumper CON3 of Banana pi BPI-P2 Zero'''
|-
| CON3 Pin Name || Default Function || GPIO
|-
| CON3 P03 || UART0-TXD || PA4
|-
| CON3 P02 || UART0-RXD || PA5
|-
| CON3 P01 || GND ||
|-
|}

==PoE support ==

we deign a IEEE 802.3af PoE module for BPI-P2 Zero ,easy to support PoE function,more spec ,please check BPI-9600 PoE module spec

*[[BPI-9600 IEEE 802.3af PoE module]]

=Resources=

== Documents==
*Because of the Google security update some of the old links will not work if the images you want to use cannot be downloaded from the [https://drive.google.com/drive/folders/0B_YnvHgh2rwjVjNyS2pheEtWQlk?resourcekey=0-U4TI84zIBdId7bHHjf2qKA new link bpi-image Files]
*All banana pi [https://drive.google.com/drive/folders/0B4PAo2nW2Kfndjh6SW9MS2xKSWs?resourcekey=0-qXGFXKmd7AVy0S81OXM1RA&usp=sharing docement(SCH file,DXF file,and doc)]
** allwinner H3 chip doc baidu link: https://pan.baidu.com/s/1qTULll2CR02d0Hw9itq1rw
** Allwinner H2+ chip doc baidu link: https://pan.baidu.com/s/1TGMYr3rhizfhlg5hl6hLyg
*BPI-P2 Zero schematic diagram :https://drive.google.com/drive/folders/0B4PAo2nW2KfnflVqbjJGTFlFTTd1b1o1OUxDNk5ackVDM0RNUjBpZ0FQU19SbDk1MngzZWM?resourcekey=0-ZRCiv304nGzvq-w7lwnpjg&usp=sharing
*BPI-P2 zero CE,FCC,RoHS Certification : http://forum.banana-pi.org/t/banana-pi-bpi-p2-zero-ce-fcc-rohs-certification/9788
*Banana pi BPI-P2 Zero IEEE 802.3af PoE function test: https://www.youtube.com/watch?v=RCrDmhjxfCU&feature=youtu.be
*BPI-P2 Zero DXF file: https://drive.google.com/file/d/1NBenPRf6Pngsio930PKuzj6IqyUK5qyr/view?usp=sharing
*magazinmehatronika BPI-P2 zero and maker review: https://www.magazinmehatronika.com/banana-pi-bpi-p2-recenzija/

==Source code==
* Android 4.4 source code
::download link: https://drive.google.com/open?id=0B_YnvHgh2rwjdWNEQzg1UDl1bUE
::forum pthread: http://forum.banana-pi.org/t/bpi-m2-android-4-4-source-code-download-link/3159

*Linux source code
:: kernel 4.4 source code : https://github.com/BPI-SINOVOIP/BPI-M2P-bsp-4.4
:: kernel 3.4 source code : https://github.com/BPI-SINOVOIP/BPI-M2Z-bsp

=Image Release=

==Linux==

*2022-10-12 Armbian_22.11.0-trunk_Bananapip2zero_jammy_edge_5.19.6_xfce_desktop.img
:: Google Drive:https://drive.google.com/file/d/1vP_047mfuAhSjBkZvb3w-iTGktd_BZbu/view?usp=sharing
:: Baidu Cloud: https://pan.baidu.com/s/1uhbUMYeplPybxTn_Cybpvw?pwd=8888 (pincode: 8888)
:: Discuss on Forum: https://forum.banana-pi.org/t/bananapi-bpi-p2-zero-new-image-release-armbian-jammy/14026

*2022-10-12 Armbian_22.11.0-trunk_Bananapip2zero_bullseye_edge_5.19.6_xfce_desktop.img
::Google Drive:https://drive.google.com/file/d/1YSaM1ob80EPcNoeVKYPjtCeMItBlTMET/view?usp=sharing
::Baidu Cloud:https://pan.baidu.com/s/1CrZQhN3BR6bx7uMTZYVeMQ?pwd=8888 (pincode: 8888)
::Discuss on Forum: https://forum.banana-pi.org/t/bananapi-bpi-p2-zero-new-image-release-armbian-bullseye/14025

*2022-09-27-Armbian_22.11.0-trunk_jammy_edge_lubuntu_5.19.6-qt5-swap-bpi-P2z-M2Z-10804MB
::Google Drive: https://drive.google.com/file/d/1_rsQthyCU4HaN8tcGsPMvzt6dMwaRI-A/view?usp=sharing
::Baidu Cloud:https://pan.baidu.com/s/1RKJzzpMOHnFW0nj8I-NJIA?pwd=rk22 (pincode: rk22)
::MD5:f4dfbe234c21a6038f50f699780d4e03

*2020-04-28 update, Debian 9, Rasbian Stretch, Ubuntu 16.04 Mate Desktop and Ubuntu 16.04 Server images, base on kernel 4.4，Images for m2z and p2z board are compatible.
::google driver: https://drive.google.com/drive/folders/1uRE8BppgDjK2TXH5kUIJ1_YrbAAW3HKF
::baidu cloud ： https://pan.baidu.com/s/1pJfJbhIcU52uaR4mkWc-4A Pincode：5e3E
::discuss on forum: http://forum.banana-pi.org/t/banana-pi-bpi-m2-zero-new-image-2020-04-28-debian-rasbian-ubuntu/11068

*2019-4-30 update BPI-M2 Zero & BPI-P2 Zero Ubuntu Server 16.04
::Features Map:http://wiki.banana-pi.org/M2Z_Image_Map#Kernel_3.4
::Image Links：
::::HDMI-Version
::::Google Drive : https://drive.google.com/open?id=1nTrali0w7GgcGatu-jxyJR-sF06rMN39
::::Baidu Drive : https://pan.baidu.com/s/100LiQcD7V2_AJ3EmYN8p0g ( PinCode: q379 )
::::Md5sum : f8aa74511677a0543d2af65115d7d0d0
::::Forum pthread: http://forum.banana-pi.org/t/bananapi-bpi-m2z-bpi-p2-zero-h2-new-images-reapbian9-4-ubuntu16-04-release-2019-04-30/9166

*2018-4-30 update BPI-M2 Zero & P2Zero Ubuntu Desktop 16.04
::Features Map:http://wiki.banana-pi.org/M2Z_Image_Map#Kernel_3.4
::Image Links：
::::HDMI-Version
::::Google Drive : https://drive.google.com/open?id=14_qm7Nk3FIycIC95ghVyeFz2xEbKjuSx
::::Baidu Drive : https://pan.baidu.com/s/1LZmkxRnszlhfdLD0Ngg18g ( PinCode: dqe1 )
::::Md5sum : 25daaac1e678a5cc98259a82ea5ce53c
::::Forum pthread: http://forum.banana-pi.org/t/bananapi-bpi-m2z-bpi-p2-zero-h2-new-images-reapbian9-4-ubuntu16-04-release-2019-04-30/9166

*2018-08-17 update Ubuntu image V1.0 release This release is for BPI-P2 Zero board which is based on Allwinner H2+, We have one demo image release，Ubuntu 16.04 is based on kernel 3.4.
::BPI-P2 Zero image Features Map : http://wiki.banana-pi.org/P2Z_Image_Map
::Google Drive : https://drive.google.com/open?id=1izY4ib2roA4I9s4psbXqZq5sBXLkCgBE
::Baidu Drive : https://pan.baidu.com/s/1-pAplB8_j_W5mUsYsinavg
::Forum pthread : http://forum.banana-pi.org/t/bananapi-bpi-p2-zero-h2-with-poe-ubuntu-image-release-2018-08-17/6533

香蕉派 BPI-M2 Berry

2023-06-27T06:35:03Z

Qubot: /* 硬件规格表 */

[[en:Banana_Pi_BPI-M2_Berry]]

=产品介绍=

[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|Overview]]
[[File:Banana_pi_BPI-M2_Berry_4.jpg|thumb|Overview:front]]
[[File:Banana_pi_BPI-M2_Berry_3.JPG|thumb|Overview:back]]
[[File:R40_for_vehicle_license_plate_recognition.JPG|thumb|BPI-M2 Berry for BPI 4.0 [[Successful case]] ：R40 for vehicle license plate recognition ]]
[[File:R40_for_IoT_gateway.JPG|thumb|BPI-M2 Berry for BPI 4.0 [[Successful case]] ：R40 for IoT gateway with Z-wave, zigbee,WiFI]]

香蕉派 BPI-M2 Berry 四核单板计算机采用全志 R40/V40芯片开发。支持板载Wifi与蓝牙，支持SATA接口，可以直接接硬盘。板上有SD卡插座，可以从SD卡启动系统镜像。

Banana PI BPI-M2 Berry 兼容性强大,可以跑android系统,Debian linux,Ubuntu linux, Raspberry Pi系统和全志TinaLinux系统.

Banana PI BPI-M2 Berry硬件：全志R40/V40四核处理器，1GB LPDDR3内存，千兆以太网口，4 USB 接口流畅运行Android5.1。Banana PI BPI-M2 Berry尺寸与树莓派 3完全一样，可以直接使用树莓派3的外壳。GPIO兼容Raspberry Pi 3并能运行rasbian 系统。

[[File:Banana_Pi_BPI-M2_Berry.jpg]]

作为香蕉派家族的一员，BPI-M2 Berry是香蕉皮M1/M1+的直接升级版，支持SATA。

板子的尺寸与接口都和树莓派3一样，所以你可以用树莓派3的外壳等配件直接用在BPI-M2 Berry

==主要特点==

* Allwinner R40/V40 Quad Core ARM Cortex A7 CPU
* 1GB DDR3 SDRAM.
* WiFi (AP6212) & Bluetooth onboard.
* SATA Interface.
* 4*USB 2.0
* MIPI DSI ingerface
* CSI camera interface

==如何开始使用==
*镜像烧录及快速开始使用 : [[快速上手香蕉派镜像烧录与系统启动]]

*开发快速入门:[[快速上手香蕉派 BPI-M2 Ultra / BPI-M2 Berry]]

=硬件介绍=
==硬件接口==
[[File:M2ubinterface.jpg]]

==硬件规格表==
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''HardWare Specification of Banana pi BPI-M2 Berry'''
|-
|Soc || Allwinner A40I/R40/V40
|-
| CPU || quad-core cortex -A7,the most power efficient CPU core ARM's ever development
|-
| GPU || dual-core MALI-400 MP2 and runs at 500MHz, capable of 1.1 Gpixel/s throughput. Graphics capabilities are slightly higher than the original Xbox’s level of performance. The GPU provides OpenGL ES 2.0, hardware-accelerated OpenVG, 1080p45 H.264 high-profile encode and decode.
|-
| SDRAM || 1GB DDR3 with 733MHz$shared with GPU$
|-
| SATA || suppoort SATA interface
|-
| GPIO || 40 Pins Header, 28×GPIO, some of which can be used for specific functions including UART, I2C, SPI, PWM, I2S.
|-
| On board Network || 10/100/1000Mbps Ethernet $Realtek RTL8211E/D$
|-
| Wifi Module || WiFi 802.11 b/g/n $AP 6212 module on board$
|-
| Bluetooth || BT4.0
|-
| On board Storage || MicroSD $TF$ card,No eMMC onboard
|-
| Display || 4-lane MIPI DSI display,or RGB panel or LVDS panel,TV-out on HDMI V1.4
|-
| Video || Multi-format FHD video decoding, including Mpeg1/2, Mpeg4, H.263, H.264, etc H.264 decode up to 1080P60,support video encodeing:High-deinition$HD$H.264 video encoder is up to 1080P@45fps
|-
| Audio outputs || HDMI, analog audio $via 3.5 mm TRRS jack$, I2S audio $also potentially for audio input$
|-
| Camera || A CSI input connector Camera:Supports 8-bit YUV422 CMOS sensor interface,Supports CCIR656 protocol for NTSC and PAL,Supports 5M pixel camera sensor ,Supports video capture solution up to 1080p@30fps
|-
| Audio input || On board microphone
|-
| USB || 4 USB 2.0 host, 1 USB 2.0 OTG
|-
| Buttons || Reset button, Power button, U-boot button
|-
| Leds || Power status Led and RJ45 Led
|-
| IR || No onboard IR receiver
|-
| DC Power || 5V/2A with micro USB port
|-
| battery || No 3.7V lithium battery power support
|-
| Sizes || 85mmX56mm,same size as raspberry pi 3
|-
| Weight || 40g
|-
|}

==GPIO PIN 定义 ==

Banana Pi BPI-M2 Ultra has a 40-pin GPIO header that matches that of the Model Raspberry Pi 3. Following is the Banana Pi GPIO Pinout:

[[File:Gpio define.png]]

{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''40 PIN GPIO of Banana pi BPI-M2 Ultra'''
|-
|GPIO Pin Name || Default Function || Function2：GPIO || Function3
|-
| CON1-P01 || VCC-3V3 || ||
|-
| CON1-P02 || DCIN || ||
|-
| CON1-P03 || TWI2-SDA || PB21 || PWM5
|-
| CON1-P04 || DCIN || ||
|-
| CON1-P05 || TWI2-SCK || PB20 || PWM4
|-
| CON1-P06 || GND || ||
|-
| CON1-P07 || PB3 || PB3 || PWM1
|-
| CON1-P08 || UART2-TX || PI18 || SPI1\_MOSI
|-
| CON1-P09 || GND || ||
|-
| CON1-P10 || UART2-RX || PI19 || SPI1\_MISO
|-
| CON1-P11 || UART7-TX || PI20 || PWM2 |
|-
| CON1-P12 || UART2-CTS || PI17 || SPI1\_CLK
|-
| CON1-P13 || UART7-RX || PI21 || PWM3
|-
| CON1-P14 || GND || ||
|-
| CON1-P15 || PH25 || PH25 || CSI1-FIELD
|-
| CON1-P16 || UART2-RTS || PI16 || SPI1\_CS0
|-
| CON1-P17 || VCC-3V3 || ||
|-
| CON1-P18 || PH26 || PH26 || CSI1-HSYNC
|-
| CON1-P19 || SPI0\_MOSI || PC0 ||
|-
| CON1-P20 || GND || ||
|-
| CON1-P21 || SPI0\_MISO || PC1 ||
|-
| CON1-P22 || PH27 || PH27 || CSI1-VSYNC
|-
| CON1-P23 || SPI0\_CLK || PC2 ||
|-
| CON1-P24 || SPI0\_CS || PC23 ||
|-
| CON1-P25 || GND || ||
|-
| CON1-P26 || PH24 || PH24 || CSI1-PCLK
|-
| CON1-P27 || TWI3-SDA || PI1 ||
|-
| CON1-P28 || TWI3-SCK || PI0 ||
|-
| CON1-P29 || PH0 || PH0 || CSI1-D0
|-
| CON1-P30 || GND || ||
|-
| CON1-P31 || PH1 || PH1 || CSI1-D1
|-
| CON1-P32 || PD20 || PD20 || CSI1-MCLK
|-
| CON1-P33 || PH2 || PH2 || CSI1-D2
|-
| CON1-P34 || GND || ||
|-
| CON1-P35 || PH3 || PH3 || CSI1-D3
|-
| CON1-P36 || UART5-RX || PH7 || CSI1-D7
|-
| CON1-P37 || UART4-TX || PH4 || CSI1-D4
|-
| CON1-P38 || UART5-TX || PH6 || CSI1-D6
|-
| ON1-P39 || GND || ||
|-
| CON1-P40 || UART4-RX || PH5 || CSI1-D5
|-
|}

'''CSI Camera Connector specification:'''

The CSI Camera Connector is a 24-pin FPC connector which can connect external camera module with proper signal pin mappings. The pin definitions of the CSI interface are shown as below. This is marked on the Banana Pi board as “Camera”.

{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''CSi Camera connector GPIO of Banana pi BPI-M2 Ultra'''
|-
| CSI Pin Name || Default Function || Function2：GPIO
|-
| CN5-P01 || NC ||
|-
| CN5-P02 || GND ||
|-
| CN5-P03 || CSI0-SDA || PI3
|-
| CN5-P04 || CSI0-AVDD ||
|-
| CN5-P05 || CSI0-SCK || PI2
|-
| CN5-P06 || CSI0-Reset || PI7
|-
| CN5-P07 || CSI0-VSYNC || PE3
|-
| CN5-P08 || CSI0-PWDN || PI6
|-
| CN5-P09 || CSI0-HSYNC || PE2
|-
| CN5-P10 || CSI0-DVDD ||
|-
| CN5-P11 || CSI0-DOVDD ||
|-
| CN5-P12 || CSI0-D7 || PE11
|-
| CN5-P13 || CSI0-MCLK || PE1
|-
| CN5-P14 || CSI0-D6 || PE10
|-
| CN5-P15 || GND ||
|-
| CN5-P16 || CSI0-D5 || PE9
|-
| CN5-P17 || CSI0-PCLK || PE0
|-
| CN5-P18 || CSI0-D4 || PE8
|-
| CN5-P19 || CSI0-D0 || PE4
|-
| CN5-P20 || CSI0-D3 || PE7
|-
| CN5-P21 || CSI0-D1 || PE5
|-
| CN5-P22 || CSI0-D2 || PE6
|-
| CN5-P23 || GND ||
|-
| CN5-P24 || CSI0-AFVCC ||
|-
|}

'''Display specification'''

MIPI DSI $Display Serial Interface$

The display Connector is a 40-pin FPC connector which can connect external LCD panel $MIPI DSI$ and touch screen $I2C$ module as well. The pin definitions of this connector are shown as below. This is marked on the Banana Pi board as “DSI”.

{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''40 PIN GPIO of Banana pi BPI-M2 Ultra'''
|-
| DSI Pin Name || Default Function || Function2：GPIO
|-
| CN6-P01 || VCC-3V3 ||
|-
| CN6-P02 || IPSOUT ||
|-
| CN6-P03 || VCC-3V3 ||
|-
| CN6-P04 || IPSOUT ||
|-
| CN6-P05 || GND ||
|-
| CN6-P06 || IPSOUT ||
|-
| CN6-P07 || GND ||
|-
| CN6-P08 || IPSOUT ||
|-
| CN6-P09 || NC ||
|-
| CN6-P10 || GND ||
|-
| CN6-P11 || NC ||
|-
| CN6-P12 || DSI-D0N ||
|-
| CN6-P13 || NC ||
|-
| CN6-P14 || DSI-D0P ||
|-
| CN6-P15 || NC ||
|-
| CN6-P16 || GND ||
|-
| CN6-P17 || TWI0-SDA || PB19
|-
| CN6-P18 || DSI-D1N ||
|-
| CN6-P19 || TWI0-SCK || PB18
|-
| CN6-P20 || DSI-D1P ||
|-
| CN6-P21 || CTP-INT || PI10
|-
| CN6-P22 || GND ||
|-
| CN6-P23 || CTP-RST || PI11
|-
| CN6-P24 || DSI-CKN ||
|-
| CN6-P25 || GND ||
|-
| CN6-P26 || DSI-CKP ||
|-
| CN6-P27 || LCD-BL-EN || PH16
|-
| CN6-P28 || GND ||
|-
| CN6-P29 || LCD-RST || PH17
|-
| CN6-P30 || DSI-D2N ||
|-
| CN6-P31 || LCD-PWR-EN || PH18
|-
| CN6-P32 || DSI-D2P ||
|-
| CN6-P33 ||GND ||
|-
| CN6-P34 || GND ||
|-
| CN6-P35 || LCD-PWM || PB2
|-
| CN6-P36 || DSI-D3N ||
|-
| CN6-P37 || GND ||
|-
| CN6-P38 || DSI-D3P ||
|-
| CN6-P39 || NC ||
|-
| CN6-P40 || GND ||
|-
|}

'''UART specification:'''

The header CON4 is the UART interface. For developers of Banana Pi, this is an easy way to get the UART console output to check the system status and log message.

{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''CON4 Uart GPIO of Banana pi BPI-M2 Ultra'''
|-
| CON2 Pin Name || Default Function || GPIO
|-
| CON2 P03 || UART0-TXD ||
|-
| CON2 P02 || UART0-RXD||
|-
| CON2 P01 || GND||
|-
|}

=软件=

==TinaLinux==
Allwinner Tina-IoT os for BPI-M2 Ultra/BPI-M2 Berry

=软件开发=

==Basic Development==

=开发资源=

* 原理图下载 [https://drive.google.com/file/d/0B4PAo2nW2KfnTEMtNXpJWEJDTmc/view?usp=sharing BPI-M2 Berry Schematics]
* DXF结构文档下载 [https://drive.google.com/file/d/0B4PAo2nW2Kfnci1xaHd5eWtseEU/view?usp=sharing BPI-M2 Berry dxf file]
* Allwinner R40/V40 规格书
::[https://drive.google.com/file/d/0B4PAo2nW2KfneE54VzVOdHpITzA/view?usp=sharing Allwinner V40 芯片规格书]
::[https://drive.google.com/file/d/0B4PAo2nW2KfnbVp2TmRMYUdPUGM/view?usp=sharing Allwinner R40 芯片规格书]
::[https://github.com/tinalinux/docs/blob/r40-v1.y/Allwinner\_R40\_User\_Manual\_V1.0.pdf Allwinner R40 芯片用户使用手册 v1.0]
::[https://drive.google.com/file/d/0B4PAo2nW2KfnM2pnT19zZW5qOTA/view?usp=sharing axp221s PMU datasheet]
* Banana pi BPI-M2 Berry CE,FCC,RoHS 认证证书
::[https://bananapi.gitbooks.io/bpi-m2-ultra-open-source-single-board-computer/content/bpi-m2-berry-cefcc-rohs-certification.html CE FCC RoHS 证书]

=镜像发布=
== Android 6.0==
*2017-08-25 update
*HDMI-Version
::Google Drive : https://drive.google.com/open?id=0B_YnvHgh2rwjMlVUN2ZGcHIwdUE
::Baidu Cloud : MD5: c65fa4c20b8a6d2d05bfd32b090c3570
*LCD5-Version
::Google Drive : https://drive.google.com/open?id=0B_YnvHgh2rwjWGRVay1va1oyWDg
::Baidu Cloud : MD5:f664e5fe0af20ebfc06ddc50bac1845b
*LCD7-Version
::google Drive : https://drive.google.com/open?id=0B_YnvHgh2rwjSHduUmRhSXR2Wlk
::baidu Cloud : MD5: 6cda3453d9524643c8f92fcdc8deb32f
*forum pthread : http://forum.banana-pi.org/t/bpi-m2-ultra-bpi-m2-berry-new-image-android-6-0-version-v1-2017-08-25/3731

==Ubuntu==
===3.10 kernel===
*2019-05-13 update banana pi M2U board which is based on A40I, R40, V40, and it is based on Ubuntu 16.04 & Raspbian 9 & Debian 9 Operation system with kernel 3.10.108
::BPI-M2U Ubuntu 16.04 Features Map:http://wiki.banana-pi.org/M2U/Berry_Image_Map#Ubuntu_16.04
::Desktop images:
::::Google Drive : https://drive.google.com/open?id=1TpRMMcm50kQTXOOLXp65npTWovd7jCYc
::::Baidu Drive : https://pan.baidu.com/s/1-8nAN7RXVqVbJg3CUQnRzQ (PinCode:fnpt)
::::MD5 : cde8fd1165b54c633bcc5288e8447c2b
::Server images:
::::Google Drive : https://drive.google.com/open?id=1vcuIpQ7O2SFB3cZ4UemOqR2hQkxHy3RF
::::Baidu Drive : https://pan.baidu.com/s/18Cp7zeuHxa82z5OU_tV_oQ (PinCode：qat4)
::::MD5 : 07981887a7a21f5cda72ab8a1e37a834
::Forum pthread : http://forum.banana-pi.org/t/bpi-m2u-berry-new-image-release-ubuntu-16-04-raspbian-9-4-debian-9-4-2019-05-13/9225

*2018-01-04 update BPI-M2 Ultra/Berry Ubuntu 16.04 image
::Google Drive : https://drive.google.com/file/d/1G4Ggkne63ofD51Yt2c-x5-qy9h7BgY4_/view?usp=sharing
::baidu cloud : https://pan.baidu.com/s/1cFHYGY1
::MD5: a61e6f66a5ea2288fff0c3acff12d633
*2017-11-13 update
::Google Drive : https://drive.google.com/file/d/19PI9yuL9iFa4bU6dh7ym3tcCHhjAh-cM/view?usp=sharing
::baidu cloud : http://pan.baidu.com/s/1nvccOlz
::MD5: 4655b896a3c4e1958a15bb8ca45ac4fe
::forum pthread : http://forum.banana-pi.org/t/bpi-m2-ultra-bpi-m2-berry-new-image-2017-11-13-ubuntu-16-04-mate-desktop-beta2-bpi-m2u-sd-emmc-img/4182

==Debian==
*2019-05-13 update banana pi M2U board which is based on A40I, R40, V40, and it is based on Ubuntu 16.04 & Raspbian 9 & Debian 9 Operation system with kernel 3.10.108
::BPI-M2U Debian 9 Features Map:http://wiki.banana-pi.org/M2U/Berry_Image_Map#Debian_9
::Desktop images :
::::Google Drive :
::::Baidu Drive : https://pan.baidu.com/s/1ZqDZT4dOQNyvsu0nT4oMTg (PinCode:kshd)
::::MD5 : 7e5d848f804bc5ffb8854a93d7488694
::Server images:
::::Google Drive : https://drive.google.com/open?id=1aoB8mGwSveNztB-EO_fBKLOr-GdzcMNV
::::Baidu Drive : https://pan.baidu.com/s/1V0djGvUR7QJFMeAgZV86zg (PinCode:e0t6)
::::MD5 : b7314d444dc13a40e1dd7b1602436f40
::Forum pthread : http://forum.banana-pi.org/t/bpi-m2u-berry-new-image-release-ubuntu-16-04-raspbian-9-4-debian-9-4-2019-05-13/9225

*2017-11-13 update debian-9-stretch-mate-desktop
::Google Drive : https://drive.google.com/file/d/0B_YnvHgh2rwjeTh4TmlnMGl5X3M/view?usp=sharing
::baidu cloud : http://pan.baidu.com/s/1c1LvS1y
::MD5: 0a1fad281c24902148b16276a79bac12
*2017-11-13 update debian-9-stretch-lite
::Google Drive: https://drive.google.com/file/d/0B_YnvHgh2rwjOWg1OW9heWZsYm8/view?usp=sharing
::baidu cloud: http://pan.baidu.com/s/1c3zxCy 13
::MD5: cff677aa94ca5345fc6e26379cfe4e95
*forum pthread : http://forum.banana-pi.org/t/bpi-m2-ultra-bpi-m2-berry-new-image-2017-08-28-debian-sd-emmc-img/3745/2

==Rasbian==
*2019-05-13 update banana pi M2U board which is based on A40I, R40, V40, and it is based on Ubuntu 16.04 & Raspbian 9 & Debian 9 Operation system with kernel 3.10.108
::BPI-M2U Raspbian 9 Features Map:http://wiki.banana-pi.org/M2U/Berry_Image_Map#Raspbian_9.4
::Desktop image :
::::Google Drive : https://drive.google.com/open?id=16bDXcoKycZSGQgzh-L3bQYBpEs8HtRZF
::::Baidu Drive : https://pan.baidu.com/s/115a-o-qKxI3YDkEAdmGevQ (PinCode:6hxx)
::::MD5 : f7ee24ff15654724e2c7ec3bf72c8506
::Forum pthread : http://forum.banana-pi.org/t/bpi-m2u-berry-new-image-release-ubuntu-16-04-raspbian-9-4-debian-9-4-2019-05-13/9225

*2018-05-24 update Raspbian jessie 8.0 V1.1
::Google Drive : https://drive.google.com/file/d/0B_YnvHgh2rwjRGlUMUdqZk5ETDg/view?usp=sharing
::baidu cloud : https://pan.baidu.com/s/1UnMPtGBNp3-8KHDZPhVOUg
::forum pthread : http://forum.banana-pi.org/t/banana-pi-bpi-m2u-berry-new-image-release-raspbian-jessie-8-0-2018-5-24/5812

*2017-05-25 update raspbian jessie
::Google Drive : https://drive.google.com/file/d/0B_YnvHgh2rwjRGlUMUdqZk5ETDg/view?usp=sharing
::baidu cloud : https://pan.baidu.com/s/1civq4e
::MD5: 60e19ea9138d6841fa6852ece4727b0a
::forum pthread : http://forum.banana-pi.org/t/banana-pi-bpi-m2-ultra-bpi-m2-berry-new-image-2017-05-25-raspbian-jessie-preview3-bpi-m2u-sd-emmc-img/3306

==Armbian==

*Armbain have support BPI-M2 Ultra/BPI-M2 Berry，Armbian Bionic btea and Armbian Stretch beta version
::image download ： https://www.armbian.com/bananapi-m2u/
::Boot logs : http://ix.io/1kVQ
::Forum pthread : http://forum.banana-pi.org/t/armbian-bionic-and-stretch/6573

==Tina IoT Linux ==
*BPI-M2 Ultra / BPI-M2 Berry support Allwinner TinaLinux .
::more please see : [[Tina Linux]]

==RPiTC v3 1.12==
*2017-11-28 updtae
*RPiTC v3 1.12 for Banana Pi (BPI-M2U/BPI-M2B/BPI-M2P/BPI-M3/BPI-M64/BPI-R2): [http://forum.banana-pi.org/t/rpitc-v3-1-12-for-banana-pi-bpi-m2u-bpi-m2b-bpi-m2p-bpi-m3-bpi-m64-bpi-r2/4292 download link]

==其他==
* kali linux,crux linux,archlinux,centos linux for BPI-M2 Ultra & BPI-M2 Berry : [http://forum.banana-pi.org/t/bpi-m2-ultra-bpi-m2-berry-new-image-2017-8-28-kali-linux-crux-linux-archlinux-centos-linux-image/3750 kali linux,crux linux,archlinux,centos linux 2017-08-25]

* please download here: http://forum.banana-pi.org/c/Banana-pi-BPI-M2-Ultra/M2Uimage

=FAQ=

香蕉派 BPI-M2 Berry

2023-06-27T06:34:34Z

Qubot: /* 硬件规格表 */

[[en:Banana_Pi_BPI-M2_Berry]]

=产品介绍=

[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|Overview]]
[[File:Banana_pi_BPI-M2_Berry_4.jpg|thumb|Overview:front]]
[[File:Banana_pi_BPI-M2_Berry_3.JPG|thumb|Overview:back]]
[[File:R40_for_vehicle_license_plate_recognition.JPG|thumb|BPI-M2 Berry for BPI 4.0 [[Successful case]] ：R40 for vehicle license plate recognition ]]
[[File:R40_for_IoT_gateway.JPG|thumb|BPI-M2 Berry for BPI 4.0 [[Successful case]] ：R40 for IoT gateway with Z-wave, zigbee,WiFI]]

香蕉派 BPI-M2 Berry 四核单板计算机采用全志 R40/V40芯片开发。支持板载Wifi与蓝牙，支持SATA接口，可以直接接硬盘。板上有SD卡插座，可以从SD卡启动系统镜像。

Banana PI BPI-M2 Berry 兼容性强大,可以跑android系统,Debian linux,Ubuntu linux, Raspberry Pi系统和全志TinaLinux系统.

Banana PI BPI-M2 Berry硬件：全志R40/V40四核处理器，1GB LPDDR3内存，千兆以太网口，4 USB 接口流畅运行Android5.1。Banana PI BPI-M2 Berry尺寸与树莓派 3完全一样，可以直接使用树莓派3的外壳。GPIO兼容Raspberry Pi 3并能运行rasbian 系统。

[[File:Banana_Pi_BPI-M2_Berry.jpg]]

作为香蕉派家族的一员，BPI-M2 Berry是香蕉皮M1/M1+的直接升级版，支持SATA。

板子的尺寸与接口都和树莓派3一样，所以你可以用树莓派3的外壳等配件直接用在BPI-M2 Berry

==主要特点==

* Allwinner R40/V40 Quad Core ARM Cortex A7 CPU
* 1GB DDR3 SDRAM.
* WiFi (AP6212) & Bluetooth onboard.
* SATA Interface.
* 4*USB 2.0
* MIPI DSI ingerface
* CSI camera interface

==如何开始使用==
*镜像烧录及快速开始使用 : [[快速上手香蕉派镜像烧录与系统启动]]

*开发快速入门:[[快速上手香蕉派 BPI-M2 Ultra / BPI-M2 Berry]]

=硬件介绍=
==硬件接口==
[[File:M2ubinterface.jpg]]

==硬件规格表==
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''HardWare Specification of Banana pi BPI-M2 Berry'''
|-
|Soc || Allwinner R40/V40/A40I
|-
| CPU || quad-core cortex -A7,the most power efficient CPU core ARM's ever development
|-
| GPU || dual-core MALI-400 MP2 and runs at 500MHz, capable of 1.1 Gpixel/s throughput. Graphics capabilities are slightly higher than the original Xbox’s level of performance. The GPU provides OpenGL ES 2.0, hardware-accelerated OpenVG, 1080p45 H.264 high-profile encode and decode.
|-
| SDRAM || 1GB DDR3 with 733MHz$shared with GPU$
|-
| SATA || suppoort SATA interface
|-
| GPIO || 40 Pins Header, 28×GPIO, some of which can be used for specific functions including UART, I2C, SPI, PWM, I2S.
|-
| On board Network || 10/100/1000Mbps Ethernet $Realtek RTL8211E/D$
|-
| Wifi Module || WiFi 802.11 b/g/n $AP 6212 module on board$
|-
| Bluetooth || BT4.0
|-
| On board Storage || MicroSD $TF$ card,No eMMC onboard
|-
| Display || 4-lane MIPI DSI display,or RGB panel or LVDS panel,TV-out on HDMI V1.4
|-
| Video || Multi-format FHD video decoding, including Mpeg1/2, Mpeg4, H.263, H.264, etc H.264 decode up to 1080P60,support video encodeing:High-deinition$HD$H.264 video encoder is up to 1080P@45fps
|-
| Audio outputs || HDMI, analog audio $via 3.5 mm TRRS jack$, I2S audio $also potentially for audio input$
|-
| Camera || A CSI input connector Camera:Supports 8-bit YUV422 CMOS sensor interface,Supports CCIR656 protocol for NTSC and PAL,Supports 5M pixel camera sensor ,Supports video capture solution up to 1080p@30fps
|-
| Audio input || On board microphone
|-
| USB || 4 USB 2.0 host, 1 USB 2.0 OTG
|-
| Buttons || Reset button, Power button, U-boot button
|-
| Leds || Power status Led and RJ45 Led
|-
| IR || No onboard IR receiver
|-
| DC Power || 5V/2A with micro USB port
|-
| battery || No 3.7V lithium battery power support
|-
| Sizes || 85mmX56mm,same size as raspberry pi 3
|-
| Weight || 40g
|-
|}

==GPIO PIN 定义 ==

Banana Pi BPI-M2 Ultra has a 40-pin GPIO header that matches that of the Model Raspberry Pi 3. Following is the Banana Pi GPIO Pinout:

[[File:Gpio define.png]]

{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''40 PIN GPIO of Banana pi BPI-M2 Ultra'''
|-
|GPIO Pin Name || Default Function || Function2：GPIO || Function3
|-
| CON1-P01 || VCC-3V3 || ||
|-
| CON1-P02 || DCIN || ||
|-
| CON1-P03 || TWI2-SDA || PB21 || PWM5
|-
| CON1-P04 || DCIN || ||
|-
| CON1-P05 || TWI2-SCK || PB20 || PWM4
|-
| CON1-P06 || GND || ||
|-
| CON1-P07 || PB3 || PB3 || PWM1
|-
| CON1-P08 || UART2-TX || PI18 || SPI1\_MOSI
|-
| CON1-P09 || GND || ||
|-
| CON1-P10 || UART2-RX || PI19 || SPI1\_MISO
|-
| CON1-P11 || UART7-TX || PI20 || PWM2 |
|-
| CON1-P12 || UART2-CTS || PI17 || SPI1\_CLK
|-
| CON1-P13 || UART7-RX || PI21 || PWM3
|-
| CON1-P14 || GND || ||
|-
| CON1-P15 || PH25 || PH25 || CSI1-FIELD
|-
| CON1-P16 || UART2-RTS || PI16 || SPI1\_CS0
|-
| CON1-P17 || VCC-3V3 || ||
|-
| CON1-P18 || PH26 || PH26 || CSI1-HSYNC
|-
| CON1-P19 || SPI0\_MOSI || PC0 ||
|-
| CON1-P20 || GND || ||
|-
| CON1-P21 || SPI0\_MISO || PC1 ||
|-
| CON1-P22 || PH27 || PH27 || CSI1-VSYNC
|-
| CON1-P23 || SPI0\_CLK || PC2 ||
|-
| CON1-P24 || SPI0\_CS || PC23 ||
|-
| CON1-P25 || GND || ||
|-
| CON1-P26 || PH24 || PH24 || CSI1-PCLK
|-
| CON1-P27 || TWI3-SDA || PI1 ||
|-
| CON1-P28 || TWI3-SCK || PI0 ||
|-
| CON1-P29 || PH0 || PH0 || CSI1-D0
|-
| CON1-P30 || GND || ||
|-
| CON1-P31 || PH1 || PH1 || CSI1-D1
|-
| CON1-P32 || PD20 || PD20 || CSI1-MCLK
|-
| CON1-P33 || PH2 || PH2 || CSI1-D2
|-
| CON1-P34 || GND || ||
|-
| CON1-P35 || PH3 || PH3 || CSI1-D3
|-
| CON1-P36 || UART5-RX || PH7 || CSI1-D7
|-
| CON1-P37 || UART4-TX || PH4 || CSI1-D4
|-
| CON1-P38 || UART5-TX || PH6 || CSI1-D6
|-
| ON1-P39 || GND || ||
|-
| CON1-P40 || UART4-RX || PH5 || CSI1-D5
|-
|}

'''CSI Camera Connector specification:'''

The CSI Camera Connector is a 24-pin FPC connector which can connect external camera module with proper signal pin mappings. The pin definitions of the CSI interface are shown as below. This is marked on the Banana Pi board as “Camera”.

{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''CSi Camera connector GPIO of Banana pi BPI-M2 Ultra'''
|-
| CSI Pin Name || Default Function || Function2：GPIO
|-
| CN5-P01 || NC ||
|-
| CN5-P02 || GND ||
|-
| CN5-P03 || CSI0-SDA || PI3
|-
| CN5-P04 || CSI0-AVDD ||
|-
| CN5-P05 || CSI0-SCK || PI2
|-
| CN5-P06 || CSI0-Reset || PI7
|-
| CN5-P07 || CSI0-VSYNC || PE3
|-
| CN5-P08 || CSI0-PWDN || PI6
|-
| CN5-P09 || CSI0-HSYNC || PE2
|-
| CN5-P10 || CSI0-DVDD ||
|-
| CN5-P11 || CSI0-DOVDD ||
|-
| CN5-P12 || CSI0-D7 || PE11
|-
| CN5-P13 || CSI0-MCLK || PE1
|-
| CN5-P14 || CSI0-D6 || PE10
|-
| CN5-P15 || GND ||
|-
| CN5-P16 || CSI0-D5 || PE9
|-
| CN5-P17 || CSI0-PCLK || PE0
|-
| CN5-P18 || CSI0-D4 || PE8
|-
| CN5-P19 || CSI0-D0 || PE4
|-
| CN5-P20 || CSI0-D3 || PE7
|-
| CN5-P21 || CSI0-D1 || PE5
|-
| CN5-P22 || CSI0-D2 || PE6
|-
| CN5-P23 || GND ||
|-
| CN5-P24 || CSI0-AFVCC ||
|-
|}

'''Display specification'''

MIPI DSI $Display Serial Interface$

The display Connector is a 40-pin FPC connector which can connect external LCD panel $MIPI DSI$ and touch screen $I2C$ module as well. The pin definitions of this connector are shown as below. This is marked on the Banana Pi board as “DSI”.

{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''40 PIN GPIO of Banana pi BPI-M2 Ultra'''
|-
| DSI Pin Name || Default Function || Function2：GPIO
|-
| CN6-P01 || VCC-3V3 ||
|-
| CN6-P02 || IPSOUT ||
|-
| CN6-P03 || VCC-3V3 ||
|-
| CN6-P04 || IPSOUT ||
|-
| CN6-P05 || GND ||
|-
| CN6-P06 || IPSOUT ||
|-
| CN6-P07 || GND ||
|-
| CN6-P08 || IPSOUT ||
|-
| CN6-P09 || NC ||
|-
| CN6-P10 || GND ||
|-
| CN6-P11 || NC ||
|-
| CN6-P12 || DSI-D0N ||
|-
| CN6-P13 || NC ||
|-
| CN6-P14 || DSI-D0P ||
|-
| CN6-P15 || NC ||
|-
| CN6-P16 || GND ||
|-
| CN6-P17 || TWI0-SDA || PB19
|-
| CN6-P18 || DSI-D1N ||
|-
| CN6-P19 || TWI0-SCK || PB18
|-
| CN6-P20 || DSI-D1P ||
|-
| CN6-P21 || CTP-INT || PI10
|-
| CN6-P22 || GND ||
|-
| CN6-P23 || CTP-RST || PI11
|-
| CN6-P24 || DSI-CKN ||
|-
| CN6-P25 || GND ||
|-
| CN6-P26 || DSI-CKP ||
|-
| CN6-P27 || LCD-BL-EN || PH16
|-
| CN6-P28 || GND ||
|-
| CN6-P29 || LCD-RST || PH17
|-
| CN6-P30 || DSI-D2N ||
|-
| CN6-P31 || LCD-PWR-EN || PH18
|-
| CN6-P32 || DSI-D2P ||
|-
| CN6-P33 ||GND ||
|-
| CN6-P34 || GND ||
|-
| CN6-P35 || LCD-PWM || PB2
|-
| CN6-P36 || DSI-D3N ||
|-
| CN6-P37 || GND ||
|-
| CN6-P38 || DSI-D3P ||
|-
| CN6-P39 || NC ||
|-
| CN6-P40 || GND ||
|-
|}

'''UART specification:'''

The header CON4 is the UART interface. For developers of Banana Pi, this is an easy way to get the UART console output to check the system status and log message.

{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''CON4 Uart GPIO of Banana pi BPI-M2 Ultra'''
|-
| CON2 Pin Name || Default Function || GPIO
|-
| CON2 P03 || UART0-TXD ||
|-
| CON2 P02 || UART0-RXD||
|-
| CON2 P01 || GND||
|-
|}

=软件=

==TinaLinux==
Allwinner Tina-IoT os for BPI-M2 Ultra/BPI-M2 Berry

=软件开发=

==Basic Development==

=开发资源=

* 原理图下载 [https://drive.google.com/file/d/0B4PAo2nW2KfnTEMtNXpJWEJDTmc/view?usp=sharing BPI-M2 Berry Schematics]
* DXF结构文档下载 [https://drive.google.com/file/d/0B4PAo2nW2Kfnci1xaHd5eWtseEU/view?usp=sharing BPI-M2 Berry dxf file]
* Allwinner R40/V40 规格书
::[https://drive.google.com/file/d/0B4PAo2nW2KfneE54VzVOdHpITzA/view?usp=sharing Allwinner V40 芯片规格书]
::[https://drive.google.com/file/d/0B4PAo2nW2KfnbVp2TmRMYUdPUGM/view?usp=sharing Allwinner R40 芯片规格书]
::[https://github.com/tinalinux/docs/blob/r40-v1.y/Allwinner\_R40\_User\_Manual\_V1.0.pdf Allwinner R40 芯片用户使用手册 v1.0]
::[https://drive.google.com/file/d/0B4PAo2nW2KfnM2pnT19zZW5qOTA/view?usp=sharing axp221s PMU datasheet]
* Banana pi BPI-M2 Berry CE,FCC,RoHS 认证证书
::[https://bananapi.gitbooks.io/bpi-m2-ultra-open-source-single-board-computer/content/bpi-m2-berry-cefcc-rohs-certification.html CE FCC RoHS 证书]

=镜像发布=
== Android 6.0==
*2017-08-25 update
*HDMI-Version
::Google Drive : https://drive.google.com/open?id=0B_YnvHgh2rwjMlVUN2ZGcHIwdUE
::Baidu Cloud : MD5: c65fa4c20b8a6d2d05bfd32b090c3570
*LCD5-Version
::Google Drive : https://drive.google.com/open?id=0B_YnvHgh2rwjWGRVay1va1oyWDg
::Baidu Cloud : MD5:f664e5fe0af20ebfc06ddc50bac1845b
*LCD7-Version
::google Drive : https://drive.google.com/open?id=0B_YnvHgh2rwjSHduUmRhSXR2Wlk
::baidu Cloud : MD5: 6cda3453d9524643c8f92fcdc8deb32f
*forum pthread : http://forum.banana-pi.org/t/bpi-m2-ultra-bpi-m2-berry-new-image-android-6-0-version-v1-2017-08-25/3731

==Ubuntu==
===3.10 kernel===
*2019-05-13 update banana pi M2U board which is based on A40I, R40, V40, and it is based on Ubuntu 16.04 & Raspbian 9 & Debian 9 Operation system with kernel 3.10.108
::BPI-M2U Ubuntu 16.04 Features Map:http://wiki.banana-pi.org/M2U/Berry_Image_Map#Ubuntu_16.04
::Desktop images:
::::Google Drive : https://drive.google.com/open?id=1TpRMMcm50kQTXOOLXp65npTWovd7jCYc
::::Baidu Drive : https://pan.baidu.com/s/1-8nAN7RXVqVbJg3CUQnRzQ (PinCode:fnpt)
::::MD5 : cde8fd1165b54c633bcc5288e8447c2b
::Server images:
::::Google Drive : https://drive.google.com/open?id=1vcuIpQ7O2SFB3cZ4UemOqR2hQkxHy3RF
::::Baidu Drive : https://pan.baidu.com/s/18Cp7zeuHxa82z5OU_tV_oQ (PinCode：qat4)
::::MD5 : 07981887a7a21f5cda72ab8a1e37a834
::Forum pthread : http://forum.banana-pi.org/t/bpi-m2u-berry-new-image-release-ubuntu-16-04-raspbian-9-4-debian-9-4-2019-05-13/9225

*2018-01-04 update BPI-M2 Ultra/Berry Ubuntu 16.04 image
::Google Drive : https://drive.google.com/file/d/1G4Ggkne63ofD51Yt2c-x5-qy9h7BgY4_/view?usp=sharing
::baidu cloud : https://pan.baidu.com/s/1cFHYGY1
::MD5: a61e6f66a5ea2288fff0c3acff12d633
*2017-11-13 update
::Google Drive : https://drive.google.com/file/d/19PI9yuL9iFa4bU6dh7ym3tcCHhjAh-cM/view?usp=sharing
::baidu cloud : http://pan.baidu.com/s/1nvccOlz
::MD5: 4655b896a3c4e1958a15bb8ca45ac4fe
::forum pthread : http://forum.banana-pi.org/t/bpi-m2-ultra-bpi-m2-berry-new-image-2017-11-13-ubuntu-16-04-mate-desktop-beta2-bpi-m2u-sd-emmc-img/4182

==Debian==
*2019-05-13 update banana pi M2U board which is based on A40I, R40, V40, and it is based on Ubuntu 16.04 & Raspbian 9 & Debian 9 Operation system with kernel 3.10.108
::BPI-M2U Debian 9 Features Map:http://wiki.banana-pi.org/M2U/Berry_Image_Map#Debian_9
::Desktop images :
::::Google Drive :
::::Baidu Drive : https://pan.baidu.com/s/1ZqDZT4dOQNyvsu0nT4oMTg (PinCode:kshd)
::::MD5 : 7e5d848f804bc5ffb8854a93d7488694
::Server images:
::::Google Drive : https://drive.google.com/open?id=1aoB8mGwSveNztB-EO_fBKLOr-GdzcMNV
::::Baidu Drive : https://pan.baidu.com/s/1V0djGvUR7QJFMeAgZV86zg (PinCode:e0t6)
::::MD5 : b7314d444dc13a40e1dd7b1602436f40
::Forum pthread : http://forum.banana-pi.org/t/bpi-m2u-berry-new-image-release-ubuntu-16-04-raspbian-9-4-debian-9-4-2019-05-13/9225

*2017-11-13 update debian-9-stretch-mate-desktop
::Google Drive : https://drive.google.com/file/d/0B_YnvHgh2rwjeTh4TmlnMGl5X3M/view?usp=sharing
::baidu cloud : http://pan.baidu.com/s/1c1LvS1y
::MD5: 0a1fad281c24902148b16276a79bac12
*2017-11-13 update debian-9-stretch-lite
::Google Drive: https://drive.google.com/file/d/0B_YnvHgh2rwjOWg1OW9heWZsYm8/view?usp=sharing
::baidu cloud: http://pan.baidu.com/s/1c3zxCy 13
::MD5: cff677aa94ca5345fc6e26379cfe4e95
*forum pthread : http://forum.banana-pi.org/t/bpi-m2-ultra-bpi-m2-berry-new-image-2017-08-28-debian-sd-emmc-img/3745/2

==Rasbian==
*2019-05-13 update banana pi M2U board which is based on A40I, R40, V40, and it is based on Ubuntu 16.04 & Raspbian 9 & Debian 9 Operation system with kernel 3.10.108
::BPI-M2U Raspbian 9 Features Map:http://wiki.banana-pi.org/M2U/Berry_Image_Map#Raspbian_9.4
::Desktop image :
::::Google Drive : https://drive.google.com/open?id=16bDXcoKycZSGQgzh-L3bQYBpEs8HtRZF
::::Baidu Drive : https://pan.baidu.com/s/115a-o-qKxI3YDkEAdmGevQ (PinCode:6hxx)
::::MD5 : f7ee24ff15654724e2c7ec3bf72c8506
::Forum pthread : http://forum.banana-pi.org/t/bpi-m2u-berry-new-image-release-ubuntu-16-04-raspbian-9-4-debian-9-4-2019-05-13/9225

*2018-05-24 update Raspbian jessie 8.0 V1.1
::Google Drive : https://drive.google.com/file/d/0B_YnvHgh2rwjRGlUMUdqZk5ETDg/view?usp=sharing
::baidu cloud : https://pan.baidu.com/s/1UnMPtGBNp3-8KHDZPhVOUg
::forum pthread : http://forum.banana-pi.org/t/banana-pi-bpi-m2u-berry-new-image-release-raspbian-jessie-8-0-2018-5-24/5812

*2017-05-25 update raspbian jessie
::Google Drive : https://drive.google.com/file/d/0B_YnvHgh2rwjRGlUMUdqZk5ETDg/view?usp=sharing
::baidu cloud : https://pan.baidu.com/s/1civq4e
::MD5: 60e19ea9138d6841fa6852ece4727b0a
::forum pthread : http://forum.banana-pi.org/t/banana-pi-bpi-m2-ultra-bpi-m2-berry-new-image-2017-05-25-raspbian-jessie-preview3-bpi-m2u-sd-emmc-img/3306

==Armbian==

*Armbain have support BPI-M2 Ultra/BPI-M2 Berry，Armbian Bionic btea and Armbian Stretch beta version
::image download ： https://www.armbian.com/bananapi-m2u/
::Boot logs : http://ix.io/1kVQ
::Forum pthread : http://forum.banana-pi.org/t/armbian-bionic-and-stretch/6573

==Tina IoT Linux ==
*BPI-M2 Ultra / BPI-M2 Berry support Allwinner TinaLinux .
::more please see : [[Tina Linux]]

==RPiTC v3 1.12==
*2017-11-28 updtae
*RPiTC v3 1.12 for Banana Pi (BPI-M2U/BPI-M2B/BPI-M2P/BPI-M3/BPI-M64/BPI-R2): [http://forum.banana-pi.org/t/rpitc-v3-1-12-for-banana-pi-bpi-m2u-bpi-m2b-bpi-m2p-bpi-m3-bpi-m64-bpi-r2/4292 download link]

==其他==
* kali linux,crux linux,archlinux,centos linux for BPI-M2 Ultra & BPI-M2 Berry : [http://forum.banana-pi.org/t/bpi-m2-ultra-bpi-m2-berry-new-image-2017-8-28-kali-linux-crux-linux-archlinux-centos-linux-image/3750 kali linux,crux linux,archlinux,centos linux 2017-08-25]

* please download here: http://forum.banana-pi.org/c/Banana-pi-BPI-M2-Ultra/M2Uimage

=FAQ=

Banana Pi BPI-R2 Pro

2023-06-26T08:45:05Z

Qubot: /* kernel linux-4.19.xx Release image */

[[zh:香蕉派 BPI-R2 Pro]]

=Summary=
[[File:Banana_Pi_BPI-R2_Pro_1_750.jpg|thumb|[[Banana Pi BPI-R2 Pro]] Rockchip RK3568 design]]
[[File:Banana_Pi_BPI-R2_Pro_3.jpg|thumb|[[Banana Pi BPI-R2 Pro]] Rockchip RK3568 design]]
[[File:Rockchip_RC3568.jpg|thumb|Rockchip RK3568 chip]]
[[File:BPI-R2_case_.jpg|thumb| BPI-R2 Pro case same as BPI-R2]]
[[File:BPI-RK3588_board_kit_2.jpg|thumb|[[BPI-RK3588 Core board and development Kit]]]]
[[File:Banana Pi BPI-W3 LGA 1.jpg|thumb|[[Banana Pi BPI-W3]] with Rockchip RK3588 chip design]]
[[File:Banana_Pi_BPI-R3_Router_2.jpg|thumb|[[Banana Pi BPI-R3]] with MediaTek MT7986(Filogic 830)]]
[[File:Banana_Pi_BPI-R3_Mini__1.jpg|thumb|[[Banana Pi BPI-R3 Mini]] with MediaTek MT7986(Filogic 830)]]
[[File:Banana_Pi_BPI-R3_Mini__case_1.jpg|thumb|[[Banana Pi BPI-R3 Mini]] with MediaTek MT7986(Filogic 830)]]
[[File:BPI-R64_3.JPG|thumb|[[Banana Pi BPI-R64]] with MediaTek MT7622]]
[[File:BPI-R2_3.JPG|thumb|[[Banana Pi BPI-R2]] with MTK MT7623N chip design]]
[[File:O2A0500.jpg|thumb|[[Banana Pi BPI-W2]] with Realtek RTK1296 chip design]]
[[File:Banana_pi_BPI-R1_1.JPG|thumb|[[Banana Pi BPI-R1]] with allwinner A20 chip design]]

==Introduction==
Banana Pi BPI-R2 Pro is the next generation smart router developement board from Banana Pi in 2021. It is powered by Rockchip RK 3568 processor.Onboard 2GB LPDDR4 memory and 16GB eMMC storage, and supports 2 USB 3.0 interface, 5 gigabit network port. M.2 key-E and mini PCIe interface, 2 mipi DSI interface(one can change to LVDS by software), 1 CSI camera interface,1 HDMI output,

[[File:Banana_Pi_BPI-R2_Pro_ban_.jpg]]

BPI-R2 Pro same size as [[Banana Pi BPI-R2]] , and interface is also same .so can use BPI-R2 case.

==Key Features==
* Rockchip RK3568 Quad-core ARM Cortex-A55 CPU
* Mali-G52 1-Core-2EE
* 2G LPDDR4 SDRAM (option 4G)
* Mini PCIE interface and M.2 key-e interface
* support 1 SATA interface
* MicroSD slot supports up to 256GB expansion
* 16G eMMC flash (option 16/32/64G)
* 2 MIPI display interface support
* 1 CSI camera interface
* 5 port 10/100/1000 Mb Ethernet port
* (2) USB 3.0 and (1) USB 2.0 otg port

==Rockchip RK3568==

RK3568 has built-in MICRO-research NPU of Rockchip, 0.8Tops computing power and integrated high performance AI accelerator RKNN NPU. Rockchip also provides developers with an easy-to-use model transformation tool, RKNN-Toolkit, which supports one-click transformation of Caffe/TensorFlow/TF-Lite/ONNX/PyTorch/Keras/Darknet mainstream architecture models.

RK3568 has rich interface expansion capabilities. Supports a variety of peripheral high-speed interfaces, supporting four USB2.0 ports, 4xUSB2.0 HOST+ 1xUSB3.0 HOST+ 1xusB3.0 OTG. Support gigabit Ethernet *2, multi-camera support, support MIPI CSI 4Lanes, can be divided into 2x2Lanes two groups of independent use support 16bit DVP interface, support BT1120 input, support VC mode. RK3568 has a complete display interface, support HDMI 2.0 output support dual channel MIPI DSI, dual channel LVDS, can drive 2.5K LCD screen, can directly drive ink screen, support eDp. RK3568 has plenty of peripherals, supporting 10x UART, 6x I2C, 16x PWM, 4x SPI, 8xSARADC and MINI PCIE.

Rockchip RK3568 chip is a general PURPOSE SoC designed for consumer industry applications. The CPU uses 4-core A55 architecture processor, integrated G52 GRAPHICS processor, built-in independent NPU, and runs Android 11 and Linux. RK3568 is mainly customized for tablet PC, speaker with screen, Android pen, dictionary pen and other consumer products, as well as face payment POS machine, e-book, cloud terminal, video phone, NAS storage and other industry products

==Getting Start==
[[Getting Started with R2PRO]]

=Hardware=

==Hardware interface==
[[File:Banana_Pi_BPI-R2_Pro_int_750.jpg]]

==Hardware spec ==

{| class="wikitable"
|-
!
! Banana Pi R2 Pro
|-
! CPU
| Rockchip RK3568 Quad-core ARM Cortex-A55 CPU 2GHz
|-
! GPU
| Mali-G52 1-Core-2EE OpenGL ES3.2 Vu1kn 1.1 OpenCL 2.0
|-
! Memory
| 2G DDR3 SDRAM (option 4G)
|-
! Storage
| Onboard 16GB eMMC Flash, Micro SD-Card slot, SATA 3.0 Port,SPI flash
|-
! Network
| 5 x 10/100/1000 Mbit/s Ethernet
|-
! Display(s)
| 1 HDMI port, 2 DSI interface(1 DSI can change to LVDS by software)
|-
|-
! Camera
| 1 CSI camera interfact
|-
! Video decoder(s)
| H.265 HEVC/MVC Main10 Profile yuv420@L5.1 up to 4096x2304@60fps,H.264 AVC/MVC Main10 Profile yuv400/yuv420/yuv422/@L5.1 up to 4096x2304@60fps
|-
|-
! Video encoder(s)
| H.264/AVC BP/MP/HP@level4.2，up to 1920x1080@100fps, H.265/HEVC MP@level4.1, up to 1920x1080@100fps (4096x4096@10fps with TILE)
|-
! Audio Output(s)
| HDMI & I2S & Speaker & Headphone
|-
! USB port
| USB 3.0 PORT (x2), micro USB OTG (x1)
|-
! mini PCIE
| 1 mini pcie interface & 1 M.2 key-e interface
|-
! Remote
| IR Receiver (x1)
|-
! GPIO
| 40 Pin Header : GPIO (x28) and Power (+5V, +3.3V and GND). Some of I/O Pin can be used for specific functions as UART, I2C, SPI or PWM
|-
! Switches
| Reset button, Power button, U-boot button
|-
! LED
| Power Status and 8P8C
|-
! Power Source
| 12 volt @2A via DC Power and/or Micro USB (OTG)
|-
! Size & Weight
| 148 mm × 100.5mm 100g
|-
! OS
| OpenWRT, Linux and others OS
|}

==GPIO PIN define==
BPI-R2 40 PIN GPIO, Debug Uart PIN,MIPI camera ,MIPI LCD0，MIPI LCD1,eDP LCD PIN define.

[[BPI-R2 Pro all GPIO PIN define]]

Running on android11 system, connecting with 2x dsi panel + 1x eDP panel:https://www.youtube.com/watch?v=HpDAmNVDwXI

=Resources=

==Source Code==
*linux-4.19.xx kernel BSP Source code on github ：https://github.com/BPI-SINOVOIP/BPI-R2PRO-BSP/
*linux-5.10.66 kernel BSP Source code on github ：https://github.com/BPI-SINOVOIP/BPI-R2PRO-BSP-5.10.x/
*BPI-R2 PRO Android11 Source Code
:Baidu Cloud:https://pan.baidu.com/s/1c2vw-df4hh55VB3gSsM6Uw?pwd=8888 (提取码: 8888)
:Google Drive:

==Documents==
*Because of the Google security update some of the old links will not work if the images you want to use cannot be downloaded from the [https://drive.google.com/drive/folders/0B_YnvHgh2rwjVjNyS2pheEtWQlk?resourcekey=0-U4TI84zIBdId7bHHjf2qKA new link bpi-image Files]
*All banana pi [https://drive.google.com/drive/folders/0B4PAo2nW2Kfndjh6SW9MS2xKSWs?resourcekey=0-qXGFXKmd7AVy0S81OXM1RA&usp=sharing docement(SCH file,DXF file,and doc)]
*BPI-R2 Pro schematic diagram : https://drive.google.com/file/d/1aDOL8U6-4bxn7iB_MzCOgHoDhUu0wuQu/view?usp=sharing
*BPI-R2 Pro DXF file ：https://drive.google.com/file/d/1N9AWJVHC4fZEko5_RIkc3pI0gK1I0XiV/view?usp=sharing
*MT7531 switch chip datasheet: https://drive.google.com/file/d/1aVdQz3rbKWjkvdga8-LQ-VFXjmHR8yf9/view?usp=sharing
*RTL8367RB-VB-CG Switch chip datasheet:https://drive.google.com/file/d/1Rua-SRJLPoV0NLnvwJg-fopsD178KIts/view?usp=sharing
*BPI-R2 Pro CE,FCC,RoHS certificate : https://banana-pi.org/en/bpi-honor/
*Install google play on Bananapi BPI-R2 pro Android 11/12:https://www.youtube.com/watch?v=pMKBVcJhsx4

=Release image=
Note: the network disk include linux-4.19.xx and linux-5.10.66 kernel version, linux-5.10.66 kernel version can support DSA feature.
*All image for BPI-R2 Pro google ： https://drive.google.com/drive/folders/1gHNGVL_uq8L4t987k-nzg6MKWDSmDcfC
*All image for BPI-R2 Pro : Baidu ： https://pan.baidu.com/s/1u5bIp0fMJPre-j0bXGfDWA?pwd=i8q6 Pincode: i8q6

==kernel linux-5.10.66 Release image, support DSA feature==
Supported OS Note: OpenWRT, Debian10, Ubuntu 16.04. Ubuntu 20.04, Ubunutu 22.04, Ubunut OS support server version, desktop version, mate desktop version.
*kernel linux-5.10.66 image for BPI-R2 Pro : Baidu : https://pan.baidu.com/s/19B6AYrHfbIFgRytTpW8Mbg?pwd=6me6 Pincode: 6me6

==AltLinux for Banana Pi BPI R2 pro==
*kernel 5.18.9 : https://forum.banana-pi.org/t/altlinux-for-bpi-r2-pro-rk3568/13363

==Armbian and LibreELEC for BPI-R2-pro==
*https://forum.banana-pi.org/t/armbian-and-libreelec-for-bpi-r2-pro-rk3568/13308

==Android==
:[https://wiki.banana-pi.org/Getting_Started_with_R2PRO#Android How to flash Android Image]
*All Android image can find here:
::Google Drive: https://drive.google.com/drive/folders/1Bs0lhnukZ4A_BmbY-QPiJsFguPXh6imh?usp=share_link
::Baidu Cloud: https://pan.baidu.com/s/19_nZls-1tzAsIB3_B-PWrg?pwd=6zw8 (pincode: 6zw8)

* 2023-03-17-Android11-atv-bpi-r2pro.img
::Google Drive:https://drive.google.com/drive/folders/1TZMsaeg99bC8WwxEb8zOMTOAA0TurQ_E?usp=share_link
::Baidu Cloud:https://pan.baidu.com/s/1_Hb0dB_4mHhTXiWP6TAzDA?pwd=bdxa (pincode: bdxa)

*2023-03-17-Android11-bpi-r2pro.img
::Google Drive:https://drive.google.com/drive/folders/108SbohEB8OsWYaxvFeYhGDzxHaUJ1OcW?usp=share_link
::Baidu Cloud: https://pan.baidu.com/s/1FKdN2b3qA2Cc4syO15zbng?pwd=rnxd (pincode: rnxd)

* 2022-11-16 release, Android12-bpi-r2pro.img
::Google Drive: https://drive.google.com/file/d/1UZ-e6QJIB8ZU-rdGsCnDNaNR2pYHHvxA/view?usp=share_link
::Baidu Cloud: https://pan.baidu.com/s/1tQ5Fg47R0fpUajYpNIsJ3g?pwd=8888 (pincode: 8888)
::MD5:a7b5faf7818f1ab2d36253a5d3ca1d18
::Forum pthread:https://forum.banana-pi.org/t/bananapi-bpi-r2-pro-2022-11-16-android-12/14264

* 2022-06-10 release, Android 11 with kernel 4.19.219, tablet variant image
::Google Drive: https://drive.google.com/file/d/1qiLZKU8_2O0hHgP25F0CRxv9MnSJlXpv/view?usp=sharing
::Baidu Cloud:https://pan.baidu.com/s/1EUiGaXuPxAkR69g7EOnVaw?pwd=4n6c (pincode: 4n6c)
::MD5: ebd336bad0c27c66ae65a4d38103bced

* 2022-06-10 release, Android 11 with kernel 4.19.219, atv variant image
::Google Drive: https://drive.google.com/file/d/104K7W1PX4OFvUtqNGHOnx6RZO49BrTZp/view?usp=sharing
::Baidu Cloud: https://pan.baidu.com/s/1RbNf1dFqMxy1Dx_ysym82w?pwd=v4u8 (pincode: v4u8)
::MD5: 49506a8a3183ab189046b5e2e2833b87

=Easy to buy sample=
*Aliexpress shop : https://www.aliexpress.com/item/1005004224551525.html?spm=a2g0o.store_pc_newArrival.8148356.1.2d8330d9Jco2ZH
*Taobao shop : https://item.taobao.com/item.htm?spm=a2oq0.12575281.0.0.282d1debCwvgH0&ft=t&id=673191560298

BPI-Leaf-S3 开发板

2022-12-19T02:08:09Z

Qubot: /* 硬件规格 */

[[en:BPI-Leaf-S3]]

= 介绍 =
[[File:BPI-Leaf-S3_banner.jpg]]

[[File:Leaf-S3-incline-front.jpg|thumb|[[BPI-Leaf-S3]] with ESP32-S3]]

[[File:Leaf-S3-incline-back.jpg|thumb|[[BPI-Leaf-S3]] with ESP32-S3]]

[[File:Smart-01-03.gif|thumb|[[BPI-Smart ]]with ESP8266]]
[[File:Webduino_gif.gif|thumb|[[BPI-Bit]] with ESP32]]
[[File:BPI-AI_1.JPG|thumb|[[BPI-AI]] Kendryte K210 RISC-V]]
[[File:ESP32_6.JPG|thumb|[[BPI-UNO32]] with ESP32 design]]

香蕉派Leaf系列是专为物联网设计的低功耗微控制器开发板。

BPI-Leaf-S3板载ESP32-S3芯片，支持 2.4 GHz Wi-Fi 和低功耗蓝牙 (Bluetooth® LE) 双模无线通信，外围兼容低功耗硬件设计，深度睡眠模式下功耗仅为10uA。

支持USB和外接3.7V锂电池两种供电方式，可实现双电源下自动切换电源功能，并支持USB充电方式。体积小巧，接口方便，上手简单，可直接应用于物联网低功耗项目。

BPI-Leaf-S3开发板在软件方面支持ESP-IDF、Arduino、MicroPython等多种方式进行编程开发。

BPI-Leaf-S3开发板上标记了与芯片对应的所有IO管脚，且IO管脚顺序与Espressif ESP32-S3-DevKitC-1开发板一致，开发者可根据实际需求，可将DevKitC-1支持的外围设备添加到BPI-Leaf-S3上，也可将开发板插在面包板上使用。

== 关键特性 ==

* ESP32-S3，Xtensa® 32 bit LX7
* 片外 PSRAM , FLASH
* Ultra-low power 10uA
* 2.4G WIFI ，Bluetooth 5 ，Bluetooth mesh
* GPIO , ADC , TOUCH , PWM , I2C , SPI , RMT , I2S , UART , LCD，CAMERA ，USB , JTAG
* 1* JST SH 1mm 4-Pin I2C连接座
* 1 * USB Type-C
* 1 * 2pin 电池连接座，支持充电
* 1 * 全彩色LED

== BPI-Leaf-S3 与 ESP32-S3-DevKitC-1开发板对比 ==

{| class="wikitable"
|- style="font-weight:bold;"
! 开发板
! BPI-Leaf-S3
! ESP32-S3-DevKitC-1
|-
| 引出GPIO
| 36
| 36
|-
| 3.3v管脚
| 2
| 2
|-
| 5v管脚
| 1
| 1
|-
| GND管脚
| 4
| 4
|-
| 全彩LED灯
| 1 on GPIO48
| 1 on GPIO48
|-
| 芯片直连USB
| Type-C USB接口x1
| MicroUSB接口x1
|-
| UART TTL转USB
| 无
| CP2102-MicroUSB接口x1
|-
| 外接电池连接座
| 3.7v锂电池供电接口
| 无
|-
| 电池充电
| 500mA充电
| 无
|-
| I²C JST SH 1mm 4-Pin连接座
| 1
| 无
|}

BPI-Leaf-S3开发板IO管脚数量，顺序，间距都与Espressif ESP32-S3-DevKitC-1开发板一致。

BPI-Leaf-S3开发板不再具备传统的UART TTL转USB转接芯片及其USB接口，这是因为ESP32-S3芯片的内置USB功能已经足够完善，支持CDC-ACM 虚拟串口及 JTAG 适配器功能，不再需要外部的转接芯片就可以实现软件开发调试，固件下载等功能。

相较于ESP32-S3-DevKitC-1开发板，BPI-Leaf-S3开发板增加了外接电池连接座并搭配了充电电路，可直接通过USB给电池充电，且可实现自动切换供电，即在有接3.7v锂电池的条件下，插拔USB不会导致程序中断，适应更多应用场景。

BPI-Leaf-S3开发板上还增加了一个I²C 4pin连接座，使开发板连接一些I²C设备更加便捷稳固。其实此接口并不局限于连接I²C设备，所有可以通过一根3.3v线，一根GND线，一或两根信号线控制的设备都可以通过此4pin连接座与开发板建立通信。

== Espressif ESP32-S3 ==

ESP32-S3 是一款集成 2.4 GHz Wi-Fi 和 Bluetooth 5 (LE) 的 MCU 芯片，支持远距离模式 (Long Range)。ESP32-S3 搭载 Xtensa® 32 位 LX7 双核处理器，主频高达 240 MHz，内置 512 KB SRAM (TCM)，具有 45 个可编程 GPIO 管脚和丰富的通信接口。ESP32-S3 支持更大容量的高速 Octal SPI flash 和片外 RAM，支持用户配置数据缓存与指令缓存。

以下是ESP32-S3芯片重要功能的描述。

* '''支持Wi-Fi + Bluetooth 5 (LE) 无线连接''': ESP32-S3 集成 2.4 GHz Wi-Fi (802.11 b/g/n)，支持 40 MHz 带宽；其低功耗蓝牙子系统支持 Bluetooth 5 (LE) 和 Bluetooth Mesh，可通过 Coded PHY 与广播扩展实现远距离通信。它还支持 2 Mbps PHY，用于提高传输速度和数据吞吐量。ESP32-S3 的 Wi-Fi 和 Bluetooth LE 射频性能优越，在高温下也能稳定工作。

* '''支持 AI 加速''': ESP32-S3 MCU 增加了用于加速神经网络计算和信号处理等工作的向量指令 (vector instructions)。AI 开发者们通过 ESP-DSP 和 ESP-NN 库使用这些向量指令，可以实现高性能的图像识别、语音唤醒和识别等应用。

* '''丰富的 IO 接口''': ESP32-S3 拥有 45 个可编程 GPIO 以及 SPI、I2S、I2C、PWM、RMT、ADC、UART、SD/MMC 主机控制器和 TWAITM 控制器等常用外设接口。其中的 14 个 GPIO 可被配置为 HMI 交互的电容触摸输入端。此外，ESP32-S3 搭载了超低功耗协处理器 (ULP)，支持多种低功耗模式，广泛适用于各类低功耗应用场景。

* '''完善的安全机制''': ESP32-S3 为物联网设备提供了完善的安全机制和保护措施，防止各类恶意攻击和威胁。它支持基于 AES-XTS 算法的 flash 加密、基于 RSA 算法的安全启动、数字签名和 HMAC。ESP32-S3 还新增了一个“世界控制器 (World Controller)”模块，提供了两个互不干扰的执行环境，实现可信执行环境或权限分离机制。

= 硬件 =

== 硬件接口示意图 ==

[[File:Leaf-S3_board.png|800px]]

== 硬件规格 ==

{| class="wikitable"
|-
! colspan="2" style="background-color:#ffcb2f;" | BPI-Leaf-S3 规格表
|-
| SoC主控芯片
| ESP32-S3，Xtensa® 32 位 LX7 双核处理器
|-
| 主频
| 240MHz MAX
|-
| 工作温度
| -40℃~+85℃
|-
| 片上 ROM
| 384 KB
|-
| 片上 SRAM
| 320 KB
|-
| 板载 FLASH ROM
| 8MB
|-
| 片上外设PSRAM
| 2MB
|-
| WIFI
| IEEE 802.11 b/g/n ，2.4Ghz频带，150Mbps
|-
| 蓝牙
| Bluetooth 5 ，Bluetooth mesh
|-
| GPIO
| BPI-Leaf-S3已引出36个可用GPIO
|-
| ADC
| 2 × 12 位 SAR ADC，支持 20 个模拟通道输入
|-
| TOUCH 电容式触摸传感器
| 14
|-
| SPI
| 4
|-
| I2C
| 2，支持主机或从机模式
|-
| I2S
| 2，串行立体声数据的输入输出
|-
| LCD
| 1，支持 8 位 ~16 位并行 RGB、I8080、MOTO6800 接口
|-
| CAMERA
| 1，支持 8 位 ~16 位 DVP 图像传感器接口
|-
| UART
| 3 ，支持异步通信（RS232 和RS485）和 IrDA
|-
| PWM
| 8 路独立通道，14位精度
|-
| MCPWM
| 2
|-
| USB
| 1 × 全速USB 2.0 OTG，Type-C母口
|-
| USB Serial/JTAG 控制器
| 1，USB 全速标准，CDC-ACM ，JTAG
|-
| 温度传感器
| 1，测量范围为–20 °C 到 110 °C，用于监测芯片内部温度
|-
| SD/MMC
| 1 × SDIO主机接口，具有2个卡槽，支持SD卡3.0和3.01，SDIO 3.0，CE-ATA 1.1，MMC 4.41，eMMC 4.5和4.51
|-
| TWAI® 控制器
| 1 ，兼容 ISO11898-1（CAN 规范 2.0）
|-
| 通用 DMA 控制器
| 5 个接收通道和 5 个发送通道
|-
| RMT
| 4 通道发射，4通道接收，共享 384 x 32-bit 的 RAM
|-
| 脉冲计数器
| 4个脉冲计数控制器（单元），每个单元有2个独立的通道
|-
| 定时器
| 4 × 54 位通用定时器，16 位时钟预分频器，1 × 52 位系统定时器，3 × 看门狗定时器
|-
| 外部晶振
| 40Mhz
|-
| RTC 和低功耗管理
| 电源管理单元 (PMU)+ 超低功耗协处理器 (ULP)
|-
| 低功耗电流
| 10uA
|-
| 工作电压
| 3.3V
|-
| 输入电压
| 3.3V~5.5V
|-
| 最大放电电流
| 2A@3.3V DC/DC
|-
| USB充电
| 支持
|-
| 最大充电电流
| 500mA
|-
| 可控全彩色LED
| 1
|}

== 硬件尺寸 ==

[[File:Leaf-S3_board_dimension.png | 700px]]

{| class="wikitable"
|-
! colspan="2" style=" background-color:#ffcb2f;" | BPI-Leaf-S3 尺寸表
|-
| 管脚间距
| 2.54mm
|-
| 安装孔间距
| 23mm/ 62.25mm
|-
| 安装孔尺寸
| 内径2mm/外径3mm
|-
| 主板尺寸
| 26 × 65.25(mm)/1.02 x 2.57(inches)
|-
|}

管脚间距兼容万能板（洞洞板、点阵板），面包板，便于调试应用。

== 外设GPIO管脚分配 ==

{| class="wikitable"
|-
! colspan="3" style=" background-color:#ffcb2f;" | BPI-Leaf-S3 外设GPIO管脚分配
|- style="background-color:#32cb00;"
| 外设接口
| 信号
| 管脚
|-
| rowspan="2" | ADC
| ADC1_CH0~9
| GPIO 1~10
|-
| ADC2_CH0~9
| GPIO 11~20
|-
| 触摸传感器
| TOUCH1~14
| GPIO 1~14
|-
| rowspan="4"|JTAG
| MTCK
| GPIO 39
|-
| MTDO
| GPIO 40
|-
| MTDI
| GPIO 41
|-
| MTMS
| GPIO 42
|-
| rowspan="14" | UART
| colspan="2" style="font-style:italic;color:#9b9b9b;" | 默认分配管脚，可重定义为任意GPIO
|-
| style="background-color:#ffffc7;" | U0RXD_in
| style="background-color:#ffffc7;" | GPIO 44
|-
| U0CTS_in
| GPIO 16
|-
| U0DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U0TXD_out
| style="background-color:#ffffc7;" | GPIO43
|-
| U0RTS_out
| GPIO 15
|-
| U0DTR_out
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1RXD_in
| style="background-color:#ffffc7;" | GPIO 18
|-
| U1CTS_in
| GPIO 20
|-
| U1DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1TXD_out
| style="background-color:#ffffc7;" | GPIO 17
|-
| U1RTS_out
| GPIO 19
|-
| U1DTR_out
| 任意GPIO
|-
| style="background-color:#9aff99;" | U2
| style="background-color:#9aff99;" | 任意GPIO
|-
| I2C
| colspan="2" | 任意GPIO
|-
| PWM
| colspan="2" | 任意GPIO
|-
| I2S
| colspan="2" | 任意GPIO
|-
| LCD
| colspan="2" | 任意GPIO
|-
| CAMERA
| colspan="2" | 任意GPIO
|-
| RMT
| colspan="2" | 任意GPIO
|-
| SPI0/1
| colspan="2" | 已用于FLASH与PSRAM
|-
| SPI2/3
| colspan="2" | 任意GPIO
|-
| 脉冲计数器
| colspan="2" | 任意GPIO
|-
| rowspan="8" | USB OTG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| RCV
| GPIO21（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| rowspan="7" | USB Serial/JTAG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| SD/MMC
| colspan="2" | 任意GPIO
|-
| MCPWM
| colspan="2" | 任意GPIO
|-
| TWAI
| colspan="2" | 任意GPIO
|-
| 彩色LED
| colspan="2" | GPIO 48
|}

= 软件 =

== ESP-IDF ==

[[File:Esp-idf-logo.png | 800px]]

ESP-IDF 是乐鑫官方推出的物联网开发框架，支持 Windows、Linux 和 macOS 操作系统。

建议开发者通过集成开发环境 (IDE) 安装 ESP-IDF:

* [https://github.com/espressif/idf-eclipse-plugin/blob/master/README_CN.md GitHub: ESP-IDF Eclipse 插件安装与使用指南]
* [https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension ESP-IDF VSCode 插件] | [https://github.com/espressif/vscode-esp-idf-extension/blob/master/docs/tutorial/toc.md GitHub: 安装与使用指南] | [https://www.bilibili.com/video/BV17p4y167uN bilibili：ESP-IDF VSCode 插件快速操作指南]

或者根据操作系统选择对应的手动安装流程:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/windows-setup.html Windows 平台工具链的标准设置]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/linux-macos-setup.html Linux 和 macOS 平台工具链的标准设置]

API:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/index.html#api API 参考]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-guides/index.html#api API 指南]

为了使你的BPI-Leaf-S3开发板可以通过USB-CDC刷写FLASH，需要设置开发板为固件下载模式。

有两种操作方法：

1.通过USB连接到电脑，按住BOOT键，再按一下RESET键并松开，最后松开BOOT键。

2.在断开供电的条件下按住BOOT键，再通过USB连接到电脑，最后松开BOOT键。

需要在设备管理器中确认接口，固件下载模式与普通模式下的接口序号可能是不一样的。

== MicroPython ==

[[File:Mircopython.png | 800px]]

MicroPython实现了大部分Python 3 特性和语法，易学易上手，验证程序效果无需编译直接下载进芯片运行。

无论是否有编程基础，MicroPython的上手难度绝对远低于其他编程语言，其代码易读性高，且开源社区有多年积累的丰富资源，就如同Python一样拥有极强的生命力与应用价值。

* '''[https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/tree/main/Example/MicroPython-zh#1%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B GitHub: MicroPython快速上手]'''

* [[ micropython_运行环境搭建 | MicroPython运行环境搭建(Thonny IDE) ]]

* [[ micropython_固件下载与烧录 | MicroPython固件下载与烧录 ]]

== CircuitPython ==

[[File:CircuitPython_Repo_header_logo.jpg | 800px]]

CircuitPython是旨在简化在单片机开发板上进行编程实验和学习的一种编程语言。

配合Mu编辑器进行CircuitPython编程是最低难度的上手方法，安装软件，连接设备即可开始使用。

[https://circuitpython.org/board/bpi_leaf_s3/ BPI-Leaf-S3 CircuitPython 下载页面]

[https://codewith.mu/ Mu编辑器下载页面]

'''安装tinyUF2固件：'''

为了使你的BPI-Leaf-S3开发板可以通过USB-CDC刷写FLASH，需要设置开发板为固件下载模式。

通过USB连接到电脑，按住BOOT键，再按一下RESET键并松开，最后松开BOOT键。

在BPI-Leaf-S3 CircuitPython 下载页面底部的 Install, Repair, or Update UF2 Bootloader 栏目中，参考其说明下载安装tinyUF2固件。

'''安装CircuitPython固件：'''

在BPI-Leaf-S3 CircuitPython 下载页面右侧点击 DOWNLOAD .UF2 NOW 按钮下载固件到本地，随后拷贝至BPI-Leaf-S3 UF2 Bootloader模式下的磁盘中，自动复位后即可使用。

'''已得到adafruit/circuitpython GitHub存储库支持'''

https://github.com/adafruit/circuitpython/pull/6904

'''已得到adafruit/tinyuf2 GitHub存储库支持'''

https://github.com/adafruit/tinyuf2/pull/196

== Arduino ==

[[File:Arduino_logo_1200x350.png | 800px]]

Arduino 是一个开源嵌入式软硬件开发平台，用来供用户制作可交互式的嵌入式项目。

* [https://www.arduino.cc/en/software Arduino IDE 下载地址] | [https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html#installing 安装并配置Arduino-ESP32运行环境]
* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/Example/Arduino GitHub: BPI-Leaf-S3 Arduino快速上手]
* [https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html#apis Arduino-ESP32 APIs]

'''已得到 arduino-esp32 GitHub 存储库支持'''

https://github.com/espressif/arduino-esp32/pull/7345

该板已合并到主分支。

= 资料与资源 =

* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/sch/BPI-Leaf-S3-Chip-V0.1A.pdf GitHub: BPI-Leaf-S3 开发板原理图PDF]

* [https://www.espressif.com/sites/default/files/documentation/esp32-s3_datasheet_cn.pdf ESP32-S3 技术规格书]

* [https://www.espressif.com/sites/default/files/documentation/esp32-s3_technical_reference_manual_cn.pdf ESP32-S3 技术参考手册]

=样品购买=

* 官方速卖通: https://www.aliexpress.com/item/1005004428945296.html?spm=5261.ProductManageOnline.0.0.48af4edfYbyEoI
* 官方淘宝: https://item.taobao.com/item.htm?spm=a2126o.success.0.0.29034831FGnLQW&id=677287234553
* OEM&OEM 定制服务： sales@banana-pi.com

BPI-Leaf-S3

2022-12-19T02:07:52Z

Qubot: /* Hardware Spec */

[[zh:BPI-Leaf-S3 开发板]]

= Introduction =
[[File:BPI-Leaf-S3_banner.jpg]]
[[File:Leaf-S3-incline-front.jpg|thumb|[[BPI-Leaf-S3]] with ESP32-S3]]
[[File:Leaf-S3-incline-back.jpg|thumb|[[BPI-Leaf-S3]] with ESP32-S3]]
[[File:PICO-1000-7.jpg|thumb|[[BPI-PicoW-S3 ]]with ESP32-S3]]
[[File:Smart-01-03.gif|thumb|[[BPI-Smart ]]with ESP8266]]
[[File:Webduino_gif.gif|thumb|[[BPI-Bit]] with ESP32]]
[[File:BPI-AI_1.JPG|thumb|[[BPI-AI]] Kendryte K210 RISC-V]]
[[File:ESP32_6.JPG|thumb|[[BPI-UNO32]] with ESP32 design]]

The Banana Pi BPI-Leaf-S3 is a series of low-powered microcontrollers designed for IoT development and Maker DIY board.It supports 2.4 GHz Wi-Fi and Bluetooth® LE dual-mode wireless communication, the peripheral is compatible with low-power hardware design, and the power consumption is only 10uA in deep sleep mode.

The main controller supports two power supply inputs: USB and external 3.7V lithium battery, both can be interchangable freely. The battery could also be charged while USB is plugged in. Compact size, various interface, easy to use, and can be directly applied to low-power IoT projects.

In terms of programming, the Leaf-S3 supports ESP-IDF, Arduino, micropython and other methods.

The IO pins on BPI-Leaf-S3 are identical to the Espressif ESP32-S3-DevKitC-1, developers can add peripherals that are supported by DevKitC-1 onto the BPI-Leaf-S3, and can also combine it onto a breadboard.

== Key Features ==

* ESP32-S3，Xtensa® 32 bit LX7
* External PSRAM , FLASH
* Ultra-low power 10uA
* 2.4G WIFI ，Bluetooth 5 ，Bluetooth mesh
* GPIO , ADC , TOUCH , PWM , I2C , SPI , RMT , I2S , UART , LCD，CAMERA ，USB , JTAG
* 1* JST SH 1mm 4-Pin Socket, support I2C
* 1 * USB Type-C
* 1 * MX 1.25mm 2-Pin Socket，support charging
* 1 * Neopixel LED

== ESP32-S3-DevKitC-1, BPI-Leaf-S3 Comparison ==

{| class="wikitable"
|-
! Dev Board
! BPI-Leaf-S3
! ESP32-S3-DevKitC-1
|-
| GPIO Pins
| 36
| 36
|-
| 3.3v Pins
| 3
| 3
|-
| 5v Pins
| 1
| 1
|-
| GND Pins
| 4
| 4
|-
| ARGB LEDs
| 1 on GPIO48
| 1 on GPIO48
|-
| Chip Internal USB
| USB-C Connector x 1
| MicroUSB Connector x 1
|-
| UART TTL to USB
| None
| CP2102-MicroUSB Connector x 1
|-
| External Battery Socket
| 3.7v Li-ion Battery dock
| None
|-
| Battery Charging
| 500mA Charging Current
| None
|-
| JST SH 1mm 4-Pin Socket
| 1
| None
|}

The amount, numeric order, and spacing of IO pins on BPI-Leaf-S3 are identical to the Espressif ESP32-S3-DevKitC-1.

The BPI-Leaf-S3 dev board no longer equips traditional UART TTL to USB converter chip and its dedicated USB port. This is due to the ESP32-S3 chip's internal USB function were improved, supporting CDC-ACM virtual serial port and JTAG interface, which is capable of software development and firmware management feature, that makes the external converter chip redundant.

Compared to ESP32-S3-DevKitC-1 dev board, the BPI-Leaf-S3 adds an external battery socket and a charging circuit, capable of charging the battery via USB. When a 3.7v battery is connected, unplugging the USB will not cause the program to break, making it fit for multiple applications.

BPI-Leaf-S3 dev board is equipped with an I²C 4 pin dock, this stabalizes connection to other I²C peripherals. This dock is not only restricted to I²C connection, any module that requires a 3.3v pin, a GND pin, one or two data pin can also be connected to the Leaf-S3 via this 4 pin dock.

==Espressif ESP32-S3==

ESP32-S3 is a dual-core XTensa LX7 MCU, capable of running at 240 MHz. Apart from its 512 KB of internal SRAM, it also comes with integrated 2.4 GHz, 802.11 b/g/n Wi-Fi and Bluetooth 5 (LE) connectivity that provides long-range support. It has 45 programmable GPIOs and supports a rich set of peripherals. Compared with ESP32, it supports larger, high-speed octal SPI flash, and PSRAM with configurable data and instruction cache.

What follows is a description of the most important features of ESP32-S3.

* Wi-Fi + Bluetooth 5 (LE) Wireless Connectivity: ESP32-S3 supports a 2.4 GHz Wi-Fi (802.11 b/g/n) with 40 MHz of bandwidth support. The Bluetooth Low Energy subsystem supports long range through Coded PHY and advertisement extension. It also supports higher transmission speed and data throughput, with 2 Mbps PHY. Both Wi-Fi and BLE have superior RF performance that is maintained even at high temperatures.

* AI Acceleration Support: ESP32-S3 has additional support for vector instructions in the MCU, which provides acceleration for neural network computing and signal processing workloads. The software libraries for the above-mentioned optimized functions will become available very soon, in the form of updates to ESP-WHO and ESP-Skainet.

* Rich Set of IO Peripherals: ESP32-S3 has 44 programmable GPIOs, namely 10 more GPIOs than those of ESP32. ESP32-S3 supports all the commonly-used peripherals, such as SPI, I2S, I2C, PWM, RMT, ADC and UART, SD/MMC host and TWAITM. In total, 14 GPIOs can be configured as capacitive touch input for HMI applications. Apart from all these peripherals, however, ESP32-S3 is also equipped with an ultra-low-power (ULP) core that supports multiple low-power modes in a variety of such use-cases.

* Security:ESP32-S3 provides all the necessary security requirements for building securely connected devices, without requiring any external components. It supports AES-XTS-based flash encryption and RSA-based secure boot. In addition, ESP32-S3 has a digital signature peripheral and an HMAC module, which provide functionality that is similar to the hardware secure element, thus protecting the private or symmetric key from software attacks and identity theft. ESP32-S3 also has a “World Controller” peripheral that provides two fully-isolated execution environments, which enable the implementation of a trusted-execution environment or a privilege-separation scheme.

= Hardware =

== Hardware sketch map ==

[[File:Leaf-S3_board.png|800px]]

== Hardware Spec ==

{| class="wikitable"
|-
! colspan="2" style="background-color:#ffcb2f;" | BPI-Leaf-S3 Spec
|-
| SoC
| ESP32-S3，Xtensa® dual-core 32-bit LX7 microprocessor
|-
| Clock Frequency
| 240MHz MAX
|-
| Operating Temperature
| -40℃~+85℃
|-
| Internal ROM
| 384 KB
|-
| Internal SRAM
| 320 KB
|-
| Onboard FLASH ROM
| 8MB
|-
| On-chip PSRAM
| 2MB
|-
| WIFI
| IEEE 802.11 b/g/n ，2.4Ghz，150Mbps
|-
| Bluetooth
| Bluetooth 5 ，Bluetooth mesh
|-
| GPIO
| BPI-Leaf-S3 has led out 36 available gpios
|-
| ADC
| 2 × 12-bit SAR ADCs, up to 20 channels
|-
| Touch Sensor
| 14
|-
| SPI
| 4
|-
| I2C
| 2
|-
| I2S
| 2
|-
| LCD
| 1 × LCD interface (8-bit ~16-bit parallel RGB, I8080 and MOTO6800)
|-
| CAMERA
| 1 × DVP 8-bit ~16-bit camera interface
|-
| UART
| 3
|-
| PWM
| 8 channels 14 bits
|-
| MCPWM
| 2
|-
| USB
| 1 × full-speed USB OTG，female Type-C socket
|-
| USB Serial/JTAG controller
| 1，CDC-ACM ，JTAG
|-
| Temperature Sensor
| 1，ranging from -20 °C to 110 °C
|-
| SD/MMC
| 1 × SDIO host controller with 2 slots,SD 3.0,SD 3.01,SDIO 3.0,CE-ATA 1.1,MMC 4.41,eMMC 4.5,eMMC 4.51
|-
| TWAI® controller
| 1 ，compatible with ISO 11898-1 (CAN Specification 2.0)
|-
| General DMA controller (GDMA)
| 5 transmit channels and 5 receive channels
|-
| RMT
| 4 TX channels,4RX channels.Eight channels share a 384 x 32-bit RAM
|-
| Pulse Count Controller
| 4 independent pulse counters (units).Each unit consists of two independent channels
|-
| Timers
| 4 × 54-bit general-purpose timers. 1 × 52-bit system timer. 3 × watchdog timers
|-
| External crystal oscillator
| 40Mhz
|-
| RTC and LowPower Management
| Power Management Unit (PMU) + Ultra-Low-Power Coprocessor(ULP)
|-
| Deep-sleep consumption current
| 10uA
|-
| Operating Voltage
| 3.3V
|-
| Input Voltage
| 3.3V~5.5V
|-
| Maximum discharge current
| 2A@3.3V DC/DC
|-
| USB charge
| Support
|-
| Maximum charging current
| 500mA
|-
| Neopixel LED
| 1
|}

== Hardware Dimensions ==

[[File:Leaf-S3_board_dimension.png | 700px]]

{| class="wikitable"
|-
! colspan="2" style=" background-color:#ffcb2f;" | BPI-Leaf-S3 Dimensions
|-
| Pin spacing
| 2.54mm
|-
| Mounting hole spacing
| 23mm/ 62.25mm
|-
| Mounting hole size
| bore 2mm/outside 3mm
|-
| Motherboard size
| 26 × 65.25(mm)/1.02 x 2.57(inches)
|-
| board thickness
| 1.2mm
|}

The pin spacing is breadboard compatible for easy application debugging.

== Peripheral Pin Configurations ==

{| class="wikitable"
|-
! colspan="3" style=" background-color:#ffcb2f;" | BPI-Leaf-S3 GPIO Pin define
|- style="background-color:#32cb00;"
| Peripheral Interface
| Signal
| Pin
|-
| rowspan="2" | ADC
| ADC1_CH0~9
| GPIO 1~10
|-
| ADC2_CH0~9
| GPIO 11~20
|-
| Touch sensor
| TOUCH1~14
| GPIO 1~14
|-
| rowspan="4"|JTAG
| MTCK
| GPIO 39
|-
| MTDO
| GPIO 40
|-
| MTDI
| GPIO 41
|-
| MTMS
| GPIO 42
|-
| rowspan="14" | UART
| colspan="2" style="font-style:italic;color:#9b9b9b;" | The pins are assigned by default, and can be redefined to any GPIO
|-
| style="background-color:#ffffc7;" | U0RXD_in
| style="background-color:#ffffc7;" | GPIO 44
|-
| U0CTS_in
| GPIO 16
|-
| U0DSR_in
| any GPIO
|-
| style="background-color:#ffffc7;" | U0TXD_out
| style="background-color:#ffffc7;" | GPIO43
|-
| U0RTS_out
| GPIO 15
|-
| U0DTR_out
| any GPIO
|-
| style="background-color:#ffffc7;" | U1RXD_in
| style="background-color:#ffffc7;" | GPIO 18
|-
| U1CTS_in
| GPIO 20
|-
| U1DSR_in
| any GPIO
|-
| style="background-color:#ffffc7;" | U1TXD_out
| style="background-color:#ffffc7;" | GPIO 17
|-
| U1RTS_out
| GPIO 19
|-
| U1DTR_out
| any GPIO
|-
| style="background-color:#9aff99;" | U2
| style="background-color:#9aff99;" | any GPIO
|-
| I2C
| colspan="2" | any GPIO
|-
| PWM
| colspan="2" | any GPIO
|-
| I2S
| colspan="2" | any GPIO
|-
| LCD
| colspan="2" | any GPIO
|-
| CAMERA
| colspan="2" | any GPIO
|-
| RMT
| colspan="2" | any GPIO
|-
| SPI0/1
| colspan="2" | Used for FLASH and PSRAM
|-
| SPI2/3
| colspan="2" | any GPIO
|-
| Pulse counter
| colspan="2" | any GPIO
|-
| rowspan="8" | USB OTG
| D-
| GPIO 19（on-chip PHY）
|-
| D+
| GPIO 20（on-chip PHY）
|-
| VP
| GPIO 42（external PHY）
|-
| VM
| GPIO 41（external PHY）
|-
| RCV
| GPIO21（external PHY）
|-
| OEN
| GPIO 40（external PHY）
|-
| VPO
| GPIO 39（external PHY）
|-
| VMO
| GPIO38（external PHY）
|-
| rowspan="7" | USB Serial/JTAG
| D-
| GPIO 19（on-chip PHY）
|-
| D+
| GPIO 20（on-chip PHY）
|-
| VP
| GPIO 42（external PHY）
|-
| VM
| GPIO 41（external PHY）
|-
| OEN
| GPIO 40（external PHY）
|-
| VPO
| GPIO 39（external PHY）
|-
| VMO
| GPIO38（external PHY）
|-
| SD/MMC
| colspan="2" | any GPIO
|-
| MCPWM
| colspan="2" | any GPIO
|-
| TWAI
| colspan="2" | any GPIO
|-
| Neopixel LED
| colspan="2" | GPIO 48
|}

= Software =

== Espressif ESP-IDF ==

[[File:Esp-idf-logo.png | 800px]]

ESP-IDF is the development framework for Espressif SoCs supported on Windows, Linux and macOS.

It is recommend that developers install ESP-IDF via IDE.

* [https://github.com/espressif/idf-eclipse-plugin/blob/master/README.md GitHub: ESP-IDF Eclipse Plugin README]
* [https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension ESP-IDF VSCode Extension] | [https://github.com/espressif/vscode-esp-idf-extension/blob/master/docs/tutorial/toc.md GitHub: README ] | [https://www.youtube.com/watch?v=Lc6ausiKvQM youtube: Quick User Guide for the ESP-IDF VSCode Extension]

Or install manually based on operating system:

* [https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/get-started/windows-setup.html Standard Setup of Toolchain for Windows]
* [https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/get-started/linux-macos-setup.html Standard Toolchain Setup for Linux and macOS]

API:

* [https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/api-reference/index.html#api-reference ESP-IDF API Reference Docs]
* [https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/api-guides/index.html#api-guides ESP-IDF API Guides]

To enable your BPI-Leaf-S3 device to flash via USB-CDC.

There are two ways to enter Bootloader mode:

# Connect it to the computer via USB, hold BOOT button, press RST button once, then release BOOT button.
# Hold BOOT button while disconnected to power, connect to PC via USB, then release BOOT button.

The chip controls GPIO0 via BOOT button to choose between reset or cold boot.

Confirm the port of your BPI-Leaf-S3 device via device manager, it might display different port if you are on different modes.

== MicroPython ==

[[File:Mircopython.png | 800px]]

Regardless of the programmer is a beginner or not, MicroPython is considered to be less difficult to develop than other MCU programming languages.

Its code is easy to understand compared to other programming languages, and it has various resources accumulated over the years by the open source community.

Just like Python, it has strong vitality and application value.

* [[ micropython_operating_env | Building MicroPython Operating Environment ]]

* [[ micropython_firmware | MicroPython Firmware Download]]

'''Forum resources'''

* [https://forum.banana-pi.org/t/bpi-leaf-s3-oled-displays-potentiometer-voltage-and-progress-bar/13718 BPI-Leaf-S3 OLED displays potentiometer voltage and progress bar]
* [https://forum.banana-pi.org/t/banana-pi-bpi-leaf-s3-with-esp32-s3-use-potentiometer-to-control-neopixel-steplessly/13703 BPI-Leaf-S3 with ESP32-S3, use potentiometer to control neopixel steplessly]
* [https://forum.banana-pi.org/t/banana-pi-bpi-leaf-s3-with-esp32-s3-use-key-interrupts-to-control-neopixel/13660 BPI-Leaf-S3 with ESP32-S3, use key interrupts to control neopixel]
* [https://forum.banana-pi.org/t/banana-pi-bpi-leaf-s3-with-esp32-s3-micropython-neopixel-show/13661 BPI-Leaf-S3 with ESP32-S3 & microPython Neopixel show]
* [https://forum.banana-pi.org/t/banana-pi-bpi-leaf-s3-micropython-getting-started-blink-led-on-bread-board/13634 BPI-Leaf-S3 microPython getting started, blink LED on bread board]
* [https://forum.banana-pi.org/t/bpi-leaf-s3-micropython-display-web-clock-on-oled-screen/13324 BPI-Leaf-S3+MicroPython: Display Web Clock on OLED screen]
* [https://forum.banana-pi.org/t/banana-pi-bpi-leaf-s3-micropython-use-adc-measuring-potentiometer-to-control-the-motor/13273 BPI-Leaf-S3+MicroPython:Use ADC measuring potentiometer to control the motor]
* [https://forum.banana-pi.org/t/banana-pi-bpi-leaf-s3-micropython-with-tb6612fng-pwm-motor/13259 Banana Pi BPI-Leaf-S3 MicroPython with TB6612FNG PWM Motor]
* [https://forum.banana-pi.org/t/making-iot-programming-easy-using-micropython-on-bpi-leaf-s3/13248 Making IoT programming easy，using MicroPython on BPI-Leaf-S3]

== CircuitPython ==

[[File:CircuitPython_Repo_header_logo.jpg | 800px]]

CircuitPython is a programming language designed to simplify experimenting and learning to code on low-cost microcontroller boards.

CircuitPython programming with Mu editor is the easiest way to get started. Install the software and connect the device to start using it.

[https://circuitpython.org/board/bpi_leaf_s3/ BPI-Leaf-S3 CircuitPython Download Page]

[https://codewith.mu/ Mu Editor]

'''How to install tinyUF2 firmware:'''

To enable your BPI-Leaf-S3 device to flash via USB-CDC.

Connect it to the computer via USB, hold BOOT button, press RST button once, then release BOOT button.

In the Install, Repair, or Update UF2 Bootloader section at the bottom of the page, follow its instructions to download and install tinyUF2 firmware.

'''How to install CircuitPython firmware：'''

Click the DOWNLOAD .UF2 NOW button on the right side of the page to download the firmware to the local, and then copy it to the disk in BPI-Leaf-S3 UF2 Bootloader mode, and it can be used after automatic reset.

'''Supported by the adafruit/circuitpython GitHub repository'''

https://github.com/adafruit/circuitpython/pull/6904

'''Supported by the adafruit/tinyuf2 GitHub repository'''

https://github.com/adafruit/tinyuf2/pull/196

== Arduino ==

[[File:Arduino_logo_1200x350.png | 800px]]

Arduino is an open source embedded software and hardware development platform for users to create interactive embedded projects.

* [https://www.arduino.cc/en/software Arduino IDE download link] | [https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html#installing Install and configure the Arduino-ESP32 runtime environment]
* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/Example/Arduino GitHub: BPI-Leaf-S3 Arduino Getting Started]
* [https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html#apis Arduino-ESP32 APIs]

'''Supported by the arduino-esp32 GitHub repository'''

https://github.com/espressif/arduino-esp32/pull/7345

The board has been merged into the master branch.

= Resources =

* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/sch/BPI-Leaf-S3-Chip-V0.1A.pdf BPI-Leaf-S3 schematic diagram PDF]

* [https://www.espressif.com/sites/default/files/documentation/esp32-s3_datasheet_en.pdf ESP32-S3 Datasheet]

* [https://www.espressif.com/sites/default/files/documentation/esp32-s3_technical_reference_manual_en.pdf ESP32-S3 Technical Reference Manual]

=Easy to buy sample=

* Aliexpress shop : https://www.aliexpress.com/item/1005004428945296.html?spm=5261.ProductManageOnline.0.0.48af4edfYbyEoI
* Taobao shop : https://item.taobao.com/item.htm?spm=a2126o.success.0.0.29034831FGnLQW&id=677287234553
* OEM&OEM customized service ： sales@banana-pi.com

BPI-PicoW-S3

2022-11-17T09:16:23Z

Qubot: /* BPI-PicoW-S3 VS Rraspberry Pi PicoW, BPI-Leaf-S3, ESP32-S3-DevKitC-1 */

[[zh:BPI-PicoW-S3_开发板]]

= Introduction =
[[File:BPI-PicoW-S3 banner.png|800px]]

[[File:PICO-1000-7.jpg|thumb|[[BPI-PicoW-S3 ]]with ESP32-S3]]
[[File:PICO-1000-5.png|thumb|[[BPI-PicoW-S3 ]]with ESP32-S3]]
[[File:Leaf-S3-incline-front.jpg|thumb|[[BPI-Leaf-S3]] with ESP32-S3]]
[[File:Smart-01-03.gif|thumb|[[BPI-Smart ]]with ESP8266]]
[[File:Webduino_gif.gif|thumb|[[BPI-Bit]] with ESP32]]
[[File:BPI-AI_1.JPG|thumb|[[BPI-AI]] Kendryte K210 RISC-V]]
[[File:ESP32_6.JPG|thumb|[[BPI-UNO32]] with ESP32 design]]

The Banana Pi BPI-PicoW-S3 is a series of low-powered microcontrollers designed for IoT development and Maker DIY board.same size as Raspberry Pi Pico board,It supports 2.4 GHz Wi-Fi and Bluetooth® LE dual-mode wireless communication, the peripheral is compatible with low-power hardware design, and the power consumption is only 10uA in deep sleep mode.In terms of programming, the PicoW-S3 supports ESP-IDF, Arduino, micropython and other methods.

== key features ==

*ESP32-S3, Xtensa® 32 bit LX7
* External PSRAM, FLASH
* Ultra-low power 10uA
* 2.4G WIFI, Bluetooth 5, Bluetooth mesh
* GPIO, ADC, TOUCH, PWM, I2C, SPI, RMT, I2S, UART, LCD, CAMERA, USB, JTAG
*1*microUSB
*1*Full color LED

== BPI-PicoW-S3 VS Raspberry Pi PicoW, BPI-Leaf-S3, ESP32-S3-DevKitC-1 ==

{| class="wikitable"
|- style="font-weight:bold;"
! Development board
!BPI-PicoW-S3
!Raspberry Pi PicoW
!BPI-Leaf-S3
!ESP32-S3-DevKitC-1
|-
| GPIO pinout
| 27
| 27
| 36
| 36
|-
| 3.3v pin
| 1
| 1
| 2
| 2
|-
| 5v pin
| 2
| 2
| 1
| 1
|-
| GND pin
| 8
| 8
| 4
| 4
|-
| Full color LED
| 1 on GPIO48
| None
| 1 on GPIO48
| 1 on GPIO48
|-
| Chip directly connected to USB
| MicroUSB port x1
| MicroUSB port x1
| Type-C USB port x1
| MicroUSB port x1
|-
| UART TTL to USB
| None
| None
| None
| CP2102-MicroUSB interface x1
|-
| External battery socket
| None
| None
| 3.7v lithium battery power supply interface
| None
|-
| Battery charging
| None
| None
| 500mA charging
| None
|-
| I²C 4pin connector
| None
| None
| 1
| None
|}

== Espressif ESP32-S3 ==

Esp32-S3 is an MCU chip that integrates 2.4 GHz Wi-Fi and Bluetooth 5 (LE) and supports Long Range mode. The ESP32-S3 runs on an Xtensa® 32-bit LX7 dual-core processor with a high frequency of 240 MHz, 512 KB built-in SRAM (TCM), 45 programmable GPIO pins, and a rich communication interface. Esp32-s3 supports larger capacity of high-speed Octal SPI flash and off-chip RAM, and supports user-configured data caching and instruction caching.

What follows is a description of the most important features of ESP32-S3.

* Wi-Fi + Bluetooth 5 (LE) Wireless Connectivity: ESP32-S3 supports a 2.4 GHz Wi-Fi (802.11 b/g/n) with 40 MHz of bandwidth support. The Bluetooth Low Energy subsystem supports long range through Coded PHY and advertisement extension. It also supports higher transmission speed and data throughput, with 2 Mbps PHY. Both Wi-Fi and BLE have superior RF performance that is maintained even at high temperatures.

* AI Acceleration Support: ESP32-S3 has additional support for vector instructions in the MCU, which provides acceleration for neural network computing and signal processing workloads. The software libraries for the above-mentioned optimized functions will become available very soon, in the form of updates to ESP-DSP and ESP-NN.

* Rich IO interfaces: ESP32-S3 has 45 programmable GPIOs and common peripheral interfaces such as SPI, I2S, I2C, PWM, RMT, ADC, UART, SD/MMC host controller and TWAITM controller. Fourteen of the GPIOs can be configured as capacitive touch inputs for HMI interaction. In addition, ESP32-S3 is equipped with an ultra-low power coprocessor (ULP) and supports multiple low-power modes, making it widely applicable to various low-power application scenarios.

* Security mechanism: ESP32-S3 provides comprehensive security mechanism and protection measures for iot devices to prevent all kinds of malicious attacks and threats. It supports Flash encryption based on AES-XTS algorithm, secure startup based on RSA algorithm, digital signature and HMAC. Esp32-s3 also includes a new "World Controller" module, which provides two non-interfering execution environments to implement a trusted execution environment or permission separation mechanism.

= Hardware =

== Hardware interface ==

[[File:BPI-PicoW-S3-V0.4-IO.png|800px]]

== Hardware spec ==

{| class="wikitable"
|-
!colspan="2" style="background-color:#ffcb2f;" | BPI-PicoW-S3 Spec Sheet
|-
| SoC
| ESP32-S3, Xtensa® 32-bit LX7 dual core
|-
| Basic frequency
| 240MHz MAX
|-
| Operating temperature
| -40℃~+85℃
|-
| On-chip ROM
| 384KB
|-
| On-chip SRAM
| 320KB
|-
| Extereal FLASH
| 8MB
|-
| In-packge PSRAM
| 2MB
|-
| WIFI
| IEEE 802.11 b/g/n, 2.4Ghz band, 150Mbps
|-
| Bluetooth
| Bluetooth 5, Bluetooth mesh
|-
| GPIO
| BPI-PicoW-S3 has led out 27 available GPIOs
|-
| ADC
| 2 × 12-bit SAR ADC supporting 18 analog channel inputs
|-
| TOUCH Capacitive Touch Sensor
| 14
|-
| SPI
| 4
|-
| I2C
| 2. Support master or slave mode
|-
| I2S
| 2, input and output of serial stereo data
|-
| LCD
| 1, support 8-bit ~16-bit parallel RGB, I8080, MOTO6800 interface
|-
| CAMERA
| 1, supports 8-bit ~16-bit DVP image sensor interface
|-
| UART
| 3, supports asynchronous communication (RS232 and RS485) and IrDA
|-
| PWM
| 8 independent channels, 14-bit precision
|-
| MCPWM
| 2
|-
| USB
| 1 × Full Speed USB 2.0 OTG, MicroUSB Female
|-
| USB Serial/JTAG Controller
| 1, USB full speed standard, CDC-ACM, JTAG
|-
| Temperature sensor
| 1, the measurement range is –20 °C to 110 °C, for monitoring the internal temperature of the chip
|-
| SD/MMC
| 1 × SDIO host interface, with 2 card slots, supports SD card 3.0 and 3.01, SDIO 3.0, CE-ATA 1.1, MMC 4.41, eMMC 4.5 and 4.51
|-
| TWAI® Controller
| 1, compatible with ISO11898-1 (CAN specification 2.0)
|-
| Generic DMA Controller
| 5 receive channels and 5 transmit channels
|-
| RMT
| 4-channel transmit, 4-channel receive, shared 384 x 32-bit RAM
|-
| Pulse Counter
| 4 pulse count controllers (units), each unit has 2 independent channels
|-
| Timer
| 4 × 54-bit general-purpose timers, 16-bit clock prescaler, 1 × 52-bit system timer, 3 × watchdog timers
|-
| External crystal
| 40Mhz
|-
| RTC and Low Power Management
| Power Management Unit (PMU) + Ultra Low Power Coprocessor (ULP)
|-
| Low power consumption current
| 10uA
|-
| Working Voltage
| 3.3V
|-
| Input voltage
| 3.3V~5.5V
|-
| Maximum discharge current
| 2A@3.3V DC/DC
|-
| Controllable full color LED
| 1
|-
| Controllable monochrome LED
| 1
|}

== Hardware Size ==

[[File:BPI-Pico-S3-board-dimension.png|800px]]

{| class="wikitable"
|-
!colspan="2" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 size chart
|-
| Pin spacing
| 2.54mm
|-
| Hole Spacing
| 11.4mm/ 47mm
|-
| Hole size
| Inner diameter 2.1mm/Outer diameter 3.4mm
|-
| Mainboard size
| 21 × 51.88(mm)/0.83 x 2.04(inches)
|-
| Thickness
| 1.2mm
|}

The pin spacing is compatible with universal boards (hole boards, dot matrix boards) and breadboards, which is convenient for debugging applications.

==GPIO define ==

{| class="wikitable"
|-
!colspan="3" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 peripheral GPIO pin assignment
|- style="background-color:#32cb00;"
| Peripheral Interface
| Signal
| Pins
|-
| rowspan="2" | ADC
| ADC1_CH0~9
| GPIO 1~10
|-
| ADC2_CH0~9
| GPIO 11~20
|-
| Touch Sensor
| TOUCH1~14
| GPIO 1~14
|-
| rowspan="4"|JTAG
| MTCK
| GPIO 39
|-
| MTDO
| GPIO 40
|-
| MTDI
| GPIO 41
|-
| MTMS
| GPIO 42
|-
| rowspan="14" | UART
| colspan="2" style="font-style:italic;color:#9b9b9b;" | Default assigned pins, can be redefined as any GPIO
|-
| style="background-color:#ffffc7;" | U0RXD_in
| style="background-color:#ffffc7;" | GPIO 44
|-
| U0CTS_in
| GPIO 16
|-
| U0DSR_in
| Any GPIO
|-
| style="background-color:#ffffc7;" | U0TXD_out
| style="background-color:#ffffc7;" | GPIO43
|-
| U0RTS_out
| GPIO 15
|-
| U0DTR_out
| Any GPIO
|-
| style="background-color:#ffffc7;" | U1RXD_in
| style="background-color:#ffffc7;" | GPIO 18
|-
| U1CTS_in
| GPIO 20
|-
| U1DSR_in
| Any GPIO
|-
| style="background-color:#ffffc7;" | U1TXD_out
| style="background-color:#ffffc7;" | GPIO 17
|-
| U1RTS_out
| GPIO 19
|-
| U1DTR_out
| Any GPIO
|-
| style="background-color:#9aff99;" | U2
| style="background-color:#9aff99;" | Any GPIO
|-
| I2C
| colspan="2" | Any GPIO
|-
| PWM
| colspan="2" | Any GPIO
|-
| I2S
| colspan="2" | Any GPIO
|-
| LCD
| colspan="2" | Any GPIO
|-
| CAMERA
| colspan="2" | Any GPIO
|-
| RMT
| colspan="2" | Any GPIO
|-
| SPI0/1
| colspan="2" | Used for FLASH and PSRAM
|-
| SPI2/3
| colspan="2" | Any GPIO
|-
| Pulse Counter
| colspan="2" | Any GPIO
|-
| rowspan="8" | USB OTG
| D-
| GPIO 19 (internal PHY)
|-
| D+
| GPIO 20 (internal PHY)
|-
| VP
| GPIO 42 (External PHY)
|-
| VM
| GPIO 41 (External PHY)
|-
| RCV
| GPIO21 (External PHY)
|-
| OEN
| GPIO 40 (External PHY)
|-
| VPO
| GPIO 39 (External PHY)
|-
| VMO
| GPIO38 (External PHY)
|-
| rowspan="7" | USB Serial/JTAG
| D-
| GPIO 19 (internal PHY)
|-
| D+
| GPIO 20 (internal PHY)
|-
| VP
| GPIO 42 (External PHY)
|-
| VM
| GPIO 41 (External PHY)
|-
| OEN
| GPIO 40 (External PHY)
|-
| VPO
| GPIO 39 (External PHY)
|-
| VMO
| GPIO38 (External PHY)
|-
| SD/MMC
| colspan="2" | Any GPIO
|-
| MCPWM
| colspan="2" | Any GPIO
|-
| TWAI
| colspan="2" | Any GPIO
|-
| Full Color LED
| colspan="2" | GPIO 48
|-
| Monochrome LED
| colspan="2" | GPIO 46
|}

= Software =

== CircuitPython ==

[[File:CircuitPython_Repo_header_logo.jpg | 800px]]

CircuitPython is a programming language designed to simplify experimenting and learning to code on low-cost microcontroller boards.

CircuitPython programming with Mu editor is the easiest way to get started. Install the software and connect the device to start using it.

* [https://codewith.mu/ Mu Editor Download Page]

* [[ code_circuitpython_with_mu_en | Getting Started: Code CircuitPython with Mu Editor ]]

'''Supported by the adafruit/circuitpython GitHub repository'''

https://github.com/adafruit/circuitpython/pull/7031

'''Supported by the adafruit/tinyuf2 GitHub repository'''

https://github.com/adafruit/tinyuf2/pull/250

'''Reference Resources''' :

* [https://learn.adafruit.com/welcome-to-circuitpython Adafruit: Welcome To CircuitPython]

* [https://learn.adafruit.com/getting-started-with-web-workflow-using-the-code-editor/overview Adafruit:CircuitPython Web Workflow Code Editor Quick Start]

* [https://circuitpython.readthedocs.io/ Adafruit:CircuitPython Docs]

* [https://github.com/todbot/circuitpython-tricks GitHub:CircuitPython-tricks]

* [https://forum.banana-pi.org/t/bpi-pico-s3-getting-started-code-circuitpython-with-mu-editor/13969 BPI-Pico-S3 Getting Started, Code CircuitPython with Mu Editor]

==ESP-IDF==

[[File:Esp-idf-logo.png | 800px]]

ESP-IDF is an IoT development framework officially launched by Espressif, supporting Windows, Linux and macOS operating systems.

It is recommended that developers install ESP-IDF via an integrated development environment (IDE):

* [https://github.com/espressif/idf-eclipse-plugin/blob/master/README_CN.md GitHub: ESP-IDF Eclipse Plugin Installation and Usage Guide]
* [https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension ESP-IDF VSCode plugin] | [https://github.com/espressif/vscode-esp-idf-extension/blob /master/docs/tutorial/toc.md GitHub: Installation and Usage Guide] | [https://www.bilibili.com/video/BV17p4y167uN bilibili: ESP-IDF VSCode Plugin Quick Operation Guide]

Or select the corresponding manual installation process according to the operating system:

* [https://docs.espressif.com/projects/esp-idf/en_US/latest/esp32s3/get-started/windows-setup.html Standard setup for Windows platform toolchain]
* [https://docs.espressif.com/projects/esp-idf/en_US/latest/esp32s3/get-started/linux-macos-setup.html Standard setup for Linux and macOS platform toolchains]

API:

* [https://docs.espressif.com/projects/esp-idf/en_US/latest/esp32s3/api-reference/index.html#api API Reference]
* [https://docs.espressif.com/projects/esp-idf/en_US/latest/esp32s3/api-guides/index.html#api API Guide]

In order to enable your BPI-Leaf-S3 development board to flash FLASH through USB-CDC, you need to set the development board to firmware download mode.

There are two methods of operation:

1. Connect to the computer via USB, press and hold the BOOT button, then press the RESET button and release it, and finally release the BOOT button.

2. Press and hold the BOOT button when the power supply is disconnected, then connect to the computer via USB, and finally release the BOOT button.

You need to confirm the interface in the device manager. The serial number of the interface in the firmware download mode and the normal mode may be different.

==MicroPython==

[[File:Mircopython.png | 800px]]

MicroPython implements most of the features and syntax of Python 3, which is easy to learn and use, and can be downloaded directly into the chip to run the verification program without compiling.

Regardless of whether you have a programming foundation or not, MicroPython is far less difficult to get started with than other programming languages. Its code is easy to read, and the open source community has accumulated rich resources over the years. Just like Python, it has strong vitality and application value.

==Arduino==

[[File:Arduino_logo_1200x350.png | 800px]]

Arduino is an open source embedded software and hardware development platform for users to create interactive embedded projects.

* [https://www.arduino.cc/en/software Arduino IDE download address] | [https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html#installing Install and configure Arduino-ESP32 operating environment]
* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/Example/Arduino GitHub: BPI-Leaf-S3 Arduino Quick Start]
* [https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html#apis Arduino-ESP32 APIs]

=Resources=
BPI-PicoW-S3 schematic : https://github.com/BPI-STEAM/BPI-PicoW-Doc/blob/main/sch/BPI-PicoW-V0.4.pdf

=Easy to buy sample=

* Official AliExpress:https://www.aliexpress.com/item/1005004775634442.html
* SinoVoip Aliexpress : https://www.aliexpress.com/item/1005004775859077.html
* Official Taobao: https://item.taobao.com/item.htm?spm=a2126o.success.0.0.25b04831CHV1Nc&id=684134360199
* OEM&OEM customized service: sales@banana-pi.com

BPI-PicoW-S3 开发板

2022-11-17T09:16:06Z

Qubot: /* BPI-PicoW-S3 与 Rraspberry Pi PicoW、BPI-Leaf-S3、ESP32-S3-DevKitC-1 开发板对比 */

[[en:BPI-PicoW-S3]]

= 介绍 =
[[File:BPI-PicoW-S3 banner.png|800px]]

[[File:PICO-1000-7.jpg|thumb|[[BPI-PicoW-S3_开发板 ]]with ESP32-S3]]
[[File:PICO-1000-5.png|thumb|[[BPI-PicoW-S3_开发板 ]]with ESP32-S3]]
[[File:Smart-01-03.gif|thumb|[[BPI-Smart ]]with ESP8266]]
[[File:Webduino_gif.gif|thumb|[[BPI-Bit]] with ESP32]]
[[File:BPI-AI_1.JPG|thumb|[[BPI-AI]] Kendryte K210 RISC-V]]
[[File:ESP32_6.JPG|thumb|[[BPI-UNO32]] with ESP32 design]]

Banana Pi BPI-PicoW-S3 是一系列低功耗微控制器，专为物联网开发和Maker DIY设计的开发板。与 Raspberry Pi Pico 板尺寸相同，支持 2.4 GHz Wi-Fi 和 Bluetooth® LE 双模无线通信，外设兼容低功耗硬件设计，深度睡眠模式下功耗仅为10uA。编程方面，PicoW-S3支持ESP-IDF、Arduino、micropython、CircuitPython 等多种方式

== 关键特性 ==

* ESP32-S3，Xtensa® 32 bit LX7
* 片外 PSRAM , FLASH
* Ultra-low power 10uA
* 2.4G WIFI ，Bluetooth 5 ，Bluetooth mesh
* GPIO , ADC , TOUCH , PWM , I2C , SPI , RMT , I2S , UART , LCD，CAMERA ，USB , JTAG
* 1 * microUSB
* 1 * 全彩色LED

== BPI-PicoW-S3 与 Raspberry Pi PicoW、BPI-Leaf-S3、ESP32-S3-DevKitC-1 开发板对比 ==

{| class="wikitable"
|- style="font-weight:bold;"
! 开发板
! BPI-PicoW-S3
! Raspberry Pi PicoW
! BPI-Leaf-S3
! ESP32-S3-DevKitC-1
|-
| 引出GPIO
| 27
| 27
| 36
| 36
|-
| 3.3v管脚
| 1
| 1
| 2
| 2
|-
| 5v管脚
| 2
| 2
| 1
| 1
|-
| GND管脚
| 8
| 8
| 4
| 4
|-
| 全彩LED灯
| 1 on GPIO48
| 无
| 1 on GPIO48
| 1 on GPIO48
|-
| 芯片直连USB
| MicroUSB接口x1
| MicroUSB接口x1
| Type-C USB接口x1
| MicroUSB接口x1
|-
| UART TTL转USB
| 无
| 无
| 无
| CP2102-MicroUSB接口x1
|-
| 外接电池连接座
| 无
| 无
| 3.7v锂电池供电接口
| 无
|-
| 电池充电
| 无
| 无
| 500mA充电
| 无
|-
| I²C 4pin连接座
| 无
| 无
| 1
| 无
|}

== Espressif ESP32-S3 ==

ESP32-S3 是一款集成 2.4 GHz Wi-Fi 和 Bluetooth 5 (LE) 的 MCU 芯片，支持远距离模式 (Long Range)。ESP32-S3 搭载 Xtensa® 32 位 LX7 双核处理器，主频高达 240 MHz，内置 512 KB SRAM (TCM)，具有 45 个可编程 GPIO 管脚和丰富的通信接口。ESP32-S3 支持更大容量的高速 Octal SPI flash 和片外 RAM，支持用户配置数据缓存与指令缓存。

以下是ESP32-S3芯片重要功能的描述。

* '''支持Wi-Fi + Bluetooth 5 (LE) 无线连接''': ESP32-S3 集成 2.4 GHz Wi-Fi (802.11 b/g/n)，支持 40 MHz 带宽；其低功耗蓝牙子系统支持 Bluetooth 5 (LE) 和 Bluetooth Mesh，可通过 Coded PHY 与广播扩展实现远距离通信。它还支持 2 Mbps PHY，用于提高传输速度和数据吞吐量。ESP32-S3 的 Wi-Fi 和 Bluetooth LE 射频性能优越，在高温下也能稳定工作。

* '''支持 AI 加速''': ESP32-S3 MCU 增加了用于加速神经网络计算和信号处理等工作的向量指令 (vector instructions)。AI 开发者们通过 ESP-DSP 和 ESP-NN 库使用这些向量指令，可以实现高性能的图像识别、语音唤醒和识别等应用。

* '''丰富的 IO 接口''': ESP32-S3 拥有 45 个可编程 GPIO 以及 SPI、I2S、I2C、PWM、RMT、ADC、UART、SD/MMC 主机控制器和 TWAITM 控制器等常用外设接口。其中的 14 个 GPIO 可被配置为 HMI 交互的电容触摸输入端。此外，ESP32-S3 搭载了超低功耗协处理器 (ULP)，支持多种低功耗模式，广泛适用于各类低功耗应用场景。

* '''完善的安全机制''': ESP32-S3 为物联网设备提供了完善的安全机制和保护措施，防止各类恶意攻击和威胁。它支持基于 AES-XTS 算法的 flash 加密、基于 RSA 算法的安全启动、数字签名和 HMAC。ESP32-S3 还新增了一个“世界控制器 (World Controller)”模块，提供了两个互不干扰的执行环境，实现可信执行环境或权限分离机制。

= 硬件 =

== 硬件接口示意图 ==

[[File:BPI-PicoW-S3-V0.4-IO.png|800px]]

== 硬件规格 ==

{| class="wikitable"
|-
! colspan="2" style="background-color:#ffcb2f;" | BPI-PicoW-S3 规格表
|-
| SoC主控芯片
| ESP32-S3，Xtensa® 32 位 LX7 双核处理器
|-
| 主频
| 240MHz MAX
|-
| 工作温度
| -40℃~+85℃
|-
| 片上 ROM
| 384 KB
|-
| 片上 SRAM
| 320 KB
|-
| 外置FLASH
| 8MB
|-
| 封装内PSRAM
| 2MB
|-
| WIFI
| IEEE 802.11 b/g/n ，2.4Ghz频带，150Mbps
|-
| 蓝牙
| Bluetooth 5 ，Bluetooth mesh
|-
| GPIO
| BPI-PicoW-S3已引出27个可用GPIO
|-
| ADC
| 2 × 12 位 SAR ADC，支持 18 个模拟通道输入
|-
| TOUCH 电容式触摸传感器
| 14
|-
| SPI
| 4
|-
| I2C
| 2，支持主机或从机模式
|-
| I2S
| 2，串行立体声数据的输入输出
|-
| LCD
| 1，支持 8 位 ~16 位并行 RGB、I8080、MOTO6800 接口
|-
| CAMERA
| 1，支持 8 位 ~16 位 DVP 图像传感器接口
|-
| UART
| 3 ，支持异步通信（RS232 和RS485）和 IrDA
|-
| PWM
| 8 路独立通道，14位精度
|-
| MCPWM
| 2
|-
| USB
| 1 × 全速USB 2.0 OTG，MicroUSB母口
|-
| USB Serial/JTAG 控制器
| 1，USB 全速标准，CDC-ACM ，JTAG
|-
| 温度传感器
| 1，测量范围为–20 °C 到 110 °C，用于监测芯片内部温度
|-
| SD/MMC
| 1 × SDIO主机接口，具有2个卡槽，支持SD卡3.0和3.01，SDIO 3.0，CE-ATA 1.1，MMC 4.41，eMMC 4.5和4.51
|-
| TWAI® 控制器
| 1 ，兼容 ISO11898-1（CAN 规范 2.0）
|-
| 通用 DMA 控制器
| 5 个接收通道和 5 个发送通道
|-
| RMT
| 4 通道发射，4通道接收，共享 384 x 32-bit 的 RAM
|-
| 脉冲计数器
| 4个脉冲计数控制器（单元），每个单元有2个独立的通道
|-
| 定时器
| 4 × 54 位通用定时器，16 位时钟预分频器，1 × 52 位系统定时器，3 × 看门狗定时器
|-
| 外部晶振
| 40Mhz
|-
| RTC 和低功耗管理
| 电源管理单元 (PMU)+ 超低功耗协处理器 (ULP)
|-
| 低功耗电流
| 10uA
|-
| 工作电压
| 3.3V
|-
| 输入电压
| 3.3V~5.5V
|-
| 最大放电电流
| 2A@3.3V DC/DC
|-
| 可控全彩色LED
| 1
|-
| 可控单色LED
| 1
|}

== 硬件尺寸 ==

[[File:BPI-Pico-S3-board-dimension.png|800px]]

{| class="wikitable"
|-
! colspan="2" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 尺寸表
|-
| 管脚间距
| 2.54mm
|-
| 安装孔间距
| 11.4mm/ 47mm
|-
| 安装孔尺寸
| 内径2.1mm/外径3.4mm
|-
| 主板尺寸
| 21 × 51.88(mm)/0.83 x 2.04(inches)
|-
|}

管脚间距兼容万能板（洞洞板、点阵板），面包板，便于调试应用。

== 外设GPIO管脚分配 ==

{| class="wikitable"
|-
! colspan="3" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 外设GPIO管脚分配
|- style="background-color:#32cb00;"
| 外设接口
| 信号
| 管脚
|-
| rowspan="2" | ADC
| ADC1_CH0~9
| GPIO 1~10
|-
| ADC2_CH0~9
| GPIO 11~20
|-
| 触摸传感器
| TOUCH1~14
| GPIO 1~14
|-
| rowspan="4"|JTAG
| MTCK
| GPIO 39
|-
| MTDO
| GPIO 40
|-
| MTDI
| GPIO 41
|-
| MTMS
| GPIO 42
|-
| rowspan="14" | UART
| colspan="2" style="font-style:italic;color:#9b9b9b;" | 默认分配管脚，可重定义为任意GPIO
|-
| style="background-color:#ffffc7;" | U0RXD_in
| style="background-color:#ffffc7;" | GPIO 44
|-
| U0CTS_in
| GPIO 16
|-
| U0DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U0TXD_out
| style="background-color:#ffffc7;" | GPIO43
|-
| U0RTS_out
| GPIO 15
|-
| U0DTR_out
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1RXD_in
| style="background-color:#ffffc7;" | GPIO 18
|-
| U1CTS_in
| GPIO 20
|-
| U1DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1TXD_out
| style="background-color:#ffffc7;" | GPIO 17
|-
| U1RTS_out
| GPIO 19
|-
| U1DTR_out
| 任意GPIO
|-
| style="background-color:#9aff99;" | U2
| style="background-color:#9aff99;" | 任意GPIO
|-
| I2C
| colspan="2" | 任意GPIO
|-
| PWM
| colspan="2" | 任意GPIO
|-
| I2S
| colspan="2" | 任意GPIO
|-
| LCD
| colspan="2" | 任意GPIO
|-
| CAMERA
| colspan="2" | 任意GPIO
|-
| RMT
| colspan="2" | 任意GPIO
|-
| SPI0/1
| colspan="2" | 已用于FLASH与PSRAM
|-
| SPI2/3
| colspan="2" | 任意GPIO
|-
| 脉冲计数器
| colspan="2" | 任意GPIO
|-
| rowspan="8" | USB OTG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| RCV
| GPIO21（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| rowspan="7" | USB Serial/JTAG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| SD/MMC
| colspan="2" | 任意GPIO
|-
| MCPWM
| colspan="2" | 任意GPIO
|-
| TWAI
| colspan="2" | 任意GPIO
|-
| 全彩色LED
| colspan="2" | GPIO 48
|-
| 单色LED
| colspan="2" | GPIO 46
|}

= 软件 =

== CircuitPython ==

[[File:CircuitPython_Repo_header_logo.jpg | 800px]]

CircuitPython是旨在简化在单片机开发板上进行编程实验和学习的一种编程语言。

配合Mu编辑器进行CircuitPython编程是最低难度的上手方法，安装软件，连接设备即可开始使用。

* [https://codewith.mu/ Mu编辑器官方下载页面]

* [[ code_circuitpython_with_mu_ch | 快速上手: 在Mu编辑器中进行CircuitPython编程 ]]

'''已得到adafruit/circuitpython GitHub存储库支持'''

https://github.com/adafruit/circuitpython/pull/7031

'''已得到adafruit/tinyuf2 GitHub存储库支持'''

https://github.com/adafruit/tinyuf2/pull/250

'''参考资源''':

* [https://learn.adafruit.com/welcome-to-circuitpython Adafruit:CircuitPython入门教程]

* [https://learn.adafruit.com/getting-started-with-web-workflow-using-the-code-editor/overview Adafruit:上手CircuitPython网页代码编辑器]

* [https://circuitpython.readthedocs.io/ Adafruit:CircuitPython文档]

* [https://github.com/todbot/circuitpython-tricks GitHub:CircuitPython技巧与例程]

== ESP-IDF ==

[[File:Esp-idf-logo.png | 800px]]

ESP-IDF 是乐鑫官方推出的物联网开发框架，支持 Windows、Linux 和 macOS 操作系统。

建议开发者通过集成开发环境 (IDE) 安装 ESP-IDF:

* [https://github.com/espressif/idf-eclipse-plugin/blob/master/README_CN.md GitHub: ESP-IDF Eclipse 插件安装与使用指南]
* [https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension ESP-IDF VSCode 插件] | [https://github.com/espressif/vscode-esp-idf-extension/blob/master/docs/tutorial/toc.md GitHub: 安装与使用指南] | [https://www.bilibili.com/video/BV17p4y167uN bilibili：ESP-IDF VSCode 插件快速操作指南]

或者根据操作系统选择对应的手动安装流程:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/windows-setup.html Windows 平台工具链的标准设置]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/linux-macos-setup.html Linux 和 macOS 平台工具链的标准设置]

API:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/index.html#api API 参考]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-guides/index.html#api API 指南]

为了使你的BPI-Leaf-S3开发板可以通过USB-CDC刷写FLASH，需要设置开发板为固件下载模式。

有两种操作方法：

1.通过USB连接到电脑，按住BOOT键，再按一下RESET键并松开，最后松开BOOT键。

2.在断开供电的条件下按住BOOT键，再通过USB连接到电脑，最后松开BOOT键。

需要在设备管理器中确认接口，固件下载模式与普通模式下的接口序号可能是不一样的。

== MicroPython ==

[[File:Mircopython.png | 800px]]

MicroPython实现了大部分Python 3 特性和语法，易学易上手，验证程序效果无需编译直接下载进芯片运行。

无论是否有编程基础，MicroPython的上手难度绝对远低于其他编程语言，其代码易读性高，且开源社区有多年积累的丰富资源，就如同Python一样拥有极强的生命力与应用价值。

* '''[https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/tree/main/Example/MicroPython-zh#1%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B GitHub: MicroPython快速上手]'''

* [[ micropython_运行环境搭建 | MicroPython运行环境搭建(Thonny IDE) ]]

* [[ micropython_固件下载与烧录 | MicroPython固件下载与烧录 ]]

== Arduino ==

[[File:Arduino_logo_1200x350.png | 800px]]

Arduino 是一个开源嵌入式软硬件开发平台，用来供用户制作可交互式的嵌入式项目。

* [https://www.arduino.cc/en/software Arduino IDE 下载地址] | [https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html#installing 安装并配置Arduino-ESP32运行环境]
* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/Example/Arduino GitHub: BPI-Leaf-S3 Arduino快速上手]
* [https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html#apis Arduino-ESP32 APIs]

= 资料与资源 =

=样品购买=

* 比派科技官方速卖通店:https://www.aliexpress.com/item/1005004775634442.html
* SinoVoip 官方速卖通店 : https://www.aliexpress.com/item/1005004775859077.html
* 官方淘宝店: https://item.taobao.com/item.htm?spm=a2126o.success.0.0.25b04831CHV1Nc&id=684134360199
* OEM&OEM 定制服务: sales@banana-pi.com

Banana Pi BPI-M5

2022-10-21T03:01:24Z

Qubot: /* BPI-M5 40PIN GPIO (CON2) */

[[zh:香蕉派_BPI-M5]]
=BPI-M5 Introduction=
[[File:Banana_Pi_BPI-M5_4.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[Banana Pi BPI-M2S]] Amlogic A311D/S922 chip]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|Amlogic S905X3 Processor]]
[[File:Banana_Pi_BPI-M5_2.jpg|thumb|Amlogic S905X3 Processor]]

[[File:BPI-M5_case_1.jpg|thumb|BPI-M5 case design]]
[[File:Wifibt_module_1.jpeg|thumb|WiFi&BT board, 802.11 a/b/g/n/ac 2T2R WiFi and Bluectooch 5.0]]

Banana Pi BPI-M5 is the next generation single board computer from Banana Pi in 2020. It is powered by Amlogic S905X3 quad-core Cortex-A55 (2.0 XXGHz) processor.Onboard 4GB LPDDR4 memory and 16GB EMMC storage, and supports 4 USB 3.0 interface, a gigabit network port.

[[File:Banana_Pi_BPI-M5.jpg]]

=Key Features=
* Amlogic S905X3 quad core Cortex-A55 (2.0xxGHz)
* Mali-G31 GPU
* 4GB LPDDR4
* 16GB eMMC flash
* 4 USB 3.0
* 1 GbE ethernet
* HDMI output

==Getting Start==
*[[Getting Started with M5/M2Pro]]

=Hardware=
==Hardware interface==
[[File:Banana_Pi_BPI-M5_interface1.jpg]]

==Hardware spec==
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''HardWare Specification of Banana pi BPI-M5'''
|-
|CPU|| Amlogic S905X3 Quad-Core Cortex-A55 (2.0xxGHz)
|-
| GPU||Mali-G31 MP2 GPU with 4 x Execution Engines (650Mhz)
|-
| Memory|| 4 GB LPDDR4
|-
| Storage|| MicroSD slot with support for up to 256GB expansion and 16G eMMC flash with support for up to 64GB
|-
| Network|| 10/100/1000 Mbit/s Ethernet ,Optional WiFi USB dongle
|-
|Video Output(s)|| 1 x HDMI 2.1 (up to 4K@60Hz with HDR, CEC, EDID)
|-
| Audio Output(s)|| 3.5mm jack and 1 x HDMI digital output
|-
| USB ports|| USB 3.0 PORT (x4)
|-
|GPIO|| 40 Pin Header : GPIO (x28) and Power (+5V, +3.3V and GND). GPIO pins can be used for UART, I2C, SPI or PWM
|-
|Switches|| Reset, Power and U-boot
|-
| LED|| Power Status and Activity status
|-
| Power Source|| 5 volt @3A via Micro USB (TYPE C)
|-
|Size & Weight|| 92x60mm, 48g
|-
|OS|| Android and Linux
|}

==Wifi & BT support via expansion board==

===SDIO interface Wifi&BT===

* WiFi&BT board, 802.11 a/b/g/n/ac 2T2R WiFi and Bluetooth 5.0 , support BPI-M5 and BPI-F2P

[[File:Wifibt_module1_.jpeg]]

*how to use : http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Wifi.2FBT_support
*discuss on forum : http://forum.banana-pi.org/t/bpi-m5-wifi-bt-board-sdio-interface-802-11-a-b-g-n-ac-2t2r-wifi-and-bluectooch-5-0/11846
*RT8822CS Bluetooth and WiFi adapter for Banana Pi BPI-M5：https://www.magazinmehatronika.com/en/rt8822cs-bluetooth-and-wifi-adapter-for-banana-pi-m5/?fbclid=IwAR0Oqm4TCa2SAXBTMJgRmWMJI-VQREqFxLh1-LnT_XzA5MAvYh_BL9-L7Xk
*easy to buy sample : https://www.aliexpress.com/item/1005002550783568.html?spm=5261.ProductManageOnline.0.0.34ed4edfgdV59j

===standard USB interface Wifi&BT===

*Banana Pi Wifi&BT 4.2 expansion Board, standard USB interface, so support all open source boards via USB port.IEEE 802.11b/g/n/ac(1T1R) USB WLANAnd BT Module

[[File:Usb_wifi_bt_board_3.jpg]]

*how to use : http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Wifi.2FBT_support
*discuss on forum : http://forum.banana-pi.org/t/banana-pi-wifi-bt-4-2-expansion-board-standard-usb-interface/12162

==BPI-M2 Pro VS BPI-M5 VS Odroid C4 VS RPI 4 ==

{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''BPI-M2 Pro VS BPI-M5 VS Odroid C4 VS RPI 4'''
|-
|||[[Banana Pi BPI-M2 Pro]]||[[Banana Pi BPI-M5]]|| Odroid C4|| Raspberry Pi 4||
|-
|Processor||Amlogic S905X3 Quad-Core Cortex-A55 ARMv8.2-A 64-bit 1.5GHz ||Amlogic S905X3 Quad-Core Cortex-A55 ARMv8.2-A 64-bit 1.5GHz || Amlogic S905X3 Quad-Core Cortex-A55 ARMv8.2-A 64-bit 1.5GHz || Broadcom BCM2711, Quad core Cortex-A72 (ARM v8) 64-bit SoC @ 1.5GHz
|-
|GPU ||Mali-G31 MP2 GPU ||Mali-G31 MP2 GPU || Mali-G31 MP2 GPU || Broadcom VideoCore VI
|-
|RAM ||2GB LPDDR4 ||4GB LPDDR4 ||DDR4 4GiB with 32-bit bus width ||2GB, 4GB or 8GB LPDDR4-3200 SDRAM
|-
|Storage || micro SD card slot & 16GB eMMC flash on board|| micro SD card slot & 16GB eMMC flash on board ||micro SD card slot , eMMC connector for option ||micro SD card slot, non EMMC
|-
|Network ||1 GbE ,WiFi&BT5.0 onbard|| GbE ,Optional WiFi USB dongle || GbE ||GbE, 2.4 GHz and 5.0 GHz IEEE 802.11ac wireless, Bluetooth 5.0, BLE
|-
|Video Output || 1 x HDMI 2.1 (up to 4K@60Hz with HDR, CEC, EDID)|| 1 x HDMI 2.1 (up to 4K@60Hz with HDR, CEC, EDID) || 1 x HDMI 2.1 (up to 4K@60Hz with HDR, CEC, EDID) || 2 × micro-HDMI 2.0
|-
|Audio Output || 1 x HDMI digital output ||3.5mm jack and 1 x HDMI digital output || Optional SPDIF optical output || 3.5 mm analogue audio-video jack
|-
|DSI ||N/A ||N/A ||N/A || 2-lane MIPI DSI display port
|-
|CSI ||N/A ||N/A ||N/A ||2-lane MIPI CSI camera port
|-
|USB ||USB 3.0 x 2 1 Micro USB 2.0||USB 3.0 x 4 TYPE C ||USB 3.0 x 4, 1 x Micro USB 2.0 port (OTG) || 2 USB 3.0 ports; 2 USB 2.0 ports;
|-
|Power ||5 volt @3A via DC power ||5 volt @3A via Micro USB (TYPE C) ||1 x DC power jack (Outer diameter : 5.5mm, inner diameter : 2.1mm) || 5V DC via USB-C connector (minimum 3A*)
|-
|IR ||Yes||Yes ||Yes ||N/A
|-
|GPIO ||40 Pin Header : GPIO (x28) and Power (+5V, +3.3V and GND).||40 Pin Header : GPIO (x28) and Power (+5V, +3.3V and GND). || 40 x GPIO pins ||40-pin GPIO header, populated
|-
|Button ||Reset, user and U-boot ||Reset, user and U-boot || N/A || N/A ||
|-
|LED || Power Status and Activity status|| Power Status and Activity status || Power Status and Activity status || Power Status and Activity status
|-
|Dimensions & weight||65mm x 65mm,58g ||85mm x 56mm, 48g ||85mm x 56mm 59g ||88 mm × 58 mm, 46 g
|-
|System Support|| Linux & Android || Linux & Android ||Linux & Android ||Linux & Android
|}

==GPIO PIN define ==

===BPI-M5 40PIN GPIO (CON2)===
{| class="wikitable"
|-
|GPIO Pin Name ||Default Function ||Function2|| Function3
|-
|CON1-P01 ||VCC-3V3|| ||
|-
|CON1-P02|| VCC5V || ||
|-
|CON1-P03|| GPIOX_17 ||I2C_M2_SDA||
|-
|CON1-P04|| VCC5V ||||
|-
|CON1-P05|| GPIOX_18|| I2C_M2_SCL ||
|-
|CON1-P06|| GND ||||
|-
|CON1-P07|| GPIOX_5 SDIO_CMD||||
|-
|CON1-P08|| GPIOX_12|| UART_A_TX ||
|-
|CON1-P09|| GND ||||
|-
|CON1-P10|| GPIOX_13 ||UART_A_RX ||
|-
|CON1-P11|| GPIOX_3 SDIO_D3 ||||
|-
|CON1-P12|| GPIOAO_8|| TDMB_SCLK ||
|-
|CON1-P13|| GPIOX_4 SDIO_CLK||||
|-
|CON1-P14|| GND ||||
|-
|CON1-P15|| GPIOX_7 PWM_F ||||
|-
|CON1-P16|| GPIOX_0 SDIO_D0 ||||
|-
|CON1-P17|| VCC-3V3 ||||
|-
|CON1-P18|| GPIOX_1 SDIO_D1 ||||
|-
|CON1-P19|| GPIOX_8 PCM_DIN ||||
|-
|CON1-P20|| GND ||||
|-
|CON1-P21|| GPIOX_9 PCM_DOUT||||
|-
|CON1-P22|| GPIOX_2 SDIO_D2 ||||
|-
|CON1-P23|| GPIOX_11|| PCM_CLK ||
|-
|CON1-P24|| GPIOX_10 ||PCM_SYNC ||
|-
|CON1-P25|| GND ||||
|-
|CON1-P26|| GPIOX_16 ||PWM_E ||
|-
|CON1-P27|| GPIOA_14|| I2C_M3_SDA ||
|-
|CON1-P28|| GPIOA_15|| I2C_M3_SCL||
|-
|CON1-P29|| GPIOX_14|| UART_A_CTS ||
|-
|CON1-P30|| GND ||||
|-
|CON1-P31|| GPIOX_15 ||UART_A_RTS ||
|-
|CON1-P32|| GPIOX_19|| PWM_B ||
|-
|CON1-P33|| GPIOX_6 PWM_A ||||
|-
|CON1-P34|| GND ||||
|-
|CON1-P35|| GPIOAO_7|| TDMB_FS ||
|-
|CON1-P36|| GPIOH_5 SPDIF_IN||||
|-
|CON1-P37|| GPIOAO_9|| I2S_MCLK||
|-
|CON1-P38|| GPIOAO_10|| TDMB_DIN|| SPDIF_OUT
|-
|CON1-P39|| GND ||||
|-
|CON1-P40|| GPIOAO_4|| TDMB_DOUT||
|}

===BPI-M5 Debug UART(CON1) ===
{| class="wikitable"
|-
|CON2-P1|| GND
|-
|CON2-P2|| UART0-RX
|-
|CON2-P3|| UART0-TX
|-
|}

=Development=
==Source code==
===Android===
android 9 source code: https://github.com/BPI-SINOVOIP/BPI-S905X3-Android9

[http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Build_Android_Source_Code How to build the Android Source Code]

===Linux BSP source code===
Linux BSP source code: https://github.com/BPI-SINOVOIP/BPI-M5-bsp

[http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Build_Linux_Source_Code How to build the Linux BSP Source Code]

== Resources==
*Because of the Google security update some of the old links will not work if the images you want to use cannot be downloaded from the [https://drive.google.com/drive/folders/0B_YnvHgh2rwjVjNyS2pheEtWQlk?resourcekey=0-U4TI84zIBdId7bHHjf2qKA new link bpi-image Files]
*All banana pi [https://drive.google.com/drive/folders/0B4PAo2nW2Kfndjh6SW9MS2xKSWs?resourcekey=0-qXGFXKmd7AVy0S81OXM1RA&usp=sharing docement(SCH file,DXF file,and doc)]
*[https://download.banana-pi.dev/d/3ebbfa04265d4dddb81b/files/?p=%2FDocuments%2FBPI-M5%2FBPI-M5-SCH-V10-Release.pdf BPI-M5 schematic diagram]
*[https://download.banana-pi.dev/d/3ebbfa04265d4dddb81b/files/?p=%2FDocuments%2FBPI-M5%2FBPI-M5-PCB-V10-DXF.rar BPI-M5 PCB DXF file]
*[https://download.banana-pi.dev/d/3ebbfa04265d4dddb81b/files/?p=%2FDocuments%2FBPI-M5%2FS905X3_Public_Datasheet_Hardkernel.pdf Amlogic S905x3 datasheet]
*[http://wiki.banana-pi.org/Product_certification Banana Pi BPI-M5 CE,FCC,RoHS Certification]
*Install OpenGapps on Bananapi BPI-M5 Android 9.0:https://www.youtube.com/watch?v=fXOKmWfpqF8
*BANANA PI BPI-M5 REVIEW & BENCHMARKS：https://bret.dk/banana-pi-m5-review/

=System image=

==Android==
:[http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Android How to flash Android Image]

* 2022-09-07 release, BPI-M2 PRO/M5-Mbox-Android9
::Baidu Cloud: https://pan.baidu.com/s/1vqFGBDzY0gdqIIkX8ap5GA?pwd=uex1 (pincode: uex1)
::Google Drive:https://drive.google.com/file/d/1qmVfN-ocQJ2WqTdFw3vk1f5_kDnRGZeM/view?usp=sharing
::MD5: ac9ac49c3b37b9cd85de65bd64f9552f

* 2022-09-07 release, BPI-M2 PRO/M5-Tablet-Android9
::Baidu Cloud: https://pan.baidu.com/s/1vrmPlyPttoKU-FkPZZE-Jg?pwd=ds7a (pincode: ds7a)
::Google Drive:https://drive.google.com/file/d/1m-b5wYWazMM_QgnQ5iQZiPRRD6AmF-Ao/view?usp=sharing
::MD5: 84d60f44761a4d4958a50e47eee7a62a

*2021-05-20 release, Android 9.0 with kernel 4.9.113, mbox variant ui image
::Baidu Cloud: https://pan.baidu.com/s/1C-EiB4UcjuSYCfjFNlVL0g?pwd=8gqg (pincode: 8gqg)
::Google Drive:https://drive.google.com/file/d/1SkFY9Zoc5NY_wNXkzw514-DnN_TBy0K6/view?usp=sharing
::MD5: dda75a075a5d7572756f57e4a256dffa

*2021-05-20 release, Android 9.0 with kernel 4.9.113, tablet variant ui image
::Baidu Cloud: https://pan.baidu.com/s/1Z8KmmvvA8Bc-JwR4nbBOWA?pwd=dtk8 (pincode: dtk8)
::Google Drive:https://drive.google.com/file/d/1U3wLxouH2-IBBYQmHngWErLCwIJgLA7G/view?usp=sharing
::MD5: 27381d5e307034e5c5456b167f67ef75

==Linux==
:[http://wiki.banana-pi.org/Getting_Started_with_BPI-M5#Linux How to flash Linux Image]

===Raspbian===
*BPI-M5 BPI-M2 Pro new image:Raspbian image, 2022-4-09 update, Raspbian image for linux kernel 4.9 and 5.17. support 32bit and 64 bit,please choose the right image
::google driver: https://drive.google.com/drive/folders/1oqamIMl5Kmb3LVYMPFw-1tilvwKQI6n-
::discuss on forum : https://forum.banana-pi.org/t/bpi-m5-bpi-m2-pro-new-image-rasbian-image-2022-4-09-update/13246

===Ubuntu===

* 2022-09-06 release Ubuntu Mate Desktop 20.04 with Kernel 4.9
::Baidu Cloud: https://pan.baidu.com/s/1XE2K_KlVwP0hvjv_AChVgg?pwd=38vx (pincode: 38vx)
::Google drive: https://drive.google.com/file/d/1OGNaEylMR-VlfY6ynRkGQNuljLcvxoqe/view?usp=sharing
::MD5: 4b0528065ddcf634e9a43b6b7a6363b1

*2022-09-06 release, Ubuntu server 20.04 with Kernel 4.9
::Baidu Cloud: https://pan.baidu.com/s/15g52JerxZejcwywH7zZOlg?pwd=jtv5 (pincode: jtv5)
::Google drive:https://drive.google.com/file/d/15Y80CDT07HfEgo2YVjTkLSeIUGk8GQUo/view?usp=sharing
::MD5: f377dc5246f9ed7133db95c9d34b5201

*2021-06-21 release, Ubuntu Server 20.04 with kernel 4.9.241
::Baidu Cloud: https://pan.baidu.com/s/1IAugHTujzkTV9zfQoLw-iA?pwd=a37k (pincode: a37k)
::Google Drive:https://drive.google.com/file/d/1ASyBYkQmv6RMg_NSf2KQTpd87PosyeW-/view?usp=sharing
::MD5: 5c896c37eaa590cfbb8a6c7a5ba433a0

===Debian===
*2022-09-06 release, Debian-10-buster with Kernel 4.9
::Baidu Cloud: https://pan.baidu.com/s/1BEdv5AWEYgkMcUX_ju4DPQ?pwd=2cw4 (pincode: 2cw4)
::Google Drive:https://drive.google.com/file/d/1IZ7IEFeb21ZnaAuknz9lr00jo95UX6ml/view?usp=sharing
::MD5: f6cbe3518e8a02267224a0aa0256ce11

*2021-06-21 release, Debian Buster with kernel 4.9.241
::Baidu Cloud: https://pan.baidu.com/s/1xqk9wJ7o7aNCqa8k8Y4zGw?pwd=u5pu (pincode: u5pu)
::Google Drive:https://drive.google.com/file/d/1Ej-vYN98KZ0D17cjdtdZeDQjnkqEJ_wb/view?usp=sharing
::MD5: 4ea1d71a5ba1a8fa743e4c8abbe7569b

==Third part image==
===EmuELEC===
*This is a porting of EmuELEC v4.5 for BPI-M5. I ported from odroid c4 official EmuELEC image. PS3 a XBOX ONE S gamepad controllers were tested and work fine.
*https://forum.banana-pi.org/t/emuelec-for-bpi-m5/12095
===CoreELEC===
* CoreELEC 19.2
:[https://coreelec.org/ CoreELEC] official support Bananapi M5 and M2Pro since 19.2-Matrix_rc1
::Download: https://coreelec.org/#download
::Install Guide: https://coreelec.org/#install
::Source Code: https://github.com/CoreELEC/CoreELEC
::how to install: https://wiki.coreelec.org/coreelec:bpim2pro

===Armbian===
:Armbian unstable legacy and current build for Bananapi M5 and M2Pro
::Google Drive: https://drive.google.com/drive/folders/1Cx_DA90Tbr8_M_8eQd-NwFUOp3UTwhYt
::Baidu Cloud : https://pan.baidu.com/s/15y4LNg4K-w0vrwMTcg5VGQ Pincode: j9aj

===Volumio===
:Download:
::Google drive: https://drive.google.com/drive/folders/1B7nsy4Jxt2lBgXoA6XEnaamEQvZyHI8f
::Baidu cloud : https://pan.baidu.com/s/1mj9OC8P2VSI5GAMnIKGBqA PinCode: mrrb
:User Guide: https://cdn.volumio.org/wp-content/uploads/2019/01/Quick-Start-Guide-Volumio.pdf
:Source code: https://github.com/Dangku/volumio-build
:Platform prebuild package: https://github.com/Dangku/volumio-platform-bananapi
:Development guilde: https://volumio.github.io/docs/User_Manual/Quick_Start_Guide.html

===Odroid Android image===
*Base on Odroid android source code and build for bananapi m5/m2pro
:Download:
::Google Drive: https://drive.google.com/drive/folders/1u_CddlHvpAMu2VZJfIfUKTsFFyigCWig
:Install Guide: https://forum.odroid.com/viewtopic.php?f=204&t=38579

*Odroid ubuntu IMG for BPI-M5：
::https://forum.banana-pi.org/t/odroid-ubuntu-img-for-bpi-m5/12169

===Ubuntu Core 20===
:Ubuntu Core 20 demo image for bananapi m5/m2pro.
:Download:
::Google drive: https://drive.google.com/drive/folders/1TdAQ-HdggKrOPmWi0chpHDJY0SMWlUaC
::Baidu cloud :
:Install Guide: https://ubuntu.com/core/docs/uc20/install

===Archlinux===
*Archlinux xfce and minimal demo image, kernel 4.9, image build refer to [https://archdroid.org/ Archdroid]
:login: alarm/alarm, or root/root
:Download:
::Google drive:https://drive.google.com/drive/folders/1rSSNgbseY2mwTMIauGR1yrXN8RPKzuk6
::Baidu link : https://pan.baidu.com/s/1Ck_H51jPUyAv98o73I8oAw Pincode: rbv2
::discuss on forum : https://forum.banana-pi.org/t/bpi-m5-bpi-m2-pro-new-image-archlinux-2021-9-14/12595

===HuaWei OpenEuler===
*OpenEuler demo image, bpi kernel 4.9
:Download:
::Baidu link ：https://pan.baidu.com/s/12b7q3y-m3YRyD7GwhKE0QA Pincode：lv50
:SIG gitee link : https://gitee.com/openeuler/raspberrypi
:Discuss on fourm : http://forum.banana-pi.org/

===Manjaro for BPI-M5===

Manjaro porting for BPI-M5 from Official Image for Odroid C4, the ported image use kernel 5.10. If anyone is interested on give it a try, the download link is below.
*Download Link: https://mega.nz/folder/BuZWkLhC#phC9KSsassB4bmkAegYykA
*discuss on forum : https://forum.banana-pi.org/t/manjaro-for-bpi-m5/12726

=Easy to buy=

*[https://pt.aliexpress.com/item/1005001871842695.html?spm=a2g0o.productlist.0.0.59976fff0GL35q&algo_pvid=24dfc96b-f6c1-4850-9ff4-fd177ee36648&algo_expid=24dfc96b-f6c1-4850-9ff4-fd177ee36648-0&btsid=0bb47a2216147586025791703e886c&ws_ab_test=searchweb0_0,searchweb201602_,searchweb201603_ buy it form aliexpress ]

*easy to buy RTL8822 wifi module sample : https://www.aliexpress.com/item/1005002550783568.html?spm=5261.ProductManageOnline.0.0.34ed4edfgdV59j

* Mass order,please contact : judyhuang@banana-pi.com

BPI-Leaf-S3 开发板

2022-09-27T08:11:51Z

Qubot: /* 硬件尺寸 */

[[en:BPI-Leaf-S3]]

= 介绍 =
[[File:BPI-Leaf-S3_banner.jpg]]

[[File:Leaf-S3-incline-front.jpg|thumb|[[BPI-Leaf-S3]] with ESP32-S3]]

[[File:Leaf-S3-incline-back.jpg|thumb|[[BPI-Leaf-S3]] with ESP32-S3]]

[[File:Smart-01-03.gif|thumb|[[BPI-Smart ]]with ESP8266]]
[[File:Webduino_gif.gif|thumb|[[BPI-Bit]] with ESP32]]
[[File:BPI-AI_1.JPG|thumb|[[BPI-AI]] Kendryte K210 RISC-V]]
[[File:ESP32_6.JPG|thumb|[[BPI-UNO32]] with ESP32 design]]

香蕉派Leaf系列是专为物联网设计的低功耗微控制器开发板。

BPI-Leaf-S3板载ESP32-S3芯片，支持 2.4 GHz Wi-Fi 和低功耗蓝牙 (Bluetooth® LE) 双模无线通信，外围兼容低功耗硬件设计，深度睡眠模式下功耗仅为10uA。

支持USB和外接3.7V锂电池两种供电方式，可实现双电源下自动切换电源功能，并支持USB充电方式。体积小巧，接口方便，上手简单，可直接应用于物联网低功耗项目。

BPI-Leaf-S3开发板在软件方面支持ESP-IDF、Arduino、MicroPython等多种方式进行编程开发。

BPI-Leaf-S3开发板上标记了与芯片对应的所有IO管脚，且IO管脚顺序与Espressif ESP32-S3-DevKitC-1开发板一致，开发者可根据实际需求，可将DevKitC-1支持的外围设备添加到BPI-Leaf-S3上，也可将开发板插在面包板上使用。

== 关键特性 ==

* ESP32-S3，Xtensa® 32 bit LX7
* 片外 PSRAM , FLASH
* Ultra-low power 10uA
* 2.4G WIFI ，Bluetooth 5 ，Bluetooth mesh
* GPIO , ADC , TOUCH , PWM , I2C , SPI , RMT , I2S , UART , LCD，CAMERA ，USB , JTAG
* 1* JST SH 1mm 4-Pin I2C连接座
* 1 * USB Type-C
* 1 * 2pin 电池连接座，支持充电
* 1 * 全彩色LED

== BPI-Leaf-S3 与 ESP32-S3-DevKitC-1开发板对比 ==

{| class="wikitable"
|- style="font-weight:bold;"
! 开发板
! BPI-Leaf-S3
! ESP32-S3-DevKitC-1
|-
| 引出GPIO
| 36
| 36
|-
| 3.3v管脚
| 2
| 2
|-
| 5v管脚
| 1
| 1
|-
| GND管脚
| 4
| 4
|-
| 全彩LED灯
| 1 on GPIO48
| 1 on GPIO48
|-
| 芯片直连USB
| Type-C USB接口x1
| MicroUSB接口x1
|-
| UART TTL转USB
| 无
| CP2102-MicroUSB接口x1
|-
| 外接电池连接座
| 3.7v锂电池供电接口
| 无
|-
| 电池充电
| 500mA充电
| 无
|-
| I²C JST SH 1mm 4-Pin连接座
| 1
| 无
|}

BPI-Leaf-S3开发板IO管脚数量，顺序，间距都与Espressif ESP32-S3-DevKitC-1开发板一致。

BPI-Leaf-S3开发板不再具备传统的UART TTL转USB转接芯片及其USB接口，这是因为ESP32-S3芯片的内置USB功能已经足够完善，支持CDC-ACM 虚拟串口及 JTAG 适配器功能，不再需要外部的转接芯片就可以实现软件开发调试，固件下载等功能。

相较于ESP32-S3-DevKitC-1开发板，BPI-Leaf-S3开发板增加了外接电池连接座并搭配了充电电路，可直接通过USB给电池充电，且可实现自动切换供电，即在有接3.7v锂电池的条件下，插拔USB不会导致程序中断，适应更多应用场景。

BPI-Leaf-S3开发板上还增加了一个I²C 4pin连接座，使开发板连接一些I²C设备更加便捷稳固。其实此接口并不局限于连接I²C设备，所有可以通过一根3.3v线，一根GND线，一或两根信号线控制的设备都可以通过此4pin连接座与开发板建立通信。

== Espressif ESP32-S3 ==

ESP32-S3 是一款集成 2.4 GHz Wi-Fi 和 Bluetooth 5 (LE) 的 MCU 芯片，支持远距离模式 (Long Range)。ESP32-S3 搭载 Xtensa® 32 位 LX7 双核处理器，主频高达 240 MHz，内置 512 KB SRAM (TCM)，具有 45 个可编程 GPIO 管脚和丰富的通信接口。ESP32-S3 支持更大容量的高速 Octal SPI flash 和片外 RAM，支持用户配置数据缓存与指令缓存。

以下是ESP32-S3芯片重要功能的描述。

* '''支持Wi-Fi + Bluetooth 5 (LE) 无线连接''': ESP32-S3 集成 2.4 GHz Wi-Fi (802.11 b/g/n)，支持 40 MHz 带宽；其低功耗蓝牙子系统支持 Bluetooth 5 (LE) 和 Bluetooth Mesh，可通过 Coded PHY 与广播扩展实现远距离通信。它还支持 2 Mbps PHY，用于提高传输速度和数据吞吐量。ESP32-S3 的 Wi-Fi 和 Bluetooth LE 射频性能优越，在高温下也能稳定工作。

* '''支持 AI 加速''': ESP32-S3 MCU 增加了用于加速神经网络计算和信号处理等工作的向量指令 (vector instructions)。AI 开发者们通过 ESP-DSP 和 ESP-NN 库使用这些向量指令，可以实现高性能的图像识别、语音唤醒和识别等应用。

* '''丰富的 IO 接口''': ESP32-S3 拥有 45 个可编程 GPIO 以及 SPI、I2S、I2C、PWM、RMT、ADC、UART、SD/MMC 主机控制器和 TWAITM 控制器等常用外设接口。其中的 14 个 GPIO 可被配置为 HMI 交互的电容触摸输入端。此外，ESP32-S3 搭载了超低功耗协处理器 (ULP)，支持多种低功耗模式，广泛适用于各类低功耗应用场景。

* '''完善的安全机制''': ESP32-S3 为物联网设备提供了完善的安全机制和保护措施，防止各类恶意攻击和威胁。它支持基于 AES-XTS 算法的 flash 加密、基于 RSA 算法的安全启动、数字签名和 HMAC。ESP32-S3 还新增了一个“世界控制器 (World Controller)”模块，提供了两个互不干扰的执行环境，实现可信执行环境或权限分离机制。

= 硬件 =

== 硬件接口示意图 ==

[[File:Leaf-S3_board.png|800px]]

== 硬件规格 ==

{| class="wikitable"
|-
! colspan="2" style="background-color:#ffcb2f;" | BPI-Leaf-S3 规格表
|-
| SoC主控芯片
| ESP32-S3，Xtensa® 32 位 LX7 双核处理器
|-
| 主频
| 240MHz MAX
|-
| 工作温度
| -40℃~+85℃
|-
| 片上 ROM
| 384 KB
|-
| 片上 SRAM
| 320 KB
|-
| 板载 FLASH ROM
| 4MB
|-
| 片上外设PSRAM
| 2MB
|-
| WIFI
| IEEE 802.11 b/g/n ，2.4Ghz频带，150Mbps
|-
| 蓝牙
| Bluetooth 5 ，Bluetooth mesh
|-
| GPIO
| BPI-Leaf-S3已引出36个可用GPIO
|-
| ADC
| 2 × 12 位 SAR ADC，支持 20 个模拟通道输入
|-
| TOUCH 电容式触摸传感器
| 14
|-
| SPI
| 4
|-
| I2C
| 2，支持主机或从机模式
|-
| I2S
| 2，串行立体声数据的输入输出
|-
| LCD
| 1，支持 8 位 ~16 位并行 RGB、I8080、MOTO6800 接口
|-
| CAMERA
| 1，支持 8 位 ~16 位 DVP 图像传感器接口
|-
| UART
| 3 ，支持异步通信（RS232 和RS485）和 IrDA
|-
| PWM
| 8 路独立通道，14位精度
|-
| MCPWM
| 2
|-
| USB
| 1 × 全速USB 2.0 OTG，Type-C母口
|-
| USB Serial/JTAG 控制器
| 1，USB 全速标准，CDC-ACM ，JTAG
|-
| 温度传感器
| 1，测量范围为–20 °C 到 110 °C，用于监测芯片内部温度
|-
| SD/MMC
| 1 × SDIO主机接口，具有2个卡槽，支持SD卡3.0和3.01，SDIO 3.0，CE-ATA 1.1，MMC 4.41，eMMC 4.5和4.51
|-
| TWAI® 控制器
| 1 ，兼容 ISO11898-1（CAN 规范 2.0）
|-
| 通用 DMA 控制器
| 5 个接收通道和 5 个发送通道
|-
| RMT
| 4 通道发射，4通道接收，共享 384 x 32-bit 的 RAM
|-
| 脉冲计数器
| 4个脉冲计数控制器（单元），每个单元有2个独立的通道
|-
| 定时器
| 4 × 54 位通用定时器，16 位时钟预分频器，1 × 52 位系统定时器，3 × 看门狗定时器
|-
| 外部晶振
| 40Mhz
|-
| RTC 和低功耗管理
| 电源管理单元 (PMU)+ 超低功耗协处理器 (ULP)
|-
| 低功耗电流
| 10uA
|-
| 工作电压
| 3.3V
|-
| 输入电压
| 3.3V~5.5V
|-
| 最大放电电流
| 2A@3.3V DC/DC
|-
| USB充电
| 支持
|-
| 最大充电电流
| 500mA
|-
| 可控全彩色LED
| 1
|}

== 硬件尺寸 ==

[[File:Leaf-S3_board_dimension.png | 700px]]

{| class="wikitable"
|-
! colspan="2" style=" background-color:#ffcb2f;" | BPI-Leaf-S3 尺寸表
|-
| 管脚间距
| 2.54mm
|-
| 安装孔间距
| 23mm/ 62.25mm
|-
| 安装孔尺寸
| 内径2mm/外径3mm
|-
| 主板尺寸
| 26 × 65.25(mm)/1.02 x 2.57(inches)
|-
|}

管脚间距兼容万能板（洞洞板、点阵板），面包板，便于调试应用。

== 外设GPIO管脚分配 ==

{| class="wikitable"
|-
! colspan="3" style=" background-color:#ffcb2f;" | BPI-Leaf-S3 外设GPIO管脚分配
|- style="background-color:#32cb00;"
| 外设接口
| 信号
| 管脚
|-
| rowspan="2" | ADC
| ADC1_CH0~9
| GPIO 1~10
|-
| ADC2_CH0~9
| GPIO 11~20
|-
| 触摸传感器
| TOUCH1~14
| GPIO 1~14
|-
| rowspan="4"|JTAG
| MTCK
| GPIO 39
|-
| MTDO
| GPIO 40
|-
| MTDI
| GPIO 41
|-
| MTMS
| GPIO 42
|-
| rowspan="14" | UART
| colspan="2" style="font-style:italic;color:#9b9b9b;" | 默认分配管脚，可重定义为任意GPIO
|-
| style="background-color:#ffffc7;" | U0RXD_in
| style="background-color:#ffffc7;" | GPIO 44
|-
| U0CTS_in
| GPIO 16
|-
| U0DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U0TXD_out
| style="background-color:#ffffc7;" | GPIO43
|-
| U0RTS_out
| GPIO 15
|-
| U0DTR_out
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1RXD_in
| style="background-color:#ffffc7;" | GPIO 18
|-
| U1CTS_in
| GPIO 20
|-
| U1DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1TXD_out
| style="background-color:#ffffc7;" | GPIO 17
|-
| U1RTS_out
| GPIO 19
|-
| U1DTR_out
| 任意GPIO
|-
| style="background-color:#9aff99;" | U2
| style="background-color:#9aff99;" | 任意GPIO
|-
| I2C
| colspan="2" | 任意GPIO
|-
| PWM
| colspan="2" | 任意GPIO
|-
| I2S
| colspan="2" | 任意GPIO
|-
| LCD
| colspan="2" | 任意GPIO
|-
| CAMERA
| colspan="2" | 任意GPIO
|-
| RMT
| colspan="2" | 任意GPIO
|-
| SPI0/1
| colspan="2" | 已用于FLASH与PSRAM
|-
| SPI2/3
| colspan="2" | 任意GPIO
|-
| 脉冲计数器
| colspan="2" | 任意GPIO
|-
| rowspan="8" | USB OTG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| RCV
| GPIO21（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| rowspan="7" | USB Serial/JTAG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| SD/MMC
| colspan="2" | 任意GPIO
|-
| MCPWM
| colspan="2" | 任意GPIO
|-
| TWAI
| colspan="2" | 任意GPIO
|-
| 彩色LED
| colspan="2" | GPIO 48
|}

= 软件 =

== ESP-IDF ==

[[File:Esp-idf-logo.png | 800px]]

ESP-IDF 是乐鑫官方推出的物联网开发框架，支持 Windows、Linux 和 macOS 操作系统。

建议开发者通过集成开发环境 (IDE) 安装 ESP-IDF:

* [https://github.com/espressif/idf-eclipse-plugin/blob/master/README_CN.md GitHub: ESP-IDF Eclipse 插件安装与使用指南]
* [https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension ESP-IDF VSCode 插件] | [https://github.com/espressif/vscode-esp-idf-extension/blob/master/docs/tutorial/toc.md GitHub: 安装与使用指南] | [https://www.bilibili.com/video/BV17p4y167uN bilibili：ESP-IDF VSCode 插件快速操作指南]

或者根据操作系统选择对应的手动安装流程:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/windows-setup.html Windows 平台工具链的标准设置]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/linux-macos-setup.html Linux 和 macOS 平台工具链的标准设置]

API:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/index.html#api API 参考]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-guides/index.html#api API 指南]

为了使你的BPI-Leaf-S3开发板可以通过USB-CDC刷写FLASH，需要设置开发板为固件下载模式。

有两种操作方法：

1.通过USB连接到电脑，按住BOOT键，再按一下RESET键并松开，最后松开BOOT键。

2.在断开供电的条件下按住BOOT键，再通过USB连接到电脑，最后松开BOOT键。

需要在设备管理器中确认接口，固件下载模式与普通模式下的接口序号可能是不一样的。

== MicroPython ==

[[File:Mircopython.png | 800px]]

MicroPython实现了大部分Python 3 特性和语法，易学易上手，验证程序效果无需编译直接下载进芯片运行。

无论是否有编程基础，MicroPython的上手难度绝对远低于其他编程语言，其代码易读性高，且开源社区有多年积累的丰富资源，就如同Python一样拥有极强的生命力与应用价值。

* '''[https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/tree/main/Example/MicroPython-zh#1%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B GitHub: MicroPython快速上手]'''

* [[ micropython_运行环境搭建 | MicroPython运行环境搭建(Thonny IDE) ]]

* [[ micropython_固件下载与烧录 | MicroPython固件下载与烧录 ]]

== CircuitPython ==

[[File:CircuitPython_Repo_header_logo.jpg | 800px]]

[https://circuitpython.org/board/bpi_leaf_s3/ BPI-Leaf-S3 CircuitPython Download 页面]

== Arduino ==

[[File:Arduino_logo_1200x350.png | 800px]]

Arduino 是一个开源嵌入式软硬件开发平台，用来供用户制作可交互式的嵌入式项目。

* [https://www.arduino.cc/en/software Arduino IDE 下载地址] | [https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html#installing 安装并配置Arduino-ESP32运行环境]
* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/Example/Arduino GitHub: BPI-Leaf-S3 Arduino快速上手]
* [https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html#apis Arduino-ESP32 APIs]

= 资料与资源 =

* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/sch/BPI-Leaf-S3-Chip-V0.1A.pdf GitHub: BPI-Leaf-S3 开发板原理图PDF]

* [https://www.espressif.com/sites/default/files/documentation/esp32-s3_datasheet_cn.pdf ESP32-S3 技术规格书]

* [https://www.espressif.com/sites/default/files/documentation/esp32-s3_technical_reference_manual_cn.pdf ESP32-S3 技术参考手册]

=样品购买=

* 官方速卖通: https://www.aliexpress.com/item/1005004428945296.html?spm=5261.ProductManageOnline.0.0.48af4edfYbyEoI
* 官方淘宝: https://item.taobao.com/item.htm?spm=a2126o.success.0.0.29034831FGnLQW&id=677287234553
* OEM&OEM 定制服务： sales@banana-pi.com

BPI-PicoW-S3 开发板

2022-09-27T08:11:22Z

Qubot: /* 硬件尺寸 */

[[en:BPI-PicoW-S3]]

= 介绍 =
[[File:BPI-PicoW-S3 banner.png|800px]]

[[File:PICO-1000-7.jpg|thumb|[[BPI-PicoW-S3_开发板 ]]with ESP32-S3]]
[[File:PICO-1000-5.png|thumb|[[BPI-PicoW-S3_开发板 ]]with ESP32-S3]]
[[File:Smart-01-03.gif|thumb|[[BPI-Smart ]]with ESP8266]]
[[File:Webduino_gif.gif|thumb|[[BPI-Bit]] with ESP32]]
[[File:BPI-AI_1.JPG|thumb|[[BPI-AI]] Kendryte K210 RISC-V]]
[[File:ESP32_6.JPG|thumb|[[BPI-UNO32]] with ESP32 design]]

Banana Pi BPI-PicoW-S3 是一系列低功耗微控制器，专为物联网开发和Maker DIY设计的开发板。与 Raspberry Pi Pico 板尺寸相同，支持 2.4 GHz Wi-Fi 和 Bluetooth® LE 双模无线通信，外设兼容低功耗硬件设计，深度睡眠模式下功耗仅为10uA。编程方面，PicoW-S3支持ESP-IDF、Arduino、micropython、CircuitPython 等多种方式

== 关键特性 ==

* ESP32-S3，Xtensa® 32 bit LX7
* 片外 PSRAM , FLASH
* Ultra-low power 10uA
* 2.4G WIFI ，Bluetooth 5 ，Bluetooth mesh
* GPIO , ADC , TOUCH , PWM , I2C , SPI , RMT , I2S , UART , LCD，CAMERA ，USB , JTAG
* 1 * microUSB
* 1 * 全彩色LED

== BPI-PicoW-S3 与 Rraspberry Pi PicoW、BPI-Leaf-S3、ESP32-S3-DevKitC-1 开发板对比 ==

{| class="wikitable"
|- style="font-weight:bold;"
! 开发板
! BPI-PicoW-S3
! Rraspberry Pi PicoW
! BPI-Leaf-S3
! ESP32-S3-DevKitC-1
|-
| 引出GPIO
| 27
| 27
| 36
| 36
|-
| 3.3v管脚
| 1
| 1
| 2
| 2
|-
| 5v管脚
| 2
| 2
| 1
| 1
|-
| GND管脚
| 8
| 8
| 4
| 4
|-
| 全彩LED灯
| 1 on GPIO48
| 无
| 1 on GPIO48
| 1 on GPIO48
|-
| 芯片直连USB
| MicroUSB接口x1
| MicroUSB接口x1
| Type-C USB接口x1
| MicroUSB接口x1
|-
| UART TTL转USB
| 无
| 无
| 无
| CP2102-MicroUSB接口x1
|-
| 外接电池连接座
| 无
| 无
| 3.7v锂电池供电接口
| 无
|-
| 电池充电
| 无
| 无
| 500mA充电
| 无
|-
| I²C 4pin连接座
| 无
| 无
| 1
| 无
|}

== Espressif ESP32-S3 ==

ESP32-S3 是一款集成 2.4 GHz Wi-Fi 和 Bluetooth 5 (LE) 的 MCU 芯片，支持远距离模式 (Long Range)。ESP32-S3 搭载 Xtensa® 32 位 LX7 双核处理器，主频高达 240 MHz，内置 512 KB SRAM (TCM)，具有 45 个可编程 GPIO 管脚和丰富的通信接口。ESP32-S3 支持更大容量的高速 Octal SPI flash 和片外 RAM，支持用户配置数据缓存与指令缓存。

以下是ESP32-S3芯片重要功能的描述。

* '''支持Wi-Fi + Bluetooth 5 (LE) 无线连接''': ESP32-S3 集成 2.4 GHz Wi-Fi (802.11 b/g/n)，支持 40 MHz 带宽；其低功耗蓝牙子系统支持 Bluetooth 5 (LE) 和 Bluetooth Mesh，可通过 Coded PHY 与广播扩展实现远距离通信。它还支持 2 Mbps PHY，用于提高传输速度和数据吞吐量。ESP32-S3 的 Wi-Fi 和 Bluetooth LE 射频性能优越，在高温下也能稳定工作。

* '''支持 AI 加速''': ESP32-S3 MCU 增加了用于加速神经网络计算和信号处理等工作的向量指令 (vector instructions)。AI 开发者们通过 ESP-DSP 和 ESP-NN 库使用这些向量指令，可以实现高性能的图像识别、语音唤醒和识别等应用。

* '''丰富的 IO 接口''': ESP32-S3 拥有 45 个可编程 GPIO 以及 SPI、I2S、I2C、PWM、RMT、ADC、UART、SD/MMC 主机控制器和 TWAITM 控制器等常用外设接口。其中的 14 个 GPIO 可被配置为 HMI 交互的电容触摸输入端。此外，ESP32-S3 搭载了超低功耗协处理器 (ULP)，支持多种低功耗模式，广泛适用于各类低功耗应用场景。

* '''完善的安全机制''': ESP32-S3 为物联网设备提供了完善的安全机制和保护措施，防止各类恶意攻击和威胁。它支持基于 AES-XTS 算法的 flash 加密、基于 RSA 算法的安全启动、数字签名和 HMAC。ESP32-S3 还新增了一个“世界控制器 (World Controller)”模块，提供了两个互不干扰的执行环境，实现可信执行环境或权限分离机制。

= 硬件 =

== 硬件接口示意图 ==

[[File:BPI-PicoW-S3-V0.4-IO.png|800px]]

== 硬件规格 ==

{| class="wikitable"
|-
! colspan="2" style="background-color:#ffcb2f;" | BPI-PicoW-S3 规格表
|-
| SoC主控芯片
| ESP32-S3，Xtensa® 32 位 LX7 双核处理器
|-
| 主频
| 240MHz MAX
|-
| 工作温度
| -40℃~+85℃
|-
| 片上 ROM
| 384 KB
|-
| 片上 SRAM
| 320 KB
|-
| 板载 FLASH ROM
| 2MB
|-
| 片上外设PSRAM
| 8MB
|-
| WIFI
| IEEE 802.11 b/g/n ，2.4Ghz频带，150Mbps
|-
| 蓝牙
| Bluetooth 5 ，Bluetooth mesh
|-
| GPIO
| BPI-PicoW-S3已引出27个可用GPIO
|-
| ADC
| 2 × 12 位 SAR ADC，支持 18 个模拟通道输入
|-
| TOUCH 电容式触摸传感器
| 14
|-
| SPI
| 4
|-
| I2C
| 2，支持主机或从机模式
|-
| I2S
| 2，串行立体声数据的输入输出
|-
| LCD
| 1，支持 8 位 ~16 位并行 RGB、I8080、MOTO6800 接口
|-
| CAMERA
| 1，支持 8 位 ~16 位 DVP 图像传感器接口
|-
| UART
| 3 ，支持异步通信（RS232 和RS485）和 IrDA
|-
| PWM
| 8 路独立通道，14位精度
|-
| MCPWM
| 2
|-
| USB
| 1 × 全速USB 2.0 OTG，MicroUSB母口
|-
| USB Serial/JTAG 控制器
| 1，USB 全速标准，CDC-ACM ，JTAG
|-
| 温度传感器
| 1，测量范围为–20 °C 到 110 °C，用于监测芯片内部温度
|-
| SD/MMC
| 1 × SDIO主机接口，具有2个卡槽，支持SD卡3.0和3.01，SDIO 3.0，CE-ATA 1.1，MMC 4.41，eMMC 4.5和4.51
|-
| TWAI® 控制器
| 1 ，兼容 ISO11898-1（CAN 规范 2.0）
|-
| 通用 DMA 控制器
| 5 个接收通道和 5 个发送通道
|-
| RMT
| 4 通道发射，4通道接收，共享 384 x 32-bit 的 RAM
|-
| 脉冲计数器
| 4个脉冲计数控制器（单元），每个单元有2个独立的通道
|-
| 定时器
| 4 × 54 位通用定时器，16 位时钟预分频器，1 × 52 位系统定时器，3 × 看门狗定时器
|-
| 外部晶振
| 40Mhz
|-
| RTC 和低功耗管理
| 电源管理单元 (PMU)+ 超低功耗协处理器 (ULP)
|-
| 低功耗电流
| 10uA
|-
| 工作电压
| 3.3V
|-
| 输入电压
| 3.3V~5.5V
|-
| 最大放电电流
| 2A@3.3V DC/DC
|-
| 可控全彩色LED
| 1
|}

== 硬件尺寸 ==

[[File:BPI-Pico-S3-board-dimension.png|800px]]

{| class="wikitable"
|-
! colspan="2" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 尺寸表
|-
| 管脚间距
| 2.54mm
|-
| 安装孔间距
| 11.4mm/ 47mm
|-
| 安装孔尺寸
| 内径2.1mm/外径3.4mm
|-
| 主板尺寸
| 21 × 51.88(mm)/0.83 x 2.04(inches)
|-
|}

管脚间距兼容万能板（洞洞板、点阵板），面包板，便于调试应用。

== 外设GPIO管脚分配 ==

{| class="wikitable"
|-
! colspan="3" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 外设GPIO管脚分配
|- style="background-color:#32cb00;"
| 外设接口
| 信号
| 管脚
|-
| rowspan="2" | ADC
| ADC1_CH0~9
| GPIO 1~10
|-
| ADC2_CH0~9
| GPIO 11~20
|-
| 触摸传感器
| TOUCH1~14
| GPIO 1~14
|-
| rowspan="4"|JTAG
| MTCK
| GPIO 39
|-
| MTDO
| GPIO 40
|-
| MTDI
| GPIO 41
|-
| MTMS
| GPIO 42
|-
| rowspan="14" | UART
| colspan="2" style="font-style:italic;color:#9b9b9b;" | 默认分配管脚，可重定义为任意GPIO
|-
| style="background-color:#ffffc7;" | U0RXD_in
| style="background-color:#ffffc7;" | GPIO 44
|-
| U0CTS_in
| GPIO 16
|-
| U0DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U0TXD_out
| style="background-color:#ffffc7;" | GPIO43
|-
| U0RTS_out
| GPIO 15
|-
| U0DTR_out
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1RXD_in
| style="background-color:#ffffc7;" | GPIO 18
|-
| U1CTS_in
| GPIO 20
|-
| U1DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1TXD_out
| style="background-color:#ffffc7;" | GPIO 17
|-
| U1RTS_out
| GPIO 19
|-
| U1DTR_out
| 任意GPIO
|-
| style="background-color:#9aff99;" | U2
| style="background-color:#9aff99;" | 任意GPIO
|-
| I2C
| colspan="2" | 任意GPIO
|-
| PWM
| colspan="2" | 任意GPIO
|-
| I2S
| colspan="2" | 任意GPIO
|-
| LCD
| colspan="2" | 任意GPIO
|-
| CAMERA
| colspan="2" | 任意GPIO
|-
| RMT
| colspan="2" | 任意GPIO
|-
| SPI0/1
| colspan="2" | 已用于FLASH与PSRAM
|-
| SPI2/3
| colspan="2" | 任意GPIO
|-
| 脉冲计数器
| colspan="2" | 任意GPIO
|-
| rowspan="8" | USB OTG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| RCV
| GPIO21（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| rowspan="7" | USB Serial/JTAG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| SD/MMC
| colspan="2" | 任意GPIO
|-
| MCPWM
| colspan="2" | 任意GPIO
|-
| TWAI
| colspan="2" | 任意GPIO
|-
| 彩色LED
| colspan="2" | GPIO 48
|}

= 软件 =

== ESP-IDF ==

[[File:Esp-idf-logo.png | 800px]]

ESP-IDF 是乐鑫官方推出的物联网开发框架，支持 Windows、Linux 和 macOS 操作系统。

建议开发者通过集成开发环境 (IDE) 安装 ESP-IDF:

* [https://github.com/espressif/idf-eclipse-plugin/blob/master/README_CN.md GitHub: ESP-IDF Eclipse 插件安装与使用指南]
* [https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension ESP-IDF VSCode 插件] | [https://github.com/espressif/vscode-esp-idf-extension/blob/master/docs/tutorial/toc.md GitHub: 安装与使用指南] | [https://www.bilibili.com/video/BV17p4y167uN bilibili：ESP-IDF VSCode 插件快速操作指南]

或者根据操作系统选择对应的手动安装流程:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/windows-setup.html Windows 平台工具链的标准设置]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/linux-macos-setup.html Linux 和 macOS 平台工具链的标准设置]

API:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/index.html#api API 参考]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-guides/index.html#api API 指南]

为了使你的BPI-Leaf-S3开发板可以通过USB-CDC刷写FLASH，需要设置开发板为固件下载模式。

有两种操作方法：

1.通过USB连接到电脑，按住BOOT键，再按一下RESET键并松开，最后松开BOOT键。

2.在断开供电的条件下按住BOOT键，再通过USB连接到电脑，最后松开BOOT键。

需要在设备管理器中确认接口，固件下载模式与普通模式下的接口序号可能是不一样的。

== MicroPython ==

[[File:Mircopython.png | 800px]]

MicroPython实现了大部分Python 3 特性和语法，易学易上手，验证程序效果无需编译直接下载进芯片运行。

无论是否有编程基础，MicroPython的上手难度绝对远低于其他编程语言，其代码易读性高，且开源社区有多年积累的丰富资源，就如同Python一样拥有极强的生命力与应用价值。

* '''[https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/tree/main/Example/MicroPython-zh#1%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B GitHub: MicroPython快速上手]'''

* [[ micropython_运行环境搭建 | MicroPython运行环境搭建(Thonny IDE) ]]

* [[ micropython_固件下载与烧录 | MicroPython固件下载与烧录 ]]

== Arduino ==

[[File:Arduino_logo_1200x350.png | 800px]]

Arduino 是一个开源嵌入式软硬件开发平台，用来供用户制作可交互式的嵌入式项目。

* [https://www.arduino.cc/en/software Arduino IDE 下载地址] | [https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html#installing 安装并配置Arduino-ESP32运行环境]
* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/Example/Arduino GitHub: BPI-Leaf-S3 Arduino快速上手]
* [https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html#apis Arduino-ESP32 APIs]

= 资料与资源 =

=样品购买=

* 比派科技官方速卖通店:https://www.aliexpress.com/item/1005004775634442.html?spm=5261.ProductManageOnline.0.0.15744edfAyCaNk
* SinoVoip 官方速卖通店 : https://pt.aliexpress.com/item/1005004775859077.html?spm=5261.ProductManageOnline.0.0.785f4edfxIkaFg&gatewayAdapt=glo2bra
* 官方淘宝店: https://item.taobao.com/item.htm?spm=a2126o.success.0.0.25b04831CHV1Nc&id=684134360199
* OEM&OEM 定制服务: sales@banana-pi.com

BPI-PicoW-S3 开发板

2022-09-22T07:05:22Z

Qubot: /* 介绍 */

[[en:BPI-PicoW-S3]]

= 介绍 =
[[File:BPI-PicoW-S3 banner.png|800px]]

[[File:PICO-1000-7.jpg|thumb|[[BPI-PicoW-S3_开发板 ]]with ESP32-S3]]
[[File:PICO-1000-5.png|thumb|[[BPI-PicoW-S3_开发板 ]]with ESP32-S3]]
[[File:Smart-01-03.gif|thumb|[[BPI-Smart ]]with ESP8266]]
[[File:Webduino_gif.gif|thumb|[[BPI-Bit]] with ESP32]]
[[File:BPI-AI_1.JPG|thumb|[[BPI-AI]] Kendryte K210 RISC-V]]
[[File:ESP32_6.JPG|thumb|[[BPI-UNO32]] with ESP32 design]]

Banana Pi BPI-PicoW-S3 是一系列低功耗微控制器，专为物联网开发和Maker DIY设计的开发板。与 Raspberry Pi Pico 板尺寸相同，支持 2.4 GHz Wi-Fi 和 Bluetooth® LE 双模无线通信，外设兼容低功耗硬件设计，深度睡眠模式下功耗仅为10uA。编程方面，PicoW-S3支持ESP-IDF、Arduino、micropython、CircuitPython 等多种方式

== 关键特性 ==

* ESP32-S3，Xtensa® 32 bit LX7
* 片外 PSRAM , FLASH
* Ultra-low power 10uA
* 2.4G WIFI ，Bluetooth 5 ，Bluetooth mesh
* GPIO , ADC , TOUCH , PWM , I2C , SPI , RMT , I2S , UART , LCD，CAMERA ，USB , JTAG
* 1 * microUSB
* 1 * 全彩色LED

== BPI-PicoW-S3 与 Rraspberry Pi PicoW、BPI-Leaf-S3、ESP32-S3-DevKitC-1 开发板对比 ==

{| class="wikitable"
|- style="font-weight:bold;"
! 开发板
! BPI-PicoW-S3
! Rraspberry Pi PicoW
! BPI-Leaf-S3
! ESP32-S3-DevKitC-1
|-
| 引出GPIO
| 27
| 27
| 36
| 36
|-
| 3.3v管脚
| 1
| 1
| 2
| 2
|-
| 5v管脚
| 2
| 2
| 1
| 1
|-
| GND管脚
| 8
| 8
| 4
| 4
|-
| 全彩LED灯
| 1 on GPIO48
| 无
| 1 on GPIO48
| 1 on GPIO48
|-
| 芯片直连USB
| MicroUSB接口x1
| MicroUSB接口x1
| Type-C USB接口x1
| MicroUSB接口x1
|-
| UART TTL转USB
| 无
| 无
| 无
| CP2102-MicroUSB接口x1
|-
| 外接电池连接座
| 无
| 无
| 3.7v锂电池供电接口
| 无
|-
| 电池充电
| 无
| 无
| 500mA充电
| 无
|-
| I²C 4pin连接座
| 无
| 无
| 1
| 无
|}

== Espressif ESP32-S3 ==

ESP32-S3 是一款集成 2.4 GHz Wi-Fi 和 Bluetooth 5 (LE) 的 MCU 芯片，支持远距离模式 (Long Range)。ESP32-S3 搭载 Xtensa® 32 位 LX7 双核处理器，主频高达 240 MHz，内置 512 KB SRAM (TCM)，具有 45 个可编程 GPIO 管脚和丰富的通信接口。ESP32-S3 支持更大容量的高速 Octal SPI flash 和片外 RAM，支持用户配置数据缓存与指令缓存。

以下是ESP32-S3芯片重要功能的描述。

* '''支持Wi-Fi + Bluetooth 5 (LE) 无线连接''': ESP32-S3 集成 2.4 GHz Wi-Fi (802.11 b/g/n)，支持 40 MHz 带宽；其低功耗蓝牙子系统支持 Bluetooth 5 (LE) 和 Bluetooth Mesh，可通过 Coded PHY 与广播扩展实现远距离通信。它还支持 2 Mbps PHY，用于提高传输速度和数据吞吐量。ESP32-S3 的 Wi-Fi 和 Bluetooth LE 射频性能优越，在高温下也能稳定工作。

* '''支持 AI 加速''': ESP32-S3 MCU 增加了用于加速神经网络计算和信号处理等工作的向量指令 (vector instructions)。AI 开发者们通过 ESP-DSP 和 ESP-NN 库使用这些向量指令，可以实现高性能的图像识别、语音唤醒和识别等应用。

* '''丰富的 IO 接口''': ESP32-S3 拥有 45 个可编程 GPIO 以及 SPI、I2S、I2C、PWM、RMT、ADC、UART、SD/MMC 主机控制器和 TWAITM 控制器等常用外设接口。其中的 14 个 GPIO 可被配置为 HMI 交互的电容触摸输入端。此外，ESP32-S3 搭载了超低功耗协处理器 (ULP)，支持多种低功耗模式，广泛适用于各类低功耗应用场景。

* '''完善的安全机制''': ESP32-S3 为物联网设备提供了完善的安全机制和保护措施，防止各类恶意攻击和威胁。它支持基于 AES-XTS 算法的 flash 加密、基于 RSA 算法的安全启动、数字签名和 HMAC。ESP32-S3 还新增了一个“世界控制器 (World Controller)”模块，提供了两个互不干扰的执行环境，实现可信执行环境或权限分离机制。

= 硬件 =

== 硬件接口示意图 ==

[[File:BPI-PicoW-S3-V0.4-IO.png|800px]]

== 硬件规格 ==

{| class="wikitable"
|-
! colspan="2" style="background-color:#ffcb2f;" | BPI-PicoW-S3 规格表
|-
| SoC主控芯片
| ESP32-S3，Xtensa® 32 位 LX7 双核处理器
|-
| 主频
| 240MHz MAX
|-
| 工作温度
| -40℃~+85℃
|-
| 片上 ROM
| 384 KB
|-
| 片上 SRAM
| 320 KB
|-
| 板载 FLASH ROM
| 2MB
|-
| 片上外设PSRAM
| 8MB
|-
| WIFI
| IEEE 802.11 b/g/n ，2.4Ghz频带，150Mbps
|-
| 蓝牙
| Bluetooth 5 ，Bluetooth mesh
|-
| GPIO
| BPI-PicoW-S3已引出27个可用GPIO
|-
| ADC
| 2 × 12 位 SAR ADC，支持 18 个模拟通道输入
|-
| TOUCH 电容式触摸传感器
| 14
|-
| SPI
| 4
|-
| I2C
| 2，支持主机或从机模式
|-
| I2S
| 2，串行立体声数据的输入输出
|-
| LCD
| 1，支持 8 位 ~16 位并行 RGB、I8080、MOTO6800 接口
|-
| CAMERA
| 1，支持 8 位 ~16 位 DVP 图像传感器接口
|-
| UART
| 3 ，支持异步通信（RS232 和RS485）和 IrDA
|-
| PWM
| 8 路独立通道，14位精度
|-
| MCPWM
| 2
|-
| USB
| 1 × 全速USB 2.0 OTG，MicroUSB母口
|-
| USB Serial/JTAG 控制器
| 1，USB 全速标准，CDC-ACM ，JTAG
|-
| 温度传感器
| 1，测量范围为–20 °C 到 110 °C，用于监测芯片内部温度
|-
| SD/MMC
| 1 × SDIO主机接口，具有2个卡槽，支持SD卡3.0和3.01，SDIO 3.0，CE-ATA 1.1，MMC 4.41，eMMC 4.5和4.51
|-
| TWAI® 控制器
| 1 ，兼容 ISO11898-1（CAN 规范 2.0）
|-
| 通用 DMA 控制器
| 5 个接收通道和 5 个发送通道
|-
| RMT
| 4 通道发射，4通道接收，共享 384 x 32-bit 的 RAM
|-
| 脉冲计数器
| 4个脉冲计数控制器（单元），每个单元有2个独立的通道
|-
| 定时器
| 4 × 54 位通用定时器，16 位时钟预分频器，1 × 52 位系统定时器，3 × 看门狗定时器
|-
| 外部晶振
| 40Mhz
|-
| RTC 和低功耗管理
| 电源管理单元 (PMU)+ 超低功耗协处理器 (ULP)
|-
| 低功耗电流
| 10uA
|-
| 工作电压
| 3.3V
|-
| 输入电压
| 3.3V~5.5V
|-
| 最大放电电流
| 2A@3.3V DC/DC
|-
| 可控全彩色LED
| 1
|}

== 硬件尺寸 ==

[[File:BPI-Pico-S3-board-dimension.png|800px]]

{| class="wikitable"
|-
! colspan="2" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 尺寸表
|-
| 管脚间距
| 2.54mm
|-
| 安装孔间距
| 11.4mm/ 47mm
|-
| 安装孔尺寸
| 内径2.1mm/外径3.4mm
|-
| 主板尺寸
| 21 × 51.88(mm)/0.83 x 2.04(inches)
|-
| 板厚
| 1.2mm
|}

管脚间距兼容万能板（洞洞板、点阵板），面包板，便于调试应用。

== 外设GPIO管脚分配 ==

{| class="wikitable"
|-
! colspan="3" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 外设GPIO管脚分配
|- style="background-color:#32cb00;"
| 外设接口
| 信号
| 管脚
|-
| rowspan="2" | ADC
| ADC1_CH0~9
| GPIO 1~10
|-
| ADC2_CH0~9
| GPIO 11~20
|-
| 触摸传感器
| TOUCH1~14
| GPIO 1~14
|-
| rowspan="4"|JTAG
| MTCK
| GPIO 39
|-
| MTDO
| GPIO 40
|-
| MTDI
| GPIO 41
|-
| MTMS
| GPIO 42
|-
| rowspan="14" | UART
| colspan="2" style="font-style:italic;color:#9b9b9b;" | 默认分配管脚，可重定义为任意GPIO
|-
| style="background-color:#ffffc7;" | U0RXD_in
| style="background-color:#ffffc7;" | GPIO 44
|-
| U0CTS_in
| GPIO 16
|-
| U0DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U0TXD_out
| style="background-color:#ffffc7;" | GPIO43
|-
| U0RTS_out
| GPIO 15
|-
| U0DTR_out
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1RXD_in
| style="background-color:#ffffc7;" | GPIO 18
|-
| U1CTS_in
| GPIO 20
|-
| U1DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1TXD_out
| style="background-color:#ffffc7;" | GPIO 17
|-
| U1RTS_out
| GPIO 19
|-
| U1DTR_out
| 任意GPIO
|-
| style="background-color:#9aff99;" | U2
| style="background-color:#9aff99;" | 任意GPIO
|-
| I2C
| colspan="2" | 任意GPIO
|-
| PWM
| colspan="2" | 任意GPIO
|-
| I2S
| colspan="2" | 任意GPIO
|-
| LCD
| colspan="2" | 任意GPIO
|-
| CAMERA
| colspan="2" | 任意GPIO
|-
| RMT
| colspan="2" | 任意GPIO
|-
| SPI0/1
| colspan="2" | 已用于FLASH与PSRAM
|-
| SPI2/3
| colspan="2" | 任意GPIO
|-
| 脉冲计数器
| colspan="2" | 任意GPIO
|-
| rowspan="8" | USB OTG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| RCV
| GPIO21（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| rowspan="7" | USB Serial/JTAG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| SD/MMC
| colspan="2" | 任意GPIO
|-
| MCPWM
| colspan="2" | 任意GPIO
|-
| TWAI
| colspan="2" | 任意GPIO
|-
| 彩色LED
| colspan="2" | GPIO 48
|}

= 软件 =

== ESP-IDF ==

[[File:Esp-idf-logo.png | 800px]]

ESP-IDF 是乐鑫官方推出的物联网开发框架，支持 Windows、Linux 和 macOS 操作系统。

建议开发者通过集成开发环境 (IDE) 安装 ESP-IDF:

* [https://github.com/espressif/idf-eclipse-plugin/blob/master/README_CN.md GitHub: ESP-IDF Eclipse 插件安装与使用指南]
* [https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension ESP-IDF VSCode 插件] | [https://github.com/espressif/vscode-esp-idf-extension/blob/master/docs/tutorial/toc.md GitHub: 安装与使用指南] | [https://www.bilibili.com/video/BV17p4y167uN bilibili：ESP-IDF VSCode 插件快速操作指南]

或者根据操作系统选择对应的手动安装流程:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/windows-setup.html Windows 平台工具链的标准设置]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/linux-macos-setup.html Linux 和 macOS 平台工具链的标准设置]

API:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/index.html#api API 参考]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-guides/index.html#api API 指南]

为了使你的BPI-Leaf-S3开发板可以通过USB-CDC刷写FLASH，需要设置开发板为固件下载模式。

有两种操作方法：

1.通过USB连接到电脑，按住BOOT键，再按一下RESET键并松开，最后松开BOOT键。

2.在断开供电的条件下按住BOOT键，再通过USB连接到电脑，最后松开BOOT键。

需要在设备管理器中确认接口，固件下载模式与普通模式下的接口序号可能是不一样的。

== MicroPython ==

[[File:Mircopython.png | 800px]]

MicroPython实现了大部分Python 3 特性和语法，易学易上手，验证程序效果无需编译直接下载进芯片运行。

无论是否有编程基础，MicroPython的上手难度绝对远低于其他编程语言，其代码易读性高，且开源社区有多年积累的丰富资源，就如同Python一样拥有极强的生命力与应用价值。

* '''[https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/tree/main/Example/MicroPython-zh#1%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B GitHub: MicroPython快速上手]'''

* [[ micropython_运行环境搭建 | MicroPython运行环境搭建(Thonny IDE) ]]

* [[ micropython_固件下载与烧录 | MicroPython固件下载与烧录 ]]

== Arduino ==

[[File:Arduino_logo_1200x350.png | 800px]]

Arduino 是一个开源嵌入式软硬件开发平台，用来供用户制作可交互式的嵌入式项目。

* [https://www.arduino.cc/en/software Arduino IDE 下载地址] | [https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html#installing 安装并配置Arduino-ESP32运行环境]
* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/Example/Arduino GitHub: BPI-Leaf-S3 Arduino快速上手]
* [https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html#apis Arduino-ESP32 APIs]

= 资料与资源 =

=样品购买=

* 官方速卖通:
* 官方淘宝:
* OEM&OEM 定制服务： sales@banana-pi.com

BPI-PicoW-S3 开发板

2022-09-22T03:23:00Z

Qubot: /* 硬件规格 */

[[en:BPI-PicoW-S3]]

= 介绍 =
[[File:BPI-PicoW-S3 banner.png|800px]]

[[File:PICO-1000-7.jpg|thumb|[[BPI-PicoW-S3_开发板 ]]with ESP32-S3]]
[[File:PICO-1000-5.png|thumb|[[BPI-PicoW-S3_开发板 ]]with ESP32-S3]]
[[File:Smart-01-03.gif|thumb|[[BPI-Smart ]]with ESP8266]]
[[File:Webduino_gif.gif|thumb|[[BPI-Bit]] with ESP32]]
[[File:BPI-AI_1.JPG|thumb|[[BPI-AI]] Kendryte K210 RISC-V]]
[[File:ESP32_6.JPG|thumb|[[BPI-UNO32]] with ESP32 design]]

== 关键特性 ==

* ESP32-S3，Xtensa® 32 bit LX7
* 片外 PSRAM , FLASH
* Ultra-low power 10uA
* 2.4G WIFI ，Bluetooth 5 ，Bluetooth mesh
* GPIO , ADC , TOUCH , PWM , I2C , SPI , RMT , I2S , UART , LCD，CAMERA ，USB , JTAG
* 1 * microUSB
* 1 * 全彩色LED

== BPI-PicoW-S3 与 Rraspberry Pi PicoW、BPI-Leaf-S3、ESP32-S3-DevKitC-1 开发板对比 ==

{| class="wikitable"
|- style="font-weight:bold;"
! 开发板
! BPI-PicoW-S3
! Rraspberry Pi PicoW
! BPI-Leaf-S3
! ESP32-S3-DevKitC-1
|-
| 引出GPIO
| 27
| 27
| 36
| 36
|-
| 3.3v管脚
| 1
| 1
| 2
| 2
|-
| 5v管脚
| 2
| 2
| 1
| 1
|-
| GND管脚
| 8
| 8
| 4
| 4
|-
| 全彩LED灯
| 1 on GPIO48
| 无
| 1 on GPIO48
| 1 on GPIO48
|-
| 芯片直连USB
| MicroUSB接口x1
| MicroUSB接口x1
| Type-C USB接口x1
| MicroUSB接口x1
|-
| UART TTL转USB
| 无
| 无
| 无
| CP2102-MicroUSB接口x1
|-
| 外接电池连接座
| 无
| 无
| 3.7v锂电池供电接口
| 无
|-
| 电池充电
| 无
| 无
| 500mA充电
| 无
|-
| I²C 4pin连接座
| 无
| 无
| 1
| 无
|}

== Espressif ESP32-S3 ==

ESP32-S3 是一款集成 2.4 GHz Wi-Fi 和 Bluetooth 5 (LE) 的 MCU 芯片，支持远距离模式 (Long Range)。ESP32-S3 搭载 Xtensa® 32 位 LX7 双核处理器，主频高达 240 MHz，内置 512 KB SRAM (TCM)，具有 45 个可编程 GPIO 管脚和丰富的通信接口。ESP32-S3 支持更大容量的高速 Octal SPI flash 和片外 RAM，支持用户配置数据缓存与指令缓存。

以下是ESP32-S3芯片重要功能的描述。

* '''支持Wi-Fi + Bluetooth 5 (LE) 无线连接''': ESP32-S3 集成 2.4 GHz Wi-Fi (802.11 b/g/n)，支持 40 MHz 带宽；其低功耗蓝牙子系统支持 Bluetooth 5 (LE) 和 Bluetooth Mesh，可通过 Coded PHY 与广播扩展实现远距离通信。它还支持 2 Mbps PHY，用于提高传输速度和数据吞吐量。ESP32-S3 的 Wi-Fi 和 Bluetooth LE 射频性能优越，在高温下也能稳定工作。

* '''支持 AI 加速''': ESP32-S3 MCU 增加了用于加速神经网络计算和信号处理等工作的向量指令 (vector instructions)。AI 开发者们通过 ESP-DSP 和 ESP-NN 库使用这些向量指令，可以实现高性能的图像识别、语音唤醒和识别等应用。

* '''丰富的 IO 接口''': ESP32-S3 拥有 45 个可编程 GPIO 以及 SPI、I2S、I2C、PWM、RMT、ADC、UART、SD/MMC 主机控制器和 TWAITM 控制器等常用外设接口。其中的 14 个 GPIO 可被配置为 HMI 交互的电容触摸输入端。此外，ESP32-S3 搭载了超低功耗协处理器 (ULP)，支持多种低功耗模式，广泛适用于各类低功耗应用场景。

* '''完善的安全机制''': ESP32-S3 为物联网设备提供了完善的安全机制和保护措施，防止各类恶意攻击和威胁。它支持基于 AES-XTS 算法的 flash 加密、基于 RSA 算法的安全启动、数字签名和 HMAC。ESP32-S3 还新增了一个“世界控制器 (World Controller)”模块，提供了两个互不干扰的执行环境，实现可信执行环境或权限分离机制。

= 硬件 =

== 硬件接口示意图 ==

[[File:BPI-PicoW-S3-V0.4-IO.png|800px]]

== 硬件规格 ==

{| class="wikitable"
|-
! colspan="2" style="background-color:#ffcb2f;" | BPI-PicoW-S3 规格表
|-
| SoC主控芯片
| ESP32-S3，Xtensa® 32 位 LX7 双核处理器
|-
| 主频
| 240MHz MAX
|-
| 工作温度
| -40℃~+85℃
|-
| 片上 ROM
| 384 KB
|-
| 片上 SRAM
| 320 KB
|-
| 板载 FLASH ROM
| 2MB
|-
| 片上外设PSRAM
| 8MB
|-
| WIFI
| IEEE 802.11 b/g/n ，2.4Ghz频带，150Mbps
|-
| 蓝牙
| Bluetooth 5 ，Bluetooth mesh
|-
| GPIO
| BPI-PicoW-S3已引出27个可用GPIO
|-
| ADC
| 2 × 12 位 SAR ADC，支持 18 个模拟通道输入
|-
| TOUCH 电容式触摸传感器
| 14
|-
| SPI
| 4
|-
| I2C
| 2，支持主机或从机模式
|-
| I2S
| 2，串行立体声数据的输入输出
|-
| LCD
| 1，支持 8 位 ~16 位并行 RGB、I8080、MOTO6800 接口
|-
| CAMERA
| 1，支持 8 位 ~16 位 DVP 图像传感器接口
|-
| UART
| 3 ，支持异步通信（RS232 和RS485）和 IrDA
|-
| PWM
| 8 路独立通道，14位精度
|-
| MCPWM
| 2
|-
| USB
| 1 × 全速USB 2.0 OTG，MicroUSB母口
|-
| USB Serial/JTAG 控制器
| 1，USB 全速标准，CDC-ACM ，JTAG
|-
| 温度传感器
| 1，测量范围为–20 °C 到 110 °C，用于监测芯片内部温度
|-
| SD/MMC
| 1 × SDIO主机接口，具有2个卡槽，支持SD卡3.0和3.01，SDIO 3.0，CE-ATA 1.1，MMC 4.41，eMMC 4.5和4.51
|-
| TWAI® 控制器
| 1 ，兼容 ISO11898-1（CAN 规范 2.0）
|-
| 通用 DMA 控制器
| 5 个接收通道和 5 个发送通道
|-
| RMT
| 4 通道发射，4通道接收，共享 384 x 32-bit 的 RAM
|-
| 脉冲计数器
| 4个脉冲计数控制器（单元），每个单元有2个独立的通道
|-
| 定时器
| 4 × 54 位通用定时器，16 位时钟预分频器，1 × 52 位系统定时器，3 × 看门狗定时器
|-
| 外部晶振
| 40Mhz
|-
| RTC 和低功耗管理
| 电源管理单元 (PMU)+ 超低功耗协处理器 (ULP)
|-
| 低功耗电流
| 10uA
|-
| 工作电压
| 3.3V
|-
| 输入电压
| 3.3V~5.5V
|-
| 最大放电电流
| 2A@3.3V DC/DC
|-
| 可控全彩色LED
| 1
|}

== 硬件尺寸 ==

[[File:BPI-Pico-S3-board-dimension.png|800px]]

{| class="wikitable"
|-
! colspan="2" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 尺寸表
|-
| 管脚间距
| 2.54mm
|-
| 安装孔间距
| 11.4mm/ 47mm
|-
| 安装孔尺寸
| 内径2.1mm/外径3.4mm
|-
| 主板尺寸
| 21 × 51.88(mm)/0.83 x 2.04(inches)
|-
| 板厚
| 1.2mm
|}

管脚间距兼容万能板（洞洞板、点阵板），面包板，便于调试应用。

== 外设GPIO管脚分配 ==

{| class="wikitable"
|-
! colspan="3" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 外设GPIO管脚分配
|- style="background-color:#32cb00;"
| 外设接口
| 信号
| 管脚
|-
| rowspan="2" | ADC
| ADC1_CH0~9
| GPIO 1~10
|-
| ADC2_CH0~9
| GPIO 11~20
|-
| 触摸传感器
| TOUCH1~14
| GPIO 1~14
|-
| rowspan="4"|JTAG
| MTCK
| GPIO 39
|-
| MTDO
| GPIO 40
|-
| MTDI
| GPIO 41
|-
| MTMS
| GPIO 42
|-
| rowspan="14" | UART
| colspan="2" style="font-style:italic;color:#9b9b9b;" | 默认分配管脚，可重定义为任意GPIO
|-
| style="background-color:#ffffc7;" | U0RXD_in
| style="background-color:#ffffc7;" | GPIO 44
|-
| U0CTS_in
| GPIO 16
|-
| U0DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U0TXD_out
| style="background-color:#ffffc7;" | GPIO43
|-
| U0RTS_out
| GPIO 15
|-
| U0DTR_out
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1RXD_in
| style="background-color:#ffffc7;" | GPIO 18
|-
| U1CTS_in
| GPIO 20
|-
| U1DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1TXD_out
| style="background-color:#ffffc7;" | GPIO 17
|-
| U1RTS_out
| GPIO 19
|-
| U1DTR_out
| 任意GPIO
|-
| style="background-color:#9aff99;" | U2
| style="background-color:#9aff99;" | 任意GPIO
|-
| I2C
| colspan="2" | 任意GPIO
|-
| PWM
| colspan="2" | 任意GPIO
|-
| I2S
| colspan="2" | 任意GPIO
|-
| LCD
| colspan="2" | 任意GPIO
|-
| CAMERA
| colspan="2" | 任意GPIO
|-
| RMT
| colspan="2" | 任意GPIO
|-
| SPI0/1
| colspan="2" | 已用于FLASH与PSRAM
|-
| SPI2/3
| colspan="2" | 任意GPIO
|-
| 脉冲计数器
| colspan="2" | 任意GPIO
|-
| rowspan="8" | USB OTG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| RCV
| GPIO21（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| rowspan="7" | USB Serial/JTAG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| SD/MMC
| colspan="2" | 任意GPIO
|-
| MCPWM
| colspan="2" | 任意GPIO
|-
| TWAI
| colspan="2" | 任意GPIO
|-
| 彩色LED
| colspan="2" | GPIO 48
|}

= 软件 =

== ESP-IDF ==

[[File:Esp-idf-logo.png | 800px]]

ESP-IDF 是乐鑫官方推出的物联网开发框架，支持 Windows、Linux 和 macOS 操作系统。

建议开发者通过集成开发环境 (IDE) 安装 ESP-IDF:

* [https://github.com/espressif/idf-eclipse-plugin/blob/master/README_CN.md GitHub: ESP-IDF Eclipse 插件安装与使用指南]
* [https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension ESP-IDF VSCode 插件] | [https://github.com/espressif/vscode-esp-idf-extension/blob/master/docs/tutorial/toc.md GitHub: 安装与使用指南] | [https://www.bilibili.com/video/BV17p4y167uN bilibili：ESP-IDF VSCode 插件快速操作指南]

或者根据操作系统选择对应的手动安装流程:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/windows-setup.html Windows 平台工具链的标准设置]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/linux-macos-setup.html Linux 和 macOS 平台工具链的标准设置]

API:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/index.html#api API 参考]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-guides/index.html#api API 指南]

为了使你的BPI-Leaf-S3开发板可以通过USB-CDC刷写FLASH，需要设置开发板为固件下载模式。

有两种操作方法：

1.通过USB连接到电脑，按住BOOT键，再按一下RESET键并松开，最后松开BOOT键。

2.在断开供电的条件下按住BOOT键，再通过USB连接到电脑，最后松开BOOT键。

需要在设备管理器中确认接口，固件下载模式与普通模式下的接口序号可能是不一样的。

== MicroPython ==

[[File:Mircopython.png | 800px]]

MicroPython实现了大部分Python 3 特性和语法，易学易上手，验证程序效果无需编译直接下载进芯片运行。

无论是否有编程基础，MicroPython的上手难度绝对远低于其他编程语言，其代码易读性高，且开源社区有多年积累的丰富资源，就如同Python一样拥有极强的生命力与应用价值。

* '''[https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/tree/main/Example/MicroPython-zh#1%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B GitHub: MicroPython快速上手]'''

* [[ micropython_运行环境搭建 | MicroPython运行环境搭建(Thonny IDE) ]]

* [[ micropython_固件下载与烧录 | MicroPython固件下载与烧录 ]]

== Arduino ==

[[File:Arduino_logo_1200x350.png | 800px]]

Arduino 是一个开源嵌入式软硬件开发平台，用来供用户制作可交互式的嵌入式项目。

* [https://www.arduino.cc/en/software Arduino IDE 下载地址] | [https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html#installing 安装并配置Arduino-ESP32运行环境]
* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/Example/Arduino GitHub: BPI-Leaf-S3 Arduino快速上手]
* [https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html#apis Arduino-ESP32 APIs]

= 资料与资源 =

=样品购买=

* 官方速卖通:
* 官方淘宝:
* OEM&OEM 定制服务： sales@banana-pi.com

BPI-PicoW-S3 开发板

2022-09-22T03:15:54Z

Qubot:

[[en:BPI-PicoW-S3]]

= 介绍 =
[[File:BPI-PicoW-S3 banner.png|800px]]

[[File:PICO-1000-7.jpg|thumb|[[BPI-PicoW-S3_开发板 ]]with ESP32-S3]]
[[File:PICO-1000-5.png|thumb|[[BPI-PicoW-S3_开发板 ]]with ESP32-S3]]
[[File:Smart-01-03.gif|thumb|[[BPI-Smart ]]with ESP8266]]
[[File:Webduino_gif.gif|thumb|[[BPI-Bit]] with ESP32]]
[[File:BPI-AI_1.JPG|thumb|[[BPI-AI]] Kendryte K210 RISC-V]]
[[File:ESP32_6.JPG|thumb|[[BPI-UNO32]] with ESP32 design]]

== 关键特性 ==

* ESP32-S3，Xtensa® 32 bit LX7
* 片外 PSRAM , FLASH
* Ultra-low power 10uA
* 2.4G WIFI ，Bluetooth 5 ，Bluetooth mesh
* GPIO , ADC , TOUCH , PWM , I2C , SPI , RMT , I2S , UART , LCD，CAMERA ，USB , JTAG
* 1 * microUSB
* 1 * 全彩色LED

== BPI-PicoW-S3 与 Rraspberry Pi PicoW、BPI-Leaf-S3、ESP32-S3-DevKitC-1 开发板对比 ==

{| class="wikitable"
|- style="font-weight:bold;"
! 开发板
! BPI-PicoW-S3
! Rraspberry Pi PicoW
! BPI-Leaf-S3
! ESP32-S3-DevKitC-1
|-
| 引出GPIO
| 27
| 27
| 36
| 36
|-
| 3.3v管脚
| 1
| 1
| 2
| 2
|-
| 5v管脚
| 2
| 2
| 1
| 1
|-
| GND管脚
| 8
| 8
| 4
| 4
|-
| 全彩LED灯
| 1 on GPIO48
| 无
| 1 on GPIO48
| 1 on GPIO48
|-
| 芯片直连USB
| MicroUSB接口x1
| MicroUSB接口x1
| Type-C USB接口x1
| MicroUSB接口x1
|-
| UART TTL转USB
| 无
| 无
| 无
| CP2102-MicroUSB接口x1
|-
| 外接电池连接座
| 无
| 无
| 3.7v锂电池供电接口
| 无
|-
| 电池充电
| 无
| 无
| 500mA充电
| 无
|-
| I²C 4pin连接座
| 无
| 无
| 1
| 无
|}

== Espressif ESP32-S3 ==

ESP32-S3 是一款集成 2.4 GHz Wi-Fi 和 Bluetooth 5 (LE) 的 MCU 芯片，支持远距离模式 (Long Range)。ESP32-S3 搭载 Xtensa® 32 位 LX7 双核处理器，主频高达 240 MHz，内置 512 KB SRAM (TCM)，具有 45 个可编程 GPIO 管脚和丰富的通信接口。ESP32-S3 支持更大容量的高速 Octal SPI flash 和片外 RAM，支持用户配置数据缓存与指令缓存。

以下是ESP32-S3芯片重要功能的描述。

* '''支持Wi-Fi + Bluetooth 5 (LE) 无线连接''': ESP32-S3 集成 2.4 GHz Wi-Fi (802.11 b/g/n)，支持 40 MHz 带宽；其低功耗蓝牙子系统支持 Bluetooth 5 (LE) 和 Bluetooth Mesh，可通过 Coded PHY 与广播扩展实现远距离通信。它还支持 2 Mbps PHY，用于提高传输速度和数据吞吐量。ESP32-S3 的 Wi-Fi 和 Bluetooth LE 射频性能优越，在高温下也能稳定工作。

* '''支持 AI 加速''': ESP32-S3 MCU 增加了用于加速神经网络计算和信号处理等工作的向量指令 (vector instructions)。AI 开发者们通过 ESP-DSP 和 ESP-NN 库使用这些向量指令，可以实现高性能的图像识别、语音唤醒和识别等应用。

* '''丰富的 IO 接口''': ESP32-S3 拥有 45 个可编程 GPIO 以及 SPI、I2S、I2C、PWM、RMT、ADC、UART、SD/MMC 主机控制器和 TWAITM 控制器等常用外设接口。其中的 14 个 GPIO 可被配置为 HMI 交互的电容触摸输入端。此外，ESP32-S3 搭载了超低功耗协处理器 (ULP)，支持多种低功耗模式，广泛适用于各类低功耗应用场景。

* '''完善的安全机制''': ESP32-S3 为物联网设备提供了完善的安全机制和保护措施，防止各类恶意攻击和威胁。它支持基于 AES-XTS 算法的 flash 加密、基于 RSA 算法的安全启动、数字签名和 HMAC。ESP32-S3 还新增了一个“世界控制器 (World Controller)”模块，提供了两个互不干扰的执行环境，实现可信执行环境或权限分离机制。

= 硬件 =

== 硬件接口示意图 ==

[[File:BPI-PicoW-S3-V0.4-IO.png|800px]]

== 硬件规格 ==

{| class="wikitable"
|-
! colspan="2" style="background-color:#ffcb2f;" | BPI-PicoW-S3 规格表
|-
| SoC主控芯片
| ESP32-S3，Xtensa® 32 位 LX7 双核处理器
|-
| 主频
| 240MHz MAX
|-
| 工作温度
| -40℃~+85℃
|-
| 片上 ROM
| 384 KB
|-
| 片上 SRAM
| 320 KB
|-
| 板载 FLASH ROM
| 2MB
|-
| 片上外设PSRAM
| 8MB
|-
| WIFI
| IEEE 802.11 b/g/n ，2.4Ghz频带，150Mbps
|-
| 蓝牙
| Bluetooth 5 ，Bluetooth mesh
|-
| GPIO
| BPI-PicoW-S3已引出27个可用GPIO
|-
| ADC
| 2 × 12 位 SAR ADC，支持 18 个模拟通道输入
|-
| TOUCH 电容式触摸传感器
| 14
|-
| SPI
| 4
|-
| I2C
| 2，支持主机或从机模式
|-
| I2S
| 2，串行立体声数据的输入输出
|-
| LCD
| 1，支持 8 位 ~16 位并行 RGB、I8080、MOTO6800 接口
|-
| CAMERA
| 1，支持 8 位 ~16 位 DVP 图像传感器接口
|-
| UART
| 3 ，支持异步通信（RS232 和RS485）和 IrDA
|-
| PWM
| 8 路独立通道，14位精度
|-
| MCPWM
| 2
|-
| USB
| 1 × 全速USB 2.0 OTG，Type-C母口
|-
| USB Serial/JTAG 控制器
| 1，USB 全速标准，CDC-ACM ，JTAG
|-
| 温度传感器
| 1，测量范围为–20 °C 到 110 °C，用于监测芯片内部温度
|-
| SD/MMC
| 1 × SDIO主机接口，具有2个卡槽，支持SD卡3.0和3.01，SDIO 3.0，CE-ATA 1.1，MMC 4.41，eMMC 4.5和4.51
|-
| TWAI® 控制器
| 1 ，兼容 ISO11898-1（CAN 规范 2.0）
|-
| 通用 DMA 控制器
| 5 个接收通道和 5 个发送通道
|-
| RMT
| 4 通道发射，4通道接收，共享 384 x 32-bit 的 RAM
|-
| 脉冲计数器
| 4个脉冲计数控制器（单元），每个单元有2个独立的通道
|-
| 定时器
| 4 × 54 位通用定时器，16 位时钟预分频器，1 × 52 位系统定时器，3 × 看门狗定时器
|-
| 外部晶振
| 40Mhz
|-
| RTC 和低功耗管理
| 电源管理单元 (PMU)+ 超低功耗协处理器 (ULP)
|-
| 低功耗电流
| 10uA
|-
| 工作电压
| 3.3V
|-
| 输入电压
| 3.3V~5.5V
|-
| 最大放电电流
| 2A@3.3V DC/DC
|-
| USB充电
| 支持
|-
| 最大充电电流
| 500mA
|-
| 可控全彩色LED
| 1
|}

== 硬件尺寸 ==

[[File:BPI-Pico-S3-board-dimension.png|800px]]

{| class="wikitable"
|-
! colspan="2" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 尺寸表
|-
| 管脚间距
| 2.54mm
|-
| 安装孔间距
| 11.4mm/ 47mm
|-
| 安装孔尺寸
| 内径2.1mm/外径3.4mm
|-
| 主板尺寸
| 21 × 51.88(mm)/0.83 x 2.04(inches)
|-
| 板厚
| 1.2mm
|}

管脚间距兼容万能板（洞洞板、点阵板），面包板，便于调试应用。

== 外设GPIO管脚分配 ==

{| class="wikitable"
|-
! colspan="3" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 外设GPIO管脚分配
|- style="background-color:#32cb00;"
| 外设接口
| 信号
| 管脚
|-
| rowspan="2" | ADC
| ADC1_CH0~9
| GPIO 1~10
|-
| ADC2_CH0~9
| GPIO 11~20
|-
| 触摸传感器
| TOUCH1~14
| GPIO 1~14
|-
| rowspan="4"|JTAG
| MTCK
| GPIO 39
|-
| MTDO
| GPIO 40
|-
| MTDI
| GPIO 41
|-
| MTMS
| GPIO 42
|-
| rowspan="14" | UART
| colspan="2" style="font-style:italic;color:#9b9b9b;" | 默认分配管脚，可重定义为任意GPIO
|-
| style="background-color:#ffffc7;" | U0RXD_in
| style="background-color:#ffffc7;" | GPIO 44
|-
| U0CTS_in
| GPIO 16
|-
| U0DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U0TXD_out
| style="background-color:#ffffc7;" | GPIO43
|-
| U0RTS_out
| GPIO 15
|-
| U0DTR_out
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1RXD_in
| style="background-color:#ffffc7;" | GPIO 18
|-
| U1CTS_in
| GPIO 20
|-
| U1DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1TXD_out
| style="background-color:#ffffc7;" | GPIO 17
|-
| U1RTS_out
| GPIO 19
|-
| U1DTR_out
| 任意GPIO
|-
| style="background-color:#9aff99;" | U2
| style="background-color:#9aff99;" | 任意GPIO
|-
| I2C
| colspan="2" | 任意GPIO
|-
| PWM
| colspan="2" | 任意GPIO
|-
| I2S
| colspan="2" | 任意GPIO
|-
| LCD
| colspan="2" | 任意GPIO
|-
| CAMERA
| colspan="2" | 任意GPIO
|-
| RMT
| colspan="2" | 任意GPIO
|-
| SPI0/1
| colspan="2" | 已用于FLASH与PSRAM
|-
| SPI2/3
| colspan="2" | 任意GPIO
|-
| 脉冲计数器
| colspan="2" | 任意GPIO
|-
| rowspan="8" | USB OTG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| RCV
| GPIO21（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| rowspan="7" | USB Serial/JTAG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| SD/MMC
| colspan="2" | 任意GPIO
|-
| MCPWM
| colspan="2" | 任意GPIO
|-
| TWAI
| colspan="2" | 任意GPIO
|-
| 彩色LED
| colspan="2" | GPIO 48
|}

= 软件 =

== ESP-IDF ==

[[File:Esp-idf-logo.png | 800px]]

ESP-IDF 是乐鑫官方推出的物联网开发框架，支持 Windows、Linux 和 macOS 操作系统。

建议开发者通过集成开发环境 (IDE) 安装 ESP-IDF:

* [https://github.com/espressif/idf-eclipse-plugin/blob/master/README_CN.md GitHub: ESP-IDF Eclipse 插件安装与使用指南]
* [https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension ESP-IDF VSCode 插件] | [https://github.com/espressif/vscode-esp-idf-extension/blob/master/docs/tutorial/toc.md GitHub: 安装与使用指南] | [https://www.bilibili.com/video/BV17p4y167uN bilibili：ESP-IDF VSCode 插件快速操作指南]

或者根据操作系统选择对应的手动安装流程:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/windows-setup.html Windows 平台工具链的标准设置]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/linux-macos-setup.html Linux 和 macOS 平台工具链的标准设置]

API:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/index.html#api API 参考]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-guides/index.html#api API 指南]

为了使你的BPI-Leaf-S3开发板可以通过USB-CDC刷写FLASH，需要设置开发板为固件下载模式。

有两种操作方法：

1.通过USB连接到电脑，按住BOOT键，再按一下RESET键并松开，最后松开BOOT键。

2.在断开供电的条件下按住BOOT键，再通过USB连接到电脑，最后松开BOOT键。

需要在设备管理器中确认接口，固件下载模式与普通模式下的接口序号可能是不一样的。

== MicroPython ==

[[File:Mircopython.png | 800px]]

MicroPython实现了大部分Python 3 特性和语法，易学易上手，验证程序效果无需编译直接下载进芯片运行。

无论是否有编程基础，MicroPython的上手难度绝对远低于其他编程语言，其代码易读性高，且开源社区有多年积累的丰富资源，就如同Python一样拥有极强的生命力与应用价值。

* '''[https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/tree/main/Example/MicroPython-zh#1%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B GitHub: MicroPython快速上手]'''

* [[ micropython_运行环境搭建 | MicroPython运行环境搭建(Thonny IDE) ]]

* [[ micropython_固件下载与烧录 | MicroPython固件下载与烧录 ]]

== Arduino ==

[[File:Arduino_logo_1200x350.png | 800px]]

Arduino 是一个开源嵌入式软硬件开发平台，用来供用户制作可交互式的嵌入式项目。

* [https://www.arduino.cc/en/software Arduino IDE 下载地址] | [https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html#installing 安装并配置Arduino-ESP32运行环境]
* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/Example/Arduino GitHub: BPI-Leaf-S3 Arduino快速上手]
* [https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html#apis Arduino-ESP32 APIs]

= 资料与资源 =

=样品购买=

* 官方速卖通:
* 官方淘宝:
* OEM&OEM 定制服务： sales@banana-pi.com

File:PICO-1000-back.png

2022-09-22T03:07:50Z

Qubot:

File:PICO-1000-7.jpg

2022-09-22T02:57:27Z

Qubot:

BPI-PicoW-S3 开发板

2022-09-22T02:55:51Z

Qubot: /* 介绍 */

[[en:BPI-PicoW-S3]]

= 介绍 =
[[File:BPI-PicoW-S3 banner.png|800px]]

[[File:Smart-01-03.gif|thumb|[[BPI-Smart ]]with ESP8266]]
[[File:Webduino_gif.gif|thumb|[[BPI-Bit]] with ESP32]]
[[File:BPI-AI_1.JPG|thumb|[[BPI-AI]] Kendryte K210 RISC-V]]
[[File:ESP32_6.JPG|thumb|[[BPI-UNO32]] with ESP32 design]]

== 关键特性 ==

* ESP32-S3，Xtensa® 32 bit LX7
* 片外 PSRAM , FLASH
* Ultra-low power 10uA
* 2.4G WIFI ，Bluetooth 5 ，Bluetooth mesh
* GPIO , ADC , TOUCH , PWM , I2C , SPI , RMT , I2S , UART , LCD，CAMERA ，USB , JTAG
* 1 * microUSB
* 1 * 全彩色LED

== BPI-PicoW-S3 与 Rraspberry Pi PicoW、BPI-Leaf-S3、ESP32-S3-DevKitC-1 开发板对比 ==

{| class="wikitable"
|- style="font-weight:bold;"
! 开发板
! BPI-PicoW-S3
! Rraspberry Pi PicoW
! BPI-Leaf-S3
! ESP32-S3-DevKitC-1
|-
| 引出GPIO
| 27
| 27
| 36
| 36
|-
| 3.3v管脚
| 1
| 1
| 2
| 2
|-
| 5v管脚
| 2
| 2
| 1
| 1
|-
| GND管脚
| 8
| 8
| 4
| 4
|-
| 全彩LED灯
| 1 on GPIO48
| 无
| 1 on GPIO48
| 1 on GPIO48
|-
| 芯片直连USB
| MicroUSB接口x1
| MicroUSB接口x1
| Type-C USB接口x1
| MicroUSB接口x1
|-
| UART TTL转USB
| 无
| 无
| 无
| CP2102-MicroUSB接口x1
|-
| 外接电池连接座
| 无
| 无
| 3.7v锂电池供电接口
| 无
|-
| 电池充电
| 无
| 无
| 500mA充电
| 无
|-
| I²C 4pin连接座
| 无
| 无
| 1
| 无
|}

== Espressif ESP32-S3 ==

ESP32-S3 是一款集成 2.4 GHz Wi-Fi 和 Bluetooth 5 (LE) 的 MCU 芯片，支持远距离模式 (Long Range)。ESP32-S3 搭载 Xtensa® 32 位 LX7 双核处理器，主频高达 240 MHz，内置 512 KB SRAM (TCM)，具有 45 个可编程 GPIO 管脚和丰富的通信接口。ESP32-S3 支持更大容量的高速 Octal SPI flash 和片外 RAM，支持用户配置数据缓存与指令缓存。

以下是ESP32-S3芯片重要功能的描述。

* '''支持Wi-Fi + Bluetooth 5 (LE) 无线连接''': ESP32-S3 集成 2.4 GHz Wi-Fi (802.11 b/g/n)，支持 40 MHz 带宽；其低功耗蓝牙子系统支持 Bluetooth 5 (LE) 和 Bluetooth Mesh，可通过 Coded PHY 与广播扩展实现远距离通信。它还支持 2 Mbps PHY，用于提高传输速度和数据吞吐量。ESP32-S3 的 Wi-Fi 和 Bluetooth LE 射频性能优越，在高温下也能稳定工作。

* '''支持 AI 加速''': ESP32-S3 MCU 增加了用于加速神经网络计算和信号处理等工作的向量指令 (vector instructions)。AI 开发者们通过 ESP-DSP 和 ESP-NN 库使用这些向量指令，可以实现高性能的图像识别、语音唤醒和识别等应用。

* '''丰富的 IO 接口''': ESP32-S3 拥有 45 个可编程 GPIO 以及 SPI、I2S、I2C、PWM、RMT、ADC、UART、SD/MMC 主机控制器和 TWAITM 控制器等常用外设接口。其中的 14 个 GPIO 可被配置为 HMI 交互的电容触摸输入端。此外，ESP32-S3 搭载了超低功耗协处理器 (ULP)，支持多种低功耗模式，广泛适用于各类低功耗应用场景。

* '''完善的安全机制''': ESP32-S3 为物联网设备提供了完善的安全机制和保护措施，防止各类恶意攻击和威胁。它支持基于 AES-XTS 算法的 flash 加密、基于 RSA 算法的安全启动、数字签名和 HMAC。ESP32-S3 还新增了一个“世界控制器 (World Controller)”模块，提供了两个互不干扰的执行环境，实现可信执行环境或权限分离机制。

= 硬件 =

== 硬件接口示意图 ==

[[File:BPI-PicoW-S3-V0.4-IO.png|800px]]

== 硬件规格 ==

{| class="wikitable"
|-
! colspan="2" style="background-color:#ffcb2f;" | BPI-PicoW-S3 规格表
|-
| SoC主控芯片
| ESP32-S3，Xtensa® 32 位 LX7 双核处理器
|-
| 主频
| 240MHz MAX
|-
| 工作温度
| -40℃~+85℃
|-
| 片上 ROM
| 384 KB
|-
| 片上 SRAM
| 320 KB
|-
| 板载 FLASH ROM
| 2MB
|-
| 片上外设PSRAM
| 8MB
|-
| WIFI
| IEEE 802.11 b/g/n ，2.4Ghz频带，150Mbps
|-
| 蓝牙
| Bluetooth 5 ，Bluetooth mesh
|-
| GPIO
| BPI-PicoW-S3已引出27个可用GPIO
|-
| ADC
| 2 × 12 位 SAR ADC，支持 18 个模拟通道输入
|-
| TOUCH 电容式触摸传感器
| 14
|-
| SPI
| 4
|-
| I2C
| 2，支持主机或从机模式
|-
| I2S
| 2，串行立体声数据的输入输出
|-
| LCD
| 1，支持 8 位 ~16 位并行 RGB、I8080、MOTO6800 接口
|-
| CAMERA
| 1，支持 8 位 ~16 位 DVP 图像传感器接口
|-
| UART
| 3 ，支持异步通信（RS232 和RS485）和 IrDA
|-
| PWM
| 8 路独立通道，14位精度
|-
| MCPWM
| 2
|-
| USB
| 1 × 全速USB 2.0 OTG，Type-C母口
|-
| USB Serial/JTAG 控制器
| 1，USB 全速标准，CDC-ACM ，JTAG
|-
| 温度传感器
| 1，测量范围为–20 °C 到 110 °C，用于监测芯片内部温度
|-
| SD/MMC
| 1 × SDIO主机接口，具有2个卡槽，支持SD卡3.0和3.01，SDIO 3.0，CE-ATA 1.1，MMC 4.41，eMMC 4.5和4.51
|-
| TWAI® 控制器
| 1 ，兼容 ISO11898-1（CAN 规范 2.0）
|-
| 通用 DMA 控制器
| 5 个接收通道和 5 个发送通道
|-
| RMT
| 4 通道发射，4通道接收，共享 384 x 32-bit 的 RAM
|-
| 脉冲计数器
| 4个脉冲计数控制器（单元），每个单元有2个独立的通道
|-
| 定时器
| 4 × 54 位通用定时器，16 位时钟预分频器，1 × 52 位系统定时器，3 × 看门狗定时器
|-
| 外部晶振
| 40Mhz
|-
| RTC 和低功耗管理
| 电源管理单元 (PMU)+ 超低功耗协处理器 (ULP)
|-
| 低功耗电流
| 10uA
|-
| 工作电压
| 3.3V
|-
| 输入电压
| 3.3V~5.5V
|-
| 最大放电电流
| 2A@3.3V DC/DC
|-
| USB充电
| 支持
|-
| 最大充电电流
| 500mA
|-
| 可控全彩色LED
| 1
|}

== 硬件尺寸 ==

[[File:BPI-Pico-S3-board-dimension.png|800px]]

{| class="wikitable"
|-
! colspan="2" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 尺寸表
|-
| 管脚间距
| 2.54mm
|-
| 安装孔间距
| 11.4mm/ 47mm
|-
| 安装孔尺寸
| 内径2.1mm/外径3.4mm
|-
| 主板尺寸
| 21 × 51.88(mm)/0.83 x 2.04(inches)
|-
| 板厚
| 1.2mm
|}

管脚间距兼容万能板（洞洞板、点阵板），面包板，便于调试应用。

== 外设GPIO管脚分配 ==

{| class="wikitable"
|-
! colspan="3" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 外设GPIO管脚分配
|- style="background-color:#32cb00;"
| 外设接口
| 信号
| 管脚
|-
| rowspan="2" | ADC
| ADC1_CH0~9
| GPIO 1~10
|-
| ADC2_CH0~9
| GPIO 11~20
|-
| 触摸传感器
| TOUCH1~14
| GPIO 1~14
|-
| rowspan="4"|JTAG
| MTCK
| GPIO 39
|-
| MTDO
| GPIO 40
|-
| MTDI
| GPIO 41
|-
| MTMS
| GPIO 42
|-
| rowspan="14" | UART
| colspan="2" style="font-style:italic;color:#9b9b9b;" | 默认分配管脚，可重定义为任意GPIO
|-
| style="background-color:#ffffc7;" | U0RXD_in
| style="background-color:#ffffc7;" | GPIO 44
|-
| U0CTS_in
| GPIO 16
|-
| U0DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U0TXD_out
| style="background-color:#ffffc7;" | GPIO43
|-
| U0RTS_out
| GPIO 15
|-
| U0DTR_out
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1RXD_in
| style="background-color:#ffffc7;" | GPIO 18
|-
| U1CTS_in
| GPIO 20
|-
| U1DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1TXD_out
| style="background-color:#ffffc7;" | GPIO 17
|-
| U1RTS_out
| GPIO 19
|-
| U1DTR_out
| 任意GPIO
|-
| style="background-color:#9aff99;" | U2
| style="background-color:#9aff99;" | 任意GPIO
|-
| I2C
| colspan="2" | 任意GPIO
|-
| PWM
| colspan="2" | 任意GPIO
|-
| I2S
| colspan="2" | 任意GPIO
|-
| LCD
| colspan="2" | 任意GPIO
|-
| CAMERA
| colspan="2" | 任意GPIO
|-
| RMT
| colspan="2" | 任意GPIO
|-
| SPI0/1
| colspan="2" | 已用于FLASH与PSRAM
|-
| SPI2/3
| colspan="2" | 任意GPIO
|-
| 脉冲计数器
| colspan="2" | 任意GPIO
|-
| rowspan="8" | USB OTG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| RCV
| GPIO21（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| rowspan="7" | USB Serial/JTAG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| SD/MMC
| colspan="2" | 任意GPIO
|-
| MCPWM
| colspan="2" | 任意GPIO
|-
| TWAI
| colspan="2" | 任意GPIO
|-
| 彩色LED
| colspan="2" | GPIO 48
|}

= 软件 =

== ESP-IDF ==

[[File:Esp-idf-logo.png | 800px]]

ESP-IDF 是乐鑫官方推出的物联网开发框架，支持 Windows、Linux 和 macOS 操作系统。

建议开发者通过集成开发环境 (IDE) 安装 ESP-IDF:

* [https://github.com/espressif/idf-eclipse-plugin/blob/master/README_CN.md GitHub: ESP-IDF Eclipse 插件安装与使用指南]
* [https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension ESP-IDF VSCode 插件] | [https://github.com/espressif/vscode-esp-idf-extension/blob/master/docs/tutorial/toc.md GitHub: 安装与使用指南] | [https://www.bilibili.com/video/BV17p4y167uN bilibili：ESP-IDF VSCode 插件快速操作指南]

或者根据操作系统选择对应的手动安装流程:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/windows-setup.html Windows 平台工具链的标准设置]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/linux-macos-setup.html Linux 和 macOS 平台工具链的标准设置]

API:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/index.html#api API 参考]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-guides/index.html#api API 指南]

为了使你的BPI-Leaf-S3开发板可以通过USB-CDC刷写FLASH，需要设置开发板为固件下载模式。

有两种操作方法：

1.通过USB连接到电脑，按住BOOT键，再按一下RESET键并松开，最后松开BOOT键。

2.在断开供电的条件下按住BOOT键，再通过USB连接到电脑，最后松开BOOT键。

需要在设备管理器中确认接口，固件下载模式与普通模式下的接口序号可能是不一样的。

== MicroPython ==

[[File:Mircopython.png | 800px]]

MicroPython实现了大部分Python 3 特性和语法，易学易上手，验证程序效果无需编译直接下载进芯片运行。

无论是否有编程基础，MicroPython的上手难度绝对远低于其他编程语言，其代码易读性高，且开源社区有多年积累的丰富资源，就如同Python一样拥有极强的生命力与应用价值。

* '''[https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/tree/main/Example/MicroPython-zh#1%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B GitHub: MicroPython快速上手]'''

* [[ micropython_运行环境搭建 | MicroPython运行环境搭建(Thonny IDE) ]]

* [[ micropython_固件下载与烧录 | MicroPython固件下载与烧录 ]]

== Arduino ==

[[File:Arduino_logo_1200x350.png | 800px]]

Arduino 是一个开源嵌入式软硬件开发平台，用来供用户制作可交互式的嵌入式项目。

* [https://www.arduino.cc/en/software Arduino IDE 下载地址] | [https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html#installing 安装并配置Arduino-ESP32运行环境]
* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/Example/Arduino GitHub: BPI-Leaf-S3 Arduino快速上手]
* [https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html#apis Arduino-ESP32 APIs]

= 资料与资源 =

=样品购买=

* 官方速卖通:
* 官方淘宝:
* OEM&OEM 定制服务： sales@banana-pi.com

File:BPI-PicoW-S3 banner.png

2022-09-22T02:54:48Z

Qubot: Qubot uploaded a new version of File:BPI-PicoW-S3 banner.png

File:BPI-PicoW-S3 banner.png

2022-09-22T02:47:01Z

Qubot:

BPI-PicoW-S3 开发板

2022-09-21T01:59:25Z

Qubot: /* BPI-PicoW-S3 与 Rraspberry Pi PicoW、BPI-Leaf-S3、ESP32-S3-DevKitC-1 开发板对比 */

[[en:BPI-PicoW-S3]]

= 介绍 =
Preparing...

[[File:Smart-01-03.gif|thumb|[[BPI-Smart ]]with ESP8266]]
[[File:Webduino_gif.gif|thumb|[[BPI-Bit]] with ESP32]]
[[File:BPI-AI_1.JPG|thumb|[[BPI-AI]] Kendryte K210 RISC-V]]
[[File:ESP32_6.JPG|thumb|[[BPI-UNO32]] with ESP32 design]]

== 关键特性 ==

* ESP32-S3，Xtensa® 32 bit LX7
* 片外 PSRAM , FLASH
* Ultra-low power 10uA
* 2.4G WIFI ，Bluetooth 5 ，Bluetooth mesh
* GPIO , ADC , TOUCH , PWM , I2C , SPI , RMT , I2S , UART , LCD，CAMERA ，USB , JTAG
* 1 * microUSB
* 1 * 全彩色LED

== BPI-PicoW-S3 与 Rraspberry Pi PicoW、BPI-Leaf-S3、ESP32-S3-DevKitC-1 开发板对比 ==

{| class="wikitable"
|- style="font-weight:bold;"
! 开发板
! BPI-PicoW-S3
! Rraspberry Pi PicoW
! BPI-Leaf-S3
! ESP32-S3-DevKitC-1
|-
| 引出GPIO
| 27
| 27
| 36
| 36
|-
| 3.3v管脚
| 1
| 1
| 2
| 2
|-
| 5v管脚
| 2
| 2
| 1
| 1
|-
| GND管脚
| 8
| 8
| 4
| 4
|-
| 全彩LED灯
| 1 on GPIO48
| 无
| 1 on GPIO48
| 1 on GPIO48
|-
| 芯片直连USB
| MicroUSB接口x1
| MicroUSB接口x1
| Type-C USB接口x1
| MicroUSB接口x1
|-
| UART TTL转USB
| 无
| 无
| 无
| CP2102-MicroUSB接口x1
|-
| 外接电池连接座
| 无
| 无
| 3.7v锂电池供电接口
| 无
|-
| 电池充电
| 无
| 无
| 500mA充电
| 无
|-
| I²C 4pin连接座
| 无
| 无
| 1
| 无
|}

== Espressif ESP32-S3 ==

ESP32-S3 是一款集成 2.4 GHz Wi-Fi 和 Bluetooth 5 (LE) 的 MCU 芯片，支持远距离模式 (Long Range)。ESP32-S3 搭载 Xtensa® 32 位 LX7 双核处理器，主频高达 240 MHz，内置 512 KB SRAM (TCM)，具有 45 个可编程 GPIO 管脚和丰富的通信接口。ESP32-S3 支持更大容量的高速 Octal SPI flash 和片外 RAM，支持用户配置数据缓存与指令缓存。

以下是ESP32-S3芯片重要功能的描述。

* '''支持Wi-Fi + Bluetooth 5 (LE) 无线连接''': ESP32-S3 集成 2.4 GHz Wi-Fi (802.11 b/g/n)，支持 40 MHz 带宽；其低功耗蓝牙子系统支持 Bluetooth 5 (LE) 和 Bluetooth Mesh，可通过 Coded PHY 与广播扩展实现远距离通信。它还支持 2 Mbps PHY，用于提高传输速度和数据吞吐量。ESP32-S3 的 Wi-Fi 和 Bluetooth LE 射频性能优越，在高温下也能稳定工作。

* '''支持 AI 加速''': ESP32-S3 MCU 增加了用于加速神经网络计算和信号处理等工作的向量指令 (vector instructions)。AI 开发者们通过 ESP-DSP 和 ESP-NN 库使用这些向量指令，可以实现高性能的图像识别、语音唤醒和识别等应用。

* '''丰富的 IO 接口''': ESP32-S3 拥有 45 个可编程 GPIO 以及 SPI、I2S、I2C、PWM、RMT、ADC、UART、SD/MMC 主机控制器和 TWAITM 控制器等常用外设接口。其中的 14 个 GPIO 可被配置为 HMI 交互的电容触摸输入端。此外，ESP32-S3 搭载了超低功耗协处理器 (ULP)，支持多种低功耗模式，广泛适用于各类低功耗应用场景。

* '''完善的安全机制''': ESP32-S3 为物联网设备提供了完善的安全机制和保护措施，防止各类恶意攻击和威胁。它支持基于 AES-XTS 算法的 flash 加密、基于 RSA 算法的安全启动、数字签名和 HMAC。ESP32-S3 还新增了一个“世界控制器 (World Controller)”模块，提供了两个互不干扰的执行环境，实现可信执行环境或权限分离机制。

= 硬件 =

== 硬件接口示意图 ==

[[File:BPI-PicoW-S3-V0.4-IO.png|800px]]

== 硬件规格 ==

{| class="wikitable"
|-
! colspan="2" style="background-color:#ffcb2f;" | BPI-PicoW-S3 规格表
|-
| SoC主控芯片
| ESP32-S3，Xtensa® 32 位 LX7 双核处理器
|-
| 主频
| 240MHz MAX
|-
| 工作温度
| -40℃~+85℃
|-
| 片上 ROM
| 384 KB
|-
| 片上 SRAM
| 320 KB
|-
| 板载 FLASH ROM
| 2MB
|-
| 片上外设PSRAM
| 8MB
|-
| WIFI
| IEEE 802.11 b/g/n ，2.4Ghz频带，150Mbps
|-
| 蓝牙
| Bluetooth 5 ，Bluetooth mesh
|-
| GPIO
| BPI-PicoW-S3已引出27个可用GPIO
|-
| ADC
| 2 × 12 位 SAR ADC，支持 18 个模拟通道输入
|-
| TOUCH 电容式触摸传感器
| 14
|-
| SPI
| 4
|-
| I2C
| 2，支持主机或从机模式
|-
| I2S
| 2，串行立体声数据的输入输出
|-
| LCD
| 1，支持 8 位 ~16 位并行 RGB、I8080、MOTO6800 接口
|-
| CAMERA
| 1，支持 8 位 ~16 位 DVP 图像传感器接口
|-
| UART
| 3 ，支持异步通信（RS232 和RS485）和 IrDA
|-
| PWM
| 8 路独立通道，14位精度
|-
| MCPWM
| 2
|-
| USB
| 1 × 全速USB 2.0 OTG，Type-C母口
|-
| USB Serial/JTAG 控制器
| 1，USB 全速标准，CDC-ACM ，JTAG
|-
| 温度传感器
| 1，测量范围为–20 °C 到 110 °C，用于监测芯片内部温度
|-
| SD/MMC
| 1 × SDIO主机接口，具有2个卡槽，支持SD卡3.0和3.01，SDIO 3.0，CE-ATA 1.1，MMC 4.41，eMMC 4.5和4.51
|-
| TWAI® 控制器
| 1 ，兼容 ISO11898-1（CAN 规范 2.0）
|-
| 通用 DMA 控制器
| 5 个接收通道和 5 个发送通道
|-
| RMT
| 4 通道发射，4通道接收，共享 384 x 32-bit 的 RAM
|-
| 脉冲计数器
| 4个脉冲计数控制器（单元），每个单元有2个独立的通道
|-
| 定时器
| 4 × 54 位通用定时器，16 位时钟预分频器，1 × 52 位系统定时器，3 × 看门狗定时器
|-
| 外部晶振
| 40Mhz
|-
| RTC 和低功耗管理
| 电源管理单元 (PMU)+ 超低功耗协处理器 (ULP)
|-
| 低功耗电流
| 10uA
|-
| 工作电压
| 3.3V
|-
| 输入电压
| 3.3V~5.5V
|-
| 最大放电电流
| 2A@3.3V DC/DC
|-
| USB充电
| 支持
|-
| 最大充电电流
| 500mA
|-
| 可控全彩色LED
| 1
|}

== 硬件尺寸 ==

[[File:BPI-Pico-S3-board-dimension.png|800px]]

{| class="wikitable"
|-
! colspan="2" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 尺寸表
|-
| 管脚间距
| 2.54mm
|-
| 安装孔间距
| 11.4mm/ 47mm
|-
| 安装孔尺寸
| 内径2.1mm/外径3.4mm
|-
| 主板尺寸
| 21 × 51.88(mm)/0.83 x 2.04(inches)
|-
| 板厚
| 1.2mm
|}

管脚间距兼容万能板（洞洞板、点阵板），面包板，便于调试应用。

== 外设GPIO管脚分配 ==

{| class="wikitable"
|-
! colspan="3" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 外设GPIO管脚分配
|- style="background-color:#32cb00;"
| 外设接口
| 信号
| 管脚
|-
| rowspan="2" | ADC
| ADC1_CH0~9
| GPIO 1~10
|-
| ADC2_CH0~9
| GPIO 11~20
|-
| 触摸传感器
| TOUCH1~14
| GPIO 1~14
|-
| rowspan="4"|JTAG
| MTCK
| GPIO 39
|-
| MTDO
| GPIO 40
|-
| MTDI
| GPIO 41
|-
| MTMS
| GPIO 42
|-
| rowspan="14" | UART
| colspan="2" style="font-style:italic;color:#9b9b9b;" | 默认分配管脚，可重定义为任意GPIO
|-
| style="background-color:#ffffc7;" | U0RXD_in
| style="background-color:#ffffc7;" | GPIO 44
|-
| U0CTS_in
| GPIO 16
|-
| U0DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U0TXD_out
| style="background-color:#ffffc7;" | GPIO43
|-
| U0RTS_out
| GPIO 15
|-
| U0DTR_out
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1RXD_in
| style="background-color:#ffffc7;" | GPIO 18
|-
| U1CTS_in
| GPIO 20
|-
| U1DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1TXD_out
| style="background-color:#ffffc7;" | GPIO 17
|-
| U1RTS_out
| GPIO 19
|-
| U1DTR_out
| 任意GPIO
|-
| style="background-color:#9aff99;" | U2
| style="background-color:#9aff99;" | 任意GPIO
|-
| I2C
| colspan="2" | 任意GPIO
|-
| PWM
| colspan="2" | 任意GPIO
|-
| I2S
| colspan="2" | 任意GPIO
|-
| LCD
| colspan="2" | 任意GPIO
|-
| CAMERA
| colspan="2" | 任意GPIO
|-
| RMT
| colspan="2" | 任意GPIO
|-
| SPI0/1
| colspan="2" | 已用于FLASH与PSRAM
|-
| SPI2/3
| colspan="2" | 任意GPIO
|-
| 脉冲计数器
| colspan="2" | 任意GPIO
|-
| rowspan="8" | USB OTG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| RCV
| GPIO21（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| rowspan="7" | USB Serial/JTAG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| SD/MMC
| colspan="2" | 任意GPIO
|-
| MCPWM
| colspan="2" | 任意GPIO
|-
| TWAI
| colspan="2" | 任意GPIO
|-
| 彩色LED
| colspan="2" | GPIO 48
|}

= 软件 =

== ESP-IDF ==

[[File:Esp-idf-logo.png | 800px]]

ESP-IDF 是乐鑫官方推出的物联网开发框架，支持 Windows、Linux 和 macOS 操作系统。

建议开发者通过集成开发环境 (IDE) 安装 ESP-IDF:

* [https://github.com/espressif/idf-eclipse-plugin/blob/master/README_CN.md GitHub: ESP-IDF Eclipse 插件安装与使用指南]
* [https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension ESP-IDF VSCode 插件] | [https://github.com/espressif/vscode-esp-idf-extension/blob/master/docs/tutorial/toc.md GitHub: 安装与使用指南] | [https://www.bilibili.com/video/BV17p4y167uN bilibili：ESP-IDF VSCode 插件快速操作指南]

或者根据操作系统选择对应的手动安装流程:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/windows-setup.html Windows 平台工具链的标准设置]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/linux-macos-setup.html Linux 和 macOS 平台工具链的标准设置]

API:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/index.html#api API 参考]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-guides/index.html#api API 指南]

为了使你的BPI-Leaf-S3开发板可以通过USB-CDC刷写FLASH，需要设置开发板为固件下载模式。

有两种操作方法：

1.通过USB连接到电脑，按住BOOT键，再按一下RESET键并松开，最后松开BOOT键。

2.在断开供电的条件下按住BOOT键，再通过USB连接到电脑，最后松开BOOT键。

需要在设备管理器中确认接口，固件下载模式与普通模式下的接口序号可能是不一样的。

== MicroPython ==

[[File:Mircopython.png | 800px]]

MicroPython实现了大部分Python 3 特性和语法，易学易上手，验证程序效果无需编译直接下载进芯片运行。

无论是否有编程基础，MicroPython的上手难度绝对远低于其他编程语言，其代码易读性高，且开源社区有多年积累的丰富资源，就如同Python一样拥有极强的生命力与应用价值。

* '''[https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/tree/main/Example/MicroPython-zh#1%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B GitHub: MicroPython快速上手]'''

* [[ micropython_运行环境搭建 | MicroPython运行环境搭建(Thonny IDE) ]]

* [[ micropython_固件下载与烧录 | MicroPython固件下载与烧录 ]]

== Arduino ==

[[File:Arduino_logo_1200x350.png | 800px]]

Arduino 是一个开源嵌入式软硬件开发平台，用来供用户制作可交互式的嵌入式项目。

* [https://www.arduino.cc/en/software Arduino IDE 下载地址] | [https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html#installing 安装并配置Arduino-ESP32运行环境]
* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/Example/Arduino GitHub: BPI-Leaf-S3 Arduino快速上手]
* [https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html#apis Arduino-ESP32 APIs]

= 资料与资源 =

=样品购买=

* 官方速卖通:
* 官方淘宝:
* OEM&OEM 定制服务： sales@banana-pi.com

BPI-PicoW-S3 开发板

2022-09-21T01:58:55Z

Qubot: /* BPI-PicoW-S3 与 BPI-Leaf-S3 Rraspberry Pi PicoW开发板对比 */

[[en:BPI-PicoW-S3]]

= 介绍 =
Preparing...

[[File:Smart-01-03.gif|thumb|[[BPI-Smart ]]with ESP8266]]
[[File:Webduino_gif.gif|thumb|[[BPI-Bit]] with ESP32]]
[[File:BPI-AI_1.JPG|thumb|[[BPI-AI]] Kendryte K210 RISC-V]]
[[File:ESP32_6.JPG|thumb|[[BPI-UNO32]] with ESP32 design]]

== 关键特性 ==

* ESP32-S3，Xtensa® 32 bit LX7
* 片外 PSRAM , FLASH
* Ultra-low power 10uA
* 2.4G WIFI ，Bluetooth 5 ，Bluetooth mesh
* GPIO , ADC , TOUCH , PWM , I2C , SPI , RMT , I2S , UART , LCD，CAMERA ，USB , JTAG
* 1 * microUSB
* 1 * 全彩色LED

== BPI-PicoW-S3 与 Rraspberry Pi PicoW、BPI-Leaf-S3、ESP32-S3-DevKitC-1 开发板对比 ==
Preparing...
{| class="wikitable"
|- style="font-weight:bold;"
! 开发板
! BPI-PicoW-S3
! Rraspberry Pi PicoW
! BPI-Leaf-S3
! ESP32-S3-DevKitC-1
|-
| 引出GPIO
| 27
| 27
| 36
| 36
|-
| 3.3v管脚
| 1
| 1
| 2
| 2
|-
| 5v管脚
| 2
| 2
| 1
| 1
|-
| GND管脚
| 8
| 8
| 4
| 4
|-
| 全彩LED灯
| 1 on GPIO48
| 无
| 1 on GPIO48
| 1 on GPIO48
|-
| 芯片直连USB
| MicroUSB接口x1
| MicroUSB接口x1
| Type-C USB接口x1
| MicroUSB接口x1
|-
| UART TTL转USB
| 无
| 无
| 无
| CP2102-MicroUSB接口x1
|-
| 外接电池连接座
| 无
| 无
| 3.7v锂电池供电接口
| 无
|-
| 电池充电
| 无
| 无
| 500mA充电
| 无
|-
| I²C 4pin连接座
| 无
| 无
| 1
| 无
|}

== Espressif ESP32-S3 ==

ESP32-S3 是一款集成 2.4 GHz Wi-Fi 和 Bluetooth 5 (LE) 的 MCU 芯片，支持远距离模式 (Long Range)。ESP32-S3 搭载 Xtensa® 32 位 LX7 双核处理器，主频高达 240 MHz，内置 512 KB SRAM (TCM)，具有 45 个可编程 GPIO 管脚和丰富的通信接口。ESP32-S3 支持更大容量的高速 Octal SPI flash 和片外 RAM，支持用户配置数据缓存与指令缓存。

以下是ESP32-S3芯片重要功能的描述。

* '''支持Wi-Fi + Bluetooth 5 (LE) 无线连接''': ESP32-S3 集成 2.4 GHz Wi-Fi (802.11 b/g/n)，支持 40 MHz 带宽；其低功耗蓝牙子系统支持 Bluetooth 5 (LE) 和 Bluetooth Mesh，可通过 Coded PHY 与广播扩展实现远距离通信。它还支持 2 Mbps PHY，用于提高传输速度和数据吞吐量。ESP32-S3 的 Wi-Fi 和 Bluetooth LE 射频性能优越，在高温下也能稳定工作。

* '''支持 AI 加速''': ESP32-S3 MCU 增加了用于加速神经网络计算和信号处理等工作的向量指令 (vector instructions)。AI 开发者们通过 ESP-DSP 和 ESP-NN 库使用这些向量指令，可以实现高性能的图像识别、语音唤醒和识别等应用。

* '''丰富的 IO 接口''': ESP32-S3 拥有 45 个可编程 GPIO 以及 SPI、I2S、I2C、PWM、RMT、ADC、UART、SD/MMC 主机控制器和 TWAITM 控制器等常用外设接口。其中的 14 个 GPIO 可被配置为 HMI 交互的电容触摸输入端。此外，ESP32-S3 搭载了超低功耗协处理器 (ULP)，支持多种低功耗模式，广泛适用于各类低功耗应用场景。

* '''完善的安全机制''': ESP32-S3 为物联网设备提供了完善的安全机制和保护措施，防止各类恶意攻击和威胁。它支持基于 AES-XTS 算法的 flash 加密、基于 RSA 算法的安全启动、数字签名和 HMAC。ESP32-S3 还新增了一个“世界控制器 (World Controller)”模块，提供了两个互不干扰的执行环境，实现可信执行环境或权限分离机制。

= 硬件 =

== 硬件接口示意图 ==

[[File:BPI-PicoW-S3-V0.4-IO.png|800px]]

== 硬件规格 ==

{| class="wikitable"
|-
! colspan="2" style="background-color:#ffcb2f;" | BPI-PicoW-S3 规格表
|-
| SoC主控芯片
| ESP32-S3，Xtensa® 32 位 LX7 双核处理器
|-
| 主频
| 240MHz MAX
|-
| 工作温度
| -40℃~+85℃
|-
| 片上 ROM
| 384 KB
|-
| 片上 SRAM
| 320 KB
|-
| 板载 FLASH ROM
| 2MB
|-
| 片上外设PSRAM
| 8MB
|-
| WIFI
| IEEE 802.11 b/g/n ，2.4Ghz频带，150Mbps
|-
| 蓝牙
| Bluetooth 5 ，Bluetooth mesh
|-
| GPIO
| BPI-PicoW-S3已引出27个可用GPIO
|-
| ADC
| 2 × 12 位 SAR ADC，支持 18 个模拟通道输入
|-
| TOUCH 电容式触摸传感器
| 14
|-
| SPI
| 4
|-
| I2C
| 2，支持主机或从机模式
|-
| I2S
| 2，串行立体声数据的输入输出
|-
| LCD
| 1，支持 8 位 ~16 位并行 RGB、I8080、MOTO6800 接口
|-
| CAMERA
| 1，支持 8 位 ~16 位 DVP 图像传感器接口
|-
| UART
| 3 ，支持异步通信（RS232 和RS485）和 IrDA
|-
| PWM
| 8 路独立通道，14位精度
|-
| MCPWM
| 2
|-
| USB
| 1 × 全速USB 2.0 OTG，Type-C母口
|-
| USB Serial/JTAG 控制器
| 1，USB 全速标准，CDC-ACM ，JTAG
|-
| 温度传感器
| 1，测量范围为–20 °C 到 110 °C，用于监测芯片内部温度
|-
| SD/MMC
| 1 × SDIO主机接口，具有2个卡槽，支持SD卡3.0和3.01，SDIO 3.0，CE-ATA 1.1，MMC 4.41，eMMC 4.5和4.51
|-
| TWAI® 控制器
| 1 ，兼容 ISO11898-1（CAN 规范 2.0）
|-
| 通用 DMA 控制器
| 5 个接收通道和 5 个发送通道
|-
| RMT
| 4 通道发射，4通道接收，共享 384 x 32-bit 的 RAM
|-
| 脉冲计数器
| 4个脉冲计数控制器（单元），每个单元有2个独立的通道
|-
| 定时器
| 4 × 54 位通用定时器，16 位时钟预分频器，1 × 52 位系统定时器，3 × 看门狗定时器
|-
| 外部晶振
| 40Mhz
|-
| RTC 和低功耗管理
| 电源管理单元 (PMU)+ 超低功耗协处理器 (ULP)
|-
| 低功耗电流
| 10uA
|-
| 工作电压
| 3.3V
|-
| 输入电压
| 3.3V~5.5V
|-
| 最大放电电流
| 2A@3.3V DC/DC
|-
| USB充电
| 支持
|-
| 最大充电电流
| 500mA
|-
| 可控全彩色LED
| 1
|}

== 硬件尺寸 ==

[[File:BPI-Pico-S3-board-dimension.png|800px]]

{| class="wikitable"
|-
! colspan="2" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 尺寸表
|-
| 管脚间距
| 2.54mm
|-
| 安装孔间距
| 11.4mm/ 47mm
|-
| 安装孔尺寸
| 内径2.1mm/外径3.4mm
|-
| 主板尺寸
| 21 × 51.88(mm)/0.83 x 2.04(inches)
|-
| 板厚
| 1.2mm
|}

管脚间距兼容万能板（洞洞板、点阵板），面包板，便于调试应用。

== 外设GPIO管脚分配 ==

{| class="wikitable"
|-
! colspan="3" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 外设GPIO管脚分配
|- style="background-color:#32cb00;"
| 外设接口
| 信号
| 管脚
|-
| rowspan="2" | ADC
| ADC1_CH0~9
| GPIO 1~10
|-
| ADC2_CH0~9
| GPIO 11~20
|-
| 触摸传感器
| TOUCH1~14
| GPIO 1~14
|-
| rowspan="4"|JTAG
| MTCK
| GPIO 39
|-
| MTDO
| GPIO 40
|-
| MTDI
| GPIO 41
|-
| MTMS
| GPIO 42
|-
| rowspan="14" | UART
| colspan="2" style="font-style:italic;color:#9b9b9b;" | 默认分配管脚，可重定义为任意GPIO
|-
| style="background-color:#ffffc7;" | U0RXD_in
| style="background-color:#ffffc7;" | GPIO 44
|-
| U0CTS_in
| GPIO 16
|-
| U0DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U0TXD_out
| style="background-color:#ffffc7;" | GPIO43
|-
| U0RTS_out
| GPIO 15
|-
| U0DTR_out
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1RXD_in
| style="background-color:#ffffc7;" | GPIO 18
|-
| U1CTS_in
| GPIO 20
|-
| U1DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1TXD_out
| style="background-color:#ffffc7;" | GPIO 17
|-
| U1RTS_out
| GPIO 19
|-
| U1DTR_out
| 任意GPIO
|-
| style="background-color:#9aff99;" | U2
| style="background-color:#9aff99;" | 任意GPIO
|-
| I2C
| colspan="2" | 任意GPIO
|-
| PWM
| colspan="2" | 任意GPIO
|-
| I2S
| colspan="2" | 任意GPIO
|-
| LCD
| colspan="2" | 任意GPIO
|-
| CAMERA
| colspan="2" | 任意GPIO
|-
| RMT
| colspan="2" | 任意GPIO
|-
| SPI0/1
| colspan="2" | 已用于FLASH与PSRAM
|-
| SPI2/3
| colspan="2" | 任意GPIO
|-
| 脉冲计数器
| colspan="2" | 任意GPIO
|-
| rowspan="8" | USB OTG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| RCV
| GPIO21（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| rowspan="7" | USB Serial/JTAG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| SD/MMC
| colspan="2" | 任意GPIO
|-
| MCPWM
| colspan="2" | 任意GPIO
|-
| TWAI
| colspan="2" | 任意GPIO
|-
| 彩色LED
| colspan="2" | GPIO 48
|}

= 软件 =

== ESP-IDF ==

[[File:Esp-idf-logo.png | 800px]]

ESP-IDF 是乐鑫官方推出的物联网开发框架，支持 Windows、Linux 和 macOS 操作系统。

建议开发者通过集成开发环境 (IDE) 安装 ESP-IDF:

* [https://github.com/espressif/idf-eclipse-plugin/blob/master/README_CN.md GitHub: ESP-IDF Eclipse 插件安装与使用指南]
* [https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension ESP-IDF VSCode 插件] | [https://github.com/espressif/vscode-esp-idf-extension/blob/master/docs/tutorial/toc.md GitHub: 安装与使用指南] | [https://www.bilibili.com/video/BV17p4y167uN bilibili：ESP-IDF VSCode 插件快速操作指南]

或者根据操作系统选择对应的手动安装流程:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/windows-setup.html Windows 平台工具链的标准设置]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/linux-macos-setup.html Linux 和 macOS 平台工具链的标准设置]

API:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/index.html#api API 参考]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-guides/index.html#api API 指南]

为了使你的BPI-Leaf-S3开发板可以通过USB-CDC刷写FLASH，需要设置开发板为固件下载模式。

有两种操作方法：

1.通过USB连接到电脑，按住BOOT键，再按一下RESET键并松开，最后松开BOOT键。

2.在断开供电的条件下按住BOOT键，再通过USB连接到电脑，最后松开BOOT键。

需要在设备管理器中确认接口，固件下载模式与普通模式下的接口序号可能是不一样的。

== MicroPython ==

[[File:Mircopython.png | 800px]]

MicroPython实现了大部分Python 3 特性和语法，易学易上手，验证程序效果无需编译直接下载进芯片运行。

无论是否有编程基础，MicroPython的上手难度绝对远低于其他编程语言，其代码易读性高，且开源社区有多年积累的丰富资源，就如同Python一样拥有极强的生命力与应用价值。

* '''[https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/tree/main/Example/MicroPython-zh#1%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B GitHub: MicroPython快速上手]'''

* [[ micropython_运行环境搭建 | MicroPython运行环境搭建(Thonny IDE) ]]

* [[ micropython_固件下载与烧录 | MicroPython固件下载与烧录 ]]

== Arduino ==

[[File:Arduino_logo_1200x350.png | 800px]]

Arduino 是一个开源嵌入式软硬件开发平台，用来供用户制作可交互式的嵌入式项目。

* [https://www.arduino.cc/en/software Arduino IDE 下载地址] | [https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html#installing 安装并配置Arduino-ESP32运行环境]
* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/Example/Arduino GitHub: BPI-Leaf-S3 Arduino快速上手]
* [https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html#apis Arduino-ESP32 APIs]

= 资料与资源 =

=样品购买=

* 官方速卖通:
* 官方淘宝:
* OEM&OEM 定制服务： sales@banana-pi.com

BPI-PicoW-S3 开发板

2022-09-21T01:57:14Z

Qubot: /* BPI-Pico-S3 与 Rraspberry Pi PicoW开发板对比 */

[[en:BPI-PicoW-S3]]

= 介绍 =
Preparing...

[[File:Smart-01-03.gif|thumb|[[BPI-Smart ]]with ESP8266]]
[[File:Webduino_gif.gif|thumb|[[BPI-Bit]] with ESP32]]
[[File:BPI-AI_1.JPG|thumb|[[BPI-AI]] Kendryte K210 RISC-V]]
[[File:ESP32_6.JPG|thumb|[[BPI-UNO32]] with ESP32 design]]

== 关键特性 ==

* ESP32-S3，Xtensa® 32 bit LX7
* 片外 PSRAM , FLASH
* Ultra-low power 10uA
* 2.4G WIFI ，Bluetooth 5 ，Bluetooth mesh
* GPIO , ADC , TOUCH , PWM , I2C , SPI , RMT , I2S , UART , LCD，CAMERA ，USB , JTAG
* 1 * microUSB
* 1 * 全彩色LED

== BPI-PicoW-S3 与 BPI-Leaf-S3 Rraspberry Pi PicoW开发板对比 ==
Preparing...
{| class="wikitable"
|- style="font-weight:bold;"
! 开发板
! BPI-PicoW-S3
! BPI-Leaf-S3
! ESP32-S3-DevKitC-1
|-
| 引出GPIO
| 27
| 36
| 36
|-
| 3.3v管脚
| 1
| 2
| 2
|-
| 5v管脚
| 2
| 1
| 1
|-
| GND管脚
| 8
| 4
| 4
|-
| 全彩LED灯
| 1 on GPIO48
| 1 on GPIO48
| 1 on GPIO48
|-
| 芯片直连USB
| MicroUSB接口x1
| Type-C USB接口x1
| MicroUSB接口x1
|-
| UART TTL转USB
| 无
| 无
| CP2102-MicroUSB接口x1
|-
| 外接电池连接座
| 无
| 3.7v锂电池供电接口
| 无
|-
| 电池充电
| 无
| 500mA充电
| 无
|-
| I²C 4pin连接座
| 无
| 1
| 无
|}

== Espressif ESP32-S3 ==

ESP32-S3 是一款集成 2.4 GHz Wi-Fi 和 Bluetooth 5 (LE) 的 MCU 芯片，支持远距离模式 (Long Range)。ESP32-S3 搭载 Xtensa® 32 位 LX7 双核处理器，主频高达 240 MHz，内置 512 KB SRAM (TCM)，具有 45 个可编程 GPIO 管脚和丰富的通信接口。ESP32-S3 支持更大容量的高速 Octal SPI flash 和片外 RAM，支持用户配置数据缓存与指令缓存。

以下是ESP32-S3芯片重要功能的描述。

* '''支持Wi-Fi + Bluetooth 5 (LE) 无线连接''': ESP32-S3 集成 2.4 GHz Wi-Fi (802.11 b/g/n)，支持 40 MHz 带宽；其低功耗蓝牙子系统支持 Bluetooth 5 (LE) 和 Bluetooth Mesh，可通过 Coded PHY 与广播扩展实现远距离通信。它还支持 2 Mbps PHY，用于提高传输速度和数据吞吐量。ESP32-S3 的 Wi-Fi 和 Bluetooth LE 射频性能优越，在高温下也能稳定工作。

* '''支持 AI 加速''': ESP32-S3 MCU 增加了用于加速神经网络计算和信号处理等工作的向量指令 (vector instructions)。AI 开发者们通过 ESP-DSP 和 ESP-NN 库使用这些向量指令，可以实现高性能的图像识别、语音唤醒和识别等应用。

* '''丰富的 IO 接口''': ESP32-S3 拥有 45 个可编程 GPIO 以及 SPI、I2S、I2C、PWM、RMT、ADC、UART、SD/MMC 主机控制器和 TWAITM 控制器等常用外设接口。其中的 14 个 GPIO 可被配置为 HMI 交互的电容触摸输入端。此外，ESP32-S3 搭载了超低功耗协处理器 (ULP)，支持多种低功耗模式，广泛适用于各类低功耗应用场景。

* '''完善的安全机制''': ESP32-S3 为物联网设备提供了完善的安全机制和保护措施，防止各类恶意攻击和威胁。它支持基于 AES-XTS 算法的 flash 加密、基于 RSA 算法的安全启动、数字签名和 HMAC。ESP32-S3 还新增了一个“世界控制器 (World Controller)”模块，提供了两个互不干扰的执行环境，实现可信执行环境或权限分离机制。

= 硬件 =

== 硬件接口示意图 ==

[[File:BPI-PicoW-S3-V0.4-IO.png|800px]]

== 硬件规格 ==

{| class="wikitable"
|-
! colspan="2" style="background-color:#ffcb2f;" | BPI-PicoW-S3 规格表
|-
| SoC主控芯片
| ESP32-S3，Xtensa® 32 位 LX7 双核处理器
|-
| 主频
| 240MHz MAX
|-
| 工作温度
| -40℃~+85℃
|-
| 片上 ROM
| 384 KB
|-
| 片上 SRAM
| 320 KB
|-
| 板载 FLASH ROM
| 2MB
|-
| 片上外设PSRAM
| 8MB
|-
| WIFI
| IEEE 802.11 b/g/n ，2.4Ghz频带，150Mbps
|-
| 蓝牙
| Bluetooth 5 ，Bluetooth mesh
|-
| GPIO
| BPI-PicoW-S3已引出27个可用GPIO
|-
| ADC
| 2 × 12 位 SAR ADC，支持 18 个模拟通道输入
|-
| TOUCH 电容式触摸传感器
| 14
|-
| SPI
| 4
|-
| I2C
| 2，支持主机或从机模式
|-
| I2S
| 2，串行立体声数据的输入输出
|-
| LCD
| 1，支持 8 位 ~16 位并行 RGB、I8080、MOTO6800 接口
|-
| CAMERA
| 1，支持 8 位 ~16 位 DVP 图像传感器接口
|-
| UART
| 3 ，支持异步通信（RS232 和RS485）和 IrDA
|-
| PWM
| 8 路独立通道，14位精度
|-
| MCPWM
| 2
|-
| USB
| 1 × 全速USB 2.0 OTG，Type-C母口
|-
| USB Serial/JTAG 控制器
| 1，USB 全速标准，CDC-ACM ，JTAG
|-
| 温度传感器
| 1，测量范围为–20 °C 到 110 °C，用于监测芯片内部温度
|-
| SD/MMC
| 1 × SDIO主机接口，具有2个卡槽，支持SD卡3.0和3.01，SDIO 3.0，CE-ATA 1.1，MMC 4.41，eMMC 4.5和4.51
|-
| TWAI® 控制器
| 1 ，兼容 ISO11898-1（CAN 规范 2.0）
|-
| 通用 DMA 控制器
| 5 个接收通道和 5 个发送通道
|-
| RMT
| 4 通道发射，4通道接收，共享 384 x 32-bit 的 RAM
|-
| 脉冲计数器
| 4个脉冲计数控制器（单元），每个单元有2个独立的通道
|-
| 定时器
| 4 × 54 位通用定时器，16 位时钟预分频器，1 × 52 位系统定时器，3 × 看门狗定时器
|-
| 外部晶振
| 40Mhz
|-
| RTC 和低功耗管理
| 电源管理单元 (PMU)+ 超低功耗协处理器 (ULP)
|-
| 低功耗电流
| 10uA
|-
| 工作电压
| 3.3V
|-
| 输入电压
| 3.3V~5.5V
|-
| 最大放电电流
| 2A@3.3V DC/DC
|-
| USB充电
| 支持
|-
| 最大充电电流
| 500mA
|-
| 可控全彩色LED
| 1
|}

== 硬件尺寸 ==

[[File:BPI-Pico-S3-board-dimension.png|800px]]

{| class="wikitable"
|-
! colspan="2" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 尺寸表
|-
| 管脚间距
| 2.54mm
|-
| 安装孔间距
| 11.4mm/ 47mm
|-
| 安装孔尺寸
| 内径2.1mm/外径3.4mm
|-
| 主板尺寸
| 21 × 51.88(mm)/0.83 x 2.04(inches)
|-
| 板厚
| 1.2mm
|}

管脚间距兼容万能板（洞洞板、点阵板），面包板，便于调试应用。

== 外设GPIO管脚分配 ==

{| class="wikitable"
|-
! colspan="3" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 外设GPIO管脚分配
|- style="background-color:#32cb00;"
| 外设接口
| 信号
| 管脚
|-
| rowspan="2" | ADC
| ADC1_CH0~9
| GPIO 1~10
|-
| ADC2_CH0~9
| GPIO 11~20
|-
| 触摸传感器
| TOUCH1~14
| GPIO 1~14
|-
| rowspan="4"|JTAG
| MTCK
| GPIO 39
|-
| MTDO
| GPIO 40
|-
| MTDI
| GPIO 41
|-
| MTMS
| GPIO 42
|-
| rowspan="14" | UART
| colspan="2" style="font-style:italic;color:#9b9b9b;" | 默认分配管脚，可重定义为任意GPIO
|-
| style="background-color:#ffffc7;" | U0RXD_in
| style="background-color:#ffffc7;" | GPIO 44
|-
| U0CTS_in
| GPIO 16
|-
| U0DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U0TXD_out
| style="background-color:#ffffc7;" | GPIO43
|-
| U0RTS_out
| GPIO 15
|-
| U0DTR_out
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1RXD_in
| style="background-color:#ffffc7;" | GPIO 18
|-
| U1CTS_in
| GPIO 20
|-
| U1DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1TXD_out
| style="background-color:#ffffc7;" | GPIO 17
|-
| U1RTS_out
| GPIO 19
|-
| U1DTR_out
| 任意GPIO
|-
| style="background-color:#9aff99;" | U2
| style="background-color:#9aff99;" | 任意GPIO
|-
| I2C
| colspan="2" | 任意GPIO
|-
| PWM
| colspan="2" | 任意GPIO
|-
| I2S
| colspan="2" | 任意GPIO
|-
| LCD
| colspan="2" | 任意GPIO
|-
| CAMERA
| colspan="2" | 任意GPIO
|-
| RMT
| colspan="2" | 任意GPIO
|-
| SPI0/1
| colspan="2" | 已用于FLASH与PSRAM
|-
| SPI2/3
| colspan="2" | 任意GPIO
|-
| 脉冲计数器
| colspan="2" | 任意GPIO
|-
| rowspan="8" | USB OTG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| RCV
| GPIO21（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| rowspan="7" | USB Serial/JTAG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| SD/MMC
| colspan="2" | 任意GPIO
|-
| MCPWM
| colspan="2" | 任意GPIO
|-
| TWAI
| colspan="2" | 任意GPIO
|-
| 彩色LED
| colspan="2" | GPIO 48
|}

= 软件 =

== ESP-IDF ==

[[File:Esp-idf-logo.png | 800px]]

ESP-IDF 是乐鑫官方推出的物联网开发框架，支持 Windows、Linux 和 macOS 操作系统。

建议开发者通过集成开发环境 (IDE) 安装 ESP-IDF:

* [https://github.com/espressif/idf-eclipse-plugin/blob/master/README_CN.md GitHub: ESP-IDF Eclipse 插件安装与使用指南]
* [https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension ESP-IDF VSCode 插件] | [https://github.com/espressif/vscode-esp-idf-extension/blob/master/docs/tutorial/toc.md GitHub: 安装与使用指南] | [https://www.bilibili.com/video/BV17p4y167uN bilibili：ESP-IDF VSCode 插件快速操作指南]

或者根据操作系统选择对应的手动安装流程:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/windows-setup.html Windows 平台工具链的标准设置]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/linux-macos-setup.html Linux 和 macOS 平台工具链的标准设置]

API:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/index.html#api API 参考]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-guides/index.html#api API 指南]

为了使你的BPI-Leaf-S3开发板可以通过USB-CDC刷写FLASH，需要设置开发板为固件下载模式。

有两种操作方法：

1.通过USB连接到电脑，按住BOOT键，再按一下RESET键并松开，最后松开BOOT键。

2.在断开供电的条件下按住BOOT键，再通过USB连接到电脑，最后松开BOOT键。

需要在设备管理器中确认接口，固件下载模式与普通模式下的接口序号可能是不一样的。

== MicroPython ==

[[File:Mircopython.png | 800px]]

MicroPython实现了大部分Python 3 特性和语法，易学易上手，验证程序效果无需编译直接下载进芯片运行。

无论是否有编程基础，MicroPython的上手难度绝对远低于其他编程语言，其代码易读性高，且开源社区有多年积累的丰富资源，就如同Python一样拥有极强的生命力与应用价值。

* '''[https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/tree/main/Example/MicroPython-zh#1%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B GitHub: MicroPython快速上手]'''

* [[ micropython_运行环境搭建 | MicroPython运行环境搭建(Thonny IDE) ]]

* [[ micropython_固件下载与烧录 | MicroPython固件下载与烧录 ]]

== Arduino ==

[[File:Arduino_logo_1200x350.png | 800px]]

Arduino 是一个开源嵌入式软硬件开发平台，用来供用户制作可交互式的嵌入式项目。

* [https://www.arduino.cc/en/software Arduino IDE 下载地址] | [https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html#installing 安装并配置Arduino-ESP32运行环境]
* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/Example/Arduino GitHub: BPI-Leaf-S3 Arduino快速上手]
* [https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html#apis Arduino-ESP32 APIs]

= 资料与资源 =

=样品购买=

* 官方速卖通:
* 官方淘宝:
* OEM&OEM 定制服务： sales@banana-pi.com

BPI-PicoW-S3 开发板

2022-09-21T01:49:04Z

Qubot: /* 外设GPIO管脚分配 */

[[en:BPI-PicoW-S3]]

= 介绍 =
Preparing...

[[File:Smart-01-03.gif|thumb|[[BPI-Smart ]]with ESP8266]]
[[File:Webduino_gif.gif|thumb|[[BPI-Bit]] with ESP32]]
[[File:BPI-AI_1.JPG|thumb|[[BPI-AI]] Kendryte K210 RISC-V]]
[[File:ESP32_6.JPG|thumb|[[BPI-UNO32]] with ESP32 design]]

== 关键特性 ==

* ESP32-S3，Xtensa® 32 bit LX7
* 片外 PSRAM , FLASH
* Ultra-low power 10uA
* 2.4G WIFI ，Bluetooth 5 ，Bluetooth mesh
* GPIO , ADC , TOUCH , PWM , I2C , SPI , RMT , I2S , UART , LCD，CAMERA ，USB , JTAG
* 1 * microUSB
* 1 * 全彩色LED

== BPI-Pico-S3 与 Rraspberry Pi PicoW开发板对比 ==
Preparing...
{| class="wikitable"
|- style="font-weight:bold;"
! 开发板
! BPI-Leaf-S3
! ESP32-S3-DevKitC-1
|-
| 引出GPIO
| 36
| 36
|-
| 3.3v管脚
| 2
| 2
|-
| 5v管脚
| 1
| 1
|-
| GND管脚
| 4
| 4
|-
| 全彩LED灯
| 1 on GPIO48
| 1 on GPIO48
|-
| 芯片直连USB
| Type-C USB接口x1
| MicroUSB接口x1
|-
| UART TTL转USB
| 无
| CP2102-MicroUSB接口x1
|-
| 外接电池连接座
| 3.7v锂电池供电接口
| 无
|-
| 电池充电
| 500mA充电
| 无
|-
| I²C 4pin连接座
| 1
| 无
|}

== Espressif ESP32-S3 ==

ESP32-S3 是一款集成 2.4 GHz Wi-Fi 和 Bluetooth 5 (LE) 的 MCU 芯片，支持远距离模式 (Long Range)。ESP32-S3 搭载 Xtensa® 32 位 LX7 双核处理器，主频高达 240 MHz，内置 512 KB SRAM (TCM)，具有 45 个可编程 GPIO 管脚和丰富的通信接口。ESP32-S3 支持更大容量的高速 Octal SPI flash 和片外 RAM，支持用户配置数据缓存与指令缓存。

以下是ESP32-S3芯片重要功能的描述。

* '''支持Wi-Fi + Bluetooth 5 (LE) 无线连接''': ESP32-S3 集成 2.4 GHz Wi-Fi (802.11 b/g/n)，支持 40 MHz 带宽；其低功耗蓝牙子系统支持 Bluetooth 5 (LE) 和 Bluetooth Mesh，可通过 Coded PHY 与广播扩展实现远距离通信。它还支持 2 Mbps PHY，用于提高传输速度和数据吞吐量。ESP32-S3 的 Wi-Fi 和 Bluetooth LE 射频性能优越，在高温下也能稳定工作。

* '''支持 AI 加速''': ESP32-S3 MCU 增加了用于加速神经网络计算和信号处理等工作的向量指令 (vector instructions)。AI 开发者们通过 ESP-DSP 和 ESP-NN 库使用这些向量指令，可以实现高性能的图像识别、语音唤醒和识别等应用。

* '''丰富的 IO 接口''': ESP32-S3 拥有 45 个可编程 GPIO 以及 SPI、I2S、I2C、PWM、RMT、ADC、UART、SD/MMC 主机控制器和 TWAITM 控制器等常用外设接口。其中的 14 个 GPIO 可被配置为 HMI 交互的电容触摸输入端。此外，ESP32-S3 搭载了超低功耗协处理器 (ULP)，支持多种低功耗模式，广泛适用于各类低功耗应用场景。

* '''完善的安全机制''': ESP32-S3 为物联网设备提供了完善的安全机制和保护措施，防止各类恶意攻击和威胁。它支持基于 AES-XTS 算法的 flash 加密、基于 RSA 算法的安全启动、数字签名和 HMAC。ESP32-S3 还新增了一个“世界控制器 (World Controller)”模块，提供了两个互不干扰的执行环境，实现可信执行环境或权限分离机制。

= 硬件 =

== 硬件接口示意图 ==

[[File:BPI-PicoW-S3-V0.4-IO.png|800px]]

== 硬件规格 ==

{| class="wikitable"
|-
! colspan="2" style="background-color:#ffcb2f;" | BPI-PicoW-S3 规格表
|-
| SoC主控芯片
| ESP32-S3，Xtensa® 32 位 LX7 双核处理器
|-
| 主频
| 240MHz MAX
|-
| 工作温度
| -40℃~+85℃
|-
| 片上 ROM
| 384 KB
|-
| 片上 SRAM
| 320 KB
|-
| 板载 FLASH ROM
| 2MB
|-
| 片上外设PSRAM
| 8MB
|-
| WIFI
| IEEE 802.11 b/g/n ，2.4Ghz频带，150Mbps
|-
| 蓝牙
| Bluetooth 5 ，Bluetooth mesh
|-
| GPIO
| BPI-PicoW-S3已引出27个可用GPIO
|-
| ADC
| 2 × 12 位 SAR ADC，支持 18 个模拟通道输入
|-
| TOUCH 电容式触摸传感器
| 14
|-
| SPI
| 4
|-
| I2C
| 2，支持主机或从机模式
|-
| I2S
| 2，串行立体声数据的输入输出
|-
| LCD
| 1，支持 8 位 ~16 位并行 RGB、I8080、MOTO6800 接口
|-
| CAMERA
| 1，支持 8 位 ~16 位 DVP 图像传感器接口
|-
| UART
| 3 ，支持异步通信（RS232 和RS485）和 IrDA
|-
| PWM
| 8 路独立通道，14位精度
|-
| MCPWM
| 2
|-
| USB
| 1 × 全速USB 2.0 OTG，Type-C母口
|-
| USB Serial/JTAG 控制器
| 1，USB 全速标准，CDC-ACM ，JTAG
|-
| 温度传感器
| 1，测量范围为–20 °C 到 110 °C，用于监测芯片内部温度
|-
| SD/MMC
| 1 × SDIO主机接口，具有2个卡槽，支持SD卡3.0和3.01，SDIO 3.0，CE-ATA 1.1，MMC 4.41，eMMC 4.5和4.51
|-
| TWAI® 控制器
| 1 ，兼容 ISO11898-1（CAN 规范 2.0）
|-
| 通用 DMA 控制器
| 5 个接收通道和 5 个发送通道
|-
| RMT
| 4 通道发射，4通道接收，共享 384 x 32-bit 的 RAM
|-
| 脉冲计数器
| 4个脉冲计数控制器（单元），每个单元有2个独立的通道
|-
| 定时器
| 4 × 54 位通用定时器，16 位时钟预分频器，1 × 52 位系统定时器，3 × 看门狗定时器
|-
| 外部晶振
| 40Mhz
|-
| RTC 和低功耗管理
| 电源管理单元 (PMU)+ 超低功耗协处理器 (ULP)
|-
| 低功耗电流
| 10uA
|-
| 工作电压
| 3.3V
|-
| 输入电压
| 3.3V~5.5V
|-
| 最大放电电流
| 2A@3.3V DC/DC
|-
| USB充电
| 支持
|-
| 最大充电电流
| 500mA
|-
| 可控全彩色LED
| 1
|}

== 硬件尺寸 ==

[[File:BPI-Pico-S3-board-dimension.png|800px]]

{| class="wikitable"
|-
! colspan="2" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 尺寸表
|-
| 管脚间距
| 2.54mm
|-
| 安装孔间距
| 11.4mm/ 47mm
|-
| 安装孔尺寸
| 内径2.1mm/外径3.4mm
|-
| 主板尺寸
| 21 × 51.88(mm)/0.83 x 2.04(inches)
|-
| 板厚
| 1.2mm
|}

管脚间距兼容万能板（洞洞板、点阵板），面包板，便于调试应用。

== 外设GPIO管脚分配 ==

{| class="wikitable"
|-
! colspan="3" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 外设GPIO管脚分配
|- style="background-color:#32cb00;"
| 外设接口
| 信号
| 管脚
|-
| rowspan="2" | ADC
| ADC1_CH0~9
| GPIO 1~10
|-
| ADC2_CH0~9
| GPIO 11~20
|-
| 触摸传感器
| TOUCH1~14
| GPIO 1~14
|-
| rowspan="4"|JTAG
| MTCK
| GPIO 39
|-
| MTDO
| GPIO 40
|-
| MTDI
| GPIO 41
|-
| MTMS
| GPIO 42
|-
| rowspan="14" | UART
| colspan="2" style="font-style:italic;color:#9b9b9b;" | 默认分配管脚，可重定义为任意GPIO
|-
| style="background-color:#ffffc7;" | U0RXD_in
| style="background-color:#ffffc7;" | GPIO 44
|-
| U0CTS_in
| GPIO 16
|-
| U0DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U0TXD_out
| style="background-color:#ffffc7;" | GPIO43
|-
| U0RTS_out
| GPIO 15
|-
| U0DTR_out
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1RXD_in
| style="background-color:#ffffc7;" | GPIO 18
|-
| U1CTS_in
| GPIO 20
|-
| U1DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1TXD_out
| style="background-color:#ffffc7;" | GPIO 17
|-
| U1RTS_out
| GPIO 19
|-
| U1DTR_out
| 任意GPIO
|-
| style="background-color:#9aff99;" | U2
| style="background-color:#9aff99;" | 任意GPIO
|-
| I2C
| colspan="2" | 任意GPIO
|-
| PWM
| colspan="2" | 任意GPIO
|-
| I2S
| colspan="2" | 任意GPIO
|-
| LCD
| colspan="2" | 任意GPIO
|-
| CAMERA
| colspan="2" | 任意GPIO
|-
| RMT
| colspan="2" | 任意GPIO
|-
| SPI0/1
| colspan="2" | 已用于FLASH与PSRAM
|-
| SPI2/3
| colspan="2" | 任意GPIO
|-
| 脉冲计数器
| colspan="2" | 任意GPIO
|-
| rowspan="8" | USB OTG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| RCV
| GPIO21（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| rowspan="7" | USB Serial/JTAG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| SD/MMC
| colspan="2" | 任意GPIO
|-
| MCPWM
| colspan="2" | 任意GPIO
|-
| TWAI
| colspan="2" | 任意GPIO
|-
| 彩色LED
| colspan="2" | GPIO 48
|}

= 软件 =

== ESP-IDF ==

[[File:Esp-idf-logo.png | 800px]]

ESP-IDF 是乐鑫官方推出的物联网开发框架，支持 Windows、Linux 和 macOS 操作系统。

建议开发者通过集成开发环境 (IDE) 安装 ESP-IDF:

* [https://github.com/espressif/idf-eclipse-plugin/blob/master/README_CN.md GitHub: ESP-IDF Eclipse 插件安装与使用指南]
* [https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension ESP-IDF VSCode 插件] | [https://github.com/espressif/vscode-esp-idf-extension/blob/master/docs/tutorial/toc.md GitHub: 安装与使用指南] | [https://www.bilibili.com/video/BV17p4y167uN bilibili：ESP-IDF VSCode 插件快速操作指南]

或者根据操作系统选择对应的手动安装流程:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/windows-setup.html Windows 平台工具链的标准设置]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/linux-macos-setup.html Linux 和 macOS 平台工具链的标准设置]

API:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/index.html#api API 参考]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-guides/index.html#api API 指南]

为了使你的BPI-Leaf-S3开发板可以通过USB-CDC刷写FLASH，需要设置开发板为固件下载模式。

有两种操作方法：

1.通过USB连接到电脑，按住BOOT键，再按一下RESET键并松开，最后松开BOOT键。

2.在断开供电的条件下按住BOOT键，再通过USB连接到电脑，最后松开BOOT键。

需要在设备管理器中确认接口，固件下载模式与普通模式下的接口序号可能是不一样的。

== MicroPython ==

[[File:Mircopython.png | 800px]]

MicroPython实现了大部分Python 3 特性和语法，易学易上手，验证程序效果无需编译直接下载进芯片运行。

无论是否有编程基础，MicroPython的上手难度绝对远低于其他编程语言，其代码易读性高，且开源社区有多年积累的丰富资源，就如同Python一样拥有极强的生命力与应用价值。

* '''[https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/tree/main/Example/MicroPython-zh#1%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B GitHub: MicroPython快速上手]'''

* [[ micropython_运行环境搭建 | MicroPython运行环境搭建(Thonny IDE) ]]

* [[ micropython_固件下载与烧录 | MicroPython固件下载与烧录 ]]

== Arduino ==

[[File:Arduino_logo_1200x350.png | 800px]]

Arduino 是一个开源嵌入式软硬件开发平台，用来供用户制作可交互式的嵌入式项目。

* [https://www.arduino.cc/en/software Arduino IDE 下载地址] | [https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html#installing 安装并配置Arduino-ESP32运行环境]
* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/Example/Arduino GitHub: BPI-Leaf-S3 Arduino快速上手]
* [https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html#apis Arduino-ESP32 APIs]

= 资料与资源 =

=样品购买=

* 官方速卖通:
* 官方淘宝:
* OEM&OEM 定制服务： sales@banana-pi.com

BPI-PicoW-S3 开发板

2022-09-21T01:48:33Z

Qubot: /* 硬件尺寸 */

[[en:BPI-PicoW-S3]]

= 介绍 =
Preparing...

[[File:Smart-01-03.gif|thumb|[[BPI-Smart ]]with ESP8266]]
[[File:Webduino_gif.gif|thumb|[[BPI-Bit]] with ESP32]]
[[File:BPI-AI_1.JPG|thumb|[[BPI-AI]] Kendryte K210 RISC-V]]
[[File:ESP32_6.JPG|thumb|[[BPI-UNO32]] with ESP32 design]]

== 关键特性 ==

* ESP32-S3，Xtensa® 32 bit LX7
* 片外 PSRAM , FLASH
* Ultra-low power 10uA
* 2.4G WIFI ，Bluetooth 5 ，Bluetooth mesh
* GPIO , ADC , TOUCH , PWM , I2C , SPI , RMT , I2S , UART , LCD，CAMERA ，USB , JTAG
* 1 * microUSB
* 1 * 全彩色LED

== BPI-Pico-S3 与 Rraspberry Pi PicoW开发板对比 ==
Preparing...
{| class="wikitable"
|- style="font-weight:bold;"
! 开发板
! BPI-Leaf-S3
! ESP32-S3-DevKitC-1
|-
| 引出GPIO
| 36
| 36
|-
| 3.3v管脚
| 2
| 2
|-
| 5v管脚
| 1
| 1
|-
| GND管脚
| 4
| 4
|-
| 全彩LED灯
| 1 on GPIO48
| 1 on GPIO48
|-
| 芯片直连USB
| Type-C USB接口x1
| MicroUSB接口x1
|-
| UART TTL转USB
| 无
| CP2102-MicroUSB接口x1
|-
| 外接电池连接座
| 3.7v锂电池供电接口
| 无
|-
| 电池充电
| 500mA充电
| 无
|-
| I²C 4pin连接座
| 1
| 无
|}

== Espressif ESP32-S3 ==

ESP32-S3 是一款集成 2.4 GHz Wi-Fi 和 Bluetooth 5 (LE) 的 MCU 芯片，支持远距离模式 (Long Range)。ESP32-S3 搭载 Xtensa® 32 位 LX7 双核处理器，主频高达 240 MHz，内置 512 KB SRAM (TCM)，具有 45 个可编程 GPIO 管脚和丰富的通信接口。ESP32-S3 支持更大容量的高速 Octal SPI flash 和片外 RAM，支持用户配置数据缓存与指令缓存。

以下是ESP32-S3芯片重要功能的描述。

* '''支持Wi-Fi + Bluetooth 5 (LE) 无线连接''': ESP32-S3 集成 2.4 GHz Wi-Fi (802.11 b/g/n)，支持 40 MHz 带宽；其低功耗蓝牙子系统支持 Bluetooth 5 (LE) 和 Bluetooth Mesh，可通过 Coded PHY 与广播扩展实现远距离通信。它还支持 2 Mbps PHY，用于提高传输速度和数据吞吐量。ESP32-S3 的 Wi-Fi 和 Bluetooth LE 射频性能优越，在高温下也能稳定工作。

* '''支持 AI 加速''': ESP32-S3 MCU 增加了用于加速神经网络计算和信号处理等工作的向量指令 (vector instructions)。AI 开发者们通过 ESP-DSP 和 ESP-NN 库使用这些向量指令，可以实现高性能的图像识别、语音唤醒和识别等应用。

* '''丰富的 IO 接口''': ESP32-S3 拥有 45 个可编程 GPIO 以及 SPI、I2S、I2C、PWM、RMT、ADC、UART、SD/MMC 主机控制器和 TWAITM 控制器等常用外设接口。其中的 14 个 GPIO 可被配置为 HMI 交互的电容触摸输入端。此外，ESP32-S3 搭载了超低功耗协处理器 (ULP)，支持多种低功耗模式，广泛适用于各类低功耗应用场景。

* '''完善的安全机制''': ESP32-S3 为物联网设备提供了完善的安全机制和保护措施，防止各类恶意攻击和威胁。它支持基于 AES-XTS 算法的 flash 加密、基于 RSA 算法的安全启动、数字签名和 HMAC。ESP32-S3 还新增了一个“世界控制器 (World Controller)”模块，提供了两个互不干扰的执行环境，实现可信执行环境或权限分离机制。

= 硬件 =

== 硬件接口示意图 ==

[[File:BPI-PicoW-S3-V0.4-IO.png|800px]]

== 硬件规格 ==

{| class="wikitable"
|-
! colspan="2" style="background-color:#ffcb2f;" | BPI-PicoW-S3 规格表
|-
| SoC主控芯片
| ESP32-S3，Xtensa® 32 位 LX7 双核处理器
|-
| 主频
| 240MHz MAX
|-
| 工作温度
| -40℃~+85℃
|-
| 片上 ROM
| 384 KB
|-
| 片上 SRAM
| 320 KB
|-
| 板载 FLASH ROM
| 2MB
|-
| 片上外设PSRAM
| 8MB
|-
| WIFI
| IEEE 802.11 b/g/n ，2.4Ghz频带，150Mbps
|-
| 蓝牙
| Bluetooth 5 ，Bluetooth mesh
|-
| GPIO
| BPI-PicoW-S3已引出27个可用GPIO
|-
| ADC
| 2 × 12 位 SAR ADC，支持 18 个模拟通道输入
|-
| TOUCH 电容式触摸传感器
| 14
|-
| SPI
| 4
|-
| I2C
| 2，支持主机或从机模式
|-
| I2S
| 2，串行立体声数据的输入输出
|-
| LCD
| 1，支持 8 位 ~16 位并行 RGB、I8080、MOTO6800 接口
|-
| CAMERA
| 1，支持 8 位 ~16 位 DVP 图像传感器接口
|-
| UART
| 3 ，支持异步通信（RS232 和RS485）和 IrDA
|-
| PWM
| 8 路独立通道，14位精度
|-
| MCPWM
| 2
|-
| USB
| 1 × 全速USB 2.0 OTG，Type-C母口
|-
| USB Serial/JTAG 控制器
| 1，USB 全速标准，CDC-ACM ，JTAG
|-
| 温度传感器
| 1，测量范围为–20 °C 到 110 °C，用于监测芯片内部温度
|-
| SD/MMC
| 1 × SDIO主机接口，具有2个卡槽，支持SD卡3.0和3.01，SDIO 3.0，CE-ATA 1.1，MMC 4.41，eMMC 4.5和4.51
|-
| TWAI® 控制器
| 1 ，兼容 ISO11898-1（CAN 规范 2.0）
|-
| 通用 DMA 控制器
| 5 个接收通道和 5 个发送通道
|-
| RMT
| 4 通道发射，4通道接收，共享 384 x 32-bit 的 RAM
|-
| 脉冲计数器
| 4个脉冲计数控制器（单元），每个单元有2个独立的通道
|-
| 定时器
| 4 × 54 位通用定时器，16 位时钟预分频器，1 × 52 位系统定时器，3 × 看门狗定时器
|-
| 外部晶振
| 40Mhz
|-
| RTC 和低功耗管理
| 电源管理单元 (PMU)+ 超低功耗协处理器 (ULP)
|-
| 低功耗电流
| 10uA
|-
| 工作电压
| 3.3V
|-
| 输入电压
| 3.3V~5.5V
|-
| 最大放电电流
| 2A@3.3V DC/DC
|-
| USB充电
| 支持
|-
| 最大充电电流
| 500mA
|-
| 可控全彩色LED
| 1
|}

== 硬件尺寸 ==

[[File:BPI-Pico-S3-board-dimension.png|800px]]

{| class="wikitable"
|-
! colspan="2" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 尺寸表
|-
| 管脚间距
| 2.54mm
|-
| 安装孔间距
| 11.4mm/ 47mm
|-
| 安装孔尺寸
| 内径2.1mm/外径3.4mm
|-
| 主板尺寸
| 21 × 51.88(mm)/0.83 x 2.04(inches)
|-
| 板厚
| 1.2mm
|}

管脚间距兼容万能板（洞洞板、点阵板），面包板，便于调试应用。

== 外设GPIO管脚分配 ==

{| class="wikitable"
|-
! colspan="3" style=" background-color:#ffcb2f;" | BPI-Leaf-S3 外设GPIO管脚分配
|- style="background-color:#32cb00;"
| 外设接口
| 信号
| 管脚
|-
| rowspan="2" | ADC
| ADC1_CH0~9
| GPIO 1~10
|-
| ADC2_CH0~9
| GPIO 11~20
|-
| 触摸传感器
| TOUCH1~14
| GPIO 1~14
|-
| rowspan="4"|JTAG
| MTCK
| GPIO 39
|-
| MTDO
| GPIO 40
|-
| MTDI
| GPIO 41
|-
| MTMS
| GPIO 42
|-
| rowspan="14" | UART
| colspan="2" style="font-style:italic;color:#9b9b9b;" | 默认分配管脚，可重定义为任意GPIO
|-
| style="background-color:#ffffc7;" | U0RXD_in
| style="background-color:#ffffc7;" | GPIO 44
|-
| U0CTS_in
| GPIO 16
|-
| U0DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U0TXD_out
| style="background-color:#ffffc7;" | GPIO43
|-
| U0RTS_out
| GPIO 15
|-
| U0DTR_out
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1RXD_in
| style="background-color:#ffffc7;" | GPIO 18
|-
| U1CTS_in
| GPIO 20
|-
| U1DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1TXD_out
| style="background-color:#ffffc7;" | GPIO 17
|-
| U1RTS_out
| GPIO 19
|-
| U1DTR_out
| 任意GPIO
|-
| style="background-color:#9aff99;" | U2
| style="background-color:#9aff99;" | 任意GPIO
|-
| I2C
| colspan="2" | 任意GPIO
|-
| PWM
| colspan="2" | 任意GPIO
|-
| I2S
| colspan="2" | 任意GPIO
|-
| LCD
| colspan="2" | 任意GPIO
|-
| CAMERA
| colspan="2" | 任意GPIO
|-
| RMT
| colspan="2" | 任意GPIO
|-
| SPI0/1
| colspan="2" | 已用于FLASH与PSRAM
|-
| SPI2/3
| colspan="2" | 任意GPIO
|-
| 脉冲计数器
| colspan="2" | 任意GPIO
|-
| rowspan="8" | USB OTG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| RCV
| GPIO21（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| rowspan="7" | USB Serial/JTAG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| SD/MMC
| colspan="2" | 任意GPIO
|-
| MCPWM
| colspan="2" | 任意GPIO
|-
| TWAI
| colspan="2" | 任意GPIO
|-
| 彩色LED
| colspan="2" | GPIO 48
|}

= 软件 =

== ESP-IDF ==

[[File:Esp-idf-logo.png | 800px]]

ESP-IDF 是乐鑫官方推出的物联网开发框架，支持 Windows、Linux 和 macOS 操作系统。

建议开发者通过集成开发环境 (IDE) 安装 ESP-IDF:

* [https://github.com/espressif/idf-eclipse-plugin/blob/master/README_CN.md GitHub: ESP-IDF Eclipse 插件安装与使用指南]
* [https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension ESP-IDF VSCode 插件] | [https://github.com/espressif/vscode-esp-idf-extension/blob/master/docs/tutorial/toc.md GitHub: 安装与使用指南] | [https://www.bilibili.com/video/BV17p4y167uN bilibili：ESP-IDF VSCode 插件快速操作指南]

或者根据操作系统选择对应的手动安装流程:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/windows-setup.html Windows 平台工具链的标准设置]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/linux-macos-setup.html Linux 和 macOS 平台工具链的标准设置]

API:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/index.html#api API 参考]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-guides/index.html#api API 指南]

为了使你的BPI-Leaf-S3开发板可以通过USB-CDC刷写FLASH，需要设置开发板为固件下载模式。

有两种操作方法：

1.通过USB连接到电脑，按住BOOT键，再按一下RESET键并松开，最后松开BOOT键。

2.在断开供电的条件下按住BOOT键，再通过USB连接到电脑，最后松开BOOT键。

需要在设备管理器中确认接口，固件下载模式与普通模式下的接口序号可能是不一样的。

== MicroPython ==

[[File:Mircopython.png | 800px]]

MicroPython实现了大部分Python 3 特性和语法，易学易上手，验证程序效果无需编译直接下载进芯片运行。

无论是否有编程基础，MicroPython的上手难度绝对远低于其他编程语言，其代码易读性高，且开源社区有多年积累的丰富资源，就如同Python一样拥有极强的生命力与应用价值。

* '''[https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/tree/main/Example/MicroPython-zh#1%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B GitHub: MicroPython快速上手]'''

* [[ micropython_运行环境搭建 | MicroPython运行环境搭建(Thonny IDE) ]]

* [[ micropython_固件下载与烧录 | MicroPython固件下载与烧录 ]]

== Arduino ==

[[File:Arduino_logo_1200x350.png | 800px]]

Arduino 是一个开源嵌入式软硬件开发平台，用来供用户制作可交互式的嵌入式项目。

* [https://www.arduino.cc/en/software Arduino IDE 下载地址] | [https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html#installing 安装并配置Arduino-ESP32运行环境]
* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/Example/Arduino GitHub: BPI-Leaf-S3 Arduino快速上手]
* [https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html#apis Arduino-ESP32 APIs]

= 资料与资源 =

=样品购买=

* 官方速卖通:
* 官方淘宝:
* OEM&OEM 定制服务： sales@banana-pi.com

BPI-PicoW-S3 开发板

2022-09-21T01:47:56Z

Qubot: /* 硬件尺寸 */

[[en:BPI-PicoW-S3]]

= 介绍 =
Preparing...

[[File:Smart-01-03.gif|thumb|[[BPI-Smart ]]with ESP8266]]
[[File:Webduino_gif.gif|thumb|[[BPI-Bit]] with ESP32]]
[[File:BPI-AI_1.JPG|thumb|[[BPI-AI]] Kendryte K210 RISC-V]]
[[File:ESP32_6.JPG|thumb|[[BPI-UNO32]] with ESP32 design]]

== 关键特性 ==

* ESP32-S3，Xtensa® 32 bit LX7
* 片外 PSRAM , FLASH
* Ultra-low power 10uA
* 2.4G WIFI ，Bluetooth 5 ，Bluetooth mesh
* GPIO , ADC , TOUCH , PWM , I2C , SPI , RMT , I2S , UART , LCD，CAMERA ，USB , JTAG
* 1 * microUSB
* 1 * 全彩色LED

== BPI-Pico-S3 与 Rraspberry Pi PicoW开发板对比 ==
Preparing...
{| class="wikitable"
|- style="font-weight:bold;"
! 开发板
! BPI-Leaf-S3
! ESP32-S3-DevKitC-1
|-
| 引出GPIO
| 36
| 36
|-
| 3.3v管脚
| 2
| 2
|-
| 5v管脚
| 1
| 1
|-
| GND管脚
| 4
| 4
|-
| 全彩LED灯
| 1 on GPIO48
| 1 on GPIO48
|-
| 芯片直连USB
| Type-C USB接口x1
| MicroUSB接口x1
|-
| UART TTL转USB
| 无
| CP2102-MicroUSB接口x1
|-
| 外接电池连接座
| 3.7v锂电池供电接口
| 无
|-
| 电池充电
| 500mA充电
| 无
|-
| I²C 4pin连接座
| 1
| 无
|}

== Espressif ESP32-S3 ==

ESP32-S3 是一款集成 2.4 GHz Wi-Fi 和 Bluetooth 5 (LE) 的 MCU 芯片，支持远距离模式 (Long Range)。ESP32-S3 搭载 Xtensa® 32 位 LX7 双核处理器，主频高达 240 MHz，内置 512 KB SRAM (TCM)，具有 45 个可编程 GPIO 管脚和丰富的通信接口。ESP32-S3 支持更大容量的高速 Octal SPI flash 和片外 RAM，支持用户配置数据缓存与指令缓存。

以下是ESP32-S3芯片重要功能的描述。

* '''支持Wi-Fi + Bluetooth 5 (LE) 无线连接''': ESP32-S3 集成 2.4 GHz Wi-Fi (802.11 b/g/n)，支持 40 MHz 带宽；其低功耗蓝牙子系统支持 Bluetooth 5 (LE) 和 Bluetooth Mesh，可通过 Coded PHY 与广播扩展实现远距离通信。它还支持 2 Mbps PHY，用于提高传输速度和数据吞吐量。ESP32-S3 的 Wi-Fi 和 Bluetooth LE 射频性能优越，在高温下也能稳定工作。

* '''支持 AI 加速''': ESP32-S3 MCU 增加了用于加速神经网络计算和信号处理等工作的向量指令 (vector instructions)。AI 开发者们通过 ESP-DSP 和 ESP-NN 库使用这些向量指令，可以实现高性能的图像识别、语音唤醒和识别等应用。

* '''丰富的 IO 接口''': ESP32-S3 拥有 45 个可编程 GPIO 以及 SPI、I2S、I2C、PWM、RMT、ADC、UART、SD/MMC 主机控制器和 TWAITM 控制器等常用外设接口。其中的 14 个 GPIO 可被配置为 HMI 交互的电容触摸输入端。此外，ESP32-S3 搭载了超低功耗协处理器 (ULP)，支持多种低功耗模式，广泛适用于各类低功耗应用场景。

* '''完善的安全机制''': ESP32-S3 为物联网设备提供了完善的安全机制和保护措施，防止各类恶意攻击和威胁。它支持基于 AES-XTS 算法的 flash 加密、基于 RSA 算法的安全启动、数字签名和 HMAC。ESP32-S3 还新增了一个“世界控制器 (World Controller)”模块，提供了两个互不干扰的执行环境，实现可信执行环境或权限分离机制。

= 硬件 =

== 硬件接口示意图 ==

[[File:BPI-PicoW-S3-V0.4-IO.png|800px]]

== 硬件规格 ==

{| class="wikitable"
|-
! colspan="2" style="background-color:#ffcb2f;" | BPI-PicoW-S3 规格表
|-
| SoC主控芯片
| ESP32-S3，Xtensa® 32 位 LX7 双核处理器
|-
| 主频
| 240MHz MAX
|-
| 工作温度
| -40℃~+85℃
|-
| 片上 ROM
| 384 KB
|-
| 片上 SRAM
| 320 KB
|-
| 板载 FLASH ROM
| 2MB
|-
| 片上外设PSRAM
| 8MB
|-
| WIFI
| IEEE 802.11 b/g/n ，2.4Ghz频带，150Mbps
|-
| 蓝牙
| Bluetooth 5 ，Bluetooth mesh
|-
| GPIO
| BPI-PicoW-S3已引出27个可用GPIO
|-
| ADC
| 2 × 12 位 SAR ADC，支持 18 个模拟通道输入
|-
| TOUCH 电容式触摸传感器
| 14
|-
| SPI
| 4
|-
| I2C
| 2，支持主机或从机模式
|-
| I2S
| 2，串行立体声数据的输入输出
|-
| LCD
| 1，支持 8 位 ~16 位并行 RGB、I8080、MOTO6800 接口
|-
| CAMERA
| 1，支持 8 位 ~16 位 DVP 图像传感器接口
|-
| UART
| 3 ，支持异步通信（RS232 和RS485）和 IrDA
|-
| PWM
| 8 路独立通道，14位精度
|-
| MCPWM
| 2
|-
| USB
| 1 × 全速USB 2.0 OTG，Type-C母口
|-
| USB Serial/JTAG 控制器
| 1，USB 全速标准，CDC-ACM ，JTAG
|-
| 温度传感器
| 1，测量范围为–20 °C 到 110 °C，用于监测芯片内部温度
|-
| SD/MMC
| 1 × SDIO主机接口，具有2个卡槽，支持SD卡3.0和3.01，SDIO 3.0，CE-ATA 1.1，MMC 4.41，eMMC 4.5和4.51
|-
| TWAI® 控制器
| 1 ，兼容 ISO11898-1（CAN 规范 2.0）
|-
| 通用 DMA 控制器
| 5 个接收通道和 5 个发送通道
|-
| RMT
| 4 通道发射，4通道接收，共享 384 x 32-bit 的 RAM
|-
| 脉冲计数器
| 4个脉冲计数控制器（单元），每个单元有2个独立的通道
|-
| 定时器
| 4 × 54 位通用定时器，16 位时钟预分频器，1 × 52 位系统定时器，3 × 看门狗定时器
|-
| 外部晶振
| 40Mhz
|-
| RTC 和低功耗管理
| 电源管理单元 (PMU)+ 超低功耗协处理器 (ULP)
|-
| 低功耗电流
| 10uA
|-
| 工作电压
| 3.3V
|-
| 输入电压
| 3.3V~5.5V
|-
| 最大放电电流
| 2A@3.3V DC/DC
|-
| USB充电
| 支持
|-
| 最大充电电流
| 500mA
|-
| 可控全彩色LED
| 1
|}

== 硬件尺寸 ==

[[File:Leaf-S3 board dimension.png|800px]]

{| class="wikitable"
|-
! colspan="2" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 尺寸表
|-
| 管脚间距
| 2.54mm
|-
| 安装孔间距
| 11.4mm/ 47mm
|-
| 安装孔尺寸
| 内径2.1mm/外径3.4mm
|-
| 主板尺寸
| 21 × 51.88(mm)/0.83 x 2.04(inches)
|-
| 板厚
| 1.2mm
|}

管脚间距兼容万能板（洞洞板、点阵板），面包板，便于调试应用。

== 外设GPIO管脚分配 ==

{| class="wikitable"
|-
! colspan="3" style=" background-color:#ffcb2f;" | BPI-Leaf-S3 外设GPIO管脚分配
|- style="background-color:#32cb00;"
| 外设接口
| 信号
| 管脚
|-
| rowspan="2" | ADC
| ADC1_CH0~9
| GPIO 1~10
|-
| ADC2_CH0~9
| GPIO 11~20
|-
| 触摸传感器
| TOUCH1~14
| GPIO 1~14
|-
| rowspan="4"|JTAG
| MTCK
| GPIO 39
|-
| MTDO
| GPIO 40
|-
| MTDI
| GPIO 41
|-
| MTMS
| GPIO 42
|-
| rowspan="14" | UART
| colspan="2" style="font-style:italic;color:#9b9b9b;" | 默认分配管脚，可重定义为任意GPIO
|-
| style="background-color:#ffffc7;" | U0RXD_in
| style="background-color:#ffffc7;" | GPIO 44
|-
| U0CTS_in
| GPIO 16
|-
| U0DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U0TXD_out
| style="background-color:#ffffc7;" | GPIO43
|-
| U0RTS_out
| GPIO 15
|-
| U0DTR_out
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1RXD_in
| style="background-color:#ffffc7;" | GPIO 18
|-
| U1CTS_in
| GPIO 20
|-
| U1DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1TXD_out
| style="background-color:#ffffc7;" | GPIO 17
|-
| U1RTS_out
| GPIO 19
|-
| U1DTR_out
| 任意GPIO
|-
| style="background-color:#9aff99;" | U2
| style="background-color:#9aff99;" | 任意GPIO
|-
| I2C
| colspan="2" | 任意GPIO
|-
| PWM
| colspan="2" | 任意GPIO
|-
| I2S
| colspan="2" | 任意GPIO
|-
| LCD
| colspan="2" | 任意GPIO
|-
| CAMERA
| colspan="2" | 任意GPIO
|-
| RMT
| colspan="2" | 任意GPIO
|-
| SPI0/1
| colspan="2" | 已用于FLASH与PSRAM
|-
| SPI2/3
| colspan="2" | 任意GPIO
|-
| 脉冲计数器
| colspan="2" | 任意GPIO
|-
| rowspan="8" | USB OTG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| RCV
| GPIO21（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| rowspan="7" | USB Serial/JTAG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| SD/MMC
| colspan="2" | 任意GPIO
|-
| MCPWM
| colspan="2" | 任意GPIO
|-
| TWAI
| colspan="2" | 任意GPIO
|-
| 彩色LED
| colspan="2" | GPIO 48
|}

= 软件 =

== ESP-IDF ==

[[File:Esp-idf-logo.png | 800px]]

ESP-IDF 是乐鑫官方推出的物联网开发框架，支持 Windows、Linux 和 macOS 操作系统。

建议开发者通过集成开发环境 (IDE) 安装 ESP-IDF:

* [https://github.com/espressif/idf-eclipse-plugin/blob/master/README_CN.md GitHub: ESP-IDF Eclipse 插件安装与使用指南]
* [https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension ESP-IDF VSCode 插件] | [https://github.com/espressif/vscode-esp-idf-extension/blob/master/docs/tutorial/toc.md GitHub: 安装与使用指南] | [https://www.bilibili.com/video/BV17p4y167uN bilibili：ESP-IDF VSCode 插件快速操作指南]

或者根据操作系统选择对应的手动安装流程:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/windows-setup.html Windows 平台工具链的标准设置]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/linux-macos-setup.html Linux 和 macOS 平台工具链的标准设置]

API:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/index.html#api API 参考]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-guides/index.html#api API 指南]

为了使你的BPI-Leaf-S3开发板可以通过USB-CDC刷写FLASH，需要设置开发板为固件下载模式。

有两种操作方法：

1.通过USB连接到电脑，按住BOOT键，再按一下RESET键并松开，最后松开BOOT键。

2.在断开供电的条件下按住BOOT键，再通过USB连接到电脑，最后松开BOOT键。

需要在设备管理器中确认接口，固件下载模式与普通模式下的接口序号可能是不一样的。

== MicroPython ==

[[File:Mircopython.png | 800px]]

MicroPython实现了大部分Python 3 特性和语法，易学易上手，验证程序效果无需编译直接下载进芯片运行。

无论是否有编程基础，MicroPython的上手难度绝对远低于其他编程语言，其代码易读性高，且开源社区有多年积累的丰富资源，就如同Python一样拥有极强的生命力与应用价值。

* '''[https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/tree/main/Example/MicroPython-zh#1%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B GitHub: MicroPython快速上手]'''

* [[ micropython_运行环境搭建 | MicroPython运行环境搭建(Thonny IDE) ]]

* [[ micropython_固件下载与烧录 | MicroPython固件下载与烧录 ]]

== Arduino ==

[[File:Arduino_logo_1200x350.png | 800px]]

Arduino 是一个开源嵌入式软硬件开发平台，用来供用户制作可交互式的嵌入式项目。

* [https://www.arduino.cc/en/software Arduino IDE 下载地址] | [https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html#installing 安装并配置Arduino-ESP32运行环境]
* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/Example/Arduino GitHub: BPI-Leaf-S3 Arduino快速上手]
* [https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html#apis Arduino-ESP32 APIs]

= 资料与资源 =

=样品购买=

* 官方速卖通:
* 官方淘宝:
* OEM&OEM 定制服务： sales@banana-pi.com

File:BPI-PicoW-S3-V0.4-IO.png

2022-09-21T01:45:52Z

Qubot: Qubot uploaded a new version of File:BPI-PicoW-S3-V0.4-IO.png

BPI-PicoW-S3 开发板

2022-09-21T01:43:10Z

Qubot: /* 硬件规格 */

[[en:BPI-PicoW-S3]]

= 介绍 =
Preparing...

[[File:Smart-01-03.gif|thumb|[[BPI-Smart ]]with ESP8266]]
[[File:Webduino_gif.gif|thumb|[[BPI-Bit]] with ESP32]]
[[File:BPI-AI_1.JPG|thumb|[[BPI-AI]] Kendryte K210 RISC-V]]
[[File:ESP32_6.JPG|thumb|[[BPI-UNO32]] with ESP32 design]]

== 关键特性 ==

* ESP32-S3，Xtensa® 32 bit LX7
* 片外 PSRAM , FLASH
* Ultra-low power 10uA
* 2.4G WIFI ，Bluetooth 5 ，Bluetooth mesh
* GPIO , ADC , TOUCH , PWM , I2C , SPI , RMT , I2S , UART , LCD，CAMERA ，USB , JTAG
* 1 * microUSB
* 1 * 全彩色LED

== BPI-Pico-S3 与 Rraspberry Pi PicoW开发板对比 ==
Preparing...
{| class="wikitable"
|- style="font-weight:bold;"
! 开发板
! BPI-Leaf-S3
! ESP32-S3-DevKitC-1
|-
| 引出GPIO
| 36
| 36
|-
| 3.3v管脚
| 2
| 2
|-
| 5v管脚
| 1
| 1
|-
| GND管脚
| 4
| 4
|-
| 全彩LED灯
| 1 on GPIO48
| 1 on GPIO48
|-
| 芯片直连USB
| Type-C USB接口x1
| MicroUSB接口x1
|-
| UART TTL转USB
| 无
| CP2102-MicroUSB接口x1
|-
| 外接电池连接座
| 3.7v锂电池供电接口
| 无
|-
| 电池充电
| 500mA充电
| 无
|-
| I²C 4pin连接座
| 1
| 无
|}

== Espressif ESP32-S3 ==

ESP32-S3 是一款集成 2.4 GHz Wi-Fi 和 Bluetooth 5 (LE) 的 MCU 芯片，支持远距离模式 (Long Range)。ESP32-S3 搭载 Xtensa® 32 位 LX7 双核处理器，主频高达 240 MHz，内置 512 KB SRAM (TCM)，具有 45 个可编程 GPIO 管脚和丰富的通信接口。ESP32-S3 支持更大容量的高速 Octal SPI flash 和片外 RAM，支持用户配置数据缓存与指令缓存。

以下是ESP32-S3芯片重要功能的描述。

* '''支持Wi-Fi + Bluetooth 5 (LE) 无线连接''': ESP32-S3 集成 2.4 GHz Wi-Fi (802.11 b/g/n)，支持 40 MHz 带宽；其低功耗蓝牙子系统支持 Bluetooth 5 (LE) 和 Bluetooth Mesh，可通过 Coded PHY 与广播扩展实现远距离通信。它还支持 2 Mbps PHY，用于提高传输速度和数据吞吐量。ESP32-S3 的 Wi-Fi 和 Bluetooth LE 射频性能优越，在高温下也能稳定工作。

* '''支持 AI 加速''': ESP32-S3 MCU 增加了用于加速神经网络计算和信号处理等工作的向量指令 (vector instructions)。AI 开发者们通过 ESP-DSP 和 ESP-NN 库使用这些向量指令，可以实现高性能的图像识别、语音唤醒和识别等应用。

* '''丰富的 IO 接口''': ESP32-S3 拥有 45 个可编程 GPIO 以及 SPI、I2S、I2C、PWM、RMT、ADC、UART、SD/MMC 主机控制器和 TWAITM 控制器等常用外设接口。其中的 14 个 GPIO 可被配置为 HMI 交互的电容触摸输入端。此外，ESP32-S3 搭载了超低功耗协处理器 (ULP)，支持多种低功耗模式，广泛适用于各类低功耗应用场景。

* '''完善的安全机制''': ESP32-S3 为物联网设备提供了完善的安全机制和保护措施，防止各类恶意攻击和威胁。它支持基于 AES-XTS 算法的 flash 加密、基于 RSA 算法的安全启动、数字签名和 HMAC。ESP32-S3 还新增了一个“世界控制器 (World Controller)”模块，提供了两个互不干扰的执行环境，实现可信执行环境或权限分离机制。

= 硬件 =

== 硬件接口示意图 ==

[[File:BPI-PicoW-S3-V0.4-IO.png|800px]]

== 硬件规格 ==

{| class="wikitable"
|-
! colspan="2" style="background-color:#ffcb2f;" | BPI-PicoW-S3 规格表
|-
| SoC主控芯片
| ESP32-S3，Xtensa® 32 位 LX7 双核处理器
|-
| 主频
| 240MHz MAX
|-
| 工作温度
| -40℃~+85℃
|-
| 片上 ROM
| 384 KB
|-
| 片上 SRAM
| 320 KB
|-
| 板载 FLASH ROM
| 2MB
|-
| 片上外设PSRAM
| 8MB
|-
| WIFI
| IEEE 802.11 b/g/n ，2.4Ghz频带，150Mbps
|-
| 蓝牙
| Bluetooth 5 ，Bluetooth mesh
|-
| GPIO
| BPI-PicoW-S3已引出27个可用GPIO
|-
| ADC
| 2 × 12 位 SAR ADC，支持 18 个模拟通道输入
|-
| TOUCH 电容式触摸传感器
| 14
|-
| SPI
| 4
|-
| I2C
| 2，支持主机或从机模式
|-
| I2S
| 2，串行立体声数据的输入输出
|-
| LCD
| 1，支持 8 位 ~16 位并行 RGB、I8080、MOTO6800 接口
|-
| CAMERA
| 1，支持 8 位 ~16 位 DVP 图像传感器接口
|-
| UART
| 3 ，支持异步通信（RS232 和RS485）和 IrDA
|-
| PWM
| 8 路独立通道，14位精度
|-
| MCPWM
| 2
|-
| USB
| 1 × 全速USB 2.0 OTG，Type-C母口
|-
| USB Serial/JTAG 控制器
| 1，USB 全速标准，CDC-ACM ，JTAG
|-
| 温度传感器
| 1，测量范围为–20 °C 到 110 °C，用于监测芯片内部温度
|-
| SD/MMC
| 1 × SDIO主机接口，具有2个卡槽，支持SD卡3.0和3.01，SDIO 3.0，CE-ATA 1.1，MMC 4.41，eMMC 4.5和4.51
|-
| TWAI® 控制器
| 1 ，兼容 ISO11898-1（CAN 规范 2.0）
|-
| 通用 DMA 控制器
| 5 个接收通道和 5 个发送通道
|-
| RMT
| 4 通道发射，4通道接收，共享 384 x 32-bit 的 RAM
|-
| 脉冲计数器
| 4个脉冲计数控制器（单元），每个单元有2个独立的通道
|-
| 定时器
| 4 × 54 位通用定时器，16 位时钟预分频器，1 × 52 位系统定时器，3 × 看门狗定时器
|-
| 外部晶振
| 40Mhz
|-
| RTC 和低功耗管理
| 电源管理单元 (PMU)+ 超低功耗协处理器 (ULP)
|-
| 低功耗电流
| 10uA
|-
| 工作电压
| 3.3V
|-
| 输入电压
| 3.3V~5.5V
|-
| 最大放电电流
| 2A@3.3V DC/DC
|-
| USB充电
| 支持
|-
| 最大充电电流
| 500mA
|-
| 可控全彩色LED
| 1
|}

== 硬件尺寸 ==

[[File:BPI-PicoW-S3-V0.4-IO.png|800px]]

{| class="wikitable"
|-
! colspan="2" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 尺寸表
|-
| 管脚间距
| 2.54mm
|-
| 安装孔间距
| 11.4mm/ 47mm
|-
| 安装孔尺寸
| 内径2.1mm/外径3.4mm
|-
| 主板尺寸
| 21 × 51.88(mm)/0.83 x 2.04(inches)
|-
| 板厚
| 1.2mm
|}

管脚间距兼容万能板（洞洞板、点阵板），面包板，便于调试应用。

== 外设GPIO管脚分配 ==

{| class="wikitable"
|-
! colspan="3" style=" background-color:#ffcb2f;" | BPI-Leaf-S3 外设GPIO管脚分配
|- style="background-color:#32cb00;"
| 外设接口
| 信号
| 管脚
|-
| rowspan="2" | ADC
| ADC1_CH0~9
| GPIO 1~10
|-
| ADC2_CH0~9
| GPIO 11~20
|-
| 触摸传感器
| TOUCH1~14
| GPIO 1~14
|-
| rowspan="4"|JTAG
| MTCK
| GPIO 39
|-
| MTDO
| GPIO 40
|-
| MTDI
| GPIO 41
|-
| MTMS
| GPIO 42
|-
| rowspan="14" | UART
| colspan="2" style="font-style:italic;color:#9b9b9b;" | 默认分配管脚，可重定义为任意GPIO
|-
| style="background-color:#ffffc7;" | U0RXD_in
| style="background-color:#ffffc7;" | GPIO 44
|-
| U0CTS_in
| GPIO 16
|-
| U0DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U0TXD_out
| style="background-color:#ffffc7;" | GPIO43
|-
| U0RTS_out
| GPIO 15
|-
| U0DTR_out
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1RXD_in
| style="background-color:#ffffc7;" | GPIO 18
|-
| U1CTS_in
| GPIO 20
|-
| U1DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1TXD_out
| style="background-color:#ffffc7;" | GPIO 17
|-
| U1RTS_out
| GPIO 19
|-
| U1DTR_out
| 任意GPIO
|-
| style="background-color:#9aff99;" | U2
| style="background-color:#9aff99;" | 任意GPIO
|-
| I2C
| colspan="2" | 任意GPIO
|-
| PWM
| colspan="2" | 任意GPIO
|-
| I2S
| colspan="2" | 任意GPIO
|-
| LCD
| colspan="2" | 任意GPIO
|-
| CAMERA
| colspan="2" | 任意GPIO
|-
| RMT
| colspan="2" | 任意GPIO
|-
| SPI0/1
| colspan="2" | 已用于FLASH与PSRAM
|-
| SPI2/3
| colspan="2" | 任意GPIO
|-
| 脉冲计数器
| colspan="2" | 任意GPIO
|-
| rowspan="8" | USB OTG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| RCV
| GPIO21（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| rowspan="7" | USB Serial/JTAG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| SD/MMC
| colspan="2" | 任意GPIO
|-
| MCPWM
| colspan="2" | 任意GPIO
|-
| TWAI
| colspan="2" | 任意GPIO
|-
| 彩色LED
| colspan="2" | GPIO 48
|}

= 软件 =

== ESP-IDF ==

[[File:Esp-idf-logo.png | 800px]]

ESP-IDF 是乐鑫官方推出的物联网开发框架，支持 Windows、Linux 和 macOS 操作系统。

建议开发者通过集成开发环境 (IDE) 安装 ESP-IDF:

* [https://github.com/espressif/idf-eclipse-plugin/blob/master/README_CN.md GitHub: ESP-IDF Eclipse 插件安装与使用指南]
* [https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension ESP-IDF VSCode 插件] | [https://github.com/espressif/vscode-esp-idf-extension/blob/master/docs/tutorial/toc.md GitHub: 安装与使用指南] | [https://www.bilibili.com/video/BV17p4y167uN bilibili：ESP-IDF VSCode 插件快速操作指南]

或者根据操作系统选择对应的手动安装流程:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/windows-setup.html Windows 平台工具链的标准设置]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/linux-macos-setup.html Linux 和 macOS 平台工具链的标准设置]

API:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/index.html#api API 参考]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-guides/index.html#api API 指南]

为了使你的BPI-Leaf-S3开发板可以通过USB-CDC刷写FLASH，需要设置开发板为固件下载模式。

有两种操作方法：

1.通过USB连接到电脑，按住BOOT键，再按一下RESET键并松开，最后松开BOOT键。

2.在断开供电的条件下按住BOOT键，再通过USB连接到电脑，最后松开BOOT键。

需要在设备管理器中确认接口，固件下载模式与普通模式下的接口序号可能是不一样的。

== MicroPython ==

[[File:Mircopython.png | 800px]]

MicroPython实现了大部分Python 3 特性和语法，易学易上手，验证程序效果无需编译直接下载进芯片运行。

无论是否有编程基础，MicroPython的上手难度绝对远低于其他编程语言，其代码易读性高，且开源社区有多年积累的丰富资源，就如同Python一样拥有极强的生命力与应用价值。

* '''[https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/tree/main/Example/MicroPython-zh#1%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B GitHub: MicroPython快速上手]'''

* [[ micropython_运行环境搭建 | MicroPython运行环境搭建(Thonny IDE) ]]

* [[ micropython_固件下载与烧录 | MicroPython固件下载与烧录 ]]

== Arduino ==

[[File:Arduino_logo_1200x350.png | 800px]]

Arduino 是一个开源嵌入式软硬件开发平台，用来供用户制作可交互式的嵌入式项目。

* [https://www.arduino.cc/en/software Arduino IDE 下载地址] | [https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html#installing 安装并配置Arduino-ESP32运行环境]
* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/Example/Arduino GitHub: BPI-Leaf-S3 Arduino快速上手]
* [https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html#apis Arduino-ESP32 APIs]

= 资料与资源 =

=样品购买=

* 官方速卖通:
* 官方淘宝:
* OEM&OEM 定制服务： sales@banana-pi.com

BPI-PicoW-S3 开发板

2022-09-21T01:40:03Z

Qubot: /* 硬件尺寸 */

[[en:BPI-PicoW-S3]]

= 介绍 =
Preparing...

[[File:Smart-01-03.gif|thumb|[[BPI-Smart ]]with ESP8266]]
[[File:Webduino_gif.gif|thumb|[[BPI-Bit]] with ESP32]]
[[File:BPI-AI_1.JPG|thumb|[[BPI-AI]] Kendryte K210 RISC-V]]
[[File:ESP32_6.JPG|thumb|[[BPI-UNO32]] with ESP32 design]]

== 关键特性 ==

* ESP32-S3，Xtensa® 32 bit LX7
* 片外 PSRAM , FLASH
* Ultra-low power 10uA
* 2.4G WIFI ，Bluetooth 5 ，Bluetooth mesh
* GPIO , ADC , TOUCH , PWM , I2C , SPI , RMT , I2S , UART , LCD，CAMERA ，USB , JTAG
* 1 * microUSB
* 1 * 全彩色LED

== BPI-Pico-S3 与 Rraspberry Pi PicoW开发板对比 ==
Preparing...
{| class="wikitable"
|- style="font-weight:bold;"
! 开发板
! BPI-Leaf-S3
! ESP32-S3-DevKitC-1
|-
| 引出GPIO
| 36
| 36
|-
| 3.3v管脚
| 2
| 2
|-
| 5v管脚
| 1
| 1
|-
| GND管脚
| 4
| 4
|-
| 全彩LED灯
| 1 on GPIO48
| 1 on GPIO48
|-
| 芯片直连USB
| Type-C USB接口x1
| MicroUSB接口x1
|-
| UART TTL转USB
| 无
| CP2102-MicroUSB接口x1
|-
| 外接电池连接座
| 3.7v锂电池供电接口
| 无
|-
| 电池充电
| 500mA充电
| 无
|-
| I²C 4pin连接座
| 1
| 无
|}

== Espressif ESP32-S3 ==

ESP32-S3 是一款集成 2.4 GHz Wi-Fi 和 Bluetooth 5 (LE) 的 MCU 芯片，支持远距离模式 (Long Range)。ESP32-S3 搭载 Xtensa® 32 位 LX7 双核处理器，主频高达 240 MHz，内置 512 KB SRAM (TCM)，具有 45 个可编程 GPIO 管脚和丰富的通信接口。ESP32-S3 支持更大容量的高速 Octal SPI flash 和片外 RAM，支持用户配置数据缓存与指令缓存。

以下是ESP32-S3芯片重要功能的描述。

* '''支持Wi-Fi + Bluetooth 5 (LE) 无线连接''': ESP32-S3 集成 2.4 GHz Wi-Fi (802.11 b/g/n)，支持 40 MHz 带宽；其低功耗蓝牙子系统支持 Bluetooth 5 (LE) 和 Bluetooth Mesh，可通过 Coded PHY 与广播扩展实现远距离通信。它还支持 2 Mbps PHY，用于提高传输速度和数据吞吐量。ESP32-S3 的 Wi-Fi 和 Bluetooth LE 射频性能优越，在高温下也能稳定工作。

* '''支持 AI 加速''': ESP32-S3 MCU 增加了用于加速神经网络计算和信号处理等工作的向量指令 (vector instructions)。AI 开发者们通过 ESP-DSP 和 ESP-NN 库使用这些向量指令，可以实现高性能的图像识别、语音唤醒和识别等应用。

* '''丰富的 IO 接口''': ESP32-S3 拥有 45 个可编程 GPIO 以及 SPI、I2S、I2C、PWM、RMT、ADC、UART、SD/MMC 主机控制器和 TWAITM 控制器等常用外设接口。其中的 14 个 GPIO 可被配置为 HMI 交互的电容触摸输入端。此外，ESP32-S3 搭载了超低功耗协处理器 (ULP)，支持多种低功耗模式，广泛适用于各类低功耗应用场景。

* '''完善的安全机制''': ESP32-S3 为物联网设备提供了完善的安全机制和保护措施，防止各类恶意攻击和威胁。它支持基于 AES-XTS 算法的 flash 加密、基于 RSA 算法的安全启动、数字签名和 HMAC。ESP32-S3 还新增了一个“世界控制器 (World Controller)”模块，提供了两个互不干扰的执行环境，实现可信执行环境或权限分离机制。

= 硬件 =

== 硬件接口示意图 ==

[[File:BPI-PicoW-S3-V0.4-IO.png|800px]]

== 硬件规格 ==

{| class="wikitable"
|-
! colspan="2" style="background-color:#ffcb2f;" | BPI-Leaf-S3 规格表
|-
| SoC主控芯片
| ESP32-S3，Xtensa® 32 位 LX7 双核处理器
|-
| 主频
| 240MHz MAX
|-
| 工作温度
| -40℃~+85℃
|-
| 片上 ROM
| 384 KB
|-
| 片上 SRAM
| 320 KB
|-
| 板载 FLASH ROM
| 4MB
|-
| 片上外设PSRAM
| 2MB
|-
| WIFI
| IEEE 802.11 b/g/n ，2.4Ghz频带，150Mbps
|-
| 蓝牙
| Bluetooth 5 ，Bluetooth mesh
|-
| GPIO
| BPI-Leaf-S3已引出36个可用GPIO
|-
| ADC
| 2 × 12 位 SAR ADC，支持 20 个模拟通道输入
|-
| TOUCH 电容式触摸传感器
| 14
|-
| SPI
| 4
|-
| I2C
| 2，支持主机或从机模式
|-
| I2S
| 2，串行立体声数据的输入输出
|-
| LCD
| 1，支持 8 位 ~16 位并行 RGB、I8080、MOTO6800 接口
|-
| CAMERA
| 1，支持 8 位 ~16 位 DVP 图像传感器接口
|-
| UART
| 3 ，支持异步通信（RS232 和RS485）和 IrDA
|-
| PWM
| 8 路独立通道，14位精度
|-
| MCPWM
| 2
|-
| USB
| 1 × 全速USB 2.0 OTG，Type-C母口
|-
| USB Serial/JTAG 控制器
| 1，USB 全速标准，CDC-ACM ，JTAG
|-
| 温度传感器
| 1，测量范围为–20 °C 到 110 °C，用于监测芯片内部温度
|-
| SD/MMC
| 1 × SDIO主机接口，具有2个卡槽，支持SD卡3.0和3.01，SDIO 3.0，CE-ATA 1.1，MMC 4.41，eMMC 4.5和4.51
|-
| TWAI® 控制器
| 1 ，兼容 ISO11898-1（CAN 规范 2.0）
|-
| 通用 DMA 控制器
| 5 个接收通道和 5 个发送通道
|-
| RMT
| 4 通道发射，4通道接收，共享 384 x 32-bit 的 RAM
|-
| 脉冲计数器
| 4个脉冲计数控制器（单元），每个单元有2个独立的通道
|-
| 定时器
| 4 × 54 位通用定时器，16 位时钟预分频器，1 × 52 位系统定时器，3 × 看门狗定时器
|-
| 外部晶振
| 40Mhz
|-
| RTC 和低功耗管理
| 电源管理单元 (PMU)+ 超低功耗协处理器 (ULP)
|-
| 低功耗电流
| 10uA
|-
| 工作电压
| 3.3V
|-
| 输入电压
| 3.3V~5.5V
|-
| 最大放电电流
| 2A@3.3V DC/DC
|-
| USB充电
| 支持
|-
| 最大充电电流
| 500mA
|-
| 可控全彩色LED
| 1
|}

== 硬件尺寸 ==

[[File:BPI-PicoW-S3-V0.4-IO.png|800px]]

{| class="wikitable"
|-
! colspan="2" style=" background-color:#ffcb2f;" | BPI-PicoW-S3 尺寸表
|-
| 管脚间距
| 2.54mm
|-
| 安装孔间距
| 11.4mm/ 47mm
|-
| 安装孔尺寸
| 内径2.1mm/外径3.4mm
|-
| 主板尺寸
| 21 × 51.88(mm)/0.83 x 2.04(inches)
|-
| 板厚
| 1.2mm
|}

管脚间距兼容万能板（洞洞板、点阵板），面包板，便于调试应用。

== 外设GPIO管脚分配 ==

{| class="wikitable"
|-
! colspan="3" style=" background-color:#ffcb2f;" | BPI-Leaf-S3 外设GPIO管脚分配
|- style="background-color:#32cb00;"
| 外设接口
| 信号
| 管脚
|-
| rowspan="2" | ADC
| ADC1_CH0~9
| GPIO 1~10
|-
| ADC2_CH0~9
| GPIO 11~20
|-
| 触摸传感器
| TOUCH1~14
| GPIO 1~14
|-
| rowspan="4"|JTAG
| MTCK
| GPIO 39
|-
| MTDO
| GPIO 40
|-
| MTDI
| GPIO 41
|-
| MTMS
| GPIO 42
|-
| rowspan="14" | UART
| colspan="2" style="font-style:italic;color:#9b9b9b;" | 默认分配管脚，可重定义为任意GPIO
|-
| style="background-color:#ffffc7;" | U0RXD_in
| style="background-color:#ffffc7;" | GPIO 44
|-
| U0CTS_in
| GPIO 16
|-
| U0DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U0TXD_out
| style="background-color:#ffffc7;" | GPIO43
|-
| U0RTS_out
| GPIO 15
|-
| U0DTR_out
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1RXD_in
| style="background-color:#ffffc7;" | GPIO 18
|-
| U1CTS_in
| GPIO 20
|-
| U1DSR_in
| 任意GPIO
|-
| style="background-color:#ffffc7;" | U1TXD_out
| style="background-color:#ffffc7;" | GPIO 17
|-
| U1RTS_out
| GPIO 19
|-
| U1DTR_out
| 任意GPIO
|-
| style="background-color:#9aff99;" | U2
| style="background-color:#9aff99;" | 任意GPIO
|-
| I2C
| colspan="2" | 任意GPIO
|-
| PWM
| colspan="2" | 任意GPIO
|-
| I2S
| colspan="2" | 任意GPIO
|-
| LCD
| colspan="2" | 任意GPIO
|-
| CAMERA
| colspan="2" | 任意GPIO
|-
| RMT
| colspan="2" | 任意GPIO
|-
| SPI0/1
| colspan="2" | 已用于FLASH与PSRAM
|-
| SPI2/3
| colspan="2" | 任意GPIO
|-
| 脉冲计数器
| colspan="2" | 任意GPIO
|-
| rowspan="8" | USB OTG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| RCV
| GPIO21（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| rowspan="7" | USB Serial/JTAG
| D-
| GPIO 19（内部 PHY）
|-
| D+
| GPIO 20（内部 PHY）
|-
| VP
| GPIO 42（外部 PHY）
|-
| VM
| GPIO 41（外部 PHY）
|-
| OEN
| GPIO 40（外部 PHY）
|-
| VPO
| GPIO 39（外部 PHY）
|-
| VMO
| GPIO38（外部 PHY）
|-
| SD/MMC
| colspan="2" | 任意GPIO
|-
| MCPWM
| colspan="2" | 任意GPIO
|-
| TWAI
| colspan="2" | 任意GPIO
|-
| 彩色LED
| colspan="2" | GPIO 48
|}

= 软件 =

== ESP-IDF ==

[[File:Esp-idf-logo.png | 800px]]

ESP-IDF 是乐鑫官方推出的物联网开发框架，支持 Windows、Linux 和 macOS 操作系统。

建议开发者通过集成开发环境 (IDE) 安装 ESP-IDF:

* [https://github.com/espressif/idf-eclipse-plugin/blob/master/README_CN.md GitHub: ESP-IDF Eclipse 插件安装与使用指南]
* [https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension ESP-IDF VSCode 插件] | [https://github.com/espressif/vscode-esp-idf-extension/blob/master/docs/tutorial/toc.md GitHub: 安装与使用指南] | [https://www.bilibili.com/video/BV17p4y167uN bilibili：ESP-IDF VSCode 插件快速操作指南]

或者根据操作系统选择对应的手动安装流程:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/windows-setup.html Windows 平台工具链的标准设置]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/get-started/linux-macos-setup.html Linux 和 macOS 平台工具链的标准设置]

API:

* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/index.html#api API 参考]
* [https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-guides/index.html#api API 指南]

为了使你的BPI-Leaf-S3开发板可以通过USB-CDC刷写FLASH，需要设置开发板为固件下载模式。

有两种操作方法：

1.通过USB连接到电脑，按住BOOT键，再按一下RESET键并松开，最后松开BOOT键。

2.在断开供电的条件下按住BOOT键，再通过USB连接到电脑，最后松开BOOT键。

需要在设备管理器中确认接口，固件下载模式与普通模式下的接口序号可能是不一样的。

== MicroPython ==

[[File:Mircopython.png | 800px]]

MicroPython实现了大部分Python 3 特性和语法，易学易上手，验证程序效果无需编译直接下载进芯片运行。

无论是否有编程基础，MicroPython的上手难度绝对远低于其他编程语言，其代码易读性高，且开源社区有多年积累的丰富资源，就如同Python一样拥有极强的生命力与应用价值。

* '''[https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/tree/main/Example/MicroPython-zh#1%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B GitHub: MicroPython快速上手]'''

* [[ micropython_运行环境搭建 | MicroPython运行环境搭建(Thonny IDE) ]]

* [[ micropython_固件下载与烧录 | MicroPython固件下载与烧录 ]]

== Arduino ==

[[File:Arduino_logo_1200x350.png | 800px]]

Arduino 是一个开源嵌入式软硬件开发平台，用来供用户制作可交互式的嵌入式项目。

* [https://www.arduino.cc/en/software Arduino IDE 下载地址] | [https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html#installing 安装并配置Arduino-ESP32运行环境]
* [https://github.com/BPI-STEAM/BPI-Leaf-S3-Doc/blob/main/Example/Arduino GitHub: BPI-Leaf-S3 Arduino快速上手]
* [https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html#apis Arduino-ESP32 APIs]

= 资料与资源 =

=样品购买=

* 官方速卖通:
* 官方淘宝:
* OEM&OEM 定制服务： sales@banana-pi.com