配置工具详细用户基础手册.doc

ALi Customization Tools for M3328C
顾客手册

1. 摘要 1
2. 软件构成及其运营环境 1
3. 使用阐明 1
3.1. ACT_M3328C基本用法 1
3.2. 各页面和选项详解: 3
3.2.1 Chunk 设立 3
3.2.2 Common 设立 5
3.2.3 Panel 设立 6
3.2.4 GPIO usage 设立 9
3.2.5 Tuner 设立 10
3.2.6 Language 设立 12
3.2.7 AV 输出设立 13
3.2.8 Keymap设立 14
3.2.9 Program设立 15
3.2.10 Serial flash设立 16
4. 配备实战 17
4.1 配备Panel和遥控器 17
4.2 配备Serial flash 18

1. 摘要
ALi Customization Tools for M3328C（ACT_M3328C）是扬智公司（ALi）开发一种软件工具，它用于ALi M3328C DVB-S solution客户化定制。
以往DVB生产厂商在 ALi 解决方案上开发出一种新型号产品时，为了能让Firmware 在新硬件平台上正常运营，需要把平台送到ALi 公司，由ALi工程师对其调试，并对Firmware进行相应修改，经质控部门测试通过后，再交回给DVB生产厂商进行验证。如果客户需要改动某些硬件配备、出厂设立、个性化开机画面等等，也要通过上述流程才干实现。这个工作流程会牵涉到各种公司间沟通协调、不同部门间人力、资源、时间安排等。这使得新产品研发周期被大大拉长，不利于对市场需求作出迅速响应，同步也增长了大量型号版本支持维护工作，这增长了各有关公司成本承担。
针对以上问题，ALi在新M3328C solution中提供ALi Customization Tools for M3328C (ACT_M3328C）软件工具，能让顾客对M3328C solutionFirmware修改诸多惯用硬件配备和软件设立，界面和谐、操作简易，使客户可以依照自己型号需要简朴快捷地配备好Firmware。当前可配备项目有：遥控器（IR）；面板（front panel）及GPIO；Video输出；调谐器（tuner）；系统设立；OSD 语言；个性化开机画面；节目搜索设立；更换预置（缺省）节目表等。
使用ACT_M3328C，客户可以自己配备产品，可大大缩短响应时间，有效减少成本，ALi推荐客户优先考虑在ACT_M3328C可配备范畴内设计其新型号产品。

2. 软件构成及其运营环境
1) ACT_M3328C 运营在 Windows XP或Windows 操作系统上。
2) 本工具包括两个必要文献：ACT_M3328C.exe 和ACT_M3328C.ini，默认状况下ACT_M3328C.exe读取ACT_M3328C.ini信息，因此这时把它们放在同一种目录下，固然也可以自己选取此外.ini文献。本工具完全为绿色软件，无需安装，直接运营。

3. 使用阐明

3.1. ACT_M3328C基本用法
用鼠标双击ACT_M3328C.exe（如下称ACT）可启动本工具，会浮现如下窗口：

Figure – 3.1
在ACT启动时顾客必要一方面选取一种支持ACTFW文献， ACT会从该Firmware（如下简称FW）中读取它所有可设立参数到ACT页面上。如果想使用此外ini文献（默以为ACT_M3328C.ini，与ACT_M3328C.exe同一目录），可以勾上“Use external config file”选项，从而选取相应ini文献。咱们为每一种FW都设立了密码，只有输入对的密码，ACT才干打开FW进行方案定制。
输入对的密码后按“OK”打开主窗口。

Figure – 3.2
这时顾客可依照需求去修改上面设立。界面下部几种按键功能如下：
重新选取FW并读取FW中配备信息，更新界面信息。
保存配备信息到新FW中，这个FW文献不可以是你load设立同一种FW文献。
把所有定制信息保存到指定文献中（*.set），这样客户可觉得不同应用 保存不同定制文献。
这个键在不同配备页上Load内容不同，在Common页上（本例）把.set（保存）配备信息所有Load并显示出来。
修改FW密码，顾客先输入旧密码，然后输入新密码和确认密码，按 “OK”就行了，修改后密码只在save后FW生效，并不变化原FW密码。
退出ACT。

3.2. 各页面和选项详解:
ACT左边是配备页选项，涉及Chunk、Common、Panel、GPIO Usage(Panel子项目)、Tuner、Language、AV Set 、Program set、Keymap和Serial flash等几页设立。

3.2.1 Chunk 设立

Figure – 3.3

FW是由各种Chunk（数据存储块）构成，各个Chunk完毕作用各不相似， 上面列出了可以更换开机Logo以及预置节目表chunk（defaultdb(PRC)）。
预置节目表：预置节目表是初次开机时默认电视/广播节目表，通过STB菜单恢复默认也可以还原预置节目表。通过编辑节目表Excel文献，客户可以自己编辑所需预置节目。节目表Excel文献格式类似图Figure－3.3a所示，

Figure－3.3a
卫星名前加“*”，表达并预置这个卫星下所有节目。
卫星名前加“#”，表达只预置这个卫星和TP，不预制节目。
输入或修改卫星和节目信息，完毕后，按Ctrl＋A，选取所有数据，拷贝（Ctrl＋C）数据到缓存，然后新建一种TXT文本文献，粘贴卫星数据到文献中，保存TXT文献，该TXT文献就是咱们预置节目表文献。选取不同预置节目表TXT文献就可以更换不同开机预置节目表。咱们预置节目排列方式有两种，一种是按照节目所在TP排列，一种是按照顾客自己方式排列（也就是按照Excel中节目顺序排列）。在ACT目录下有一种dfv_m3328c.ini文献，如果客户方案（Firmware）是按TP排列（默认），请设立FixedOrder=0；如果是按顾客方式排列，请设立FixedOrder=1。然后保存该文献。客户方案（Firmware）必要与预置节目表一致，否则STB执行恢复默认后，节目表一定会乱。
选取chunk文献（如logo（*.m2v））去更换原FW相应chunk数据（开机Logo）。
清除/取消更换，保持本来FWchunk数据不变。

3.2.2 Common 设立
这里重要是某些比较常用系统配备。

Figure – 3.4

FW 版本信息。
有Release/Debug选取，Debug版本FW可以从串口打印出调试 信息，如遥控器键值，面板键值等，同步可以在视频（电视）输出中看到一种测试菜单，有Panel某些信息，如GPIO，扫描方式，等等。每次按面板，遥控器，菜单界面上均有相应键值显示，以及点亮LED灯或场强管，以便调试新面板和遥控器，详细用法请看配备实战。注意：Debug版本只能用于调试，不可用于量产。
初次开机时默认透明度。
与否支持遥控器持续按键。
初次开机时默认调色板。
默认盲扫方式，有All/Free选取，表达选取盲扫所有节目还是仅
仅免费节目。
默认增长节目扫描方式，，有All/Free选取，表达选取盲扫全
部节目还是仅仅免费节目。
STB开机启动时面板LED显示字符，输入字符范畴为：
aAbBcCdDeEfFgGhHiIjJlLnNoOpPqQrRsStTuU-_空格。其她字符由于LED7段数码管限制不可以输入。
STB处在standby状态时面板LED显示字符，输入范畴同上：
aAbBcCdDeEfFgGhHiIjJlLnNoOpPqQrRsStTuU-_空格。
默认开机时音量大小，最大为100。
盲扫或者新增节目时搜到电视节目初始音频设立，可选取Left，
Right和Stereo。
盲扫或者新增节目时搜到广播节目初始音频设立，可选取
Left，Right和Stereo。
开机画面（Logo）显示持续（延迟）时间。

3.2.3 Panel 设立

Figure – 3.5
这是面板配备信息，尚有一种子配备页面是GPIO usage，
面板扫描方式，有Shadow scan和Slot scan两种。
Shadow scan：扫描按键Key连接在移位寄存器总线上。
Slot Scan：扫描按键key连接在单独GPIO上。
面板LED数量。
LED H（点）段运用特殊配备，下图中以连接lock灯为例：

Figure – 3.6
LED数码管点段(Segment H)控制使能开关，如上图所示，如果前 面板H段位上连接了其她灯，则可以通过这个来设立，“On”表达该连线有效，下面有关配备也生效； 反之则无效。
控制该点段连线端口， “POW/GND”表达由该点连接于电源或地上， Com1/Com2/Com3/Com4则表白连接于相应COM口上。
用一种Byte值来控制点亮LED(八段)数码管，点段由其中一种bit来控制，由下面LED段设立来选取该Bit位。
选取点段（或连线）极性，高激活还是低激活。
有些客户STB面板上设有场强管(普通是8段管)，这项功能就是打开/关闭 场强管属性设立。下面简介一下这些属性设立。
选取控制/点亮场强管COM口。
选取场强管极性。
把控制场强管bit位连接反向，这样就可以以便控制场强管点亮方向。 咱们用一种BYTE来显示8段场强管，每一种bit点亮/灭一种段。通过下面list就可以依照硬件连线为每一种段选取控制bit位。

设定点亮场强管各段管信号强度范畴及场强管bit位连接，咱们场强管普通有8段显示，依照信号强度大小反映到场强管上。如左图所示，用Bit7控制段1，Bit6控制段2，....

而Scope项中。
Dark all – 场强管全灭（<1(即0)时全灭）。
Light segment1 – 点亮1管信号强度范畴（< 12时点亮1管）。
Light segment2 – 点亮1，2管信号强度范畴（< 24时点亮1，2管）。后来范畴设立类似。
注意，前面段范畴必要不大于背面段范畴，如scope of segment 2 必要 不不大于或等于scope of segment 1。
设立面板LED数码管极性。

LED数码管a－h段（详细段位排列可参照Figure – 3.6）和移位寄存器（bit0－bit7）连接表，必要要配合详细硬件设立。其中Segment H就是控制LED点段bit。当选取某一段时，如Segment F，下方管脚图示就点亮了相应段，以便对照配备。详细使用请参照配备实战－配备Panel和遥控器。

最后，咱们可以本来在Common页面看到按键变成了，这时该按键功能
是只把Panel（涉及下面要提到GPIO usage）配备信息从.set文献中Load进来。

3.2.4 GPIO usage 设立

Figure – 3.7
这是Panel页面一种子项， 由于M3328CGPIO重要都是用于Panel，如图Figure – 3.5列出了也许
用到GPIO， 客户必要依照硬件来配备相应GPIO。可以设定“GPIO No.”，范畴是0 － 62，
63表达无效；而“Polar”则可以选取极性。
Panel GPIO bus类型，有Common和Direct GPIO两种，common是面板通过移位寄存器来控制GPIO；Direct GPIO是直接连接控制GPIO。两种所要配备GPIO有所不同。

3.2.5 Tuner 设立

Figure – 3.8A

Figure – 3.8B
配备Tuner各种属性，这些都需要依照硬件来配备。
随着ACT不断升级，为了保持良好兼容性，ACT 打开不同版本FW或者配备文献时也许浮现可配备选项有所不同，Figure-3.8A所示ACT打开了配备文献版本为1.0FW，改版本FW中包括了各种Tuner driver和Tuner某些详细配备信息，顾客只要依照STB硬件对的选取就行了；而Figure-3.8B所示ACT打开了配备文献版本更高一级（2.0）FW，可以看出多余了某些配备选项，这是由于为了节约FW占用FLASH空间，把Tuner driver和Tuner配备信息从FW中分离了出来，顾客只要选取想要Tuner，ACT就动态地把Tuner driver放到FW中，而当前FW有且只有一种Tuner driver，别的不用Tuner driver是不放到FW中去，不占用FLASH空间，同步2.0版本可以独立配备各个Tuner。
如下某些配备选项是1.0和2.0版本共有：
选取当前硬件所配备Tuner，有MAX2118、ZL10039、ST6000、 M88TS、TDA8262等选取，default选项是不更改tuner（配备版本为1.0，2.0无该选项），这样就以Firmware默认tuner为准。
Tuner极性是正常还是反转。
Tuner与否为单晶振（配备版本为1.0，2.0无该选项）。
顾客自定义Tuner晶振频率，有时客户也许用不是原则晶振，这时可以依照实际状况设定，如果是“0”，STB将用默认频率。
调节信号质量缩放比例，同一种天线环境条件，各个Tuner得到信号质量也许不同，为了使显示出来信号质量一致，可以依照实际状况配备缩放比例，比例范畴为50％～300％，精准到十位，如果真实显示信号质量，则填入100。
调节信号强度缩放比例，同一种天线环境条件，各个Tuner得到信号强度也许不同，为了使显示出来信号质量一致，可以依照实际状况配备缩放比例，比例范畴为50％～300％，精准到十位，如果真实显示信号强度，则填入100。
与否打开Tuner I/Q配备，如果“enable”，关于下面I/Q配备将在FW中生效；否则无效。
Q+/Q-输出与否反转。
I+/I-输出与否反转。
I/Q与否反转。
差分/单端输出控制。
如下某些配备选项是2.0版本或以上独有，某些详细设立可以求助于Driver工程师，普通状况下已经配备好给客户：
TunerI2C地址。
Tuner中屡屡率范畴起始（低）频率，单位为MHz。
Tuner中屡屡率范畴结束（高）频率，单位为MHz。
Tuner滤波器带宽，单位为KHz。
TunerAGC门限1设立值。
TunerAGC门限2设立值。
QPSK配备。

3.2.6 Language 设立

Figure – 3.9
为FW配备OSD语言。
初次开机默认OSD语言。

如果FW中有各种OSD语言可以选取，如list box列出，通过“On/Off”开关， 可以使STB OSD语言菜单选取上相应语言可见/不可见。

3.2.7 AV 输出设立

Figure – 3.10
配备了某些音频、视频等输出属性。
初次开机默认电视制式，有PAL/NTSC/Auto选取，选取Auto则依照电视节目制式来转换，而其她两种则是强行转换成相应制式。
初次开机默认播放时电视节目还是广播节目。
STB有RF模块时，默认RF输出制式，有NTSC/ PAL-P/ PAL-I/ PAL-D/K可选取。如果打开FW不支持RF模块，则这项设立和下面紧跟设立（RF channel）将看不见。
设立初次开机默认RF channel，依照RF mode不同，channel有各自范畴。

设立Video输出。Enable项用于打开/关闭Video输出。而右边“1stDAC”，“2ndDAC”， “3thDAC”为各种输出选取DAC。
“CVBS_1”，“CVBS_2”只需要配备1st DAC,；“SVIDEO_1”有两个输出，因此要设立“1stDAC(-Y-)”，
“2ndDAC(-C-)”。“YUV_1”有三个输出，则应当设立三个DAC(-Y-，-U-，-V-)。
当Video输出为有效时，不能重复选取同一种DAC。
3.2.8 Keymap设立

Figure – 3.11
配备遥控器,面板扫描码和某些键功能。
播放时选取用什么键实现Pause功能，有Pause key/OK key选取。遥控器/面板有Pause 键（同步下面键值映射表设立了Pause键扫描码）就一定有pause功能，如果没有Pause键可以选取Ok键完毕pause。
选取用什么键实现Preview（预览）功能，有List key/OK key选取。遥控器/面板有（Program）List 键（同步下面键值映射表设立了List键扫描码）就一定有Preview功能，如果没有List 键可以选取Ok键完毕Preview。
选取用什么键实现DView（多画面）功能，有DView key/0 key选取。遥控器/面板有DView键（同步下面键值映射表设立了DView键扫描码）就一定有DView功能，如果没有DView键可以选取0键完毕DView。
注意：不能同步设定OK键来完毕Pause和Preview功能。
设立IR顾客码，一种遥控器顾客码都是一定（2 个byte），加上独一键码（2个byte，见下面设立阐明），构成了独一扫描码。

设立面板和遥控器键值映射表（功能码，2个byte）。有些遥控器有两个键功能是同样，但是扫描码不同样，这时可以在Key2 列输入此外扫描码，这样两个键就可以实现同样功能。详细如何配备请参照配备实战－配备Panel和遥控器。

此外，也可以同步支持2款遥控器， 配备如下：
设立第二个遥控器user code，如果设立了这个user code，key1 和 第一种user code 构成一种扫描码，key2 和 第二个user code 构成另一种遥控器扫描码。

3.2.9 Program设立
为搜索卫星节目而设某些配备。

Figure – 3.12
Autoscan more TPs设立项可觉得STB盲扫时指定必要搜索转发器，这样就可以防止某些特殊TP漏扫。通过可以弹出对话框增长要搜索转发器，而则删除在列表框中选取转发器。当前最多可以指定10个转发器。
Forbidden programs/TP设立项可以在搜索节目时忽视（跳过）指定节目或TP，由于某些国家或地区也许由于政治或其她因素不准接受某些节目，这时把这些禁止节目设立上就行了。通过弹出对话框新增要禁止搜索节目。当前最多可以指定15个节目。
转发器/节目参数阐明：
Polarity：极化方式，有H（水平）和V（垂直）两种，如果是Forbidden programs/TP项目，尚有
H/V选项，即水平和垂直节目都搜台时同步会被屏蔽。
Frequency：下行频率，范畴是3000 － 13450（MHz），TP设立误差范畴是±5M，Program设
置误差范畴是±2M。
Symbol rate：符号率，范畴是1000 － 45000（K bits/S）。P设立误差范畴是±2M，Program
设立误差范畴是％5。
Video PID：范畴是32 － 8191。
Audio PID：范畴是32 － 8191。

3.2.10 Serial flash设立

Figure – 3.13
对于支持Serial flash firmware，ACT可以配备增长、编辑和删除serial flash构造类型，但是对于firmware自身内部支持通过验证serial flash（在Description列中有型号列出），不能编辑和删除。
点击或，弹出下面对话框编辑或增长flash类型，详细如何增长一种新serial flash请参照配备实战－配备Serial flash。

Figure – 3.14
Figure – 3.15
4. 配备实战
4.1 配备Panel和遥控器
拿到一种新遥控器（或面板），一方面必要在“Panel/GPIO usage”页面中对的配备好Scan Type和GPIO，这样才干保证Panel可以扫描到面板按键和控制Led显示，然后在“Common”页面中设立 为“Debug”模式，保存FW，把FW烧进平台，接上串口工具，平台/电视输出画面和ACT有关选项如图Figure – 4.1，画面对话框中，显示了平台面板某些信息，如Scan Type，Led Polarity等等，
Figure – 4.1
（1）配备Key map
依次按面板和遥控器各个按键，可以看到对话框中信息变化：如果按面板按键，Key Type显示Panel，如果按遥控器，Key Type显示IR，同步User code和Key code也显示了所按键键值，串口工具也将键值打印出来，把键值拷贝粘贴到“Key map”配备页面panel或者IR相应键值映射列表中，依次设立好面板和遥控器所有key map。
（2）配备LED显示
LED数码管a－h段（详细段位排列可参照Figure – 3.6）和移位寄存器（bit0－bit7）连接，每按一下面板或者遥控器，依照“Panel”页面LED Polarity选项，依次循环把bit0-bit7置高/低电平（Active at low表达置低，Active at high表达置高），面板上可以看出LED一段一段依次被点亮了，如果LED是其中一段不亮，而其他段亮，则证明LED Polarity选反了，改正过来。观测点亮LED段和界面对话框上输出bit位，例如当前输出bit2，点亮了F段，则在ACT “Panel”页面LED segment项中选取一致bit位控制。
配备好后，可以点，把当前键值或panel设立保存为一种新xxxx.Set文献， 下次再需要使用这款遥控器只需要或把panel信息或IR（无Panel Keymap 信息）keymap从.set文献中读取并且显示出来。

4.2 配备Serial flash
如果有一款新serial flash需要咱们FW支持（这时普通咱们解决方案都应当支持eRom功能），咱们可以通过升级工具Serial flash detect功能来检测flash构造和指令，如图Figure – 3.15所示，

Figure – 4.2

1. 打开升级工具。Upgrade Mode 为“eRom 1->1”，Operate Mode为 ”Serial flash detect“
2. dump file选项中选取一种TXT文献保存将要得到serial flash信息
3. 按“Next”，然后依照提示打开机器电源，检测完毕后查看保存TXT文献来拟定flash构造
4. 依照检测flash 构造文献，在ACT在“Serial flash”页面上增长flash类型。

例如，有一种Flash 检测TXT 文献内容如下：
Detect get id command:
Identified as serial flash
id value = 0x1320377f
id command = 0x9f

flash id option:
1.Flash ID：0x37,Device value：Command:0x9f，Byte address：0x01
2.Flash ID：0x20,Device value：Command:0x9f，Byte address：0x02
3.Flash ID：0x13,Device value：Command:0x9f，Byte address：0x03

Detect flash size：
Now start detect the size of this flash!
Please wait.................Flash capacity = 0x80000

Detect sector structure：
2,4k 1,8k 1,16k 1,32k 7,64k

普通来说，检测得到flash ID 命令组合方式有几种，如果本来串行flash列表上没有这种组合，就可以选取其中一种组合。如上咱们选取是组合3：Flash ID：0x13,Device value：Command:0x9f，Byte address：0x03
依照这些信息在ACT添加串行Flash 类型，如图Figure – 4.3

Figure – 4.3