A20 DragonBoard使用说明书.docx
《A20 DragonBoard使用说明书.docx》由会员分享，可在线阅读，更多相关《A20 DragonBoard使用说明书.docx（19页珍藏版）》请在冰豆网上搜索。
A20DragonBoard使用说明书
A20DragonBoard使用说明书
V1.0
2013-03-30
RevisionHistory
Version
Date
Author
Changescomparedtopreviousissue
V1.0
2013-03-30
Martin_zheng
Create
目录
1.前言3
1.1简介3
1.2测试时间3
1.3目的3
1.4名词解释3
1.5参考文档3
2.使用入门4
2.1编译内核4
2.2配置测试项目4
2.3打包固件5
2.4烧写固件5
2.5启动系统5
3.测试流程6
4.配置文件8
4.1配置文件格式限制8
4.2模块配置示例8
4.3DRAM配置9
4.4RTC配置9
4.5WIFI配置9
4.6G-Sensor配置10
4.7Nand配置10
4.8MMC配置10
4.9UDisk配置11
4.10Usb_HOST1配置11
4.11Usb_HOST2配置11
4.12Usb_OTG配置11
4.13HDMI配置11
4.14Key配置12
4.15IR配置12
4.16MIC配置13
4.17TP配置13
4.18Camera配置14
4.19界面配置14
5.FAQs18
5.1为系统启动后会进入TP校准界面？
18
5.2如何添加新的方案？
18
5.3为什么录音测试没有声音输出？
18
5.4如何关闭内核的打印？
18
Declaration19
1.前言
2.简介
DragonBoard是一个基于LinuxBSP，集成了DirectFB的图形化板卡测试系统。
该系统旨在检测板卡能否在特定的环境中正常工作。
DragonBoard测试系统的固件可以直接烧录到板卡上，同时，也支持卡启动，减少对PC的依赖。
DragonBoard测试系统的测试流程分为两个部分：
自动测试和手动测试。
自动测试包括内存、时钟、WIFI、重力传感器等；手动测试包括SD卡、U盘、HDMI、按键、红外、录音耳机和触摸等等。
系统上电运行后会自动加载、运行用户启用的测试用例，并将结果显示到界面，用户可从中看到哪些测试项通过，哪些失败。
3.测试时间
DragonBoard测试系统完成一张板卡测试所需的时间具有一定的浮动性，主要受以下几个方面影响：
●主频和DDR频率；
●测试项数量；
●测试流水线和工人的熟练程度；
主频和DDR频率决定了系统的运行速度，越高的频率测试程序运行的越快，所需的时间就越短；测试项数量会影响系统负荷和工人操作时间；另外测试流水线设置是否合理以及工人的熟练程度也直接影响测试时间。
4.目的
本文档主要向用户阐述在A20平台上DragonBoard测试系统的使用方法。
5.名词解释
6.参考文档
7.使用入门
由于DragonBoard测试系统基于LinuxBSP，因此需要待测试平台的LinuxBSP，即Linux内核。
系统默认使用Android的Linux内核。
DragonBoard测试系统的源码位于buildroot/target/dragonboard目录下面，A20SDK默认包含了dragonboard，编译内核时会自动编译这些源码，并生成所需的测试用例。
8.编译内核
在lichee根目录下执行下面的命令，编译一个供DragonBoard使用的内核，这个内核和Android的Linux内核使用相同的配置：
$./build.sh–psun7i_dragonboard
编译完内核后自动编译DragonBoard测试系统，并生成rootfs.ext4，位于out/dragonboard目录下面。
rootfs.ext4包含了一个根文件系统，里面有驱动模块文件，位于/lib/modules/3.3.0目录下面，还有dragonboard测试用例和数据，位于/dragonboard目录下面。
注意：
虽然在量产阶段，卡启动是最好的选择，但是在开发阶段使用flash启动开发更加方便、快捷。
如果客户使用flash启动来开发，建议关闭flash的读写测试。
因为flash的读写测试是针对nanda这个分区，这个分区默认做为了bootloader分区，这个分区中存放了boot相关的代码，flash测试的代码会破坏这个分区中的文件，从而导致下次开机的时候运行到boot1阶段会不能正常加载boot.axf这个文件，以至于不能正常启动。
9.配置测试项目
DragonBoard测试系统提供了一个灵活的配置脚本test_config.fex，方便用户定制自己的测试项目，从而提高系统的效率。
test_config.fex能够完成以下基本工作：
1.修改界面的语言和颜色
2.启动或者禁用某个测试项目
3.修改测试项目的参数
测试项目的各项配置说明详见第4节配置文件。
10.打包固件
打包使用下面命令：
$./build.shpack_dragonboard
1.选择芯片平台
StartpackingforLicheesystem
Allvalidchips:
0.sun7i
Pleaseselectachip:
2.选择dragonboard
Allvalidplatforms:
0.android
1.dragonboard
2.linux
3.选择方案
Allvalidboards:
0.wing-evb-v10
Pleaseselectaboard:
11.烧写固件
1.Nand启动
使用PhoenixSuit烧写固件。
2.SD卡启动
使用PhoenixCard3.09或更新的工具烧写固件,用于在PC制作启动卡。
12.启动系统
1.Nand启动
2.SD卡启动
上电前请先将SD卡插入板卡卡槽。
13.测试流程
板卡上电之后系统自动启动，测试程序依照test_config.fex配置依次加载，并显示主界面。
根据配置的不同，主界面的布局也将不同。
当进入主界面之后，用户即看到各个测试项目的状态。
这些测试项目被分为两组：
自动测试项和手动测试项。
自动测试项整个测试过程自动完成，无需用户干预，测试通过测试项目描成蓝色，测试失败测试项目描成红色。
手动测试项需要用户参与。
其中带wifi测试与mic测试与camera测试的主界面如下图所示：
1.SD卡
用户插入一张SD卡等待3秒，如果成功会在界面显示容量并且测试项目变成蓝色，否则测试项目变成红色。
2.U盘
用户插入一个U盘等待3秒，如果成功会在界面显示容量并且测试项目变成蓝色，否则测试项目变成红色。
3.HDMI
对于pad,等带lcd的产品，如果用户配置到lcd输出，则在用户插入HDMI后等待3秒，
HDMI会输出ColorBar和一段音乐。
如果成功测试项目变成蓝色，否则测试项目变成红色。
对于hdmidongle,homelet这种不带LCD的产品，如果用户配置到HDMI输出，则HDMI会输出整个dragonboard的UI界面。
如果用户没有配置mic录音的话，HDMI会输出一段音乐。
否则会把mic的录音输出到HDMI音频上。
4.按键
界面会显示用户按下的按键。
如果成功测试项目变成蓝色，否则测试项目变成红色。
5.红外
界面会显示用户按下的按键。
如果成功测试项目变成蓝色，否则测试项目变成红色。
6.录音耳机
根据用户配置，如果用户需要在mic录音前播放一段音乐到耳机口，则会先播放音乐，到用户配置的规定时间后音乐会停止。
录音程序会在延时5秒后（默认值）开始录音，对于pad产品，用户可以插入耳机测试耳机输出是否正常，同时也可判断Speaker是否正常。
对于HDMI输出的产品，录音会出从HDMI输出。
在录音的同时，UI上会动态直观的显示录音的能量条。
7.触摸
用户可以通过触摸屏幕来检测触摸屏的好坏。
屏幕会显示用户划过的轨迹，用户可以借此来判断屏幕好坏。
如需清除轨迹，请按正上方的清屏按钮。
8．网络
Dragonboard会扫描wifi热点，并把扫描到的热点显示到UI上。
而且所有的热点按信号强度依次显示。
同时也会显示出信号的DB值和信号强度能量条。
信号强度大于60db的为能量条为绿色，表示信号强度较好。
信号强度小于60db的能量条为红色，表于信号强度较差。
14.配置文件
DragonBoard板卡测试系统提供了一个灵活的配置脚本test_config.fex，位于/tools/pack/chips/sun7i/configs/dragonboard/{方案目录}，方便用户定制自己的测试项目，从而提高系统的效率。
配置文件可以完成以下工作：
1.修改界面的语言和颜色
2.启用或者禁用某个测试项目
3.修改测试项目的参数
该脚本使用ini文件格式，由段、键和值三者组成，通常一个段表示一个模块配置。
目前要求该配置文件使用UTF-8编码，其他编码格式可能会导致未知错误，这点后续会改善。
15.配置文件格式限制
16.模块配置示例
测试模块配置示例：
[example]
display_name="Example"
activated=1
program="example.sh"
category=0
run_type=1
1.[example]
[example]表示一个模块配置example。
2.display_name
当前测试模块显示到界面的名称，字符串类型，最多可容纳64个字节。
如果为空，测试程序不会运行。
如需显示双引号，使用下面语法：
display_name=string:
"Example"
如果模块显示的名称需要不同的语言支持，修改display_name字段即可。
3.activated
0：
不测试该模块。
1：
测试该模块。
如果用户的方案不需要测试当前模块，请将该项置0；否则，请将该项置1。
4.program
模块的测试程序，字符串类型，最多可容纳16个字节。
5.category
0：
自动测试模块
1：
手动测试模块
6.run_type
0：
等待当前模块的测试程序执行完毕再运行下一个模块的测试程序
1：
不等待当前模块的测试程序执行完毕
一般为了提高整体的测试速度，对于耗时较长的测试程序建议填0，反之填1。
注意，当category=1，即手动测试模块时，该项无效。
因为手动测试模块会阻止其他测试模块加载，系统可能无法继续加载其他测试模块。
17.DRAM配置
内存测试配置。
[dram]
display_name="内存"
activated=1
program="memtester.sh"
category=0
run_type=1
dram_size=2048
test_size=8
dram_size:
板卡上使用了多大的dram，以MB为单位，在dram测试之初，程序会去检测板卡上dram的实际容量，如果小于配置容量，则说明贴片存在问题，测试不通过。
test_size：
使用多大的容量测试DRAM的性能，单位是MB，默认使用8M。
实际如果需要测出DRAM的性能，需要设定较大的容量，但是这样耗时较长，因此需要用户折中选择一个合适的值。
8M大概可以在30秒以内完成DRAM性能测试。
18.RTC配置
时钟测试配置。
[rtc]
display_name="时钟"
activated=1
program="rtctester.sh"
category=0
run_type=1
19.WIFI配置
WIFI测试配置。
[wifi]
display_name="网络"
activated=0
program="wifitester.sh"
category=0
run_type=1
module_path="/system/vendor/modules/ar6302.ko"
module_args="fwpath=/system/vendor/modules/"
module_path：
需要加载的模块全路径，DragonBoard测试系统将模块文件放在/lib/modules/3.3.0/目录下，并且创建了一个/system/vendor/modules，解决部分wifi驱动下载固件失败的问题。
module_args：
模块的参数。
20.G-Sensor配置
重力感应器测试配置。
[gsensor]
display_name="重力感应器"
activated=1
program="gsensortester.sh"
category=0
run_type=1
module_count=1
module1_path="/system/vendor/modules/bma250.ko"
device_name="bma250"
module_count：
需要加载的模块数量。
modulex_path：
需要加载的模块全路径，“x”表示每几个需要加载的模块，从1开始。
device_name：
G-Sensor设备的名称。
21.Nand配置
闪存测试配置。
[nand]
display_name="闪存"
activated=0
program="nandtester.sh"
category=0
run_type=0
test_size=128
test_size：
测试nand读写的大小。
nand方案请禁用nand测试。
22.MMC配置
SD卡测试配置。
[mmc]
display_name="SD卡"
activated=1
program="mmctester.sh"
category=1
run_type=1
卡启动方案请禁用mmc测试。
23.UDisk配置
U盘测试配置。
[udisk]
display_name="U盘"
activated=1
program="udisktester.sh"
category=1
run_type=1
24.Usb_HOST1配置
读出连接到host1的设备的PID,VID到UI。
[Usb_HOST1]
display_name="USB主机1"
activated=1
program="host1tester.sh"
category=1
run_type=1
25.Usb_HOST2配置
读出连接到host2的设备的PID,VID到UI。
[Usb_HOST2]
display_name="USB主机2"
activated=1
program="host2tester.sh"
category=1
run_type=1
26.Usb_OTG配置
读出连接到otg的设备的PID,VID到UI。
[Usb_OTG]
display_name="USB_OTG"
activated=1
program="otgtester.sh"
category=1
run_type=1
27.HDMI配置
[hdmi]
display_name="HDMI"
activated=1
program="hdmitester"
category=1
run_type=1
sound_file="/dragonboard/data/test48000.pcm"
samplerate=48000
support_mode=2
sound_file：
向HDMI播放的音乐文件全路径。
samplerate：
音乐的采样率。
support_mode：
设置HDMI输出模块，默认优先输出1080p，720p，如果两者都不支持，这个配置才会生效。
支持以下输出模式。
;support_mode
;0:
480I
;1:
576I
;2:
480P
;3:
576P
;4:
720P50HZ
;5:
720P60HZ
;6:
1080I50HZ
;7:
1080I60HZ
;8:
1080P24HZ
;9:
1080P50HZ
;10:
1080P60HZ
28.Key配置
按键测试配置。
[key]
display_name="按键"
activated=1
program="keytester"
category=1
run_type=1
29.IR配置
红外测试配置。
[ir]
display_name="红外"
activated=1
program="irtester"
category=1
run_type=1
module_path="/system/vendor/modules/sun7i-ir.ko"
module_path：
需要加载的模块全路径。
30.MIC配置
录音耳机测试配置。
[mic]
display_name="录音耳机"
activated=1
program="mictester"
category=1
run_type=1
delay=5
volume=40
music_playtime=10
sound_file="/dragonboard/data/test48000.pcm"
samplerate=48000
mic1_used=1
mic2_used=1
mic1_gain=1
mic2_gain=1
mic1_threshold=16383
mic2_threshold=16383
delay：
录音前的延时。
volume：
耳机、喇叭初始输出音量。
最大值为63.
music_playtime：
录音前音乐播放时间。
sound_file：
要播放音乐文件的路径。
samplerate：
要播放音乐文件的采样率。
mic1_used：
是否测试mic1
mic2_used:
是否测试mic2
mic1_gain:
mic1前级放大增益。
mic2_gain:
mic2前级放大增益。
mic1_threshold：
mic2测试通过振幅阀值，最大值为32767
mic2_threshold：
mic2测试通过振幅阀值,最大值为32767
31.TP配置
触摸测试配置。
[tp]
display_name="触摸"
type=1
module_path="/system/vendor/modules/gt82x.ko"
type：
触摸屏的类型，0表示电阻屏，1表示电容屏。
电阻屏在系统启动后会运行TP校准的程序，只有通过调屏程序才会进入dragonboard界面。
module_path：
需要加载的模块全路径。
32.Camera配置
摄像头测试配置。
[camera]
activated=1
module_count=4
module1_path="/system/vendor/modules/videobuf-core.ko"
module2_path="/system/vendor/modules/videobuf-dma-contig.ko"
module3_path="/system/vendor/modules/gc0308.ko"
module4_path="/system/vendor/modules/sunxi_csi0.ko"
dev_cnt=1
csi_cnt=1
fps=30
module_count：
需要加载的模块总数。
modulex_path：
“x”表示第几个需要加载的模块，从1开始。
dev_cnt：
设置摄相头个数。
csi_cnt：
设置csi通路，一般情况下是一路csi拖两个摄相头；如果两路csi各拖一个摄相头，则设成2。
fps：
帧率。
33.界面配置
;-------------------------------------------------------------------------------
;manual_menu_name
;manualtestcasemenuname,32bytes.
;auto_menu_name
;autotestcasemenuname,32bytes.
;clear_button_name
;clearscreenbuttonname,8bytes.
;font_size
;testcasefontdisplaysize,validvalue:
20pixel（default）,24pixel.
;height_adjust
;adjustheightofmanualtestcaseandautotestcase.
;
;ColorIndex
;0:
White
;1:
Yellow
;2:
Green
;3:
Cyan
;4:
Magenta
;5:
Red
;6:
Blue
;7:
Black
;8:
Beauty
;menu_bgcolor
;Thebackgroundcolorindexoftestcasecategorymenu.
;menu_fgcolor
;Theforegroundcolorindexoftestcasecategorymenu.
;item_init_bgcolor
;Thebackgroundcolorindexoftestcaseiteminitstatus.
;item_init_fgcolor
;Theforegroundcolorindexoftestcaseiteminitstatus.
;item_ok_bgcolor
;ThebackgroundcolorindexoftestcaseitemOKstatus.
;item_ok_fgcolor
;TheforegroundcolorindexoftestcaseitemOKstatus.
;item_fail_bgcolor
;Thebackgroundcolorindexoftestcaseitemfailstatus.
;item_fail_fgcolor
;Theforegroundcolorindexoftestcaseitemfailstatus.
;
;pass_str
;Thestringdisplayafterte
升级会员 