Update README.en.md

Export/readme.md

@@ -0,0 +1 @@
+# Схемы и iBOMs

Gerber/readme.md

@@ -0,0 +1 @@
+# Файлы для производства.

README.en.md

@@ -1,6 +1,78 @@
 # PentoGraf-Pentagon-1024k
 
-Pentagon ZX Spectrum clone on SRAM with TurboSound and NemoBus in Leningrad-2 (Aurora) form-factor.
+## Pentagon ZX Spectrum clone on SRAM with TurboSound and NemoBus in Leningrad-2 (Aurora) form-factor.
 
 > [English](README.en.md) | [Русский](README.md)
 
+# 🛠 PentoGraf (Pentagon Clone by Alex-2-Graf)
+
+After the successful launch of Leningrad-2-48k and Leningrad-2-128k-SRAM, the question arose about playing demos. 
+We all know that the majority of demosceners write their demos specifically for the Pentagon clone.
+
+## 📜 History
+
+**Pentagon** is the most popular and iconic Soviet clone of the ZX Spectrum, developed in Moscow around 1989–1990. Unlike the original British computer, the Pentagon featured unique screen timings (320 lines per frame instead of 312, and 71,680 T-cycles per INT instead of 69,888).
+
+These "incorrect" timings gave the CPU more time to execute code during the interrupt. This made the Pentagon a worldwide benchmark for creating highly complex graphical and musical demos (Demoscene). Even today, 99% of all graphical effects and multicolor routines in the post-Soviet space are written strictly for the Pentagon architecture.
+
+Many suggested simply modifying the timings of the Aurora board to match the Pentagon. However, in that case, it wouldn't be a Leningrad-2 anymore, nor would it be a proper Pentagon.
+
+A different approach was chosen.
+
+**PentoGraf** is an author's modification of the iconic Pentagon ZX Spectrum clone. This project is a direct continuation of the **Aurora** board (Leningrad-2 128k SRAM) and brings the legendary demoscene architecture into the compact form-factor and dimensions of the "Leningrad".
+
+**PentoGraf** is a tribute to the legend, built on reliable static RAM (SRAM) and packed into the ergonomic size of the "Leningrad" board.
+
+## 💾 Key Features
+
+* **Compatibility:** Full match of dimensions, mounting holes, and connectors with the "Aurora" board (Leningrad-2). Fits the same cases and is compatible with original keyboards.
+* **Component Base:** 100% classic discrete logic ("rassypukha") of K1533/K555 series (74HC/HCT) without using CPLD/FPGA.
+* **Memory:** 1024 KB of static RAM (SRAM) onboard, eliminating issues related to complex and unreliable dynamic RAM (RU5/RU7).
+* **Sound:** Integrated dual-chip TurboSound system (two AY-3-8910/YM2149F chips).
+* **Modernization:** The bulky classic floppy disk controller (FDD) has been completely removed.
+* **Expansion:** Equipped with a single NemoBus system slot for connecting modern peripherals (DivMMC, BDI, PiCard, ZXKM, GeneralSound, ZX-Multisound, etc.).
+* **RISER:** Further expansion up to 4 devices is possible using a Riser board.
+
+---
+
+## As a result, the following files were created:
+* [PentoGraf iBOM 1.01](Export/PentoGraf_1.01.html)
+* [Schematics](Export/PentoGraf_1.01.pdf)
+* [Gerber Files](Gerber/PentoGraf_1.01_gerber.zip)
+
+### T-connector (Riser) series:
+* [Riser iBOM](Export/Rizer.html)
+* [Schematics](Export/Rizer.pdf)
+* [RIZER x4](Gerber/RIZER_x4_Nemobus_Pent_gerber.zip)
+* [RIZER x3](Gerber/RIZER_x3_Nemobus_Pent_gerber.zip)
+* [RIZER x2](Gerber/RIZER_x2_Nemobus_Pent_gerber.zip)
+* [RIZER x1](Gerber/RIZER_x1_Nemobus_Pent_gerber.zip)
+
+## 📌 Additional Notes
+* Memory can be used in **SOP packages** via an adapter [Gerber](Gerber/SRAM-PentoGraf_Gerber.zip)  .
+* As mentioned above, you can use the **keyboard from the Aurora board**.
+
+---
+
+## 🛠 Assembly and Troubleshooting
+
+Generally, assembly and tuning do not cause any major issues. However, let's clarify the purpose of the jumpers:
+
+* **JP1, JP2, and JP3:** These must be shorted/closed if you are installing a **VGA connector**. If you are installing an **HDMI output**, leave them open. 
+  * *Note:* When installing HDMI, all resistors **R24-R31** must be replaced with **270 Ohm** values.
+* **J9:** This jumper is required to cut power from the **RP2040-Zero** during firmware flashing.
+* **J18:** This jumper is required when using the **W27C512 ROM**.
+
+### 💾 ROM / Firmware
+* ROM files for the project can be found [here](ROM).
+
+### 📺 VGA Output
+* Firmware and configuration settings for the RP2040-Zero can be found [here](VGA).
+
+---
+
+## ⚖ License
+
+This project is Open Source Hardware. Graphic materials, schematics, and PCB layouts are distributed under the **CERN OHL v2 Weak Reciprocal** license (CERN-OHL-W-2.0).
+
+You are free to redistribute, modify, and manufacture this device, provided that the authorship of **Alex-2-Graf** is preserved and any modified source files of the board are published under the same open-source license.

README.md

@@ -1,8 +1,115 @@
 # PentoGraf-Pentagon-1024k
+  
+## Pentagon ZX Spectrum clone on SRAM with TurboSound and NemoBus in Leningrad-2 (Aurora) form-factor.  
+  
+> [English](README.en.md) | [Русский](README.md)  
+  
+# 🛠️ PentoGraf (Pentagon Clone by Alex-2-Graf)  
+  
+После успешного запуска [Leningrad-2-48k](https://github.com/Alex-2-Graf/LENINGRAD-2-48k) и [Leningrad-2-128k-SRAM](https://github.com/Alex-2-Graf/Leningrad-2-128k-SRAM) встал вопрос с проигрыванием демок.  
+  
+Все мы знаем, что большинство демосценеров пишут демо под клон Пентагона.
 
-Pentagon ZX Spectrum clone on SRAM with TurboSound and NemoBus in Leningrad-2 (Aurora) form-factor.
+---
+
+## 📜 Историческая справка / History
+
+**Pentagon (Пентагон)** — самый популярный и культовый советский клон ZX Spectrum, разработанный в Москве в районе 1989–1990 годов.
+В отличие от оригинального британского компьютера, Пентагон обладал уникальным таймингом экрана (320 строк в кадре вместо 312 и 71680 тактов за интру вместо 69888). 
+
+Именно эти «неправильные» тайминги дали процессору больше времени на выполнение кода во время прерывания.  
+Это сделало Пентагон мировым эталоном для создания сложнейших графических и музыкальных демо (Demoscene).  
+До сих пор 99% всех графических эффектов и мультиколоров на постсоветском пространстве пишутся строго под архитектуру Пентагона.
+  
+---
+
+Многие предлагали просто переделать тайминги под Пентагон на Авроре.  
+Но тогда это будет уже не Ленинград2, но ещё и не Пентагон.  
+Был выбран другой путь. 
+
+---
+
+**PentoGraf** — авторская модификация культового клона ZX Spectrum «Пентагон».  
+Проект является прямым продолжением платы **Aurora** (Ленинград-2 128k SRAM) и переносит легендарную демосценическую архитектуру в компактные габариты и форм-фактор «Ленинграда».
+  
+**PentoGraf** — это дань уважения легенде, выполненная на надежной статической памяти (SRAM) и упакованная в эргономичные размеры платы «Аврора».
+
+---
+
+## 💾 Основные особенности
+
+* **Совместимость:** Полное совпадение размеров, крепежных отверстий и разъемов с платой «Аврора» (Ленинград-2). Подходит в те же корпуса, совместима с оригинальными клавиатурами.
+* **База компонентов:** 100% классическая мелкая логика («рассыпуха») серий К1533/К555 без использования CPLD/FPGA.
+* **Память:** 1024 КБ статического ОЗУ (SRAM) «на борту», что избавляет от проблем со сложной и ненадежной динамической памятью (РУ5/РУ7).
+* **Звук:** Интегрированная двухчиповая звуковая система TurboSound (два чипа AY-3-8910/YM2149F).
+* **Модернизация:** Полностью удален громоздкий классический контроллер дисковода (FDD).
+* **Расширение:** Установлен один системный слот NemoBus для подключения современных периферийных устройств (DivMMC, BDI, PiCard, ZXKM, GeneralSound, ZX-Multisound и др.).
+* **RIZER:** Также возможно расширение через Rizer до 4-х устройств
+* 
+---
+
+## В результате на свет появился PentoGraf  [iBOM 1.01](Export/PentoGraf_1.01.html)   [Схема](Export/PentoGraf_1.01.pdf)   [Gerber](Gerber/PentoGraf_1.01_gerber.zip)  
+  
+![](Foto/PentoGraf.jpg)  
+  
+![](Foto/PentoGraf-3.jpg)  
+  
+---
+
+## Серия ёлок [iBOM х4](Export/Rizer.html)  [Схема](Export/Rizer.pdf)  
+  
+[RIZER x4](Gerber/RIZER_x4_Nemobus_Pent_gerber.zip)  
+[RIZER x3](Gerber/RIZER_x3_Nemobus_Pent_gerber.zip)  
+[RIZER x2](Gerber/RIZER_x2_Nemobus_Pent_gerber.zip)  
+[RIZER x1](Gerber/RIZER_x1_Nemobus_Pent_gerber.zip)  
+
+![](Foto/RIZER_x4_Nemobus_Pent.jpg)  
+  
+![](Foto/RIZER_x3_Nemobus_Pent.jpg)  
+  
+![](Foto/RIZER_x2_Nemobus_Pent.jpg)  
+  
+![](Foto/RIZER_x1_Nemobus_Pent.jpg)  
+  
+---
+
+## Предусмотрено использование памяти в корпусах SOP через переходник [Gerber](Gerber/SRAM-PentoGraf_Gerber.zip)  
+  
+![](Foto/SRAM-PentoGraf.png)  
+  
+---
+
+## Как упоминалось выше можно использовать клавиатуру от Авроры
+
+---
+
+## Сборка  
+  
+Как правило, сборка и наладка проблем не вызывают.  
+Хотя всё же проясним назначение перемычек.  
+  
+JP1, JP2 и JP3 замыкаются в случае установки VGA-разъёма.  
+При установке HDMI замыкать их не надо.  
+Но при этом все резисторы R24-31 заменяются на 270 Ом.  
+Джампер J9 необходим для снятия питания с RP2040-Zero при перепрошивке.  
+  
+![](Jumpers/J9.jpg)  
+  
+Джампер J18 необходим при использовании ПЗУ W27C512.  
+  
+![](Jumpers/J18.jpg)  
+  
+## ПЗУ  
+  
+ПЗУ для проекта находятся [тут](ROM)  
+  
+## VGA  
+  
+Прошивка и настройки для RP2040-Zero находится [тут](VGA)  
+
+## ⚖️ Лицензия / License
 
 
+Этот проект является открытым аппаратным обеспечением (Open Source Hardware). Графические материалы, схемы и топология печатной платы распространяются под лицензией **CERN OHL v2 Weak Reciprocal** (CERN-OHL-W-2.0).
 
-> \[English](README.en.md) | \[Русский](README.md)  
-
+Вы можете свободно распространять, модифицировать и производить это устройство при условии сохранения авторства **Alex-2-Graf** и публикации измененных исходных файлов платы под аналогичной открытой лицензией.

ROM/readme.md

@@ -0,0 +1,14 @@
+# Прошивки для проекта
+
+PentoGraf (8 ROM)  -  полная прошивка для 29C040  
+  
+Прошивки для W27C512  
+  
+1. PentoGraf (Classic) - Основная прошивка. (Рекомендуется)
+2. PentoGraf (Fatall 0.25) - Используется с БДИ.
+3. PentoGraf (Proteus 2.23.3381) - Используется с БДИ.
+4. PentoGraf (GLUK 6.63) - Используется с БДИ.
+5. PentoGraf (MED) - Используется с БДИ.
+6. PentoGraf (Test by LW PLM) - Популярный тест Михалыча.
+7. PentoGraf (Test 1024k) - Тест от Князева
+8. PentoGraf (RETROLEUM 1.71) - Тест 128к и переферии.

Sources/readme.md

@@ -0,0 +1,2 @@
+# Вспомогательные материалы
+