5 配置文件


本章主要介绍配置文件的格式,除非对配置文件格式很熟悉,否则建议不要人工修改配置文件,请通过【文件】菜单下的【保存配置】来保存配置。

配置文件由[Global]、[Button]、[Indicator]、[Trace]、[Monitor]、[I2C Set]、[Advance]、[Segment]、[Bit Register]和[Word Register]组成,下面描述时所用的红色字符表示本例子中的内容,需要由实际内容替代。“//”后面为对应的说明,实际中并不需要。

本软件有Main和Slave两个页面,对应独立的配置文件,两者格式一致。

5.1 全局段[Global]

[Global]分段主要保存全局配置信息:

[Global]    //识别符

Chip=12    //Chip名, “=”号后的字符将显示到窗口顶部

Version=0.1    //版本号,“=”号后的字符将显示到窗口顶部, Chip名后

AddrBytes=1    //芯片地址的字节数,8位地址线时设为1,32位地址线时设为4。注:AddrBytes的范围是1-4

OffsetBits=4    //偏移地址位数。注:OffsetBits的范围是1-4

RegisterBytes=1    //寄存器的字节数,8位宽时设为1,32位宽设为4。注:RegisterBytes的范围是1-4

CSRun=E:\HiChannel\demo-script|app1#E:\HiChannel\demo-script2|app2#    //C脚本文件路径列表,C脚本不同路径之间必须用“#”隔开,文件路径后面是联合编译后定义的执行文件的名字,必须唯一,无脚本文件路径时也须添加”|“标识。

CSIncludes=E:\HiChannel\header1|E:\HiChannel\header2|#E:\HiChannel\header2|#    //C脚本依赖的头文件路径,多个路径之间用“#”隔开,对C脚本同一路径需要引入多个头文件时,不同头文件路径之间用“|”隔开,无头文件时也须添加”|“标识。

注:C脚本文件路径下的所有C脚本文件后缀名必须为“.c”或者“.C”。

5.2 按钮操作段[Button]

[Button]段保存按钮操作Button的配置信息:

[Button]    //识别符

Button 1=FunctionName|Caption|Paramnum|param1,param2|Remind|isReturnValue    //第1个按钮的配置

………

Button 配置说明

5.3 指示灯段[Indicator]

[Indicator]段保存按钮操作Indicator的配置信息:

[Indicator]    //识别符

Indicator 1=FunctionName|Caption|Type    //第1个指示灯的配置

Indicator 2=FunctionName|Caption|Type    //第2个指示灯的配置

Indicator 3=FunctionName|Caption|Type    //第3个指示灯的配置

………

Indicator 配置说明

5.4 跟踪显示段[Trace]

[Trace]段保存按钮操作Trace的配置信息:

[Trace]    //识别符

Trace 1=FunctionName|Caption    //第1个跟踪显示的配置

Trace 2=FunctionName|Caption    //第2个跟踪显示的配置

Trace 3=FunctionName|Caption    //第3个跟踪显示的配置

………

Trace 配置说明

5.5 常用监控段[Monitor]

[Monitor]段保存按钮操作Monitor的配置信息:

[Monitor]    //识别符

Lock Time=FunctionName    //锁定时间的配置

Symbol Error=FunctionName    //符号率误差的配置

Carrier Error=FunctionName    //载波频率误差的配置

Signal Intensity=FunctionName    //信号强度的配置

Signal Quality=FunctionName    //信号质量的配置

C/N=FunctionName    //C/N的配置

Error Rate=FunctionName    //错误率的配置

Monitor 配置说明

5.6 I2C设置段[I2C Set]

[I2C Set]    //识别符

Chip Address=0x3F    //芯片的I2C通讯的器件地址

Large FPGA=0x30    //大FPGA的I2C通讯的器件地址

Middle FPGA=0x1F    //中FPGA的I2C通讯的器件地址

Small FPGA=0x33    //小FPGA的I2C通讯的器件地址

I2C Communication=FunctionName    //通讯检测脚本函数,格式为:“app名称#方法名”

Selection Item=Small FPGA    //选中的项目

注:I2C设置中的器件地址以十六进制保存

5.7 高级段[Advance]

[Advance]    //识别符

Spectrum Function=FunctionName    //频谱观察中选择的C脚本函数,格式为:“app名称#方法名”

Timer Period=300    //定时周期,单位ms

I2C Speed=400    //I2C速率,单位kHz

Auto Update=Yes    //自动刷新

Stop Auto Update=No    //停止自动刷新

Bit Register=Yes    //比特寄存器形式

Word Register=No    //字寄存器形式

5.8 分段信息段[Segment]

[Segment]    //识别符

Number=16    //寄存器的分段数,必须与后面所列分段基地址数一致

00=I2C    //格式:分段基地址(16进制)=分段名

10=MAN

20=AGC

………

F0=RSD

5.9 位寄存器信息段[Bit Register]

列出各个分段的寄存器信息,以比特形式表示,即将寄存器的某几位定义为一个寄存器。每分段先在头部给出该分段基地址,然后列出该分段的寄存器。一个分段列完后空一行,再列新的分段,直到列完所有分段。

[Bit Register]    //识别符

[00]    //[基地址],基地址应[Segment]中有定义,否则无效

Number=8    //该分段包含的寄存器个数(十进制)

00[14: 9]=6'd55      |c_IF_max    //[偏移位域地址]=[位数]’[进制][默认值] |[寄存器名]

01[24:19]=6'd35      |c_IF_min

02[ 7: 0]=8'd43      |c_agc_set

………

[10]    //[基地址],基地址应[Segment]中有定义,否则无效

Number=4    //该分段包含的寄存器个数(十进制)

00[14: 9]=6'd55      |c_cbs_test    //[偏移位域地址]=[位数]’[进制][默认值] |[寄存器名]

01[24:19]=6'd35      |c_cbs_xxx

5.10 字寄存器信息段[Word Register]

列出各个分段的寄存器信息,以字形式表示,即将一个字(RegisterBytes=1时即为1个字节)定义为一个寄存器。其它同[Bit Register]

[Word Register]    //识别符

[基址]    //该分段的基地址,应[Segment]中有过定义,否则无效。

Number=8    //该分段包含的寄存器个数(十进制)

[偏移位域地址]=[位数]’[进制][默认值]    |[寄存器名]

格式同Bit Register,只是位域地址中起始和结束位固定为[8*RegisterBytes-1:0]