用于 Raspberry Pi Sense Hat 的 Swift 软件包 `SenseHat`

功能

✅ LED 闪烁 - 这是每个人开始玩 Raspberry Pi 的起点；
✅ 获取/设置单个像素的颜色；
✅ 一次性设置所有像素的颜色；
✅ 一次性获取/设置所有像素（到/从 Data）；
✅ 在 LCD 矩阵上显示 8x8 字符（支持 ascii、扩展拉丁文、方框绘图元素、块元素、平假名、希腊文、sga）；
✅ 显示任意文本（8x8 字体，水平滚动）；
✅ LED 矩阵旋转 0º/90º/180º/270º；
✅ 设置 LED 矩阵方向 0º/90º/180º/270º，并使所有获取/设置基本操作都遵循它；
✅ 读取摇杆；
✅ 读取湿度和压力传感器；
✅ 读取陀螺仪/加速度计/磁力计传感器；
✅ 贪吃蛇游戏；
✅ 生命游戏；

待办

改进陀螺仪/加速度计/磁力计传感器读取；
添加 RGB 颜色到 Rgb565 的转换；
添加西里尔字体 8x8；
添加 3x5 字体；
用 Swift 字体替换 C 字体；
在 LED 矩阵上显示任意图像；
显示预处理视频；
菜单以显示来自任何可用传感器的读数；
根据陀螺仪读数旋转屏幕的模式；
用于 Web 的 SenseHat LED 矩阵模拟器；
用于加速度计/陀螺仪/磁力计的卡尔曼滤波；
添加模拟时钟演示应用。

用法

实例化

// Look over all frame buffer devices in `/dev/` for one of Sense Hat. 
// Use default orientation `.up`
guard let senseHat = SenseHat() else {
    fatalError("Can't initialise Raspberry Pi Sense Hat")
}

参数 orientation 可用于其他方向，例如 SenseHat(orientation: .left)。参数 frameBufferDevice 可用于指定帧缓冲区设备，例如 SenseHat(frameBufferDevice: "/dev/fb0")。两个参数可以同时使用：SenseHat(frameBufferDevice: "/dev/fb0", orientation: .down)。

参数 orientation 定义 LED 矩阵的顶部在哪里。以下是用不同方向显示相同字符 "1" 的示例

`.up`	`.left`	`.right`	`.down`

将矩阵的所有 LED 设置为特定颜色

senseHat.set(color: .red) // sets all LEDs of matrix to red

senseHat.set(color: .black) // sets all LEDs of matrix to black, literally turns them off

将矩阵的特定 LED 设置为特定颜色

senseHat.set(color: .black) // clear
senseHat.set(x: 0, y: 0, color: .white) // set most top left LED to white using function syntax
senseHat[7, 7] = .green // set most bottom right LED to green using subscript syntax

坐标 x 和 y 应属于 0..<7 范围。

在 LED 矩阵上显示字符

senseHat.show(character: Character("A"), color: .blue)

senseHat.show(character: Character("π"), color: .yellow, background: .blue)

在 LED 矩阵上显示字符串

senseHat.show(string: "Hello! ", secPerChar: 0.5, color: .yellow, background: .blue)

senseHat.orientation = .left
senseHat.show(string: "Απόλλων ", secPerChar: 0.5, color: .red, background: .darkGray)

senseHat.orientation = .right
senseHat.show(string: "ここからそこまで ", secPerChar: 0.5, color: .white, background: .brown)

senseHat.orientation = .down
senseHat.show(string: "Fußgängerübergänge ", secPerChar: 0.5, color: .white, background: .purple)

读取湿度传感器

if let h = senseHat.humidity() {
    let strH = String(format: "%.1lf", h.H_rH)
    senseHat.show(string: "Humidity \(strH)% rH ", secPerChar: 0.5, color: .yellow, background: .black)
    let strT = String(format: "%.1lf", h.T_DegC)
    senseHat.show(string: "Temperature \(strT)ºC", secPerChar: 0.5, color: .yellow, background: .black)
} else {
    print("Cannot read humidity sensor")
}

读取压力传感器

if let p = senseHat.pressure() {
    let strP = String(format: "%.1lf", p.P_hPa)
    let strT = String(format: "%.1lf", p.T_DegC)
    senseHat.show(string: "Pressure \(strP) hPa ", secPerChar: 0.5, color: .yellow, background: .black)
    senseHat.show(string: "Temperature \(strT)ºC", secPerChar: 0.5, color: .yellow, background: .black)
} else {
    print("Cannot read pressure sensor")
}

实用链接

遗憾的是，Raspberry Pi Sense Hat 的数据手册或程序员手册不存在，或者我未能找到。这里有一些实用链接

raspberrypi.org 上的官方页面 Sense HAT；
Astro Pi：飞行硬件技术规格列出了 SenseHat 的所有传感器，并附有数据手册链接；
官方文档 Sense HAT 文档；
官方 Python 模块 sense-hat；
Python 模块的源代码 sense-hat；
Sense HAT 入门指南;
Rust 库 sensehat-screen，其中解释了 RGB 如何在所谓的 Rgb565 中打包成两个字节；
Linux 帧缓冲区设备 API，用于访问像素缓冲区；
LSM9DS1 的数据手册，这个可能有用从 FIFO 读取；
在 Raspberry Pi 上安装 Swift 的指南 buildSwiftOnARM，用于安装预构建的 Swift 5.1.5。待办：描述我做了哪些不同的事情；
3D 打印 Astro Pi 外壳.

用于 Raspberry Pi Sense Hat 的 Swift 软件包 SenseHat

用法

实例化