ES108FC1 Connector

# 克隆项目
git clone <repository-url>
cd ink-paper

# 准备开发环境 (下载 micropython, esp-idf 等)
./scripts/prepare.sh

# 编译 MicroPython 固件
./scripts/build.sh

# 使用智能烧写脚本 (自动检测端口)
./scripts/flash.sh -e

# 运行硬件测试脚本
source esp-idf/export.sh
python scripts/test_hardware.py --all       # 测试所有硬件
python scripts/test_hardware.py --display   # 仅测试显示屏
python scripts/test_hardware.py --sensors   # 仅测试传感器

# 下载demo目录中的测试程序到ESP32
./scripts/download.sh

import papers3

# 查看系统信息
papers3.info()
papers3.flash_info()
papers3.ram_info()

# 使用硬件模块
buzzer = papers3.Buzzer()
buzzer.init()
buzzer.beep(1000, 200)
buzzer.deinit()

import papers3

# 初始化显示器
epdiy = papers3.EPDiy()
epdiy.init()

# 绘制中文文字
epdiy.draw_text("中文文本", 10, 50, 0)              # 中文字体(行高70px)
epdiy.draw_text("English Text", 10, 100, 0)        # 同样支持英文

# 更新显示
epdiy.update()

# 基础图形绘制
epdiy.clear()                                    # 清屏
epdiy.draw_rect(x, y, width, height, color)      # 绘制矩形
epdiy.fill_rect(x, y, width, height, color)      # 填充矩形
epdiy.draw_circle(x, y, radius, color)           # 绘制圆形
epdiy.fill_circle(x, y, radius, color)           # 填充圆形
epdiy.draw_line(x1, y1, x2, y2, color)           # 绘制直线
epdiy.draw_triangle(x1, y1, x2, y2, x3, y3, color)  # 绘制三角形
epdiy.fill_triangle(x1, y1, x2, y2, x3, y3, color)  # 填充三角形

# 文字绘制 (支持中文)
epdiy.draw_text(text, x, y, color)               # 中文字体 (实际高度70px，行间距70px)

# 显示更新
epdiy.update()                                   # 更新屏幕显示
epdiy.clear_screen()                             # 清除并更新

# 初始化蜂鸣器
buzzer = papers3.Buzzer()
buzzer.init()

# 播放声音
buzzer.beep(frequency, duration)  # 频率(Hz), 持续时间(ms)
buzzer.beep(1000, 500)           # 1kHz音调持续500ms

# 清理资源
buzzer.deinit()

# 初始化电池监控
battery = papers3.Battery()
battery.init()

# 读取电池信息
voltage = battery.voltage()      # 电压(mV)
percentage = battery.percentage() # 电量百分比

print(f"电池电压: {voltage} mV")
print(f"电池电量: {percentage}%")

# 清理资源
battery.deinit()

# 初始化陀螺仪
gyro = papers3.Gyro()
gyro.init()

# 读取传感器数据
accel = gyro.read_accel()  # 加速度计 [x, y, z]
gyro_data = gyro.read_gyro()  # 陀螺仪 [x, y, z]

print(f"加速度: {accel}")
print(f"陀螺仪: {gyro_data}")

# 清理资源
gyro.deinit()

# 初始化RTC
rtc = papers3.RTC()
rtc.init()

# 读取时间
current_time = rtc.datetime()
print(f"当前时间: {current_time}")

# 设置时间 (年, 月, 日, 星期, 时, 分, 秒)
rtc.set_datetime(2024, 12, 25, 3, 10, 30, 0)

# 清理资源
rtc.deinit()

# 初始化触摸屏
touch = papers3.Touch()
touch.init()

# 读取触摸数据
touch.update()                    # 更新触摸数据
num_touches = touch.get_touches() # 获取触摸点数量

for i in range(num_touches):
    point = touch.get_point(i)    # 获取触摸点 [x, y, size]
    x, y, size = point
    print(f"触摸点 {i}: X={x}, Y={y}, Size={size}")

# 清理资源
touch.deinit()

# 初始化LED
led = papers3.LED()
led.init()

# 控制LED
led.on()   # 点亮
led.off()  # 熄灭

# 清理资源
led.deinit()

# 导入测试模块
import test

# 创建测试实例
t = test.create_test()

# 查看帮助
t.help()

# 初始化硬件
t.init()

# 运行基础测试
t.basic()

# 硬件模块测试
t.buzzer_test()    # 蜂鸣器测试
t.battery_test()   # 电池监控测试
t.led_test()       # LED测试
t.gyro_test()      # 陀螺仪测试
t.rtc_test()       # RTC测试
t.touch_test()     # 触摸屏测试

# 显示功能测试

# 手动测试中文字体
epdiy = papers3.EPDiy()
epdiy.init()
epdiy.clear()

# 显示中英文对比 (注意70px行间距)
epdiy.draw_text("中文字体 Chinese Font", 50, 100, 0)
epdiy.draw_text("English Font Display", 50, 170, 0)  # 100+70=170

epdiy.update()

# 下载屏幕测试工具到ESP32
./scripts/download.sh

# 在ESP32上运行屏幕测试
import screen_range_test as srt

# 查看帮助
srt.help()

# 快速演示
srt.demo_quick()

# 交互式演示菜单
srt.demo_interactive()

# 基础屏幕范围测试
srt.test_basic()

# 坐标网格测试
srt.test_grid(100)

# 自定义文本布局测试
srt.test_text_layout(50, 50, 80, 6)

# 自定义测试 (带网格)
srt.test_custom(100, 80, 70, 5, True)

ink-paper/
├── micropython/         # MicroPython v1.25.0 (自动克隆)
├── esp-idf/            # ESP-IDF v5.4.1 (自动克隆)
├── epdiy/              # EPDiy 电子墨水屏库
├── papers3/            # Papers3 MicroPython 模块
│   ├── modpapers3.c    # 主模块入口
│   ├── papers3_epdiy.c # 显示器支持 (多字体)
│   ├── papers3_buzzer.c # 蜂鸣器
│   ├── papers3_battery.c # 电池监控
│   ├── papers3_gyro.c  # 陀螺仪
│   ├── papers3_rtc.c   # 实时时钟
│   ├── papers3_touch.c # 触摸屏
│   ├── papers3_led.c   # LED控制
│   ├── papers3_i2c.c   # I2C 共享总线管理
│   ├── papers3_i2c.h   # I2C 头文件
│   ├── papers3_pins.h  # 引脚定义
│   ├── chinese_24.h    # 中文字体(生成参数24px, 实际行高70px)
│   ├── _boot.py        # 启动脚本
│   ├── flashbdev.py    # Flash设备检测
│   └── inisetup.py     # 文件系统初始化
├── demo/               # 演示和测试程序
│   ├── test.py         # 完整测试框架
│   ├── screen_range_test.py # 屏幕范围测试工具
│   └── README.md       # 演示程序使用说明

# 查看系统信息
papers3.info()        # 基础系统信息
papers3.flash_info()  # Flash 使用情况
papers3.ram_info()    # RAM 状态信息

# 快速编译和烧写
./scripts/build.sh && ./scripts/flash.sh -e

# macOS/Linux
screen /dev/cu.usbserial-* 115200

# 或使用 minicom
minicom -b 115200 -D /dev/cu.usbserial-*

# 生成新字体 (需要先安装 freetype-py)
cd scripts
python3 generate_chinese_font.py --size 20 --output ../papers3

# 在 papers3_epdiy.c 中添加新字体支持
# 然后重新编译

# 标题区域
epdiy.draw_text("Papers3 应用", 20, 30, 0)

# 主要内容
epdiy.draw_text("这是主要内容区域", 20, 80, 0)

# 状态信息
epdiy.draw_text("状态: 就绪", 20, 500, 8)