Manual_develop.doc

RDA5850/RDA5851开发手册 版本: .1 2013-7-15 目录 目录 3 更新历史 5 声明 6 代码结构 7 任务列表 7 应用开发模块 7 驱动开发接口 9 Flash驱动 9 LCD驱动 9 项目定义 10 平台定义 10 应用定义 14 编译环境 15 第一次运行 15 编译方法 15 资源编辑器 16 项目设置 16 出厂设置 17 语音设置 17 语言选择 18 图片设置 19 字符串设置 20 LED设置 21 菜单设置 22 节日设置 23 模拟器 24 第一次运行 25 选择项目 26 模拟器界面 27 模拟器菜单 28 调试工具 29 工具栏说明 29 Log窗口说明 29 内存窗口说明 30 下载界面如下 30 调试菜单 30 工具配置 31 Trace配置 32 音频校准 32 音量校准 32 Mp3解码器校准 34 SBC参数设置 35 回音消除参数设置 35 更新历史 日期 版本 描述 作者 20-5-26 1.0 新版本发布 1.1 增加部分target配置 2012-8-21 1.2 增加gpio按键配置 2013-4-9 2.0 增加led，gdb，trace，calibration 2013-7-15 2.1 增加蓝牙调试菜单， 增加sbc和回音消除设置方法的说明 声明 1. 在未经事先书面许可的情况下，严禁以任何形式复制、本手册中的任何内容在编制手册过程中已经力求内容的正确与完整，但并不保证本手册没有任何错误或遗漏。本公司将不对本手册可能出现的错误或者疏漏负责我们保留在不预先通知的情况下，对本手册中描述的任何产品进行修改和改进的权利。 代码结构 系统分为两个部分，应用程序和平台代码。 平台代码位于platform目录，应用程序位于apps目录。 目录列表 目录 内容 apps ap_xxx 应用程序代码 ap_gui 公用显示程序，比如菜单、进度条等 gui 显示函数库，显示文字、图片等 projects_cfg 应用项目配置，包括选项、资源等 system 访问平台软件相关的代码 env 编译脚本和makefile lib 库文件 platform chip 芯片定义和rom文件 edrv 外部设备驱动程序 flash_prog 下载程序Ramrun include 平台库文件的头文件。 Simulator 模拟器代码 target 平台定义文件 build 编译中间文件 hex 系统目标文件，每个target会有一个子目录。 toolpool 编译调试工具。 系统入口函数是BAL_TaskInit。 BAL_TaskInit里面首先调用BAL_Initalise函数进行系统的初始化。然后创建了4个任务。 任务列表 总共有4个任务中系统中运行： 系统任务，主要处理底层驱动的消息 媒体任务，运行和调度解码模块 蓝牙任务，运行协议栈和profile 应用任务，运行应用程序，处理消息和显示界面。 4个任务中除了应用任务都是在平台代码里的。 应用开发模块 应用程序一般是一个消息处理循环，调用MESSAGE_Wait函数得到消息，根据应用分别处理对应的消息，不处理的消息调用MESSAGE_HandleHotkey函数处理热键。 示例代码： 驱动开发接口 需要用户定制的驱动主要是flash和lcd，其他部分的驱动一般不需要改动。 驱动的选择在平台的定义文件target.def里面。 Flash驱动 Flash驱动位于platform\edrv\memd目录下，驱动的接口定义在文件memd_m.h中，主要包括读、写、擦等函数接口。 LCD驱动 LCD驱动位于platform\edrv\lcdd目录下，驱动的接口定义在文件lcdd_m.h中，主要包括打开，更新等接口。 项目定义 平台定义 平台定义在目录target下，每个平台一个目录，包括一个target.def文件和两个头文件tgt_board_cfg.h和tgt_app_cfg.h。 平台定义包括了芯片的定义和硬件平台的定义，比如驱动的配置、按键的设置等信息。 target.def文件中需要修改的部分： tgt_app_cfg.h一般不需要修改。 tgt_board_cfg.h可能需要修改的部分： xmake脚本中的CT_TARGET参数选择编译的平台。 应用定义 应用定义在目录apps\projects_cfg目录下，每个项目一个目录，包括一个头文件project_config.h和资源文件。 头文件中定义了上层应用的feature，比如lcd尺寸、是否支持菜单等。