Translate READMEs to Russian
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
@@ -1,57 +1,59 @@
|
||||
# ZIFI32 — ESP32 WiFi/SPI module for ZX Evolution
|
||||
# ZIFI32 — модуль ESP32 WiFi/SPI для ZX Evolution
|
||||
|
||||
Firmware and hardware for the ESP32-S3-based WiFi/SPI module ("ZiFi32") used
|
||||
by the ZX Evolution / TS-Conf ("Pentevo") retro-computer platform. Adds
|
||||
WiFi, a WAV/XM/MOD/S3M audio tracker, and (new in this fork, work in
|
||||
progress) an SMB2/3 network share that exposes the machine's real SD card
|
||||
to any Windows/macOS/Linux client.
|
||||
Прошивка и аппаратная часть модуля ESP32-S3 (WiFi/SPI, "ZiFi32") для
|
||||
ретро-компьютера ZX Evolution / TS-Conf ("Pentevo"). Даёт WiFi,
|
||||
аудио-трекер (WAV/XM/MOD/S3M), а также (новое в этом форке, в разработке)
|
||||
сетевую шару по SMB2/3, открывающую доступ к реальной SD-карте машины с
|
||||
любого клиента Windows/macOS/Linux.
|
||||
|
||||
**Base source**: [tslabs/zx-evo](https://github.com/tslabs/zx-evo/tree/master/pentevo/esp32).
|
||||
See [`firmware/README.md`](firmware/README.md) for the full list of changes
|
||||
made in this fork and their current status.
|
||||
**Исходная база**: [tslabs/zx-evo](https://github.com/tslabs/zx-evo/tree/master/pentevo/esp32).
|
||||
Полный список изменений этого форка и их текущий статус — в
|
||||
[`firmware/README.md`](firmware/README.md).
|
||||
|
||||
## Requirements
|
||||
## Требования
|
||||
|
||||
- The ZX Evolution/TS-Conf board's own **core firmware must be built with
|
||||
VDAC2 and ESP32 (ZiFi32) peripheral support enabled** - without both, the
|
||||
core won't recognize this module on the SPI bus at all, and won't drive
|
||||
the FT8xx video chip either.
|
||||
- The **RESET jumper on the IDE connector must be installed** - see
|
||||
- Прошивка ядра платы ZX Evolution/TS-Conf **должна быть собрана с
|
||||
поддержкой VDAC2 и ESP32 (ZiFi32)** — без этого ядро вообще не увидит
|
||||
модуль на шине SPI, а видеочип FT8xx работать не будет.
|
||||
- **Перемычка RESET на разъёме IDE должна быть установлена** — см.
|
||||
[`hardware/connection_diagram.webp`](hardware/connection_diagram.webp).
|
||||
|
||||
## Repository layout
|
||||
## Структура репозитория
|
||||
|
||||
| Path | What's there |
|
||||
| Путь | Что там |
|
||||
|---------------------|--------------|
|
||||
| `src/` | ESP32 firmware source (ESP-IDF project) |
|
||||
| `firmware/` | Ready-to-flash compiled binaries + flashing instructions + changelog |
|
||||
| `hardware/` | Adapter board connection diagram, PCB photo, Gerber files |
|
||||
| `doc/` | Protocol/design notes |
|
||||
| `test/` | Original upstream SPI protocol test scripts (Python, Raspberry Pi) |
|
||||
| `spi_gpio_probe/` | Standalone diagnostic firmware - logs raw SPI pin edges, used for bring-up debugging, NOT the main firmware |
|
||||
| `src/` | Исходный код прошивки ESP32 (проект ESP-IDF) |
|
||||
| `firmware/` | Готовые к прошивке скомпилированные файлы + инструкция по прошивке + список изменений |
|
||||
| `hardware/` | Схема подключения переходной платы, фото платы, Gerber-файлы |
|
||||
| `doc/` | Заметки по протоколу/архитектуре |
|
||||
| `test/` | Оригинальные тестовые скрипты протокола SPI из апстрима (Python, Raspberry Pi) |
|
||||
| `spi_gpio_probe/` | Отдельная диагностическая прошивка — логирует сырые фронты на пинах SPI, использовалась для отладки при разработке; НЕ основная прошивка |
|
||||
|
||||
## Quick start
|
||||
## Быстрый старт
|
||||
|
||||
1. Flash `firmware/esp-spi.bin` (+ bootloader/partition table) to the ESP32-S3
|
||||
module - see [`firmware/README.md`](firmware/README.md#flashing) for the
|
||||
exact `esptool.py` command.
|
||||
2. Wire it up per [`hardware/connection_diagram.webp`](hardware/connection_diagram.webp)
|
||||
(adapter PCB Gerbers are in [`hardware/gerber/`](hardware/gerber/) if you're
|
||||
making your own board - see the photo in [`hardware/pcb_photo.jpg`](hardware/pcb_photo.jpg)).
|
||||
3. Make sure the ZX Evolution core firmware requirement above is met.
|
||||
4. Build from source instead of flashing the prebuilt binary: ESP-IDF
|
||||
**v6.1** (not `v6.1-rc1`), `idf.py build flash`.
|
||||
1. Прошейте `firmware/esp-spi.bin` (+ bootloader/таблицу разделов) в модуль
|
||||
ESP32-S3 — точная команда `esptool.py` в
|
||||
[`firmware/README.md`](firmware/README.md#Прошивка).
|
||||
2. Подключите по схеме
|
||||
[`hardware/connection_diagram.webp`](hardware/connection_diagram.webp)
|
||||
(Gerber-файлы переходной платы — в [`hardware/gerber/`](hardware/gerber/),
|
||||
если делаете свою плату; фото платы —
|
||||
[`hardware/pcb_photo.jpg`](hardware/pcb_photo.jpg)).
|
||||
3. Убедитесь, что выполнено требование по ядру ZX Evolution (см. выше).
|
||||
4. Собрать из исходников вместо прошивки готового бинарника: ESP-IDF
|
||||
**v6.1** (не `v6.1-rc1`), `idf.py build flash`.
|
||||
|
||||
## Status
|
||||
## Статус
|
||||
|
||||
WiFi, audio tracker playback, and the SMB2/3 VFS bridge (browse, download,
|
||||
upload, delete over a real SD card) all work against real hardware. The VFS
|
||||
bridge is still **actively being developed** - directory creation, in-place
|
||||
file truncation on overwrite, and live directory-change notifications aren't
|
||||
implemented yet. Full details in [`firmware/README.md`](firmware/README.md).
|
||||
WiFi, воспроизведение аудио-трекера и SMB2/3-мост (просмотр, скачивание,
|
||||
загрузка, удаление на реальной SD-карте) — всё работает на реальном
|
||||
железе. Мост к SMB всё ещё **активно дорабатывается** — пока не реализовано
|
||||
создание директорий, обрезка файла при перезаписи более коротким
|
||||
содержимым и уведомления об изменениях в реальном времени. Подробности —
|
||||
в [`firmware/README.md`](firmware/README.md).
|
||||
|
||||
## License
|
||||
## Лицензия
|
||||
|
||||
This repository vendors [libsmb2](https://github.com/sahlberg/libsmb2)
|
||||
(LGPL-2.1) under `src/third_party/libsmb2` - see its own `COPYING` and
|
||||
`LICENCE-LGPL-2.1.txt` there.
|
||||
В этом репозитории вендорится [libsmb2](https://github.com/sahlberg/libsmb2)
|
||||
(LGPL-2.1) в каталоге `src/third_party/libsmb2` — см. его собственные файлы
|
||||
`COPYING` и `LICENCE-LGPL-2.1.txt`.
|
||||
|
||||
Reference in New Issue
Block a user