TTGO TWatch Library 使用教程

1. 项目目录结构及介绍

TTGO TWatch Library 项目的目录结构如下：

TTGO_TWatch_Library/
├── CHANGELOG.md
├── LICENSE
├── README.md
├── library.json
├── library.properties
├── src/
│   ├── AXP202X.cpp
│   ├── AXP202X.h
│   ├── BMA.cpp
│   ├── BMA.h
│   ├── FT6236.cpp
│   ├── FT6236.h
│   ├── PCF8563.cpp
│   ├── PCF8563.h
│   ├── TTGO_TWatch.cpp
│   ├── TTGO_TWatch.h
│   ├── TWatch_hal.cpp
│   ├── TWatch_hal.h
│   ├── TWatch_lvgl.cpp
│   ├── TWatch_lvgl.h
│   ├── TWatch_lvgl_hal.cpp
│   ├── TWatch_lvgl_hal.h
│   ├── TWatch_lvgl_theme.cpp
│   ├── TWatch_lvgl_theme.h
│   ├── TWatch_lvgl_widgets.cpp
│   ├── TWatch_lvgl_widgets.h
│   ├── TWatch_utils.cpp
│   └── TWatch_utils.h
├── examples/
│   ├── Basic/
│   ├── LVGL/
│   ├── Sensor/
│   └── ...
├── images/
│   └── ...
└── ...

目录结构介绍

• CHANGELOG.md: 记录项目的更新日志。
• LICENSE: 项目的开源许可证文件。
• README.md: 项目的介绍和使用说明。
• library.json 和 library.properties: 用于 Arduino IDE 的库管理文件。
• src/: 包含项目的核心源代码文件，包括硬件驱动和库的核心功能实现。
• examples/: 包含多个示例程序，展示了如何使用 TTGO TWatch Library 进行开发。
• images/: 包含项目相关的图片资源。

2. 项目启动文件介绍

项目的启动文件主要位于 src/ 目录下，其中最重要的文件是 TTGO_TWatch.cpp 和 TTGO_TWatch.h。

TTGO_TWatch.cpp

该文件包含了 TTGO TWatch 库的主要实现代码，负责初始化硬件设备、配置系统参数以及提供对外的 API 接口。

TTGO_TWatch.h

该头文件定义了库的主要类和函数接口，用户可以通过包含该头文件来使用 TTGO TWatch 库的功能。

3. 项目的配置文件介绍

项目的配置文件主要位于 examples/ 目录下的各个示例程序中，通常命名为 config.h。

config.h

config.h 文件用于配置项目的硬件参数和功能模块。用户可以根据自己的硬件版本和需求，在 config.h 中定义相应的宏来启用或禁用某些功能模块。

例如：

#define LILYGO_WATCH_2020_V1
#define LILYGO_WATCH_LVGL
#define LILYGO_WATCH_HAS_MOTOR

这些宏定义将决定哪些硬件模块会被初始化和使用。

配置文件示例

以下是一个典型的 config.h 文件示例：

#ifndef _CONFIG_H_
#define _CONFIG_H_

// 定义使用的 T-Watch 型号
#define LILYGO_WATCH_2020_V1

// 启用 LVGL 图形库
#define LILYGO_WATCH_LVGL

// 启用振动马达
#define LILYGO_WATCH_HAS_MOTOR

#endif

通过修改 config.h 文件中的宏定义，用户可以灵活地配置和定制自己的 T-Watch 应用程序。