misterkun/toolchain

ARMv7 C/C++ 工具链（适用于 MiSTer FPGA DE10-Nano）

本镜像为MiSTer FPGA（DE10-Nano）或其他ARMv7架构设备提供无摩擦的C/C++开发环境，通过Docker在x86/64平台运行ARM容器，避免手动处理交叉编译或修改Makefile的繁琐工作。

镜像压缩后大小为271.48 MB，加上基础层总磁盘占用约1.1GB。

Terasic DE10-Nano HPS（硬处理器系统）信息

环境变量已预设CFLAGS：-mcpu=cortex-a9 -mfloat-abi=hard -mtune=cortex-a9 -mfpu=neon。

在x86/x64平台运行ARM容器的方法

直接在x86/x64平台启动ARM容器会报错：

bash
exec user process caused "exec format error"

需先执行以下命令注册Qemu模拟器：

bash
docker run --rm --privileged hypriot/qemu-register

如何使用该镜像

Linux/Mac终端

bash
docker run -it --rm -v $(pwd):/mister misterkun/toolchain /bin/bash

Windows

Windows命令提示符（cmd）：

cmd
docker run -it --rm -v %cd%:/mister misterkun/toolchain /bin/bash

Windows PowerShell：

powershell
docker run -it --rm -v ${pwd}:/mister misterkun/toolchain /bin/bash

参数说明：

• -it：启用交互式终端
• --rm：容器退出后自动删除
• -v <路径>：将当前目录映射到容器内的/mister目录
• misterkun/toolchain：镜像名称
• /bin/bash：进入容器的bash终端

也可直接执行命令（无需进入容器）：

bash
docker run -it --rm -v ${pwd}:/mister misterkun/toolchain make

Windows共享驱动器问题

若出现以下错误：

text
Drive has not been shared.

需打开Docker设置，在“Shared Drives”中添加需共享的驱动器。

实用技巧：添加别名

Mac：编辑~/.bash_profile
Linux：编辑~/.profile或~/.bashrc
添加以下内容：

bash
alias mtc='f(){ docker run -it --rm -v "$(pwd)":/mister misterkun/toolchain "$@"; unset -f f; }; f'

Windows PowerShell：编辑${Home}\Documents\WindowsPowerShell\Profile.ps1
添加以下内容：

powershell
Function _mtc { docker run -it --rm -v ${pwd}:/mister misterkun/toolchain @Args }
Set-Alias -Name mtc -Value _mtc

之后可直接用mtc进入容器，或mtc make编译代码。

示例：编译Main_MiSTer

容器内已安装git，无需本地安装。

容器内操作

bash
# 创建目录并进入
mkdir Main_MiSTer && cd Main_MiSTer
# 进入容器
mtc
# 克隆代码
git clone https://github.com/MiSTer-devel/Main_MiSTer.git .
# 编译
make

容器外操作

bash
# 克隆代码
mtc git clone https://github.com/MiSTer-devel/Main_MiSTer.git
# 进入目录
cd Main_MiSTer
# 编译
mtc make

参考资料

• Cyclone V硬处理器系统技术参考手册
• NEON开发入门
• Cortex-A9 NEON技术参考手册
• ARM浮点编译选项解析
• PowerShell配置文件说明

镜像包含内容

源码/发行版包

系统包

问题反馈

请在https://github.com/misterkun-io/Toolchain_MiSTer/issues%E6%8F%90%E4%BA%A4%E9%97%AE%E9%A2%98%E3%80%82

许可协议

本镜像包含的软件可能受不同许可协议约束（如基础系统的Bash等）。使用镜像时，需确保符合所有包含软件的许可要求。