Matricks

"教旧矩阵新技巧..."

Matricks 是一个基于 WASM 的可扩展 LED 矩阵控制工具，旨在用于 Raspberry Pi 设备。LED 矩阵功能由用户开发的插件（或“技巧”）定义，这些插件可以用支持 Extism PDK 的任何语言开发。在开发插件时，您可以查看 Simtricks 进行模拟！

运行 Matricks

Raspberry Pi 上的安装

• 在您的 Raspberry Pi 上安装 64 位 Raspbian[^1] [^2]
• 从 Rust 网站 安装 Rust 和 Cargo
• 运行 apt install libclang-dev libssl-dev
• 运行 cargo install matricks
• 配置您的 Raspberry Pi 并重启

使用预编译的二进制文件

为了方便，预编译的二进制文件在版本标签中可用。

• 配置您的 Raspberry Pi 并重启
• 运行以下命令下载和运行 Matricks

MATRICKS_VERSION=0.3.1 && \
wget https://github.com/wymcg/matricks/releases/download/v$MATRICKS_VERSION/matricks_$MATRICKS_VERSION && \ 
chmod +x matricks_$MATRICKS_VERSION && \
./matricks_$MATRICKS_VERSION 

交叉编译

• 在另一台设备上
  • 从 Rust 网站 安装 Rust 和 Cargo
  • 运行 rustup target add aarch64-unknown-linux-musl
  • 运行 cargo install cross
  • 克隆此仓库并使用 cross build --release --target aarch64-unknown-linux-musl 构建
  • 将生成的可执行文件传输到您的 Raspberry Pi
• 在您的 Raspberry Pi 上
  • 安装 64 位 Raspbian[^1]
  • 配置您的 Raspberry Pi 并重启
  • 运行可执行文件

用法

本节描述了 Matricks 的基本用法。有关一般用法信息，请运行 matricks help。有关要尝试的插件列表，请参阅 examples README 中的几个示例插件。

手动配置

您可以使用matricks manual手动为Matricks提供配置。要运行插件（或目录中的一组插件），可以按照以下方式调用Matricks：

matricks manual [OPTIONS] --path <PLUGIN_PATH> --width <WIDTH> --height <HEIGHT>

这将运行指定路径上的插件（或插件集）在连接的矩阵上。还有其他矩阵和插件配置选项；有关更多信息，请参阅matricks help manual。

保存配置

一旦您确认使用matricks manual一切正常，您可以使用matricks save命令将配置保存到文件。要保存配置，可以按照以下方式调用Matricks：

matricks save <NEW_CONFIG_PATH> [OPTIONS] --path <PLUGIN_PATH> --width <WIDTH> --height <HEIGHT>

这与matricks manual类似，但不是运行插件，Matricks将配置信息保存到给定路径的新TOML文件中。matricks save具有与matricks manual相同的矩阵和插件配置选项。有关更多信息，请参阅matricks help save。

自动配置

如果您有一个TOML配置文件（可以手动创建或通过运行matricks save创建），您可以使用matricks auto使用它。要使用配置文件运行Matricks，可以按照以下方式调用Matricks：

matricks auto <CONFIG_PATH>

此命令将使用给定文件中的配置信息来驱动矩阵。有关更多信息，请参阅matricks help auto。

清除矩阵

如果出于任何原因您需要清除矩阵上的所有LED，可以按照以下方式调用Matricks：

matricks clear --width <WIDTH> --height <HEIGHT>

有关更多信息，请参阅matricks help clear。

查看日志

要查看Matricks的日志，请在命令前加上RUST_LOG=matricks=info。例如

RUST_LOG=matricks=info matricks auto your_config.toml

[^1]: 目前，Matricks只能在64位操作系统上安装和运行。 [^2]: 如果您使用的是RAM少于1GB的Raspberry Pi，不推荐使用此方法安装。

Raspberry Pi配置

在可以使用Matricks驱动LED矩阵之前，需要对其进行一些配置。如果不遵循这些说明，Matricks可能无法按预期工作。本节概述了来自rpi_ws281x README的说明。

启用SPI

在Raspberry Pi上启用SPI最简单的方法是使用raspi-config命令行工具。运行sudo raspi-config，并通过选择Interface Options > SPI导航到SPI激活对话框。

更改GPU核心频率

将以下行添加到/boot/config.txt

更改SPI缓冲区大小（可选）

在某些发行版上，可能需要通过编辑/boot/cmdline.txt并添加以下行来增加最大SPI传输大小：

spidev.bufsize=32768