百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
F

flightportal

> 编程语言
开源

一个项目,用于在 Adafruit MatrixPortal 和 LED 矩阵上显示飞机的详细信息

390 stars0 点赞0 次浏览
访问官网GitHub

工具介绍

一个项目,用于在 Adafruit MatrixPortal 和 LED 矩阵上显示飞机的详细信息

flightportal

Project for displaying the details of planes overhead on an Adafruit MatrixPortal and LED matrix

(video sped up to make the file fit, the speeds and delays are configurable anyway)

https://user-images.githubusercontent.com/103124527/206902629-1f31bd41-d8a8-415e-a35a-625efb20b3d6.MOV

Uses an Adafruit MatrixPortal and a 64x32 LED/RGB Matrix (P4), and some fairly hacked-together FlightRadar24 API-style scraping to display the details of flights passing overhead. That code being unofficial, it may break at any time!

To make one you will need:

  1. A MatrixPortal M4
  2. A P4, 64x32 RGB matrix panel (I get mine from Aliexpress, also available from Adafruit)
  3. The 3D printed case I designed
  4. Adafruit acrylic diffuser - available various places
  5. 6 M3 screws (sorry, said M5 before but was looking at the wrong ones, my bad. Think mine are 8mm long, little bit more would be OK, shorter probably a problem)
  6. Optional: Uglu dashes to stick the diffuser on, the case holds mine on pretty well though

Software setup

You can automate the library installation via CircUp, easily installed via uv.

[!CAUTION] If you do not use CircUp, you will need to manually copy the libraries and their dependencies listed in step 3 below to the CIRCUITPY drive.

  1. Prep the portal as detailed in the Adafruit MatrixPortal guide.

  2. Install CircUp, the CircuitPython library manager:

    bash
    uv tool install circup
  3. Connect the MatrixPortal to your computer and install the required libraries:

    bash
    circup install adafruit_fakerequests adafruit_requests adafruit_bitmap_font adafruit_io adafruit_matrixportal adafruit_minimqtt adafruit_display_text adafruit_portalbase
  4. Copy code.py and settings.toml to the root of the CIRCUITPY drive.

  5. Edit settings.toml with your Wi-Fi details and the geographic bounding box you want to search.

The portal should now be ready to run. If you'd like to change the layout, colours or the flight info displayed, have a look at code.py; these are configurable near the top of the file.

For power, the easiest thing is to use the cable that came with your matrix panel, as long as it has two prongs that go to the screws on the matrixportal. All that's needed is for the portal to connect to the power port on the panel - we're not using much power here (I clock it at about 2w). Any decent usb power supply connected to the portal should do it.

I soldered a connection straight onto the panel's power port as below, for neatness, but that's completely optional.

Debugging over serial

If the MatrixPortal is in a reboot loop or does not display output, connect to its serial device at rate 115200 to observe the script's output.

Using discotool (recommended)

discotool can assist with identifying the correct serial port and connecting to it automatically.

bash
uv tool install discotool

[!NOTE] As of writing, the latest discotool v0.5.8 has a packaging issue that can cause ModuleNotFoundError: No module named 'appdirs' after installation with uv tool. If you encounter it, reinstall Discotool with the missing dependency:

bash
uv tool install --reinstall --with 'appdirs>=1.4.4' 'discotool==0.5.8'

Then connect your MatrixPortal over USB and monitor the serial output:

bash
discotool repl

The output includes helpful messages about errors and the flights the portal sees. You can also paste the URLs shown in the output into a browser to check that they return flights.

Ctrl+C will interrupt the running script and allow you to enter Python REPL, Ctrl+D soft-reboots.

Connecting manually

Without discotool to discover your MatrixPortal, tools like putty or screen can connect to the serial device the MatrixPortal exposes using baud rate 115200. Check Device Manager for COM ports on Windows or look at /dev/tty.usbmodem* devices on MacOS to identify the correct serial device to connect to.

See Adafruit's Connecting to the Serial Console documentation for details.

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Python

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言