Introduction
? Step 1: Install Docker
? On Windows
-
Download Docker Desktop for Windows and install it.
-
Open Docker Desktop → Settings → make sure “Use the WSL2 backend” is enabled.
(On macOS or Linux, just install Docker using the official installer or your package manager.)
? Step 2: Run an Ubuntu Container
Open PowerShell or Terminal, then pull the Ubuntu image:
docker pull ubuntu:22.04
Start a new container and open a shell inside it:
docker run -it --name myubuntu ubuntu:22.04
Now you are inside the Ubuntu environment:
root@xxxxxxxx:/#
? Step 3: Install Applications
First, update package lists:
apt update
Example: Install basic tools
apt install -y vim git curl wget build-essential
Example: Install Python
apt install -y python3 python3-pip
Example: Install RISC-V or EDA tools
apt install -y gcc-riscv64-unknown-elf verilator make
? Step 4: Save Your Customized Image
When you finish installing tools, exit the container:
exit
Then save your current environment as a new Docker image:
docker commit myubuntu myubuntu:tools
Next time, you can start it directly:
docker run -it myubuntu:tools
? Step 5: Distribute the Environment (for a seminar)
To share your prepared environment with students:
docker save myubuntu:tools -o ubuntu_tools.tar
Each student can load it with:
docker load -i ubuntu_tools.tar
docker run -it myubuntu:tools
This ensures everyone has the same Ubuntu setup and tools.
✅ Summary
| Step | Description |
|---|---|
| 1 | Install Docker Desktop |
| 2 | Pull Ubuntu image (docker pull ubuntu:22.04) |
| 3 | Run it (docker run -it ubuntu:22.04) |
| 4 | Install tools using apt install |
| 5 | Save and share the image |
Would you like me to create a ready-to-use Dockerfile (so that the Ubuntu + tools image can be built automatically)?
It’s perfect for distributing in a seminar or class.
Introduction
This manual helps you get started with the software tools you need:
-
Ubuntu Linux – The operating system for the workshop environment
-
Docker – Runs a pre-configured development environment
-
Git – Version control for tracking changes
-
GitHub – Online platform to share and submit your work
-
RISC-V & FPGA Tools – Compilers, simulators, and synthesis tools
By following this manual, you can set up your environment, complete exercises, and submit your work safely.
Ubuntu Linux
Ubuntu is a free and open-source operating system based on Linux. It is widely used in programming, development, and scientific research. It provides a stable environment for software development. It works well with RISC-V compilers, simulators, and FPGA tools. Docker can run Ubuntu consistently on any PC, so every student has the same environment.
| Command | Purpose |
|---|---|
pwd |
Show current directory |
ls |
List files |
cd <folder> |
Change directory |
mkdir <name> |
Create folder |
rm <file> |
Delete file |
nano <file> |
Edit file in terminal |
Git
-
Set up Git (first time only):
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
-
Clone a repository from GitHub:
git clone https://github.com/kunieda-lab/riscv-edu.git
cd riscv-edu
-
Check status of your files:
git status
-
Add changes:
git add .
-
Commit changes:
git commit -m "Day 1 exercises completed"
-
Push changes to GitHub:
git push
GitHub
-
Repository: A folder stored online with your code and files
-
Branch: Version of your repository (usually
main) -
Pull: Download the latest updates from GitHub
-
Push: Upload your work to GitHub
Your instructor may give you a GitHub Classroom link to automatically create a personal repository.
Docker
Docker allows you to run the same environment on any PC.
1. Build Docker image (first time only):
sudo docker build -t riscv-edu:latest .
2. Run Docker container:
sudo docker run -it --name riscv-container riscv-edu:latest
-
You are now inside a pre-configured Ubuntu environment with all RISC-V tools installed.
-
The working folder is usually
/workspace.
3. Exit Docker:
exit
Design Tools
-
Navigate to examples:
cd /workspace/sample
-
Compile a RISC-V program:
make
./hello_riscv
-
FPGA synthesis and simulation:
yosys top.v
nextpnr-ice40 --hx8k --json top.json --asc top.asc
icepack top.asc top.bin
Your instructor will provide specific exercises and instructions for each tool.
Submitting Your Work
-
Add and commit your changes:
git add .
git commit -m "Exercise completed"
-
Push to GitHub (your repository will be linked via GitHub Classroom):
git push
-
Check online if your files appear and ask the instructor if there are problems.
8. Troubleshooting Tips
-
Command not found → Check spelling and whether you are in Docker
-
Permission denied → Add
sudobefore commands if necessary -
Git errors → Make sure your repository URL is correct and you have access
-
Docker build errors → Ensure you have a stable internet connection
9. Additional Notes
-
Always pull the latest version of the repository before starting exercises:
git pull
-
Save your work frequently and commit small changes to GitHub
-
Follow instructions from your instructor for FPGA hardware exercises
Notes
-
Command not found → Check spelling and whether you are in Docker
-
Permission denied → Add
sudobefore commands if necessary -
Git errors → Make sure your repository URL is correct and you have access
-
Docker build errors → Ensure you have a stable internet connection
-
Always pull the latest version of the repository before starting exercises:
git pull
-
Save your work frequently and commit small changes to GitHub
-
Follow instructions from your instructor for FPGA hardware exercises
支払後の入金確認までお待ち下さい。
①-1 料金支払い
民事意思能力鑑定
１．遺言執筆判断能力評価
２．認知機能評価(長谷川式）
３．認知機能評価(MMSE）
4．精神疾患有無判定
①-1 会員情報入力
会員アカウントを作成するために会員登録が必要です。
１．ユーザー名、Eメールでアカウント作成(パスワードが送付されます）
２．ユーザー名とパスワードでログイン。プロフィールの登録（下ボタンをクリック）を別頁で提出。
② 予約
担当する先生が選ばれ、予約可能日の日時の予約表が更新されます。
１．予約表のページで（以下のボタンをクリック）、予約日を選んでください。
２．１回目だけでなく、それ以降の予約をまとめて行っても構いません。
③ 相談スカイプ
予約した時間になりましたら、ビデオ通話スカイプのページ（以下のボタンをクリック）からスカイプを起動してください。
１．スマートフォンも可能です。パソコンではWebカメラや音声装置が必要です。
２．クラウド上のスカイプを使いますので、パソコンへのダウンロードは必要ありません。
