AgonLight开源项目安装与配置指南

1. 项目基础介绍

AgonLight是一个结合了即时启动微电脑和独立微控制器的独特设备。它允许用户通过BASIC提示符即时控制项目，无需主机电脑或草图编译。AgonLight适合对8位计算机进行编程和开发，非常适合作为教育工具或DIY项目。

主要编程语言：BASIC（用于与设备交互），C（用于固件开发）。

2. 项目使用的关键技术和框架

• Zilog eZ80 CPU：AgonLight使用Zilog eZ80 CPU，这是一款高性能的8位微处理器。
• Quark固件：项目的官方固件，包含BBC BASIC、MOS和VDP三个模块。
• PS/2键盘接口：支持使用标准PS/2键盘进行输入。
• SD卡存储：使用SD卡作为存储媒介，便于固件和数据的存储。

3. 安装和配置准备工作

在开始安装之前，请确保您已准备好以下工具和材料：

• 一台电脑，用于下载和传输文件到AgonLight。
• 一张Class-10，Fat32格式化的SD卡，容量不超过32GB。
• 一个适用于AgonLight的PS/2键盘。
• 一个USB到串行适配器（如果需要通过串行接口进行调试）。

安装步骤

步骤 1：下载项目文件

首先，您需要从电脑上访问GitHub，并克隆或下载AgonLight项目文件。如果您不熟悉命令行，可以使用GitHub桌面客户端来简化这个过程。

git clone https://github.com/TheByteAttic/AgonLight.git

或者，如果您使用的是GitHub桌面客户端，只需点击“克隆到”按钮，并选择您的电脑上的一个目录来保存项目文件。

步骤 2：准备SD卡

将SD卡插入电脑，并确保它已经被格式化为Fat32格式。您可以使用电脑上的磁盘管理工具来完成这一步。

步骤 3：传输文件到SD卡

将下载的AgonLight项目文件夹中的uSD card files目录下的所有文件复制到SD卡上。

步骤 4：安装固件

根据项目提供的固件安装指南（通常在项目文档中），使用合适的工具将固件安装到AgonLight的微控制器上。这可能需要使用特定的编程电缆，例如Zilog USB Smart Cable。

步骤 5：测试设备

完成固件安装后，将SD卡插入AgonLight，并连接PS/2键盘。打开AgonLight的电源，您应该能够看到启动信息，并通过键盘与设备交互。

步骤 6：开始编程

一旦设备启动并运行，您就可以开始使用BASIC语言编写程序，并通过键盘输入到AgonLight中进行执行。

请注意，以上步骤是一个简化的指南，实际的安装过程可能根据您的具体环境和设备有所不同。在安装过程中，请确保遵循项目文档中的详细指示。