Translate READMEs to Russian

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
2026-09-14 16:03:56 +03:00
co-authored by Claude Sonnet 5
parent 8b0102b56c
commit 17b0421aaf
2 changed files with 129 additions and 125 deletions
+45 -43
View File
@@ -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`.