Initial commit

Author: Linyxus

.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

.gitignore

@@ -0,0 +1,273 @@
+## Core latex/pdflatex auxiliary files:
+*.aux
+*.lof
+*.log
+*.lot
+*.fls
+*.out
+*.toc
+*.fmt
+*.fot
+*.cb
+*.cb2
+.*.lb
+
+## Intermediate documents:
+*.dvi
+*.xdv
+*-converted-to.*
+# these rules might exclude image files for figures etc.
+# *.ps
+# *.eps
+# *.pdf
+
+## Generated if empty string is given at "Please type another file name for output:"
+.pdf
+
+## Bibliography auxiliary files (bibtex/biblatex/biber):
+*.bbl
+*.bcf
+*.blg
+*-blx.aux
+*-blx.bib
+*.run.xml
+
+## Build tool auxiliary files:
+*.fdb_latexmk
+*.synctex
+*.synctex(busy)
+*.synctex.gz
+*.synctex.gz(busy)
+*.pdfsync
+
+## Build tool directories for auxiliary files
+# latexrun
+latex.out/
+
+## Auxiliary and intermediate files from other packages:
+# algorithms
+*.alg
+*.loa
+
+# achemso
+acs-*.bib
+
+# amsthm
+*.thm
+
+# beamer
+*.nav
+*.pre
+*.snm
+*.vrb
+
+# changes
+*.soc
+
+# comment
+*.cut
+
+# cprotect
+*.cpt
+
+# elsarticle (documentclass of Elsevier journals)
+*.spl
+
+# endnotes
+*.ent
+
+# fixme
+*.lox
+
+# feynmf/feynmp
+*.mf
+*.mp
+*.t[1-9]
+*.t[1-9][0-9]
+*.tfm
+
+#(r)(e)ledmac/(r)(e)ledpar
+*.end
+*.?end
+*.[1-9]
+*.[1-9][0-9]
+*.[1-9][0-9][0-9]
+*.[1-9]R
+*.[1-9][0-9]R
+*.[1-9][0-9][0-9]R
+*.eledsec[1-9]
+*.eledsec[1-9]R
+*.eledsec[1-9][0-9]
+*.eledsec[1-9][0-9]R
+*.eledsec[1-9][0-9][0-9]
+*.eledsec[1-9][0-9][0-9]R
+
+# glossaries
+*.acn
+*.acr
+*.glg
+*.glo
+*.gls
+*.glsdefs
+*.lzo
+*.lzs
+
+# uncomment this for glossaries-extra (will ignore makeindex's style files!)
+# *.ist
+
+# gnuplottex
+*-gnuplottex-*
+
+# gregoriotex
+*.gaux
+*.gtex
+
+# htlatex
+*.4ct
+*.4tc
+*.idv
+*.lg
+*.trc
+*.xref
+
+# hyperref
+*.brf
+
+# knitr
+*-concordance.tex
+# TODO Comment the next line if you want to keep your tikz graphics files
+*.tikz
+*-tikzDictionary
+
+# listings
+*.lol
+
+# luatexja-ruby
+*.ltjruby
+
+# makeidx
+*.idx
+*.ilg
+*.ind
+
+# minitoc
+*.maf
+*.mlf
+*.mlt
+*.mtc[0-9]*
+*.slf[0-9]*
+*.slt[0-9]*
+*.stc[0-9]*
+
+# minted
+_minted*
+*.pyg
+
+# morewrites
+*.mw
+
+# nomencl
+*.nlg
+*.nlo
+*.nls
+
+# pax
+*.pax
+
+# pdfpcnotes
+*.pdfpc
+
+# sagetex
+*.sagetex.sage
+*.sagetex.py
+*.sagetex.scmd
+
+# scrwfile
+*.wrt
+
+# sympy
+*.sout
+*.sympy
+sympy-plots-for-*.tex/
+
+# pdfcomment
+*.upa
+*.upb
+
+# pythontex
+*.pytxcode
+pythontex-files-*/
+
+# tcolorbox
+*.listing
+
+# thmtools
+*.loe
+
+# TikZ & PGF
+*.dpth
+*.md5
+*.auxlock
+
+# todonotes
+*.tdo
+
+# vhistory
+*.hst
+*.ver
+
+# easy-todo
+*.lod
+
+# xcolor
+*.xcp
+
+# xmpincl
+*.xmpi
+
+# xindy
+*.xdy
+
+# xypic precompiled matrices and outlines
+*.xyc
+*.xyd
+
+# endfloat
+*.ttt
+*.fff
+
+# Latexian
+TSWLatexianTemp*
+
+## Editors:
+# WinEdt
+*.bak
+*.sav
+
+# Texpad
+.texpadtmp
+
+# LyX
+*.lyx~
+
+# Kile
+*.backup
+
+# gummi
+.*.swp
+
+# KBibTeX
+*~[0-9]*
+
+# auto folder when using emacs and auctex
+./auto/*
+*.el
+
+# expex forward references with \gathertags
+*-tags.tex
+
+# standalone packages
+*.sta
+
+# Makeindex log files
+*.lpz

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Yichen Xu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,2 @@
+# doc
+ Report and slides of EasterMIPS.

ack.tex

@@ -0,0 +1,14 @@
+\chapter{附录}
+
+\section{参考文献}
+MIPS® Architecture For Programmers Volume I-A: Introduction to the MIPS32 Architecture.rev3.02
+
+MIPS® Architecture For Programmers Volume II-A: The MIPS32® Instruction Set 
+
+MIPS® Architecture For Programmers Volume III: The MIPS32® and microMIPS32™ Privileged Resource Architecture 
+
+Xilinx IP:: AXI Crossbar (2.1) LogiCORE IP Product Guide
+
+\section{致谢}
+
+在\texttt{EasterMips}的开发过程中，我们获得了来自周峰老师的方向指导和服务器资源。他帮助我们指明了方向，并帮助我们解决了疫情导致的合作问题。同时我们还获得了于海鑫学长的诸多指点，他为我们的实现过程提供了巨大的帮助。最后还要感谢北邮人团队于校内提供的Git服务器，为我们进行构建调试带来便利。

ci.tex

@@ -0,0 +1,45 @@
+\hypertarget{ux5f00ux53d1ux652fux6301}{%
+\chapter{开发支持工具}\label{ux5f00ux53d1ux652fux6301}}
+
+在疫情期间，由于团队成员异地协作难度较高，经由指导老师的支持，我们完成了如下系统的构建。提升了协作效率。
+
+\hypertarget{ux81eaux52a8ux5316ux6784ux5efaux53caux6d4bux8bd5}{%
+\section{自动化构建及测试}\label{ux81eaux52a8ux5316ux6784ux5efaux53caux6d4bux8bd5}}
+
+得益于周老师提供的一台10核32G内存150G硬盘的服务器，及北邮人团队的校内Git服务器，参考并重写清华Nontrival-mips提供的自动构建脚本，通过在服务器上对\texttt{vivado}进行\texttt{docker}封装，我们成功建立校园环境内的自动构建服务器。
+该服务器可以完成如下功能：
+
+\begin{enumerate}
+\item
+  自动完成功能、性能、TLB测试的Simulation阶段
+\item
+  自动完成\texttt{func/perf\ bitstream}的构建，并上传到平台以供下载。
+\item
+  提供时序检查报告的下载。
+\end{enumerate}
+
+通过该自动构建服务器，帮助我们解决了远程协作时代码的有效性问题，减少了merge分支时带来的出错可能。
+
+\begin{figure}[ht]
+    \centering
+    \includegraphics[width=0.7\linewidth]{ci_usage.png}
+    \caption{CI使用情况}
+    \label{fig:ci-usage}
+\end{figure}
+
+\hypertarget{ux75abux60c5ux671fux95f4ux8fdcux7a0bux534fux4f5c}{%
+\section{疫情期间远程协作}\label{ux75abux60c5ux671fux95f4ux8fdcux7a0bux534fux4f5c}}
+
+在疫情期间，团队协作问题给我们的进展带来了很大的困扰。同时团队成员的电脑性能不足也令开发进度受到限制，运行测试时时间长和复现问题困难；还因为系统测试板仅有一块，在执行后续调试时问题较为繁多。
+为此，我们通过如下两种方法解决：
+
+\begin{enumerate}
+\item
+  通过在校内服务器上进行内网穿透并配置\texttt{VNC}远程桌面，进行远程编写。解决本地计算机性能不足和环境不同(macOS)的问题，节省调试时间并给本地留出更多的性能。
+\item
+  通过Teamviewer进行远程桌面，在调试系统测试的波形问题时，不需要频繁上传下载波形即完成。配合语音通话并进行同屏协作，调试效率大大提升，比单纯靠语音描述更加有效。
+\end{enumerate}
+
+整个开发过程中，我们一共进行了270余次提交，完成了194次有效的自动化构建，节省的总时长大约为230小时。
+
+在穿透时，我们选择仅支持\texttt{ssh\_public\_key}，设置不常用用户名来避免暴力破解，按需开启VNC功能，在方便了自身的同时确保校内网络安全。