Raspberry Piで電光掲示板（RGB LEDマトリックス）を制御できる、rpi-rgb-led-matrixで、上手くデモの四角を表示できなかったときのトラブルシュートメモです。

（環境：Raspberry Pi 4 + Raspberry Pi OS）

想定される問題

想定される問題は、大きく分けて以下の2つかなと思います。
（ジャンパワイヤなどの配線自体の不良も考えられますが、、基本的にはそこまで発生しやすいものではないかなと思います。）

HW: 配線ミス

人間が配線を繋いでいるので、もっともありうるのはこちらでしょう。
ひたすらニラメッコするしかないです。左右反転して勘違いしていたりすることも稀にあります。。

指定する必要があるオプションが漏れているか、指定しなくて良いオプションをしているケースなどがあります。
変なLEDを買わなければ、基本的にネットで落ちているコマンドで動くかなと思います。

私はこれでした。1日くらい悩みましたが、--led-colsの指定ミスでした。
16x32のLEDマトリックスを使っていると勘違いしていましたが、よくよくドット数を数えると32x64でした・・・

ネットではこうなっている方も見つけました。
考えられる原因としては以下がありそうです。

これは中々無いと思いますが、RGBの3原色でカラフルにしているため、特定の色の接続を切るとその色が出なくなります。

上手く行った例