LcdTools指令集

1. SetOutIOVCC(ctrl,dly)

[功能] 控制电源IOVCC输出开关。
[格式] SetOutIOVCC(<控制>,<延时>)，ctrl控制字用“ON”来表示打开，“OFF”表示关闭；dly延时时间为控制IOVCC后延时等待时间，单位为mS，最大65535。
[例子] SetOutIOVCC(ON, 100);  //表示开启电源IOVCC输出，之后等待100mS。

2. SetOutVCI(ctrl,dly)

[功能] 控制电源VCI输出开关。
[格式] 格式描述如 SetOutIOVCC()。
[例子]  SetOutVCI(ON,100);  //表示开启电源VCI输出，之后等待100mS。

3. SetOutVSP(ctrl,dly)

[功能] 控制电源VSP输出开关。指令SetOutELVDD同功能。
[格式] 格式描述如 SetOutIOVCC()。
[例子] SetOutVSP(ON,100);  //表示开启电源VSP输出，之后等待100mS。

4. SetOutVSN(ctrl,dly)

[功能] 控制电源VSN输出开关。指令SetOutELVSS同功能。
[格式] 格式描述如 SetOutIOVCC()。
[例子] SetOutVSN(ON,100);  //表示开启电源VSN输出，之后等待100mS。

5. SetOutVCOM(ctrl,dly)

[功能] 控制电源VCOM输出开关。
[格式] 格式描述如 SetOutIOVCC ()。
[例子] SetOutVCOM(ON,100);  //表示开启电源VCOM输出，之后等待100mS。

6. SetOutAVDD(ctrl,dly)

[功能] 控制电源AVDD输出开关。
[格式] 格式描述如 SetOutIOVCC ()。
[例子] SetOutAVDD (ON,100);  //表示开启电源AVDD输出，之后等待100mS。

7. SetOutVGH(ctrl,dly)

[功能] 控制VGH输出开关。
[格式] 格式描述如 SetOutIOVCC ()。
[例子]  SetOutVGH (ON,100);  //表示开启电源VGH输出，之后等待100mS。

8. SetOutVGL(ctrl,dly)

[功能] 控制电源VGL输出开关。
[格式] 格式描述如 SetOutIOVCC ()。
[例子] SetOutVGL (ON,100);  //表示开启电源VGL输出，之后等待100mS。

9. SetOutBL(ctrl,dly)

[功能] 控制背光电源BL输出开关。
[格式] 格式描述如 SetOutIOVCC ()。
[例子] SetOutBL (ON,100);  //表示开启背光电源BL输出，之后等待100mS。

10. SetLcmBL(ctrl,duty)

[功能] 控制背光电源BL输出开关及控制信号PWM占空比。
[格式] SetLcmBL (<控制>,<占空比>)，ctrl控制用“ON”来表示打开，“OFF”表示关闭；duty背光控制信号PWM占空比，设置范围0~100，单位%。
[例子] SetLcmBL (ON,63);  //表示LCM背光打开，控制信号PWM占空比63%（恒流80mA输出量程时，对应输出40mA，注：不同恒流模块会有不同的对应关系）。

11. SetLcmRst(logic,dly)

[功能] 控制LCM复位信号。
[格式] SetLcmRst (<逻辑电平>,<延时>)，logic控制用“1”来表示高，“0”表示低；dly延时时间为控制RST后延时等待时间，单位为mS。
[例子] SetLcmRst (0,100);  //表示LCM复位拉低，之后等待100mS。

12. MipiWrite(mode,dat…)

[功能] MIPI写数据。
[格式] MipiWrite (<数据模式>,<寄存器>,<数据1>,…)，数据模式用“GEN”或“Gen”来表示Generic模式，用“DCS”来表示DCS模式；后面第一个参数为寄存器地址，8bit数，支持十进制和十六进制表示方式；如果寄存器要写多个参数，则在寄 存 器地址参数后依次列出要写参数，以“,”分隔。
[例子] MipiWrite(DCS,0x11);  //以DCS模式写指令0x11，LCM退出休眠模式。
　　   MipiWrite(Gen,0xB6, 0x33,0xDB,0x80,0x12,0x00); //以Genric模式往寄存器0xb6写入5个参数。

13. MipiRead(mode,dat...,cnt)

[功能] MIPI读数据。
[格式] MipiRead (<数据模式>,<数据1>,…,<读取个数>)，数据模式用“GEN”或“Gen”来表示Generic模式，用“DCS”来表示DCS模式；后面第一个参数为寄存器地址，8bit数，支持十进制和十六进制表示方式；寄存器地址后可带参数，DCS读模式没有参数，Generic模式最多可以带两个参数；最后一个参数为MIPI读取参数个数，支持十进制和十六进制数，范围1~255。
[例子] MipiRead(Gen,0xD1,  5);              //以Genric模式从寄存器0xD1读取5个值。
          MipiRead(Gen,0x80,0x02,  1);       //寄存器0x80，带一个参数0x02，读1个值。

14. I2cWrite(sla,subaddr,submode,dat…)

[功能] IIC写数据。
[格式] I2cWrite (<从机地址>,<子地址>,<子地址模式>,<参数1>,…)，从机地址为7位地址，支持十进制和十六进制数；子地址为16位数，低8位为一级子地址，高8位为二级子地址，如果操作没有子地址模式，则该数随便填写一个正确的数字，如0x00；子地址模式用“SUBADDR0”“SUBADDR1”“SUBADDR2”来分别表示无子地址，一个子地址，两个子地址；参数为8位，支持十进制和十六进制表示方式。
[例子] I2cWrite (0x45,0x01, SUBADDR1, 0xa0,0x01); //设备地址（7bit）0x45的0x01寄存器中写入两个参数。

15. I2cRead(sla,subaddr,submode,cnt)

[功能] IIC读数据。
[格式] I2cRead (<从机地址>,<子地址>,<子地址模式>,<读取个数>)，从机地址为7位地址，支持十进制和十六进制数；子地址为16位数，低8位为一级子地址，高8位为二级子地址，如果操作没有子地址模式，则该数随便填写一个正确的数字，如0x00；子地址模式用“SUBADDR0” “SUBADDR1” “SUBADDR2” "SUBADDRN"来分别表示无子地址，一个子地址，两个子地址，多个参数；参数为8位，支持十进制和十六进制表示方式。
[例子] I2cRead (0x45,0x01, SUBADDR1, 5); //设备地址（7bit）0x45的0x01寄存器中读取5个参数。

16. SpiWrite(wire,bitn,cmdlen,cmd,…,dat…)

[功能] SPI写数据。
[格式] SpiWrite (<几线制>,<参数位数>,<命令个数>,<命令1>,…,<参数1>,…)，线制用“WIRE3” “WIRE4”来表示三线和四线制；参数位数用“BIT8” “BIT9” “BIT16”来表示8位 9位和16位参数模式；命令个数，在3线9bit模式和4线8bit模式，参数有命令和数据之分，定义好命令个数，则在他之后的几个参数会以命令模式发送，其他参数则以数据模式发送，命令个数不管什么模式，最小为1；命令和参数支持8位或者16位数，支持十进制和十六进制表示方式。
[例子] SpiWrite(WIRE3,BIT8,1,0x04, 0x07); //SPI 以3线制8bit模式，1个命令0x04写参数0x07。

17. SpiRead(wire,bitn,dummy,cmdlen,cmd,…,cnt)

[功能] SPI读数据。
[格式] SpiRead (<几线制>,<参数位数>,<dummy时钟模式>,<命令个数>,<命令1>,…,<读取个数>)，线制用“WIRE3” “WIRE4”来表示三线和四线制；参数位数用“BIT8” “BIT9” “BIT16”来表示8位、9位、16位参数模式；dummy时钟模式用“DUMMY0” “DUMMY1” “DUMMY2” “DUMMY3” “DUMMY4” “DUMMY5” “DUMMY6” “DUMMY7”表示读数据前发0、1、2、3、4、5、6、7个dummy时钟；命令个数，在3线9bit模式和4线8bit模式，参数有命令和数据之分，定义好命令个数，则在他之后的几个参数会以命令模式发送，其他参数则以数据模式发送，命令个数不管什么模式，最小为1；读取个数范围1~255。
[例子] SpiRead (WIRE3,BIT8,DUMMY1,1,0x0a, 2); //SPI 以3线制8bit模式，1个命令0x0a读取2个参数，读数据前发1个DUMMY时钟。

18. Delay(dly)

[功能] 单位ms延时函数 同delayms()。
[格式] Delay (<延时>)，ms延时，最大支持65535ms。
[例子] Delay (120); //延时120ms。

19. SetMipiMode(mode)

[功能] 设置MIPI速率模式。
[格式] SetMipiMode (<模式>)，模式使用“HS” “LP”来表示高速和低速模式。
[例子] SetMipiMode (LP); //设置MIPI进入低速模式。

20. SetGPIO(chl,logic,dly)

[功能] 设置用户扩展GPIO端口逻辑电平。
[格式] SetGPIO (<通道>,<逻辑>,<延时>)，通道有1~13通道，但不包括第5通道，详情见接口图；逻辑用“1”表示输出高电平，用“0”表示输出低电平；延时为控制逻辑后延时时间，单位ms。
[例子] SetGPIO (4,1, 200); //控制GPIO4输出高电平，延时200ms。

21. LogicOpera(type,mode,opera1,opera2)

[功能] 逻辑运算。
[格式] LogicOpera (<运算类型>,<模式>,<操作数1>,<操作数2>)，逻辑运算类型有“AND” “OR” “NOT” “NAND” “NOR” “XOR” “XNOR”分别表示与 或 非 与非 或非 异或 同或；模式 0表示被操作数2为立即数，即实际数值；模式 1表示被操作数为变量，为指定变量中任意一个；操作数1为目的操作数，为指定变量中任意一个，运算完成后存于该变量中；操作数2为立即数或变量，参与运算。
[格式] LogicOpera (AND,0, rd0,0xff); //读数缓存第一个参数与0xff做逻辑与运算，结果存于rd0中，等于： rd0 &= 0xff。

 22. LogicMove(type,mode,opera1,opera2)

[功能] 逻辑移位。
[格式] LogicMove (<移位类型>,<模式>,<操作数1>,<操作数2>)，逻辑移位类型有“LEFT” “RIGHT”分别表示左移和右移；模式 0表示被操作数2为立即数，即实际数值；模式 1表示被操作数为变量，为指定变量中任意一个；操作数1为目的操作数，为指定变量中任意一个，移位完成后存于该变量中；操作数2为立即数或变量，为移位位数值。
[例子] LogicMove(RIGHT,0, rd0,8); //读数缓存第一个参数右移8位，结果存于rd0中，等于： rd0 >>= 8。

 23. ArthiOpera(type,mode,opera1,opera2)

[功能] 算术运算。
[格式] ArthiOpera (<运算类型>,<模式>,<操作数1>,<操作数2>)，算术运算类型有“ADD” “SUB” “MULT” “DIV” “TO”分别表示加 减 乘 除和赋值；模式 0表示操作数2为立即数，即实际数值；模式 1表示操作数2为变量，为指定变量中任意一个；操作数1为目的操作数，必须为指定变量中任意一个，运算结果存于该变量中；操作数2为立即数或变量，参与运算。
[例子] ArthiOpera (ADD,1, rd0,rd1); //读数缓存第一个参数与第二个参数相加，结果存于rd0中，等于： rd0 += rd1。

24. MatchAssign(mode1,opera1,set,mode2,opera2,match)

[功能] 匹配赋值。
[格式] MatchAssign (<模式1>,<操作数1>,<设定值>,<模式2>,<操作数2>,<匹配值>)，模式1为 0表示设定值立即数，即实际数值，模式1为 1表示设定值为变量，为指定变量中任意一个；操作数1为目的操作数，为指定变量中任意一个，匹配赋值存于该变量中；模式2为 0表示匹配值立即数，即实际数值，模式2为 1表示匹配值为变量，为指定变量中任意一个；操作数2为变量，参与匹配。
[例子] MatchAssign(0,otptimes,1,0, rd0,0xfe); //表示当rd0值恒等于0xfe时，otptimes赋值1，表达式等于：if(rd0 == 0xfe)  otptimes = 1;。

25. ShowPattern (item)

[功能] 显示指定位置用户定制PATTERN。
[格式] ShowPattern (<PAT编号>)，PAT编号最小值为1，1~PatNum（定制画面总数），表示显示指定定制画面；当取值大于定制画面总数上限（PX01定制画面上限50，E860为120）时，显示的为固定画面，(item-PatNumMax)值为1~5时，表示显示红、绿、蓝、黑、白，值大于5时显示图片Fxx.bmp，xx值为(item-PatNumMax-5)；建议该指令只放在PwrOnSequence函数中，在需要自己定义显示PATTERN的时间点时使用该指令，如果不调用该指令，程序会自动按预设显示时序开启显示PATTERN，默认开机显示为用户定制画面第一个画面。
[例子] ShowPattern (1); 　//显示用户定制画面第一个。
　　   ShowPattern (51);   //显示红色(PX01)
　　   ShowPattern (56);   //显示PICTURE F01.BMP(PX01)

26. InitBrige ()

[功能] 初始化桥接芯片，如SSD2828。
[格式] InitBrige ()，不带参数。
[例子] InitBrige (); //初始化桥接芯片。

27. ReadbufCheck (type,pos,dat1,…)

[功能] 接口读数缓存参数比较（MIPI SPI IIC都支持）。
[格式] ReadbufCheck (<比较方式>,<buf起始位置>,<data1>,…)，比较方式可选相同和不同比较，用EQUAL和DIFFER表示；buf起始位置用于指示从读数缓存哪个开始比较，起始位置为0，最大不超过255；data1…为顺序比较数据，全部比较正确报OK，否则报NG并锁死。
[例子] ReadbufCheck(EQUAL,0,0xa0,0x11); //比较读数缓存从第一个数开始，前两个是是否是0xa0,0x11,若是报OK，不是报NG。

28. LcmShowInfoEn (ctrl)

[功能] LCM信息显示使能控制。
[格式] LcmShowInfoEn (<使能控制>)，使能控制用"ON"表示使能，"OFF"表示禁止，LCM在测试时有时一些测试信息会显示到被测LCM，但是如果被测LCM是压缩屏，此时可能会出现显示异常，用改指令关闭LCM信息显示可以避免，默认是打开的。
[例子] LcmShowInfoEn (OFF); //禁止LCM信息显示。

29. SetBufCheckInfo (info1,info2)

[功能] 设置读数缓存数据检测结果显示信息，如比较和匹配测试指令。。
[格式] SetBufCheckInfo (<比较成功显示字符串>,<比较失败显示字符串>)，比较成功字符串用于设定ReadbufCheck()指令比较OK后显示信息，在PG小屏消息窗口显示；同理，比较失败显示字符串用于设定比较NG后显示信息。
[例子] SetBufCheckInfo (“ID CHK OK”,”ID CHK NG”); //
　　   ReadbufCheck(0,0xa0,0x11);                       //读到第一、二个数为0xa0 0x11则显示“ID CHK OK”，表示比较成功；反之显示“ID CHK NG”，表示比较失败。

30. ReadbufMatch (pos,cnt,dat1,dat2,…)

[功能] 匹配读数缓存数值，可以匹配多组数据，用于检测读数缓存中指定位置的几个数是否为几组数中的一种，若存在则报OK，不存在报NG。
[格式] ReadbufMatch(<读数缓存数值起始位置>,<匹配数据个数>,<data1>,…)，读数缓存数值起始位置最小为0，最大255；匹配数据个数最小为1，最大256，读数缓存控件大小为256，请注意起始位置和匹配个数不要超出范围；data为匹配数，以匹配个数为一组，可以填写多组。

[例子] SetBufCheckInfo (“ID CHK OK”,”ID CHK NG”);

　　　ReadbufMatch(0,3, 0xff,0xff,0xff); //从位置0开始匹配三个数，是否为0xff 0xff 0xff

　　    ReadbufMatch(0,3, 0x98,0x81,0x00, 0x98,0x81,0x02, 0x77,0x01,0x01); //从位置0开始匹配三个参数，是否为0x98 0x81 0x00或0x98 0x81 0x02或0x77 0x01 0x1三组中一组，如果有则匹配成功，不存在则报失败。