Banana Pi Wiki - User contributions [en]

BPI-Leaf-S3

2023-11-15T02:16:10Z

Wind: /* Introduction */

[[zh:BPI-Leaf-S3 开发板]]

= Introduction =
[[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:BPI-Centi-S3_2.jpg|thumb|[[BPI-Centi-S3]] with ESP32-S3 front]]
[[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.

[[File:BPI-Leaf-S3_banner.jpg]]

== Key Features ==

* ESP32-S3，Xtensa® 32 bit LX7
* Extereal FLASH 8MB
* In-packge PSRAM 2MB
* 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* SH 1mm 4-Pin Socket, support I2C
* 1 * USB Type-C
* 1 * MX 1.25mm 2-Pin Socket，support USB 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.

==Getting Start==

*[https://bpi-steam.com/Leaf_S3_doc/en/ Getting Started with BPI-Leaf-S3]

= 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
| 512 KB
|-
| Onboard FLASH ROM
| 8MB
|-
| In-packge 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.

*ESP-DL (deep learning) Auto-Generating Model Deployment Project using TVM: https://docs.espressif.com/projects/esp-dl/en/latest/esp32/tutorials/deploying-models-through-tvm.html

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

'''BPI-Steam resources'''
* [https://bpi-steam.com/Leaf_S3_doc/en/MicroPython/Environment.html MicroPython runtime environment setup]
* [https://bpi-steam.com/Leaf_S3_doc/en/MicroPython/Firmware.html Micropython firmware download and burning]
* [https://bpi-steam.com/Leaf_S3_doc/en/MicroPython/Basic.html Basic use case]
* [https://bpi-steam.com/Leaf_S3_doc/en/MicroPython/ESPNOW.html ESP-NOW use case]

'''Forum resources'''
* [https://forum.banana-pi.org/t/bpi-leaf-s3-esp-now-on-micropython-easy-to-implement-networking-communication/15481 BPI-Leaf-S3 , ESP-NOW on MicroPython, easy to implement networking communication]
* [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=

* BIPAI Aliexpress shop:https://www.aliexpress.com/item/1005004701866550.html?
* SINOVOIP 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-Leaf-S3

2023-11-15T02:15:59Z

Wind: /* Introduction */

[[zh:BPI-Leaf-S3 开发板]]

= Introduction =
[[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:BPI-Centi-S3_2.jpg|thumb|[[BPI-Centi-S3]] with ESP32-S3 front]]
[[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.
[[File:BPI-Leaf-S3_banner.jpg]]

[[File:BPI-Leaf-S3_banner.jpg]]

== Key Features ==

* ESP32-S3，Xtensa® 32 bit LX7
* Extereal FLASH 8MB
* In-packge PSRAM 2MB
* 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* SH 1mm 4-Pin Socket, support I2C
* 1 * USB Type-C
* 1 * MX 1.25mm 2-Pin Socket，support USB 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.

==Getting Start==

*[https://bpi-steam.com/Leaf_S3_doc/en/ Getting Started with BPI-Leaf-S3]

= 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
| 512 KB
|-
| Onboard FLASH ROM
| 8MB
|-
| In-packge 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.

*ESP-DL (deep learning) Auto-Generating Model Deployment Project using TVM: https://docs.espressif.com/projects/esp-dl/en/latest/esp32/tutorials/deploying-models-through-tvm.html

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

'''BPI-Steam resources'''
* [https://bpi-steam.com/Leaf_S3_doc/en/MicroPython/Environment.html MicroPython runtime environment setup]
* [https://bpi-steam.com/Leaf_S3_doc/en/MicroPython/Firmware.html Micropython firmware download and burning]
* [https://bpi-steam.com/Leaf_S3_doc/en/MicroPython/Basic.html Basic use case]
* [https://bpi-steam.com/Leaf_S3_doc/en/MicroPython/ESPNOW.html ESP-NOW use case]

'''Forum resources'''
* [https://forum.banana-pi.org/t/bpi-leaf-s3-esp-now-on-micropython-easy-to-implement-networking-communication/15481 BPI-Leaf-S3 , ESP-NOW on MicroPython, easy to implement networking communication]
* [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=

* BIPAI Aliexpress shop:https://www.aliexpress.com/item/1005004701866550.html?
* SINOVOIP 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-Leaf-S3

2023-11-15T02:15:50Z

Wind: /* Introduction */

[[zh:BPI-Leaf-S3 开发板]]

= Introduction =
[[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:BPI-Centi-S3_2.jpg|thumb|[[BPI-Centi-S3]] with ESP32-S3 front]]
[[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.
[[File:BPI-Leaf-S3_banner.jpg]]

== Key Features ==

* ESP32-S3，Xtensa® 32 bit LX7
* Extereal FLASH 8MB
* In-packge PSRAM 2MB
* 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* SH 1mm 4-Pin Socket, support I2C
* 1 * USB Type-C
* 1 * MX 1.25mm 2-Pin Socket，support USB 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.

==Getting Start==

*[https://bpi-steam.com/Leaf_S3_doc/en/ Getting Started with BPI-Leaf-S3]

= 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
| 512 KB
|-
| Onboard FLASH ROM
| 8MB
|-
| In-packge 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.

*ESP-DL (deep learning) Auto-Generating Model Deployment Project using TVM: https://docs.espressif.com/projects/esp-dl/en/latest/esp32/tutorials/deploying-models-through-tvm.html

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

'''BPI-Steam resources'''
* [https://bpi-steam.com/Leaf_S3_doc/en/MicroPython/Environment.html MicroPython runtime environment setup]
* [https://bpi-steam.com/Leaf_S3_doc/en/MicroPython/Firmware.html Micropython firmware download and burning]
* [https://bpi-steam.com/Leaf_S3_doc/en/MicroPython/Basic.html Basic use case]
* [https://bpi-steam.com/Leaf_S3_doc/en/MicroPython/ESPNOW.html ESP-NOW use case]

'''Forum resources'''
* [https://forum.banana-pi.org/t/bpi-leaf-s3-esp-now-on-micropython-easy-to-implement-networking-communication/15481 BPI-Leaf-S3 , ESP-NOW on MicroPython, easy to implement networking communication]
* [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=

* BIPAI Aliexpress shop:https://www.aliexpress.com/item/1005004701866550.html?
* SINOVOIP 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

Banana Pi BPI-M4 Berry

2023-11-15T02:08:14Z

Wind: /* Introduction */

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

==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
:OEM&ODM, please contact: judyhuang@banana-pi.com

Getting Started with BPI-M4 Zero

2023-11-14T03:11:26Z

Wind: /* Prepare */

[[zh:快速上手_BPI-M4_Zero]]
[[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 [Linux Linux Image], and confirm that the md5 checksum is correct.

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

:7. The wiki guide is only for [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-m4-zero-xxx.img.zip
sudo balena local flash path/to/xxx-bpi-m4-zero-xxx.img.zip --drive /dev/disk2
sudo balena local flash path/to/xxx-bpi-m4-zero-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-m4-zero-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-m4-zero-xxx.img.zip /dev/sdX

===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, an HDMI cable, and a mini HDMI to HDMI adapter.
:3. Use an HDMI cable and a mini HDMI to HDMI adapter to connect the monitor and BPI-M4 Zero, 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 Zero 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 Zero, and also connect the PC to another LAN port.
:3. Check the IP address of BPI-M4 Zero on the router management interface, or use the following command on the BPI-M4 Zero 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 Zero 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 Zero 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 Zero 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 Zero 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-m4zero:~$ 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 Zero 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 Zero.If it is a USB disk with a type-A plug, you also need a type-A to type-C adapter.
: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 Zero 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, use an HDMI cable and a mini HDMI to HDMI adapter 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]]

===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-m4zero:~$ 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-m4zero:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth 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 Zero 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]]

首页

2023-11-13T06:30:46Z

Wind: /* 香蕉派快速上手使用并开始开发 */

[[en:Main_Page]]
<div id="快速开始"></div>
[[File:Website.jpg|thumb| [[香蕉派(Banana Pi) 开源社区生态与物联网整体技术解决方案]]]]
[[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|[[香蕉派 BPI-R3]] with MediaTek MT7986(Filogic 830)]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[香蕉派 BPI-M2S]] Amlogic A311D chip]]
[[File:Banana_Pi_BPI-R2_Pro_1_750.jpg|thumb|[[香蕉派 BPI-R2 Pro]] Rockchip RK3568 design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[香蕉派 BPI-M2 Pro]] S905x3 方案设计]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[香蕉派 BPI-M5 ]]Amlogic S905X3 方案设计]]
[[File:Banana_PI_BPI-F2P_3.JPG|thumb| [[香蕉派 BPI-F2P]]工业物联网网关开发板]]
[[File:Banana_Pi_BPI-F2S_1_.JPG|thumb| [[香蕉派 BPI-F2S]] with Sunplus SP7021]]
[[File:Banana_Pi_BPI-R64_1.jpg|thumb|[[香蕉派 BPI-R64]] MTK MT7622]]
[[File:O2A0500.jpg|thumb|[[香蕉派 BPI-W2]] Realtek RD1296]]
[[File:BPI-R2_3.JPG|thumb|[[香蕉派 BPI-R2]] MTK MT7623N]]
[[File:Banana_Pi_BPI-M4_1.jpg|thumb|[[香蕉派 BPI-M4]] Realtek RTD1395]]
[[File:Banana_pi_BPI-M64_1.jpg|thumb|[[香蕉派 BPI-M64]] Allwinner A64]]
[[File:Banana_pi_BPI-M3_1.jpg|thumb|[[香蕉派 BPI-M3]] Allwinner A83T]]
[[File:BPI-F2_zero_1.JPG|thumb|[[香蕉派 BPI-P2 Zero]] Allwinner H2+/H3/H5]]
[[File:Banana_pi_BPI-M2+_2.jpg|thumb|[[香蕉派 BPI-M2+]] Allwinner H3/H5/H2+]3]]
[[File:BPI-M2_zero_11.JPG|thumb|[[香蕉派 BPI-M2 ZERO]] Allwinner H2+/H3/H5]]
[[File:Banana_pi_BPI-M2_Ultra_2.JPG|thumb|[[香蕉派 BPI-M2U]] Allwinner R40/V40/A40i]]
[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[香蕉派 BPI-M2 Berry]] Allwinner R40/V40/A40i]]
[[File:Banana_pi_bpi-m2_magic_5.JPG|thumb|[[香蕉派 BPI-M2M]] Allwinner A33/R16]]
[[File:Banana_pi_BPI-R1_1.JPG|thumb|[[香蕉派 BPI-R1]] Allwinner A20]]
[[File:Banana_pi_BPI-M1+_1.jpg|thumb|[[香蕉派 BPI-M1+]] Allwinner A20]]
[[File:Banana_pi_BPI-M1_1.jpg|thumb|[[香蕉派 BPI-M1]] Allwinner A20]]

=香蕉派(Banana Pi)开源硬件项目介绍=

[[File:Website.jpg]]

[https://www.banana-pi.org.cn/ '''香蕉派（Banana Pi）''']是由[http://wiki.banana-pi.org/%E5%B9%BF%E4%B8%9C%E6%AF%94%E6%B4%BE%E7%A7%91%E6%8A%80%E6%9C%89%E9%99%90%E5%85%AC%E5%8F%B8%E5%85%AC%E5%8F%B8%E4%BB%8B%E7%BB%8D '''广东比派科技有限公司''']主导的一个开源硬件项目，专注在ARM，MCU系列开源硬件开发板，提供全开放的软件与硬件平台,打造基础技术开发平台。重点打造[[香蕉派(Banana Pi) 开源社区生态与物联网整体技术解决方案]].

全系列开源硬件产品，完整整合了语音，数据，视频系统平台,传感器。开发者可以灵活的在开源硬件基础平台上搭建各种应用平台。可以应用在物联网，AI 人工智能，工业互联网控制，STEAM教育等各方面。

欢迎加入[https://forum.banana-pi.org.cn/ '''Banana Pi中文官方论坛''']进行技术讨论，可以在[https://shop108780008.taobao.com/?spm=a1z10.1.0.0.EZ5mQu '''比派科技淘宝官方店''']购买样品进行DIY.

'''[[BPI 4.0 定制服务]]'''已经全球有100多个'''[[BPI 4.0 成功案例]]'''，为客户提供研发，生产，供应链管理，产品认证一站式服务。

==香蕉派快速上手使用并开始开发==
<div id="Banana Pi"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="12%" valign="top" align="left"|
*[[快速上手香蕉派镜像烧录与系统启动]]
*[[快速上手香蕉派 BPI-M1]] [[Image:hot.gif]]
*[[快速上手香蕉派 BPI-M1+]] [[Image:hot.gif]]
*[[快速上手香蕉派 BPI-P2 Zero]]
*[[快速上手香蕉派 BPI-M2 Ultra / BPI-M2 Berry]][[Image:hot.gif]]
*[[快速上手香蕉派 BPI-M2 Magic]][[Image:hot.gif]]
*[[快速上手香蕉派 BPI-M2 Zero]]
*[[快速上手香蕉派 BPI-M2+]] [[Image:hot.gif]]
*[[快速上手香蕉派 BPI-M64]]
*[[快速上手香蕉派 BPI-M3]][[Image:hot.gif]]
*[[快速上手 BPI-M4 Berry | 快速上手香蕉派 BPI-M4 Berry ]]

|width="12%" valign="top" align="left"|
*[[快速上手香蕉派 BPI-R1]][[Image:hot.gif]]
*[[快速上手香蕉派 BPI-R2]] [[Image:hot.gif]]
*[[快速上手香蕉派 BPI-W2]] [[Image:hot.gif]]
*[[Getting Started with R2PRO]]
*[[Getting Started with R64]]
*[[Getting Started with BPI-R3]]
*[[Getting Started with BPI-W3]]

|width="12%" valign="top" align="left"|

*[[Getting Started with M64]]
*[[Getting Started with M3]]
*[[Getting Started with M4]]
*[[Getting Started with M5/M2Pro]]
*[[Getting Started with M2S]]
*[[Getting Started with CM4]]
|}

=镜像和开发工具=
=== 嵌入式系统 ===
{| border="0" cellpadding="10" width="70%"
|-
|width="32%" valign="top" align="left"|

*[[Armbian]]
*[[Tina Linux]]
*[[Mainline Linux uboot 2019.07]]
|}

=== 开发工具 ===
{| border="0" cellpadding="10" width="70%"
|-
|width="32%" valign="top" align="left"|
*[[Using 4G module with BananaPi]]
*[[WiFi/AP/BT/BLE on BananaPi]]
*[[OpenCV 3.4x on BananaPi]]
*[[How to use DHT Sensor via banana pi]]
|}

=== Github编译源码 ===
* 香蕉派开源硬件源代码github : https://github.com/bpi-sinovoip
* STEAM教育产品源代码github : https://github.com/BPI-STEAM

=香蕉派（Banana Pi）开源硬件产品系列=

[https://pan.baidu.com/s/1QE18Hh2D1asNI1z9TFNspQ 香蕉派产品数码照片百度下载提取码: 4y75]
===香蕉派系列单板计算机: [[Banana Pi 单板计算机系列产品比较表]] ===
<div id="Banana Pi single board computer"></div >
{| border="0" cellpadding="10" width="70%"
|-
|width="32%" valign="top" align="left"|
*[[香蕉派 BPI-M1]] [Allwinner A20] [[Image:hot.gif]]
*[[香蕉派 BPI-M1+]] [Allwinner A20] [[Image:hot.gif]]
*[[香蕉派 BPI-M2 ZERO]] [Allwinner H2+/H3/H5] [[Image:hot.gif]]
*[[香蕉派 BPI-P2 Zero]] [allwinner H2+/H3/H5]
*[[香蕉派 BPI-M2+]] [Allwinner H3/H5/H2+] [[Image:hot.gif]]
*[[香蕉派 BPI-M2 Magic]] [Allwinner A33/R16] [[Image:hot.gif]]
*[[香蕉派 BPI-M2 Berry]] [Allwinner R40/V40/A40i] [[Image:hot.gif]]
*[[香蕉派 BPI-M2 Ultra]] [Allwinner R40/V40/A40i][[Image:hot.gif]]
*[[香蕉派 BPI-M64]] [Allwinner A64] [[Image:hot.gif]]
*[[香蕉派 BPI-M3]] [Allwinner A83T] [[Image:hot.gif]]

|width="32%" valign="top" align="left"|
*[[香蕉派 BPI-F2]] [Freescale IMX6]
*[[香蕉派 BPI-F2S]] [Sunplus SP7021 工业级开发板]
*[[香蕉派 BPI-F2P]] [Sunplus SP7021 工业控制网关开发板]
*[[香蕉派 BPI-S64 Core]] [Actions S700]
*[[香蕉派 BPI-M4]] [Realtek 1395]
*[[香蕉派 BPI-M4 Berry]][Allwinner H618]
*[[香蕉派 BPI-M5]] [Amlogic S905x3]
*[[香蕉派 BPI-M2 Pro]] [Amlogic S905x3]
*[[香蕉派 BPI-M2S]] [Amlogic A311D&S922X]
*[[香蕉派 BPI-M6]] [ Synaptics VS680]
*[[香蕉派 BPI-P2 Pro]] [Rockchip RK3308]

|}

===香蕉派系列开源智能路由器: [[Banana Pi 开源路由器产品系列比较表]]===

<div id="Banana Pi Webduino & Arduino Products"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="10%" valign="top" align="left"|
*[[香蕉派 BPI-R4]] [MTK MT7988(Filogic 880)]
*[[香蕉派 BPI-R3]] [MTK MT7986(Filogic 830)]
*[[香蕉派 BPI-R3 Mini]] [MTK MT7986(Filogic 830)]
*[[香蕉派 BPI-R64]] [MTK MT7622]
*[[香蕉派 BPI-R2]] [MTK MT7623N] [[Image:hot.gif]]
|width="10%" valign="top" align="left"|
*[[香蕉派 BPI-W3]] [Rockchip RK3588]
*[[香蕉派 BPI-R2 Pro]] [Rockchip RK3568]
*[[香蕉派 BPI-W2]] [Realtek 1296] [[Image:hot.gif]]
*[[香蕉派 BPI-R1]] [Allwinner A20]
*[[香蕉派 BPI-Wifi6 路由器]] [创耀科技 TR6560 + TR5220 wifi SOC]
|}

===Banana Pi Core board and development Kit===
<div id="Banana Pi AI"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="10%" valign="top" align="left"|
*[[香蕉派 BPI-CM2]] [Rockchip RK3568]
*[[香蕉派 BPI-CM4]] [Amlogic A311D]
*[[香蕉派 BPI-CM5]] [Amlogic A311D2]
|width="10%" valign="top" align="left"|
*[[BPI-RK3588 Core board and development Kit]] [Rochchip RK3588]
*[[香蕉派 BPI-W3]] [Rockchip RK3588 LGA core board]
*[[Banana Pi BPI-S64 Core]] [Actions S700]
|}

===香蕉派系列开源AI智能开发板===
<div id="Banana Pi AI"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="10%" valign="top" align="left"|
*[[BPI-AI-Voice (Microsemi)]] [[Image:hot.gif]]
*[[BPI-EAI80 AIoT 开发板]] 格力零边界 EAI80芯片方案
|width="10%" valign="top" align="left"|
*[[BPI-R18-AI 语音麦克风陈列开发套件(Allwinner SoC-Only 3-Mic Far-Field Dev Kit) ]][[Image:hot.gif]]
|width="10%" valign="top" align="left"|
*[[AIWorld P1]]
|}

===香蕉派 Webduino & Arduino & MicroPython 产品系列===

Banana Pi Webduino & Arduino & MicroPython 主板

<div id="Banana Pi Webduino & Arduino & MicroPython Products"></div>
{| border="0" cellpadding="10" width="70%"
|width="10%" valign="top" align="left"|
*[[BPI-Bit STEAM 教育开发板]] [ESP32] [[Image:hot.gif]]
*[[BPI-Bit-S2 STEAM 教育开发板]][ESP32-S2]
*[[BPI-Smart STEAM教育开发板]] [ESP8266]
|width="10%" valign="top" align="left"|
*[[BPI-UNO32 Arduino开发板]] [ESP32] [[Image:hot.gif]]
*[[BPI-Leaf-S2 开发板]][ESP32-S2]
*[[BPI-Leaf-S3 开发板]][ESP32-S3]
*[[BPI-PicoW-S3 开发板]][ESP32-S3]
*[[BPI-Centi-S3 开发板]][ESP32-S3 ST7789]
*[[BPI-Pico-RP2040 开发板]][RP2040]
|width="10%" valign="top" align="left"|
*[[BPI-NANO Arduino开源开发板]] [ATmega328P]
*[[BPI-UNO Arduino开源开发板]] [ATmega328P]

|}

Banana Pi Webduino & Arduino & Micro:bit 主板扩展板

<div id="Banana Pi Webduino & Arduino boards Accessories"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="10%" valign="top" align="left"|
*[[ BPI-UNO32 shell compatible LEGO bricks ]] [[Image:hot.gif]]
*[[ BPI-bit acrylic shell compatible LEGO bricks ]]
|width="10%" valign="top" align="left"|
*[[ BPI:bit gpio expansion board ]]
*[[ BPI:bit robot 机器人扩展板]]
*[[ BPI:bit MoonCar 登月小车]]
*[[香蕉派 Q-Car]] [支持BPI:bit BPI:AI Micro:bit]
*[[香蕉派 Triode-Car]][支持BPI:bit Micro:bit]
|width="10%" valign="top" align="left"|
*[[ BPI-BT BLE 4.2 control module ]]
*[[BPI-Nano robot 机器人扩展板]]

|}

===香蕉派嵌入式工业控制网关方案===

*[[BPI-6202 嵌入式单板工控机]]
*[[BPI-5202 龙芯2K1000LA嵌入式单板工控机]]
*[[BPI-FSM1819D 伺服电机驱动控制器]]
*[[5G + 4G LTE + Wifi AC + 5千兆网口多卡聚合融合通信网关]] 采用MTK MT7622/7623N芯片设计
*[[基于BPI-M2 Ultra 的工业控制网关设计]] 采用Allwinner A40i芯片设计

===香蕉派IoT物联网开发板与技术解决方案===

<div id="Banana Pi"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="10%" valign="top" align="left"|
*[[BPI NB-IoT Linaro 96Boars]] [[Image:hot.gif]]
*[[BPI-CC2650 Zigbee BT Linaro 96Boars]] [[Image:hot.gif]]
*[[BPI Zigbee BT5.0 IoT module]]
*[[BPI-GSM module]]
*[[BPI-9600 IEEE 802.3af PoE module]]
*[[BPI-7402 IEEE 802.3at PoE module]]

|width="10%" valign="top" align="left"|
*[[BPI NB-BC95 NB-IoT ]] [[Image:hot.gif]]
*[[BPI Z-Wave Gateway IoT module]]
*[[4G module via USB]]
*[[BPI-PC101 gesture recognition module]]
*[[BPI-MT7615 802.11 ac wifi无线 4x4双频模块]]
*[[BPI NB-IOT Arduino]] [[Image:hot.gif]]
*[[Banana PI D1]]
*[[BPI-D2]][Rockchips RV1126]
*[[Banana PI G1]]

|width="10%" valign="top" align="left"|
*[[Banana PI BPI-FT8215Q FOC控制直流无刷马达驱动开发板]]
*[[Banana PI BPI-8132Q 三相电机控制开发板]]
|}

===香蕉派系列产品相关配件===
<div id="Banana Pi Webduino & Arduino Products"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="32%" valign="top" align="left"|
*[[香蕉派外壳]]
*[[IR remote control]]

|width="32%" valign="top" align="left"|
*[[7.0 LCD touch panel]]
*[[10.1 HDMI touch panel]] will coming soon
*[[Camera]]

|width="32%" valign="top" align="left"|
*[[BPI Open debugger board]]
*[[UniPi on BPI]]

|}

香蕉派系列 GPIO 扩展板

<div id="Banana Pi"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="32%" valign="top" align="left"|
*[[BPI LM75 Temperature Sensor Module]]
*[[BPI AD/DA extend module]]
*[[BPI Prototyping Pi Plate module]]
*[[BPI OLED Display Module]]
*[[OLED12832 Module]]

|width="32%" valign="top" align="left"|
*[[BPI I2C electric level conversion expand module]]
*[[BPI BerryClip Module]]
*[[BPI Uno Compatible Module]]
*[[BPI GPIO extend module T type]]
*[[BPI LCD 1602 display module]]

|width="32%" valign="top" align="left"|
*[[BPI RTC real time Module]]
*[[BPI I2C GPIO extend module]]
*[[BPI IO extend module]]
*[[BPI RGB LED Matrix Expansion Module]]
*[[BPI Uart Module]]
|}

=香蕉派产品软件镜像发布图=
* [[Image Release Map]]

=香蕉派 BPI 4.0 OEM & ODM 定制服务=

[[File:Factory.png]]

<div id="BPI 4.0"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="10%" valign="top" align="left"|
*[[广东比派科技有限公司公司介绍]]
|width="10%" valign="top" align="left"|
*[[BPI 4.0 定制服务]]
|width="10%" valign="top" align="left"|
*[[BPI 4.0 成功案例 ]]
|width="10%" valign="top" align="left"|
*[[BPI 产品认证 ]]
|width="10%" valign="top" align="left"|
*[[BPI 宣传推广 ]]

|}

=香蕉派（Banana Pi）资源支持=
<div id="Banana Pi"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="12%" valign="top" align="left"|
*[[BPI 开源社区合作伙伴]]
*[[BPI 开源硬件全球代理渠道]]
|width="12%" valign="top" align="left"|
*[http://www.banana-pi.org 英文官方网站]
*[http://forum.banana-pi.org/ 英文官方论坛]
*[http://www.banana-pi.org.cn 中文官方网站]
*[http://forum.banana-pi.org.cn 中文官方论坛]
|width="12%" valign="top" align="left"|
*[https://shop108780008.taobao.com/?spm=a1z10.1.0.0.EZ5mQu 香蕉派淘宝网官方网店]
*[https://pt.aliexpress.com/store/302756 香蕉派全球速卖通官方网店]
*[https://cn1001196335.en.alibaba.com/?spm=a2700.details.cordpanyb.2.3da524a13Ez5iC 香蕉派全球阿里巴巴官方网店]
*[http://www.banana-pi.org/shop.html 香蕉派全球代理商列表]
|width="12%" valign="top" align="left"|

*[https://www.facebook.com/groups/Banana.Pi.Community/ Facebook用户群组]
*[https://plus.google.com/u/0/communities/116770564125019694131 google group]
*官方QQ技术交流群：85785523
|}

首页

2023-11-13T06:30:05Z

Wind: /* 香蕉派快速上手使用并开始开发 */

[[en:Main_Page]]
<div id="快速开始"></div>
[[File:Website.jpg|thumb| [[香蕉派(Banana Pi) 开源社区生态与物联网整体技术解决方案]]]]
[[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|[[香蕉派 BPI-R3]] with MediaTek MT7986(Filogic 830)]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[香蕉派 BPI-M2S]] Amlogic A311D chip]]
[[File:Banana_Pi_BPI-R2_Pro_1_750.jpg|thumb|[[香蕉派 BPI-R2 Pro]] Rockchip RK3568 design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[香蕉派 BPI-M2 Pro]] S905x3 方案设计]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[香蕉派 BPI-M5 ]]Amlogic S905X3 方案设计]]
[[File:Banana_PI_BPI-F2P_3.JPG|thumb| [[香蕉派 BPI-F2P]]工业物联网网关开发板]]
[[File:Banana_Pi_BPI-F2S_1_.JPG|thumb| [[香蕉派 BPI-F2S]] with Sunplus SP7021]]
[[File:Banana_Pi_BPI-R64_1.jpg|thumb|[[香蕉派 BPI-R64]] MTK MT7622]]
[[File:O2A0500.jpg|thumb|[[香蕉派 BPI-W2]] Realtek RD1296]]
[[File:BPI-R2_3.JPG|thumb|[[香蕉派 BPI-R2]] MTK MT7623N]]
[[File:Banana_Pi_BPI-M4_1.jpg|thumb|[[香蕉派 BPI-M4]] Realtek RTD1395]]
[[File:Banana_pi_BPI-M64_1.jpg|thumb|[[香蕉派 BPI-M64]] Allwinner A64]]
[[File:Banana_pi_BPI-M3_1.jpg|thumb|[[香蕉派 BPI-M3]] Allwinner A83T]]
[[File:BPI-F2_zero_1.JPG|thumb|[[香蕉派 BPI-P2 Zero]] Allwinner H2+/H3/H5]]
[[File:Banana_pi_BPI-M2+_2.jpg|thumb|[[香蕉派 BPI-M2+]] Allwinner H3/H5/H2+]3]]
[[File:BPI-M2_zero_11.JPG|thumb|[[香蕉派 BPI-M2 ZERO]] Allwinner H2+/H3/H5]]
[[File:Banana_pi_BPI-M2_Ultra_2.JPG|thumb|[[香蕉派 BPI-M2U]] Allwinner R40/V40/A40i]]
[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[香蕉派 BPI-M2 Berry]] Allwinner R40/V40/A40i]]
[[File:Banana_pi_bpi-m2_magic_5.JPG|thumb|[[香蕉派 BPI-M2M]] Allwinner A33/R16]]
[[File:Banana_pi_BPI-R1_1.JPG|thumb|[[香蕉派 BPI-R1]] Allwinner A20]]
[[File:Banana_pi_BPI-M1+_1.jpg|thumb|[[香蕉派 BPI-M1+]] Allwinner A20]]
[[File:Banana_pi_BPI-M1_1.jpg|thumb|[[香蕉派 BPI-M1]] Allwinner A20]]

=香蕉派(Banana Pi)开源硬件项目介绍=

[[File:Website.jpg]]

[https://www.banana-pi.org.cn/ '''香蕉派（Banana Pi）''']是由[http://wiki.banana-pi.org/%E5%B9%BF%E4%B8%9C%E6%AF%94%E6%B4%BE%E7%A7%91%E6%8A%80%E6%9C%89%E9%99%90%E5%85%AC%E5%8F%B8%E5%85%AC%E5%8F%B8%E4%BB%8B%E7%BB%8D '''广东比派科技有限公司''']主导的一个开源硬件项目，专注在ARM，MCU系列开源硬件开发板，提供全开放的软件与硬件平台,打造基础技术开发平台。重点打造[[香蕉派(Banana Pi) 开源社区生态与物联网整体技术解决方案]].

全系列开源硬件产品，完整整合了语音，数据，视频系统平台,传感器。开发者可以灵活的在开源硬件基础平台上搭建各种应用平台。可以应用在物联网，AI 人工智能，工业互联网控制，STEAM教育等各方面。

欢迎加入[https://forum.banana-pi.org.cn/ '''Banana Pi中文官方论坛''']进行技术讨论，可以在[https://shop108780008.taobao.com/?spm=a1z10.1.0.0.EZ5mQu '''比派科技淘宝官方店''']购买样品进行DIY.

'''[[BPI 4.0 定制服务]]'''已经全球有100多个'''[[BPI 4.0 成功案例]]'''，为客户提供研发，生产，供应链管理，产品认证一站式服务。

==香蕉派快速上手使用并开始开发==
<div id="Banana Pi"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="12%" valign="top" align="left"|
*[[快速上手香蕉派镜像烧录与系统启动]]
*[[快速上手香蕉派 BPI-M1]] [[Image:hot.gif]]
*[[快速上手香蕉派 BPI-M1+]] [[Image:hot.gif]]
*[[快速上手香蕉派 BPI-P2 Zero]]
*[[快速上手香蕉派 BPI-M2 Ultra / BPI-M2 Berry]][[Image:hot.gif]]
*[[快速上手香蕉派 BPI-M2 Magic]][[Image:hot.gif]]
*[[快速上手香蕉派 BPI-M2 Zero]]
*[[快速上手香蕉派 BPI-M2+]] [[Image:hot.gif]]
*[[快速上手香蕉派 BPI-M64]]
*[[快速上手香蕉派 BPI-M3]][[Image:hot.gif]]
*[[快速上手香蕉派 BPI-M4 Berry]]

|width="12%" valign="top" align="left"|
*[[快速上手香蕉派 BPI-R1]][[Image:hot.gif]]
*[[快速上手香蕉派 BPI-R2]] [[Image:hot.gif]]
*[[快速上手香蕉派 BPI-W2]] [[Image:hot.gif]]
*[[Getting Started with R2PRO]]
*[[Getting Started with R64]]
*[[Getting Started with BPI-R3]]
*[[Getting Started with BPI-W3]]

|width="12%" valign="top" align="left"|

*[[Getting Started with M64]]
*[[Getting Started with M3]]
*[[Getting Started with M4]]
*[[Getting Started with M5/M2Pro]]
*[[Getting Started with M2S]]
*[[Getting Started with CM4]]
|}

=镜像和开发工具=
=== 嵌入式系统 ===
{| border="0" cellpadding="10" width="70%"
|-
|width="32%" valign="top" align="left"|

*[[Armbian]]
*[[Tina Linux]]
*[[Mainline Linux uboot 2019.07]]
|}

=== 开发工具 ===
{| border="0" cellpadding="10" width="70%"
|-
|width="32%" valign="top" align="left"|
*[[Using 4G module with BananaPi]]
*[[WiFi/AP/BT/BLE on BananaPi]]
*[[OpenCV 3.4x on BananaPi]]
*[[How to use DHT Sensor via banana pi]]
|}

=== Github编译源码 ===
* 香蕉派开源硬件源代码github : https://github.com/bpi-sinovoip
* STEAM教育产品源代码github : https://github.com/BPI-STEAM

=香蕉派（Banana Pi）开源硬件产品系列=

[https://pan.baidu.com/s/1QE18Hh2D1asNI1z9TFNspQ 香蕉派产品数码照片百度下载提取码: 4y75]
===香蕉派系列单板计算机: [[Banana Pi 单板计算机系列产品比较表]] ===
<div id="Banana Pi single board computer"></div >
{| border="0" cellpadding="10" width="70%"
|-
|width="32%" valign="top" align="left"|
*[[香蕉派 BPI-M1]] [Allwinner A20] [[Image:hot.gif]]
*[[香蕉派 BPI-M1+]] [Allwinner A20] [[Image:hot.gif]]
*[[香蕉派 BPI-M2 ZERO]] [Allwinner H2+/H3/H5] [[Image:hot.gif]]
*[[香蕉派 BPI-P2 Zero]] [allwinner H2+/H3/H5]
*[[香蕉派 BPI-M2+]] [Allwinner H3/H5/H2+] [[Image:hot.gif]]
*[[香蕉派 BPI-M2 Magic]] [Allwinner A33/R16] [[Image:hot.gif]]
*[[香蕉派 BPI-M2 Berry]] [Allwinner R40/V40/A40i] [[Image:hot.gif]]
*[[香蕉派 BPI-M2 Ultra]] [Allwinner R40/V40/A40i][[Image:hot.gif]]
*[[香蕉派 BPI-M64]] [Allwinner A64] [[Image:hot.gif]]
*[[香蕉派 BPI-M3]] [Allwinner A83T] [[Image:hot.gif]]

|width="32%" valign="top" align="left"|
*[[香蕉派 BPI-F2]] [Freescale IMX6]
*[[香蕉派 BPI-F2S]] [Sunplus SP7021 工业级开发板]
*[[香蕉派 BPI-F2P]] [Sunplus SP7021 工业控制网关开发板]
*[[香蕉派 BPI-S64 Core]] [Actions S700]
*[[香蕉派 BPI-M4]] [Realtek 1395]
*[[香蕉派 BPI-M4 Berry]][Allwinner H618]
*[[香蕉派 BPI-M5]] [Amlogic S905x3]
*[[香蕉派 BPI-M2 Pro]] [Amlogic S905x3]
*[[香蕉派 BPI-M2S]] [Amlogic A311D&S922X]
*[[香蕉派 BPI-M6]] [ Synaptics VS680]
*[[香蕉派 BPI-P2 Pro]] [Rockchip RK3308]

|}

===香蕉派系列开源智能路由器: [[Banana Pi 开源路由器产品系列比较表]]===

<div id="Banana Pi Webduino & Arduino Products"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="10%" valign="top" align="left"|
*[[香蕉派 BPI-R4]] [MTK MT7988(Filogic 880)]
*[[香蕉派 BPI-R3]] [MTK MT7986(Filogic 830)]
*[[香蕉派 BPI-R3 Mini]] [MTK MT7986(Filogic 830)]
*[[香蕉派 BPI-R64]] [MTK MT7622]
*[[香蕉派 BPI-R2]] [MTK MT7623N] [[Image:hot.gif]]
|width="10%" valign="top" align="left"|
*[[香蕉派 BPI-W3]] [Rockchip RK3588]
*[[香蕉派 BPI-R2 Pro]] [Rockchip RK3568]
*[[香蕉派 BPI-W2]] [Realtek 1296] [[Image:hot.gif]]
*[[香蕉派 BPI-R1]] [Allwinner A20]
*[[香蕉派 BPI-Wifi6 路由器]] [创耀科技 TR6560 + TR5220 wifi SOC]
|}

===Banana Pi Core board and development Kit===
<div id="Banana Pi AI"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="10%" valign="top" align="left"|
*[[香蕉派 BPI-CM2]] [Rockchip RK3568]
*[[香蕉派 BPI-CM4]] [Amlogic A311D]
*[[香蕉派 BPI-CM5]] [Amlogic A311D2]
|width="10%" valign="top" align="left"|
*[[BPI-RK3588 Core board and development Kit]] [Rochchip RK3588]
*[[香蕉派 BPI-W3]] [Rockchip RK3588 LGA core board]
*[[Banana Pi BPI-S64 Core]] [Actions S700]
|}

===香蕉派系列开源AI智能开发板===
<div id="Banana Pi AI"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="10%" valign="top" align="left"|
*[[BPI-AI-Voice (Microsemi)]] [[Image:hot.gif]]
*[[BPI-EAI80 AIoT 开发板]] 格力零边界 EAI80芯片方案
|width="10%" valign="top" align="left"|
*[[BPI-R18-AI 语音麦克风陈列开发套件(Allwinner SoC-Only 3-Mic Far-Field Dev Kit) ]][[Image:hot.gif]]
|width="10%" valign="top" align="left"|
*[[AIWorld P1]]
|}

===香蕉派 Webduino & Arduino & MicroPython 产品系列===

Banana Pi Webduino & Arduino & MicroPython 主板

<div id="Banana Pi Webduino & Arduino & MicroPython Products"></div>
{| border="0" cellpadding="10" width="70%"
|width="10%" valign="top" align="left"|
*[[BPI-Bit STEAM 教育开发板]] [ESP32] [[Image:hot.gif]]
*[[BPI-Bit-S2 STEAM 教育开发板]][ESP32-S2]
*[[BPI-Smart STEAM教育开发板]] [ESP8266]
|width="10%" valign="top" align="left"|
*[[BPI-UNO32 Arduino开发板]] [ESP32] [[Image:hot.gif]]
*[[BPI-Leaf-S2 开发板]][ESP32-S2]
*[[BPI-Leaf-S3 开发板]][ESP32-S3]
*[[BPI-PicoW-S3 开发板]][ESP32-S3]
*[[BPI-Centi-S3 开发板]][ESP32-S3 ST7789]
*[[BPI-Pico-RP2040 开发板]][RP2040]
|width="10%" valign="top" align="left"|
*[[BPI-NANO Arduino开源开发板]] [ATmega328P]
*[[BPI-UNO Arduino开源开发板]] [ATmega328P]

|}

Banana Pi Webduino & Arduino & Micro:bit 主板扩展板

<div id="Banana Pi Webduino & Arduino boards Accessories"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="10%" valign="top" align="left"|
*[[ BPI-UNO32 shell compatible LEGO bricks ]] [[Image:hot.gif]]
*[[ BPI-bit acrylic shell compatible LEGO bricks ]]
|width="10%" valign="top" align="left"|
*[[ BPI:bit gpio expansion board ]]
*[[ BPI:bit robot 机器人扩展板]]
*[[ BPI:bit MoonCar 登月小车]]
*[[香蕉派 Q-Car]] [支持BPI:bit BPI:AI Micro:bit]
*[[香蕉派 Triode-Car]][支持BPI:bit Micro:bit]
|width="10%" valign="top" align="left"|
*[[ BPI-BT BLE 4.2 control module ]]
*[[BPI-Nano robot 机器人扩展板]]

|}

===香蕉派嵌入式工业控制网关方案===

*[[BPI-6202 嵌入式单板工控机]]
*[[BPI-5202 龙芯2K1000LA嵌入式单板工控机]]
*[[BPI-FSM1819D 伺服电机驱动控制器]]
*[[5G + 4G LTE + Wifi AC + 5千兆网口多卡聚合融合通信网关]] 采用MTK MT7622/7623N芯片设计
*[[基于BPI-M2 Ultra 的工业控制网关设计]] 采用Allwinner A40i芯片设计

===香蕉派IoT物联网开发板与技术解决方案===

<div id="Banana Pi"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="10%" valign="top" align="left"|
*[[BPI NB-IoT Linaro 96Boars]] [[Image:hot.gif]]
*[[BPI-CC2650 Zigbee BT Linaro 96Boars]] [[Image:hot.gif]]
*[[BPI Zigbee BT5.0 IoT module]]
*[[BPI-GSM module]]
*[[BPI-9600 IEEE 802.3af PoE module]]
*[[BPI-7402 IEEE 802.3at PoE module]]

|width="10%" valign="top" align="left"|
*[[BPI NB-BC95 NB-IoT ]] [[Image:hot.gif]]
*[[BPI Z-Wave Gateway IoT module]]
*[[4G module via USB]]
*[[BPI-PC101 gesture recognition module]]
*[[BPI-MT7615 802.11 ac wifi无线 4x4双频模块]]
*[[BPI NB-IOT Arduino]] [[Image:hot.gif]]
*[[Banana PI D1]]
*[[BPI-D2]][Rockchips RV1126]
*[[Banana PI G1]]

|width="10%" valign="top" align="left"|
*[[Banana PI BPI-FT8215Q FOC控制直流无刷马达驱动开发板]]
*[[Banana PI BPI-8132Q 三相电机控制开发板]]
|}

===香蕉派系列产品相关配件===
<div id="Banana Pi Webduino & Arduino Products"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="32%" valign="top" align="left"|
*[[香蕉派外壳]]
*[[IR remote control]]

|width="32%" valign="top" align="left"|
*[[7.0 LCD touch panel]]
*[[10.1 HDMI touch panel]] will coming soon
*[[Camera]]

|width="32%" valign="top" align="left"|
*[[BPI Open debugger board]]
*[[UniPi on BPI]]

|}

香蕉派系列 GPIO 扩展板

<div id="Banana Pi"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="32%" valign="top" align="left"|
*[[BPI LM75 Temperature Sensor Module]]
*[[BPI AD/DA extend module]]
*[[BPI Prototyping Pi Plate module]]
*[[BPI OLED Display Module]]
*[[OLED12832 Module]]

|width="32%" valign="top" align="left"|
*[[BPI I2C electric level conversion expand module]]
*[[BPI BerryClip Module]]
*[[BPI Uno Compatible Module]]
*[[BPI GPIO extend module T type]]
*[[BPI LCD 1602 display module]]

|width="32%" valign="top" align="left"|
*[[BPI RTC real time Module]]
*[[BPI I2C GPIO extend module]]
*[[BPI IO extend module]]
*[[BPI RGB LED Matrix Expansion Module]]
*[[BPI Uart Module]]
|}

=香蕉派产品软件镜像发布图=
* [[Image Release Map]]

=香蕉派 BPI 4.0 OEM & ODM 定制服务=

[[File:Factory.png]]

<div id="BPI 4.0"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="10%" valign="top" align="left"|
*[[广东比派科技有限公司公司介绍]]
|width="10%" valign="top" align="left"|
*[[BPI 4.0 定制服务]]
|width="10%" valign="top" align="left"|
*[[BPI 4.0 成功案例 ]]
|width="10%" valign="top" align="left"|
*[[BPI 产品认证 ]]
|width="10%" valign="top" align="left"|
*[[BPI 宣传推广 ]]

|}

=香蕉派（Banana Pi）资源支持=
<div id="Banana Pi"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="12%" valign="top" align="left"|
*[[BPI 开源社区合作伙伴]]
*[[BPI 开源硬件全球代理渠道]]
|width="12%" valign="top" align="left"|
*[http://www.banana-pi.org 英文官方网站]
*[http://forum.banana-pi.org/ 英文官方论坛]
*[http://www.banana-pi.org.cn 中文官方网站]
*[http://forum.banana-pi.org.cn 中文官方论坛]
|width="12%" valign="top" align="left"|
*[https://shop108780008.taobao.com/?spm=a1z10.1.0.0.EZ5mQu 香蕉派淘宝网官方网店]
*[https://pt.aliexpress.com/store/302756 香蕉派全球速卖通官方网店]
*[https://cn1001196335.en.alibaba.com/?spm=a2700.details.cordpanyb.2.3da524a13Ez5iC 香蕉派全球阿里巴巴官方网店]
*[http://www.banana-pi.org/shop.html 香蕉派全球代理商列表]
|width="12%" valign="top" align="left"|

*[https://www.facebook.com/groups/Banana.Pi.Community/ Facebook用户群组]
*[https://plus.google.com/u/0/communities/116770564125019694131 google group]
*官方QQ技术交流群：85785523
|}

Main Page

2023-11-13T06:28:53Z

Wind: /* Getting Started */

[[zh:首页]]
<div id="GettingStarted"></div>

[[File:Website.jpg|thumb|[[Banana Pi open source community ecology and Internet of things overall technical solutions]]]]
[[File:Banana_Pi_BPI-R4_1.jpg|thumb|[[Banana Pi BPI-R4]] with MediaTek Filogic 800 (MT7988)]]
[[File:Banana_Pi_BPI-R3_Mini__1.jpg|thumb|[[Banana Pi BPI-R3 Mini]] with MediaTek MT7986(Filogic 830)]]
[[File:Banana_Pi_BPI-P2_Pro_1.jpg|thumb|[[Banana Pi BPI-P2 Pro]] with Rockchip RK3308]]
[[File:Banana_Pi_BPI-M6_1.jpg|thumb|[[Banana Pi BPI-M6]] with Synaptics VS680]]
[[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-CM5_1.jpg|thumb|[[Banana Pi BPI-CM5]] with A311D2 design]]
[[File:BananaPi_BPI-CM4_base_board_1.jpg|thumb|[[Banana Pi BPI-CM4 ]] with Amlogic A311D design]]
[[File:Banana_Pi_BPI-CM2_1.jpg|thumb|[[Banana Pi BPI-CM2]] with Rockchip RK3568 ]]
[[File:Banana_Pi_BPI-M2S_1.jpg|thumb|[[Banana Pi BPI-M2S]] Amlogic A311D chip]]
[[File:Banana_Pi_BPI-R2_Pro_1_750.jpg|thumb|[[Banana Pi BPI-R2 Pro]] Rockchip RK3568 design]]
[[File:BPI-M2_Pro_2.jpg|thumb|[[Banana Pi BPI-M2 Pro]] S905x3 design]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5 ]]Amlogic S905X3 Processor]]
[[File:Banana_PI_BPI-F2P_3.JPG|thumb| [[Banana Pi BPI-F2P]] Sunplus SP7021 industrial control board ]]
[[File:Banana_Pi_BPI-F2S_1_.JPG|thumb| [[Banana Pi BPI-F2S]] with Sunplus SP7021]]
[[File:BPI-R64_3.JPG|thumb|[[Banana Pi BPI-R64]] MTK MT7622]]
[[File:O2A0500.jpg|thumb|[[Banana Pi BPI-W2]] Realtek RD1296]]
[[File:Banana_pi_BPI-M64_1.jpg|thumb|[[Banana Pi BPI-M64]] Allwinner A64]]
[[File:Banana_pi_BPI-M3_1.jpg|thumb|[[Banana Pi BPI-M3]] Allwinner A83T]]
[[File:BPI-F2_zero_1.JPG|thumb|[[Banana Pi BPI-P2 Zero]] Allwinner H2+/H3/H5]]
[[File:Banana_pi_BPI-M2+_2.jpg|thumb|[[Banana Pi BPI-M2+]] Allwinner H3/H5/H2+]3]]
[[File:BPI-M2_zero_11.JPG|thumb|[[Banana Pi BPI-M2 ZERO]] Allwinner H2+/H3/H5]]
[[File:Banana_pi_BPI-M2_Ultra_2.JPG|thumb|[[Banana Pi BPI-M2U]] Allwinner R40/V40/A40i]]
[[File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[Banana Pi BPI-M2 Berry]] Allwinner R40/V40/A40i]]
[[File:Banana_pi_bpi-m2_magic_5.JPG|thumb|[[Banana Pi BPI-M2M]] Allwinner A33/R16]]
[[File:Banana_pi_BPI-R1_1.JPG|thumb|[[Banana Pi BPI-R1]] Allwinner A20]]
[[File:Banana_pi_BPI-M1+_1.jpg|thumb|[[Banana Pi BPI-M1+]] Allwinner A20]]
[[File:Banana_pi_BPI-M1_1.jpg|thumb|[[Banana Pi BPI-M1]] Allwinner A20]]
[[File:BPI-R2_3.JPG|thumb|[[Banana Pi BPI-R2]] MTK MT7623N]]
[[File:Banana_Pi_BPI-M4_1.jpg|thumb|[[Banana Pi BPI-M4]] Realtek RTD1395]]

=About Banana Pi Open source project=

[[File:Website.jpg]]

[http://www.banana-pi.org/ '''Banana Pi'''] is an open source hardware project lead by [http://wiki.banana-pi.org/About_BPI '''GuangDong BiPai technology co., LTD''']. It focuses on the open source hardware development board of ARM and MCU series, provides open software and hardware platform, and creates the basic technology development platform. Full series open source hardware products, complete integration of voice, data, video system platform. Developers can flexibly build various application platforms on the open source hardware foundation platform. It can be applied in the Internet of things, AI artificial intelligence, industrial Internet control, STEAM education and other aspects.Create [[banana Pi open source community ecology and Internet of things overall technical solutions]].

Welcome free discuss on [http://forum.banana-pi.org/ '''Banana Pi Forum''' ], 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 new link [https://drive.google.com/drive/folders/0B4PAo2nW2Kfndjh6SW9MS2xKSWs?resourcekey=0-qXGFXKmd7AVy0S81OXM1RA&usp=sharing '''Documents'''] and [https://drive.google.com/drive/folders/0B_YnvHgh2rwjVjNyS2pheEtWQlk?resourcekey=0-U4TI84zIBdId7bHHjf2qKA '''Image''' ]

Easy to buy sample from [https://pt.aliexpress.com/store/302756 '''SinoVoip aliexpress online shop'''] and [https://www.aliexpress.com/store/1101951077 '''BPI aliexpress online shop''']

'''[[BPI 4.0 Server]]''' has served more than 200 '''[[Successful case]]''' around the world, providing one-stop service of r&d, production, supply chain management and product certification for customers.

=Getting Started=
<div id="Banana Pi"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="12%" valign="top" align="left"|
*[[Getting Started with M1]]
*[[Getting Started with M1P]]
*[[Getting Started with M2 Ultra / Berry]]
*[[Getting Started with M2M]]
*[[Getting Started with P2-Zero]]
*[[Getting Started with M2 Zero]]
*[[Getting Started with M2P]]
*[[Getting Started with BPI-M4 Berry]]

|width="12%" valign="top" align="left"|
*[[Getting Started with R1]]
*[[Getting Started with R2]]
*[[Getting Started with R2PRO]]
*[[Getting Started with R64]]
*[[Getting Started with W2]]
*[[Getting Started with BPI-R3]]
*[[Getting Started with BPI-R3 MINI]]
*[[Getting Started with BPI-W3]]

|width="12%" valign="top" align="left"|

*[[Getting Started with M64]]
*[[Getting Started with M3]]
*[[Getting Started with M4]]
*[[Getting Started with M5/M2Pro]]
*[[Getting Started with M2S]]
*[[Getting Started with CM4]]
*[[Getting Started with BPI-M6]]
|}

=Software & Development Tools=
===Embedded Operating Systems===
{| border="0" cellpadding="10" width="70%"
|-
|width="32%" valign="top" align="left"|

*[[Armbian]]
*[[Tina Linux]]
*[[Mainline Linux uboot 2019.07]]
|}

=== Development Tools ===
{| border="0" cellpadding="10" width="70%"
|-
|width="32%" valign="top" align="left"|
*[[Using 4G module with Banana Pi]]
*[[WiFi/AP/BT/BLE on Banana Pi]]
*[[OpenCV 3.4x on Banana Pi]]
*[[How to bulid a image with BSP]]
*[[How to use DHT Sensor via banana pi]]
*[[How to get the log information for Banana Pi board]]
|}

=== Building from sources ===
* Banana PI SBC and Router source code on github : https://github.com/bpi-sinovoip
* STEAM education product source code on github : https://github.com/BPI-STEAM

=Products=

===Banana Pi single board computer : [[Banana Pi Series Comparison]] ===
<div id="Banana Pi single board computer"></div >
{| border="0" cellpadding="10" width="70%"
|-
|width="32%" valign="top" align="left"|
*[[Banana Pi BPI-M4 Berry]] [Allwinner H618]
*[[Banana Pi BPI-M4 Zero]] [Allwinner H618]
*[[Banana Pi BPI-M2 ZERO]] [Allwinner H3/H2+]
*[[Banana Pi BPI-P2 Zero]] [Allwinner H3/H2+]
*[[Banana Pi BPI-M2+]] [Allwinner H3/H2+]
*[[Banana Pi BPI-M2M]] [Allwinner A33/R16]
*[[Banana Pi BPI-M2 Berry]] [Allwinner R40/V40/A40i]
*[[Banana Pi BPI-M2U]] [Allwinner R40/V40/A40i]
*[[Banana Pi BPI-M64]] [Allwinner A64]
*[[Banana Pi BPI-M3]] [Allwinner A83T]
*[[Banana Pi BPI-M1]] [Allwinner A20]
*[[Banana Pi BPI-M1+]] [Allwinner A20]

|width="32%" valign="top" align="left"|
*[[Banana Pi BPI-M5]] [Amlogic S905X3]
*[[Banana Pi BPI-M2 Pro]] [Amlogic S905x3]
*[[Banana Pi BPI-M2S]] [Amlogic A311D&S922X]

*[[Banana Pi BPI-M6]] [ Synaptics VS680]
*[[Banana Pi BPI-P2 Pro]] [Rockchip RK3308]

*[[Banana Pi BPI-F2]] [Freescale IMX6 industrial-grade]
*[[Banana Pi BPI-F2S]] [SunPlus SP7021 industrial-grade]
*[[Banana Pi BPI-F2P]] [SunPlus SP7021 industrial control gateway board ]
*[[Banana Pi BPI-M4]] [Realtek RTD1395]

|}

===Banana pi smart router: [[Banana Pi router Comparison]]===

<div id="Banana Pi Webduino & Arduino Products"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="10%" valign="top" align="left"|
*[[Banana Pi BPI-R4]] [MTK Filogic 880 (MT7988)]
*[[Banana Pi BPI-R3]] [MTK MT7986(Filogic 830)]
*[[Banana Pi BPI-R3 Mini]] [MTK MT7986(Filogic 830)]
*[[Banana Pi BPI-R64]] [MTK MT7622]
*[[Banana Pi BPI-R2]] [MTK MT7623N]

|width="10%" valign="top" align="left"|
*[[Banana Pi BPI-W3]] [Rockchip RK3588]
*[[Banana Pi BPI-R2 Pro]] [Rockchip RK3568]
*[[Banana Pi BPI-W2]] [Realtek 1296]
*[[Banana Pi BPI-R1]] [Allwinner A20]
*[[Banana Pi BPI-Wifi6 Router]] [Triductor TR6560 + TR5220 wifi SOC]
|}

===Banana Pi Core board and development Kit===
<div id="Banana Pi AI"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="10%" valign="top" align="left"|
*[[Banana Pi BPI-CM2]] [Rockchip RK3568]
*[[Banana Pi BPI-CM4]] [Amlogic A311D]
*[[Banana Pi BPI-CM5]] [Amlogic A311D2]

|width="10%" valign="top" align="left"|
*[[BPI-RK3588 Core board and development Kit]] [Rochchip RK3588]
*[[BPI-W3 Core board and development Kit]] [Rochchip RK3588]
*[[Banana Pi BPI-S64 Core]] [Actions S700]
|}

===Banana Pi Compute Module Base Board===
<div id="Banana Pi AI"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="10%" valign="top" align="left"|
*[[Banana Pi BPI-CM4IO]]
|width="10%" valign="top" align="left"|
|}

===Banana Pi AI design===
<div id="Banana Pi AI"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="10%" valign="top" align="left"|
*[[BPI-K210 RISC-V AIoT board]]
*[[StarFive VisionFive JH7100 RISC-V Single Board Computer]]
|width="10%" valign="top" align="left"|
*[[BPI-AI-Voice (Microsemi)]]
*[[BPI-EAI80 AIoT board]] [Edgeless EAI80 ]
|width="10%" valign="top" align="left"|
*[[BPI-R18-AI(Allwinner SoC-Only 3-Mic Far-Field Dev Kit) ]]
|width="10%" valign="top" align="left"|
*[[AIWorld P1]]
|}

===Banana Pi Webduino & Arduino & MicroPython Products===

Banana Pi Webduino & Arduino & MicroPython boards

<div id="Banana Pi Webduino & Arduino & MicroPython Products"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="20%" valign="top" align="left"|

*[[BPI-Leaf-S3]] [ESP32-S3]
*[[BPI-PicoW-S3]] [ESP32-S3]
*[[BPI-Centi-S3]][ESP32-S3 ST7789]
*[[BPI-Pico-RP2040]] [RP2040]

|width="20%" valign="top" align="left"|
*[[BPI-AI]] [Kendryte K210 RISC-V for AI]
*[[BPI-Bit]] [ESP32 STEAM education]
*[[BPI-Bit-S2]] [ESP32-S2 STEAM education]
*[[BPI-Smart]] [ESP8266]

|width="20%" valign="top" align="left"|
*[[BPI-NANO arduino NANO board]] [ATmega328P]
*[[BPI-UNO arduino UNO board]] [ATmega328P]
*[[BPI-UNO32]] [ESP32 for Arduino]
|}

Banana Pi Webduino & Arduino & Micro:bit boards Accessories

<div id="Banana Pi Webduino & Arduino boards Accessories"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="10%" valign="top" align="left"|
*[[ BPI-UNO32 shell compatible LEGO bricks ]]
*[[ BPI-bit acrylic shell compatible LEGO bricks ]]
*[[BPI:bit MoonCar Kit]]［BPI:bit/micro:bit］
*[[BPI Q-Car kit]][BPI:bit/micro:bit]
*[[BPI Triode-Car kit]][support BPI:bit Micro:bit]

|width="10%" valign="top" align="left"|
*[[ BPI:bit gpio expansion board ]]［BPI:bit/micro:bit］
*[[ BPI:bit robot expansion board]]［BPI:bit］
*[[BPI:bit Sensor expansion board]]［BPI:bit］

|width="10%" valign="top" align="left"|
*[[ BPI-BT BLE 4.2 control module ]]
*[[BPI-Nano robot board]] [arduino nano]

|}

===Banana Pi Industrial control gateway design===
*[[BPI-6202 Embedded single board industrial computer]]
*[[BPI-5202 Loongson 2K1000LA Embedded single board industrial computer]]
*[[Awinner A40I for Industrial control gateway design]]
*[[BPI-KVM with Rockchip RK3568 for KVM over IP design]]
*[[BPI-FSM1819D Servo motor controller]]
*[[5G + 4G LTE+Wifi AC+Gigabit Multiplex aggregate route]]

===Banana Pi IoT===

<div id="Banana Pi"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="10%" valign="top" align="left"|

*[[BPI-9600 IEEE 802.3af PoE module]]
*[[BPI-9460 IEEE 802.3af Isolation Model PoE module]]
*[[BPI-7604 IEEE 802.3af PoE Splitter module]]
*[[BPI-7402 IEEE 802.3at PoE module]]
*[[BPI-6175 Single channel PoE++ BT PSE Module]]

|width="10%" valign="top" align="left"|
*[[BPI NB-IoT Linaro 96Boars]]
*[[BPI-CC2650 Zigbee BT Linaro 96Boars]]
*[[BPI Zigbee BT5.0 IoT module]]
*[[BPI-GSM module]]
*[[BPI NB-BC95 NB-IoT ]]
*[[BPI Z-Wave Gateway IoT module]]
*[[4G module via USB]]
*[[BPI-PC101 gesture recognition module]]
*[[BPI-MT7615 802.11 ac wifi 4x4 dual-band module]]

|width="10%" valign="top" align="left"|
*[[BPI NB-IOT Arduino]]
*[[Banana PI D1]]
*[[BPI-D2]][Rockchips RV1126]
*[[Banana PI G1]]
|}

===Banana Pi Accessories===
<div id="Banana Pi Webduino & Arduino Products"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="32%" valign="top" align="left"|
*[[case]]
*[[IR remote control]]

|width="32%" valign="top" align="left"|
*[[7.0 LCD touch panel]]
*[[10.1 MIPI touch panel]]
*[[10.1 HDMI touch panel]]
*[[Camera]]

|width="32%" valign="top" align="left"|
*[[BPI Open debugger board]]
*[[UniPi on BPI]]

|}

Banana Pi GPIO Extend board

<div id="Banana Pi"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="32%" valign="top" align="left"|
*[[BPI LM75 Temperature Sensor Module]]
*[[BPI AD/DA extend module]]
*[[BPI Prototyping Pi Plate module]]
*[[BPI OLED Display Module]]
*[[OLED12832 Module]]

|width="32%" valign="top" align="left"|
*[[BPI I2C electric level conversion expand module]]
*[[BPI BerryClip Module]]
*[[BPI Uno Compatible Module]]
*[[BPI GPIO extend module T type]]
*[[BPI LCD 1602 display module]]

|width="32%" valign="top" align="left"|
*[[BPI RTC real time Module]]
*[[BPI I2C GPIO extend module]]
*[[BPI IO extend module]]
*[[BPI RGB LED Matrix Expansion Module]]
*[[BPI Uart Module]]
|}

=Image Release Map=
* [[Image Release Map]]

=BPI4.0 OEM & ODM customized service=

[[File:Factory.png]]

<div id="BPI 4.0"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="10%" valign="top" align="left"|
*[[About BPI]]
|width="10%" valign="top" align="left"|
*[[BPI 4.0 Server]]
|width="10%" valign="top" align="left"|
*[[Successful case ]]
|width="10%" valign="top" align="left"|
*[[Product certification]]
|width="10%" valign="top" align="left"|
*[[Banana Pi Publicity and promotion ]]

|}

==Typical cases of [[Successful case]]==

MediaTek MT7622E/MT7623N [[5G + 4G LTE+Wifi AC+Gigabit Multiplex aggregate route]]

ESP32 [[Sweet fume machine Intelligent sleep meter design]]

[[Realtek RTD1296 Intelligent voice, video processing platform]]

[[Awinner A40I for Industrial control gateway design]]

=Banana Pi Support=

<div id="Banana Pi"></div>
{| border="0" cellpadding="10" width="70%"
|-
|width="12%" valign="top" align="left"|
*[[Banana Pi partners]]
*[[Banana Pi agents list]]
|width="12%" valign="top" align="left"|

*[http://www.banana-pi.org English Website]
*[http://forum.banana-pi.org/ English Forum]
*[http://www.banana-pi.org.cn 中文官方网站]
*[http://forum.banana-pi.org.cn 中文论坛]
|width="12%" valign="top" align="left"|
*[https://www.facebook.com/groups/Banana.Pi.Community/ Facebook group]
*[https://www.facebook.com/sinovoipbpi Facebook Page]
*[https://twitter.com/sinovoip Twitter]
*[https://www.linkedin.com/groups/6692107/ linkedin group]
*[https://www.youtube.com/c/lionwangsinovoip/featured YouTube Channel]
*[https://www.reddit.com/r/BananaPi/ Reddit Channel]

|width="12%" valign="top" align="left"|
*[https://shop108780008.taobao.com/?spm=a1z10.1.0.0.EZ5mQu Taobao online shop]
*[https://www.aliexpress.com/store/1101951077 BPI Aliexpress online shop]
*[https://www.aliexpress.com/store/1100417230 SinoVoip Aliexpress online shop]
*[https://cn1001196335.en.alibaba.com/?spm=a2700.details.cordpanyb.2.3da524a13Ez5iC Banana Pi Alibaba online shop]

|}

Getting Started with BPI-M4 Berry

2023-11-09T03:24:34Z

Wind: /* Use Audio Devices */

[[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]].

===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-m4-berry-xxx.img.zip
sudo balena local flash path/to/xxx-bpi-m4-berry-xxx.img.zip --drive /dev/disk2
sudo balena local flash path/to/xxx-bpi-m4-berry-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-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. Install image with bpi-tools on Linux, plug SDcard to Linux PC and run
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX

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

快速上手 BPI-M4 Berry

2023-11-09T03:23:18Z

Wind: /* 3.5mm 音频接口 */

[[en:Getting_Started_with_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]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，优先从SD卡启动。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[[Banana_Pi_BPI-M4_Berry#System_image | bananapi ubuntu/debian 镜像]]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于[[Banana_Pi_BPI-M4_Berry#System_image | bananapi ubuntu/debian 镜像]] 镜像。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX

===将镜像安装到eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，且已经正常启动。

2. 在终端输入以下命令：
<pre>
sudo bananapi-config
</pre>

3. 默认连续选择第一项并按下回车键，即可完成将Linux系统镜像安装到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. 最后一步操作将关机，此时断开电源，移除SD卡，重新上电，即可从eMMC启动。

===擦除eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，插入SD卡。默认会从SD卡启动。

2. 在终端输入命令lsblk，用于列出系统中的块设备信息,如硬盘、分区、磁盘等。

<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为SD卡，mmcblk1为eMMC，在终端中输入以下命令擦除eMMC，此过程需要消耗数分钟时间，且不可逆，注意备份重要数据。
<pre>
sudo dd if=/dev/zero of=/dev/mmcblk1
</pre>

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线。
:3.使用HDMI线连接显示器与BPI-M4 Berry，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Berry UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Berry，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Berry的IP地址，或在BPI-M4 Berry UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Berry已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Berry用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Berry在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Berry的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Berry板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Berry的USB接口中。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Berry Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

====3.5mm 音频接口====
:1.准备一个使用3.5mm插头的耳机或其他音频设备，将插头插入BPI-M4 Berry的3.5mm插孔中。
:2在设置的Sound栏中将输出设备设置为Audio Codec。
[[File:Bpi_m4_berry_ubuntu_6.jpg]]
:3.播放音频。
====终端命令播放音频文件====
<pre>
aplay -l #列出设备
aplay -D hw:0,0 [path] #播放指定路径的音频文件
</pre>

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4berry:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4berry:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===使用红外接收器===
:1.需要准备一个使用NEC格式的红外遥控。
:2.在终端输入以下命令即可开始接收红外信号。
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).

[https://manpages.ubuntu.com/manpages/focal/en/man1/ir-keytable.1.html ir-keytable 参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Berry在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

快速上手 BPI-M4 Berry

2023-11-09T03:22:35Z

Wind: /* 3.5mm 音频接口 */

[[en:Getting_Started_with_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]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，优先从SD卡启动。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[[Banana_Pi_BPI-M4_Berry#System_image | bananapi ubuntu/debian 镜像]]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于[[Banana_Pi_BPI-M4_Berry#System_image | bananapi ubuntu/debian 镜像]] 镜像。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX

===将镜像安装到eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，且已经正常启动。

2. 在终端输入以下命令：
<pre>
sudo bananapi-config
</pre>

3. 默认连续选择第一项并按下回车键，即可完成将Linux系统镜像安装到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. 最后一步操作将关机，此时断开电源，移除SD卡，重新上电，即可从eMMC启动。

===擦除eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，插入SD卡。默认会从SD卡启动。

2. 在终端输入命令lsblk，用于列出系统中的块设备信息,如硬盘、分区、磁盘等。

<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为SD卡，mmcblk1为eMMC，在终端中输入以下命令擦除eMMC，此过程需要消耗数分钟时间，且不可逆，注意备份重要数据。
<pre>
sudo dd if=/dev/zero of=/dev/mmcblk1
</pre>

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线。
:3.使用HDMI线连接显示器与BPI-M4 Berry，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Berry UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Berry，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Berry的IP地址，或在BPI-M4 Berry UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Berry已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Berry用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Berry在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Berry的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Berry板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Berry的USB接口中。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Berry Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

====3.5mm 音频接口====
:1.准备一个使用3.5mm插头的耳机或其他音频设备，将插头插入BPI-M4 Berry的3.5mm插孔中。
:2在设置的Sound栏中将输出设备设置为Audio Codec。
[[File:Bpi_m4_berry_ubuntu_6.jpg]]
:3.播放音频。
:4.终端命令播放音频文件。
<pre>
aplay -l #列出设备
aplay -D hw:0,0 [path] #播放指定路径的音频文件
</pre>

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4berry:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4berry:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===使用红外接收器===
:1.需要准备一个使用NEC格式的红外遥控。
:2.在终端输入以下命令即可开始接收红外信号。
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).

[https://manpages.ubuntu.com/manpages/focal/en/man1/ir-keytable.1.html ir-keytable 参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Berry在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

快速上手 BPI-M4 Berry

2023-11-09T03:22:00Z

Wind: /* 3.5mm 音频接口 */

[[en:Getting_Started_with_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]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，优先从SD卡启动。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[[Banana_Pi_BPI-M4_Berry#System_image | bananapi ubuntu/debian 镜像]]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于[[Banana_Pi_BPI-M4_Berry#System_image | bananapi ubuntu/debian 镜像]] 镜像。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX

===将镜像安装到eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，且已经正常启动。

2. 在终端输入以下命令：
<pre>
sudo bananapi-config
</pre>

3. 默认连续选择第一项并按下回车键，即可完成将Linux系统镜像安装到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. 最后一步操作将关机，此时断开电源，移除SD卡，重新上电，即可从eMMC启动。

===擦除eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，插入SD卡。默认会从SD卡启动。

2. 在终端输入命令lsblk，用于列出系统中的块设备信息,如硬盘、分区、磁盘等。

<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为SD卡，mmcblk1为eMMC，在终端中输入以下命令擦除eMMC，此过程需要消耗数分钟时间，且不可逆，注意备份重要数据。
<pre>
sudo dd if=/dev/zero of=/dev/mmcblk1
</pre>

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线。
:3.使用HDMI线连接显示器与BPI-M4 Berry，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Berry UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Berry，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Berry的IP地址，或在BPI-M4 Berry UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Berry已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Berry用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Berry在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Berry的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Berry板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Berry的USB接口中。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Berry Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

====3.5mm 音频接口====
:1.准备一个使用3.5mm插头的耳机或其他音频设备，将插头插入BPI-M4 Berry的3.5mm插孔中。
:2在设置的Sound栏中将输出设备设置为Audio Codec。
[[File:Bpi_m4_berry_ubuntu_6.jpg]]
:3.播放音频。
:4.终端命令播放音频文件。
[pre]
aplay -l #列出设备
aplay -D hw:0,0 [path] #播放指定路径的音频文件
[/pre]

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4berry:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4berry:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===使用红外接收器===
:1.需要准备一个使用NEC格式的红外遥控。
:2.在终端输入以下命令即可开始接收红外信号。
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).

[https://manpages.ubuntu.com/manpages/focal/en/man1/ir-keytable.1.html ir-keytable 参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Berry在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

快速上手 BPI-M4 Berry

2023-11-09T03:18:55Z

Wind: /* 3.5mm 音频接口 */

[[en:Getting_Started_with_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]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，优先从SD卡启动。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[[Banana_Pi_BPI-M4_Berry#System_image | bananapi ubuntu/debian 镜像]]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于[[Banana_Pi_BPI-M4_Berry#System_image | bananapi ubuntu/debian 镜像]] 镜像。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX

===将镜像安装到eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，且已经正常启动。

2. 在终端输入以下命令：
<pre>
sudo bananapi-config
</pre>

3. 默认连续选择第一项并按下回车键，即可完成将Linux系统镜像安装到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. 最后一步操作将关机，此时断开电源，移除SD卡，重新上电，即可从eMMC启动。

===擦除eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，插入SD卡。默认会从SD卡启动。

2. 在终端输入命令lsblk，用于列出系统中的块设备信息,如硬盘、分区、磁盘等。

<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为SD卡，mmcblk1为eMMC，在终端中输入以下命令擦除eMMC，此过程需要消耗数分钟时间，且不可逆，注意备份重要数据。
<pre>
sudo dd if=/dev/zero of=/dev/mmcblk1
</pre>

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线。
:3.使用HDMI线连接显示器与BPI-M4 Berry，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Berry UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Berry，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Berry的IP地址，或在BPI-M4 Berry UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Berry已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Berry用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Berry在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Berry的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Berry板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Berry的USB接口中。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Berry Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

====3.5mm 音频接口====
:1.准备一个使用3.5mm插头的耳机或其他音频设备，将插头插入BPI-M4 Berry的3.5mm插孔中。
:2在设置的Sound栏中将输出设备设置为Audio Codec。
[[File:Bpi_m4_berry_ubuntu_6.jpg]]
:3.播放音频。
:4.终端命令播放音频文件。

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4berry:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4berry:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===使用红外接收器===
:1.需要准备一个使用NEC格式的红外遥控。
:2.在终端输入以下命令即可开始接收红外信号。
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).

[https://manpages.ubuntu.com/manpages/focal/en/man1/ir-keytable.1.html ir-keytable 参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Berry在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

快速上手 BPI-M4 Berry

2023-11-09T02:13:58Z

Wind: /* 准备 */

[[en:Getting_Started_with_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]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，优先从SD卡启动。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[[Banana_Pi_BPI-M4_Berry#System_image | bananapi ubuntu/debian 镜像]]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于[[Banana_Pi_BPI-M4_Berry#System_image | bananapi ubuntu/debian 镜像]] 镜像。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX

===将镜像安装到eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，且已经正常启动。

2. 在终端输入以下命令：
<pre>
sudo bananapi-config
</pre>

3. 默认连续选择第一项并按下回车键，即可完成将Linux系统镜像安装到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. 最后一步操作将关机，此时断开电源，移除SD卡，重新上电，即可从eMMC启动。

===擦除eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，插入SD卡。默认会从SD卡启动。

2. 在终端输入命令lsblk，用于列出系统中的块设备信息,如硬盘、分区、磁盘等。

<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为SD卡，mmcblk1为eMMC，在终端中输入以下命令擦除eMMC，此过程需要消耗数分钟时间，且不可逆，注意备份重要数据。
<pre>
sudo dd if=/dev/zero of=/dev/mmcblk1
</pre>

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线。
:3.使用HDMI线连接显示器与BPI-M4 Berry，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Berry UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Berry，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Berry的IP地址，或在BPI-M4 Berry UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Berry已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Berry用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Berry在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Berry的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Berry板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Berry的USB接口中。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Berry Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

====3.5mm 音频接口====
:1.准备一个使用3.5mm插头的耳机或其他音频设备，将插头插入BPI-M4 Berry的3.5mm插孔中。
:2在设置的Sound栏中将输出设备设置为Audio Codec。
[[File:Bpi_m4_berry_ubuntu_6.jpg]]
:3.播放音频。

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4berry:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4berry:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===使用红外接收器===
:1.需要准备一个使用NEC格式的红外遥控。
:2.在终端输入以下命令即可开始接收红外信号。
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).

[https://manpages.ubuntu.com/manpages/focal/en/man1/ir-keytable.1.html ir-keytable 参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Berry在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

Getting Started with BPI-M4 Berry

2023-11-09T01:58:49Z

Wind: /* Prepare */

[[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]].

===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-m4-berry-xxx.img.zip
sudo balena local flash path/to/xxx-bpi-m4-berry-xxx.img.zip --drive /dev/disk2
sudo balena local flash path/to/xxx-bpi-m4-berry-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-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. Install image with bpi-tools on Linux, plug SDcard to Linux PC and run
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX

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

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

快速上手 BPI-M4 Berry

2023-11-09T01:50:32Z

Wind: /* 准备 */

[[en:Getting_Started_with_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]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，优先从SD卡启动。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[[Banana_Pi_BPI-M4_Berry#System_image | bananapi 4.9 bsp ubuntu/debian 镜像]]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于bananapi 4.9 bsp ubuntu/debian 镜像。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX

===将镜像安装到eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，且已经正常启动。

2. 在终端输入以下命令：
<pre>
sudo bananapi-config
</pre>

3. 默认连续选择第一项并按下回车键，即可完成将Linux系统镜像安装到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. 最后一步操作将关机，此时断开电源，移除SD卡，重新上电，即可从eMMC启动。

===擦除eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，插入SD卡。默认会从SD卡启动。

2. 在终端输入命令lsblk，用于列出系统中的块设备信息,如硬盘、分区、磁盘等。

<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为SD卡，mmcblk1为eMMC，在终端中输入以下命令擦除eMMC，此过程需要消耗数分钟时间，且不可逆，注意备份重要数据。
<pre>
sudo dd if=/dev/zero of=/dev/mmcblk1
</pre>

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线。
:3.使用HDMI线连接显示器与BPI-M4 Berry，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Berry UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Berry，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Berry的IP地址，或在BPI-M4 Berry UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Berry已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Berry用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Berry在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Berry的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Berry板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Berry的USB接口中。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Berry Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

====3.5mm 音频接口====
:1.准备一个使用3.5mm插头的耳机或其他音频设备，将插头插入BPI-M4 Berry的3.5mm插孔中。
:2在设置的Sound栏中将输出设备设置为Audio Codec。
[[File:Bpi_m4_berry_ubuntu_6.jpg]]
:3.播放音频。

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4berry:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4berry:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===使用红外接收器===
:1.需要准备一个使用NEC格式的红外遥控。
:2.在终端输入以下命令即可开始接收红外信号。
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).

[https://manpages.ubuntu.com/manpages/focal/en/man1/ir-keytable.1.html ir-keytable 参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Berry在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

快速上手 BPI-M4 Berry

2023-11-09T01:50:18Z

Wind: /* 准备 */

[[en:Getting_Started_with_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]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，优先从SD卡启动。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[[Banana_Pi_BPI-M4_Berry#System_image bananapi 4.9 bsp ubuntu/debian 镜像]]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于bananapi 4.9 bsp ubuntu/debian 镜像。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX

===将镜像安装到eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，且已经正常启动。

2. 在终端输入以下命令：
<pre>
sudo bananapi-config
</pre>

3. 默认连续选择第一项并按下回车键，即可完成将Linux系统镜像安装到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. 最后一步操作将关机，此时断开电源，移除SD卡，重新上电，即可从eMMC启动。

===擦除eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，插入SD卡。默认会从SD卡启动。

2. 在终端输入命令lsblk，用于列出系统中的块设备信息,如硬盘、分区、磁盘等。

<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为SD卡，mmcblk1为eMMC，在终端中输入以下命令擦除eMMC，此过程需要消耗数分钟时间，且不可逆，注意备份重要数据。
<pre>
sudo dd if=/dev/zero of=/dev/mmcblk1
</pre>

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线。
:3.使用HDMI线连接显示器与BPI-M4 Berry，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Berry UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Berry，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Berry的IP地址，或在BPI-M4 Berry UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Berry已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Berry用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Berry在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Berry的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Berry板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Berry的USB接口中。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Berry Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

====3.5mm 音频接口====
:1.准备一个使用3.5mm插头的耳机或其他音频设备，将插头插入BPI-M4 Berry的3.5mm插孔中。
:2在设置的Sound栏中将输出设备设置为Audio Codec。
[[File:Bpi_m4_berry_ubuntu_6.jpg]]
:3.播放音频。

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4berry:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4berry:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===使用红外接收器===
:1.需要准备一个使用NEC格式的红外遥控。
:2.在终端输入以下命令即可开始接收红外信号。
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).

[https://manpages.ubuntu.com/manpages/focal/en/man1/ir-keytable.1.html ir-keytable 参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Berry在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

快速上手 BPI-M4 Berry

2023-11-09T01:49:42Z

Wind: /* Linux */

[[en:Getting_Started_with_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]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，优先从SD卡启动。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[[Banana_Pi_BPI-M4_Berry#System_image]]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于bananapi 4.9 bsp ubuntu/debian 镜像。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX

===将镜像安装到eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，且已经正常启动。

2. 在终端输入以下命令：
<pre>
sudo bananapi-config
</pre>

3. 默认连续选择第一项并按下回车键，即可完成将Linux系统镜像安装到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. 最后一步操作将关机，此时断开电源，移除SD卡，重新上电，即可从eMMC启动。

===擦除eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，插入SD卡。默认会从SD卡启动。

2. 在终端输入命令lsblk，用于列出系统中的块设备信息,如硬盘、分区、磁盘等。

<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为SD卡，mmcblk1为eMMC，在终端中输入以下命令擦除eMMC，此过程需要消耗数分钟时间，且不可逆，注意备份重要数据。
<pre>
sudo dd if=/dev/zero of=/dev/mmcblk1
</pre>

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线。
:3.使用HDMI线连接显示器与BPI-M4 Berry，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Berry UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Berry，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Berry的IP地址，或在BPI-M4 Berry UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Berry已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Berry用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Berry在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Berry的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Berry板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Berry的USB接口中。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Berry Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

====3.5mm 音频接口====
:1.准备一个使用3.5mm插头的耳机或其他音频设备，将插头插入BPI-M4 Berry的3.5mm插孔中。
:2在设置的Sound栏中将输出设备设置为Audio Codec。
[[File:Bpi_m4_berry_ubuntu_6.jpg]]
:3.播放音频。

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4berry:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4berry:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===使用红外接收器===
:1.需要准备一个使用NEC格式的红外遥控。
:2.在终端输入以下命令即可开始接收红外信号。
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).

[https://manpages.ubuntu.com/manpages/focal/en/man1/ir-keytable.1.html ir-keytable 参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Berry在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

快速上手 BPI-M4 Berry

2023-11-09T01:49:24Z

Wind: /* 准备 */

[[en:Getting_Started_with_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]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，优先从SD卡启动。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[Banana_Pi_BPI-M4_Berry#System_image]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于bananapi 4.9 bsp ubuntu/debian 镜像。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX

===将镜像安装到eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，且已经正常启动。

2. 在终端输入以下命令：
<pre>
sudo bananapi-config
</pre>

3. 默认连续选择第一项并按下回车键，即可完成将Linux系统镜像安装到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. 最后一步操作将关机，此时断开电源，移除SD卡，重新上电，即可从eMMC启动。

===擦除eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，插入SD卡。默认会从SD卡启动。

2. 在终端输入命令lsblk，用于列出系统中的块设备信息,如硬盘、分区、磁盘等。

<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为SD卡，mmcblk1为eMMC，在终端中输入以下命令擦除eMMC，此过程需要消耗数分钟时间，且不可逆，注意备份重要数据。
<pre>
sudo dd if=/dev/zero of=/dev/mmcblk1
</pre>

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线。
:3.使用HDMI线连接显示器与BPI-M4 Berry，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Berry UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Berry，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Berry的IP地址，或在BPI-M4 Berry UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Berry已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Berry用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Berry在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Berry的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Berry板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Berry的USB接口中。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Berry Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

====3.5mm 音频接口====
:1.准备一个使用3.5mm插头的耳机或其他音频设备，将插头插入BPI-M4 Berry的3.5mm插孔中。
:2在设置的Sound栏中将输出设备设置为Audio Codec。
[[File:Bpi_m4_berry_ubuntu_6.jpg]]
:3.播放音频。

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4berry:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4berry:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===使用红外接收器===
:1.需要准备一个使用NEC格式的红外遥控。
:2.在终端输入以下命令即可开始接收红外信号。
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).

[https://manpages.ubuntu.com/manpages/focal/en/man1/ir-keytable.1.html ir-keytable 参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Berry在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

快速上手 BPI-M4 Berry

2023-11-09T01:48:58Z

Wind: /* 准备 */

[[en:Getting_Started_with_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]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，优先从SD卡启动。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[Banana_Pi_BPI-M4_Berry#System_image Linux镜像]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于bananapi 4.9 bsp ubuntu/debian 镜像。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX

===将镜像安装到eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，且已经正常启动。

2. 在终端输入以下命令：
<pre>
sudo bananapi-config
</pre>

3. 默认连续选择第一项并按下回车键，即可完成将Linux系统镜像安装到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. 最后一步操作将关机，此时断开电源，移除SD卡，重新上电，即可从eMMC启动。

===擦除eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，插入SD卡。默认会从SD卡启动。

2. 在终端输入命令lsblk，用于列出系统中的块设备信息,如硬盘、分区、磁盘等。

<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为SD卡，mmcblk1为eMMC，在终端中输入以下命令擦除eMMC，此过程需要消耗数分钟时间，且不可逆，注意备份重要数据。
<pre>
sudo dd if=/dev/zero of=/dev/mmcblk1
</pre>

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线。
:3.使用HDMI线连接显示器与BPI-M4 Berry，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Berry UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Berry，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Berry的IP地址，或在BPI-M4 Berry UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Berry已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Berry用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Berry在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Berry的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Berry板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Berry的USB接口中。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Berry Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

====3.5mm 音频接口====
:1.准备一个使用3.5mm插头的耳机或其他音频设备，将插头插入BPI-M4 Berry的3.5mm插孔中。
:2在设置的Sound栏中将输出设备设置为Audio Codec。
[[File:Bpi_m4_berry_ubuntu_6.jpg]]
:3.播放音频。

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4berry:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4berry:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===使用红外接收器===
:1.需要准备一个使用NEC格式的红外遥控。
:2.在终端输入以下命令即可开始接收红外信号。
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).

[https://manpages.ubuntu.com/manpages/focal/en/man1/ir-keytable.1.html ir-keytable 参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Berry在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

Getting Started with BPI-M4 Berry

2023-11-07T09:38:17Z

Wind: /* Install Image to SDcard */

[[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, but you should read the [Boot_Sequence boot sequence] at 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 [Linux Linux Image], and confirm that the md5 checksum is correct.

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

:7. The wiki guide is only for [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-m4-berry-xxx.img.zip
sudo balena local flash path/to/xxx-bpi-m4-berry-xxx.img.zip --drive /dev/disk2
sudo balena local flash path/to/xxx-bpi-m4-berry-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-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. Install image with bpi-tools on Linux, plug SDcard to Linux PC and run
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX

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

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

快速上手 BPI-M4 Berry

2023-11-07T09:35:32Z

Wind: /* 擦除eMMC */

[[en:Getting_Started_with_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]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，但您应该首先阅读[Boot_Sequence启动顺序]。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[Linux镜像]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于[bananapi 4.9 bsp ubuntu/debian镜像]。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX

===将镜像安装到eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，且已经正常启动。

2. 在终端输入以下命令：
<pre>
sudo bananapi-config
</pre>

3. 默认连续选择第一项并按下回车键，即可完成将Linux系统镜像安装到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. 最后一步操作将关机，此时断开电源，移除SD卡，重新上电，即可从eMMC启动。

===擦除eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，插入SD卡。默认会从SD卡启动。

2. 在终端输入命令lsblk，用于列出系统中的块设备信息,如硬盘、分区、磁盘等。

<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为SD卡，mmcblk1为eMMC，在终端中输入以下命令擦除eMMC，此过程需要消耗数分钟时间，且不可逆，注意备份重要数据。
<pre>
sudo dd if=/dev/zero of=/dev/mmcblk1
</pre>

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线。
:3.使用HDMI线连接显示器与BPI-M4 Berry，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Berry UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Berry，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Berry的IP地址，或在BPI-M4 Berry UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Berry已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Berry用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Berry在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Berry的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Berry板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Berry的USB接口中。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Berry Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

====3.5mm 音频接口====
:1.准备一个使用3.5mm插头的耳机或其他音频设备，将插头插入BPI-M4 Berry的3.5mm插孔中。
:2在设置的Sound栏中将输出设备设置为Audio Codec。
[[File:Bpi_m4_berry_ubuntu_6.jpg]]
:3.播放音频。

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4berry:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4berry:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===使用红外接收器===
:1.需要准备一个使用NEC格式的红外遥控。
:2.在终端输入以下命令即可开始接收红外信号。
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).

[https://manpages.ubuntu.com/manpages/focal/en/man1/ir-keytable.1.html ir-keytable 参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Berry在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

File:Bpi m4 berry mobaxterm 18.jpg

2023-11-07T09:31:03Z

Wind: Wind uploaded a new version of File:Bpi m4 berry mobaxterm 18.jpg

快速上手 BPI-M4 Berry

2023-11-07T09:29:50Z

Wind: /* 将镜像安装到eMMC */

[[en:Getting_Started_with_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]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，但您应该首先阅读[Boot_Sequence启动顺序]。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[Linux镜像]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于[bananapi 4.9 bsp ubuntu/debian镜像]。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX

===将镜像安装到eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，且已经正常启动。

2. 在终端输入以下命令：
<pre>
sudo bananapi-config
</pre>

3. 默认连续选择第一项并按下回车键，即可完成将Linux系统镜像安装到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. 最后一步操作将关机，此时断开电源，移除SD卡，重新上电，即可从eMMC启动。

===擦除eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，插入SD卡。默认会从SD卡启动。

2. 在终端输入命令<pre>lsblk</pre>，用于列出系统中的块设备信息,如硬盘、分区、磁盘等。

<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为SD卡，mmcblk1为eMMC，在终端中输入以下命令擦除eMMC，此过程需要消耗数分钟时间，且不可逆，注意备份重要数据。
<pre>
sudo dd if=/dev/zero of=/dev/mmcblk1
</pre>

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线。
:3.使用HDMI线连接显示器与BPI-M4 Berry，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Berry UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Berry，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Berry的IP地址，或在BPI-M4 Berry UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Berry已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Berry用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Berry在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Berry的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Berry板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Berry的USB接口中。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Berry Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

====3.5mm 音频接口====
:1.准备一个使用3.5mm插头的耳机或其他音频设备，将插头插入BPI-M4 Berry的3.5mm插孔中。
:2在设置的Sound栏中将输出设备设置为Audio Codec。
[[File:Bpi_m4_berry_ubuntu_6.jpg]]
:3.播放音频。

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4berry:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4berry:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===使用红外接收器===
:1.需要准备一个使用NEC格式的红外遥控。
:2.在终端输入以下命令即可开始接收红外信号。
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).

[https://manpages.ubuntu.com/manpages/focal/en/man1/ir-keytable.1.html ir-keytable 参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Berry在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

快速上手 BPI-M4 Berry

2023-11-07T09:20:44Z

Wind:

[[en:Getting_Started_with_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]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，但您应该首先阅读[Boot_Sequence启动顺序]。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[Linux镜像]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于[bananapi 4.9 bsp ubuntu/debian镜像]。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX

===将镜像安装到eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，且已经正常启动。

2. 在终端输入以下命令：
<pre>
sudo bananapi-config
</pre>

3. 默认连续选择第一项并按下回车键，即可完成将Linux系统镜像安装到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]]

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线。
:3.使用HDMI线连接显示器与BPI-M4 Berry，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Berry UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Berry，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Berry的IP地址，或在BPI-M4 Berry UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Berry已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Berry用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Berry在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Berry的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Berry板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Berry的USB接口中。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Berry Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

====3.5mm 音频接口====
:1.准备一个使用3.5mm插头的耳机或其他音频设备，将插头插入BPI-M4 Berry的3.5mm插孔中。
:2在设置的Sound栏中将输出设备设置为Audio Codec。
[[File:Bpi_m4_berry_ubuntu_6.jpg]]
:3.播放音频。

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4berry:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4berry:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===使用红外接收器===
:1.需要准备一个使用NEC格式的红外遥控。
:2.在终端输入以下命令即可开始接收红外信号。
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).

[https://manpages.ubuntu.com/manpages/focal/en/man1/ir-keytable.1.html ir-keytable 参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Berry在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

快速上手 BPI-M4 Berry

2023-11-07T09:18:03Z

Wind: /* 将镜像安装到eMMC */

[[en:Getting_Started_with_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]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，但您应该首先阅读[Boot_Sequence启动顺序]。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[Linux镜像]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于[bananapi 4.9 bsp ubuntu/debian镜像]。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX

===将镜像安装到eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，且已经正常启动。

2. 在终端输入以下命令：
<pre>
sudo bananapi-config
</pre>

3. 默认连续选择第一项并按下回车键，即可完成将Linux系统镜像安装到eMMC上的操作。

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线。
:3.使用HDMI线连接显示器与BPI-M4 Berry，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Berry UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Berry，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Berry的IP地址，或在BPI-M4 Berry UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Berry已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Berry用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Berry在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Berry的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Berry板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Berry的USB接口中。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Berry Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

====3.5mm 音频接口====
:1.准备一个使用3.5mm插头的耳机或其他音频设备，将插头插入BPI-M4 Berry的3.5mm插孔中。
:2在设置的Sound栏中将输出设备设置为Audio Codec。
[[File:Bpi_m4_berry_ubuntu_6.jpg]]
:3.播放音频。

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4berry:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4berry:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===使用红外接收器===
:1.需要准备一个使用NEC格式的红外遥控。
:2.在终端输入以下命令即可开始接收红外信号。
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).

[https://manpages.ubuntu.com/manpages/focal/en/man1/ir-keytable.1.html ir-keytable 参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Berry在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

File:Bpi m4 berry mobaxterm 18.jpg

2023-11-07T09:17:36Z

Wind:

File:Bpi m4 berry mobaxterm 17.jpg

2023-11-07T09:17:10Z

Wind:

File:Bpi m4 berry mobaxterm 16.jpg

2023-11-07T09:17:01Z

Wind:

File:Bpi m4 berry mobaxterm 15.jpg

2023-11-07T09:16:50Z

Wind:

File:Bpi m4 berry mobaxterm 14.jpg

2023-11-07T09:16:37Z

Wind:

File:Bpi m4 berry mobaxterm 13.jpg

2023-11-07T09:16:10Z

Wind:

File:Bpi m4 berry mobaxterm 12.jpg

2023-11-07T09:15:25Z

Wind:

快速上手 BPI-M4 Berry

2023-11-07T08:32:11Z

Wind: /* 将镜像安装到SD卡 */

[[en:Getting_Started_with_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]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，但您应该首先阅读[Boot_Sequence启动顺序]。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[Linux镜像]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于[bananapi 4.9 bsp ubuntu/debian镜像]。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX

===将镜像安装到eMMC===

1. 确保已经在一个SD卡中烧录了Linux镜像，且已经正常启动。

2. 在终端输入以下命令：

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线。
:3.使用HDMI线连接显示器与BPI-M4 Berry，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Berry UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Berry，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Berry的IP地址，或在BPI-M4 Berry UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Berry已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Berry用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Berry在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Berry的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Berry板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Berry的USB接口中。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Berry Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

====3.5mm 音频接口====
:1.准备一个使用3.5mm插头的耳机或其他音频设备，将插头插入BPI-M4 Berry的3.5mm插孔中。
:2在设置的Sound栏中将输出设备设置为Audio Codec。
[[File:Bpi_m4_berry_ubuntu_6.jpg]]
:3.播放音频。

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4berry:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4berry:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===使用红外接收器===
:1.需要准备一个使用NEC格式的红外遥控。
:2.在终端输入以下命令即可开始接收红外信号。
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).

[https://manpages.ubuntu.com/manpages/focal/en/man1/ir-keytable.1.html ir-keytable 参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Berry在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

快速上手 BPI-M4 Zero

2023-11-07T01:39:54Z

Wind: /* 使用USB存储设备 */

[[en:Getting_Started_with_BPI-M4_Zero]]

[[File:BPI-M2_zero_11.JPG|thumb|[[Banana Pi BPI-M2 ZERO]] with Allwinner H3 chip]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，但您应该首先阅读[Boot_Sequence启动顺序]。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[Linux镜像]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于[bananapi 4.9 bsp ubuntu/debian镜像]。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-zero-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-zero-xxx.img.zip /dev/sdX

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线，一个mini HDMI转HDMI转接头。
:3.使用HDMI线连接显示器与BPI-M4 Zero，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Zero UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Zero，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Zero的IP地址，或在BPI-M4 Zero UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Zero已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Zero用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Zero在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Zero的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
pi@bpi-m4zero:~$ 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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Zero板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Zero的USB接口中，如果是type-A插头的U盘，则还需要一个type-A转type-C转接头。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Zero Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线和mini HDMI转HDMI转接头连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4zero:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4zero:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Zero在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

快速上手 BPI-M4 Zero

2023-11-07T01:38:53Z

Wind: /* HDMI音频 */

[[en:Getting_Started_with_BPI-M4_Zero]]

[[File:BPI-M2_zero_11.JPG|thumb|[[Banana Pi BPI-M2 ZERO]] with Allwinner H3 chip]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，但您应该首先阅读[Boot_Sequence启动顺序]。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[Linux镜像]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于[bananapi 4.9 bsp ubuntu/debian镜像]。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-zero-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-zero-xxx.img.zip /dev/sdX

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线，一个mini HDMI转HDMI转接头。
:3.使用HDMI线连接显示器与BPI-M4 Zero，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Zero UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Zero，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Zero的IP地址，或在BPI-M4 Zero UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Zero已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Zero用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Zero在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Zero的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
pi@bpi-m4zero:~$ 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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Zero板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Zero的USB接口中。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Zero Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线和mini HDMI转HDMI转接头连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4zero:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4zero:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Zero在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

快速上手 BPI-M4 Zero

2023-11-07T01:27:22Z

Wind: /* Ubuntu桌面 */

[[en:Getting_Started_with_BPI-M4_Zero]]

[[File:BPI-M2_zero_11.JPG|thumb|[[Banana Pi BPI-M2 ZERO]] with Allwinner H3 chip]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，但您应该首先阅读[Boot_Sequence启动顺序]。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[Linux镜像]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于[bananapi 4.9 bsp ubuntu/debian镜像]。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-zero-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-zero-xxx.img.zip /dev/sdX

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线，一个mini HDMI转HDMI转接头。
:3.使用HDMI线连接显示器与BPI-M4 Zero，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Zero UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Zero，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Zero的IP地址，或在BPI-M4 Zero UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Zero已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Zero用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Zero在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Zero的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
pi@bpi-m4zero:~$ 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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Zero板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Zero的USB接口中。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Zero Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4zero:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4zero:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Zero在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

快速上手 BPI-M4 Zero

2023-11-07T01:26:15Z

Wind:

[[en:Getting_Started_with_BPI-M4_Zero]]

[[File:BPI-M2_zero_11.JPG|thumb|[[Banana Pi BPI-M2 ZERO]] with Allwinner H3 chip]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，但您应该首先阅读[Boot_Sequence启动顺序]。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[Linux镜像]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于[bananapi 4.9 bsp ubuntu/debian镜像]。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-zero-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-zero-xxx.img.zip /dev/sdX

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线。
:3.使用HDMI线连接显示器与BPI-M4 Zero，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Zero UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Zero，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Zero的IP地址，或在BPI-M4 Zero UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Zero已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Zero用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Zero在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Zero的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
pi@bpi-m4zero:~$ 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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Zero板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Zero的USB接口中。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Zero Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4zero:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4zero:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Zero在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

快速上手 BPI-M4 Zero

2023-11-07T01:19:14Z

Wind: Created page with "en:Getting_Started_with_BPI-M4_Berry [[Banana Pi BPI-M2 ZERO with Allwinner H3 chip]] File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana..."

[[en:Getting_Started_with_BPI-M4_Berry]]

[[File:BPI-M2_zero_11.JPG|thumb|[[Banana Pi BPI-M2 ZERO]] with Allwinner H3 chip]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=开发=

==Linux==
===准备===
:1. Linux镜像支持SD卡或EMMC启动，但您应该首先阅读[Boot_Sequence启动顺序]。

:2. 建议使用A1级别的SD卡，至少8GB。

:3. 如果要从SD卡启动，确保可启动的EMMC已经格式化。

:4. 如果要从EMMC启动并将SD卡用作存储，确保SD卡已经格式化，没有刷入Linux镜像。

:5. 下载最新的[Linux镜像]，并确认md5校验和正确。

:6. 默认登录用户名：pi/bananapi或root/bananapi。

:7. Wiki指南仅适用于[bananapi 4.9 bsp ubuntu/debian镜像]。

===将镜像安装到SD卡===
:1. 在Windows、Linux和MacOS上使用Balena Etcher安装镜像。
: [https://balena.io/etcher Balena Etcher] 是Balena提供的开源GUI闪存工具，用于将操作系统镜像写入SD卡或USB驱动器。

:[[File:m2s_linux_flash.png]]

:2. 在Windows、Linux和MacOS上使用Balena Cli安装镜像。
:[https://github.com/balena-io/balena-cli Balena CLI] 是用于balenaCloud或openBalena的命令行界面。您可以从[https://github.com/balena-io/balena-cli/releases balena-io] 下载安装程序或独立包，然后正确安装到您的PC上，然后您可以使用balena的"[https://docs.balena.io/reference/balena-cli/#local-flash-image local flash]"命令将Linux镜像写入SD卡或USB驱动器。

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

:3. 在Linux上使用dd命令安装镜像，如果SD卡自动挂载，请取消挂载SD卡设备/dev/sdX分区。实际上，bpi-copy与此dd命令相同。
sudo apt-get install pv unzip
sudo unzip -p xxx-bpi-m4-zero-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. 使用bpi-tools在Linux上安装镜像，将SD卡插入Linux PC并运行以下命令：
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-zero-xxx.img.zip /dev/sdX

===启动===

====Ubuntu桌面====

:1.使用Ubuntu桌面版系统镜像，可以获得一个图形化操作界面。
:2.需要准备一台具备HDMI接口的显示器，一根HDMI线。
:3.使用HDMI线连接显示器与BPI-M4 Zero，切换显示器输入接口为对应HDMI接口，上电开机，等待片刻即可看到桌面。

[[File:Bpi_m4_berry_ubuntu_1.jpg]]

====Debug UART====
:1.准备一个3.3v USB转TTL模块。
:2.使用USB转TTL模块连接PC USB端口与板上的Debug UART端口。
:3.在PC端开启一个串行终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:4.以mobaxterm为例，设置串行端口编号和115200波特率后即可打开BPI-M4 Zero UART终端。

[[File:bpi_m4_berry_mobaxterm_1.jpg]]

[[File:bpi_m4_berry_mobaxterm_2.jpg]]

====SSH====
:1.准备一条网线，一个路由器。
:2.使用网线连接路由器的LAN口与BPI-M4 Zero，同时也将PC接入另一个LAN口。
:3.在路由器管理界面查看BPI-M4 Zero的IP地址，或在BPI-M4 Zero UART终端使用以下命令查看IP地址。
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.在PC端开启一个SSH终端软件，例如[https://mobaxterm.mobatek.net/ mobaxterm]或[https://www.putty.org/ putty]。
:5.以mobaxterm为例，将获得的IP地址，例如上文 192.168.3.10 ，填入IP地址栏，Port端口填入 22 。

[[File:bpi_m4_berry_mobaxterm_3.jpg]]

:6.打开SSH终端，输入登录用户名/密码：pi/bananapi 或 root/bananapi ，输入密码时无提示，请正常输入，完成后按Enter键即可。

[[File:bpi_m4_berry_mobaxterm_4.jpg]]

====NoMachine 远程桌面====
:1.确保BPI-M4 Zero已连接互联网，使用以下命令在系统中下载nomachine DEB安装包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

:2.或在PC浏览器打开[https://downloads.nomachine.com/download/?id=117&distro=ARM NoMachine for ARM - arm64下载页面] 下载DEB安装包，然后通过SSH或U盘拷贝到BPI-M4 Zero用户目录中。

:3.下载完成后，通过以下命令安装，注意文件名以实际下载的文件名为准。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

:4.PC端也需下载安装NoMachine，[https://download.nomachine.com NoMachine下载页面]选择适合PC操作系统的安装包，下载到本地并完成安装。

:5.注意保持PC与BPI-M4 Zero在同一个局域网中，可先尝试SSH连接确保局域网内通信正常。

:6.在PC端打开NoMachine，点击 Add 按钮，在跳转后的窗口中的Host栏输入BPI-M4 Zero的IP地址，再点击 Add 按钮。
[[File:Bpi_m4_berry_nomachine_1.jpg]]

:7.点击识别到的端口图标，在弹出的新窗口中输入用户名/密码，然后点击OK按钮。
[[File:Bpi_m4_berry_nomachine_2.jpg]]
[[File:Bpi_m4_berry_nomachine_3.jpg]]

:8.完后后续设置后，即可看到桌面。
[[File:Bpi_m4_berry_nomachine_4.jpg]]

:9.如果HDMI接口没有连接任何设备，NoMachine 远程桌面将显示黑屏，建议保持HDMI连接，或接入一个HDMI诱骗器。

===重启，关机===
:1.按RST按钮进行硬件重启，或输入重启命令：
reboot
:2.关机命令，关机后必须重新上电才可再次启动：
poweroff

===WiFi===
:使用 nmcli 命令可扫描WiFi热点，连接热点，创建AP热点。

nmcli device #列出设备
nmcli device wifi list # 列出可用的wifi接入点, list可以省略
nmcli device wifi connect [SSID] password [PASSWORD] # 连接热点mySSID, 连接成功后，就会自动生成配置文件，以后要再连接，就可以使用nmcli connection up [SSID]命令了
nmcli device disconnect [device name] # 断开wifi，使用nmcli device命令中显示的wifi设备名
nmcli device wifi hotspot con-name [NAME] ifname [device name] ssid [SSID] password [PASSWORD] # 创建AP热点

nmcli connection show #列出网络连接的配置
nmcli connection down [NAME] # 停用一个连接
nmcli connection up [NAME] # 激活一个连接
nmcli connection delete [SSID] #删除一个配置，不再保存信息和自动连接

nmcli radio wifi off # 关闭wifi
nmcli radio wifi on # 开启wifi

:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli.html nmcli 命令参考文档]
:* [https://developer-old.gnome.org/NetworkManager/unstable/nmcli-examples.html nmcli 命令参考用例]

===设置静态IP，DNS===
:1.设置静态IP需先保持连接，如果想设置以太网静态IP，则先保持以太网连接；如果想设置无线网静态IP，则先保持与一个WIFI的连接。
:2.如果上级路由器已经将你所想设置的IP地址分配给了其他设备，请更换到空闲的IP，或使其他设备让出该IP。
:3.使用 nmcli connection show 命令显示所有连接，例如：
pi@bpi-m4zero:~$ 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.使用 nmcli connection show [NAME]命令显示具体某个连接的所有属性，列如：
nmcli connection show TP-LINK_5G_7747 #如果想看以太网的则改为 Wired connection 1

#仅列举三个常用条目
ipv4.dns: 192.168.3.1 #默认为网关地址
ipv4.addresses: 192.168.3.10/24 #默认为路由器DHCP分配的IP地址
ipv4.gateway: 192.168.3.1 #网关地址，默认为路由器的IP地址

:5.设置静态IP:
nmcli connection modify TP-LINK_5G_7747 ipv4.addresses 192.168.3.2
:6.设置DNS:
nmcli connection modify TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS
:7.复位:
reboot
:8.再次启动后检查是否修改成功:
ifconfig
nmcli connection show TP-LINK_5G_7747

===网络时间同步===
:Chrony是一个开源自由的网络时间协议 NTP 的客户端和服务器软软件。它能让计算机保持系统时钟与时钟服务器（NTP）同步，因此让你的计算机保持精确的时间，Chrony也可以作为服务端软件为其他计算机提供时间同步服务。

timedatectl set-ntp false #禁用基于NTP的网络时间同步

sudo apt install chrony #安装chrony
systemctl start chrony #开启chrony
systemctl enable chrony
systemctl status chrony
systemctl restart chrony #重启服务

timedatectl status #查看时间同步状态
timedatectl list-timezones #查看时区列表
timedatectl set-timezone Asia/Shanghai #修改时区
timedatectl set-ntp true #开启NTP网络时间同步

date #查看时间
sudo hwclock -r #查看硬件时钟

:* [https://chrony-project.org/documentation.html Chrony 参考文档]

===查看硬件温度===
输入以下命令即可查看BPI-M4 Zero板上芯片内置传感器所回传的温度数据。
sensors

===修改HDMI输出分辨率===
:使用Ubuntu桌面版操作系统时，可以在Setting中找到Displays栏，修改分辨率。

[[File:Bpi_m4_berry_ubuntu_2.jpg]]

===使用USB存储设备===
:1.准备一个已经正常分区的U盘，插入BPI-M4 Zero的USB接口中。
:2.在Ubuntu桌面版中可以看到U盘已经被识别到并且可以在文件管理器中打开，也可通过GParted工具进行分区管理。

[[File:Bpi_m4_berry_ubuntu_3.jpg]]

:3.在终端挂载U盘到本地目录中：
mkdir mnt #在~/用户目录中创建一个单独的目录用于挂载，便于管理
cat /proc/partitions | grep "sd*" #列出sd开头的分区
sudo mount /dev/sda1 ~/mnt/ #将/dev/sda1挂载到~/mnt/
ls ~/mnt/ #挂载后即可列出U盘中的文件
sudo umount -v /dev/sda1 #卸载/dev/sda1，之后可移除U盘

===使用音频设备===
:准备一个音频文件，通过U盘或SSH等方式，拷贝到BPI-M4 Zero Ubuntu桌面版系统中。
====HDMI音频====
:1.准备一个具备HDMI音频输入功能的显示器，在显示器设置中开启相关功能，使用HDMI线连接显示器。
:2.在设置的Sound栏中将输出设备设置为HDMI Audio。
[[File:Bpi_m4_berry_ubuntu_4.jpg]]
:3.播放音频。
[[File:Bpi_m4_berry_ubuntu_5.jpg]]

===使用蓝牙===
:1.在Ubuntu桌面中打开设置，在Bluetooth栏中连接蓝牙设备，例如蓝牙鼠标或键盘。
[[File:Bpi_m4_berry_ubuntu_7.jpg]]
:2.在终端通过命令行连接蓝牙设备的方法如下：
<pre>
pi@bpi-m4zero:~$ sudo bluetoothctl #打开蓝牙设备管理工具
[sudo] password for pi:
Agent registered
[CHG] Controller 2C:C3:E6:AC:D5:D8 Pairable: yes
[bluetooth]# power on #启动蓝牙功能，power off关闭
Changing power on succeeded
[bluetooth]# discoverable on #允许本设备被发现
Changing discoverable on succeeded
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discoverable: yes
[bluetooth]# pairable on #允许设备配对
Changing pairable on succeeded
[bluetooth]# scan on #开始扫描
Discovery started
[CHG] Controller 2C:C3:E6:AC:D5:D8 Discovering: yes
[NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #一个蓝牙鼠标的MAC地址与设备名
[CHG] Device D4:C4:85:A5:C6:B1 TxPower: 4
[bluetooth]# pair D4:C4:85:A5:C6:B1 #配对想要连接的蓝牙设备的MAC地址
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 #配对成功
[CHG] Device D4:C4:85:A5:C6:B1 Modalias: usb:v046DpB021d0007
[bluetooth]# exit #退出蓝牙设备管理工具
pi@bpi-m4zero:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth参考文档]

===传输文件===
====scp====
Linux系统中的scp（secure copy）命令用于以安全的方式在服务器之间复制文件。

SCP命令或安全复制允许在本地主机和远程主机之间或两个远程主机之间安全传输文件。

它使用与Secure Shell（SSH）协议相同的身份验证和安全性。

可以在Windows终端中将文件拷贝至相同局域网中的Linux系统中，仅需确保已开启Open SSH客户端，在设置>应用>可选功能中可查看。
如果想在Linux系统中拷贝Windows系统中的文件，则还需开启Open SSH服务端。
:[[File:Bpi_m4_berry_mobaxterm_6.jpg]]

scp命令格式为:

:<pre>scp [optional] file_source file_target</pre>
::1.<nowiki>[optional]</nowiki> 为可选参数，例如 -r ，使用它即可递归复制整个目录。

::2.file_source 要拷贝的文件或目录。

::3.file_target 将要拷贝过去的路径，如果最后输入了具体文件名则对其重命名。

以在Windows系统中拷贝本地文件到Linux系统中为例，在Windows终端中输入：
:<pre>PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12:"/home/pi/Downloads/"</pre>

也可以在Windows终端中拷贝Linux系统中的文件到本地：
:<pre>PS D:\temp\temp_4> scp pi@192.168.3.12:"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"</pre>
:: 其中 pi@192.168.3.12 为Linux系统中的用户名和BPI-M4 Zero在局域网中的IP地址。
:: 其中 <nowiki>:"/home/pi/Downloads/hello.txt"</nowiki> 为Linux系统中的文件路径。
:: 其中 "D:\temp\temp_4" 为Windows系统中的路径。

[https://www.runoob.com/linux/linux-comm-scp.html scp 参考文档]

====mobaxterm====
使用 mobaxterm 或其他类似的软件，可通过图形化界面管理文件。
:[https://mobaxterm.mobatek.net/download.html mobaxterm 下载]
:[https://download.mobatek.net/mobaxterm-on-linux.html mobaxterm-linux 预览版]

如下图所示，在mobaxterm中建立SSH连接后，界面左侧就会出现文件管理窗口，支持以文件拖拽的方式进行复制粘贴。
:[[File:Bpi_m4_berry_mobaxterm_7.jpg]]

香蕉派 BPI-M4 Zero

2023-11-06T07:45:05Z

Wind:

[[en:Banana_Pi_BPI-M4_Zero]]

= 产品介绍 =

M4 Zero是M2 Zero的后续型号，在性能上有着巨大提升，SOC升级为H618, CPU频率提升25% 。内存升级为DDR4, 容量翻4倍，新增8G eMMC。支持5G WiFi, 另外USB接口也升级为type-C。

它的外形大小和40-pin接头与Raspberry Pi Zero W相同，它将适合Zero W的大部分外壳和配件。

=关键特性=
* Allwinner H618, Quad-core ARM Cortex™-A53 processor
* ARM Mali G31 GPU
* 2.4G/5G WIFI & Bluetooth 4.2
* 2G LPDDR4 RAM
* 8G eMMC flash memory
* 1x USB2.0 Type-C OTG, 5V power supply
* 1x USB2.0 Type-C
* 1x miniHDMI 2.0a
* 1x 24-pin FPC connector
** 1x USB2.0
** 1x 100Mbps Ethernet

=快速上手=
*[[快速上手 BPI-M4 Zero]]

=硬件=
==硬件接口==

==硬件规格==
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="2"| '''Hardware Specification of Banana pi BPI-M4 Zero'''
|-
| 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, SDIO3.0
|-
| Wireless || 2.4G/5G WiFi and Bluetooth 4.2
|-
| HDMI || 1x miniHDMI 2.0a (up to 4K@60Hz with HDR10, CEC, DDC, SCDC), HDMI digital Audio output
|-
| USB || 1x USB2.0 Type-C 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
|-
| rowspan="2" | 24-pin FPC
| 0.5mm pitch FPC connector， 1x USB2.0, 1x IR, 1x 100Mbps Ethernet
|-
| 9 pins GPIO, UART,TWI/I²C, PWM, PCM/I²S
|-
|Buttons|| Reset, FEL
|-
| LED || Power Status and Activity status
|-
| Power || 5V@3A via USB Type-C
|-
|Size || 65mm × 30mm
|-
|Weight ||
|}

==PIN 定义 ==

===BPI-M4 Zero 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;" |
|}
=== 24-pin FPC ===

{| class="wikitable" style="text-align:center;"
|-
| style="background: PaleTurquoise; color: black" colspan="6"| '''24-pin FPC define and GPIO Alternative Functions Assignments'''
|-
! Pin Num
! Pin Name
! ALT0
! ALT1
|-
| 1
| GND
|
|
|-
| 2
| EPHY_RXN
|
|
|-
| 3
| EPHY_RXP
|
|
|-
| 4
| EPHY_TXN
|
|
|-
| 5
| EPHY_TXP
|
|
|-
| 6
| GND
|
|
|-
| 7
| PI9
| UART3_TX
| TWI2_SCK
|-
| 8
| PI10
| UART3_RX
| TWI2_SDA
|-
| 9
| PI12
| UART3_CTS
| PWM2
|-
| 10
| PI11
| UART3_RTS
| PWM1
|-
| 11
| 3V3
|
|
|-
| 12
| 3V3
|
|
|-
| 13
| PI4
| H_I2S0_DIN0
| H_I2S0_DOUT1
|-
| 14
| PI3
| H_I2S0_DOUT0
| H_I2S0_DIN1
|-
| 15
| PI2
| H_I2S0_LRCK
|
|-
| 16
| PI1
| H_I2S0_BCLK
|
|-
| 17
| PI0
| H_I2S0_MCLK
|
|-
| 18
| GND
|
|
|-
| 19
| PH10
| IR_RX
|
|-
| 20
| 5V
|
|
|-
| 21
| 5V
|
|
|-
| 22
| USB2_DP
|
|
|-
| 23
| USB2_DM
|
|
|-
| 24
| GND
|
|
|-
|}

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

=开发=
==源码==

*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

==资源==
*BPI-M4 Zero Allwinner H618 SBC burn Ubuntu desktop image
*BPI-M4 Zero DXF file

*BPI-M4 Zero SBC bench test:

*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

=系统镜像=

=购买=

Getting Started with BPI-M4 Zero

2023-11-06T06:14:56Z

Wind: /* Use IR Receiver */

[[zh:快速上手_BPI-M4_Zero]]
[[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, but you should read the [Boot_Sequence boot sequence] at 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 [Linux Linux Image], and confirm that the md5 checksum is correct.

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

:7. The wiki guide is only for [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-m4-zero-xxx.img.zip
sudo balena local flash path/to/xxx-bpi-m4-zero-xxx.img.zip --drive /dev/disk2
sudo balena local flash path/to/xxx-bpi-m4-zero-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-m4-zero-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-m4-zero-xxx.img.zip /dev/sdX

===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, an HDMI cable, and a mini HDMI to HDMI adapter.
:3. Use an HDMI cable and a mini HDMI to HDMI adapter to connect the monitor and BPI-M4 Zero, 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 Zero 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 Zero, and also connect the PC to another LAN port.
:3. Check the IP address of BPI-M4 Zero on the router management interface, or use the following command on the BPI-M4 Zero 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 Zero 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 Zero 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 Zero 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 Zero 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-m4zero:~$ 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 Zero 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 Zero.If it is a USB disk with a type-A plug, you also need a type-A to type-C adapter.
: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 Zero 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, use an HDMI cable and a mini HDMI to HDMI adapter 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]]

===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-m4zero:~$ 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-m4zero:~$
</pre>

:[https://wiki.archlinux.org/title/bluetooth archlinux bluetooth 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 Zero 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]]

Getting Started with BPI-M4 Zero

2023-11-06T06:14:38Z

Wind: /* 3.5mm audio jack */

[[zh:快速上手_BPI-M4_Zero]]
[[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, but you should read the [Boot_Sequence boot sequence] at 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 [Linux Linux Image], and confirm that the md5 checksum is correct.

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

:7. The wiki guide is only for [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-m4-zero-xxx.img.zip
sudo balena local flash path/to/xxx-bpi-m4-zero-xxx.img.zip --drive /dev/disk2
sudo balena local flash path/to/xxx-bpi-m4-zero-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-m4-zero-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-m4-zero-xxx.img.zip /dev/sdX

===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, an HDMI cable, and a mini HDMI to HDMI adapter.
:3. Use an HDMI cable and a mini HDMI to HDMI adapter to connect the monitor and BPI-M4 Zero, 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 Zero 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 Zero, and also connect the PC to another LAN port.
:3. Check the IP address of BPI-M4 Zero on the router management interface, or use the following command on the BPI-M4 Zero 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 Zero 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 Zero 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 Zero 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 Zero 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-m4zero:~$ 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 Zero 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 Zero.If it is a USB disk with a type-A plug, you also need a type-A to type-C adapter.
: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 Zero 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, use an HDMI cable and a mini HDMI to HDMI adapter 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]]

===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-m4zero:~$ 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-m4zero:~$
</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 Zero 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]]

Getting Started with BPI-M4 Berry

2023-11-06T06:14:17Z

Wind: /* Use USB disk */

[[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, but you should read the [Boot_Sequence boot sequence] at 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 [Linux Linux Image], and confirm that the md5 checksum is correct.

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

:7. The wiki guide is only for [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-m4-berry-xxx.img.zip
sudo balena local flash path/to/xxx-bpi-m4-berry-xxx.img.zip --drive /dev/disk2
sudo balena local flash path/to/xxx-bpi-m4-berry-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-m4-berry-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer

:4. Install image with bpi-tools on Linux, plug SDcard to Linux PC and run
sudo apt-get install pv unzip
sudo bpi-copy xxx-bpi-m4-berry-xxx.img.zip /dev/sdX

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

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

Getting Started with BPI-M4 Zero

2023-11-06T06:13:57Z

Wind: /* Use USB disk */

[[zh:快速上手_BPI-M4_Zero]]
[[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, but you should read the [Boot_Sequence boot sequence] at 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 [Linux Linux Image], and confirm that the md5 checksum is correct.

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

:7. The wiki guide is only for [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-m4-zero-xxx.img.zip
sudo balena local flash path/to/xxx-bpi-m4-zero-xxx.img.zip --drive /dev/disk2
sudo balena local flash path/to/xxx-bpi-m4-zero-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-m4-zero-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-m4-zero-xxx.img.zip /dev/sdX

===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, an HDMI cable, and a mini HDMI to HDMI adapter.
:3. Use an HDMI cable and a mini HDMI to HDMI adapter to connect the monitor and BPI-M4 Zero, 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 Zero 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 Zero, and also connect the PC to another LAN port.
:3. Check the IP address of BPI-M4 Zero on the router management interface, or use the following command on the BPI-M4 Zero 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 Zero 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 Zero 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 Zero 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 Zero 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-m4zero:~$ 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 Zero 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 Zero.If it is a USB disk with a type-A plug, you also need a type-A to type-C adapter.
: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 Zero 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, use an HDMI cable and a mini HDMI to HDMI adapter 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 Zero.
: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.

===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-m4zero:~$ 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-m4zero:~$
</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 Zero 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]]

Getting Started with BPI-M4 Zero

2023-11-06T03:38:21Z

Wind: /* HDMI audio */

[[zh:快速上手_BPI-M4_Zero]]
[[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, but you should read the [Boot_Sequence boot sequence] at 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 [Linux Linux Image], and confirm that the md5 checksum is correct.

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

:7. The wiki guide is only for [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-m4-zero-xxx.img.zip
sudo balena local flash path/to/xxx-bpi-m4-zero-xxx.img.zip --drive /dev/disk2
sudo balena local flash path/to/xxx-bpi-m4-zero-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-m4-zero-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-m4-zero-xxx.img.zip /dev/sdX

===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, an HDMI cable, and a mini HDMI to HDMI adapter.
:3. Use an HDMI cable and a mini HDMI to HDMI adapter to connect the monitor and BPI-M4 Zero, 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 Zero 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 Zero, and also connect the PC to another LAN port.
:3. Check the IP address of BPI-M4 Zero on the router management interface, or use the following command on the BPI-M4 Zero 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 Zero 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 Zero 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 Zero 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 Zero 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-m4zero:~$ 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 Zero 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 Zero.
:2. In the Ubuntu desktop version, you can see that the USB flash drive has been recognized and can be opened in the file manager, or partition management can be performed through the GParted tool.

[[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 Zero 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, use an HDMI cable and a mini HDMI to HDMI adapter 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 Zero.
: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.

===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-m4zero:~$ 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-m4zero:~$
</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 Zero 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]]

Getting Started with BPI-M4 Zero

2023-11-06T03:31:48Z

Wind: Created page with "zh:快速上手_BPI-M4_Zero [[Banana Pi BPI-M4 Berry H618 design]] File:Banana_pi_BPI-M2_Berry_5.JPG|thumb|[[Banana Pi BPI-M2..."

[[zh:快速上手_BPI-M4_Zero]]
[[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, but you should read the [Boot_Sequence boot sequence] at 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 [Linux Linux Image], and confirm that the md5 checksum is correct.

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

:7. The wiki guide is only for [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-m4-zero-xxx.img.zip
sudo balena local flash path/to/xxx-bpi-m4-zero-xxx.img.zip --drive /dev/disk2
sudo balena local flash path/to/xxx-bpi-m4-zero-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-m4-zero-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-m4-zero-xxx.img.zip /dev/sdX

===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, an HDMI cable, and a mini HDMI to HDMI adapter.
:3. Use an HDMI cable and a mini HDMI to HDMI adapter to connect the monitor and BPI-M4 Zero, 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 Zero 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 Zero, and also connect the PC to another LAN port.
:3. Check the IP address of BPI-M4 Zero on the router management interface, or use the following command on the BPI-M4 Zero 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 Zero 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 Zero 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 Zero 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 Zero 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-m4zero:~$ 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 Zero 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 Zero.
:2. In the Ubuntu desktop version, you can see that the USB flash drive has been recognized and can be opened in the file manager, or partition management can be performed through the GParted tool.

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

===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-m4zero:~$ 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-m4zero:~$
</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 Zero 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]]

Banana Pi BPI-M4 Zero

2023-11-06T02:47:37Z

Wind: /* 24-pin FPC */

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

[[File:BPI-M2_zero_11.JPG|thumb|[[Banana Pi BPI-M2 ZERO]] with Allwinner H3 chip]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=Introduction=
M4 Zero is the successor model of M2 Zero. It has a huge improvement in performance. The SOC is upgraded to H618 and the CPU frequency is increased by 25%. The memory is upgraded to DDR4, the capacity is quadrupled, and 8G eMMC is added. It supports 5G WiFi, and the USB interface has also been upgraded to type-C.

It has the same form factor and 40-pin connector as the Raspberry Pi Zero W, and it will fit most Zero W cases and accessories.

=Key Features=
* Allwinner H618, Quad-core ARM Cortex™-A53 processor
* ARM Mali G31 GPU
* 2.4G/5G WIFI & Bluetooth 4.2
* 2G LPDDR4 RAM
* 8G eMMC flash memory
* 1x USB2.0 Type-C OTG, 5V power supply
* 1x USB2.0 Type-C
* 1x miniHDMI 2.0a
* 1x 24-pin FPC connector
** 1x USB2.0
** 1x 100Mbps Ethernet

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

=Hardware=
==Hardware interface==

==Hardware spec==
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="2"| '''Hardware Specification of Banana pi BPI-M4 Zero'''
|-
| 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, SDIO3.0
|-
| Wireless || 2.4G/5G WiFi and Bluetooth 4.2
|-
| HDMI || 1x miniHDMI 2.0a (up to 4K@60Hz with HDR10, CEC, DDC, SCDC), HDMI digital Audio output
|-
| USB || 1x USB2.0 Type-C 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
|-
| rowspan="2" | 24-pin FPC
| 0.5mm pitch FPC connector， 1x USB2.0, 1x IR, 1x 100Mbps Ethernet
|-
| 9 pins GPIO, UART,TWI/I²C, PWM, PCM/I²S
|-
|Buttons|| Reset, FEL
|-
| LED || Power Status and Activity status
|-
| Power || 5V@3A via USB Type-C
|-
|Size || 65mm × 30mm
|-
|Weight ||
|}

==PIN define ==

===BPI-M4 Zero 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;" |
|}
=== 24-pin FPC ===

{| class="wikitable" style="text-align:center;"
|-
| style="background: PaleTurquoise; color: black" colspan="6"| '''24-pin FPC define and GPIO Alternative Functions Assignments'''
|-
! Pin Num
! Pin Name
! ALT0
! ALT1
|-
| 1
| GND
|
|
|-
| 2
| EPHY_RXN
|
|
|-
| 3
| EPHY_RXP
|
|
|-
| 4
| EPHY_TXN
|
|
|-
| 5
| EPHY_TXP
|
|
|-
| 6
| GND
|
|
|-
| 7
| PI9
| UART3_TX
| TWI2_SCK
|-
| 8
| PI10
| UART3_RX
| TWI2_SDA
|-
| 9
| PI12
| UART3_CTS
| PWM2
|-
| 10
| PI11
| UART3_RTS
| PWM1
|-
| 11
| 3V3
|
|
|-
| 12
| 3V3
|
|
|-
| 13
| PI4
| H_I2S0_DIN0
| H_I2S0_DOUT1
|-
| 14
| PI3
| H_I2S0_DOUT0
| H_I2S0_DIN1
|-
| 15
| PI2
| H_I2S0_LRCK
|
|-
| 16
| PI1
| H_I2S0_BCLK
|
|-
| 17
| PI0
| H_I2S0_MCLK
|
|-
| 18
| GND
|
|
|-
| 19
| PH10
| IR_RX
|
|-
| 20
| 5V
|
|
|-
| 21
| 5V
|
|
|-
| 22
| USB2_DP
|
|
|-
| 23
| USB2_DM
|
|
|-
| 24
| GND
|
|
|-
|}

===BPI-M4 Zero 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 Zero Allwinner H618 SBC burn Ubuntu desktop image
*BPI-M4 Zero DXF file

*BPI-M4 Zero SBC bench test:

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

Banana Pi BPI-M4 Zero

2023-11-06T02:45:26Z

Wind: /* 24-pin FPC */

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

[[File:BPI-M2_zero_11.JPG|thumb|[[Banana Pi BPI-M2 ZERO]] with Allwinner H3 chip]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=Introduction=
M4 Zero is the successor model of M2 Zero. It has a huge improvement in performance. The SOC is upgraded to H618 and the CPU frequency is increased by 25%. The memory is upgraded to DDR4, the capacity is quadrupled, and 8G eMMC is added. It supports 5G WiFi, and the USB interface has also been upgraded to type-C.

It has the same form factor and 40-pin connector as the Raspberry Pi Zero W, and it will fit most Zero W cases and accessories.

=Key Features=
* Allwinner H618, Quad-core ARM Cortex™-A53 processor
* ARM Mali G31 GPU
* 2.4G/5G WIFI & Bluetooth 4.2
* 2G LPDDR4 RAM
* 8G eMMC flash memory
* 1x USB2.0 Type-C OTG, 5V power supply
* 1x USB2.0 Type-C
* 1x miniHDMI 2.0a
* 1x 24-pin FPC connector
** 1x USB2.0
** 1x 100Mbps Ethernet

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

=Hardware=
==Hardware interface==

==Hardware spec==
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="2"| '''Hardware Specification of Banana pi BPI-M4 Zero'''
|-
| 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, SDIO3.0
|-
| Wireless || 2.4G/5G WiFi and Bluetooth 4.2
|-
| HDMI || 1x miniHDMI 2.0a (up to 4K@60Hz with HDR10, CEC, DDC, SCDC), HDMI digital Audio output
|-
| USB || 1x USB2.0 Type-C 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
|-
| rowspan="2" | 24-pin FPC
| 0.5mm pitch FPC connector， 1x USB2.0, 1x IR, 1x 100Mbps Ethernet
|-
| 9 pins GPIO, UART,TWI/I²C, PWM, PCM/I²S
|-
|Buttons|| Reset, FEL
|-
| LED || Power Status and Activity status
|-
| Power || 5V@3A via USB Type-C
|-
|Size || 65mm × 30mm
|-
|Weight ||
|}

==PIN define ==

===BPI-M4 Zero 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;" |
|}
=== 24-pin FPC ===

{| class="wikitable" style="text-align:center;"
|-
| style="background: PaleTurquoise; color: black" colspan="6"| '''24-pin FPC define and GPIO Alternative Functions Assignments'''
|-
! Pin Num
! Pin Name
! ALT0
! ALT1
! ALT2
! ALT3
|-
| 1
| GND
|
|
|
|
|-
| 2
| EPHY_RXN
|
|
|
|
|-
| 3
| EPHY_RXP
|
|
|
|
|-
| 4
| EPHY_TXN
|
|
|
|
|-
| 5
| EPHY_TXP
|
|
|
|
|-
| 6
| GND
|
|
|
|
|-
| 7
| PI9
| UART3_TX
| TWI2_SCK
|
|
|-
| 8
| PI10
| UART3_RX
| TWI2_SDA
|
|
|-
| 9
| PI12
| UART3_CTS
| PWM2
|
|
|-
| 10
| PI11
| UART3_RTS
| PWM1
|
|
|-
| 11
| 3V3
|
|
|
|
|-
| 12
| 3V3
|
|
|
|
|-
| 13
| PI4
| H_I2S0_DIN0
| H_I2S0_DOUT1
|
|
|-
| 14
| PI3
| H_I2S0_DOUT0
| H_I2S0_DIN1
|
|
|-
| 15
| PI2
| H_I2S0_LRCK
|
|
|
|-
| 16
| PI1
| H_I2S0_BCLK
|
|
|
|-
| 17
| PI0
| H_I2S0_MCLK
|
|
|
|-
| 18
| GND
|
|
|
|
|-
| 19
| PH10
| IR_RX
|
|
|
|-
| 20
| 5V
|
|
|
|
|-
| 21
| 5V
|
|
|
|
|-
| 22
| USB2_DP
|
|
|
|
|-
| 23
| USB2_DM
|
|
|
|
|-
| 24
| GND
|
|
|
|
|-
|}

===BPI-M4 Zero 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 Zero Allwinner H618 SBC burn Ubuntu desktop image
*BPI-M4 Zero DXF file

*BPI-M4 Zero SBC bench test:

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

Banana Pi BPI-M4 Zero

2023-11-02T10:02:45Z

Wind: /* 24-pin FPC */

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

[[File:BPI-M2_zero_11.JPG|thumb|[[Banana Pi BPI-M2 ZERO]] with Allwinner H3 chip]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=Introduction=
M4 Zero is the successor model of M2 Zero. It has a huge improvement in performance. The SOC is upgraded to H618 and the CPU frequency is increased by 25%. The memory is upgraded to DDR4, the capacity is quadrupled, and 8G eMMC is added. It supports 5G WiFi, and the USB interface has also been upgraded to type-C.

It has the same form factor and 40-pin connector as the Raspberry Pi Zero W, and it will fit most Zero W cases and accessories.

=Key Features=
* Allwinner H618, Quad-core ARM Cortex™-A53 processor
* ARM Mali G31 GPU
* 2.4G/5G WIFI & Bluetooth 4.2
* 2G LPDDR4 RAM
* 8G eMMC flash memory
* 1x USB2.0 Type-C OTG, 5V power supply
* 1x USB2.0 Type-C
* 1x miniHDMI 2.0a
* 1x 24-pin FPC connector
** 1x USB2.0
** 1x 100Mbps Ethernet

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

=Hardware=
==Hardware interface==

==Hardware spec==
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="2"| '''Hardware Specification of Banana pi BPI-M4 Zero'''
|-
| 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, SDIO3.0
|-
| Wireless || 2.4G/5G WiFi and Bluetooth 4.2
|-
| HDMI || 1x miniHDMI 2.0a (up to 4K@60Hz with HDR10, CEC, DDC, SCDC), HDMI digital Audio output
|-
| USB || 1x USB2.0 Type-C 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
|-
| rowspan="2" | 24-pin FPC
| 0.5mm pitch FPC connector， 1x USB2.0, 1x IR, 1x 100Mbps Ethernet
|-
| 9 pins GPIO, UART,TWI/I²C, PWM, PCM/I²S
|-
|Buttons|| Reset, FEL
|-
| LED || Power Status and Activity status
|-
| Power || 5V@3A via USB Type-C
|-
|Size || 65mm × 30mm
|-
|Weight ||
|}

==PIN define ==

===BPI-M4 Zero 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;" |
|}
=== 24-pin FPC ===

{| class="wikitable" style="text-align:center;"
|-
| style="background: PaleTurquoise; color: black" colspan="6"| '''24-pin FPC define and GPIO Alternative Functions Assignments'''
|-
! Pin Num
! Pin Name
! ALT0
! ALT1
! ALT2
! ALT3
|-
| 1
| GND
|
|
|
|
|-
| 2
| EPHY_RXN
|
|
|
|
|-
| 3
| EPHY_RXP
|
|
|
|
|-
| 4
| EPHY_TXN
|
|
|
|
|-
| 5
| EPHY_TXP
|
|
|
|
|-
| 6
| GND
|
|
|
|
|-
| 7
| PI9
|
|
|
|
|-
| 8
| PI10
|
|
|
|
|-
| 9
| PI12
|
|
|
|
|-
| 10
| PI11
|
|
|
|
|-
| 11
| 3V3
|
|
|
|
|-
| 12
| 3V3
|
|
|
|
|-
| 13
| PI4
|
|
|
|
|-
| 14
| PI3
|
|
|
|
|-
| 15
| PI2
|
|
|
|
|-
| 16
| PI1
|
|
|
|
|-
| 17
| PI0
|
|
|
|
|-
| 18
| GND
|
|
|
|
|-
| 19
| IR_RX
|
|
|
|
|-
| 20
| 5V
|
|
|
|
|-
| 21
| 5V
|
|
|
|
|-
| 22
| USB2_DP
|
|
|
|
|-
| 23
| USB2_DM
|
|
|
|
|-
| 24
| GND
|
|
|
|
|-
|}

===BPI-M4 Zero 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 Zero Allwinner H618 SBC burn Ubuntu desktop image
*BPI-M4 Zero DXF file

*BPI-M4 Zero SBC bench test:

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

Banana Pi BPI-M4 Zero

2023-11-02T10:02:27Z

Wind: /* BPI-M4 Zero 40-pin header */

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

[[File:BPI-M2_zero_11.JPG|thumb|[[Banana Pi BPI-M2 ZERO]] with Allwinner H3 chip]]
[[File:Banana_Pi_BPI-M4_Berry_1.jpg|thumb|[[Banana Pi BPI-M4 Berry]] H618 design]]
[[File:Banana_Pi_BPI-M5_1.JPG|thumb|[[Banana Pi BPI-M5]] with S905x3 design]]

=Introduction=
M4 Zero is the successor model of M2 Zero. It has a huge improvement in performance. The SOC is upgraded to H618 and the CPU frequency is increased by 25%. The memory is upgraded to DDR4, the capacity is quadrupled, and 8G eMMC is added. It supports 5G WiFi, and the USB interface has also been upgraded to type-C.

It has the same form factor and 40-pin connector as the Raspberry Pi Zero W, and it will fit most Zero W cases and accessories.

=Key Features=
* Allwinner H618, Quad-core ARM Cortex™-A53 processor
* ARM Mali G31 GPU
* 2.4G/5G WIFI & Bluetooth 4.2
* 2G LPDDR4 RAM
* 8G eMMC flash memory
* 1x USB2.0 Type-C OTG, 5V power supply
* 1x USB2.0 Type-C
* 1x miniHDMI 2.0a
* 1x 24-pin FPC connector
** 1x USB2.0
** 1x 100Mbps Ethernet

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

=Hardware=
==Hardware interface==

==Hardware spec==
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="2"| '''Hardware Specification of Banana pi BPI-M4 Zero'''
|-
| 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, SDIO3.0
|-
| Wireless || 2.4G/5G WiFi and Bluetooth 4.2
|-
| HDMI || 1x miniHDMI 2.0a (up to 4K@60Hz with HDR10, CEC, DDC, SCDC), HDMI digital Audio output
|-
| USB || 1x USB2.0 Type-C 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
|-
| rowspan="2" | 24-pin FPC
| 0.5mm pitch FPC connector， 1x USB2.0, 1x IR, 1x 100Mbps Ethernet
|-
| 9 pins GPIO, UART,TWI/I²C, PWM, PCM/I²S
|-
|Buttons|| Reset, FEL
|-
| LED || Power Status and Activity status
|-
| Power || 5V@3A via USB Type-C
|-
|Size || 65mm × 30mm
|-
|Weight ||
|}

==PIN define ==

===BPI-M4 Zero 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;" |
|}
== 24-pin FPC ==

{| class="wikitable" style="text-align:center;"
|-
| style="background: PaleTurquoise; color: black" colspan="6"| '''24-pin FPC define and GPIO Alternative Functions Assignments'''
|-
! Pin Num
! Pin Name
! ALT0
! ALT1
! ALT2
! ALT3
|-
| 1
| GND
|
|
|
|
|-
| 2
| EPHY_RXN
|
|
|
|
|-
| 3
| EPHY_RXP
|
|
|
|
|-
| 4
| EPHY_TXN
|
|
|
|
|-
| 5
| EPHY_TXP
|
|
|
|
|-
| 6
| GND
|
|
|
|
|-
| 7
| PI9
|
|
|
|
|-
| 8
| PI10
|
|
|
|
|-
| 9
| PI12
|
|
|
|
|-
| 10
| PI11
|
|
|
|
|-
| 11
| 3V3
|
|
|
|
|-
| 12
| 3V3
|
|
|
|
|-
| 13
| PI4
|
|
|
|
|-
| 14
| PI3
|
|
|
|
|-
| 15
| PI2
|
|
|
|
|-
| 16
| PI1
|
|
|
|
|-
| 17
| PI0
|
|
|
|
|-
| 18
| GND
|
|
|
|
|-
| 19
| IR_RX
|
|
|
|
|-
| 20
| 5V
|
|
|
|
|-
| 21
| 5V
|
|
|
|
|-
| 22
| USB2_DP
|
|
|
|
|-
| 23
| USB2_DM
|
|
|
|
|-
| 24
| GND
|
|
|
|
|-
|}

===BPI-M4 Zero 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 Zero Allwinner H618 SBC burn Ubuntu desktop image
*BPI-M4 Zero DXF file

*BPI-M4 Zero SBC bench test:

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