balena ads b

在 balena 上运行的 ADS-B 飞行跟踪器，支持 FlightAware、Flightradar24、Plane Finder、OpenSky Network、AirNav RadarBox、ADSB Exchange、Wingbits、adsb.fi、ADSB.lol、ADS-B One、airplanes.live、Planespotters.net、 TheAirTraffic、AvDelphi、HP Radar、RadarPlane 和 Fly Italy ADSB。

为航班跟踪社区做出贡献！将本地 ADS-B 数据从 RTL-SDR USB 加密狗（或各种其他无线电类型）和运行 balenaOS 的受支持设备（见下文）馈送到跟踪服务 FlightAware、Flightradar24、Plane Finder、OpenSky Network、AirNav RadarBox、ADSB Exchange 、Wingbits、adsb.fi、ADSB.lol、ADS-B Oneplanes.live、Planespotters.net、TheAirTraffic、AvDelphi、 HP Radar、RadarPlane 和 Fly Italy ADSB。作为回报，您每年可以获得价值数百美元的免费高级帐户（或加密货币代币）！

保持最新动态

？订阅我们的时事通讯？随时了解 balena ADS-B 飞行跟踪器的最新发展。

你被卡住了吗？寻求帮助！

在我们的讨论区提问

✏️ 在我们的 balena 论坛帖子中创建帖子

在 GitHub 上提出问题

观看 2021 年 3 月 balena IoT 欢乐时光和 2021 年 10 月 balena 黑客马拉松的视频

？直接伸出手

？阅读过去的新闻通讯

支持的设备

	设备
	英特尔NUC
	Nvidia Jetson Nano SD 卡
	橙色圆周率零
	树莓派 3 型号 B+
	树莓派3（使用64位操作系统）
	树莓派4（使用64位操作系统）
	树莓派 400
	树莓派5

如果您在此处未列出的硬件平台上成功运行 balena-ads-b，请告诉我们！

支持的无线电

该软件默认使用 RTL-SDR 无线电设备。不过，它也与 S 模式 Beast、bladeRF、HackRF、LimeSDR 和 SoapySDR 兼容。您可以在下面的使用不同无线电设备类型部分找到有关配置这些设备类型的更多信息。

制作人员

balena-ads-b 项目由 Ketil Moland Olsen 创建。现在它由 Ketil、Aaron Shaw (shawaj) 和 Teko012 团队共同维护。

该项目受到以下存储库和论坛主题的启发并借用了代码：

• https://github.com/compujuckel/adsb-docker
• https://bitbucket.org/inodes/resin-docker-rtlsdr
• https://github.com/wercsy/balena-ads-b
• https://github.com/mikenye/
• https://discussions.flightaware.com/
• https://github.com/marcelstoer/docker-adsbexchange

感谢 compujuckel、Glenn Stewart、wercsy、mikenye、abcd567a 和 marcelstoer 的分享！

感谢 garethhowell 实施了最初的 ADSB Exchange 支持，并感谢 wiedehopf 对其进行了改进。

感谢 rmorillo24 验证 balenaFin 兼容性、adaptive 确认 Raspberry Pi 400 兼容性，以及 eagleDiego 确认 Orange Pi Zero 兼容性。

感谢 schubydoo 帮助保持存储库最新。

感谢 Teko012 对存储库进行现代化改造、保持最新状态并提出了多项改进建议。

感谢 schubydoo、JPGMC 和 alanb128 对 UAT 支持进行 Beta 测试。

感谢 Aaron Shaw (shawaj) 实现了 Wingbits 和 S 模式 Beast 支持、修复了错误并改进了代码。

你们都是明星！ ？

CREDITS.md 中公开了由 balena-ads-b 脚本下载、安装和配置的软件包。

贡献者

目录

• 第 1 部分 – 构建接收器
• 第 2 部分 – 设置 balena 并配置设备
• 第 3 部分 – 配置 FlightAware
  • 替代方案 A：移植现有的 FlightAware 接收器
  • 替代方案 B：设置新的 FlightAware 接收器
• 第 4 部分 – 配置 Flightradar24
  • 替代方案 A：移植现有的 Flightradar24 接收器
  • 替代方案 B：设置新的 Flightradar24 接收器
• 第 5 部分 – 配置平面查找器
  • 替代方案 A：移植现有的 Plane Finder 接收器
  • 替代方案 B：设置新的 Plane Finder 接收器
• 第 6 部分 – 配置 OpenSky 网络
  • 替代方案 A：移植现有的 OpenSky 网络接收器
  • 替代方案 B：设置新的 OpenSky 网络接收器
• 第 7 部分 – 配置 RadarBox
  • 替代方案 A：移植现有的 RadarBox 接收器
  • 替代方案 B：设置新的 RadarBox 接收器
• 第 8 部分 – 配置 ADSB Exchange 和克隆
  • 启用 ADSB 交换
  • 启用 ADSB Exchange 克隆
• 第 9 部分 – 配置 Wingbits
  • 替代方案 A：移植现有的 Wingbits 接收器
  • 替代方案 B：设置新的 Wingbits 接收器
• 第 10 部分 – 配置 UAT（可选，仅限美国）
• 第 11 部分 – 添加数字显示器（可选）
• 第 12 部分 – 在您的设备上探索本地航班流量
• 第 13 部分 – 高级配置
  • 禁用特定服务
  • 自适应增益配置
  • 设置 dump1090 天线增益
• 第 14 部分 – 更新到最新版本

第 1 部分 – 构建接收器

我们将使用 Flightradar24、FlightAware 和 RadarBox 网站上概述的部件构建接收器：

• https://www.flightradar24.com/build-your-own
• https://flightaware.com/adsb/piaware/build
• https://www.radarbox.com/raspberry-pi

这些网站建议将 Raspberry Pi 3 Model B+ 作为首选设备。尽管如此，该项目仍然可以在上述所有设备上运行。假设您专门为此项目购买一台新设备。在这种情况下，我们建议使用具有尽可能多内存的Raspberry Pi 4 Model B。这是物超所值的。

除了该设备之外，您还需要一个兼容 RTL-SDR 的 USB 加密狗。这些加密狗基于数字电视调谐器，并且可以使用多种类型 - 通用电视棒和专用 ADS-B 棒（由 FlightAware 生产）。虽然这两种选择都有效，但 ADS-B 棒的性能似乎更好一些。

如果您居住在美国，并且除了 ADS-B 流量之外还想跟踪 UAT 流量，则可以并行使用两个加密狗。请注意，蓝色 FlightAware USB 设备只能用于 ADS-B 流量，因为它们具有专门针对 1090 MHz 频率优化的集成滤波器。橙色的 FlightAware USB 设备非常适合跟踪 UAT 流量。有关更多详细信息，请参阅第 10 部分 – 配置 UAT（可选，仅限美国）。

第 2 部分 – 设置 balena 并配置设备

或者

1. 创建一个免费的 balena 帐户。在此过程中，系统会要求您上传 SSH 公钥。如果您还没有公共 SSH 密钥，您可以创建一个。
2. 登录 balena 并前往“舰队”面板。
3. 使用您为您的设备类型选择的名称创建队列。请记下车队名称。您稍后会需要它。在出现的对话框中，选择与您的设备匹配的默认设备类型。如果您想使用 WiFi（并且您的设备支持），请指定 SSID 和密码。 （如果您的设备未主动连接到 Internet，则wifi-connect容器将创建一个带有强制门户的网络，以连接到本地 WiFi 网络。创建的热点的 SSID 为balenaWiFi ，密码为balenaWiFi 。连接后，在网络浏览器中访问http://192.168.42.1:8181/以设置连接。
4. balena 将为您创建一个 SD 卡映像，几秒钟后将自动开始下载。使用 balena 的专用工具 balenaEtcher 将图像闪存到 SD 卡。
5. 将 SD 卡插入接收器，并将其连接到有线网络（除非您计划仅使用 WiFi 并在步骤 3 中进行配置）。
6. 打开接收器电源。
7. 从 balena 仪表板，导航到您创建的车队。几分钟内就会出现一个具有自动生成名称的新设备。单击它将其打开。
8. 单击当前设备名称旁边的铅笔图标，根据您的喜好重命名您的设备。
9. 接下来，我们将配置接收器的地理位置。除非您牢记这一点，否则您可以使用 Google 地图来找到它。当您在地图上单击所需位置时，应该会出现相应的坐标。我们正在寻找十进制坐标，它应该看起来像60.395429, 5.325127。
10. 返回 balena 控制台，验证您是否已打开所需设备的视图。单击“设备变量”按钮。添加以下两个变量： LAT (接收器纬度) ，例如值60.12345和LON (接收器经度) ，例如值4.12345 。
11. 现在，您将在名为ALT新变量中输入接收器的海拔高度（以米为单位） 。如果您需要查找海拔高度，可以使用多种在线服务之一来查找。如果您的天线安装在地面以上，请记住添加相应米的大约数量。
12. 快到了！接下来，我们将通过balena云将此代码推送到您的设备。我们将使用 balena CLI 来完成此操作。按照官方说明下载并安装适合您选择的平台的 CLI。
13. 进入终端并使用以下命令登录 balena： balena login 。然后按照屏幕上的说明进行操作。
14. 接下来，使用您选择的 Git 客户端或标准命令行工具将 balena-ads-b 存储库克隆到本地计算机： git clone [email protected]:ketilmo/balena-ads-b.git 。如果您想对存储库进行更改，也可以分叉它。
15. 输入cd balena-ads-b进入新克隆的存储库的文件夹。
16. 您还记得之前您的舰队名称吗？好的。现在，我们准备通过输入balena push YOUR–FLEET–NAME–HERE将应用程序推送到 balena 的服务器。
17. 现在，等待 Docker 容器在 balena 的服务器上构建。如果该过程成功，您将在终端窗口中看到一幅美丽的 ASCII 艺术作品，描绘了一只独角兽：

 
			     
			      \
			       \
			        >/7
			    _.-(6' 
			   (=___._/` 
			        )  |
			       //|
			      //
			     j < _
			 _.-'：``。
			 r=._`.
			<`\_  .`-.
			 r-7`-。 ._'。 `
			  `, `-.`7 7) )
			   /| ' / `-._
			              || .'
			               \（
			                > >
			            ,.-'>.'
			           <.'_.''
			             <'

18. Docker 容器正在部署并安装到您的设备上，请稍等片刻。现在基础工作已经完成——干得好！

第 3 部分 – 配置 FlightAware

替代方案 A：移植现有的 FlightAware 接收器

如果您之前已经设置了独立的 FlightAware 接收器并希望将其移植到 balena，则只需执行以下步骤：

1. 前往 balena 仪表板中的设备页面，然后单击“设备变量”按钮。添加以下变量： FLIGHTAWARE_FEEDER_ID ，然后粘贴您的唯一标识符密钥，例如134cdg7d-7533-5gd4-d31d-r31r52g63v12 。该 ID 可以在 FlightAware 网站的“我的 ADS-B”部分找到。
2. 在 balena 仪表板中，单击服务名称旁边的“循环”图标，重新启动“服务”下的piaware服务。

替代方案 B：设置新的 FlightAware 接收器

如果您之前没有设置要重复使用的 FlightAware 接收器，请执行以下步骤：

1. 返回设备的摘要页面。在“终端”部分中，单击“选择目标” ，然后单击“piaware” ，最后单击“启动终端会话” 。这将打开一个终端，让您直接与 PiAware 容器交互。
2. 出现终端提示后，输入/getid.sh （包括前导斜杠），然后按回车键。
3. 如果一切按计划进行，您的 FlightAware 支线 ID 很快就会出现。复制它。
4. 单击左侧菜单中的“设备变量”按钮。添加名为FLIGHTAWARE_FEEDER_ID的变量并粘贴上一步中的值，例如134cdg7d-7533-5gd4-d31d-r31r52g63v12 。
5. 返回设备的摘要页面。单击服务名称旁边的“循环”图标，重新启动“服务”下的piaware服务。
6. 在 FlightAware 注册一个新帐户，然后使用您新创建的凭据登录。
7. 重要提示：当您与接收器连接到同一网络（有线或无线）时，请前往 FlightAware 的索赔接收器页面。 （如果这不起作用，您可以尝试使用此链接：https://flightaware.com/adsb/piaware/claim/98395c99-xxxxxxxxx16e。将“claim”后面的部分替换为您的FLIGHTAWARE_FEEDER_ID 。）
8. 检查“链接的 PiAware 接收器”标题下是否出现任何接收器。 （如果没有，请等待几分钟，然后单击“再次检查我的 PiAware”按钮。）希望您的接收器现在可以在“链接的 PiAware 接收器”标题下可见。
9. 在页面顶部的左侧菜单中，单击我的 ADBS-B菜单项。您的设备应列在橙色矩形中。接下来，单击屏幕右侧的齿轮图标。
10. 单击“配置位置”按钮，并验证该位置是否与您之前输入的坐标相匹配。如果不是，请纠正它们。
11. 单击“配置高度”按钮，然后指定接收器的高度。该值应与您在第 1 部分中在ALT变量中输入的数字匹配。
12. 如果您没有遇到任何带宽限制，请启用多边定位 (MLAT)。启用 MLAT 可让您的接收器连接到附近的其他接收器，以对未通过 ADS-B 报告位置的飞机位置进行多点定位。此选项会增加带宽使用量，但也会提供更明显的飞机位置。
13. 根据您的喜好指定 FlightAware 灯箱中的其他设置。关闭灯箱。
14. 最后，验证 FlightAware 是否正在从您的接收器接收数据。您可以通过单击 Flightaware.com 上的“我的 ADS-B”顶部菜单项找到接收器的仪表板。

第 4 部分 – 配置 Flightradar24

替代方案 A：移植现有的 Flightradar24 接收器

如果您之前已经设置了 Flightradar24 接收器并希望将其移植到 balena，您只需执行以下步骤：

1. 返回 balena 仪表板和您设备的页面。单击“设备变量”按钮。添加名为FR24_KEY的变量并粘贴现有 Flightradar24 密钥的值，例如dv4rrt2g122g7233 。密钥位于 Flightradar24 配置文件中，通常可以在这里找到： /etc/fr24feed.ini 。 （如果您找不到旧密钥，请按照备选方案 B 中的步骤检索或创建新密钥。）
2. 单击服务名称旁边的“循环”图标，重新启动“服务”下的fr24feed服务。

替代方案 B：设置新的 Flightradar24 接收器

如果您之前没有设置过要重复使用的 Flightradar24 接收器，请执行以下步骤：

1. 返回 balena 仪表板上的设备页面。
2. 在“终端”部分中，单击“选择目标” ，然后单击“fr24feed” ，最后单击“启动终端会话” 。
3. 这将打开一个终端，让您直接与 Flightradar24 容器交互。
4. 在提示符处输入fr24feed --signup 。
5. 当询问时，输入您的电子邮件地址。
6. 系统会询问您是否有 Flightradar24 共享密钥。除非您想重复使用过去的内容，否则请在此处按回车键。
7. 如果您想激活多点定位，请在下一个提示处键入yes 。如果您的带宽有限，请考虑输入no将其关闭。
8. 输入接收器的纬度。这应该与您在第 1 部分中在LAT变量中输入的值相同。
9. 输入接收者的经度。这应该与您在第 1 部分中在LON变量中输入的值相同。
10. 最后，输入接收器的高度（以英尺为单位）。您可以通过将第 1 部分中ALT变量中输入的值乘以 3.28 来计算。
11. 现在，将显示您的设置摘要。如果您对结果感到满意，请输入yes继续。
12. 在接收器类型下，为 ModeS Beast 选择4 。
13. 在连接类型下，选择1作为网络连接。
14. 当询问您的接收者的 IP 地址/主机名时，请输入dump1090-fa 。
15. 接下来，输入数据端口号： 30005 。
16. 键入no以禁用端口 30334 上的 RAW 数据馈送。
17. 键入no以禁用端口 30003 上的基站数据馈送。
18. 输入0以禁用日志文件写入。
19. 当询问日志文件路径时，只需按回车键即可。
20. 现在将提交配置，您将被重定向回终端。
21. 在提示符下，输入cat /etc/fr24feed.ini 。将显示您的 Flightradar24 设置。
22. 找到以fr24key=开头的行，然后复制引号之间的字符串。它看起来像这样： dv4rrt2g122g7233 。
23. 单击左侧菜单中的“设备变量”按钮。添加名为FR24_KEY的变量并粘贴上一步中的值，例如dv4rrt2g122g7233 。
24. 单击服务名称旁边的“循环”图标，重新启动“服务”下的fr24feed服务。
25. 前往 Flightradar24 的网站并使用您在步骤 5 中填写的完全相同的电子邮件地址创建一个新的基本帐户。
26. 在您的接收器开始向 Flightradar24 提供数据后不久，您的基本帐户将升级到其商业计划。享受！

第 5 部分 – 配置平面查找器

替代方案 A：移植现有的 Plane Finder 接收器

如果您之前已经设置了 Plane Finder 接收器并希望将其移植到 balena，则只需执行以下步骤：

1. 返回 balena 仪表板和您设备的页面。单击“设备变量”按钮。添加名为PLANEFINDER_SHARECODE的变量并粘贴现有 Plane Finder 键的值，例如7e3q8n45wq369 。您可以在 Plane Finder 的“您的接收者”页面找到您的密钥。
2. 在 balena 仪表板的设备页面上，通过单击服务名称旁边的“循环”图标，重新启动“服务”下的planfinder服务。

替代方案 B：设置新的 Plane Finder 接收器

如果您之前没有设置过要重复使用的 Plane Finder 接收器，请执行以下步骤：

1. 注册新的 Plane Finder 帐户或登录您现有的帐户。
2. 在“终端”部分中，单击“选择目标” ，然后单击“planefinder” ，最后单击“启动终端会话” 。
3. 这将打开一个终端，让您可以直接与 Plane Finder 容器交互。
4. 出现终端提示后，输入pfclient ，然后按回车键。
5. 如果一切按计划进行，您将在终端部分看到一些输出日志消息。
6. 滚动到页面顶部并查找您设备的本地 IP 地址- 它应该类似于192.168.2.35 - 如果有多个 IP 地址，则其中任何一个都应该有效。单击 IP 地址旁边的按钮将其复制到剪贴板。
7. 打开浏览器窗口，粘贴 IP 地址，然后按回车键。这应该加载 Plane Finder 共享代码生成器页面。
8. 填写表格以生成 Plane Finder 共享代码。使用您注册 Plane Finder 帐户时使用的同一电子邮件地址。对于接收器 Lat ，使用第 2 部分中LAT变量的值。对于接收器 Lon ，使用LON变量的值。最后，单击“创建新共享代码”按钮。共享代码应该会在几秒钟内出现。它应该类似于6g34asr1gvvx7 。将其复制到剪贴板。忽略表格的其余部分 - 您不必填写此部分。
9. 打开 Plane Finder 的“您的接收者”页面。在“添加接收者”标题下，找到“共享代码”输入字段。粘贴上一步中的共享代码，然后单击“添加接收器”按钮。
10. 返回 Balena 仪表板和您设备的页面。单击“设备变量”按钮。添加名为PLANEFINDER_SHARECODE的变量并粘贴您刚刚创建的 Plane Finder 键的值，例如7e3q8n45wq369 。
11. 在 Balena 仪表板的设备页面上，单击服务名称旁边的“循环”图标，重新启动“服务”下的planfinder服务。

第 6 部分 – 配置 OpenSky 网络

替代方案 A：移植现有的 OpenSky 网络接收器

如果您之前已经设置了 OpenSky 网络接收器并希望将其移植到 balena，则只需执行以下步骤：

1. 返回 balena 仪表板和您设备的页面。单击设备变量按钮 – Vx 。
2. 添加名为OPENSKY_USERNAME的变量并粘贴您的 OpenSky Network 用户名，例如JohnDoe123 。您可以在 OpenSky 网络仪表板页面上找到您的用户名。
3. 添加名为OPENSKY_SERIAL的变量并粘贴现有 OpenSky 网络序列号的值，例如1663421823 。您可以在 OpenSky Network Dashboard页面上找到您的序列号。
4. 在 balena 仪表板的设备页面上，单击服务名称旁边的“循环”图标，重新启动“服务”下的opensky-network服务。

替代方案 B：设置新的 OpenSky 网络接收器

如果您之前没有设置要重复使用的 OpenSky 网络接收器，请执行以下步骤：

1. 注册一个新的 OpenSky 网络帐户。请务必使用发送给您的电子邮件激活它。请记下您的用户名。您很快就会需要它。
2. 返回 balena 仪表板上的设备页面。单击左侧菜单中的“设备变量”按钮。添加一个名为OPENSKY_USERNAME的变量，并用您新创建的 OpenSky 用户名填充它，例如JohnDoe123 。
3. 返回设备的摘要页面。单击服务名称旁边的“循环”图标，重新启动“服务”下的opensky-network服务。等待服务完成重新启动。
4. 在“终端”部分中，单击“选择目标” ，然后单击“opensky-network” ，最后单击“启动终端会话” 。
5. 这将打开一个终端，让您直接与 OpenSky 网络容器交互。
6. 出现终端提示后，输入/getserial.sh （包括前导斜杠），然后按回车键。
7. 如果一切按计划进行，您的 OpenSky 网络序列号很快就会出现。复制它。
8. 单击左侧菜单中的“设备变量”按钮。添加名为OPENSKY_SERIAL的变量并粘贴上一步中的值，例如1267385439 。
9. 返回设备的摘要页面。单击服务名称旁边的“循环”图标，重新启动“服务”下的opensky-network服务。
10. 前往您的 OpenSky 网络仪表板并验证您的接收器是否显示并提供数据。

第 7 部分 – 配置 RadarBox

替代方案 A：移植现有的 RadarBox 接收器

如果您之前已经设置了RadarBox接收器并想将其移植到Balena，您只需执行以下步骤：

1. 返回 Balena 仪表板和您设备的页面。单击“设备变量”按钮。添加名为RADARBOX_KEY的变量并粘贴现有 RadarBox 密钥的值，例如546b69e69b4671a742b82b10c674cdc1 。要获取密钥，请在当前的 RadarBox 设备上发出以下命令： sudo rbfeeder --showkey --no-start 。
2. 单击服务名称旁边的“循环”图标，重新启动“服务”下的雷达盒服务。

替代方案 B：设置新的 RadarBox 接收器

如果您之前尚未设置要重复使用的 RadarBox 接收器，请执行以下步骤：

1. 注册一个新的 RadarBox 帐户。请务必使用发送给您的电子邮件激活它。
2. 返回 balena 仪表板上的设备页面。
3. 在“终端”部分中，单击“选择目标” ，然后单击“雷达箱” ，最后单击“启动终端会话” 。
4. 这将打开一个终端，让您直接与 RadarBox 容器交互。
5. 在提示符处输入/showkey.sh 。您的 RadarBox 密钥将显示出来，看起来类似于： 546b69e69b4671a742b82b10c674cdc1 。
6. 单击左侧菜单中的“设备变量”按钮。添加名为RADARBOX_KEY的变量并粘贴步骤 5 中的值，例如546b69e69b4671a742b82b10c674cdc1 。
7. 单击服务名称旁边的“循环”图标，重新启动“服务”下的雷达盒服务。
8. 前往 RadarBox 的“认领您的 Raspberry Pi”页面。找到名为共享密钥的输入字段，然后粘贴步骤 5 中的值，例如546b69e69b4671a742b82b10c674cdc1 。
9. 系统可能会要求您输入馈线的位置和距地面的高度。输入您之前在LAT和LON变量中输入的相同值。当询问天线的高度时，请以距地面米（或英尺）为单位指定，而不是像之前那样指定为海平面以上。如果系统没有要求您输入此信息，您可以通过单击屏幕左侧接收者 ID 下方的“编辑”链接来手动输入。
10. 最后，验证 RadarBox 是否正在从接收器接收数据。您可以通过单击radarbox.com 上“Stations ”手风琴下的“Account”菜单来找到您的接收器。

第 8 部分 – 配置 ADSB Exchange 和克隆

启用 ADSB 交换

1. 返回 balena 仪表板上的设备页面。在“终端”部分中，单击“选择目标” ，然后单击“adsb-exchange” ，最后单击“启动终端会话” 。这将打开一个终端，让您可以直接与 ADSB Exchange 容器交互。
2. 在提示符处，键入/usr/local/share/adsbexchange-stats/create-uuid.sh然后按回车键。将显示您的 ADSB-Exchange UUID。记下来。
3. 在同一提示符下，键入/create-sitename.sh然后按回车键。按照屏幕上的说明为您的喂食器输入一个友好的名称（例如您的位置）。按回车键并记下结果。
4. 单击“设备变量”按钮。使用步骤 2 中的值添加名为ADSB_EXCHANGE_UUID的变量。
5. 单击“设备变量”按钮。使用步骤 3 中的值添加名为ADSB_EXCHANGE_SITENAME的变量。
6. 单击服务名称旁边的“循环”图标，重新启动“服务”下的adsb-exchange服务。
7. 接下来，等待一两分钟，让服务重新启动，然后从与馈送器位于同一网络上的 PC 转到 ADSB Exchange 的馈送器状态页面。验证您的 Feed 是否显示为已注册，并且 ADSB Exchange 是否正在接收您的 Feed 和 MLAT 数据。您还可以通过搜索您的站点名称，在 ADSB Exchange 馈线地图上验证馈线的性能。

启用 ADSB Exchange 克隆

该项目支持 ADSB Exchange 出售后出现的许多 ADSB Exchange 克隆。目前支持 adsb.fi、ADSB.lol、ADS-B One、airplanes.live、Planespotters.net、TheAirTraffic、AvDelphi、HP Radar、RadarPlane 和 Fly Italy ADSB。如果您想添加任何新服务，请创建一个 PR 添加新服务，或者如果您不知道如何添加，请针对您的请求提出问题。

对于这些服务，您目前不需要任何登录或 API 凭据，因此无需在它们上创建帐户（尽管其中一些确实提供此服务），也无需在 balenaCloud 中添加凭据。但是，您必须有选择地启用每项服务（或者您可以启用所有服务，或启用除 ADSB Exchange 之外的所有服务）。

要启用所有服务或除 ADSB Exchange 之外的所有服务，您可以使用以下设备变量之一：

• ADSB_EXCHANGE_ENABLE_ALL=true
• ADSB_EXCHANGE_ENABLE_ALL_BUT_ADSBX=true

请注意，您可以使用true 、 enable 、 enabled 、 1 、 y 、 yes或on作为值，并且大小写并不重要。如果您使用ADSB_EXCHANGE_ENABLE_ALL这将启用 ADSB Exchange，然后您需要添加ADSB_EXCHANGE_UUID和ADSB_EXCHANGE_SITENAME如上一节所述。

要启用单个服务，您需要添加具有以下值之一的设备变量（如果要启用多个服务，则需要添加多个值）：

• ADSB_EXCHANGE_ENABLE=true （您还需要添加ADSB_EXCHANGE_UUID和ADSB_EXCHANGE_SITENAME ，如上一节所述。
• ADSB_FI_ENABLE=true
• ADSB_LOL_ENABLE=true
• ADSB_ONE_ENABLE=true
• AIRPLANES_LIVE_ENABLE=true
• PLANESPOTTERS_ENABLE=true
• THE_AIR_TRAFFIC_ENABLE=true
• AV_DELPHI_ENABLE=true
• HPRADAR_ENABLE=true
• RADARPLANE_ENABLE=true
• FLY_ITALY_ADSB_ENABLE=true

最后，这些服务都需要传递 UUID 来识别系统中的设备。如果您设置了ADSB_EXCHANGE_UUID则所有服务将使用相同的 UUID。如果您未启用 ADSB Exchange 且未设置ADSB_EXCHANGE_UUID变量，系统会自动为您生成一个。但是，如果您愿意，也可以使用名为UUID设备变量并将 UUID 作为值（例如 2ddf6698-ea34-4c39-bbce-a8c3ddaf9bbd）手动设置 UUID。如果您愿意，可以使用在线 UUID 生成器来生成一个。

第 9 部分 – 配置 Wingbits

替代方案 A：移植现有的 Wingbits 接收器

如果您之前已经设置了 Wingbits 接收器并希望将其移植到 Balena，则只需执行以下步骤：

1. 返回 Balena 仪表板和您设备的页面。单击“设备变量”按钮。添加名为WINGBITS_DEVICE_ID的变量并粘贴现有 Wingbits ID 的值，例如small-coral-spider 。要获取您的 ID，请访问 Wingbits 仪表板，确保您位于“天线”选项卡并查看 ID 列。
2. 单击服务名称旁边的“循环”图标，重新启动“服务”下的wingbits服务。

替代方案 B：设置新的 Wingbits 接收器

如果您之前尚未设置要重复使用的 Wingbits 接收器，请执行以下步骤：

1. 注册一个新的 Wingbits 帐户。请务必使用发送给您的电子邮件激活它。
2. 登录您的 Wingbits 帐户，导航至“天线”选项卡，然后单击“注册天线” 。
3. 在框中输入您的纬度和经度（或在地图上选择您的位置）。然后向下滚动并单击注册。然后，您将返回到天线页面，列表中会出现一个新条目。请务必记下 ID 列中的名称，例如small-coral-spider 。
4. 返回 balena 仪表板上的设备页面。
5. 单击左侧菜单中的“设备变量”按钮。添加名为WINGBITS_DEVICE_ID的变量并粘贴步骤 4 中的值，例如small-coral-spider 。
6. 单击服务名称旁边的“循环”图标，重新启动“服务”下的wingbits服务。
7. 等待几分钟，然后返回 Wingbits Antenna 选项卡，刷新页面，在表格的Status列中，您应该会看到带有绿色背景的文本Online 。如果您将鼠标悬停在此处，您应该会看到一个工具提示文本弹出窗口，其中显示上次接收数据的时间，例如Last message: 22/11/2023, 03:17:40 。

第 10 部分 – 配置 UAT（可选，仅限美国）

请注意：以下说明涉及对 RTL-SDR USB 记忆棒进行低级更改，例如更改序列号。仅当您对所涉及的步骤感到满意时，才能谨慎操作。所做的所有更改均由您自行承担风险。

在美国，飞机可以使用 ADS-B 标准（以 1090 MHz 的频率传输）或 UAT 协议（以 978 MHz 的频率传输）。如果您居住在美国并拥有额外的 RTL-SDR 加密狗，则可以跟踪 UAT 和 ADS-B 流量。请注意，蓝色 FlightAware USB 设备只能用于 ADS-B 流量，因为它们具有专门针对 1090 MHz 频率优化的集成滤波器。橙色的 FlightAware USB 设备非常适合跟踪 UAT 流量。

1. 在执行以下步骤之前，请确保您只有一根 RTL-SDR 棒连接到您的设备。连接的棒应用于常规 ADS-B 1090 MHz 馈电。
2. 前往设备的摘要页面。单击左侧菜单中的“设备变量”按钮。添加名为DISABLED_SERVICES的变量并使用值dump1090-fa,dump978-fa填充它。
3. 在“摘要”页面的“终端”部分中，单击“选择目标” ，然后单击“转储1090-fa” ，最后单击“启动终端会话” 。这将打开一个终端，让您直接与 PiAware 容器交互。
4. 出现终端提示后，输入/add-serial-1090.sh ，然后按回车键。
5. 输入YES ，然后按回车键，以更改加密狗的序列号。验证该过程是否成功完成。
6. 单击左侧菜单中的“设备变量”按钮。添加一个名为DUMP1090_DEVICE的新变量并将其值设置为00001090 。
7. 关闭您的设备。关闭电源后，从 Pi 上拔下第一根 RTL-SDR 棒。
8. 插入第二根 RTL-SDR 棒（用于 UAT 的棒），使第一根棒保持断开状态。打开您的设备。
9. 前往设备的摘要页面。等待所有容器都显示“正在运行”状态。在“终端”部分中，单击“选择目标” ，然后单击“转储978-fa” ，最后单击“启动终端会话” 。
10. 出现终端提示后，输入/add-serial-978.sh ，然后按回车键。
11. 输入YES ，然后按回车键，以更改加密狗的序列号。验证该过程是否成功完成。
12. 单击左侧菜单中的“设备变量”按钮。添加一个名为DUMP978_DEVICE的新变量并将其值设置为00000978 。
13. 关闭您的设备。关闭电源后，连接两个 RTL-SDR 棒。
14. 单击左侧菜单中的“设备变量”按钮。删除DISABLED_SERVICES变量。
15. 添加一个名为UAT_ENABLED的新变量并将其分配true 。
16. 打开设备电源。现在，您应该同时将ADS-B和UAT数据馈送到支持它的服务（Flightaware，Radarbox和ADSB-Exchange）。

第11部分 - 添加数字显示（可选）

Balena还生产一个项目，可以轻松地配置为在名为Balenadash的数字显示器上以信息亭模式显示网页。通过将该项目放入该项目，我们可以直接从PI显示馈线页面。然后，我们可以设置一个配置为连接到http://{{YOURIP or YOURSERVICENAME}}:YOURSERVICEPORT LAUNCH_URL设备变量：您的服务/端口是上面的前端之一，例如http://planefinder:30053 ）自动显示在附件显示屏上。可以通过访问端口8081上的Web服务器来在本地配置Balenadash服务。

第12部分 - 在您的设备上本地探索航班流量

如果设置顺利进行，则应将飞行流量数据馈送到几个在线服务。您将收到访问提供商的保费服务，以换取您的努力。但是，除此之外，您还可以直接从设备上探索数据，即原始和未经编辑。那是魔术的一部分，对吗？

当您将本地网络访问接收器时，您可以直接从源头探索数据。首先在Balena控制台打开您的设备页面，然后找到IP ADDRESS字段，例如10.0.0.10 。然后，在下面进一步添加所需的端口号。

远离您当地的网络，但仍然渴望知道哪些飞机在您的房屋上巡游？在这里，Balena的内置公共设备URL派上用场。在Balena控制台中打开您的设备页面，找到PUBLIC DEVICE URL标头，然后翻转下面的开关以启用它。最后，单击按钮旁边的箭头图标，添加下面指定的所需的URL后缀和瞧 - 您应该查看您所在地区的情况。

Dump1090的雷达视图此视图可视化接收器所看到的所有内容，包括多屈服的平面位置。当您进入本地网络时，请前往YOURIP:8080进行检查。远程打开Balena的公共设备URL并添加/skyaware/在URL的尾端，例如https://6g31f15653bwt4y251b18c1daf4qw164.balena-devices.com/skyaware/

平面查找器的雷达视图与Dump1090相似，但是平面查找器添加了3D可视化和其他出色的观看选项。前往YOURIP:30053进行检查。远程打开Balena的公共设备URL并将/planefinder/添加到URL尾端，例如https://6g31f15653bwt4y251b18c1daf4qw164.balena-devices.com/planefinder/

Flightradar24状态页面的视觉效果少于其他两个选项，FlighTradar24的状态页面可为您提供有关馈线性能的高级统计和指标。前往YOURIP:8754进行检查。遥控时，打开Balena的公共设备URL ，然后将/fr24feed/添加到URL的尾端，例如https://6g31f15653bwt4y251b18c1daf4qw164.balena-devices.com/fr24feed/

Dump978的雷达视图（仅可选和美国），如果您居住在美国并已配置了UAT喂食，则可以使用此视图探索数据。当您进入本地网络时，请前往YOURIP:8978进行检查。远程打开Balena的公共设备URL ，并在URL的尾端添加/skyaware978/ ，例如https://6g31f15653bwt4y251b18c1daf4qw164.balena-devices.com/skyaware978/ 。但是，请记住，UAT流量很少。您可能需要几天的时间才能看到任何流量，具体取决于您所在的位置。

第13部分 - 高级配置

禁用特定服务

您可以通过创建一个名为DISABLED_SERVICES的设备变量，使用您要将其作为逗号分隔值禁用的服务来禁用任何Balena-ADS-B服务。例如，如果要禁用dump1090fa服务，则将DISABLED_SERVICES变量设置为dump1090fa 。如果要禁用DUMP1090FA和PIAWARE服务，则将DISABLED_SERVICES变量设置为dump1090fa, piaware 。

使用不同的无线电设备类型

使用Balena-ADS-B，您可以使用各种SDR（软件定义的无线电）和其他设备，例如基于FPGA的Mode-S Beast。默认操作模式是在USB上使用RTL-SDR，并且此设置不需要其他配置。

如果您使用Mode-S Beast，Bladerf，HackRF，Limesdr或Soapysdr，则需要配置此设备以根据您的预期工作。

为了配置您使用的特定设备类型，您需要创建一个名为RADIO_DEVICE_TYPE的设备变量。可能的值如下：

• rtlsdr（这是默认值，如果使用RTL-SDR，则不需要配置此变量）
• 模态
• 布拉德夫
• hackrf
• Limesdr
• Soapysdr

例如，如果您拥有模式 - S BEAST，则将RADIO_DEVICE_TYPE变量设置为modesbeast 。请记住，在更新设备后，要保存设备变量设置。配置此设备后，您的设备应自动重新启动，并且收音机现在应起作用。

自适应增益配置

可以配置Dump1090-FA服务以使调谐器增益自动适应变化条件。您可以在Flightaware的网站上阅读有关此操作方式的更多信息。

动态范围模式下的自适应增益

从Flightaware的文档中：动态范围自适应增益模式尝试设置接收器增益以保持给定的动态范围 - 也就是说，它试图设置增益，以使一般噪声处于或低于给定的水平。

默认情况下启用此模式。如果您手动指定天线增益（请参见下文），则将停用。您可以通过设置名为DUMP1090_ADAPTIVE_DYNAMIC_RANGE的设备变量来手动禁用此模式，并使用值false 。

“爆发”信号模式的自适应增益

从Flightaware的文档中： “爆发”自适应增益模式聆听并未成功解码为ADS-B消息的信号爆发，但大约有正确的时机是由于接收器超载而导致的可能丢失的消息。当在短时间内听到足够大的信号时，Dump1090将减少接收器的增益以尝试接收。

默认情况下禁用此模式。您可以通过设置具有true设备变量，名为DUMP1090_ADAPTIVE_BURST来启用它。

为了使此模式最佳地工作，您应该调整大声且安静的范围。您可以通过创建两个名为DUMP1090_ADAPTIVE_BURST_LOUD_RATE和DUMP1090_ADAPTIVE_BURST_QUIET_RATE的设备变量来做到这一点，并以所需的响亮和安静的目标作为其值。

限制增益范围

从Flightaware的文档中：如果您提前知道增益设置的内容，因此您想允许自适应增益以仅在一定范围内更改增益，则可以在DB中设置最小和最大增益设置。自适应增益只会在此范围内调整增益。

您可以通过创建两个名为DUMP1090_ADAPTIVE_MIN_GAIN和DUMP1090_ADAPTIVE_MAX_GAIN的设备变量来指定目标最大值和最小增益，并具有所需的最大值和最小值作为其值。

降低自适应增益的CPU成本

从Flightaware的文档中：调整增益所需的测量结果具有CPU成本，在较慢的设备上，减少自适应增益的工作量可能很有用。这可以通过调整自适应增益周期来完​​成。这是一个控制传入数据自适应增益检查的百分比。 100％意味着检查每个样本。较低的值降低了CPU的使用，而自适应增益的权衡是RF环境的精确效果。 “快速” CPU的默认占空比为50％，“慢” CPU（当前“慢”表示“ ARMV6架构”，例如PI零或PI 1）。

您可以通过创建名为DUMP1090_SLOW_CPU设备变量来进一步降低占空比，并将所需的占空比百分比作为值（1-100）。

设置dump1090天线增益

默认情况下，Dump1090将在动态范围模式下以自适应增益运行。您可以通过设置名为DUMP1090_GAIN的设备变量，并具有您喜欢的值来覆盖此问题。您可以在ADSB-Wiki上阅读有关手动增益优化的更多信息。

设备在服务出口上重新启动

Dump978和Dump1090如果遇到错误，则可以重新启动该设备。您可以通过设置名为REBOOT_DEVICE_ON_SERVICE_EXIT的设备变量true启用此功能。

自动Balenaos主机更新

自动使您的Balenaos主机发布最新。要启用此服务，请创建一个具有autohupr值的名为ENABLED_SERVICES的设备变量。

• HUP_CHECK_INTERVAL ：检查可用更新之间的间隔。默认值为1D。
• HUP_TARGET_VERSION ：您希望Balenahup自动更新设备的OS版本。这是要指定所需的变量，否则，默认情况下不会执行更新。将变量设置为“最新”/“推荐”，以始终更新到最新的OS版本或将其设置为特定版本（例如'2.107.10'）。

第14部分 - 更新最新版本

更新到最新版本是微不足道的。如果使用Balena-button使用蓝色部署安装了Balena-Ads-B，则可以再次单击它并覆盖当前的应用程序。选择“部署到现有车队”选项，然后选择要更新的车队。所有设置将被保留。为方便起见，按钮就在这里：

如果您使用了手动balena push方法，请从主分支中提取更改，然后使用Balena CLI将更新推到您的应用程序中。有关完整的说明，请查看第2部分 - 设置Balena并配置设备。

享受！