From 030c43aa4a22a0a2fce74129c2a81e2dac866846 Mon Sep 17 00:00:00 2001 From: Alex Date: Mon, 14 Sep 2026 16:10:04 +0300 Subject: [PATCH] Document the AT-command UART interface MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Root README: new "Интерфейсы" section listing the supported AT+ subset alongside the native SPI protocol. firmware/README.md: added the three AT-related fixes (lazy WiFi init before the first network AT command, AT+GMR display-capture timing, AT+NET_NTP -> standard AT+CIPSNTPCFG/ AT+CIPSNTPTIME) to the changelog - all verified present in current source before writing this up. Co-Authored-By: Claude Sonnet 5 --- README.md | 12 ++++++++++++ firmware/README.md | 11 +++++++++++ 2 files changed, 23 insertions(+) diff --git a/README.md b/README.md index 77f8604..7529494 100644 --- a/README.md +++ b/README.md @@ -10,6 +10,18 @@ Полный список изменений этого форка и их текущий статус — в [`firmware/README.md`](firmware/README.md). +## Интерфейсы + +Модулем можно управлять двумя способами: + +- **Родной SPI-протокол** (`esp_spi_defs.h`) — основной, быстрый способ + связи с Z80-стороной (используется, в частности, VFS/SMB-мостом). +- **AT-команды по UART** (`at_uart.cpp`), частично совместимые с набором + команд реального модуля ESP-AT: `AT+RST`, `AT+GMR`, `AT+CWJAP`, + `AT+CWLAP`, `AT+CIPSTART`, `AT+CIPSEND`, `AT+CIPSNTPCFG`, + `AT+CIPSNTPTIME`. Этим интерфейсом пользуется, например, клиент ZiFi на + самой ZX Evolution. + ## Требования - Прошивка ядра платы ZX Evolution/TS-Conf **должна быть собрана с diff --git a/firmware/README.md b/firmware/README.md index 48ed0ad..f816e1c 100644 --- a/firmware/README.md +++ b/firmware/README.md @@ -53,6 +53,17 @@ Windows/macOS/Linux мог просматривать, скачивать, за - **Исправления стабильности**: падение по нулевому указателю в обработке named-pipe RPC transceive, и нулевая по длине SPI DMA-транзакция, которая могла подвесить весь SPI-канал к стороне Z80. +- **Исправления в интерфейсе AT-команд** (`at_uart.cpp`/`at_cip.cpp`, + не связаны с VFS/SMB, но тоже часть этого форка): + - `AT+CIPSTART` (и любая другая первая после загрузки сетевая AT-команда) + падал, если стек WiFi ещё не был поднят (мьютекс `tcpip_task` ещё не + создан) — исправлено ленивой инициализацией WiFi перед первой сетевой + командой. + - Ответ на `AT+GMR` добавлял `vTaskDelay(500ms)` перед содержимым — без + этой паузы реальный ZiFi-клиент на ZX Evolution иногда не успевал + захватить баннер на экран. + - Собственная нестандартная команда `AT+NET_NTP` заменена на реальные + команды спецификации ESP-AT `AT+CIPSNTPCFG`/`AT+CIPSNTPTIME`. - **Патчи `libsmb2`** (вендорено в `src/third_party/libsmb2`): - `SMB2_FSCTL_DFS_GET_REFERRALS` теперь отвечает `STATUS_OBJECT_PATH_NOT_FOUND` вместо `STATUS_NOT_IMPLEMENTED` —