详细设计说明书(情景模式).docVIP

[情景模式] 详细设计说明书 [MTK-M3项目组] 康佳通信科技开发中心软件所 2005年4月25日  目录 修改历史 3 1整体结构及功能描述 4 2关键数据结构说明 4 3主要存储分配 6 4各子模块实现及主要算法说明 6 4.1初始化 6 4.2开启 7 4.3个人设置 7 4.3.2 音量设置 7 4.3.3 其余设置 7 5内部调用的主要函数说明 8 5.1 入口函数 8 5.2 内部函数 8 6模块提供的外部接口函数说明 9 7主要信号 说明 10 8相关文档文件 11 修改历史 时间 修改人 版本 修改内容 2005-4-25 朱丹丹 1.0 创建初始版本  1整体结构及功能描述 功能描述：此部分功能，简而言之，就是按照用户特定的需求，设置环境参数，包括了开关机铃声、来电铃声、音量、按键音等参数设置。这些环境参数可以分别设置，也可以集体启动，如下图所示。 具体实现： 情景模式模块的设计，实际上就是有条件的对NVRAM的读写，从而改变一些参数的设置。 此套代码程序可以在模拟器上运行，可以在硬件平台上运行，情景模式模块两种条件下的架构基本相同，所以这里主要介绍在硬件上的实现。 该模块的设计主要分为两部分，MMI层，和L4层。 MMI层：系统启动时对该模块进行初始化，注册此模块中菜单高亮信息，NVRAM中读取相关记录。在具体的设置之中，可以对各种参数分别设置，也可以整体启动某个情景模式。 底层：接收MMI层发送过来的消息，执行相应操作，主要为 保存已经确认的设置，另外，在进行铃声选择的时候，同时播放示范音。 2关键数据结构说明  typedef struct { MMI_VOLUME_LEVEL_ENUM ringVolumeLevel; //铃声音量 MMI_VOLUME_LEVEL_ENUM keypadVolumeLevel; //按键音量 MMI_VOLUME_LEVEL_ENUM loudSpeakerVolumeLevel; //免提音量 MMI_ALERT_TYPE mtCallAlertTypeEnum; //来电提示方式 包括响铃、振动、LED LIGHT light; //LCD、LED背光 MMI_RING_TYPE_ENUM ringTypeEnum; //响铃方式 分单次、连续、渐进 TONE_SETUP toneSetup; //各种铃声选择 MMI_ANSWERING_MODE answeringMode; //应答模式 MMI_FONT_SIZE_ENUM fontSizeEnum; //字体选择 MMI_INTELLIGENT_CALL_ALERT_TYPE intelligentCallAlert; //不确定 EXTRA_TONE extraTone; //各种提示音 } PROFILE; PROFILE gcurrentprofile;//当前设置的情景模式变量 PROFILE gprofiles[MAX_ELEMENTS]；//存放N种情景模式变量 U8 gprofileId = 0, //当前操作的情景模式ID U8 gactivatedprofile = 0;//当前处于激活状态的情景模式ID 以上为此部分比较关键的全局变量，基本上就是围绕这几个变量在进行判断和设置 typedef struct{ kal_uint16 ringTone; //来电铃声 kal_int16 powerOffTone; //关机铃声 kal_int16 powerOnTone; //开机铃声 /*Changed By Alok */ #if !defined(MMI_LOW_MEMORY_PHONE) || defined(__MMI_CLAMSHELL__) kal_int16 coverOpenTone; //翻盖铃声 kal_int16 coverCloseTone; //合盖铃声 #endif kal_int16 messageTone; //短消息铃声 kal_uint8 keypadTone; //按键音 kal_uint16 alarmTone; //闹铃音 } TONE_SETUP; typedef enum { MMI_ALERT_NONE, //无提示 MMI_RING, //响铃 MMI_VIBRATION_ONLY, //振动 MMI_VIBRATION_AND_RING, //振动+响铃 MMI