From b7a0a519da4296fc4fa8f6dcf14a5bb91ba7e742 Mon Sep 17 00:00:00 2001
From: alexkharl <sasha_xarlamov@mail.ru>
Date: Thu, 8 Feb 2024 17:49:16 +0300
Subject: [PATCH] =?UTF-8?q?Ref(01=5FAdder):=D0=94=D0=BE=D0=BF=D0=BE=D0=BB?=
 =?UTF-8?q?=D0=BD=D0=B5=D0=BD=D0=B8=D0=B5=20=D0=B8=D0=BD=D1=84=D0=BE=D1=80?=
 =?UTF-8?q?=D0=BC=D0=B0=D1=86=D0=B8=D0=B5=D0=B9=20board=20=D1=84=D0=B0?=
 =?UTF-8?q?=D0=B9=D0=BB=D0=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .pic/Labs/board files/nexys_adder0.png | Bin 0 -> 18523 bytes
 Labs/01. Adder/board files/README.md   |  26 +++++++++++++++++--------
 2 files changed, 18 insertions(+), 8 deletions(-)
 create mode 100644 .pic/Labs/board files/nexys_adder0.png

diff --git a/.pic/Labs/board files/nexys_adder0.png b/.pic/Labs/board files/nexys_adder0.png
new file mode 100644
index 0000000000000000000000000000000000000000..4c9d2d6ba846ab107321bd41aa81dda77e96365f
GIT binary patch
literal 18523
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
G`TQ>^a4Poz

literal 0
HcmV?d00001

diff --git a/Labs/01. Adder/board files/README.md b/Labs/01. Adder/board files/README.md
index 6eb83fc..74c3245 100644
--- a/Labs/01. Adder/board files/README.md	
+++ b/Labs/01. Adder/board files/README.md	
@@ -1,23 +1,33 @@
-# Проверка работы Полного 32-битного сумматора на ПЛИС
+# Проверка работы полного 32-битного сумматора в ПЛИС
 
-После того, как вы создали свой сумматор и проверили его на прохождение тестирующего модуля, вы можете использовать предложенный модуль окружения [`nexys_adder.sv`](nexys_adder.sv), который позволяет связать вашу логику с периферией, расположенной на плате `Nexys-A7`. Для его подключения, скачайте и добавьте файл в проект, либо скопируйте содержимое в новый `.sv` файл вашего проекта. В окне `Sources` нажмите на него ПКМ и выберите `Set as Top`, после чего в иерархии он станет главным, подключив ваш собственный модуль сумматора. Для того, чтобы дизайн мог физически подключиться к периферии, нужно в проекте выбрать `Add or create constraints` и подключить файл [`nexys_a7_100t.xdc`](nexys_a7_100t.xdc).
+После того, как вы создали свой сумматор и проверили его в симуляции, вы можете использовать предложенный модуль окружения [`nexys_adder.sv`](nexys_adder.sv), который позволяет связать вашу логику с периферией, расположенной на плате `Nexys-A7`. Для его подключения, скачайте и добавьте файл в проект, либо скопируйте содержимое в новый `.sv` файл вашего проекта. В окне `Sources` нажмите на него ПКМ и выберите `Set as Top`, после чего в иерархии он станет главным (название главного модуля выделено **жирным** шрифтом). Для того, чтобы дизайн мог физически подключиться к периферии, нужно в проекте выбрать `Add or create constraints` и подключить файл [`nexys_a7_100t.xdc`](nexys_a7_100t.xdc). Иерархия проекта, готового к созданию битстрима, показана на *рисунке 1*.
 
-После этого наше устройство будет выглядеть так:
+![../../../.pic/Labs/board%20files/nexys_adder0.png](../../../.pic/Labs/board%20files/nexys_adder0.png)
+
+*Рисунок 1. Иерархия проекта полного тридцатидвухбитного сумматора*
+
+После этого наше устройство будет выглядеть, как представлено на *рисунке 2*:
 
 ![../../../.pic/Labs/board%20files/nexys_adder1.png](../../../.pic/Labs/board%20files/nexys_adder1.png)
 
-Подключенное окружение позволяет производить ввод входных значений (А, В и Pin) с помощью переключателей (номер переключателя отображен на самом краю платы), расположенных на плате. Операнд А задается переключателями 15-8, В: 7-0, Pin: тактовая кнопка BTND (нижняя из 5-ти, расположенных вместе в форме крестовины). Семисегментные индикаторы в шестнадцатеричном формате отображают на левом блоке слагаемые А и В, а на правом - результат сложения. На светодиодах, расположенных над переключателями отображается результат  в двоичном формате.
+*Рисунок 2. Структурная схема модуля `nexys_adder`*, где `A`, `B` - операнды, `Pin` - входной перенос (`carry`), `S` - сумма, `Pout` - выходной перенос для тридцати двух битов (не подключен), `Semseg` - сигнал подаваемый на семисегментные индикаторы
 
-Управление сумматором через плату
+Подключенное окружение позволяет производить ввод входных значений для сумматора (`A`, `B` и `carry` aka `Pin`) с помощью переключателей (номер переключателя написан под ним же) и кнопки `BTND`. Так как переключателей всего 16, то ими можно задать только нижние восемь бит тридцатидвухбитных операндов `A` и `B` (на остальные двадцать четыре бита подается константный `0`). Таким образом нижние восемь бит операнд `A` задается переключателями `15-8`, а нижние восемь бит операнда `B` - переключателями `7-0`, входной бит переноса `carry` - кнопкой `BTND` (нижняя кнопка в группе из пяти кнопок). Максимальное беззнаковое число, которое можно подать на операнд - `2⁸ = 256`. Максимальная сумма будет `255 + 255 = 510 = 0x1FE`. В таком случае сумма двух восьмибитных чисел занимает восемь бит (`0xFE`) плюс бит переноса (`1`). Семисегментные индикаторы в шестнадцатеричном формате отображают на левом блоке слагаемые `A` и `B` (их нижние восемь бит, разделенные точкой), а на правом - результат сложения (двенадцать бит для отображения еще и переноса). Светодиоды, расположенные над переключателями, дублируют сумму, представляя ее в двоичном формате.
+
+На *рисунке 3* представлено показано сложение `A=0x48 + B=0x18 = 0x60` при нулевом входном преносе (нулевом, тк не нажата кнопка `BTND` aka сигнал `Pin`)
 
 ![../../../.pic/Labs/board%20files/nexys_adder2.png](../../../.pic/Labs/board%20files/nexys_adder2.png)
 
-Для прошивки ПЛИС подключите утройство через USB, включите питание переключателем, выполните синтез и имплементацию вашего дизайна и сгенерируйте битстрим. Если на этом этапе у вас возникают ошибки, постарайтесь исправить из с помощью [`инструкции по работе с ошибками синтеза`](../../../Vivado%20Basics/Elaboration%20failed.md). После этого выберите в левом меню `Open Target` - `Auto Connect`, затем `Program Device` и ваше устройство прошьется.
+Рисунок 3. Использование сумматора выражения `0x48 + 0x18` в ПЛИС
+
+Для прошивки ПЛИС подключите утройство через USB, включите питание переключателем, выполните синтез и имплементацию вашего дизайна и сгенерируйте битстрим. Если на этом этапе у вас возникают ошибки, постарайтесь ее исправить с помощью [`инструкции по работе с ошибками синтеза`](../../../Vivado%20Basics/Elaboration%20failed.md). После этого выберите в левом меню `Open Target` - `Auto Connect`, затем `Program Device` и ваше устройство прошьется. Процедура запуска генерации битстрима показана на *рисунке 4*, а прошивка сгенерированного битстрима в ПЛИС - на *рисунке 5*.
 
-Генерация битстрима
 ![../../../.pic/Labs/board%20files/Program_Device1.png](../../../.pic/Labs/board%20files/Program_Device1.png)
 
-Прошивка ПЛИС
+*Рисунок 4. Генерация битстрима*
+
 ![../../../.pic/Labs/board%20files/Program_Device2.png](../../../.pic/Labs/board%20files/Program_Device2.png)
 
+*Рисунок 5. Прошивка битстрима в ПЛИС*
+
 Попробуйте выставить на переключателях различные слагаемые, убедитесь, что все работает исправно и сдавайте работу.