本章主要介绍配置文件的格式,除非对配置文件格式很熟悉,否则建议不要人工修改配置文件,请通过【文件】菜单下的【保存配置】来保存配置。
配置文件由[Global]、[Button]、[Indicator]、[Trace]、[Monitor]、[I2C Set]、[Advance]、[Segment]、[Bit Register]和[Word Register]组成,下面描述时所用的红色字符表示本例子中的内容,需要由实际内容替代。“//”后面为对应的说明,实际中并不需要。
本软件有Main和Slave两个页面,对应独立的配置文件,两者格式一致。
[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”。
[Button]段保存按钮操作Button的配置信息:
[Button] //识别符
Button 1=FunctionName|Caption|Paramnum|param1,param2|Remind|isReturnValue //第1个按钮的配置
………
Button 配置说明
[Indicator]段保存按钮操作Indicator的配置信息:
[Indicator] //识别符
Indicator 1=FunctionName|Caption|Type //第1个指示灯的配置
Indicator 2=FunctionName|Caption|Type //第2个指示灯的配置
Indicator 3=FunctionName|Caption|Type //第3个指示灯的配置
………
Indicator 配置说明
[Trace]段保存按钮操作Trace的配置信息:
[Trace] //识别符
Trace 1=FunctionName|Caption //第1个跟踪显示的配置
Trace 2=FunctionName|Caption //第2个跟踪显示的配置
Trace 3=FunctionName|Caption //第3个跟踪显示的配置
………
Trace 配置说明
[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 配置说明
[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设置中的器件地址以十六进制保存
[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 //字寄存器形式
[Segment] //识别符
Number=16 //寄存器的分段数,必须与后面所列分段基地址数一致
00=I2C //格式:分段基地址(16进制)=分段名
10=MAN
20=AGC
………
F0=RSD
列出各个分段的寄存器信息,以比特形式表示,即将寄存器的某几位定义为一个寄存器。每分段先在头部给出该分段基地址,然后列出该分段的寄存器。一个分段列完后空一行,再列新的分段,直到列完所有分段。
[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
列出各个分段的寄存器信息,以字形式表示,即将一个字(RegisterBytes=1时即为1个字节)定义为一个寄存器。其它同[Bit Register]
[Word Register] //识别符
[基址] //该分段的基地址,应[Segment]中有过定义,否则无效。
Number=8 //该分段包含的寄存器个数(十进制)
[偏移位域地址]=[位数]’[进制][默认值] |[寄存器名]
格式同Bit Register,只是位域地址中起始和结束位固定为[8*RegisterBytes-1:0]