SmartAudio/docs/Tina Linux quick start guid...

296 lines
14 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

###Tina Linux快速入门指南 V2.0
* 适用范围Tina Linux SDK V2.0版本
* 更新日期2017年3月27日
***
[TOC]
####***一. 开发流程***
1. 构建linux系统编译环境软件和硬件
2. 下载R40 Tina Linux软件包
3. 对下载的软件包进行配置、编译和打包
4. 使用LiveSuit烧写固件minicom进行实时观察
***具体过程***
1. 构建linux系统编译环境
(1) 硬件资源
* R40系列开发板一块
* 电源线、usb转串口线、micro-usb下载线
* pc和编译服务器
(2) 软件资源
* 编译使用Ubuntu14.04系统
* 需要安装的软件包如下gcc, binutils, bzip2, flex, python,perl, make,ia32-libs, find, grep, diff, unzip, gawk,getopt, subversion, libz-dev and libc headers.ubuntu,可使用如下的命令直接安装相关软件包sudo apt-get install build-essential subversion git-core libncurses5-dev zlib1g-dev gawk flex quilt libssl-dev xsltproc libxml-parser-perl mercurial bzr ecj cvs unzip ia32-libs
* LiveSuit和minicomLiveSuit用于把固件烧写到开发板,通过minicom进行烧写过程中观察和后续使用LiveSuit见http://www.everything.pld1.local/C%3A/users/pld/%E6%A1%8C%E9%9D%A2/pld-know/3_%E5%B8%B8%E7%94%A8%E8%BD%AF%E4%BB%B6/7_%E8%87%AA%E5%8A%A8%E5%AE%89%E8%A3%85/auto_install_for_x64/LiveSuit )
2. 下载R40 Tina Linux软件包
* 下载repo并将其放到/usr/bin目录下见Repo_Guide.md)
* 进入home目录执行以下指令
* $ mkdir -p workspace/tina
* $ cd workspace/tina
* $ repo init -u http://gerrit.allwinnertech.com:8081/product/tina/manifest.git -b tina-dev -m default.xml
* $ repo sync
* $ repo start tina-dev --all
3. 对下载的软件包进行配置、编译和打包
* 进入到/home/workspace/tina目录执行以下指令
* $ source build/envsetup.sh
* $ lunch azalea_m2ultra-tina
* $ make -j2
* $ pack -d
* 编译完成后系统镜像会自动打包在tina/out/< board >/目录下
4. 使用LiveSuit烧写固件minicom进行实时观察
* 将开发板和PC进行正确连接
* 启动LiveSuit选择需要下载的固件
* 启动minicom进行配置端口ttyUSB0、波特率115200 8N1、连接类型serial、 Hardware Flow Control 设 为 NO)
* 按下开发板上uboot按键不要松开再按一下reset按键PC机上会提示是否格式化数据分区选择Yes或No都可以。然后其自动烧写镜像到开发板在minicom上可以看到具体过程等待烧写完成
####***二. Tina Linux Sdk目录结构***
Tina Linux SDK主要由构建系统、配置工具、工具链、host工具包、目标机功能包、文档、脚本、linux内核、bootloader组成。
[点击查看Tina结构图](https://www.processon.com/view/link/58d86685e4b03e064c7b8c34)
Tina/
├── build
├── config
├── Config.in
├── dl
├── docs
├── lichee
├── Makefile
├── out
├── package
├── rules.mk
├── scripts
├── target
├── tmp
├── toolchain
└── tools
- build 目录
主要由一系列.mk文件组成它们是基于Makefile规格编写而成。主要功能有
- 检测当前的编译环境是否满足Tina linux的构建需求
- 生成host包编译规格
- 生成工具链的编译规则
- 生成target包的编译规则
- 生成linux kernel的编译规则
- 生成系统固件的生成规格
- config 目录
config/
├── Config-build.in
├── Config-devel.in
├── Config-images.in
├── Config-kernel.in
└── top_config.in
这里存放的都是用于菜单配置项的.in文件当执行make menuconfig时发挥作用。这里简单介绍所有调用到的.in文件仅供参考
[点击查看.in目录结构](https://www.processon.com/view/link/58d86b46e4b04583185077cb)
- top_config.in: 可视化配置主界面调用其他config目录下的.in文件初始化配置选项用到了source命令
- Config-xxx.in: 各种可视化界面中的编译选项含default值
- tmp/.config-package.in: 各种包支持,包含固件生成,文件系统,各种服务等
- target/Config.in: 调用tmp/.config-target.in并配置硬件特性
- toolchain/Config.in: 优化相关选项target optionupdate toolchain
- tmp/.config-target.in: 开发板相关选项,系统相关选项
- target/imagebuilder/Config.in: 建立OpenWRT Image包含package文件
- target/sdk/Config.in: 建立OpenWRT SDK
- target/toolchain/Config.in: 打包OpenWRT 基础工具链
- docs 目录
docs/
├── build.md
├── config.md
├── init-scripts.md
├── Makefile
├── network.md
├── tina.md
├── wireless.md
└── working.md
存放用于开发的文档以markdown格式编写。后续不断完善。
- lichee 目录
lichee/
├── brandy
│ ├── add_hash
│ ├── add_hash.sh
│ ├── arm-trusted-firmware-1.0
│ ├── armv8_toolchain
│ ├── basic_loader
│ ├── build.sh
│ ├── extern-libs
│ ├── gcc-linaro
│ ├── pack_tools
│ ├── toolchain
│ ├── u-boot-2011.09
│ └── u-boot-2014.07
├── linux-3.10
└── linux-3.4
其中brandy目录用于存放bootloader,其中u-boot-2011.09用于存放R8/R16/R58的bootloaderu-boot-2014.07用于存放R18/R40的bootloaderlinux-3.10是R18/R40使用的内核源码目录linux-3.4是R8/R16/R58使用的内核源码目录。
- package 目录
package/
├── base-files
├── devel
├── firmware
├── kernel
├── libs
├── Makefile
├── network
├── system
└── utils
package 目录用于存放target机器上的软件包的源码和编译规格目录按照目标软件包的功能进行分类。
- scripts 目录
scripts 目录用于存放pc端或者小机端使用的一些脚本
- target 目录
target/
├── allwinner
├── Config.in
├── imagebuilder
├── Makefile
├── sdk
└── toolchain
用于存放目标板相关的配置以及sdk和toolchain生成的规格
- toolchain目录
toolchain/
├── binutils
├── Config.in
├── fortify-headers
├── gcc
├── gdb
├── glibc
├── info.mk
├── insight
├── kernel-headers
├── Makefile
├── musl
└── wrapper
其中gcc目录为gcc编译器的编译规则目录gdb为cc++调试器编译规则目录glibc目前没有启用默认使用的是musl下的musl-libc
- tools 目录
tools目录下存放的是host端工具的编译规则
- Makefile 结构
最后整理一下Makefile的结构仅供参考
[Tina Makefile](https://www.processon.com/view/link/58d88239e4b03eea78334943)
####***三. 编译系统的内部工作原理之构建系统工作流程***
![](http://p1.bqimg.com/567571/743537a96715fa38.png)
####***四. Tina系统的 makefile简要分析***
* ***Tina - Makefile结构图***
![](https://www.processon.com/chart_image/58d8aebee4b045831853d0c0.png)
**顶层Makefile** 里面只include了build/main.mk文件
**Build/main.mk**
- 为Openwrt检查tina目录此目录不能包含空格。
- Include了build/host.mk
- 检查Openwrt是否安装
- 包含rules.mk build/depends.mk target/Makefile package/Makefile tools/Makefile等Makefile文件
**Build/host.mk**识别主机所使用工具链选项主机的系统主机构架主机名字等并在临时目录tmp下生成tmp/.host.mk 。tmp/host.mk里如下
- HOST_OS:=Linux
- HOST_ARCH:=x86_64
- GNU_HOST_NAME:=x86_64-linux-gnu
- FIND_L=find -L $(1)
**rules.mk : ** 里面定义了主机和目标机中软件工具包的配置规则
**build/depends.mk : **里面定义了子树上的依赖关系
**build/subdir.mk : **主要包含了subdir和stampfile函数
**target/Makefile ** 定义生成目标机软件工具包的生成规格
**package/Makefile : ** 利用源码生成软件包
**tools/Makefile : ** 定义生成主机端工具编译规则,编译时获取和编译这些工具
**toolchain/Makefile : ** 利用工具链源码生成工具链
####***五. adb简介和使用***
#####5.1 adb简介
* adb全称Android Debug Bridge对于PC和手机.平板.开发板之间起到调试桥的作用。借助adb工具 我们可以对设备进行管理还可以进行很多操作比如运行shell命令,向开发板发送文件等。
#####5.2 adb的安装和配置
* adb的安装
* $sudo apt-get install android-tools-adb
* adb的配置
1. 将开发板和电脑正确链接启动minicom或putty要在minicom终端里看见开发板里系统正常启动并进入shell如果没有烧写Tina系统到开发板请先烧写系统
2. 打开电脑上的终端运行命令lsusb查看设备找到电脑和开发板相连接的串口如下
![](http://i1.piimg.com/567571/360cae93370f3f4f.png)
具体看自己的电脑也可以先拔下插在电脑上的串口USB在电脑上使用lsusb命令查看设备然后再插上串口再使用lsusb命令查看设备对比前后两次命令列出列表的不同定位到设备
3. 使用命令 sudo vim /etc/udev/rules.d/50-android.rules 打开电脑上的50-android.rules文件如果没有就创建一个进行配置这样电脑就能识别到此串口。具体配置如下(即在此文件里写入)
![](http://i4.buimg.com/567571/2902b8a93c751d3c.png)
SUBSYSTEM选项不变,ATTR{idVendor}选项中填写设备ID设备ID见上图根据自己设备填写,ATTR{idProduct}填写设备产品ID设备产品ID见上图MODE选项不变。保存退出。然后运行以下命令
- sudo chmod a+rx /etc/udev/rules.d/50-android.rules
- sudo /etc/init.d/udev restart
4. $sudo vim ~/.android/adb_usb.ini,打开adb_usb.ini文件向里面写入0x067b(设备ID)
5. 打开minicom在shell里输入adbd命令确保开发板里的adb服务正常若出现错误则不能使用。然后在电脑端的运行以下命令
- sudo adb kill-server
- sudo adb start-server
- adb devices
运行完成之后即可看见设备清单,如下:![](http://i4.buimg.com/567571/753ec38177efd46d.png)
#####5.3 adb的使用
* adb的主要命令如下
#####**adb devices**
- 说明:查看当前连接的设备, 连接到计算机的设备或者模拟器将会列出显示
- adb start-server
- 说明启动adb
#####adb kill-server
- 说明关闭adb
#####adb shell
- 说明这个命令将登录设备的shell, 后面加直接运行设备命令, 相当于执行远程命令
#####adb push
- 说明:此命令可以把电脑上的文件复制到开发板上
- 举例: adb push hello.c /tmp/ 这样就把电脑上的hello.c文件复制到了开发板上的/tmp目录下
#####adb pull
- 说明:此命令可以把开发板上的文件复制到电脑上
- 举例: adb pull /tmp/hello.c ./ 将开发板上/tmp目录下的文件hello.c复制到当前目录
#####adb version
- 说明查看adb的版本
#####adb help
- 说明adb的帮助有关更多命令详情请使用adb help命令查看
####***六. 编写程序在开发板上运行***
#####6.1 准备:
- 首先将开发软件的工具链的所在目录添加进环境变量里。对于Tina系统来说其arm工具链在tina/prebuilt/gcc/linux-x86/arm/toolchain-sunxi/toolchain/bin目录下。然后在自己的用户目录下打开.bashrc文件在这个文件的最后面添加一句话如下
export PATH=$PATH:/home/xxxxx/tina/prebuilt/gcc/linux-x86/arm/toolchain-sunxi/toolchain/bin
保存后退出然后注销系统重新登录。登录之后在终端里输入命令env查看一下PATH变量里是否包含此目录若包含则添加成功。
#####6.2 应用程序:
1. 编写一个简单的hello world程序
2. 用交叉工具链里的arm-openwrt-linux-gcc对其进行编译
3. 通过adb下载到开发板上然后运行
#####6.3 驱动程序:
######6.3.1 动态加载驱动程序
1. 编写一个驱动模块,其内容如下:
![](http://i2.buimg.com/567571/7caa6a0a55430e99.png)
2. 编写相应的Makefile其内容如下
![](http://i1.piimg.com/567571/75aba60817c3372d.png)
3. 执行make,将会产生hello.ko文件
4. 将hello.ko文件通过adb下载到开发板上
5. 执行以下命令进行加载,查看和卸载
- $insmod hello.ko
- $lsmod
- rmmod hello
######6.3.2 静态加载驱动程序
1. 在tina/lichee/linux-3.10/drivers/char/目录下创建一个hello目录
2. cd hello然后编写一个驱动模块其内容和上面一样。
3. 创建一个Makefile文件向里面写入如下内容保存退出
![](http://i4.buimg.com/567571/9f61625e7784171e.png)
4. 创建一个Kconfig文件向里面写入如下内容保存退出
![](http://i1.piimg.com/567571/430ffd73363e73c1.png)
5. cd ../进入到char目录里打开Makefile向里面添加如下内容保存退出
![](http://i4.buimg.com/567571/3b959db9bc4dddd4.png)
6. 同样在char目录下打开Kconfig文件向里面添加如下内容
![](http://i2.buimg.com/567571/6d4d758d19dfa779.png)
7. 进入到tina/target/allwinner/< board >/目录下打开modules.mk文件向里面写入如下内容保存退出
![](http://i4.buimg.com/567571/3e063d821a10d8f2.png)
8. 在同样的目录下打开deconfig文件向里面写入如下内容保存退出
![](http://i2.buimg.com/567571/2e648708f61db358.png)
9. 然后回退到linux-3.10目录下输入命令make menuconfig选中Device Drivers--->Character devices--->hello test driver确保其选项为M若不是M则按空格键选择为M保存退出
10. 回到tina目录下重新编译打包
11. 用LiveSuit下载打包后的镜像到开发板通过minicom进入到开发板的终端
12. 使用命令lsmod查看是否有hello模块若没有则执行insmod hello.ko命令安装驱动