PiDoctor树莓派系统健康监测和诊断工具

为了监测你的Raspberry Pi系统的健康状况，你可以使用PiCockpit的应用程序PiDoctor。PiDoctor还可以让你了解关于你的Raspberry Pi的许多细节，包括它的生产地点，它有多少内存，等等。

注意：PiDoctor曾经是独立的，但现在是picockpit-client的一部分。 PiDoctor的独立版本（PiDoctor OS）已经停止使用，而采用picockpit-client中的版本。 具有实时诊断功能，并增加了可用的诊断模块的数量。如果你仍然想要历史版本，请向下滚动到本页底部并查看常见问题。

拉斯皮-贝瑞的历史发展解释

使用PiDoctor来诊断你的Raspberry Pi

如何运行所有的Raspberry Pi健康测试

PiDoctor和其他PiCockpit应用程序一样，最多包括5台树莓Pis，都是免费的。

  1. 登录PiCockpit (报名参加 如果你还没有一个账户，它是免费的)
  2. 打开 我的覆盆子Pis 页面来访问你的Raspberry Pi概述
PiCockpit 我的树莓Pis概述
在 "我的树莓派 "概览中，点击你想运行诊断程序的树莓派
  1. 点击你要诊断的Raspberry Pi
为你的Raspberry Pi提供的应用程序，点击PiDoctor

4.点击PiDoctor

你将看到以下屏幕。

用于Raspberry Pi 4 Model B的PiCockpit PiDoctor主屏幕
PiDoctor的主控制屏幕

5.单击 "运行所有测试

现在将显示基本信息（RAM和CPU）。

点击运行所有测试后的PiDoctor

现在你可以向下滚动页面，查看各个模块的测试结果，或者点击任何一个快速访问按钮，跳到你感兴趣的系统测试模块。

点击PiDoctor中的快速访问按钮，快速跳转到正确的模块。

如何运行一个单独的Raspberry Pi健康检查模块

每个模块都有一个 按钮 在底部，它允许你只运行这个模块的测试。例如，请看一下 USB测试:

PiDoctor USB测试 - 点击运行USB测试按钮来执行测试

在上角还有一个 "自动重新加载 "的切换开关，它允许你每10秒自动运行一次测试。这对连续监测变化很有用。

可用的系统健康测试模块

WLAN

PiDoctor的WLAN健康测试模块的屏幕截图

WLAN模块允许你扫描Raspberry Pi附近的WiFi网络，确定它连接的是哪一个，以及强度。点击详细信息，你就可以看到网络的全部技术细节。

显示一个WLAN SSID的更多细节（摘录）。

在 "高级信息 "部分，有许多额外的命令，你可以看到其输出。其中一些只有在你点击 "运行此测试 "时才会被运行。

iwlist扫描是一个按需测试，只有当你点击 "运行此测试 "时才会运行。

搜索允许你在输出中快速找到匹配的行。

对WLAN频率进行过滤

网络

网络模块显示你的Raspberry Pi当前的IP地址、网络链接和已知的邻居。

Raspberry Pi自己的IP地址和网络链接/已知邻居

一些额外的信息可在高级信息部分获得。

ss -tupn和ss-tulpwn可以用来诊断你的Raspberry Pi上的活动网络连接和监听端口。

系统

系统是PiCockpit中最强大和最广泛的Raspberry Pi系统测试模块之一。

系统基本信息

第一部分。 系统基本信息，向你展示一些重要的概述信息。

  • 你的Raspberry Pi的序列号
  • 你的Raspberry Pi型号
  • 你的Raspberry Pi的SoC温度（使用这个监测CPU温度，或者使用PiStats查看每一秒的更新！）。
  • GPU的RAM
  • 当前的CPU频率--如果你正在为你的Raspberry Pi超频，这很有用。
  • 当前的CPU电压
  • Raspberry Pi相机的状态 - 诊断相机问题，看Raspberry Pi是否支持和检测到相机。
  • SD卡的生产日期
节流和欠压，ARM频率上限监控

使用下一个部分。 节流和欠电压，你可以诊断关于你的Raspberry Pi的重要信息。

  • 你的Pi电源是否足够强大？注意电压不足的问题
  • 你的Raspberry Pi运行得太热了吗？注意软温度限制、ARM频率上限和节流的问题

如果有问题（目前或以前），PiCockpit会在这里显示这些问题。例如，对于被触发的ARM频率上限。

ARM频率上限目前处于活动状态，以前也是活动的--表明有发热问题
处于崩溃状态的块设备和文件系统

块状设备和文件系统（存储空间）模块最初是折叠的，但可以通过点击箭头展开。

扩大的mmcblk0视图，显示所有分区

你将能够看到所有的分区，它们的大小，以及已安装的分区的使用空间。这将使你能够确定你的Raspberry Pi上的根分区的空间是否已经用完。

根分区总是挂载在 / - 在我们的案例中，最后一个分区，mmcblk0p7

Raspi Berry的有用的Linux知识

点击任何条目以查看更多细节。

显示根分区的详细信息

在这里，你可以点击显示所有的切换键，以显示更多的细节（可能只对想深入了解技术细节的人感兴趣）。

显示一个分区的所有细节

使用这一部分，你可以诊断出一个分区的文件系统（fstype）、它的/dev/路径（例如/dev/mmcblk0p1）、它的挂载点、大小、用量和标签等信息。

树莓派修订码解码器

有 两种风格的Raspberry Pi修订代码，PiCockpit可以处理这两种情况。新式的修订代码将给出更多细节。

  • 树莓派型号
  • 树莓派的型号修订
  • 树莓派内存
  • 树莓派处理器（使用的是SoC）。
  • 树莓派CPU
  • 制造商 - 你可以在这里找到你的Raspberry Pi是在哪个国家生产的

还有一些额外的标志，你可以在PiDoctor的System / Raspberry Pi revision code部分看到。

  • 允许的过电压
  • 允许OTP编程
  • 允许阅读OTP
  • 保修位

高级信息包括额外的诊断方法，以文本形式呈现。

高级诊断：检查Raspberry Pi OTP位、lscpu、free -b、vcgencmd get_config int、vcgencmd get_config str。

视频

视频模块允许你检查哪些显示器被连接到你的Raspberry Pi上，以及它们支持哪些模式（视频和音频）。对于Raspberry Pi 4和400，两个HDMI端口都支持。

PiDoctor的视频模块允许你检查连接到你的Raspberry Pi上的电视/显示器/监视器

正如你在截图中看到的，该显示器支持音频输出。

支持PCM。最大通道：2，最大采样率。  48kHz，最大采样率为16比特。

点击CEA模式和DMT模式，展开并查看可用的显示器模式--这对于在config.txt中设置Raspberry Pi的屏幕分辨率很有用，如果你看不清输出的话。

CEA模式是一个分辨率和频率的列表，显示器将乐于在其中工作。

USB

PiDoctor USB模块将允许你监测哪些USB设备连接到你的Raspberry Pi，并检索它们的详细信息。

PiDoctor的USB模块，显示一个USB 3.0设备和三个USB 2.0设备

点击箭头，展开USB设备的层次结构。

在这个例子中，一个Logitech Inc的Unifyuing接收器通过USB连接到Raspberry Pi上。

点击你感兴趣的设备以获得更多细节。

PiCockpit PiDoctor向您显示所连接的USB设备的详细信息
一个USB设备的细节（摘录）--允许你深入了解任何特定的设备，找出制造商、产品、bInterfaceClass（例如人机界面设备）和设备状态（例如总线供电）。

软件

PiDoctor中的软件模块将向你展示 你有哪个PiCockpit客户端版本 - 保持picockpit-client的最新状态是很重要的（使用PiControl从PiCockpit的web界面中更新它）。

而且，它还能让你看到当前正在运行的进程（ps辅助输出），并按名称搜索。

PiCockpit的PiDoctor软件测试模块
搜索picockpit应该可以看到守护模式下的picockpit-client。

请注意，这些结果/进程列表不是实时更新的--如果你希望它们定期被刷新，请点击自动重新加载（这将每10秒重新加载一次）。

启用自动重载的软件模块

在高级信息中还有一些额外的测试。

PiDoctor软件高级测试

你可以在这里访问以下命令的输出。

  • dmesg (内核信息缓冲区)
  • vcdbg log msg
  • 主机名ctl
  • vcgencmd版本
  • lsmod (加载内核模块)
  • ps辅助(原始输出)

通过在你感兴趣的特定高级信息输出的上方的搜索中输入你要找的文本，你就能快速搜索到结果。

dmesg, 内核的诊断信息缓冲区 - 是一个按需测试，点击运行这个测试来运行它。

禁用PiDoctor中的测试

如果你想禁用测试，例如出于安全原因，你应该从下列文件中删除相应的.json定义文件 

/etc/picockpit-client/apps/com.picockpit/pidoctor/modules

向PiDoctor添加自定义测试

通过添加额外的.json模块定义，可以添加自定义测试。看一下代码中存在的例子，一定要定义你自己独特的句柄，然后重新启动picockpit-client。

如果人们要求我在这里添加更多关于创建你自己的测试的文档。

注意，自定义测试将始终显示为 "高级信息"，因为没有为它们建立自定义用户界面。 如果你需要你自己的定制/用户界面的特定功能，请与我们联系，以获得报价。.

我怎样才能为我的Raspberry Pi获得PiDoctor？

这真的很简单。

  1. 注册一个账户 picockpit.com，您基于网络的Raspberry Pi管理平台.它对多达5个树莓Pis是免费的。
  2. 遵循 PiCockpit的安装说明. (你将创建一个API密钥并在你的树莓派上安装picockpit-client)
  3. 现在你可以简单地从你选择的浏览器的网页界面上访问PiDoctor，如本页所述

常见问题

PiDoctor没有显示在附加工具下，我如何访问它？

PiDoctor已被合并到PiCockpit中 - 请注意 在你的Raspberry Pi上安装picockpit-client，并访问PiDoctor应用程序。

经典的、独立的PiDoctor版本已经停产了。

我怎样才能下载EDID？它曾经在经典的PiDoctor软件中可用。

目前在新的PiDoctor应用程序中没有实现EDID的提取。不过，你想要EDID的很多输出都实现了。 请看上面的屏幕截图.

关于如何在Raspberry Pi上手动读取显示器的EDID的说明，请点击这里。

我可以下载PiDoctor的历史单机版吗？

你可以在这里下载PiDoctor的最新遗留独立版本（2.1.18版）。该软件按原样提供，没有任何形式的保证。

有了历史版本，你可以用同一张SD卡依次测试许多不同的Pi--它将为你测试过的每个Pi创建一个JSON日志文件，提取不同的数据。

这篇博文可能会派上用场，作为笔记 如何使用PiDoctor的遗产。

下载链接。

这些下载链接包含相同的基于Alpine Linux的基础软件--为了你的方便，有不同的格式。如有疑问，请选择.img.zip，并使用Etcher等工具编写镜像。

请注意以下限制。

  • 传统的PiDoctor版本不支持Pi 4或Pi 400（新版本的PiDoctor，作为Pi 4或Pi 400的一部分）。 码头 平台支持所有的Raspberry Pis，并将继续更新)
  • 传统版本不能安装在现有的操作系统上--你需要把它放在自己的SD卡上。
  • 在线评估工具已经停止使用，所以你必须自己查看原始的JSON文件 - 不幸的是，这种文件格式与新的PiCockpit平台V2不兼容。
  • 我们无法为传统版本提供无偿支持。 - 然而，如果你希望我们为你的业务建立一个解决方案，并愿意 为咨询和发展付费，请联系我们

你仍然有问题/需要支持吗？

请 与我们取得联系我们的目标是帮助你快速开始使用PiCockpit。