查看“Orange Pi 5 detail”的源代码

== 使用 RKDevTool 烧录 Linux 镜像到 TF 卡中的方法 ==
1) 首先需要准备一根品质良好的 Type-C 接口的数据线<br><br>
[[Image:Pi-5-details-pic31.png]]<br><br>
2) 还需要准备一张 16GB 或更大容量的 TF 卡，TF 卡的传输速度必须为 '''class10''' 级或 '''class10''' 级以上，建议使用闪迪等品牌的 TF 卡<br><br>
3) 然后将 TF 卡插入开发板的卡槽中<br><br>
[[Image:Pi-5-details-pic32.png]]<br><br>
4) 然后从<span style="color:#0066CC;">[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-pi-5.html Orange Pi 的资料下载页面]</span>下载瑞芯微驱动 '''DriverAssitant_v5.12.zip''' 和 '''MiniLoader''' 以 及 烧 录 工 具 '''RKDevTool_Release_v2.96.zip''' ，'''<span style="color:#FF0000">请确保下载的 RKDevTool 工具的的版本为 v2.96</span>'''<br>
a. 在 Orange Pi 的资料下载页面首先选择官方工具，然后进入下面的文件夹中<br><br>
[[Image:Pi-5-details-pic33.png]]<br><br>
b. 然后下载下面的所有文件<br><br>
[[Image:Pi-5-details-pic34.png]]<br><br>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| <br><big>'''注意，MiniLoader-烧录Linux镜像才需要用到的东西文件夹下文简称为MiniLoader文件夹。'''</big><br><br>
|}
5) 然后从<span style="color:#0066CC;">[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-pi-5.html Orange Pi 的资料下载页面]</span>下载想要烧录的 Linux 操作系统镜像文件压缩包，然后使用解压软件解压，解压后的文件中，以“.img”结尾的文件就是操作系统的镜像文件，大小一般都在 2GB 以上<br><br>
6) 然后用解压软件解压 '''DriverAssitant_v5.12.zip'''，再在解压后的文件夹中找到'''DriverInstall.exe''' 可执行文件并打开即可<br><br>
[[Image:Pi-5-details-pic35.png]]<br><br>
7) 打开 '''DriverInstall.exe''' 后安装瑞芯微驱动的步骤如下所示<br>
a. 点击“驱动安装”按钮<br><br>
[[Image:Pi-5-details-pic36.png]]<br><br>
b. 等待一段时间后，会弹出窗口提示“安装驱动成功”，然后点击“确定” 按钮即可<br><br>
[[Image:Pi-5-details-pic37.png]]<br><br>
8) 然后解压 '''RKDevTool_Release_v2.96.zip'''，此软件无需安装，在解压后的文件夹中找到 '''RKDevTool''' 打开即可<br><br>
[[Image:Pi-5-details-pic38.png]]<br><br>
9) 打开 '''RKDevTool''' 烧录工具后，因为电脑此时还没有通过 Type-C 线连接上开发板，所以左下角会提示“没有发现设备”<br><br>
[[Image:Pi-5-details-pic39.png]]<br><br>
10) 然后开始烧录 Linux 镜像到 eMMC 中<br>
a. 首先通过 Type-C 数据线连接好开发板与 Windows 电脑，开发板 Type-C 接口的位置如下图所示<br><br>
[[Image:Pi-5-details-pic40.png]]<br><br>
b. 确保开发板没有连接电源<br><br>
c. 还需确保下图位置的白色 USB2.0 接口没有插入 USB 设备<br><br>
[[Image:Pi-5-details-pic41.png]]<br><br>
d. 然后按住开发板的 MaskROM 按键不放，MaskROM 按键在开发板的位置如下图所示：<br><br>
[[Image:Pi-5-details-pic42.png]]<br><br>
e. 然后给开发板接上 Type-C 接口的电源，并上电<br><br>
[[Image:Pi-5-details-pic43.png]]<br><br>
f. 如果前面的步骤顺利，此时开发板会进入 '''MASKROM''' 模式，在烧录工具的界面上会提示“发现一个 '''MASKROM''' 设备”<br><br>
[[Image:Pi-5-details-pic44.png]]<br><br>
g. 然后将鼠标光标放在下面的这片区域中<br><br>
[[Image:Pi-5-details-pic45.png]]<br><br>
h. 然后点击鼠标右键会弹出下图所示的选择界面<br><br>
[[Image:Pi-5-details-pic46.png]]<br><br>
i. 然后选择'''导入配置'''选项<br><br>
[[Image:Pi-5-details-pic47.png]]<br><br>
j. 然后选择前面下载的 '''MiniLoader''' 文件夹中的 '''rk3588_linux_tfcard.cfg''' 配置文件，再点击'''打开'''<br><br>
k. 然后点击'''确定'''<br><br>
[[Image:Pi-5-details-pic48.png]]<br><br>
l. 然后点击下图所示的位置<br><br>
[[Image:Pi-5-details-pic49.png]]<br><br>
m. 再选择前面下载的 '''MiniLoader''' 文件夹中 '''MiniLoaderAll.bin'''，再点击'''打开'''<br><br>
n. 然后点击下图所示的位置<br><br>
[[Image:Pi-5-details-pic50.png]]<br><br>
o. 然后选择想要烧录的 linux 镜像的路径，再点击'''打开'''<br><br>
[[Image:Pi-5-details-pic51.png]]<br><br>
p. 然后请勾选上'''强制按地址写'''选项<br><br>
[[Image:Pi-5-details-pic52.png]]<br><br>
q. 再点击执行按钮就会开始烧录 linux 镜像到开发板的 tf 卡中<br><br>
[[Image:Pi-5-details-pic53.png]]<br><br>
r. linux 镜像烧录完后的显示 log 如下图所示<br><br>
[[Image:Pi-5-details-pic54.png]]<br><br>
s. 烧录完 linux 镜像到 tf 卡中后，linux 系统会自动启动。<br><br>

== 使用 Win32Diskimager 烧录 Linux 镜像的方法 ==
1) 首先准备一张 16GB 或更大容量的 TF 卡，TF 卡的传输速度必须为 class10 级或 class10 级以上，建议使用闪迪等品牌的 TF 卡<br><br>
2) 然后使用读卡器把 TF 卡插入电脑<br><br>
3) 接着格式化 TF 卡<br>
a. 可以使用 SD Card Formatter 这个软件格式化 TF 卡，其下载地址为<br>
 <big>'''https://www.sdcard.org/downloads/formatter/eula_windows/SDCardFormatterv5_WinEN.zip'''</big>
b. 下载完后直接解压安装即可，然后打开软件<br><br>
c. 如果电脑只插入了 TF 卡，则“Select card”一栏中会显示 TF 卡的盘符，如果电脑插入了多个 USB 存储设备，可以通过下拉框选择 TF 卡对应的盘符<br><br>
[[Image:Pi-5-details-pic55.png]]<br><br>
d. 然后点击“Format”，格式化前会弹出一个警告框，选择“是(Y)”后就会开始格式化<br><br>
[[Image:Pi-5-details-pic56.png]]<br><br>
e. 格式化完 TF 卡后会弹出下图所示的信息，点击确定即可<br><br>
[[Image:Pi-5-details-pic57.png]]<br><br>
4) 从Orange Pi的资料下载页面下载想要烧录的Linux操作系统镜像文件压缩包， 然后使用解压软件解压，解压后的文件中，以“.img”结尾的文件就是操作系统的镜像文件，大小一般都在 2GB以上<br><br>
5) 使用 Win32Diskimager 烧录 Linux 镜像到 TF 卡<br>
a. Win32Diskimager 的下载页面为<br>
 <big>'''http://sourceforge.net/projects/win32diskimager/files/Archive/'''</big>
b. 下载完后直接安装即可，Win32Diskimager 界面如下所示<br>
a)首先选择镜像文件的路径<br>
b)然后确认下 TF 卡的盘符和“设备”一栏中显示的一致<br>
c)最后点击“写入”即可开始烧录<br><br>
[[Image:Pi-5-details-pic58.png]]<br><br>
c. 镜像写入完成后，点击“退出”按钮退出即可，然后就可以拔出 TF 卡插到开发板中启动<br><br>

== Linux系统使用说明 ==
=== 已支持的Linux 镜像类型和内核版本 ===
{| class="wikitable"  style="width:800px;"
|-
| Linux 镜像类型 || 内核版本 || 服务器版 || 桌面版
|-
| Debian 11 - Bullseye || Linux5.10 || 支持 || 支持
|-
| Ubuntu 20.04 - Focal || Linux5.10 || 支持 || 支持
|-
| Ubuntu 22.04 - Jammy || Linux5.10 || 支持 || 支持
|}

=== 板载LED 灯测试说明 ===
1) 开发板上有两个 LED 灯，一个绿灯，一个红灯，所在位置如下图所示：<br><br>
[[Image:Pi-5-details-pic59.png]]<br><br>
2) 只要开发板打开了电源，红色的 LED 灯就会常亮，这是由硬件控制的，软件无法关闭。<br><br>
3) 绿色的 LED 灯在内核启动后会一直闪烁，这是由软件控制的。<br><br>
4) 设置绿灯亮灭和闪烁的方法如下所示<br>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| <br><big>'''注意，下面的操作请在 root 用户下进行。'''</big><br><br>
|}
a. 首先进入绿灯的设置目录<br>
{| class="wikitable" style="width:800px;" 
|-
|root@orangepi:~# '''cd /sys/class/leds/status_led'''
|}
b. 设置绿灯停止闪烁的命令如下<br>
{| class="wikitable" style="width:800px;" 
|-
|root@orangepi:/sys/class/leds/status_led# '''echo none > trigger'''
|}
c. 设置绿灯常亮的命令如下<br>
{| class="wikitable" style="width:800px;" 
|-
|root@orangepi:/sys/class/leds/status_led# '''echo default-on > trigger'''
|}
d. 设置绿灯闪烁的命令如下<br>
{| class="wikitable" style="width:800px;" 
|-
|root@orangepi:/sys/class/leds/status_led# '''echo heartbeat > trigger'''
|}

=== 查询 以太网口测试 ===
1) 首先将网线的一端插入开发板的以太网接口，网线的另一端接入路由器，并确保网络是畅通的<br><br>
2) 系统启动后会通过 DHCP 自动给以太网卡分配 IP 地址，不需要其他任何配置<br><br>
3) 在开发板的 Linux 系统中查看 IP 地址的命令如下所示<br>
{| class="wikitable" style="width:800px;" 
|-
|rangepi@orangepi:~$ '''ip addr show eth0'''<br>
2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000<br>
link/ether 4a:fe:2b:3d:17:1c brd ff:ff:ff:ff:ff:ff<br>
inet 192.168.1.150/24 brd 192.168.1.255 scope global dynamic noprefixroute eth0 valid_lft 43150sec preferred_lft 43150sec<br>
inet6 fe80::9a04:3703:faed:23be/64 scope link noprefixroute
|}
{| class="wikitable" style="width:800px;" style="background-color:#ffffdc;
|-
|当使用 '''ifconfig''' 查看 IP 地址时，如果提示下面的信息，是因为没有加 '''sudo''' 导致的，正确的命令是：'''sudo ifconfig'''<br><br>

orangepi@orangepi:~$ '''ifconfig'''<br>
Command 'ifconfig' is available in the following places<br>
/sbin/ifconfig<br>
/usr/sbin/ifconfig<br>
The command could not be located because '/sbin:/usr/sbin' is not included in the PATH environment variable.<br>
This is most likely caused by the lack of administrative privileges associated with your user account.<br>
ifconfig: command not found<br>
|}
{| class="wikitable" style="max-width:800px;" style="background-color:#ffffdc;
|-
|开发板启动后查看 '''IP''' 地址有三种方法：<br>
1. 接 '''HDMI''' 显示器，然后登录系统使用 '''ip addr show eth0''' 命令查看 IP 地址<br>
2. 在调试串口终端输入 '''ip addr show eth0''' 命令来查看 IP 地址<br>
3. 如果没有调试串口，也没有 '''HDMI''' 显示器，还可以通过路由器的管理界面来查看开发板网口的 '''IP''' 地址。不过这种方法经常有人会无法正常看到开发板的 '''IP''' 地址。如果看不到，调试方法如下所示：<br>
A) 首先检查 '''Linux''' 系统是否已经正常启动，如果开发板的绿灯在闪烁了，一般是正常启动了，如果只亮红灯，说明系统都没正常启动；<br>
B) 检查网线有没有插紧，或者换根网线试下；<br>
C) 换个路由器试下（路由器的问题有遇到过很多，比如路由器无法正常分配'''IP''' 地址，或者已正常分配 '''IP''' 地址但在路由器中看不到）；<br>
D) 如果没有路由器可换就只能连接 '''HDMI''' 显示器或者使用调试串口来查看 '''IP'''地址。<br>

另外需要注意的是开发板 '''DHCP''' 自动分配 '''IP''' 地址是不需要任何设置的。<br>
|}
4) 测试网络连通性的命令如下，ping 命令可以通过 Ctrl+C 快捷键来中断运行<br>
{| class="wikitable" style="width:800px;" 
|-
|orangepi@orangepi:~$ '''ping www.baidu.com -I eth0'''<br>
PING www.a.shifen.com (14.215.177.38) from 192.168.1.12 eth0: 56(84) bytes of data. 64 bytes from 14.215.177.38 (14.215.177.38): icmp_seq=1 ttl=56 time=6.74 ms<br>
64 bytes from 14.215.177.38 (14.215.177.38): icmp_seq=2 ttl=56 time=6.80 ms<br>
64 bytes from 14.215.177.38 (14.215.177.38): icmp_seq=3 ttl=56 time=6.26 ms<br>
64 bytes from 14.215.177.38 (14.215.177.38): icmp_seq=4 ttl=56 time=7.27 ms<br>
^C<br>
--- www.a.shifen.com ping statistics ---<br>
4 packets transmitted, 4 received, 0% packet loss, time 3002ms
|}