AgonLight 开源项目使用与配置指南

1. 项目目录结构及介绍

AgonLight 项目目录结构如下：

/3D Model
    - 包含 AgonLight 主板的 3D 模型和 PCB 关键尺寸的 2D 图片，用于设计自定义的 3D 打印机箱。

/Design
    - 包含所有设计文件，如原理图、EasyEDA 源文件和 PCB 布局。

/Manufacturing
    - 包含制造 AgonLight 主板所需的文件，如 Gerber 文件、物料清单和放置文件。

/Photos
    - 包含正确组装的 AgonLight 单元的照片，为自行组装提供详细参考。

/Third party documentation
    - 包含第三方文档，如部件和软件的数据手册、用户指南、指南和应用/技术说明。

/uSD card files
    - 包含应存在于 AgonLight 单元的 micro SD 卡上的文件和文件夹，但现在已过时，应遵循 Agon Wiki 中的说明。

/LICENSE
    - 包含项目许可信息。

/README.md
    - 包含项目的说明和重要公告。

2. 项目的启动文件介绍

AgonLight 项目的启动主要依赖于其官方固件 Quark™，该固件分为三个模块：Quark™ BBC BASIC、Quark™ MOS 和 Quark™ VDP。启动文件位于 /uSD card files 目录中，但在最新版本中已标记为过时。正确的方法是遵循 Agon Wiki 中的说明来准备 micro SD 卡。

启动步骤大致如下：

• 将 micro SD 卡格式化为 Fat32 文件系统，并确保分区大小不超过 32GB。
• 将 Quark™ 固件和相关文件复制到 micro SD 卡中。
• 将 micro SD 卡插入 AgonLight 单元，并接通电源。

3. 项目的配置文件介绍

AgonLight 项目的配置主要通过修改 micro SD 卡上的文件来进行。具体的配置文件取决于所使用的固件版本和所需的设置。以下是一些基本的配置步骤：

• 固件更新：如需更新固件，应遵循官方 Wiki 中的指南。对于 Quark™ MOS 的更新，可以使用 Jeroen Venema 开发的软件工具，无需专用电缆。
• 硬件手册：硬件配置应参考 Hardware Manual，其中包含了详细的硬件规格和设置信息。
• 物料清单：在 /Manufacturing 目录下的物料清单文件中，可以找到所需组件的详细信息，便于采购和组装。

在进行任何配置更改之前，请确保备份原始配置文件，以便在遇到问题时可以恢复。遵循官方文档的指导是确保项目稳定运行的关键。