From 212714af94178793e832f33de71f5f30ab9912e2 Mon Sep 17 00:00:00 2001 From: Andrei Solodovnikov Date: Sun, 17 Sep 2023 11:11:39 +0300 Subject: [PATCH] =?UTF-8?q?=D0=9A=D0=BE=D0=BC=D0=BF=D0=B8=D0=BB=D1=8F?= =?UTF-8?q?=D1=86=D0=B8=D1=8F=20=D0=B8=20=D1=80=D0=B0=D0=B7=D0=B2=D0=B5?= =?UTF-8?q?=D1=80=D1=82=D1=8B=D0=B2=D0=B0=D0=BD=D0=B8=D0=B5=20=D0=BE=D0=BD?= =?UTF-8?q?=D0=BB=D0=B0=D0=B9=D0=BD-=D0=BA=D0=BD=D0=B8=D0=B3=D0=B8=20(#2)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/SUMMARY.md | 49 ++++++++++++++++++++++++++++ .github/book.toml | 6 ++++ .github/prepare.sh | 5 +++ .github/workflows/mdbook.yml | 62 ++++++++++++++++++++++++++++++++++++ 4 files changed, 122 insertions(+) create mode 100644 .github/SUMMARY.md create mode 100644 .github/book.toml create mode 100644 .github/prepare.sh create mode 100644 .github/workflows/mdbook.yml diff --git a/.github/SUMMARY.md b/.github/SUMMARY.md new file mode 100644 index 00000000..afc20549 --- /dev/null +++ b/.github/SUMMARY.md @@ -0,0 +1,49 @@ +# Summary + +[Что такое Язык Описания Аппаратуры](Introduction/What%20is%20HDL.md) +[Как работает ПЛИС](Introduction/How%20FPGA%20works.md) + +--- + +# Цикл лабораторных работ + +- [Лабораторная №1. Сумматор](Labs/01.%20Adder/README.md) +- [Лабораторная №2. АЛУ](Labs/02.%20Arithmetic-logic%20unit/README.md) +- [Лабораторная №3. Регистровый файл и внешняя память](Labs/03.%20Register%20file%20and%20memory/README.md) +- [Лабораторная №4. Простейшее программируемое устройство](Labs/04.%20Primitive%20programmable%20device/README.md) +- [Лабораторная №5. Основной дешифратор](Labs/05.%20Main%20decoder/README.md) +- [Лабораторная №6. Тракт данных](Labs/06.%20Datapath/README.md) +- [Лабораторная №7. Внешняя память]() +- [Лабораторная №8. Блок загрузки и сохранения](Labs/08.%20Load-store%20unit/README.md) +- [Лабораторная №9. Интеграция LSU](Labs/09.%20LSU%20Integration/README.md) +- [Лабораторная №10. Подсистема прерываний](Labs/10.%20Interrupt%20subsystem/README.md) +- [Лабораторная №11. Интеграция подсистемы прерываний](Labs/11.%20Interrupt%20integration/README.md) +- [Лабораторная №12. Периферийные устройства](Labs/12.%20Peripheral%20units/README.md) +- [Лабораторная №13. Программирование](Labs/13.%20Programming/README.md) + +--- + +# Базовые структуры языка SystemVerilog + +- [Модули](Basic%20Verilog%20structures/Modules.md) +- [Мультиплексоры](Basic%20Verilog%20structures/Multiplexors.md) +- [Регистры](Basic%20Verilog%20structures/Registers.md) +- [Конкатенация](Basic%20Verilog%20structures/Concatenation.md) +- [Контроллеры](Basic%20Verilog%20structures/Controllers.md) +- [Тестовое окружение](Basic%20Verilog%20structures/Testbench.md) + +--- + +# Основы Vivado + +- [Руководство по установке Vivado](Vivado%20Basics/Install%20Vivado.md) +- [Создание проекта в Vivado](Vivado%20Basics/Vivado%20trainer.md) +- [Структура директорий в проекте Vivado](Vivado%20Basics/Folder%20Structure%20In%20The%20Project.md) +- [Как сгенерировать схему](Vivado%20Basics/How%20to%20open%20a%20schematic.md) +- [Ошибки элаборации](Vivado%20Basics/Elaboration%20failed.md) +- [Шаги имплементации](Vivado%20Basics/Implementation%20steps.md) +- [Запуск симуляции](Vivado%20Basics/Run%20Simulation.md) +- [Руководство по поиску ошибок](Vivado%20Basics/Debug%20manual.md) +- [Руководство по прошивке ПЛИС](Vivado%20Basics/Program%20nexys%20a7.md) +- [Заголовочные файлы в Verilog](Vivado%20Basics/Verilog%20Header.md) +- [Как добавить файл, инициализирующий память](Vivado%20Basics/How%20to%20add%20a%20mem-file.md) diff --git a/.github/book.toml b/.github/book.toml new file mode 100644 index 00000000..5706bb7f --- /dev/null +++ b/.github/book.toml @@ -0,0 +1,6 @@ +[book] +authors = ["Andrei Solodovnikov"] +language = "ru" +multilingual = true +src = "src" +title = "Архитектуры процессорных систем" diff --git a/.github/prepare.sh b/.github/prepare.sh new file mode 100644 index 00000000..76fd1f4b --- /dev/null +++ b/.github/prepare.sh @@ -0,0 +1,5 @@ +#!/bin/bash + +mkdir src +cp .github/book.toml ./ +cp -R .github/SUMMARY.md .pic/ Basic\ Verilog\ structures/ Introduction/ Labs/ Vivado\ Basics/ src/ \ No newline at end of file diff --git a/.github/workflows/mdbook.yml b/.github/workflows/mdbook.yml new file mode 100644 index 00000000..36abf88f --- /dev/null +++ b/.github/workflows/mdbook.yml @@ -0,0 +1,62 @@ +# Sample workflow for building and deploying a mdBook site to GitHub Pages +# +# To get started with mdBook see: https://rust-lang.github.io/mdBook/index.html +# +name: Deploy mdBook site to Pages + +on: + # Runs on pushes targeting the default branch + push: + branches: ["master"] + + # Allows you to run this workflow manually from the Actions tab + workflow_dispatch: + +# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages +permissions: + contents: read + pages: write + id-token: write + +# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued. +# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete. +concurrency: + group: "pages" + cancel-in-progress: false + +jobs: + # Build job + build: + runs-on: ubuntu-latest + env: + MDBOOK_VERSION: 0.4.21 + steps: + - uses: actions/checkout@v3 + - name: Install mdBook + run: | + chmod +x .github/prepare.sh + .github/prepare.sh + curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf -y | sh + rustup update + cargo install --version ${MDBOOK_VERSION} mdbook + - name: Setup Pages + id: pages + uses: actions/configure-pages@v3 + - name: Build with mdBook + run: mdbook build + - name: Upload artifact + uses: actions/upload-pages-artifact@v2 + with: + path: ./book + + # Deployment job + deploy: + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + runs-on: ubuntu-latest + needs: build + steps: + - name: Deploy to GitHub Pages + id: deployment + uses: actions/deploy-pages@v2