epiceric/gcc-arm

GCC-ARM https://travis-ci.org/EpicEric/gcc-arm.svg?branch=master](https://travis-ci.org/EpicEric/gcc-arm) https://img.shields.io/docker/stars/epiceric/gcc-arm.svg](https://hub.docker.com/r/epiceric/gcc-arm/) https://img.shields.io/docker/pulls/epiceric/gcc-arm.svg](https://hub.docker.com/r/epiceric/gcc-arm/)

镜像概述

本Docker容器为巴西圣保罗大学（Poli-USP）PCS3732《处理器实验室》课程设计，基于Ubuntu 16.04镜像，提供适用于32位ARM架构的GCC编译器。包含基础文本编辑器、命令别名及Evaluator-7T开发板支持，方便课程实验中的代码编写、编译与调试。

核心功能

1. 提供ARM架构32位GCC编译工具链
2. 内置Vim、Less等文本编辑器（支持自定义替换）
3. 简化编译、调试命令的别名（如arm、gcc、gdb）
4. 支持Evaluator-7T开发板连接与调试
5. 兼容裸金属程序开发（使用arm-none-eabi工具链）

使用场景

• 处理器实验室课程的ARM程序开发与调试
• 32位ARM架构的裸金属程序实验
• Evaluator-7T开发板的硬件调试

配置说明

安装

有两种获取方式：

1. 从Docker Hub拉取：

   bash
   docker pull epiceric/gcc-arm
   

2. 从GitHub源码构建：

   bash
   git clone https://github.com/EpicEric/gcc-arm.git && cd gcc-arm && docker build -t epiceric/gcc-arm docker
   # 或使用脚本：
   ./build_docker.sh
   

运行

1. 启动交互式Bash shell：

   bash
   docker run --rm -ti -v "$PWD/src":/home/student/src epiceric/gcc-arm
   # 或使用脚本：
   ./run_docker.sh
   

2. 挂载自定义源码目录：

   bash
   ./run_docker.sh ~/path/to/custom_src
   # 或直接使用docker命令：
   docker run --rm -ti -v "$HOME/path/to/custom_src":/home/student/src epiceric/gcc-arm
   

3. 退出容器：按Ctrl-D

常用命令

• 文本编辑：
  • less：查看文件内容
  • vim：编辑文件（可通过构建参数替换为其他编辑器，如emacs或nano）
• 编译与调试：
  • arm main.c：将C文件编译为ARM汇编（别名：arm-elf-gcc -S main.c）
  • gcc -o main main.s：将汇编文件编译为可执行文件（别名：arm-elf-gcc -Wall -g -o main main.s）
  • gdb main：启动GDB调试（带TUI界面，别名：arm-elf-gdb -tui --command=/home/student/.gdbinit/default main）

高级配置

Windows环境运行

注意：仅支持常规命令行（不支持PowerShell），需添加-e TERM参数并使用Linux风格路径：

bash
docker run --rm -ti -v "/c/Users/yourname/path/to/custom_src":/home/student/src -e TERM epiceric/gcc-arm

连接Evaluator-7T开发板

1. 连接开发板到USB端口，识别主机设备（如/dev/ttyUSB0）
2. 运行容器并映射设备：

   bash
   ./run_docker.sh ~/path/to/custom_src /dev/ttyUSB0
   # 或直接使用docker命令：
   docker run --rm -ti -v "$HOME/path/to/custom_src":/home/student/src --device=/dev/ttyUSB0:/dev/ttyS0 epiceric/gcc-arm
   

3. 使用e7t main替代gdb main进行调试（配置文件为.gdbinit/evaluator7t）

裸金属程序开发（arm-none-eabi）

使用Sourcery CodeBench Lite工具链构建裸金属程序：

bash
# 编译示例
eabi-gcc c_entry.c -o c_entry.o
eabi-as startup.s -o startup.o
eabi-ld -T vector_table.ld c_entry.o startup.o -o program.elf
eabi-gdb program.elf