CN

Illustration for Chinese (CN) documentation

Summary

This is the landing page for the /cn/ section. It acts as a bilingual navigation hub: it points you to the most useful internal documentation and gives a reliable first-boot flow you can follow even when older pages are brief.

????(??):??? /cn/ ????,???????????????????????????????,???????????????????????

Who this is for (????)

People arriving from older Chinese-language resources, Chinese-speaking users seeking quick access to documentation, and anyone who wants a single "start here" page that points to the canonical internal guides.

??????????????,?????????????,????????????????

What you'll do (????)

  • Find the correct internal guide for your board and use it as your primary reference. (??????????????????)
  • Download an image from the internal hub and verify it before flashing. (????????????????)
  • Boot with minimal peripherals and confirm access (serial/SSH/local console). (????????,??????)
  • Run quick checks to validate network, storage, and system health. (??????????????????)
  • Use the troubleshooting checklist to isolate power/storage issues early. (??????????????/????)

Quick checklist (????)

  • Stable PSU and cable (avoid undervoltage and "random resets"). (???????????,?????????)
  • Known-good SD card / storage and a reliable writer. (?????SD?/????????????)
  • Ethernet cable for first boot (recommended). (????????????)
  • Optional: USB'TTL serial adapter (3.3V) for recovery. (??:USB?TTL?????????)
  • Verified image file (checksum matches). (????????,?????)
  • Keyboard/HDMI only if you are not using SSH/serial. (????SSH/???????/HDMI)

Steps and guidance (???????)

1. Download and verify (?????)

Start from the downloads hub and select the image for your board.

????????????????

# Verify compressed file
sha256sum your-image.img.xz
# Compare with published checksum (?????????)

# After decompression
sha256sum your-image.img

2. Flash to storage (???????)

Use dd, Balena Etcher, or platform-specific tools. Confirm device before writing.

??dd?Balena Etcher????????????????

lsblk
# Identify SD card device (??SD???)

# Example flash command
sudo dd if=your-image.img of=/dev/sdX bs=4M status=progress conv=fsync
sync

3. First boot (????)

Connect minimal peripherals: power, Ethernet (recommended), and either HDMI+keyboard or serial console.

??????:??????(??)??HDMI+?????????

First boot takes 1-3 minutes for filesystem expansion. (??????1-3??????????)

4. Verify system (????)

Run these commands to confirm basic functionality:

????????????:

# Check kernel and system info (?????????)
uname -a

# Verify network (????)
ip a
ping -c4 1.1.1.1

# Check storage (????)
lsblk
df -h

# Check for failed services (???????)
systemctl --failed

# Review boot logs (??????)
dmesg | tail -50
journalctl -b -p err

5. Update system (????)

Update packages once under supervision. Keep console access open during updates.

??????????????????????

sudo apt update
sudo apt full-upgrade
# Review package list carefully (?????????)
sudo reboot

Common scenarios (????)

No boot / ????

  • Check PSU and cable (2A+ required). (??????????,??2A??)
  • Verify SD card is correctly inserted. (??SD?????)
  • Re-flash with verified image. (????????????)
  • Try different SD card (known-good brand). (?????SD?,??????)
  • Check serial console for early boot messages. (???????????????)

No network / ???

  • Verify Ethernet cable connection. (????????)
  • Check interface status: ip a (??????)
  • Verify DHCP client running: systemctl status dhcpcd (??DHCP?????)
  • Check routing table: ip r (?????)
  • Test DNS: nslookup google.com (??DNS)

Update issues / ????

  • Keep console access open during updates. (???????????)
  • Check disk space before updating: df -h (?????????)
  • Review package changes carefully. (?????????)
  • If update breaks system, check: journalctl -xe (????????,????)
  • Consider reflashing if recovery is complex. (??????,??????)

Using English documentation (??????)

Browser translation (?????): Most modern browsers (Chrome, Edge, Firefox) offer built-in page translation. Right-click page ? "Translate to Chinese".

????????(Chrome?Edge?Firefox)??????????????? ? "?????"?

Key terms glossary (??????):

  • Flash / ?? ' Write image to storage
  • Checksum / ??? ' Verify file integrity
  • Boot / ?? ' System startup
  • Serial console / ????? ' Debug interface
  • GPIO / ?????? ' Hardware pin control
  • Kernel / ?? ' Linux core
  • Package / ??? ' Software component
  • Repository / ??? ' Software download source

Search tips (????): Use English technical terms in search queries for better results. Example: "banana pi boot failure" finds more results than Chinese translation.

????????????????????????:"banana pi boot failure"????????????

FAQ (????)

????????? / Where to find Chinese resources?
Check forum sections, wiki pages, and community-contributed content. Official documentation is primarily English with browser translation recommended.
????????????????????????????,??????????
???????? / What are default passwords?
Varies by image. Common combinations: pi/bananapi, bananapi/bananapi, root/bananapi. Check Quick Start Guide for your specific image.
??????????:pi/bananapi?bananapi/bananapi?root/bananapi??????????????????
????????? / How to configure network?
Ethernet typically auto-configures via DHCP. WiFi requires additional setup depending on distribution. See board-specific guides.
???????DHCP?????WiFi???????????????????????
????? / Storage recommendations?
Class 10 or UHS-I SD card minimum. Reliable brands: SanDisk, Samsung, Kingston. 16GB+ recommended. Avoid generic/counterfeit cards.
??Class 10?UHS-I SD??????:SanDisk?Samsung?Kingston???16GB?????????
????? / Power requirements?
5V 2A minimum for board only. 2.5-3A with peripherals (HDMI, USB devices). Quality power supply critical for stability.
?????5V 2A????(HDMI?USB??)?2.5-3A???????????????

Author: LeMaker Documentation Team
Last updated: 2026-01-12