fix(pi5): correct gpio_slowdown guidance — Pi 5 PIO default is 1, not 4-5

The upstream library defaults gpio_slowdown to 1 for Pi 5 (IsPi4() ? 2 : 1).
In PIO mode the value is a pixel-clock divisor, so 4-5 was unnecessarily
conservative advice. Updated help text and error log to reflect the actual
range (1-3 typical for Pi 5 PIO; inverted effect in RIO mode).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Chuck
2026-05-18 16:27:21 -04:00
parent c48c06ffa7
commit f6e9c7688d
2 changed files with 3 additions and 3 deletions

View File

@@ -170,7 +170,7 @@ class DisplayManager:
f"Matrix initialization failed — running in fallback/simulation mode " f"Matrix initialization failed — running in fallback/simulation mode "
f"(size {fallback_width}x{fallback_height}). Error: {e}. " f"(size {fallback_width}x{fallback_height}). Error: {e}. "
"On Raspberry Pi 5: ensure rpi-rgb-led-matrix was built from the latest " "On Raspberry Pi 5: ensure rpi-rgb-led-matrix was built from the latest "
"submodule (re-run first_time_install.sh) and that gpio_slowdown is 4 or higher." "submodule (re-run first_time_install.sh). gpio_slowdown of 23 is typical for Pi 5 PIO mode."
) )
# Do not raise here; allow fallback mode so web preview and non-hardware environments work # Do not raise here; allow fallback mode so web preview and non-hardware environments work

View File

@@ -18,7 +18,7 @@
<p class="text-sm text-yellow-700 mt-2"> <p class="text-sm text-yellow-700 mt-2">
On Raspberry Pi 5: ensure the library was rebuilt from the latest submodule On Raspberry Pi 5: ensure the library was rebuilt from the latest submodule
(<code class="bg-yellow-100 px-1 rounded">first_time_install.sh</code>) (<code class="bg-yellow-100 px-1 rounded">first_time_install.sh</code>)
and set <strong>GPIO Slowdown to 4 or higher</strong> below. and try adjusting <strong>GPIO Slowdown</strong> (start at 3, reduce if the display looks dim or choppy).
Check the <a href="/v3/logs" class="underline font-medium">Logs tab</a> for the full error. Check the <a href="/v3/logs" class="underline font-medium">Logs tab</a> for the full error.
</p> </p>
</div> </div>
@@ -178,7 +178,7 @@
min="0" min="0"
max="10" max="10"
class="form-control"> class="form-control">
<p class="mt-1 text-sm text-gray-600">Pi 3: 3 &middot; Pi 4: 4 &middot; Pi 5: 4&ndash;5 (in RIO mode, lower values may work better)</p> <p class="mt-1 text-sm text-gray-600">Pi 3: 1&ndash;2 &middot; Pi 4: 2&ndash;4 &middot; Pi 5 PIO: 1&ndash;3. Increase if display shows garbage; in RIO mode higher values may improve performance.</p>
</div> </div>
<div class="form-group"> <div class="form-group">