MStar TV 客户开发指导书
版本 V1.0
Doc. No.: 2015040616 Doc. No.: 2015040616
© 2015 MStar Semiconductor, Inc. All rights reserved.
MStar Semiconductor makes no representations or warranties including, for example but not limited to,
warranties of merchantability, fitness for a particular purpose, non-infringement of any intellectual property right
or the accuracy or completeness of this document, and reserves the right to make changes without further notice
to any products herein to improve reliability, function or design. No responsibility is assumed by MStar
Semiconductor arising out of the application or use of any product or circuit described herein; neither does it
convey any license under its patent rights, nor the rights of others.
MStar is a trademark of MStar Semiconductor, Inc. Other trademarks or names herein are only for identification
purposes only and owned by their respective owners.
Doc. No.: 2015040616 Doc. No.: 2015040616
F-3697
REVISION HISTORY
Revision No.
Description
1.0
Initial release
Mstar TV 客户开发指导书
版本:V1.0
Date
04/21/2015
Security Level: Confidential A
- i -
4/21/2015
Copyright © 2015 MStar Semiconductor, Inc. All rights reserved.
Doc. No.: 2015040616 Doc. No.: 2015040616
F-3697
Mstar TV 客户开发指导书
版本:V1.0
TABLE OF CONTENTS
MStar TV 客户开发指导书 ...................................................................................................................... 1
版本 V1.0 ............................................................................................................................................. 1
1. Mstar TV 系统架构 ......................................................................................................................... 1
1.1. Pure Supernova 系统架构 ............................................................................................................. 1
1.2. Supernova 系统 MSrv 简介............................................................................................................ 3
1.3. Android TV 架构 .......................................................................................................................... 4
1.4. 各模块作用介绍 ........................................................................................................................... 6
1.5. 各模块编译及导入系统方式 .......................................................................................................... 7
1.5.1 Mboot 编译及烧录 ........................................................................................................... 7
1.5.2 Kernel 编译及导入 ..........................................................................................................17
1.5.3
Supernova 编译 ..............................................................................................................20
1.5.4 Android 编译 ..................................................................................................................21
1.5.5 编译文件升级到板子 .......................................................................................................24
2. 系统启动流程 ................................................................................................................................ 29
2.1. 系统启动流程 .............................................................................................................................29
2.2. Mboot 阶段完成的工作 ................................................................................................................31
2.3. Mboot 启动环境变量配置 .............................................................................................................33
2.4. Mboot GPIO/I2C/UART 配置 ........................................................................................................34
2.5. Mboot Keypad/IR 配置 ................................................................................................................35
2.6. Mboot 中 Panel 的驱动 ................................................................................................................38
2.7. Mboot 开机 Logo 和 Music ...........................................................................................................39
2.8. Mboot 中从 SN 分区获取数据 .......................................................................................................40
2.9. Mboot USB upgrade ....................................................................................................................43
2.10. Mboot 常用配置解析 ...................................................................................................................45
2.11. Mboot 下常用 debug 命令解析 .....................................................................................................47
2.12. PM51 待机流程 ...........................................................................................................................47
2.13. Mboot 中升级触发机制介绍 .........................................................................................................49
2.14. 开关机常见问题汇总及分析 .........................................................................................................51
3. 入门技能之系统配置 ...................................................................................................................... 53
3.1. 增加一个新的 Board ....................................................................................................................53
3.2. 增加一个新 Tuner .......................................................................................................................56
3.3. 增加一个新 I2C Device ................................................................................................................57
3.4. 增加一个 Panel ...........................................................................................................................58
3.5. DTV Frontend 配制方法 ...............................................................................................................59
3.6. GPIO/PWM 配置方法 ...................................................................................................................63
3.7. Keypad/IR 配制方法 ....................................................................................................................64
3.7.1 Keypad 配置 ..................................................................................................................64
3.7.2
IR 配置 ..........................................................................................................................75
3.8. Video Path 配置方法 ...................................................................................................................90
3.9. Audio Path 配制方法 ...................................................................................................................90
3.10. 开关 STR 的方法 .........................................................................................................................91
Security Level: Confidential A
- ii -
4/21/2015
Copyright © 2015 MStar Semiconductor, Inc. All rights reserved.
Doc. No.: 2015040616 Doc. No.: 2015040616
F-3697
Mstar TV 客户开发指导书
版本:V1.0
3.11. 待机唤醒源的设置方法 ................................................................................................................93
3.11.1 stPMCfg 参数的结构 .......................................................................................................94
3.11.2 使能 wakeup source 的方法 ............................................................................................95
4. 入门技能之电性能整改 ................................................................................................................... 99
4.1. 开关机 Panel 时序调整 ................................................................................................................99
4.2. TV 频率偏移 ............................................................................................................................. 101
4.3. 伴音曲线调整 ........................................................................................................................... 104
4.4. 行场同步范围调整 ..................................................................................................................... 104
4.5. 亮度曲线调整 ........................................................................................................................... 105
4.6. 白平衡参数修改 ........................................................................................................................ 105
4.7. DLC 曲线调整 ........................................................................................................................... 107
4.8. 背光亮度控制 ........................................................................................................................... 110
5. 从 UI 看到底层 ........................................................................................................................... 111
5.1. Android TV 部分 UI 架构 ............................................................................................................ 111
5.2. Pure Supernova UI 架构 ............................................................................................................ 116
5.2.1 UI 目录架构介绍 .......................................................................................................... 116
5.2.2 UI 开发工具 MIDE ........................................................................................................ 117
5.2.3 如何编辑资源文件及注意事项 ....................................................................................... 119
5.2.4 一个应用程序的创建、启动和关闭(即 APM 运行机制) ..................................................... 120
5.2.5 UI 调用的流程 .............................................................................................................. 122
5.2.6 UI 控制逻辑 ................................................................................................................. 125
5.2.7 UI 事件驱动和响应 ....................................................................................................... 127
5.2.8
Frame 常用成员 ........................................................................................................... 130
5.2.9 Container 常用成员 ...................................................................................................... 131
5.2.10 Widget 常用成员 .......................................................................................................... 131
5.2.11 如何合并 UI 代码?(以 CHINA 和 CHINA_LITE 为例) ................................................... 131
5.2.12 合并 UI 代码注意事项 ................................................................................................... 133
5.2.13 UI 开发原则 ................................................................................................................. 133
6. ATV 基本技能 ............................................................................................................................. 136
6.1. ATV 搜台流程 ........................................................................................................................... 136
6.1.1 全球各制式介绍 ........................................................................................................... 136
6.1.2 ATV 欧规自动搜台流程 ................................................................................................. 137
6.1.3 欧洲的 Secam-L ........................................................................................................... 137
6.1.4 ATV 美规自动搜台流程 ................................................................................................. 138
6.1.5 ATV 内销自动搜台流程 ................................................................................................. 139
6.1.6 手动搜台流程 ............................................................................................................... 140
6.1.7 常见搜台问题分析 ........................................................................................................ 140
6.2. ATV 换台流程 ........................................................................................................................... 143
6.3. VIF 参数调整 ............................................................................................................................ 144
6.4. ATV 节目信息管理 .................................................................................................................... 145
Security Level: Confidential A
- iii -
4/21/2015
Copyright © 2015 MStar Semiconductor, Inc. All rights reserved.
Doc. No.: 2015040616 Doc. No.: 2015040616
F-3697
Mstar TV 客户开发指导书
版本:V1.0
6.5. 场测问题应对措施 ..................................................................................................................... 151
7. DTV 基本技能 .............................................................................................................................. 152
7.1. DTV 信号的基本流程 ................................................................................................................. 152
7.2. 各种节目类型的过滤 ................................................................................................................. 153
7.2.1 SI 问题 Debug 开关说明 .................................................................................................. 154
7.2.2 常见问题的处理 .............................................................................................................. 154
7.3. DTV 前端知识了解 .................................................................................................................... 161
7.3.1 前端的主要作用 .............................................................................................................. 161
7.3.2 Tuner .............................................................................................................................. 161
7.3.3 Demod ............................................................................................................................ 162
7.3.4 Demux ............................................................................................................................ 163
7.4. EPG 常见问题分析方法 .............................................................................................................. 164
7.4.1 DVB EPG 简要介绍 ........................................................................................................... 165
7.4.2 ATSC EPG 简要介绍 ......................................................................................................... 166
7.4.3 EPG 常见问题分析 ........................................................................................................... 167
7.5. CI/CI+简介 .............................................................................................................................. 169
7.5.1 CI 系统框图 .................................................................................................................... 170
7.5.2 CI Plus 系统框图 .............................................................................................................. 171
7.5.3 CI 常见问题 debug 思路................................................................................................... 172
7.6. 频道管理简介 ........................................................................................................................... 177
7.6.1 频道管理树形结构图 ........................................................................................................ 177
7.6.2 DTV 节目开机读取介绍 ..................................................................................................... 177
7.6.3 频道管理简介 .................................................................................................................. 179
7.6.4 频道管理常见问题 ........................................................................................................... 185
7.7. DTV 场测问题注意事项 .............................................................................................................. 188
7.7.1 制定场测计划 ............................................................................................................... 190
7.7.2 准备相关器材 ............................................................................................................... 191
7.7.3 软件送前检查 ............................................................................................................... 191
7.7.4 硬件送前检查 .................................................................................................................. 191
7.7.5 客户 RF 场测流程说明 ..................................................................................................... 191
7.8. 常见搜台问题分析方法 .............................................................................................................. 192
7.8.1 搜台流程简介 .................................................................................................................. 192
7.8.2 DVB 搜台方式 m_eParserBaseType 的解释 ........................................................................ 193
7.8.3 搜台问题 Debug 开关 ...................................................................................................... 193
7.8.4 漏节目和漏频点 .............................................................................................................. 194
7.8.5 搜台问题举例分析 ........................................................................................................... 197
7.9. DTV 部分客制化注意事项 .......................................................................................................... 200
8. TTX/CC/VCHIP/Subtitle 等功能介绍 ......................................................................................... 201
Security Level: Confidential A
- iv -
4/21/2015
Copyright © 2015 MStar Semiconductor, Inc. All rights reserved.
Doc. No.: 2015040616 Doc. No.: 2015040616
F-3697
Mstar TV 客户开发指导书
版本:V1.0
9.2.1
9.2.2
9.2.3
9.2.4
9.2.5
8.1. 常见问题 debug 方法 ................................................................................................................ 201
8.1.1 TTX debug ...................................................................................................................... 201
8.1.2 Subtitle debug ................................................................................................................. 201
8.1.3 CC debug ........................................................................................................................ 202
8.1.4 Vchip debug .................................................................................................................... 203
8.2. 客制化注意事项 ........................................................................................................................ 205
9. 显示部分流程及常见问题 .............................................................................................................. 206
9.1. Scaler 问题分析方法 .................................................................................................................. 206
9.1.1 系统框图讲解 ............................................................................................................... 206
9.1.2 如何用 MSTV TOOL debug Scaler .................................................................................. 207
9.1.3 Test Pattern ................................................................................................................. 211
9.1.4 踩寄存器的方法 ........................................................................................................... 217
9.1.5 基本解题思路 ............................................................................................................... 217
9.2. 3D 问题分析方法 ...................................................................................................................... 219
3D panel 介绍 ............................................................................................................. 219
3D Format 概述 ........................................................................................................... 220
3D Mode ...................................................................................................................... 223
6Mx0 3D ...................................................................................................................... 225
Frame Alternative LR report 说明 ............................................................................... 228
9.3. 4K 问题分析方法 ....................................................................................................................... 228
9.3.1 概念介绍 ..................................................................................................................... 228
9.3.2
4K2K 需要注意的问题点 ................................................................................................ 228
9.3.3
4K2K 平台下 debug 方法 ............................................................................................... 230
9.3.4 常见问题的 debug 方法 ................................................................................................ 230
9.4. 6Mx0 系列芯片问题分析方法 ..................................................................................................... 230
9.4.1 概念简介 ..................................................................................................................... 230
9.4.2 DDC 调试 ..................................................................................................................... 232
9.4.3 常用 DDC 命令 ............................................................................................................. 233
9.5. PQ 参数导入系统方法 ................................................................................................................ 236
9.5.1
PQ 文件位置 ................................................................................................................ 236
9.5.2 生成 PQ 文件的方法 ..................................................................................................... 236
9.6. VB1 问题分析方法 ..................................................................................................................... 237
9.6.1 VB1 握手流程 ............................................................................................................... 237
9.6.2 VB1 debug 方法 ........................................................................................................... 238
9.7. 屏参配置说明 ........................................................................................................................... 239
9.7.1 基本信息和规格 ........................................................................................................... 239
9.7.2 显示时序和规格 ........................................................................................................... 240
9.7.3 上电时序和规格 ........................................................................................................... 241
10. TV API 简介 ............................................................................................................................... 244
10.1. TV API 的由来 .......................................................................................................................... 244
Security Level: Confidential A
- v -
4/21/2015
Copyright © 2015 MStar Semiconductor, Inc. All rights reserved.
Doc. No.: 2015040616 Doc. No.: 2015040616
F-3697
Mstar TV 客户开发指导书
版本:V1.0
10.2. TV API 基本类介绍 .................................................................................................................... 245
10.3. 万能接口的用法 ........................................................................................................................ 246
10.4. TV API 调用注意事项 ................................................................................................................ 246
11. ANDROID 多媒体系统客制化 ....................................................................................................... 248
11.1. Mstar 平台多媒体系统介绍 ........................................................................................................ 248
11.1.1 ICS 多媒体系统架构 ..................................................................................................... 248
11.1.2 Android JB 之后的多媒体系统介绍 ................................................................................. 249
11.2. Mstar 平台 MM 客制化部分 ........................................................................................................ 250
11.2.1 Mstar 平台多媒体扩展接口 ............................................................................................ 251
11.2.2 ExtContentsource 介绍 ................................................................................................. 252
11.2.3 Subtitle 简介 ................................................................................................................ 254
11.2.4 无缝播放流程 ............................................................................................................... 255
11.2.5 图片播放 ..................................................................................................................... 256
11.2.6 获取媒体信息 ............................................................................................................... 261
11.3. 常见问题 debug 方法 ................................................................................................................ 261
12. ANDROID 系统客制化 ................................................................................................................ 268
12.1. IR 客制化方法 .......................................................................................................................... 268
12.2. 开机动画客制化方法 ................................................................................................................. 270
12.3. 修改分区注意事项 ..................................................................................................................... 271
12.3.1 新增分区 ..................................................................................................................... 271
12.3.2 修改分区顺序 ............................................................................................................... 273
12.3.3 新增分区常见问题 ........................................................................................................ 273
12.3.4 在 EMMC 上增加内置虚拟 SD 卡 .................................................................................... 273
12.4. 影响开机时间的要素 ................................................................................................................. 275
12.4.1 硬件配置 ..................................................................................................................... 275
12.4.2 软件配置 ..................................................................................................................... 276
12.4.3 软件客制化 .................................................................................................................. 276
12.5. Android 扩展 API 说明 ............................................................................................................... 277
12.5.1 camera api .................................................................................................................. 277
12.5.2 core api ....................................................................................................................... 277
12.5.3 ppoe api ...................................................................................................................... 278
12.5.4 storage api .................................................................................................................. 279
12.5.5 widi api ....................................................................................................................... 280
12.5.6 wifi api ........................................................................................................................ 280
12.6. Android 系统简单 debug 命令 .................................................................................................... 281
13. 系统问题分析方法 ....................................................................................................................... 282
13.1. GDB Debug 技能 ....................................................................................................................... 282
13.2. Coredump 问题分析方法 ........................................................................................................... 292
13.3. 系统内存问题分析方法 .............................................................................................................. 295
13.3.1 系统内存分析 ............................................................................................................... 295
Security Level: Confidential A
- vi -
4/21/2015
Copyright © 2015 MStar Semiconductor, Inc. All rights reserved.
Doc. No.: 2015040616 Doc. No.: 2015040616