控制卡SCL程序员手册

彭小姐：18922838305QQ：316475616深圳励研科技SCL程序员手册第一章概述在本文的叙述中，一般情况下，针对SuperComm进行解释，圆括号中的“SCL2008:”则表示SCL2008的区别。SuperComm控制器播放的图象，每个象素的颜色使用两个字节(byte)来表示,称为16位色图片；SCL2008控制器播放的图象，每个象素仅使用两个位(bit)来表示，称为双色图片。对于相同大小的图片，SCL2008的数据量仅是SuperComm的八分之一左右。SuperComm系列/SCL2008系列控制器的存储空间采用FAT16文件管理系统。SuperComm控制器有SD卡(B盘)和RAM(C盘)两个磁盘，SCL2008有FLASH盘(A盘)和RAM(C盘)两个磁盘。所有待播放的图片都以文件形式存储在控制器的某个磁盘中。这些图片的播放方式、停留时间等均由节目表文件来控制。节目表文件的名字必须是PLAYLIST.LY。控制器上可以存储多达100套节目，不同的节目及相关的图片文件按照节目的索引存放在不同的目录中。例如，SD卡上的第0套节目存储在B:\P00子目录下，RAM盘的第8套节目存储在C:\P08子目录下。控制器的节目管理遵循如下结构：1、一共可以存储100套节目，每套节目按其子目录名进行管理，如P00中存放第0套节目，P09子目录中存放第9套节目。每次给控制器通电时只能播放一套节目，由Config.Ly中的节目索引来指定播放哪一套节目；第二章节目表文件PLAYLIST.LY和配置文件Config.ly彭小姐：18922838305QQ：316475616§2.1PLAYLIST.LY概述节目表文件是一个INI类型的文件。可以用记事本打开并编辑，也可以用程序自动生成该文件。节目表文件的基本结构如下：[Program1]定时信息主区域索引区域个数[Program1_Screen1]区域1的位置和大小区域1播放的项数第1项的属性第2项的属性第n项的属性[Program1_Screen2]区域2的位置和大小彭小姐：18922838305QQ：316475616区域2的播放项数第1项的属性第2项的属性第m项的属性[Program2][Program3][ProgramN]这里，N最大可到200(即一个节目表最大可容纳200个节目)§2.2PLAYLIST.LY中的定时信息每个节目可以规定它的播放时段。控制器在处理该节目前，会先将定时信息与控制器自带的日历时钟进行比较，若当前时间处于节目的定时时段内，则该节目将会被播出，否则该节目不会播出。一个定时项由如下的定义构成：TimerX=YYyyMMmmDDdd，这里X等于1-8，即可给出8个时间段。YY：本时间段的开始年份；yy：本时间段的结束年份，若定时与年份无关，则YY=00，yy=99；MM：本时间段的开始月份；mm：本时间段的结束月份，若定时与月份无关，则MM=01，mm=12，表示从1月到12月；DD：本时间段的开始日期；dd：本时间段的结束日期，若定时与日期无关，则DD=01，dd=31，表示从1日到31日；WW：本时间段的开始周日；ww：本时间段的结束周日，若定时与星期几无关，则WW=01，ww=07，表示从周一到周日；彭小姐：18922838305QQ：316475616HHNN：本时间段开始的时分；hhnn：本时间段结束的时分，若定时与时分无关，则HHNN=0000，hhnn=2359，表示从0点0分到23点59分。例如，定在7月、8月的10日到25日之间的星期六、星期日的上午8点到中午12点播放的节目，定时项写成：Timer1=009907081025060708001200Timer1-Timer8都应该一一列出，不可缺少，否则控制器上的播放器会因为查找某个定时项而浪费时间，导致节目间切换的时间变得很长。不用的定时项可以全部写成0，但第一个定时项必须明确给出，尽管可能该节目根本不使用任何定时属性。不使用定时属性的定时项写成：Timer1=009901120131010700002359Timer2=000000000000000000000000Timer3=000000000000000000000000Timer4=000000000000000000000000Timer5=000000000000000000000000Timer6=000000000000000000000000Timer7=000000000000000000000000Timer8=000000000000000000000000§2.3PLAYLIST.LY中的主区域索引每个节目都必须有一个区域是主区域，该节目的播放时间以主区域的播放时间为准。若主区域中的所有节目项都已播放完毕，则该节目结束。若从区域的节目项都已播放完毕，但主区域尚未完成，则从区域循环从头开始播放。主区域的定义格式如下：MainScreen=n，这里n表示该节目的某个区域的索引，可从1-4之间(SCL2008:1-3之间)取数，但不得大于其后定义的区域数。§2.4PLAYLIST.LY中的区域数彭小姐：18922838305QQ：316475616一个节目可以分成几个区域来独立播放。区域数定义了该节目有多少个独立区域。SuperComm控制器最大支持四个独立区域，SCL2008控制器最大支持三个独立区域。区域数的定义格式如下：Screen=n，这里n可从1-4(SCL2008:1-3)之间取数。§2.5PLAYLIST.LY中的区域位置和大小每个区域的大小和位置可任意指定。若这些区域间有重叠，则一般情况下是定义靠后的区域可覆盖定义靠前的区域，除非定义靠后的区域没有数据更新，但定义靠前的区域有新的播放项。区域的位置和大小定义如下：Position=Left,Top,Width,HeightLeft、Top为该区域的左上角坐标，Width和Height分别为该区域的宽和高。控制器最大控制范围为960列(SCL2008:可显示4032列，内部按4096列处理)，512行。一般情况下控制器安装在显示屏的右侧(正面看屏)，所以，Left坐标需要往右调整。显示屏的最左边的坐标为最大控制范围-显示屏宽度。假设显示屏宽度为256列，则最左边的坐标为960-256=704(SCL2008:4096-256=3840)。§2.6PLAYLIST.LY中的播放项数一个区域可以安排播放多个文件(每个文件称为一个节目项)，每个区域最多可安排播放200个节目项。播放项数的定义为：ItemCount=n，这里n就是实际的播放项数，可从0-200。§2.7PLAYLIST.LY中的节目项属性节目项是可播放的一个文件。定义节目项的格式如下：ItemN=type,Drv:PathFileName,Entermode,Step,Staytime其中：ItemN：可为Item1-Item255，后面的数字不可大于前面定义的播放项数，否则该项不会被播出；type：文件类型，可取值为字母‘F’、‘P’、‘T’、‘X’或‘S’。彭小姐：18922838305QQ：316475616‘F’FLASH类图片，必须快速直接贴到播放区域中‘P’普通的图片‘T’时钟项，时钟项文件可显示时间、温度、湿度、串口数据、倒计天数等等‘X’文本文件，文本文件要求预先上载字库并在Config.LY中定义安装，文本中可以包含扩展显示码，关于字库和扩展显示码，请参见第七章‘S’系统命令，可实现节目表之间的跳转和返回(支持多级跳转，仅支持一级返回)Drv：节目项文件所在的驱动器，可取值为A(FLASH盘)、B(SD卡)或C(RAM盘)，若文件与节目表文件PLAYLIST.LY在同一驱动器中，则这里的Drv可以省略；Path：路径，格式为“\Pxx\”或“\”(这里x为数字字符‘0’-‘9’),前者表示某子目录，后者表示根目录。若无路径，则表示该文件与节目表位于同一子目录；如果FileName：节目项文件名。SuperComm/SCL2008控制器仅支持8.3格§2.8PLAYLIST.LY节目表文件示例一个包含三个节目的完整的节目表文件示范如下：(节目1包含三个区域，节目2包含2个区域，节目3包含1个区域)[Program1]Timer1=009901120131010700002359Timer2=000000000000000000000000Timer3=000000000000000000000000Timer4=000000000000000000000000Timer5=000000000000000000000000Timer6=000000000000000000000000Timer7=000000000000000000000000Timer8=000000000000000000000000MainScreen=1彭小姐：18922838305QQ：316475616Screen=3[Program1_Screen1]Position=576,0,263,86ItemCount=1Item1=P,SUPERC~1.d01,4,1,5[Program1_Screen2]Position=576,90,228,167ItemCount=2Item1=P,m71a.j01,0,1,3Item2=P,zr29a.j01,0,1,3[Program1_Screen3]Position=808,90,153,167ItemCount=1Item1=T,H8W1C1AQ.tmc,1,1,65535[Program2]Timer1=009901120131010700002359Timer2=000000000000000000000000Timer3=000000000000000000000000Timer4=000000000000000000000000Timer5=000000000000000000000000Timer6=000000000000000000000000Timer7=000000000000000000000000Timer8=000000000000000000000000MainScreen=2Screen=2[Program2_Screen1]Position=576,0,384,29彭小姐：18922838305QQ：316475616ItemCount=2Item1=P,0002a.j01,1,1,5Item2=P,0003a.j01,1,1,5[Program2_Screen2]Position=576,30,384,226ItemCount=3Item1=P,34a.x01,0,1,5Item2=P,ANIMAL~1.j01,0,1,5Item3=P,auto255c.j01,0,1,5[Program3]Timer1=009901120131010700002359Timer2=000000000000000000000000Timer3=000000000000000000000000Timer4=000000000000000000000000Timer5=000000000000000000000000Timer6=000000000000000000000000Timer7=000000000000000000000000Timer8=000000000000000000000000MainScreen=1Screen=1[Program3_Screen1]Position=576,0,384,256ItemCount=1I