ATTinyCore 开源项目手册

---

一、项目目录结构及介绍

ATTinyCore 是一个针对 ATtiny 系列微控制器的 Arduino 核心库，极大地扩展了 Arduino 平台对经典 AVRs 的支持。下面是该仓库的主要目录结构及其简要介绍：

- .gitignore          # 忽略版本控制的文件列表
- CODE_OF_CONDUCT.md  # 项目的行为准则文档
- CONTRIBUTING.md     # 对贡献者指南的引用（未直接提供，但通常应在此位置）
- CHANGELOG.md       # 版本更新日志
- HowToHelp.md        # 如何参与帮助和贡献的指导
- Installation.md     # 安装和设置指南
- LICENSE.md          # 许可证信息，指示软件使用的权限范围
- README.md           # 主要的项目介绍文档
- Readme additions.txt # 补充的阅读材料或说明
- V2.0.0PinoutChanges.txt # 从某个特定版本开始的引脚变化说明
- avrdude.conf       # 针对 avrdude 工具的配置文件
- bounties.md        # 关于赏金或激励计划的信息
- mdBounties.md      # 可能是赏金详情的 Markdown 版本

项目中还可能包括多个与具体微控制器型号相关的子目录，这些子目录包含了针对不同ATtiny型号的配置和代码实现。

二、项目的启动文件介绍

在 Arduino 开发环境中，启动文件通常指的是每个项目中的 setup() 和 loop() 函数所在的 .ino 文件。然而，在 ATTinyCore 这样的核心库中，启动过程的细节由库内部处理，它确保了正确的初始化序列，如时钟设置、中断向量表等。对于开发者来说，重点在于创建自己的 .ino 或 .cpp 文件，并定义这两个关键函数来定义项目的行为逻辑。

实际上，用户不需要直接操作 ATTinyCore 中的启动代码，除非进行非常底层的定制化工作。对于大多数应用而言，只需在新Arduino项目中正确选择对应的ATTiny型号作为目标板即可。

三、项目的配置文件介绍

ATTinyCore 的配置不直接体现在单个“配置文件”上，而是通过一系列的头文件和Makefile（或者在Arduino IDE中是通过选择正确的选项和库）来实现。配置体验更多是在编译层面进行调整，比如通过定义预处理器宏（例如在 Arduino 的 boards.txt 文件中定义），以及利用库提供的特定功能宏定义。

• ** boards.txt / platform.txt **: 在 Arduino IDE 环境下，这些文件定义了各个微控制器的具体配置，如晶振频率、上传速率等。
• ** 预处理器宏 **: 用户可以通过在源码或项目级定义预处理器指令来影响编译行为，例如改变模拟读取参考电压等。
• ** 特定头文件 **: 库内会有若干头文件（如 Arduino.h, pins_arduino.h 的变体），它们包含了一系列宏定义和类型定义，用于配置和访问硬件资源。

对于更深层次的定制，开发者可能需要深入到源码中，理解并修改相应的定义，但这超出了普通用户日常工作的范畴，且通常不推荐这样做，除非有特殊需求或贡献补丁给项目本身。

---

此文档仅提供了一个大致的框架，实际的详细配置和操作步骤需参照项目最新文档和官方指南。保持关注仓库的更新，以获取最准确的使用说明。