Прошивка M5Stack PaperS3 на macOS через PlatformIO

PaperS3 — это e-ink устройство на ESP32-S3. Его можно использовать как часы, погодную станцию, панель для Home Assistant или для чтения книг. Ниже приведена универсальная инструкция по прошивке и разработке под PaperS3 на macOS с помощью PlatformIO.

1. Установка и проверка инструментов

Убедитесь, что установлен PlatformIO Core:

pio --version

Если команда вернула номер версии (например, 6.1.18), всё готово. Если PaperS3 не определяется в портах, установите драйвер CP210x:

CP210x USB to UART driver for macOS

2. Создание проекта

Создайте новый проект для PaperS3:

mkdir -p ~/Projects/papers3 && cd ~/Projects/papers3
pio project init --board esp32-s3-devkitc-1

3. Настройка platformio.ini

Откройте platformio.ini и замените содержимое:

[env:esp32s3]
platform = https://github.com/platformio/platform-espressif32.git
board = esp32-s3-devkitc-1
framework = arduino

; настройки под PaperS3
board_build.flash_size = 16MB
board_build.psram = opi

monitor_speed = 115200

Используется GitHub-платформа, чтобы избежать проблем с доступом к реестру.

4. Код прошивки

Откройте src/main.cpp и вставьте тестовый код:

#include <Arduino.h>

void setup() {
  Serial.begin(115200);
  delay(1000);
  Serial.println("✅ PaperS3 прошился и работает!");
}

void loop() {
  delay(1000);
}

5. Подключение устройства

Подключите PaperS3 к Mac через USB-C и проверьте порт:

ls /dev/cu.usb*

Пример результата: /dev/cu.usbserial-110.

6. Сборка и прошивка

Соберите проект:

pio run

Залейте прошивку (замените XXXX на свой порт):

pio run -t upload --upload-port /dev/cu.usbserial-XXXX

7. Проверка работы

Откройте монитор порта:

pio device monitor -b 115200 --port /dev/cu.usbserial-XXXX

Если всё прошло успешно — появится сообщение из Serial.println.

8. Добавление библиотек

Устанавливайте библиотеки для работы с экраном, JSON и API:

pio pkg install --library M5Unified
pio pkg install --library M5GFX
pio pkg install --library ArduinoJson

9. Следующие шаги

• Часы + погода: используйте OpenWeatherMap API и NTP.
• Чтение книг (EDC Book): прошейте готовую прошивку или соберите из исходников.
• Home Assistant: добавьте PaperS3 как e-ink панель через ESPHome.

10. Полезные команды

• Компиляция: pio run
• Заливка: pio run -t upload --upload-port /dev/cu.usbserial-XXXX
• Монитор: pio device monitor -b 115200 --port /dev/cu.usbserial-XXXX
• Установка библиотеки: pio pkg install --library <имя>
• Очистка: pio run -t clean

Заключение

PaperS3 удобно прошивать через PlatformIO на macOS: настройка проекта занимает несколько минут, а библиотеки позволяют быстро реализовать часы, погоду или интеграцию с Home Assistant. Подход универсален и подходит для любых скетчей под ESP32-S3.