快速上手指南

对于嵌入式开发者来说，能有易于上手的开发环境，简单操作的系统是能够节省很多时间的。玄铁处理器 linux 开发平台是基于 buildroot.org 构建的，帮助开发者快速构建玄铁 CPU Linux 学习和实验环境，快速集成开源组件。

玄铁 linux 开发平台融入代码仓库的动态 readme.txt 设计，将上手指引精确到每一个 config，逐行精简命令，一目了然（每一个步骤不超过 10 条命令，支持 'ctrl c' + 'ctrl v' 秒贴执行，极速上手）。

访问 https://github.com/c-sky/buildroot/releases 点击你目标 CPU 型号的 readme.txt 开始，在如下的演示环境动图中，最快用时不到15秒的时间，用户即可完成快速上手，进入qemu环境:

readme.txt 说明

readme.txt 是通过 sdk 针对每款配置生成的，精确指引用户快速上手对应配置，它分为以下段落:

(All is tested on 64bit-ubuntu 16.04)

环境说明，所有发布均使用 ubuntu 16.04 docker 环境进行，编译与测试。用户在自己环境中运行，可能会遇到缺少 wget, tar, 等基础程序和库的问题，请自行按提示安装对应程序包。如果不想逐个安装工具包，可以直接使用我们 CI 环境的 docker 镜像: 点此链接

Quick Start for qemu run

指导用户使用云端预先编译好的二进制程序，直接运行基于 Qemu 模拟器的 Linux 环境。脚本内容包含: 下载、解压、运行三个部分，用户可以直接复制，粘贴该段内容到 Host 终端中运行。具体参考 模拟器运行介绍

Build linux kernel

指导用户单独编译对应的内核源码，脚本从 kernel.org 上下载标准内核源码包，再打上我们的差异补丁（这样做是因为内核源码包太大，为了减少 CI 系统的存储负担，采用 patch 差异保存的方式）。该补丁包含了编译前的配置信息，使用后即可直接编译，确保生成镜像与 云端 CI 环境一致。

Build buildroot

指导用户编译制定版本，配置的 buildroot，也是云端 CI 环境使用的编译命令。虽然编译 buildroot 的步骤非常简单，但是由于要下载各个开源软件包，时间较长，同时对客户的网络环境有较高的要求。

Run with hardware

T-HEAD Linux 发布的代码和镜像有很强的适配性，同一个 Linux Image 通过配合不同的 dts 可以运行在不同的硬件平台上，包括 QEMU 模拟器也是一种硬件平台。具体参考 芯片板运行介绍

How to get dmesg without uart

在没有串口的情况下，我们依然可以调试 Linux，利用 Jtag 直接获取 dmesg 信息，只需 CPU + 内存，不借助其他外设

wget -nc https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/Documentation/admin-guide/kdump/gdbmacros.txt # 获取著名 kernel.org gdb 调试脚本

在 gdb 里加载 vmlinux 符号表，加载 gdbmacro.txt 脚本，运行 dmesg

file linux/vmlinux
file linux/Documentation/admin-guide/kdump/gdbmacros.txt
dmesg

gdbmacro.txt 还包含很多其他调试命令，请自行学习

Gitlab-CI url

提供了当前 readme.txt 对应的版本和配置的编译结果（云端 CI 存储的地址）。readme.txt 中 wget 的内容均来自于此，可以点击里面的 Download artifacts archive 一次性下载全部 artifacts.zip 包，解压后进入 artifacts 目录，此时粘贴复制 readme.txt 脚本，就不会再wget下载了。(wget 的参数 -nc 即 存在了就不再下载)

Versions

提供整体和各个模块的版本信息，buildroot SDK 内的所有组件的版本，均被 buildroot 顶层版本号冻结，确保版本可回溯。