Retro-Lite-CM4 项目安装与使用教程

Retro-Lite-CM4 项目安装与使用教程

Retro-Lite-CM4 A CM4 gaming handheld, designed with the Switch Lite aesthetics in mind. Contains all STL files and code to build your own landscape retro handheld system. Co-project with Dmcke5. 项目地址: https://gitcode.com/gh_mirrors/re/Retro-Lite-CM4

1. 项目目录结构及介绍

Retro-Lite-CM4 项目的目录结构如下：

Retro-Lite-CM4/
├── ATtiny84/
├── BOM/
├── CAD Files/
├── HID-Controller/
├── battery/
├── boot/
├── brightnessIcons/
├── keyboard/
├── lib/
├── overlays/
├── src/
├── volumeIcons/
├── LICENSE
└── README.md

目录介绍

• ATtiny84/: 包含与 ATtiny84 微控制器相关的代码和配置文件。
• BOM/: 包含项目的物料清单（Bill of Materials），列出了构建项目所需的所有硬件组件。
• CAD Files/: 包含项目的 CAD 文件，用于设计和制造项目的机械结构。
• HID-Controller/: 包含与 HID 控制器相关的代码和配置文件。
• battery/: 包含与电池管理相关的代码和配置文件。
• boot/: 包含启动相关的配置文件和脚本。
• brightnessIcons/: 包含亮度调节图标。
• keyboard/: 包含与键盘输入相关的代码和配置文件。
• lib/: 包含项目所需的各种库文件。
• overlays/: 包含设备树叠加层（Device Tree Overlays）文件。
• src/: 包含项目的主要源代码。
• volumeIcons/: 包含音量调节图标。
• LICENSE: 项目的开源许可证文件。
• README.md: 项目的介绍和使用说明。

2. 项目启动文件介绍

项目的启动文件主要位于 boot/ 目录下，包含以下文件：

• config.txt: 这是 Raspberry Pi 的配置文件，用于配置启动参数和硬件设置。
• cmdline.txt: 这是 Raspberry Pi 的命令行参数文件，用于指定启动时的命令行参数。

启动流程

1. 加载内核: Raspberry Pi 从 SD 卡或 eMMC 存储中加载内核。
2. 读取 config.txt: 系统读取 config.txt 文件中的配置参数，进行硬件初始化。
3. 执行 cmdline.txt: 系统根据 cmdline.txt 中的参数启动操作系统。

3. 项目的配置文件介绍

项目的配置文件主要位于 boot/ 和 src/ 目录下，包含以下文件：

• config.txt: 用于配置 Raspberry Pi 的启动参数和硬件设置。
• src/retrolite.c: 这是项目的主要源代码文件，包含系统的核心逻辑和功能实现。
• src/hdmi_script.sh: 这是一个脚本文件，用于切换 HDMI 输出和处理系统重启。

配置文件详解

config.txt

# 配置文件示例
[all]
# 启用 HDMI 输出
hdmi_force_hotplug=1
# 设置 GPU 内存
gpu_mem=256
# 启用 I2C 接口
dtparam=i2c_arm=on

src/retrolite.c

// 代码片段示例
#include <stdio.h>
#include <wiringPi.h>

int main() {
    // 初始化 WiringPi
    wiringPiSetup();
    // 配置 GPIO 引脚
    pinMode(0, OUTPUT);
    // 主循环
    while (1) {
        digitalWrite(0, HIGH);
        delay(500);
        digitalWrite(0, LOW);
        delay(500);
    }
    return 0;
}

src/hdmi_script.sh

#!/bin/bash
# 切换 HDMI 输出
hdmi_switch() {
    # 切换到外部 HDMI 输出
    vcgencmd display_power 1
    # 应用超频设置
    vcgencmd overclock 2.1GHz
}

# 主逻辑
hdmi_switch

通过以上配置文件和启动文件，可以实现 Retro-Lite-CM4 项目的启动和配置。

Retro-Lite-CM4 A CM4 gaming handheld, designed with the Switch Lite aesthetics in mind. Contains all STL files and code to build your own landscape retro handheld system. Co-project with Dmcke5. 项目地址: https://gitcode.com/gh_mirrors/re/Retro-Lite-CM4