RDA5850开发教程要点

1、RDA5850/RDA5851 开发手册版本：2.12013-7-15目录目录 2更新历史 4声明 5代码结构 6任务歹U表 6应用开发模块 6驱动开发接口 8Flash马区动 8LCD驱动 8项目定义 9平台定义 9应用定义13编译环境14第一次运行14编译方法14资源编辑器15项目设置15出厂设置16语音设置17语言选择18图片设置18字符串设置19LED设置20菜单设置21节日设置22模拟器23第一次运行24选择项目25模拟器界面26模拟器菜单27调试工具28工具栏说明28Log窗口说明28内存窗口说明 29下载界面如下 29调试菜单29工具配置30Trace 配置31音频校准31音量校

2、准31Mp3解码器校准33SBC参数设置34回音消除参数设置 3419更新历史日期版本描述作者2012-5-261.0新版本发布2012-7-301.1增加部分target配置2012-8-211.2增加gpio按键配置2013-4-92.0增加 led, gdb, trace, calibration2013-7-152.1增加蓝牙调试菜单，增加sbc和回音消除设置方法的说明声明1.在未经RDA公司事先书面许可的情况下，严禁以任何形式复制、修改本手册中的任何内容；在编制手册过程中已经力求内容的正确与完整，但并不保证本手册没有任何错误或遗漏。本公司将不对本手册可能出现的错误或者疏漏负责；我们保

3、留在不预先通知的情况下，对本手册中描述的任何产品进行修改和改进的权利。代码结构系统分为两个部分，应用程序和平台代码。平台代码位于platform目录，应用程序位于 apps目录。目录列表目录内容appsap_xxx应用程序代码ap_gui公用显示程序，比如菜单、进度条等gui显示函数库，显示文字、图片等projects_cfg应用项目配置，包括选项、资源等system访问平台软件相关的代码env编译脚本和makefilelibpO：件platformchip芯片定义和rom文件edrv外部设备驱动程序flash_prog下载程序Ramruninclude平台库文件的头文件。Simulator模

4、拟器代码target平台定义文件build编译中间文件hex系统目标文件，每个target会有一个子目录。toolpool编译调试工具。系统入口函数是 BAL_TaskInit。BAL_TaskInit里面首先调用BAL_Initalise函数进行系统的初始化。然后创建了4个任务。任务列表总共有4个任务中系统中运行：1 .系统任务，主要处理底层驱动的消息2 .媒体任务，运行和调度解码模块3 .蓝牙任务，运彳T协议栈和profile4 .应用任务，运行应用程序，处理消息和显示界面。4个任务中除了应用任务都是在平台代码里的。应用开发模块应用程序一般是一个消息处理循环，调用MESSAGE_Wait函

5、数得到消息，根据应用分别处理对应的消息，不处理的消息调用MESSAGE_HandleHotkey函数处理热键。示例代码：INT32 Sample_Entry(INT32 param) UINT32 key;UINT8 result=RESULT_MAIN;MESSAGE_Initial(g_comval); / 重置系统计数器while(1) if(need_draw) /如果需要显示 #if APP_SUPPORT_LCD=1 if(AP_Support_LCD() GUI_ClearScreen(NULL);清全屏幕GUI_DisplayBattaryLever();GUI_UpdateS

6、creen(NULL); #endifneed_draw = FALSE; key = MESSAGE_Wait(); / 取得系统消息 switch( key )根据消息执行不同动作。 case AP_MSG_RTC:need_draw = TRUE; break;case AP_KEY_MODE|AP_KEY_HOLD: ;/break;default:result = MESSAGE_HandleHotkey(key); 处理热键 if(result = RESULT_REDRAW)need_draw = TRUE;else if(result != 0) return result;

7、驱动开发接口需要用户定制的驱动主要是flash和led ,其他部分的驱动一般不需要改动。驱动的选择在平台的定义文件target.def里面。Flash驱动Flash驱动位于 platformedrvmemd目录下，驱动的接口定义在文件memd_m.h中，主要包初始化函数，系统启动后会调用。PUBLICMEMD_FLASH_LAYOUT_T*memd_FlashOpen(CONSTMEMD_FLASH_CONFIG_T* efg);读函数，一般需不要使用，可以用 memcpy实现PUBLIC MEMD_ERR_T memd_FlashRead(UINT8 *flashAddress,UINT32

8、 byteSize,UINT32* pReadByteSize, UINT8* buffer);写函数，下载程序和保存程序配置时调用PUBLIC MEMD_ERR_T memd_FlashWrite(UINT8 *flashAddress,UINT32 byteSize,UINT32 * pWrittenByteSize, CONST UINT8* buffer);擦函数，调用写函数前会先调用擦函数来擦除要写的扇区。PUBLIC MEMD_ERR_T memd_FlashErase(UINT8 *startFlashAddress,UINT8 *endFlashAddress);LCD驱动LC

9、D驱动位于platformedrvlcdd目录下，驱动的接口定义在文件lcdd_m.h中，主要包括打开，更新等接口。初始化函数，系统启动后会调用。PUBLIC LCDD_ERR_T lcdd_Open(VOID);刷屏函数，把 Data指向的buff里的内容显示到屏幕上PUBLIC LCDD_ERR_T ledd_update_sereen (UINT8* Data, LCDD_ROI_T *rect);/8段数码管显示刷屏函数PUBLIC LCDD_ERR_T led8s_update_screen(UINT16 flag, UINT8* Data);项目定义平台定义平台定义在目录targe

10、t下，每个平台一个目录，包括一个 target.def文件和两个头文件tgt_board_cfg.h 和 tgt_app_cfg.h。平台定义包括了芯片的定义和硬件平台的定义，比如驱动的配置、按键的设置等信息。target.def文件中需要修改的部分：#=# # 3 # # flash 驱动 # #SPI Flash (RAM is packaged inside baseband chip)FLSH_MODEL ?= flsh_gd25q32TARGET_EXPORT_FLAG += MEMD_NO_ASSERT# # Flash model interface: parallel/spiF

11、LSH_IF?= spi# # EBC CLK cfg: 52MHz / 78MHz / 104MHz / 156MHz SYS_MEMD_EBC_CLK ?= _78MHz_#SPIFLASH spi CLK cfg: 52MHz / 78MHz / 104MHz / 156MHz ifeq $(strip $FLSH_IF) spiSYS_MEMD_FLSH_SPI_CLK ?= _78MHz_ endif # ($FLSH_IF,)# # Ram is ADMUX or notTARGET_EXPORT_FLAG += MEMD_RAM_IS_ADMUX# # Flash is ADMU

12、X or not#TARGET_EXPORT_FLAG += MEMD_FLASH_IS_ADMUX# # Ram support burst mode or notTARGET_EXPORT_FLAG += MEMD_RAM_IS_BURST# Flash support burst mode or not#TARGET_EXPORT_FLAG += MEMD_FLASH_IS_BURST#=# 4 # LCD 驱动 # LCD_MODEL?= mzl02#ili9163c st7735r# LCD interface: gouda/slcdLCD_IF?= gouda# GOUDA can

13、 support serial LCD starting from 8808 ifeq $LCD_IF” gouda USE_SPI_LCD ?= 1 TARGET_EXPORT_FLAG += USE_SPI_LCD endif#=# 9 #用户项目定义 #项目名CT_PROJECT := 128_64#是否有资源CT_RESVALID := yesGLOBAL_EXPORT_FLAG += RESOURCE_SUPPORTtgt_app_cfg.h 一般不需要修改。tgt_board_cfg.h可能需要修改的部分:GPIO相关的定义#define TGT_GPIO_CONFIG_CFG/红

14、外使用的gpio.gpio_irc=HAL_GPIO_4,/ led使用的gpio.led_count=3,.leds= /led列表 .gpoId=HAL_GPO_5 ,/* MUSIC */ .gpoId=HAL_GPO_3 ,/* FM */ .gpoId=HAL_GPO_0 ,/* Bluetooth *八按键使用的gpio.key_count=0, /按键个数.key_interrupt_mode=TRUE,/是否中断模式，否则使用查询模式.high_keydown=TRUE, /按键按下时gpio值为高/ gpio按键列表.gpio_keys= HAL_GPIO_NONE,/lin

15、e in 检查 gpio 端口号.gpio_lineIn= HAL_GPIO_NONE, line in gpio 是高有效 .lineinPlugHigh= TRUE,/ t卡检测脚 .cardDetectGpio= HAL_GPIO_7,/低有效 .gpioCardDetectHigh= FALSE,/耳机检测脚 .earpieceDetectGpio= HAL_GPIO_1,/低有效 .earpiecePlugHigh= FALSE,/没有设置gpio检测时是否有耳机 .earpiecePlugin= FALSE,#define TGT_HAL_CONFIG.keyInMask= 0x0

16、7,按键使用的 keyin位开关.keyOutMask= 0x07, 按键使用的 keyout 位开关.uartKeyinoutSel = /以下为用keyin/keyout做gpio的开关 .keyin0GpioEn = 0, /* GPIO_20 */.keyoutIGpioEn = 0, /* GPIO_17 */.keyout2GpioEn = 0, /* GPIO_11 */.keyout3GpioEn= 0, /* GPIO_7 */.keyout4GpioEn= 0, /* GPIO_8 */,/按键定义#define KEY_MAPKEY_POWER,/ power 键的键值，

17、设置为 KEY_INVALID可以不用power键, 直接拉高，加电自动开机。./ gpio按键的值，顺序和 gpio按键定义一致 .第一列按键的值 .第二列按键的值 .第三列按键的值 /按键动作定义#define KEY_CONFIG.repeat_timeout= 1000,/进入长按的延时，单位毫秒.repeat_interval = 200,/进入长按后循环周期，单位毫秒.keymap= g_tgtKeyMap/红外遥控器定义#define IRC_CODE_MAP_SIZE22#define IRC_MAX_STYLE4#define IRC_STYLE_MAP0xbf00, 0x7

18、f80, 0xff00, 0xfd02#define IRC_MAP0x10, 0x0a, 0x0c, 0x08,/* KEY_1*/0x11,0x1b, 0x18, 0x88,/* KEY_2*/#define IRC_CONFIG.gpioId= HAL_GPIO_4,.irc_styles= IRC_MAX_STYLE,.map_size= IRC_CODE_MAP_SIZE,.timeout= 200,.style_list= &g_tgtIRCStyle0,.code_map= &g_tgtIRCMap00/ pmd配置#ifndef TGT_PMD_CONFIG#define TG

19、T_PMD_CONFIG/长按开机.holdPowerOn= FALSE,语音配置，对每种语音配置路径和参数EAR_PIECE为耳机模式LOUD_SPEAKER 为外放模式BLUETOOTH为耳机发射模式BT_EP为蓝牙接收，耳机输出模式BT_SP为蓝牙接收，外放输出模式FM是收听收音机的模式LINEIN为插入linein时使用的模式RECEIVER和BLUETOOTH模式暂时没有用至L#define TGT_AUD_CONFIG_EAR_PIECE_DRIVERCodecGallite#define TGT_AUD_CONFIG_EAR_PIECE_PARAM0#define TGT_AUD

20、_CONFIG_EAR_PIECE_OUTPUT_PATHAUD_SPK_RECEIVER /语音输出路径，可选值为耳机(AUD_SPK_EAR_PIECE )或者外放(AUD_SPK_LOUD_SPEAKER )#defineTGT_AUD_CONFIG_EAR_PIECE_OUTPUT_TYPEAUD_SPEAKER_STEREO /输出类型，立体声或者左、右声道#defineTGT_AUD_CONFIG_EAR_PIECE_INPUT_PATHAUD_MIC_LOUD_SPEAKER / 输入路径xmake脚本中的CT_TARGET参数选择编译的平台。应用定义应用定义在目录appspro

21、jects_cfg目录下，每个项目一个目录，包括一个头文件project_config.h 和资源文件。头文件不定义了上层应用的feature,比如lcd尺寸、是否支持菜单等。#define APP_SUPPORT_BLUETOOTH#define APP_SUPPORT_USB#define APP_SUPPORT_FM#define APP_SUPPORT_FM_RECORD#define APP_SUPPORT_FM_OUT#define APP_SUPPORT_LCD#define APP_SUPPORT_LED#define APP_SUPPORT_LED8s#define APP_

22、SUPPORT_FLASHDISK#define APP_SUPPORT_MENU#define APP_SUPPORT_REMOTECONTROL#define APP_SUPPORT_LYRIC#define APP_SUPPORT_FADE_INOUT1 /支持蓝牙0/ 支持 usb host1/支持fm0 / fm录音0 / fm输出1 lcd单色液晶屏1/ led指示灯1/ 8段数码管显示0 /内置磁盘空间1 /菜单支持1 /遥控器支持1 /歌词显示1 /淡进淡出#define APP_SUPPORT_INDEPEND_VOLUMNE1 /每个模块使用独立音量/上面值为0的选项目前还

23、不支持，1的选项可以改为0来关闭/语言支持，定义字符串资源时使用#define APP_SUPPORT_LANG_ENGLISH#define APP_SUPPORT_LANG_SM_CHINESE1 /English1 /SM Chinese屏幕尺寸#define LCD_WIDTH#define LCD_HEIGHT12864#define APP_DEFAULT_RESULT任务RESULT MAIN / 进入系统后首先运行的应用项目的选择在平台定义的target.def文件里。编译环境第一次运行解压 ftp 上 DevelopTool 目录下的 MIPS_Compiler.rar 和

24、coolgdb.rar 到 toolpool 目录。编译方法执行根目录下的 msys.bat打开编译环境，注意会有杀毒软件警告，最好退出杀毒软件, 以方便编译。执行xmake命令进行编译，xmake文件是个脚本，可以用文本编辑软件修改，其中参 数CT_TARGET指定需要编译的项目，其他参数不要修改。xmake可以带路径参数来单独编译某个模块，比如xmake platform/edrv编译驱动模块。xmake link命令可以单独链接。资源编辑器资源保存在项目名resource目录下，源文件名为resource.csv,可以用文本编辑工具直接编辑，目标文件名为 res.bin,用来下载到fla

25、sh,系统链接时会自动把资 源目标文件加入到系统bin文件里。资源编辑器打开的时候读取源文件，保存的时候会同时更新源文件和bin文件。资源编辑器位于 toolpoolbin目录下，文件名 resedit.exe。运行时先选择配置的项目。项目设置项目全局设置信息，包括 feature,显示参数、蓝牙名字、密码等。出厂设置第一次运行或者用户选择恢复出厂设置时恢复的配置。注：其中Loop Mode有三个选项：RepeatOne:循环播放一首歌曲， RepeatAll :循环播放所 有歌曲，Auto：自动切换，按键选择下一首歌曲时切换为循环所有歌曲，按键选择上一首歌曲时切换为循环一首歌曲。语音设置语音

26、设置配置各种提示音和内置音乐。对于没有LCD的项目，只需要配置前三页：项目设置、出厂设置和语言设置就可以了。选中的mp3文件会被复制到对应项目的resourceaudio子目录下。语音ID在gui_const.h里面定义。语音类型分为两种，mp3文件和内部编码。内部编码用一串字符来定义一段语音，每个字符播放0.1秒时间，0代表没有声音，19代表从低到高的9个频点，大约频率见下表：值严首频率0没后声首1256Hz2384Hz3512Hz4640Hz5768Hz6853Hz71024Hz81280Hz1536Hz语言选择选择语言包，语言包的id和语言菜单的id相对应。语言包文件位于 toolpoo

27、lbin目录下。图片设置选中的图片会被复制到对应项目的resourceimages子目录下。图片ID在gui_const.h里面定义。对于同类别的图片可以做成图片组资源，显示的时候用一个ID,和要显示的索引值就可以了。比如下图中的循环状态，把不同循环的图片，按照程序中变量值repeat_mode的顺序排列，显示的时候就会很方便： GUI_ResShowImage(GUI_IMG_MUSICLOOPS, repeat_mode, POSITION_F, 0); 定义图片组资源，需要指定图片的高度，以便显示程序截取图片。RDA Mpihost Rescurtf Edt21Project Cni1

28、| Ftatory Stlting |ID NameHei gh-OhOOOL OxOOOE OxOOOG OkOOO& 0x00100x0011 0x0012 0x0013 0x001qOxOOZO OxQOZljUI_I1GJJOGO GUI_irG_TEMUMAIN GUI IMG MEHWAIMA guiZimCmbisk GUI_irG_SMALL_NUM GUI工G_B工GJT询 GUT_IMG_EABS GUI_IHGEATTLLS GUljiGlBITRATENVMS GUI_IHG_rUSICEQS GUI IMG_MEHUEQA口322 0 8 2 6 63 3 11Fat

29、hLDGO. bffip FRENUM AIN. bmp MENUMUNA. bp MBISK. bmp SMALL_NUM. bmp BIG.BXW. bflip fiAES. bmp EATTLVLS.bmp BITEATEHUHS-bmp WUSICEQS.bmp MENUEQ. WpImage ID |0x0022工ma好 Ns-i：Delete |GUI_IMG_MUSICLOOFS0x002216MUSICLOOPS： bmFath：BrowxtMUEICLOOFS.bmpHeight：llaSize：UxllZ16 MENUIDOFA. bp16 VENUMUSIC. bp16

30、BEHVMUSICA. bmp16 BEKICE. brwp I，H I.r.16 HUSICRFT. bmp MMU5IC FMOUT.bn0 MMUSIC. bnp EA_fM. bmp16 MEHU.FH. Imp16 EHU_FHA. Impfl F口RUR Ihmin0x0023GUI_irG_rElTUU)OFA 0x0024 GUI_IMG_MEHWVSIC 0x0025 GUT_IMG_MEHUMUSICk 0x0026 GUI_irGJDE7ICE0x0027 GUljllG_MUSICTYPEosooze Gui_iiG_rusicBprOxOOSf GUI IHG MM1

31、EIC FBOUTOxOOBf MUSICDx009C GUI_irG_Rk_FK 0x0091 GUI 工MG MEHV FM 口 xO 限 GbT_IMG_HEHU_FMAnMrm Girr hg f皿r/in取消ISave确定字符串设置字符串ID在gui_const.h里面定义。ID的名字。需要为每个字符串在不同语言里设置内容，没有设置过的默认值为 可以直接用文本编辑工具修改资源源文件来设置字符串的值。LED设置LED显示模式设置，ID在gui_const.h里面定义。每个显示模式依次设置开关灯已经延迟时间，单位 0.1秒。点击Preview可以预览led闪烁效果，如下图:23RDA B

32、THo?t Resource EditProject Confi g Factory Setting Audi q , Im&g String | Me-nu FstivalFatten：映 _LED_-R9aoe0900ID:IOkOOOBLed 0 onLed 1 offDly OL 5 stcandLed off Lw 1 1 onLaSii3Action；Led Index ：Deal5f 0. 5 second取捎确定菜单设置首先选择要编辑的菜单，选择后菜单项会显示在列表里。每个菜单包括两个图片，一个是没选中时显示的图片，一个是选中时显示的图片。Query Active选项表示在显示

33、菜单时，通过 callback函数取得当前选中的菜单项。每个菜单项需要定义对于的string id, action, result, paramo菜单项定义：项目说明string id用来显木菜单项的字符串idAction选择菜单后执行的动作Runtime Check运行时调用callback查询是否要显布该菜单项Invisible不显示该菜单项RawText通过callback取得采单项显本的文本Action有四个选择:Action说明ResultParamSubMenu打开子菜单子菜单idResult返回结果RESULT_xxx 等值Key模拟按键按键动作，AP_KEY_DOWN、AP K

34、EY PRESS 等键值,AP_KEY_PLAY 、 AP KEY VOLADD 等。Message发送消息消息值RD A Mp5host Resource EditProject Config Factory Setting | Language | String： Menu Festival |String| F| Autim Riult FsramSl*ct Mmiu；m_STR_SEa(ElOMn “不 W5oGUI STR REPEATOHE1051Imaee ID:|GUI_MEmJ_HUSIC_LOOF ，|CUI_IMG_MUSICinOPS / |CUIZsTR_JOLE)E

35、RPIAYNe 3 ace 102.GUI STR EEPEATFOLDE*1053*ctiva 工励于网Ig_HENULOOFA,leI- Raw TextUp工n“rt JD&wn |Dalit*取消Save|节日设置节日分语言设置，选择语言后，对应的节日显示在列表里。 节日定义说明：StyleMonthDateWeekDay阳历节日（Solar）阳历月阳历日阴历节日（Lunar）阴历月阴历日按星期定义的节日（Week）阳历月第几周星期几24RDA -Ip5host Resource Edit节节节节节节节节节皿恩摹阳秋玛午宵节一.14-i 3-1- -J- - r Ju cu - ru

36、-F明节节节日节节节节节节节Conig | Factory Setting | Language | 工mage | String; | Mlenu Festival |L小甄蔻酢:I GUZ_LAHG_SB_CHINESETFestivalI平安莅MonthDataW“DtyWeek110l%EtTHUB5DAYleek603rdSUHIUYVeekE02il1SlfflBAYLunar123Lunar99Luxior615Lunar?7Luik&rSSLxmar115LunarI1Solar1225Solar1224Solar10JSolarg10Solar81Solar71Solar61

37、Solar5qSolar5iSolar41Sola312Solar38Solar214Solar11InsertDtlele取消 模拟器Simulator目录下为一 Windows平台，Visual C+环境运行的模拟器。 模拟器构建了一个可以让应用层运行的环境。2643酗停此曲 步z 卜/唐占小C EMkl Iwk HWew H*Q0 电11口一 回 国胃 聃眄瓦而而）而丽而记 m陶田r痴pm+ bbsl&c-&SimulXi+ _j|llEi下 ,jRe：-SinEC训垢4i5unrd dsun%rd ；unrd IIMbH_Eiliv已 E E有IhTTS; TlbEJEn百到 1 hf

38、aOirjR)re. 174 494 J3：i|才;5unrda5BFYappsfluiX5rcXgui_r5Durc*.d(553J 4: sunrdj5B MmppNquiHirt .gui_resQurc-. e(55JiW i mllJtiknEllg 种 linking.kuild rc-EDurce Hili己，市I1个京+kSimjl-attrxe - m-nr(5),国百 rninf(s:iMrninqi CM-V33: - : incDH(utiblc tupes - Frnn nunsinrd cfMrr * t strwC R-haqf *rl warning CHtH:

39、 Ji : 4nreforc-ncadi 口口al 4arlublc-：irning C*11S -Cff5#r ； usrefere*ced kttHl wirldbl*r wrningi 3T4H; ddt-a_-Hddr1 : unre-Ffrrnce Idc+1 vari-rtilr: wningiJl : hrpf#r-ncfi!di IdejI varidblti arnlmg EhiAis dtdi_Aiddr1 : iinKfpneM i u电尸r wning Cl: T ; nrrfe*_rncedi Loc-al vBri-sblt1: Mrninq Chin： djtj

40、:ddr z unrc-Ft-icnce4 IdcaI ujri-afelri；l二口! |OVH FI 137工 Z0LW12模拟器运行时包括一个可以定制的界面和一个终端窗口用来显示trace。第一次运行第一次运行模拟器需要注册插件，执行simulatorBinSimulatorCtrl目录下的regctrl.bat即可。调试蓝牙需要安装蓝牙驱动，蓝牙驱动支持CSR的usb蓝牙dongle,需要先安装原 CSRdongle带的IVT软件后，再更新成我们的驱动，驱动位于simulatorBinUSB_Driver目录下。还需要设置Visual C+的项目配置，指定运行的目录为当前目录，否则会找

41、不到资源文件， 如下图所示。Project Settingsrar：Win32 Debug二|General Debug C/C* Link ResourcesSimulator+ _| Source Files 1+1 _| Header Files + |_J Resource Files -SiniiulalnrLayEr -firmware:* _| lirmwarelnc - 刁 firmwareSrcCDS_win32.i rim Win32.c drv_win32.i fmd Win32, FS_win32.c pm_win32.r sul_win32.i TM_win32. 白

42、副MCI匣口 mclljwCategory： GeneralExecutable for debug session：n:svnRnAS8FHsimula1arBinSimulatDrHCXEProgram arguments：Remote execuUble path and file name：OKCancel选择项目选择模拟器运行的项目，需要修改两个地方：1 .文件IncOption.txt ,倒数第三行包含的目录改成需要模拟项目的目录。八.appsap_usbdiskinclude/I .appsap_voiceinclude项目名include/I .platformedrvbtdrdaStackinclude/I .platformedrvbtdrdaStackstackinclude2 .修改项目属性，Post-build step,复制对应的资源到调试目录 Bin。模拟器界面模拟器的界面通过 Skin来定义，skin位于simulatorBinSkins目录下，每个skin包括一个设