万博网页版登陆页派上手指南（2025版 约1万字）
万博网页版登陆页派上手指南（2025版）万博网页版登陆页派论坛编写，同行要用的请说一下出处，否则不得好死！（约1万字） 我们将不定期保持更新，删减，增加，以确保适合以前及最新的情况!一、万博网页版登陆页派概述 万博网页版登陆页派，英文名Raspberry Pi，于2011年发布上市，受到国内广泛关注始于2012年3月3日央视新闻频道的一则报道，“寸土寸金”的央视，进行了长达1分半钟的报道(看此新闻，这个新闻我一直有保存)。 本论坛在当晚连夜上线，给大家提供了一个交流的地方，汇集了大约13年前当时所有感兴趣的广大粉丝，从以前的帖子可以看出。在“树老大(论坛创始人)、ukonline2000(许多首创原创及技术支持)、自由飞翔、longbow78(彩虹壳的原创者)”等许多热心网友的帮助下，开始从国内外搞资料，解答问题，搞购买渠道，第一批用户就这样诞生了，经过不断试错，不断完善，为国内万博网页版登陆页派用户的入门和发展出了点力。 言归正传，用当时官方的话说，万博网页版登陆页派是一个卡片式电脑，只有信用卡大小，包括电脑常见的所有功能，比如USB，HDMI，CSI，复合视频接口，3.5mm接口，网口，最主要是包含了GPIO接口，因其操作方便易懂，极大的促进了国内Linux的学习，PYTHON的学习，为广大学生老师提供了很好的平台，为此许多大学开设了万博网页版登陆页派相关的课程。 现如今，万博网页版登陆页派的性能较之初代，已有极大提升，甚至前沿的AI等，几乎可以参与到您所能想到的所有项目中，Python与万博网页版登陆页派的互相成就更是成为佳话。成为仅次于微软、苹果的第三大计算平台。http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241202/1733074028183014.png二、万博网页版登陆页派、配件选购及避坑2.1、万博网页版登陆页派的选择 万博网页版登陆页派发展至今，已经有5代，但市面仍主要以3代B+、4B为主。 按照价格因素来讲，一二代时期，100多元就能买到，三四代也就在200多元，所以4代以前可以很便宜买到。 到了第5代，受内外环境影响，以及从第3B+开始，工厂离开国内后的各种原因叠加，导致5代价格明显上升。 按照性能来讲，从第4B起跟之前型号有明显提升，直至第5代，比如推出了4G,8G内存版本，大幅提升，导致价格明显提升。 如何选择呢？正常情况下4B就完全可以了，追求极致性能5代则更好。当初在2013年时，就有很多用户拿万博网页版登陆页派挖矿，挖BTC，想想真是可以，就那么点性能，不过主要是用来挂挖矿程序，并非自身参与挖矿计算。2.2、万博网页版登陆页派各个版本具体参数http://shumeipai.net/data/attachment/forum/202408/08/183848majrhgtauet6ubva.png 版本万博manbext登录网址，可以到这里。2.3、万博网页版登陆页派各版本图片 附：万博网页版登陆页派版本代号大全 Raspberry Pi代号查看方式，点此了解。http://shumeipai.net/data/attachment/forum/202408/08/184520ypcyp3nnpmp2czr3.png2.4、万博网页版登陆页派配件选择 2.4.1、所需基本配件 万博网页版登陆页派，TF卡（以及USB读卡器），电源 只追求能启动，这三个就足够了。 TF卡容量，通常商家会要求16G，甚至现在的32G。其实我试了下（2024年11月），8G就可以了(官方系统raspberry pi OS)，当然也差不了几个钱，容量搞大一点没有啥错。 至于USB读卡器，很多人忽略，但确实是必须的，您得通过它，在电脑上将系统写入TF卡，以及后续的配置，也极大可能会用到。 TF卡官方建议： 使用至少具有32GB存储空间的SD卡来安装Raspberry Pi操作系统。对于 Raspberry Pi OS Lite，我们建议至少 16GB。您可以使用任何容量小于2TB 的SD卡。由于MBR中的限制，目前不支持 2TB 以上的容量。 由于硬件限制，以下设备只能从256GB或更小的启动分区启动： Raspberry Pi Zero 万博网页版登陆页派 1 采用BCM2836 SoC的早期Raspberry Pi 2型号 其他的操作系统可能有不同要求，具体以该系统官方文档为准（后面我们将针对大多数系统进行专门的介绍说明）。 2.4.2、外壳和散热 外壳： 选择很多，能满足自己的要求即可。外壳是建议购买的，纯阳谋，有外壳，真的可以大大降低损坏率。 散热： 万博网页版登陆页派5散热要求高，普通运行，散热片就好，负载大一点，一个用风扇就可以了。 就不建议搞那些花里胡哨的了。 2.4.3、其他功能性外设 功能性外设，根据个人项目需求选择就好，没有多余的说法，有需求则买，没则忽略。 就万博网页版登陆页派的外设，可以到这个帖子万博manbext登录网址：点此进行观点表达。2.5、万博网页版登陆页派电源 下表展示了Raspberry Pi 各型号供电所需的 USB-PD 电源模式，您可以使用任何提供正确电源模式的高质量电源：
型推荐电源（电压/电流）Raspberry Pi 官方电源
万博网页版登陆页派 55V/5A（5V/3A将外设限制为600mA）27W USB-C 电源
万博网页版登陆页派4 B 型5V/3A15W USB-C 电源
万博网页版登陆页派3（所有型号）5V/2.5A12.5W Micro USB 电源
万博网页版登陆页派2（所有型号）5V/2.5A12.5W Micro USB 电源
万博网页版登陆页派1（所有型号）5V/2.5A12.5W Micro USB 电源
万博网页版登陆页派Zero（所有型号）5V/2.5A12.5W Micro USB 电源
http://shumeipai.net/source/plugin/lechen_doc/upload/image/20241202/1733095898821218.png 将电源插入标有“POWER IN”、“PWR IN”或“PWR”的接口处。 关于电源，可以到这里万博manbext登录网址：点此加入万博manbext登录网址。三、启动前的准备3.1、万博网页版登陆页派、TF卡、电源 上面已经专门进行说明，除此之外，通常还需要一些别的设备，以便更加方便快速的启动。3.2、显示器 有显示器，您的操作将方便许多;特别是如果您的项目是视频方面的，或者不习惯命令行界面，或者VNC远程桌面这样会存在不同步或者卡顿的情况下。 万博网页版登陆页派连接显示器的方式有多种方式：
版本型号显示器输出方式
万博网页版登陆页派52×Mciro-HDMI
万博网页版登陆页派4（所有型号）2×Mciro-HDMI、音频和复合输出（通过 3.5 毫米耳机孔）
万博网页版登陆页派3（所有型号）标准HDMI、音频和复合输出（通过 3.5 毫米耳机孔）
万博网页版登陆页派2（所有型号）标准HDMI、音频和复合输出（通过 3.5 毫米耳机孔）
万博网页版登陆页派1 型号 B+标准HDMI、音频和复合输出（通过 3.5 毫米耳机孔）
万博网页版登陆页派1 型号 A+标准HDMI、音频和复合输出（通过 3.5 毫米耳机孔）
万博网页版登陆页派Zero（所有型号）Mini-HDMI
注意：尽管4代、5代均有TYPE-C接口，但均不支持C口输出音频视频。 如果，您的显示器没有HDMI接口(比如VGA/DVI接口/AV接口)，这需要通过HDMI转VGA，HDMI转DVI等转换器，论坛店铺也有售卖，点此查看。 如果，您的万博网页版登陆页派有多个HDMI接口，请将主显示器接到HDMI0.http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241202/1733099729217740.png3.3、键盘、鼠标 早期万博网页版登陆页派版本存在很多键鼠不兼容的情况，如今已很少遇到，可以通过蓝牙键盘，USB无线键盘、USB有线键盘来加入。3.4、音频输出 所有带有标准HDMI、Micro-HDMI或Mini-HDMI的Raspberry Pi型号都支持通过HDMI接口进行音频输出。 所有Raspberry Pi型号都支持通过USB传输音频，比如本站网店所售的USB声卡系列，点此查看(如果您用的万博网页版登陆页派版本不含3.5mm耳机孔，那么USB这种方式可能是最快捷的)。 所有配备蓝牙的 Raspberry Pi 型号都支持蓝牙音频。 Raspberry Pi 1、2、3 和 4 的所有版本都包括一个3.5mm耳机孔，可能需要功率放大以获得足够的输出音量，当然音质从第一代开始就被广大网友吐槽，且槽点还挺多。在论坛搜索可以了解到。3.5、音频输入 万博网页版登陆页派的音频输入，历来没被重视，但随着AI的发展，声音的采集需求越来越多，通常是通过USB麦克风或USB声卡来实现，本站网店亦有售卖，点此查看。 还可以通过GPIO针脚，连接相关声音传感器模块来实现，点此查看。3.6、网络接入 以下 Raspberry Pi 型号具有Wi-Fi和蓝牙连接功能： 万博网页版登陆页派 5、万博网页版登陆页派 4、万博网页版登陆页派 3B+、万博网页版登陆页派 3、Raspberry Pi Zero W、Rsapberry Pi Zero 2W 以B为型后缀表示带以太网端口，“型号A”则表示没有以太网端口。如果您的万博网页版登陆页派没有以太网端口，可以使用USB转网口模块、或USB网卡来连接到互联网，点此查看或购买。四、系统安装、初步配置4.1、系统安装工具 A、如今安装系统，使用官方的Imager工具即可，官网下载，本站下载 B、win32diskimager：点此下载;此工具在早期万博网页版登陆页派使用中是必须的，现如今如果您要备份系统，还原本地系统，也是比较方便的方式。4.2、系统镜像下载 如果您要手动安装系统，需要先下载系统镜像，点击这里到官网下载，或到本站下载。官网有针对当前每个系统版本的介绍、更新、适用对象等必要的说明。4.3、系统安装方式 系统安装目前有两种方式，第一种：Imager安装在个人PC上进行安装（镜像会缓存在电脑里）；第二种是Imager直接安装在万博网页版登陆页派上的线上安装。 4.3.1、第一种，通过个人PC安装http://shumeipai.net/data/attachment/forum/202411/29/152751bquuxn5agzocuwwc.gif 第一步，打开IMAGER工具后，选择您的万博网页版登陆页派版本，我这里是万博网页版登陆页派5.http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241202/1733105043676287.pnghttp://shumeipai.net/source/plugin/lechen_doc/upload/image/20241202/1733105094358024.png 第二步，选择要安装的系统版本，根据个人情况选择，这里选的是Raspberry PI OS 64bithttp://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241202/1733105188176645.png 第三步，选择要装到哪个盘，我这里TF卡的盘是F盘。若有多个盘符，请确保正确，以免带来数据损失。http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241202/1733105271752410.png 第四步，点击NEXT，会弹出是否要进行相关自定义，也就是预配置：http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241202/1733105342549860.png
单击Edit Settings（编辑设置）按钮以打开系统自定义。 您可以点击 No 跳过系统自定义，那么配置向导将在万博网页版登陆页派首次启动时要求您配置相同的信息。然而对于没有显示器的用户来说，提前设置好这一步骤，将非常有用，不然会徒增许多麻烦。所以是建议必须提前设置好。http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241202/1733105854979833.png A、填好万博网页版登陆页派在网络上的名字（hostname 主机名，非登录账号），我这里叫shumeipainet5 B、填好登录用户名，我这里叫pi C、设置好密码：我这里是 shumeipainet D、填好WIFI账号和密码，一般系统自动识别，若有多个WIFI账号可用，看下是否跟您电脑连接的一样，因为后续极大可能要用SSH控制万博网页版登陆页派，若不在同一网络会比较麻烦，须保持一致。 官方说明：该选项允许您输入无线网络的 SSID(名称)和密码。如果您的网络没有公开广播 SSID，您应该启用隐藏 SSID“Hidden SSID”设置。默认情况下，Imager 使用您当前所在的国家/地区作为“无线 LAN 国家/地区”。此设置控制 Raspberry Pi 使用的 Wi-Fi 广播频率。如果您计划运行无头 Raspberry Pi，请输入无线 LAN 选项的凭据。 E、所在国家，这里填写CN F、时区，shanghai G、键盘布局，US 第五步，顶部切换service，勾选SSH，点选第一个，以用户名和密码作为SSH登录凭证。 Services (服务) 选项卡：包含可帮助您远程连接到 Raspberry Pi 的设置。 如果您计划通过网络远程使用 Raspberry Pi，请勾选 Enable SSH (启用 SSH) 旁边的框。如果您计划运行HeadlessRaspberry Pi，则应启用此选项。 选择 Allow public-key authentication only(仅允许公钥身份验证)，简言之就是生成一个只针对这个电脑的密钥，类似人的指纹等。从而不需要输入万博网页版登陆页派的账号密码您也可以访问它。如果您的 SSH 配置中已有 RSA 密钥（指纹），Imager 将使用该公钥。如果没有，您可以单击 Run SSH-keygen 生成公私钥对，Imager 将使用新生成的公钥。http://shumeipai.net/source/plugin/lechen_doc/upload/image/20241202/1733106171125334.png 第六步，顶部的OPTIONS选项卡 比如安装完毕有提示音等设置，可忽略。http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241202/1733107010641603.png 第七步：写入系统 点击保存，选择YES(是否按照自定义写入)，继续选YES(要删除TF卡原有数据，是否继续，根据个人情况选择)，开始写入系统。如果准备做一些非常严谨或重大的项目，建议验证，以免带来潜在的风险。http://shumeipai.net/source/plugin/lechen_doc/upload/image/20241202/1733107420394687.png 第八步，写入完成，会自动进行验证，我一般点击取消验证。要验证的话可能要装三四五次才能成功一次。 第九步，写完系统，会弹出提示：您可以卸载SD卡了。 这时候电脑会弹出格式化请求，千万不要点击格式化，点击取消，负责极可能损坏TF卡。这是因为写了系统的TF卡，有很多WIN无法识别的分区格式，导致认为TF卡有问题，要求您格式化。这是正常的，而且就算您点击格式化，也没用。 至此，系统安装完毕，可以插入万博网页版登陆页派启动，开玩了。 系统安装问题，可以在这里交流。4.3.2、第二种，无读卡器给万博网页版登陆页派在线安装系统如果您没有读卡器，那也没关系，万博网页版登陆页派在没装系统的情况下也是可以联网的，当然仅限于联网安装系统。 第一，前提条件 你得有显示器、有网口的万博网页版登陆页派版本，键盘，空置的TF卡、网线、以及能联网的路由器或者猫。 另外，能直接使用此方式的万博网页版登陆页派版本，只有4B、Pi400、5.如果您的 Raspberry Pi 运行较旧的引导加载程序，您可能需要更新引导加载程序以便能使用 Network Install。 第二、将键盘、显示器、网线、电源(先不通电)与万博网页版登陆页派连接，TF卡也插入万博网页版登陆页派。网线另一端连接至能上网的路由器或猫。 第三、按住键盘 SHIFT 键的同时打开 Raspberry Pi 的电源http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241202/1733141238657009.png 第四步、如果连上互联网后，Raspberry Pi将下载 Raspberry Pi 安装程序。如果下载失败，可以重复该过程。http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241202/1733141340373300.png 第五步、Raspberry Pi Imager下载完成后，系统将自动进行系统下载和安装，所填配置信息跟上面第一种系统安装方法一样。http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241202/1733141668480019.png 此方法，遇到任何问题，可以点这里进行交流求助。 五、系统备份、TF卡还原、系统还原5.1、备份万博网页版登陆页派系统 备份是好习惯，随时有退路。在系统设置好了之后，环境配置好了之后，项目搭建好了之后，建议这时候要备份一下系统。 根据十多年经验，因为后续的操作，极可能会因为各种原因导致系统损坏，或TF卡坏掉。此时如果有备份，只需还原备份系统就好，会很省事。按照下面方法即可还原： 5.1.1、先下载镜像备份工具：点这里 5.1.2、参考下面动图进行备份：http://shumeipai.net/data/attachment/forum/202411/29/205601zwuku3zw3uhottmq.gif 5.1.3、通过USB读卡器，将需要备份的TF卡插入电脑。插入后电脑会提示格式化TF卡，千万不能格式化！ 5.1.4、选择将系统备份到哪个目录(路径不要有中文或特殊符号) 选择之前，建议在最终文件夹下面新建一个".img"为后缀的文件：20241102raspiOS.img，名字自拟，不能有中文和特殊字符。 5.1.5、选好备份系统保存文件夹之后，点击READ，开始备份。 备份完毕，会提示Read successful 成功! 有任何备份问题，可以点击这里进行求助交流！5.2、将TF卡还原到出厂状态 之前多次提示不能直接格式化，是因为在Windows系统下，只能识别到装有Linux系统SD卡的极小部分分区，您格式化的也只是这个分区，因为不完整的格式化，会导致TF卡崩溃，甚至反复格式化导致损坏。 为了能将整个TF卡进行格式化，需要写入特定代码(点此下载 bootsector.img)，让win电脑能够完整识别所有分区。 5.2.1、下载bootsector.img文件后，保存在路径没有中文或特殊符号的文件夹内 5.2.2、按照下面动图进行操作，打开镜像写入工具win32diskimager（如果没下载，点此下载），写入bootsector.img文件http://shumeipai.net/data/attachment/forum/202411/29/212124yrhyttrp8hqk504m.gif 动图流程解释： 打开存放bootsector.img的文件夹，并选择bootsector.img文件 选择要还原的TF卡 点击write，开始写入 很快就写完了。 最后，这里电脑会提示将TF卡格式化，这次要点击格式化。格式化完毕，TF卡就还原成功了。就可以进行重做系统的操作了。 该方法，有任何求助交流，可以点击这里。5.3、还原备份系统的方法（即：手动安装系统的方法;这也是在万博网页版登陆页派官方没有推出imager之前最主流的系统安装方法。) 如果之前有备份的系统，可以按照下面的方法进行恢复。 还原系统，也就是将备份的系统写入TF卡。 写入前，请确保您的TF卡是新卡，或者已经还原。 5.3.1、打开镜像写入工具win32diskimager（如果没下载，点此下载） 5.3.2、按照下图操作：http://shumeipai.net/data/attachment/forum/202411/29/223519y26czs6s7x7z67x6.gif 5.3.3、动图流程解释： 打开存有备份系统的目录，并双击选择已经存在的备份系统（如果是手动安装系统，而不是恢复备份系统，这里只需将备份系统更换为您要写入的系统img镜像文件即可)。 点击read，进行write。 等10分钟左右，系统写入完毕，提示成功。系统就还原好了。 此时，弹出的格式化请求，要点击取消。 5.3.4、如果是装的新系统，而非备份系统还原，那么此时您可能要需要通过电脑进入TF卡，进行相关配置文件的修改(如果有需要)，比如联网配置文件，SSH开启文件等。 聪明的您已经发现，系统写入方法跟TF卡还原基本一样，只是写入的镜像文件不一样，以及最后TF卡还原要点击格式化，而安装系统则禁止格式化。 该步骤，任何求助交流，可以点击这里。六、万博网页版登陆页派开机，首次启动时的设置6.1、万博网页版登陆页派开机 确保万博网页版登陆页派处于断电状态下，将已写入系统的TF卡插入万博网页版登陆页派背部卡槽。http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241203/1733155416140567.png
其次接入显示器、插入USB设备，比如键盘、鼠标、USB声卡、USB麦克风等。http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241203/1733155435102428.png 最后插入电源，通电。 当万博网页版登陆页派开机时，您应该会看到状态LED亮起。如果您的Pi连接到显示器，您应该会在几分钟内看到屏幕显示画面。6.2、未成功启动因素排查 若您的万博网页版登陆页派在5分钟内没有启动，需查看板载LED灯状态。如果闪烁，则需根据LED灯状态来判断哪里出了状况，但这不用着急，并不一定就是出现了致命问题。
通常按照以下方式进行排查，即可解决问题： A、如果您使用的引导设备不是TF卡，那么请换成从TF卡引导启动。 B、重做系统，并从imager完成验证。 C、最后的大招，更新万博网页版登陆页派上的bootloader，并重做系统。具体方法请查看bootloader更新教程。 以上方式，可能只使用一种就可以，也可能要全部使用。有任何问题或求助，请点击这里更贴。6.3、首次启动的配置 如果装系统时已经进行了预先的自定义设置，此步骤可以跳过，看看也无妨。 若安装系统时未进行自定义设置，开机后，系统则会弹出如下界面，点击NEXT：http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241203/1733212130287624.png
6.3.1、蓝牙设备连接 如果您使用蓝牙键盘或鼠标，系统会引导你进行配对，并连接它们;此过程适用内置蓝牙或USB蓝牙适配器，请提前插好USB蓝牙设备。 6.3.2、本地化设置 如下界面，提示您选择所在国家，语言，时区;比如：china,chinese,+8http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241203/1733237522484882.png 6.3.3、设置账号和密码 下面界面，让您设置万博网页版登陆页派的默认账号和密码，请根据个人情况进行设置。http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241203/1733237776986976.png
6.3.4、Wi-Fi连接 如下界面，您可以选择您的首选网络，以及进入该网络设置密码。http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241203/1733237908129745.pnghttp://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241203/1733237920120303.png 6.3.5、浏览器 您可以选择谷歌浏览或火狐浏览器作为默认浏览器，非默认浏览器可以被卸载。http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241203/1733238055139694.png
6.3.6、Raspberry Pi Connect 工具 该工具可以让您在任何有网的地方访问您的万博网页版登陆页派桌面，并进行操控，实现真正的“远程”访问，而且不需要您手工进行任何配置。相关使用教程，可以本系列文档中找到。 如下界面，您可以开启或关闭：http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241203/1733238623977725.png
6.3.7、系统软件更新 （建议跳过，建议更换源之后再更新） 万博网页版登陆页派联网后，此页面可帮助您将操作系统和软件更新到最新版本。 在软件更新过程中，如果您在第3.5步中选择了卸载非默认浏览器，那么此刻向导将删除该浏览器。 这个更新过程可能需要几分钟时间，因网速而定。http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241203/1733238754122016.pnghttp://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241203/1733238766542888.png 当您看到一个弹出窗口，提示您的系统是最新的了，那么请单击 OK 继续下一步。 6.3.8、开机配置结束并重启 在配置向导结束时，单击Restart重新启动 Raspberry Pi。您的 Raspberry Pi 将按照您的配置启动，并进入桌面。http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241203/1733239135109967.png
此时，您的万博网页版登陆页派入门就此结束，可以正常按照您的配置来开机了。 Raspberry Pi OS 预装了许多基本应用程序，因此您可以立即开始使用它们。如果您想利用我们认为有用的其他应用程序，请单击屏幕左上角的 raspberry 图标。从下拉菜单中选择 Preferences > Recommended Software，您将找到包管理器。您可以在此处免费安装各种推荐的软件。http://www.shumeipai.net/source/plugin/lechen_doc/upload/image/20241203/1733239392657869.png 例如，如果您打算将 Raspberry Pi 用作家用计算机，您可能会发现 LibreOffice 对于编写和编辑文档和电子表格非常有用。您还可以使用 Universal Access 下的屏幕放大镜和 Orca 屏幕阅读器等应用程序，让您的 Raspberry Pi 更易于访问。 以上只是上手篇，帮助您初步认识和开机启动万博网页版登陆页派，后续更多内容(30万字)在硬件篇、初级篇、进阶篇、高级篇等，我们将并不断丰富完善，提供您感兴趣的教程。任何问题，均可以到我们论坛提问求助。
万博网页版登陆页派官方文档系列目录A、万博网页版登陆页派硬件篇
硬件篇比较长，分成三部分：
硬件篇一：点此查看
硬件篇二：点此查看
硬件篇三：点此查看
一、万博网页版登陆页派的分类
二、各型号对比
2.1、旗舰系列
2.2、Zero系列
2.3、PICO系列
2.4、各型号主要参数对比
2.5、各型号图片展示
2.6、CM计算模块系列
三、原理图与工程图
四、商品合规性和安全性
4.1、可燃性等级
4.2、Raspberry Pi 合规性支持
4.3、官方提供的支持
4.4、认可设计合作伙伴
五、频率管理和热控制
5.1、DVFS的使用
5.2、测量温度
5.3、散热器最佳安装方式
5.4、可调速风扇的使用
5.5、万博网页版登陆页派5风扇连接器引脚定义
六、使用 EEPROM 启动系统
6.1、可用EEPROM启动系统的型号
6.2、其他型号的方式
6.3、诊断
6.4、更新引导加载程序bootloader
6.5、更新bootloader配置
6.6、自动更新
6.7、Bootloader 版本状态
七、启动诊断
八、万博网页版登陆页派启动模式
8.1、特定的bootcode.bin -only启动模式
8.2、启用bootcode.bin UART
九、USB启动模式
9.1、USB设备启动模式
9.2、USB主机启动模式
9.3、USB大容量存储启动模式
9.4、从USB大容量存储启动
9.5、已知问题
9.6、特殊的bootcode.bin-only启动模式
9.7、硬件兼容性
9.8、多个可引导驱动器
十、网络启动
10.1、网络引导流程
10.2、调试网络启动模式
10.3、DHCP请求/应答
10.4、TFTP文件读取
10.5、已知问题
十一、GPIO启动模式
11.1、万博网页版登陆页派3B和计算模块3.引脚分配
11.2、其他
11.3、开机流程
十二、NVMe SSD启动
12.1、先决条件
12.2、编辑EEPROM启动顺序
12.3、NVMe BOOT_ORDER
12.4、举例
12.5、故障排除
十三、HTTP启动
13.1、要求
13.2、密钥
13.3、证书
13.4、安全启动
十四、引导顺序
十五、EEPROM引导流程
15.1、第一阶段引导加载程序
15.2、第二阶段引导加载程序
15.3、万博网页版登陆页派5的不同之处
15.4、Bootloader 更新
15.5、故障安全OS更新(tryboot)
15.6、tryboot_a_b模式
十六、万博网页版登陆页派引导加载程序配置
16.1、编辑配置
16.2、配置属性
十七、万博网页版登陆页派使用DPI显示屏
17.1、GPIO引脚
17.2、禁用其他GPIO外设
17.3、配置显示屏
十八、40P GPIO针脚
18.1、输入输出、如何查看GPIO定义
18.2、权限、焊盘、上电状态、中断
18.3、针脚的其他功能
18.4、电压规格
十九、GPIO焊盘控制
19.1、驱动强度控制
19.2、电流值
19.3、安全电流
19.4、GPIO 地址
19.5、驱动器强度列表
二十、Raspberry Pi的工业应用
20.1、一次性可编程设置
20.2、写入和读取客户OTP值
20.3、在非BCM2712设备上锁定OTP
20.4、在BCM2712设备上锁定OTP
20.5、在非BCM2712设备上使客户OTP位不可读
20.6、BCM2712设备上的客户MAC地址
20.7、设备专用私钥
二十一、OTP寄存器及位定义
21.1、非BCM2712设备上的OTP寄存器
21.2、BCM2712设备上的OTP寄存器
二十二、万博网页版登陆页派PCIe接口
22.1、启用PCIe
22.2、从PCIe启动
22.3、PCIe Gen 3.0警告及启用
二十三、电源按键
23.1、按键使用说明及重启方法
23.2、强制硬关机
23.3、添加自定义电源键
二十四、电源相关
24.1、电源说明及推荐电源
24.2、以太网供电(PoE)连接器
24.3、电源要求典型值
24.4、将万博网页版登陆页派待机功耗降至0.01W
24.5、电源警告及后果
24.6、电源与万博网页版登陆页派OS
24.7、USB反向供电问题
二十五、实时时钟RTC
25.1、万博网页版登陆页派定时唤醒功能
25.2、备用时钟电池、充电、禁止充电
二十六、SPI串行外设接口
26.1、SPI硬件
26.1.1、SPI Pin/GPIO映射
26.1.2、SPI主模式
26.1.3、传输模式、速度、芯片选择
26.2、SPI软件
26.3、SPI故障排除
二十七、USB(通用串行总线)
27.1、万博网页版登陆页派5的电源与USB电流限制
27.2、万博网页版登陆页派4的USB接口
27.3、万博网页版登陆页派Zero, 1. 2. 3以及早期型号的USB配置
27.4、已知的USB问题
二十八、万博网页版登陆页派版本代号
28.1、早期万博网页版登陆页派版本代号
28.2、新版本代码
28.3、正在使用的修订版本代码
28.4、使用版本代号识别电路板
28.5、版本代号使用的最佳实践
B、万博网页版登陆页派官方系统篇点此查看 一、下载与安装
二、Raspberry Pi OS介绍
三、软件更新
3.1、安装更新
3.2、搜索软件
3.3、安装包
3.4、卸载包
3.5、管理APT磁盘使用情况
3.6、升级操作系统至新版本
3.7、固件升级
3.8、系统版本退回
四、播放音频和视频
4.1、VLC 媒体播放器
4.2、在万博网页版登陆页派 OS Lite上播放音频和视频
4.3、指定音频输出设备
4.4、指定视频输出设备
4.5、同时指定音频和视频输出设备
4.6、提升流播放性能
五、实用工具
5.1、kmsprint
5.2、vclog
5.3、vcgencmd
六、无障碍选项
七、在Raspberry Pi上使用Python
7.1、使用apt安装Python包
7.2、使用pip安装Python库
7.3、使用Thonny编程
八、通过Python控制GPIO设备
8.1、LED控制
8.2、读取按钮状态
8.3、用按钮控制LED
C、万博网页版登陆页派系统配置篇点此查看 一、raspi-config配置工具
1.1、raspi-config、config.txt区别
1.2、开始使用
1.3、通过终端导航配置工具
1.4、系统选项(1 System Opthions)
1.5、显示选项 (2 Display options)
1.6、接口选项 (3 Interface options)
1.7、性能选项 (4 Performance options)
1.8、Localisation options(本地化选项)
1.9、高级选项(Advanced options)
1.10、更新 Update
二、非交互式 raspi-config
2.1、系统选项(System Opthions)
2.2、显示选项 (Display options)
2.3、接口选项 (Interface options)
2.4、性能选项 (Performance options)
2.5、本地化选项(Localisation options)
2.6、高级选项(Advanced options)
2.7、更新
三、显示器
3.1、HDMI显示器支持
3.2、通过桌面设置分辨率和旋转
3.3、通过命令行界面(CLI)设置显示
3.4、手动设置分辨率和旋转
3.5、控制台分辨率和旋转设置
四、音频设置
五、网络连接
5.1、通过桌面连接到无线网络
5.2、通过命令行连接无线网
5.3、配置DHCP
六、黑屏相关
6.1、桌面环境下的屏幕黑屏设置
6.2、控制台
七、用户
7.1、更改用户密码
7.2、添加用户
7.3、删除用户
7.4、更改默认用户
八、外部存储
8.1、挂载存储设备
8.2、自动挂载存储设备
8.3、卸载存储设备
九、内核命令行(cmdline.txt)
9.1、命令行选项
9.2、设置KMS显示模式
9.3、其他条目
十、本地化万博网页版登陆页派
十一、保护您的万博网页版登陆页派
11.1、为sudo命令设置密码
11.2、更新Raspberry Pi OS
11.3、自动更新SSH服务器
11.4、提高SSH安全性
11.5、使用防火墙
11.6、使用fail2ban阻止可疑活动
十二、设置无头万博网页版登陆页派
12.1、连接到网络
12.2、远程访问无头万博网页版登陆页派
十三、让万博网页版登陆页派托管无线网络
13.1、启用热点
13.2、禁用热点
13.3、将您的Raspberry Pi用作网络桥接器
13.4、桥接网络
十四、使用代理服务器
14.1、配置您的万博网页版登陆页派
14.2、更新 sudoers 文件
十五、boot 文件夹内容
15.1、bootcode.bin
15.2、start*.elf
15.3、fixup*.dat
15.4、cmdline.txt
15.5、config.txt
15.6、issue.txt
15.7、initramfs*
15.8、ssh 或 ssh.txt
15.9、Device Tree blob 文件 (*.dtb)
15.10、Kernel files (*.img)
15.11、overlays 文件夹
十六、LED警告闪烁代码
十七、配置UART
17.1、万博网页版登陆页派 Zero、1、2和3
17.2、Raspberry Pi 4和400
17.3、Raspberry Pi 5的UART配置
17.4、Compute Module的UART配置
17.5、主UART
17.6、次UART
17.7、主UART和次UART
17.8、Mini-UART与CPU核心频率说明
17.9、禁用Linux串行控制台
17.10、为Linux启用早期控制台
17.11、UART与设备树
17.12、PL011 UART与mini-UART的区别
十八、设备树、覆盖层和参数
18.1、设备树
18.2、基本的DTS语法
18.3、关于/include/的补充说明
18.4、标签与引用
18.5、设备树语义
18.6、设备树覆盖层
18.6.1、片段
18.6.2、设备树参数
18.6.3、字符串参数
18.6.4、 整数参数
18.6.5、布尔参数
18.6.6、字节字符串参数
18.6.7、具有多个目标的参数
18.6.8、文字赋值
18.6.9、查找表
18.6.10、覆盖/片段参数
18.6.11、特殊属性
18.6.12、覆盖映射文件
18.6.13、示例
18.7、导出标签
18.8、覆盖层应用顺序
18.9、在万博网页版登陆页派上使用设备树(Device Trees)
18.9.1、DTB, overlays 和 config.txt
18.9.2、设备树(DT)参数
18.9.3、特定于板子的标签和参数
18.9.4、HAT与设备树
18.9.5、动态设备树
18.9.5.1、dtoverlay命令
18.9.5.2、dtparam命令
18.9.6、支持的覆盖层和参数
18.10、固件参数
18.10.1、常见的引导加载程序属性
18.10.2、电源属性
18.10.3、BCM2711和BCM2712特有的引导加载程序属性
18.10.4、BCM2711和BCM2712的USB引导属性
18.10.5、NVMEM节点
18.10.6、NVMEM设备别名说明
18.11、故障排除
18.11.1、调试
18.11.2、使用dtmerge、dtdiff和ovmerge测试覆盖层
18.11.3、强制使用特定的设备树
18.11.4、禁用设备树的使用
18.11.5、快捷方式及语法变体
18.11.6、config.txt中可用的其他DT命令
十九、更改默认引脚配置
19.1、启动序列中的设备引脚
19.2、提供自定义设备树二进制文件
19.3、dt-blob的组成部分
19.3.1、videocore(视频核心配置)
19.3.2、pins_*(引脚配置)
19.3.3、pin_config(引脚配置)
19.3.4、pin@pinname(引脚名称)
19.3.5、pin_defines(引脚定义)
19.4、时钟配置
19.5、示例设备树源文件说明
D、万博网页版登陆页派config.txt配置文件详解 点此查看
一、什么是config.txt?
1.1、文件格式
1.2、高级功能
1.2.1、包括
1.2.2、条件过滤
二、autoboot.txt
2.1、boot_partition
2.2、过滤器
2.3、tryboot_a_b
2.4、A/B启动的示例更新流程
2.4.1、安装更新
2.4.2、提交或取消更新
三、常用选项
3.1、常用显示选项
3.2、常用硬件配置选项
3.2.1、camera_auto_detect
3.2.2、display_auto_detect
3.2.3、dtoverlay
3.2.4、dtparam
3.2.5、arm_boost
3.2.6、power_force_3v3_pwm
四、板载模拟音频(3.5毫米插孔)
4.1、audio_pwm_mode
4.2、disable_audio_dither
4.3、enable_audio_dither
4.4、pwm_sample_bits
五、HDMI音频
六、引导选项
6.1、start_file, fixup_file
6.2、cmdline
6.3、kernel
6.4、arm_64bit
6.5、ramfsfile
6.6、ramfsaddr
6.7、initramfs
6.8、auto_initramfs
6.9、disable_poe_fan
6.10、disable_splash
6.11、enable_uart
6.12、force_eeprom_read
6.13、os_prefix
6.14、otg_mode(仅适用万博网页版登陆页派4)
6.15、overlay_prefix
6.16、配置属性
6.16.1、boot_ramdisk
6.16.2、boot_load_flags
6.16.3、enable_rp1_uart
6.16.4、pciex4_reset
6.16.5、uart_2ndstage
6.16.6、erase_eeprom
6.16.7、eeprom_write_protect
6.16.8、os_check
6.16.9、bootloader_update
6.17、Secure Boot配置属性
6.17.1、如何使用万博网页版登陆页派Secure Boot?
6.17.2、program_pubkey
6.17.3、revoke_devkey
6.17.4、program_rpiboot_gpio
6.17.5、program_jtag_lock
七、GPIO控制
7.1、gpio
八、超频选项
8.1、超频选项描述
8.1.1、各型号默认值
8.1.2、通用默认值
8.1.3、对于Pi4、Pi 400和CM4
8.1.4、force_turbo
8.2、时钟关系
8.3、监测核心温度
8.4、监测电压
8.5、超频问题
九、条件过滤器
9.1、使用场景
9.2、条件过滤器的作用
9.3、 过滤器
9.4、模型过滤器
9.5、 过滤器
9.6、 过滤器
9.7、 过滤器
9.8、序列号过滤器
9.9、GPIO过滤器
9.10、组合条件过滤器
十、内存选项
十一、许可证密钥和编解码器选项
十二、视频选项
12.1、HDMI模式
12.1.1、4系列设备的HDMI管道
12.1.2、5系列设备的HDMI管道
12.2、复合视频模式
12.2.1、enable_tvout
12.3、LCD显示屏和触摸屏
12.4、通用显示选项
十三、摄像头设置
E、万博网页版登陆页派Linux内核篇点此查看 一、引言
二、关于更新
三、构建内核
3.1、下载内核源码
3.2、本地构建内核
3.2.1、安装构建依赖项
3.2.2、构建配置
3.2.2.1、64位架构
3.2.2.2、32位架构
3.2.3、自定义内核版本
3.2.4、构建
3.2.5、安装内核
3.2.5.1、安装64位内核的具体步骤
3.2.5.2、安装32位内核
3.3、交叉编译内核
3.3.1、安装所需依赖项和工具链
3.3.2、构建配置
3.3.2.1、64位
3.3.2.2、32位
3.3.3、使用LOCALVERSION自定义内核版本
3.3.4、构建内核
3.3.5、安装内核
3.3.5.1、查找您的启动介质
3.3.5.2、挂载分区
3.3.5.3、安装内核模块
3.3.5.4、安装64位内核
3.3.5.5、安装32位内核
四、配置内核
4.1、准备配置
4.2、使用menuconfig
4.3、在menuconfig中导航
4.4、配置内核选项
4.5、保存更改
五、给内核打补丁
5.1、确定您的内核版本
5.2、应用补丁
六、内核头文件
七、贡献代码
F、万博网页版登陆页派远程访问篇点此查看
一、远程访问的方式
1.1、通过本地网络进行远程控制
1.2、通过本地网络在设备之间共享文件
1.3、通过互联网进行远程控制
二、查万博网页版登陆页派IP地址的方法
2.1、通过桌面环境查找
2.2、命令行操作
2.2.1、根据联网方式查找IP地址
2.2.2、示例说明
2.3、使用mDNS解析raspberrypi.local
2.4、检查路由器的设备列表
2.5、使用nmap查找
2.5.1、使用nmap扫描网络上的设备
2.5.2、扫描整个子网以查找其他设备
2.6、使用智能手机应用查找设备
三、使用 SSH 访问远程终端
3.1、启用 SSH 服务器
3.1.1、桌面环境
3.1.2、装系统时
3.1.3、命令行方式
3.1.4、手动方式
3.2、连接SSH
3.2.1、通过SSH转发X11
3.3、无密码配置SSH
3.3.1、使用Raspberry Pi Imager预配置操作系统镜像
3.3.2、手动配置SSH密钥
3.3.3、检查现有的SSH公钥
3.3.4、生成新的SSH密钥对
3.3.5、将SSH密钥添加到SSH身份列表中
3.3.6、将公钥复制到您的Raspberry Pi上
3.3.7、手动将公钥复制到您的Raspberry Pi上
四、通过VNC进行屏幕共享
4.1、在Raspberry Pi上启用VNC服务器
4.1.1、通过图形界面启用VNC服务器
4.1.2、通过命令行启用VNC服务器
4.2、连接到VNC服务器
4.2.1、下载并安装TigerVNC
4.2.2、在客户端设备上启动TigerVNC
4.2.3、配置TigerVNC以连接到Raspberry Pi
五、使用Raspberry Pi进行远程访问
六、使用SCP共享文件
6.1、将文件复制到Raspberry Pi
6.2、从Raspberry Pi复制文件
6.3、使用一条命令复制多个文件
6.4、复制一个文件夹
七、使用rsync同步计算机之间的文件夹
八、网络文件系统(NFS)
8.1、设置基本的NFS服务器
8.1.1、Portmap限制访问(可选)
8.2、配置NFS客户端
8.2.1、Portmap 限制访问(可选)
8.3、配置复杂的NFS服务器
8.3.1、组权限
8.3.2、DNS(可选，仅在使用DNS时)
8.3.3、NIS(可选，仅在使用NIS时)
8.3.4、Portmap限制访问(可选)
8.4、软件包的安装与配置
8.5、重启服务
8.6、需要考虑的安全事项
8.7、问题排查
九、Samba (SMB/CIFS)
9.1、在Raspberry Pi上安装Samba
9.2、挂载从Windows共享的文件夹
9.2.1、开启共享
9.2.2、共享文件夹
9.2.3、Windows 10 共享向导
9.2.4、在Raspberry Pi上挂载文件夹
9.2.5、“Host is down”错误
9.3、从Raspberry Pi共享文件夹
十、设置Apache网络服务器
10.1、安装Apache
10.2、测试网络服务器
10.2.1、更改默认网页
10.3、为Apache安装PHP
十一、通过网络启动你的Raspberry Pi
11.1、配置网络启动客户端
11.1.1、Raspberry Pi 3 Model B
11.1.2、配置Raspberry Pi 4 Model B的网络启动
11.2、记录以太网MAC地址和序列号
11.3、配置网络启动服务器
11.3.1、在客户端文件系统中重新生成SSH主机密钥
11.3.2、查找本地网络设置
11.3.3、记录DNS服务器地址
11.3.4、在服务器Raspberry Pi上配置静态网络地址
11.3.5、配置systemd/resolved.conf以解析DNS
11.3.6、启用systemd-networkd并重启
11.3.7、启动tcpdump以捕获客户端DHCP请求
11.3.8、连接并启动客户端Raspberry Pi
11.3.9、修改dnsmasq配置以启用DHCP回复
11.3.10、创建/tftpboot目录并配置权限
11.3.11、监控dnsmasq日志
11.3.12、将启动文件复制到/tftpboot目录
11.3.13、重启dnsmasq服务
11.3.14、设置NFS根目录
11.3.15、重启RPC-Bind和NFS服务器
11.3.16、编辑TFTP启动配置
11.3.17、编辑NFS客户端的fstab文件
十二、使用IPv6进行网络启动
12.1、工作原理
12.1.1、网络地址
12.1.2、TFTP地址
12.1.3、引导过程
12.1.4、内核启动
12.2、测试环境搭建
12.2.1、TFTP服务器设置
12.2.2、DHCP服务器设置
12.2.3、修改引导加载程序配置
12.2.4、路由器与IPv6支持
12.3、调试
12.3.1、日志与追踪
12.3.2、有状态配置与网络活动监控
12.3.3、无状态配置
G、摄像头相关点此查看 一、关于相机软件
万博网页版登陆页派官方相机一览
二、rpicam-apps
2.1、万博网页版登陆页派提供的rpicam-apps示例
2.1.1、Raspberry Pi OS的集成
2.1.2、自定义应用
2.2、libcamera
2.2.1、支持的相机及芯片
2.3、rpicam-hello
2.4、rpicam-jpeg
2.5、rpicam-still
2.5.1、Encoders
2.5.2、捕捉原始图像
2.5.3、捕捉长曝光图像
2.5.4、创建延时摄影视频
2.5.4.1、rpicam-still延时摄影模式
2.5.4.2、Cron自动摄影
2.5.5、将图像拼接在一起
2.6、rpicam-vid：Raspberry Pi视频捕捉工具
2.6.1、编码器与视频捕捉优化
2.6.2、捕捉高帧率视频
2.6.3、rpicam-vid 与 libav 的集成
2.7、rpicam-raw：直接录制原始Bayer帧
2.8、rpicam-detect：基于TensorFlow Lite的对象检测
2.9、配置说明
2.9.1、调整相机行为：使用调校文件
2.10、使用多台相机
2.11、安装libcamera和rpicam-apps
三、通过网络使用rpicam-apps进行视频流传输
3.1、UDP流传输
3.2、TCP流传输
3.3、RTSP流传输
3.4、使用libav进行网络流传输
3.5、GStreamer流传输
3.5.1、RTP流传输
3.5.2、libcamerasrc GStreamer元素
四、rpicam-apps 选项参考
4.1、通用选项
4.2、相机控制选项
4.3、输出文件选项
4.4、图像选项
4.5、视频输出选项
4.6、libav视频后端选项
4.7、rpicam-detect的目标检测选项
五、使用rpicam-apps进行后处理
5.1、基本后处理阶段示例
5.2、内置后处理阶段
5.2.1、否定(negate)阶段
5.2.2、高动态范围(hdr)阶段
5.2.3、运动检测(motion_detect)阶段
5.3、使用OpenCV进行后期处理
5.3.1、Sobel滤波(sobel_cv)阶段
5.3.2、人脸检测(face_detect_cv)阶段
5.3.3、图像标注(annotate_cv)阶段
5.4、使用TensorFlow Lite进行后处理
5.4.1、前置条件
5.4.2、物体分类(object_classify_tf)阶段
5.4.3、姿态估计(pose_estimation_tf)阶段
5.4.4、物体检测(object_detect_tf)阶段
5.4.5、图像分割(segmentation_tf)阶段
5.5、自定义后处理阶段
5.5.1、基础后处理阶段
5.5.2、TensorFlow Lite 阶段
六、高级rpicam-apps使用指南
6.1、自行构建libcamera和rpicam-apps
6.1.1、移除预安装的rpicam-apps
6.1.2、不构建libcamera而构建rpicam-apps
6.1.3、构建libcamera
6.1.4、构建rpicam-apps
6.1.5、rpicam-apps Meson 标志参考
6.1.6、构建libepoxy
6.2、编写自己的rpicam应用
6.2.1、rpicam-hello简介
6.2.2、rpicam-vid
6.2.3、rpicam-raw
6.2.4、rpicam-jpeg
6.3、在Qt中使用libcamera
6.4、在Python中使用Picamera2库操作libcamera
七、使用USB网络摄像头
7.1、安装依赖
7.2、拍照
7.2.1、指定不同的分辨率
7.2.2、删除横幅
7.3、自动化图像捕捉
7.4、拍摄延时摄影
八、V4L2 驱动
8.1、使用libcamera时的设备节点
8.2、使用V4L2驱动
九、Unicam
9.1、Raspberry Pi的SoC与Unicam
9.2、软件接口
9.2.1、V4L2注意事项
9.3、编写第三方驱动
9.3.1、摄像头传感器
9.3.2、设备树
9.3.3、桥接芯片
9.3.3.1、模拟视频源
9.3.3.2、数字视频源
9.3.3.3、当前支持的设备
9.4、rpicam和raspicam之间的主要区别
9.5、rpicam-apps与 raspicam在功能和选项上的主要区别
9.6、缺陷像素校正(DPC)
十、故障排除方法
十一、获取帮助
未完待续（预计30万字）
页:
[1]