The Open Book 项目教程

1. 项目的目录结构及介绍

The Open Book 项目的目录结构如下：

The-Open-Book/
├── 3D Printed Case/
│   └── ...
├── Fabrication Files/
│   ├── OSO-BOOK-B1/
│   ├── OSO-BOOK-C1/
│   └── OSO-BOOK-C2/
├── .gitignore
├── LICENSE.md
├── README.md
└── kitspace.yaml

目录结构介绍

• 3D Printed Case/: 包含3D打印外壳的文件。
• Fabrication Files/: 包含用于制造Open Book主板的文件，包括PCB设计和元件布局。
  • OSO-BOOK-B1/: 包含OSO-BOOK-B1版本的相关文件。
  • OSO-BOOK-C1/: 包含OSO-BOOK-C1版本的相关文件。
  • OSO-BOOK-C2/: 包含OSO-BOOK-C2版本的相关文件。
• .gitignore: Git忽略文件，指定哪些文件和目录不应被版本控制。
• LICENSE.md: 项目的开源许可证文件，采用CC-BY-SA-4.0许可证。
• README.md: 项目的介绍文件，包含项目的基本信息和使用说明。
• kitspace.yaml: 用于Kitspace平台的配置文件，帮助用户快速订购所需的电子元件。

2. 项目的启动文件介绍

The Open Book 项目没有明确的“启动文件”，因为它是一个硬件项目，主要依赖于硬件组件和固件。项目的启动过程涉及以下几个步骤：

1. 硬件组装: 根据Fabrication Files目录中的文件，组装Open Book主板和相关组件。
2. 固件烧录: 使用Raspberry Pi Pico的固件烧录工具，将固件（libros）烧录到Pico上。
3. 电源启动: 将AAA电池插入电池槽，启动设备。

3. 项目的配置文件介绍

The Open Book 项目的主要配置文件是 kitspace.yaml，它用于Kitspace平台，帮助用户快速订购所需的电子元件。该文件包含以下内容：

# kitspace.yaml 文件内容示例
- name: Open Book Main Board
  description: PCB for the Open Book device
  gerbers: OSO-BOOK-C1/OSO-BOOK-C1-04-rounded.zip
  bom: OSO-BOOK-C1/OSO-BOOK-C1-04-rounded.csv
  cpl: OSO-BOOK-C1/OSO-BOOK-C1-04-rounded-top-pos.csv

配置文件介绍

• name: 组件的名称。
• description: 组件的描述。
• gerbers: 包含PCB制造所需的Gerber文件。
• bom: 包含元件清单（Bill of Materials）文件。
• cpl: 包含元件位置列表（Component Placement List）文件。

通过这些配置文件，用户可以方便地在Kitspace平台上订购所需的PCB和元件，简化硬件制造过程。