开机播放代码说明.doc

MV8720开机播放代码说明 上海文广科技发展有限公司MV8720开机播放代码说明编写：许良版本：v1.02007-08-20目录1.引言31.1背景31.2 定义31.3 参考资料32.开机播放任务说明32.1 实现功能32.2 开机播放流程42.3代码添加说明52.3.1 添加任务52.3.2 添加任务入口函数62.3.3 添加API_Shell_main()函数62.3.4 添加DMBautorun（）函数72.3.5 定义DMB_selensblbyfreqval(float freq_val)函数73 函数说明83.1 void HDEBUG_init()83.2 void APIShell_Init()93.3 void FileSystemDiskStartup()93.4 void DMBautorun()93.5MMP_RESULT OAL_FileOpen(OAL_FILE_DESCRIPTOR * fd, char * pFilePath,unsigned int AccessType)93.6MMP_RESULT OAL_FileClose(OAL_FILE_DESCRIPTOR * fd)103.7MMP_RESULT MMP_FileRead(MMP_FILE_DESCRIPTOR* pFileDescriptor, unsigned long bytesToRead, char * pBuffer, unsigned int * pBytesRead)103.8MMP_RESULT MMP_FileWrite(MMP_FILE_DESCRIPTOR* pFileDescriptor, unsigned long bytesToWrite, char * pBuffer, unsigned int * pBytesWritten)113.9DMB_RESULT DMB_Initialize(BBM_INTERFACE_TYPEbbm_interface, TUNER_INTERFACE_TYPE tuner_interface, TUNER_VENDOR_TYPE tuner_vendor)113.10DMB_RESULT DMB_selensblbyfreqval(float freq_val)113.11DMB_RESULT DMB_waitChannelReady(ENSEMBLE_VENDOR_TYPE ensemble, UCHAR *ensemble_label)123.12DMB_RESULTDMB_getTVChannelList(int*channel_Num,int channel_IDMAX_SUBCH_NUM,UCHAR channel_labelMAX_SUBCH_NUM17)123.13DMB_RESULT DMB_selectTVChannel(USHORT subChId)123.14 MMP_RESULT MMP_MediaPlayerOpen(char * pURL, MMP_MEDIAPLAYER_CONFIG * pConfig)133.15 MMP_RESULT MMP_MediaPlayerPlay()131.引言 1.1背景 本文档为开发T-DMB接收手持设备的firmware而设计，主要实现T-DMB信号的接收并通过MV8720控制进行播放，整个系统基于PNM3030与MV8720硬件平台，系统用C和C+语言开发。 1.2 定义 T-DMB 1.3 参考资料 1 MMP API Definitions Documentation2 Nucleus PLUS 参考手册3 MV8720 Data Sheet Preliminary4 MV87xx Mobile Multimedia Processor Porting Guide5 MV8700 (TigerDMB) Hardware Specification -HS-10032-00-032.开机播放任务说明 2.1 实现功能建立开机播放进程，最终使系统具有开机播放、键盘扫描两个进程，实现开机自动播放，在SD卡里某个文件中设置PNM3030的初始化频率与视频播放的频道。当8720评估板上电，初始化完成后，8720读取SD中DMB_config.ini文件中的内容，将读得的ASCII码转换为浮点数后作为频率值对PNM3030进行设置。在PNM3030频率设置成功后8720读取channel_config.ini文件中的内容作为选择播放的频道号，然后打开播放器进行播放，实现播放频道的可控。 2.2 开机播放流程图1 开机播放任务流程图 2.3代码添加说明 2.3.1 添加任务首先在CallbackInitializeUserTasks_MMPEVB1_1.cpp文件中添加开机播放任务SignalCheckTask,如下图所示：同时将源代码中提供的UserStartupTask任务屏蔽，只剩下键盘和开机播放两个任务，如下图所示： 2.3.2 添加任务入口函数在CallbackInitializeUserTasks_MMPEVB1_1.cpp文件中添加开机播放任务的入口函数，如图所示： 2.3.3 添加API_Shell_main()函数 在shellmain.cpp文件中添加API_Shell_main()函数，该函数主要完成串口调试初始化，背景窗口，OSD窗口初始化，默认文件系统初始化以及对DMBautorun()函数的调用，如下图所示： 2.3.4 添加DMBautorun（）函数在shellcommend_dmb.cpp文件中添加DMBautorun（）函数，该函数主要完成读写SD卡文件，设置PNM3030接收频率，打开播放器，选择频道播放等功能。2.3.5 定义DMB_selensblbyfreqval(float freq_val)函数 此函数的功能是设置PNM3030的接收频率，为自定义函数，首先在DMB_interface.h文件中添加此函数的声明：然后在DMB_Main.cpp文件中添加频率设置函数的API：最后在PNP_Main.cpp文件中添加频率设置函数PnP_selensblbyfreqval(float freq_val)的源代码，同时在PNP_Main.h文件中对此函数进行声明。3 函数说明3.1 void HDEBUG_init()功能：串口调试初始化参数：无返回值：无3.2 void APIShell_Init()功能：背景窗口，OSD窗口显示初始化参数：无返回值：无3.3 void FileSystemDiskStartup()功能：初始化文件系统参数：无返回值：无3.4 void DMBautorun()功能：完成SD卡文件的读写，PNM3030设置，播放器的打开等参数：无返回值：无3.5MMP_RESULT OAL_FileOpen(OAL_FILE_DESCRIPTOR * fd, char * pFilePath,unsigned int AccessType) 功能：打开指定的文件参数：fd：文件描述符指针pFilePath:文件的路径AccessType：文件访问类型 返回值： 3.6MMP_RESULT OAL_FileClose(OAL_FILE_DESCRIPTOR * fd)功能：关闭指定的文件参数：fd：文件描述符指针返回值： 3.7MMP_RESULT MMP_FileRead(MMP_FILE_DESCRIPTOR* pFileDescriptor, unsigned long bytesToRead, char * pBuffer, unsigned int * pBytesRead)功能：读指定的文件内的数据参数：pFileDescriptor:文件指针描述符bytesToRead: 指定要读的字节数pBuffer:存放数据的缓冲区指针pBytesRead: 返回读取的字节数返回值：无3.8MMP_RESULT MMP_FileWrite(MMP_FILE_DESCRIPTOR* pFileDescriptor, unsigned long bytesToWrite, char * pBuffer, unsigned int * pBytesWritten)功能：写数据到当前打开的文件中参数：pFileDescriptor:文件指针描述符bytesToWrite: 指定要写的字节数pBuffer:存放数据的缓冲区指针pBytesWritten: 返回写的字节数返回值：无3.9DMB_RESULT DMB_Initialize(BBM_INTERFACE_TYPEbbm_interface, TUNER_INTERFACE_TYPE tuner_interface, TUNER_VENDOR_TYPE tuner_vendor)功能：初始化基带和调协器芯片参数： bbm_interface : default=SPI_INTERFACE tuner_interface : default=BBM_I2C_CTRL tuner_vendor : default=INTEGRANT_TUNER返回值： success : DMB_SUCCESS fail : error_code3.10DMB_RESULT DMB_selensblbyfreqval(float freq_val)功能：设置频率值参数：Freq_val:要设置的频率值返回值： success : DMB_SUCCESS fail : error_code3.11DMB_RESULT DMB_waitChannelReady(ENSEMBLE_VENDOR_TYPE ensemble, UCHAR *ensemble_label)功能：等待所有频道就绪参数： ensemble : ensemble vendorensemble_label : ensemble label返回值： success : DMB_SUCCESS fail : error_code3.12DMB_RESULTDMB_getTVChannelList(int*channel_Num,int channel_IDMAX_SUBCH_NUM,UCHAR channel_labelMAX_SUBCH_NUM17)功能：获取视频频道列表参数： channel_Num : number of available channelchannel_ID : channel ID list channel_label : channel label list返回值： success : DMB_SUCCESS fail : error_code3.13DMB_RESULT DMB_selectTVChannel(USHORT subChId)功能：选择要播放的视频频道参数：subChId