v811_spc009/vendor/huanglong/modules/tvmw/source/common

1. TVMW目录为TV中间件实现代码,代码目录：
    vendor/mwvendor/modules/tvmw
    ├── adapter
    │   ├── tv_instruct.h
    │   └── tv_cus_instruct.h  //编译客制化目录时会将custom/customer_reference/instruct/tv_cus_instruct.h复制至此
    ├── api
    │   ├── cplusplus             //C++ API 编译客制化目录时会将custom/customer_reference/cppapi复制至此
    │   └── java                  //Java API 编译客制化目录时会将custom/customer_reference/java复制至此
    ├── common
    ├── custom                    //客制化相关代码、 公版mwvendor ini文件和客户ini文件
    │   ├── customer_reference    // 客户项目定制化代码参考;
    │   ├── mwvendor              // huanglong公版定制化代码;
    │   └── xxx                   // 客户参考customer_reference添加客户自己的项目定制化目录和代码;
    ├── debug
    │   ├── aqdebug
    │   └── tvdebug
    ├── external                  //git库不track此目录，此目录编译时创建，将custom目录下的mwvendor或custom_reference目录下的差异化实现的代码
    │                               （即不包括客制化的C++或Java接口）复制到本目录，编译入libimtvservice.so动态库
    ├── framework                 //framework层，主要用于封装或集成各驱动模块的UAPI接口和数据结构，供logic层调用
    ├── include
    ├── logic                     //logic层，主要包含了module_api、player、picture、audio、system等业务逻辑，
    │                                 module_api目录为logic层封装给C++、Java API调用的模块接口封装层
    ├── scripts
    └── tvservice
    │
    └── cfg.mak                   // 定义TVMW_CUSTOM选择客户机型编译目录.
   注: tvmw/cfg.mak中TVMW_CUSTOM选择客户机型编译目录,如:
       TVMW_CUSTOM := custom/mwvendor             //编译 公版代码 + custom/mwvendor 目录代码;
       TVMW_CUSTOM := custom/customer_reference   //编译 公版代码 + custom/customer_reference 目录代码;
       TVMW_CUSTOM := custom/xxxx                 //编译 公版代码 + custom/xxxx 目录代码.

2.客户修适配TV中间件规则：
     1>. 客户客制化代码全部放在custom/customer_reference目录下，客户不要直接修改huanglong公版的所有文件；
     2>. 客户所有实现代码可都在客制化目录custom/customer_reference下实现，编译时会将客制化目录下对应代码文件复制至公版相应目录下，并编译进行相应动态库；
     3>. 客户版本升级，可直接拷贝项目定制化目录，而不用关心huanglong发布版本修改具体内容，方便维护和升级；
     4>. 如果客户确实存在客制化目录下无法实现的功能，请反馈给huanglong TVMW部门;
     5>. 客制化详细可参考发布包中"TVMW3.0 客制化 开发指南 .pdf"文档.

2. 定制化参考customer_reference目录介绍:
  customer_reference:
     ├── source    :  客户功能实现目录,可多个cpp和h文件,可多个目录,文件名无要求;
     ├── include   ： 客户功能实现头文件,也可为空,直接放在source目录中;
     ├── cppapi    ： C++接口客户功能添加,文件名为CusEx.cpp/CusEx.h/ICusEx.h,文件名不要修改,如客户使用JAVA接口,不需要C++接口,可不需要此目录;
     ├── java      ： 客户功能JAVA接口实现,文件名为CusExImpl.java/CusEx.java,不要修改;
     ├── instruct  ： 客户功能invoke指令ID定义,文件为tv_cus_intruct.h,不要修改;
     └── ini       ： 客户项目ini文件,可参考huanglong公版tvmw\custom\mwvendor\ini下对应ini文件再修改与硬件或数据库默认值相关的定制化配置.
     注：
     1>. 如客户扩展功能使用JAVA接口,不需要C++接口,可不需要cppapi目录, java代码直接invoke方式调用实现;
         参考CusExImpl.java中cus_set_xxx实现"MwtvManager.getInstance().excuteCommandSet(CMD_ID_EX_CUS_SET_XXX, val)".
     2>. 如客户扩展功能需C++接口，cppapi、instruct目录下文件名不要修改,可在对应TODO部分添加客户功能实现代码;
     3>. 每次版本升级,注意对比huanglong公版tvmw\custom\mwvendor\ini下对应ini文件同步升级.

2. 客户中间件功能实现参考customer_reference/source/tv_cus_set.cpp中init代码部分:
    static td_s32 init(IDispatch * dispatch)
    {
        LOGI("customer cus module init");

    #if 1 //数据库客制化,创建新数据库,添加数据节点,参考tv_cus_dat.cpp中实现
        cus_db_init();
    #endif

    #if 1 //公版已存在数据库数据定义,但格式与客户不一样,客户定制私有数据查询和更新
        MW_DBO_CB_S sDboCallBack;
        sDboCallBack.pfnDbUpdateCb = cus_db_update_cb;
        sDboCallBack.pfnDbQueryCb  = cus_db_query_cb;
        sDboCallBack.pfnDbQueryManyCb = cus_db_query_many_cb;
        MwDBOFact::getDBO()->registerOpCb(&sDboCallBack);
    #endif

    #if 1 //图像模式设置,除公版已经定义的图像模式中各项设置外,客户有私有数据设置
        MW_CUS_PICMODE_CB pfnCusPicModeCb = cus_picturemode_additional;
        MwPicture::instance()->registerCusPicModeCB(pfnCusPicModeCb);
    #endif

    #if 1 //声音模式设置,除公版已经定义的声音模式中各项设置外,客户有私有数据设置
        MW_CUS_SOUNDMODE_CB pfnCusSoundModeCb = cus_soundmode_additional;
        MwAudio::instance()->registerCusSoundModeCB(pfnCusSoundModeCb);
    #endif

        td_u32 i;
    #if 1 //定制添加invoke指令调用功能实现,客户需封装C++或JAVA接口
        for (i = 0; i < sizeof(g_astCusAddModuleLocalAtomicInfo)/sizeof(LocalAtomicInfo); i++)
        {
            dispatch->insertInterface(g_astCusAddModuleLocalAtomicInfo[i].id, g_astCusAddModuleLocalAtomicInfo[i].pfn);
        }
    #endif

    #if 1 //定制替换公版已经定义的invoke指令调用功能实现
        for (i = 0; i < sizeof(g_astCusRepalceModuleLocalAtomicInfo)/sizeof(LocalAtomicInfo); i++)
        {
            dispatch->replaceInterface(g_astCusRepalceModuleLocalAtomicInfo[i].id, g_astCusRepalceModuleLocalAtomicInfo[i].pfn);
        }
    #endif

    #if 1 //控制驱动pq模块客户化功能回调,例如替换invoke指令功能SetBackLight,此处替换MW内部所有非invoke调用背光设置实现
        MW_PQCTRL_CB_S stPqCtrlCb;
        memset(&stPqCtrlCb, 0, sizeof(MW_PQCTRL_CB_S));
        stPqCtrlCb.pfnSetBackLightCb = cus_SetBackLight;
        stPqCtrlCb.pfnSetDemoCb = cus_SetDemo;
        //stPqCtrlCb.pfnGetBackLightCb = cus_GetBackLight;
        MwPQCtrl::instance()->registerOpCb(&stPqCtrlCb);
    #endif

    #if 1 //客户定制EDID和HDCP KEY
        cus_get_hdcp_key(&g_stCusHdcpEdid);
        cus_get_edid(&g_stCusHdcpEdid);
        MwVideoPlay::updateHdcpEdid(&g_stCusHdcpEdid);
    #endif

    #if 1 //客户定制比例模式的overscan裁剪和输出窗口计算算法
        MW_CONFIG_CALLBACK_S stAspectCb;
        stAspectCb.enConfigType = MW_DISPLAY_CONFIG_ASPECT;
        stAspectCb.unCfgCallback.stAspectCb.pfnAspectCropCb = cus_aspect_crop_cb;
        stAspectCb.unCfgCallback.stAspectCb.pfnAspectDispCb = cus_aspect_disp_cb;
        MwVideoPlay::registerCfgCb(&stAspectCb);
    #endif

    #if 1 //保存TVMW音频参数到EMMC裸分区/EEPROM/文件系统中文件,用于不能从MW数据库设置音频参数场景
        MW_CONFIG_SND_CALLBACK_S stConfigCb;
        stConfigCb.enConfigType = MW_SOUND_CONFIG_PRECIVOL;
        stConfigCb.unCfgCallback.stPreciVolCb.pfnPreciVolCb = cus_precivol_cb;
        MwAudioPlay::registerCfgCb(&stConfigCb);

        stConfigCb.enConfigType = MW_SOUND_CONFIG_PRESCALE;
        stConfigCb.unCfgCallback.stPrescaleCb.pfnPrescaleCb = cus_prescale_cb;
        MwAudioPlay::registerCfgCb(&stConfigCb);
    #endif

    #if 1 //注册回调在端子各种播放场景下(creat/destroy/start/stop/设置音频和PQ参数)定制客户设置
        MwSourceManager::instance()->registerListener(new cusTvListener);
    #endif

        //TODO: 其它客户化设置 start
        //  例如 1. 客户重新刷新数据库数据为客户私有数据;
        //       2. 客户新功放初始化控制;
        //       ......
        //
        //      其它客户化设置 end

        return TD_SUCCESS;
    }

    注 : 客户需要定制化某部分功能,可打开"#if 1",并修改对应功能实现(参考TODO:部分),如不需要,请 "#if 0"屏蔽此扩展功能.