A20 DragonBoard使用说明书.docx

1、A20 DragonBoard使用说明书A20 DragonBoard使用说明书V1.02013-03-30Revision HistoryVersionDateAuthorChanges compared to previous issueV1.02013-03-30Martin_zhengCreate目录1. 前言 31.1 简介 31.2 测试时间 31.3 目的 31.4 名词解释 31.5 参考文档 32. 使用入门 42.1 编译内核 42.2 配置测试项目 42.3 打包固件 52.4 烧写固件 52.5 启动系统 53. 测试流程 64. 配置文件 84.1 配置文件格式限制

2、84.2 模块配置示例 84.3 DRAM配置 94.4 RTC配置 94.5 WIFI配置 94.6 G-Sensor配置 104.7 Nand配置 104.8 MMC配置 104.9 UDisk配置 114.10 Usb_HOST1配置 114.11 Usb_HOST2配置 114.12 Usb_OTG配置 114.13 HDMI配置 114.14 Key配置 124.15 IR配置 124.16 MIC配置 134.17 TP配置 134.18 Camera配置 144.19 界面配置 145. FAQs 185.1 为系统启动后会进入TP校准界面？ 185.2 如何添加新的方案？ 18

3、5.3 为什么录音测试没有声音输出？ 185.4 如何关闭内核的打印？ 18Declaration 191. 前言2. 简介DragonBoard是一个基于Linux BSP，集成了DirectFB的图形化板卡测试系统。该系统旨在检测板卡能否在特定的环境中正常工作。DragonBoard测试系统的固件可以直接烧录到板卡上，同时，也支持卡启动，减少对PC的依赖。DragonBoard测试系统的测试流程分为两个部分：自动测试和手动测试。自动测试包括内存、时钟、WIFI、重力传感器等；手动测试包括SD卡、U盘、HDMI、按键、红外、录音耳机和触摸等等。系统上电运行后会自动加载、运行用户启用的测试用例

4、，并将结果显示到界面，用户可从中看到哪些测试项通过，哪些失败。3. 测试时间DragonBoard测试系统完成一张板卡测试所需的时间具有一定的浮动性，主要受以下几个方面影响： 主频和DDR频率； 测试项数量； 测试流水线和工人的熟练程度；主频和DDR频率决定了系统的运行速度，越高的频率测试程序运行的越快，所需的时间就越短；测试项数量会影响系统负荷和工人操作时间；另外测试流水线设置是否合理以及工人的熟练程度也直接影响测试时间。4. 目的本文档主要向用户阐述在A20平台上DragonBoard测试系统的使用方法。5. 名词解释6. 参考文档7. 使用入门由于DragonBoard测试系统基于Lin

5、ux BSP，因此需要待测试平台的Linux BSP，即Linux内核。系统默认使用Android的Linux内核。DragonBoard测试系统的源码位于buildroot/target/dragonboard目录下面，A20 SDK 默认包含了dragonboard，编译内核时会自动编译这些源码，并生成所需的测试用例。8. 编译内核在lichee根目录下执行下面的命令，编译一个供DragonBoard使用的内核，这个内核和Android的Linux内核使用相同的配置：$ ./build.sh p sun7i_dragonboard 编译完内核后自动编译DragonBoard测试系统，并生成

6、rootfs.ext4，位于out/dragonboard目录下面。rootfs.ext4包含了一个根文件系统，里面有驱动模块文件，位于/lib/modules/3.3.0目录下面，还有dragonboard测试用例和数据，位于/dragonboard目录下面。注意：虽然在量产阶段，卡启动是最好的选择，但是在开发阶段使用flash启动开发更加方便、快捷。如果客户使用flash启动来开发，建议关闭flash的读写测试。因为flash的读写测试是针对nanda这个分区，这个分区默认做为了bootloader分区，这个分区中存放了boot相关的代码，flash测试的代码会破坏这个分区中的文件，从而导

7、致下次开机的时候运行到boot1阶段会不能正常加载boot.axf这个文件，以至于不能正常启动。9. 配置测试项目DragonBoard测试系统提供了一个灵活的配置脚本test_config.fex，方便用户定制自己的测试项目，从而提高系统的效率。test_config.fex能够完成以下基本工作：1. 修改界面的语言和颜色2. 启动或者禁用某个测试项目3. 修改测试项目的参数测试项目的各项配置说明详见第4节配置文件。10. 打包固件打包使用下面命令：$ ./build.sh pack_dragonboard1. 选择芯片平台Start packing for Lichee systemAll

8、 valid chips:0. sun7iPlease select a chip:2. 选择dragonboardAll valid platforms:0. android1. dragonboard2. linux3. 选择方案All valid boards:0. wing-evb-v10Please select a board:11. 烧写固件1. Nand启动使用PhoenixSuit烧写固件。2. SD卡启动使用PhoenixCard3.09或更新的工具烧写固件, 用于在PC制作启动卡。12. 启动系统1. Nand启动2. SD卡启动上电前请先将SD卡插入板卡卡槽。13. 测

9、试流程板卡上电之后系统自动启动，测试程序依照test_config.fex配置依次加载，并显示主界面。根据配置的不同，主界面的布局也将不同。当进入主界面之后，用户即看到各个测试项目的状态。这些测试项目被分为两组：自动测试项和手动测试项。自动测试项整个测试过程自动完成，无需用户干预，测试通过测试项目描成蓝色，测试失败测试项目描成红色。手动测试项需要用户参与。其中带wifi测试与mic测试与camera测试的主界面如下图所示：1. SD卡用户插入一张SD卡等待3秒，如果成功会在界面显示容量并且测试项目变成蓝色，否则测试项目变成红色。2. U盘用户插入一个U盘等待3秒，如果成功会在界面显示容量并且测

10、试项目变成蓝色，否则测试项目变成红色。3. HDMI对于pad,等带lcd的产品，如果用户配置到lcd输出，则在用户插入HDMI后等待3秒，HDMI会输出Color Bar和一段音乐。如果成功测试项目变成蓝色，否则测试项目变成红色。对于hdmi dongle,homelet这种不带LCD的产品，如果用户配置到HDMI输出，则HDMI会输出整个dragonboard的UI界面。如果用户没有配置mic录音的话，HDMI会输出一段音乐。否则会把mic 的录音输出到HDMI 音频上。4. 按键界面会显示用户按下的按键。如果成功测试项目变成蓝色，否则测试项目变成红色。5. 红外界面会显示用户按下的按键。

11、如果成功测试项目变成蓝色，否则测试项目变成红色。6. 录音耳机根据用户配置，如果用户需要在mic录音前播放一段音乐到耳机口，则会先播放音乐，到用户配置的规定时间后音乐会停止。录音程序会在延时5秒后（默认值）开始录音，对于pad产品，用户可以插入耳机测试耳机输出是否正常，同时也可判断Speaker是否正常。对于HDMI输出的产品，录音会出从HDMI输出。在录音的同时，UI上会动态直观的显示录音的能量条。7. 触摸用户可以通过触摸屏幕来检测触摸屏的好坏。屏幕会显示用户划过的轨迹，用户可以借此来判断屏幕好坏。如需清除轨迹，请按正上方的清屏按钮。 8 网络 Dragonboard 会扫描wifi 热点

12、，并把扫描到的热点显示到UI上。而且所有的热点按信号强度依次显示。同时也会显示出信号的DB值和信号强度能量条。信号强度大于60db的为能量条为绿色，表示信号强度较好。信号强度小于60db的能量条为红色，表于信号强度较差。 14. 配置文件DragonBoard板卡测试系统提供了一个灵活的配置脚本test_config.fex，位于/tools/pack/chips/sun7i/configs/dragonboard/方案目录，方便用户定制自己的测试项目，从而提高系统的效率。配置文件可以完成以下工作：1. 修改界面的语言和颜色2. 启用或者禁用某个测试项目3. 修改测试项目的参数该脚本使用ini

13、文件格式，由段、键和值三者组成，通常一个段表示一个模块配置。目前要求该配置文件使用UTF-8编码，其他编码格式可能会导致未知错误，这点后续会改善。15. 配置文件格式限制16. 模块配置示例测试模块配置示例：exampledisplay_name= Exampleactivated = 1program = example.shcategory = 0run_type = 11. exampleexample表示一个模块配置example。2. display_name当前测试模块显示到界面的名称，字符串类型，最多可容纳64个字节。如果为空，测试程序不会运行。如需显示双引号，使用下面语法：di

14、splay_name= string:Example如果模块显示的名称需要不同的语言支持，修改display_name字段即可。3. activated0：不测试该模块。1：测试该模块。如果用户的方案不需要测试当前模块，请将该项置0；否则，请将该项置1。4. program模块的测试程序，字符串类型，最多可容纳16个字节。5. category0：自动测试模块1：手动测试模块6. run_type0：等待当前模块的测试程序执行完毕再运行下一个模块的测试程序1：不等待当前模块的测试程序执行完毕一般为了提高整体的测试速度，对于耗时较长的测试程序建议填0，反之填1。注意，当category = 1，

15、即手动测试模块时，该项无效。因为手动测试模块会阻止其他测试模块加载，系统可能无法继续加载其他测试模块。17. DRAM配置内存测试配置。dramdisplay_name= 内存activated = 1program = memtester.shcategory = 0run_type = 1dram_size = 2048test_size = 8dram_size: 板卡上使用了多大的 dram，以MB为单位，在dram 测试之初，程序会去检测板卡上dram的实际容量，如果小于配置容量，则说明贴片存在问题，测试不通过。test_size：使用多大的容量测试DRAM的性能，单位是MB，默认使

16、用8M。实际如果需要测出DRAM的性能，需要设定较大的容量，但是这样耗时较长，因此需要用户折中选择一个合适的值。8M大概可以在30秒以内完成DRAM性能测试。18. RTC配置时钟测试配置。rtcdisplay_name= 时钟activated = 1program = rtctester.shcategory = 0run_type = 119. WIFI配置WIFI测试配置。wifidisplay_name= 网络activated = 0program = wifitester.shcategory = 0run_type = 1module_path = /system/vendor

17、/modules/ar6302.komodule_args = fwpath=/system/vendor/modules/module_path：需要加载的模块全路径，DragonBoard测试系统将模块文件放在/lib/modules/3.3.0/目录下，并且创建了一个/system/vendor/modules，解决部分wifi驱动下载固件失败的问题。module_args：模块的参数。20. G-Sensor配置重力感应器测试配置。gsensordisplay_name= 重力感应器activated = 1program = gsensortester.shcategory = 0r

18、un_type = 1module_count= 1module1_path= /system/vendor/modules/bma250.kodevice_name = bma250module_count：需要加载的模块数量。modulex_path：需要加载的模块全路径，“x”表示每几个需要加载的模块，从1开始。device_name：G-Sensor设备的名称。21. Nand配置闪存测试配置。nanddisplay_name= 闪存activated = 0program = nandtester.shcategory = 0run_type = 0test_size = 128te

19、st_size：测试nand读写的大小。nand方案请禁用nand测试。22. MMC配置SD卡测试配置。mmcdisplay_name= SD卡activated = 1program = mmctester.shcategory = 1run_type = 1卡启动方案请禁用mmc测试。23. UDisk配置U盘测试配置。udiskdisplay_name= U盘activated = 1program = udisktester.shcategory = 1run_type = 124. Usb_HOST1配置读出连接到host1的设备的PID,VID 到UI。Usb_HOST1disp

20、lay_name= USB主机1activated = 1program = host1tester.shcategory = 1run_type = 125. Usb_HOST2配置读出连接到host2的设备的PID,VID 到UI。Usb_HOST2display_name= USB主机2activated = 1program = host2tester.shcategory = 1run_type = 126. Usb_OTG配置读出连接到otg的设备的PID,VID 到UI。Usb_OTGdisplay_name= USB_OTGactivated = 1program = otgt

21、ester.shcategory = 1run_type = 127. HDMI配置 hdmidisplay_name= HDMIactivated = 1program = hdmitestercategory = 1run_type = 1sound_file = /dragonboard/data/test48000.pcmsamplerate = 48000support_mode= 2sound_file：向HDMI播放的音乐文件全路径。samplerate：音乐的采样率。support_mode：设置HDMI输出模块，默认优先输出1080p，720p，如果两者都不支持，这个配置才会

22、生效。支持以下输出模式。; support_mode; 0 : 480I ; 1 : 576I ; 2 : 480P ; 3 : 576P ; 4 : 720P 50HZ; 5 : 720P 60HZ; 6 : 1080I 50HZ; 7 : 1080I 60HZ; 8 : 1080P 24HZ; 9 : 1080P 50HZ; 10: 1080P 60HZ28. Key配置按键测试配置。keydisplay_name= 按键activated = 1program = keytestercategory = 1run_type = 129. IR配置红外测试配置。irdisplay_name

23、= 红外activated = 1program = irtestercategory = 1run_type = 1module_path = /system/vendor/modules/sun7i-ir.komodule_path：需要加载的模块全路径。30. MIC配置录音耳机测试配置。micdisplay_name= 录音耳机activated = 1program = mictestercategory = 1run_type = 1delay = 5volume = 40music_playtime =10sound_file = /dragonboard/data/test48

24、000.pcmsamplerate = 48000mic1_used = 1mic2_used = 1mic1_gain = 1mic2_gain = 1 mic1_threshold =16383mic2_threshold =16383delay：录音前的延时。volume：耳机、喇叭初始输出音量。最大值为63.music_playtime ：录音前音乐播放时间。sound_file：要播放音乐文件的路径。samplerate ：要播放音乐文件的采样率。mic1_used： 是否测试mic1mic2_used: 是否测试mic2mic1_gain: mic1前级放大增益。mic2_gain

25、: mic2前级放大增益。mic1_threshold： mic2测试通过振幅阀值，最大值为32767mic2_threshold： mic2测试通过振幅阀值, 最大值为3276731. TP配置触摸测试配置。tpdisplay_name= 触摸type = 1module_path = /system/vendor/modules/gt82x.kotype：触摸屏的类型，0表示电阻屏，1表示电容屏。电阻屏在系统启动后会运行TP校准的程序，只有通过调屏程序才会进入dragonboard界面。module_path：需要加载的模块全路径。32. Camera配置摄像头测试配置。cameraact

26、ivated = 1module_count= 4module1_path= /system/vendor/modules/videobuf-core.komodule2_path= /system/vendor/modules/videobuf-dma-contig.komodule3_path= /system/vendor/modules/gc0308.komodule4_path= /system/vendor/modules/sunxi_csi0.kodev_cnt = 1csi_cnt = 1fps = 30module_count：需要加载的模块总数。modulex_path：“

27、x”表示第几个需要加载的模块，从1开始。dev_cnt：设置摄相头个数。csi_cnt：设置csi通路，一般情况下是一路csi拖两个摄相头；如果两路csi各拖一个摄相头，则设成2。fps：帧率。33. 界面配置;-; manual_menu_name; manual test case menu name, 32bytes.; auto_menu_name; auto test case menu name, 32bytes.; clear_button_name; clear screen button name, 8bytes.; font_size; test case font dis

28、play size, valid value: 20pixel(default), 24pixel.; height_adjust; adjust height of manual test case and auto test case.; Color Index; 0: White; 1: Yellow; 2: Green; 3: Cyan; 4: Magenta; 5: Red; 6: Blue; 7: Black; 8: Beauty; menu_bgcolor; The background color index of test case category menu.; menu_

29、fgcolor; The foreground color index of test case category menu.; item_init_bgcolor; The background color index of test case item init status.; item_init_fgcolor; The foreground color index of test case item init status.; item_ok_bgcolor; The background color index of test case item OK status.; item_ok_fgcolor; The foreground color index of test case item OK status.; item_fail_bgcolor; The background color index of test case item fail status.; item_fail_fgcolor; The foreground color index of test case item fail status.; pass_str; The string display after te