KV CAS API PROTOCOL FOR SMS - Trigital Technologies

DTSS Technology Corporation Ptv. Ltd.
Serial number：
Level: Confidential
DTSS
SMS to CAS API communication protocol
Version 5.0
Department：CAS
Project Name：CAS5.0
Authors：Stephens
Leader：Sharp
Audit：Stephens
Level：Confidentiality
Date of completion：
Update：2017/1/11
 Scope：The interface applies only between SMS and DTSSCAS。

 Version History：(the font in blue said recently modified content)
version Modified Author Updates

5.0
5.01 2014-12-01 Lin Add fingerprint and user message protocol
5.02 2014-12-03 Lin Update description information and sample for fingerprint
5.03 2015-01-12 Lin Update fingerprint and message protocol
5.04 2015-08-14 Lin Delete 0412 message
5.05 2015-09-07 Lin Add 0113.0114.0115.0116.0214protocal
5.06 2015-09-11 Lin 0117protocal add packname section
5.07 2015-09-12 Lin Modify 0215 protocol
5.08 2015-09-14 Lin Add 0118.0119.0120.0121 protocol
modify 0411 protocal
5.09 2015-09-15 Lin Add 0213,0214 protocal
Update all entitlement protocol
5.0.10 2016/12/16 hbin Add 3 types error code
5.0.11 2017/1/11 Wu Delete command 0203 for India
Index
SMS to CAS API communication protocol .......................................................................................................... 1
 Data Type Description ................................................................................................................................ 5
 SMS to CA command format ..................................................................................................................... 5
 CmdType List： ...................................................................................................................................... 5
Response Command Format(Except for some special Commands) .................................................................. 8
1. System class ....................................................................................................................................................... 9
1.1. SMS request program information from ca(0101) ............................................................................. 9
1.2. CA to return the basicpackage structure(0102) .................................................................................. 9
1.3. Send the reminders fee settings(0109) ............................................................................................. 10
1.4. Add/Update Region/(0114) .............................................................................................................. 10
1.5. Delete Region/(0115) ....................................................................................................................... 11
1.6. Sync Region/(0116) .......................................................................................................................... 11
1.7. Get All Packages From ca(0117) ...................................................................................................... 11
1.8. Get blacklist From ca(0118) ............................................................................................................. 12
1.9. Reponse blacklist From ca(0119) ..................................................................................................... 12
1.10. Add blacklist(0120) .......................................................................................................................... 13
1.11. Delete blacklist(0121) ...................................................................................................................... 13
1.12. Response All Packages From ca(0122) ............................................................................................ 14
1.13. Send channel/basicpackage list to ca (0123) ........................................................................... 14
1.14. Send Package list to ca (0124) ...................................................................................................... 15
2. User class ......................................................................................................................................................... 15
2.1. Enabling Smart Card(0201).............................................................................................................. 15
2.2. Disable Smart Card(0202) ................................................................................................................ 16
2.3. STB- card pairing / Cancel(0203) .................................................................................................... 16
2.4. Changing Card(0204) ....................................................................................................................... 17
2.5. Conditions limit broadcast / Cancel(0206) ....................................................................................... 17
2.6. Reset the PIN code(0207)................................................................................................................. 18
2.7. Allow recording/ disable (0208)....................................................................................................... 18
2.8. Wallet recharge (0210) .................................................................................................................. 18
2.9. Updated information on the smart card in a field ( 0212 ) ............................................................... 19
2.10. Add EMM FingerPrint ( 0213 ) ........................................................................................................ 19
2.11. Delete EMM FingerPrint ( 0214 ) .................................................................................................... 20
2.12. Add ECM FingerPrint ( 0215 )......................................................................................................... 21
2.13. Delete ECM FingerPrint ( 0216 ) ..................................................................................................... 22
2.14. Pause Entitlement( 0217) ................................................................................................................. 22
2.15. Resume Entitlement ( 0218) ............................................................................................................. 23
3. Authorized class ............................................................................................................................................... 23
3.1. Add Authorization(0301) ................................................................................................................. 23
3.2. Cancel Authorization(0302) .......................................................................................................... 24
3.3. Suspend Authorization(0303) ........................................................................................................... 25
3.4. Resume Authorization(0304) ........................................................................................................... 25
3.5. Cancel all authorizations(0305)........................................................................................................ 25

Response: Response Command Format ........................................................................................................... 26
3.6. primary-secondary binding / Cancel(0306) ...................................................................................... 26
3.7. Authorization synchronization(0307)............................................................................................... 26
4. Message class ................................................................................................................................................... 27
4.1. Send e-mail (0401) ........................................................................................................................... 27
4.2. Send OSD(0402) .............................................................................................................................. 27
4.3. Delete OSD (0403) ........................................................................................................................... 29
4.4. Modify OSD (0404) ......................................................................................................................... 29
4.5. User Message (0411) ........................................................................................................................ 30
4.6. Delete User Message (0412) ............................................................................................................ 30
4.7. User Message (0413) ........................................................................................................................ 31
5. test Command format ....................................................................................................................................... 32
 Data Type Description

SMS uses strings to communicate with CA, Several format string contains the following:
Code Data Types Description Examples
D(x) Decimal using a character '0 ~ 9' x-bit characters D(4) ‘ 0014 ’ Means the
represent a decimal number, decimal value 14
H(x) Hexadecimal With an x-bit character by character '0-9' or H (4) '001A' - the hexadecimal
'A ~ F' consisting of a hexadecimal number number 1A, converted to a
decimal value of 26
S(x) String With x arbitrary string codes (including S (3) 'DVB' - Means string
control characters) to form a string DVB
(Table I)
 SMS to CA command format
Instances name Number of instances in command
Command Header 1
CommandCode 1
AddressCondition
0-1
CommandBody 0-1
MD5 (32Bytes) 1
MD5Include Header, Type, Address Condition AND Body.
MD5 TestKey = ‘08cf5af957043d91b8046fc4052bd63a’;
Struct CommandHeader
{
Serial number H(8) 00000000-FFFFFFFF eg.:0000000A
CASYSID H(4) fixed:9101
Version D(4) eg:0400
Follow-up length H(4) eg:002C,The total length of the follow-up,not include MD5
}
Eg:0000000A91010400002C
Struct CommandType
{
CmdType D(4) eg:0101
}
 CmdType List：
CmdType Request Type Description

SMS request program information SMS request program information from ca
0101
from ca
0102 CA response program list
0109 Setting for reminder fee

Display / Cancel fingerprint Display / cancel the card number on the
0110
screen display
0201 Enabling Smart Card SMS allocated a certain smart cards to users
0202 Disable Smart Card SMS cancel smart card
Machine card pairing / cancel
0203
pairing
Changing Card User changing the card, to enable the new
card, the old card of the original
0204
authorization to be transferred to the new
card, and disable the old card
0206 Conditions limit
Clear Passwords PIN Code of the smart card reset to default
0207
values
0208 Recording Control
0210 Wallet recharge
Updated information on the smart
0212
card in a field
0213 Add EMMG fingerprint
0214 Delete Emmg fingerprint
0215 Add Ecmg fingerprint
0216 Delete Ecmg fingerprint
Add / modify one or more of the

0301 Authorization(by business /
product)
Cancel one or more of the
0302 Authorization(by business /
product)
0303 Suspend Authorization
0304 Resume Authorization
0305 Cancel all authorizations Including PPV and PPC
primary-secondary binding /
0306
Cancel
0307 Authorization synchronization
0401 Send e-mail Send mail to specified users

0402 Send OSD Send OSD to specified users

Delete OSD Remove the screen by the OSD
0403
identification
Modify OSD Modify the screen by the OSD
0404
identifies ,only modify the content
0411 Send User Message
0500 Test Command Cleint send a test Command, the server in

0501 Response Command response to 0501
Struct AddressCondition
{
AddressLen H(2) eg:13
Layer Count H(2) fixed:01 or 00, 00 means all users
For(i=0; i<layercount; i++)
{
Address Code H(2) eg:01,defined in the table below
Loop Count H(2)
For(i=0; i<loopcount; i++)
{
Start value D(9) eg:000000001
Number H(4) ex:000C
}
}
}
Eg:1F010102000000001000A0000000120005
Represents the card number from 1-10 and 12 -17
Note: 0200 means that all users
Addressing code definitions：
Addressing Name Format

code
0x01 Smart Card D(9)
0x02 Group ID D(9)
0x03 Postal Code D(9)
0x0A Custom signature 1 D(9)
0x0B Custom signature2 D(9)
0x0C Custom signature3 D(9)
0x0D Custom signature4 D(9)
0x0E Network ID D(9)
Response Command Format(Except for some special Commands)
Number of instances in Command

Instances name
Commandheader 1
CommandType 1
ResponseCode(4Bytes) 1
MD5 1
ResponseCode:
ResponseCode Description
S000 Success
E000 unknown error
E001 Invalid Command Type
E002 Invalid SMS Number
E003 Request packet length is wrong
E004 CASYSID error
E005 CA Version error
E006 Addressing expression error
E007 Smart card does not exist
E008 Package number is invalid
E171 Operator ID error
E241 Invalid new card number
E242 The card in blacklist
E243 The stbid in blacklist
E244 The stbid used
 Remarks：
1. Time format definition：
the use of a uniform time format, 14-length string: (YYYYMMDDHHMMSS).
Command Format
1. System class
1.1. SMS request program information from ca(0101)
Components
Command header
CommandType
MD5
Example:000000019101040000040101+MD5(32Bytes)
Success response:0102Command
Fail response:Response Command Format
1.2. CA to return the basicpackage structure(0102)
Components
Command header
CommandType
CommandBody
MD5
Struct Commandbody
{
BasicPackageCnt H(2) eg:01
For(i=0; i<BasicPackageCnt;i++)
{
BasicPackageNo H(4) eg:0001
BasicPackage type H(2) eg:00 0:PPC 1:IPPV 2:IPPT
Basic package name S(40) eg:mypackage1
ChannelCnt H(2) eg:02
For(int i=0; i<ChannelCnt; i++)
{
Channel number H(4) eg:0001
Channel name S(40) eg:tvname1
}
}
}
Example:0000000191010400008E010201000100mypackage1
020001tvname1
0002tvname2 +MD5(32Bytes)
Note:SMS uses the basic package combined product package
1.3. Send the reminders fee settings(0109)

Components
Command header
CommandType
CommandBody
MD5
Struct Commandbody
{
Reminder fee type H(2) 01:Frequency 02:Period
Time H(2) if(Reminderfeetype == 1)
Time means show times
If(Reminderfeetype == 2)
Time means show Frequency (Hours)
FrontDay H(2) days before authority expires
ContentLength H(2) Maximum 50 = Decimal 80
Content S(ContentLength ) eg:Your license is about to expire, please recharge
}
Example:
0000000191010400003C010901050F30Your license is about to expire, please recharge+MD5(32Bytes)
Response: Response Command Format+MD5(32Bytes)
1.4. Add/Update Region/(0114)

Components
Command header
CommandType
CommandBody
MD5
Struct Commandbody
{
PostcalCode S(6)
RegionNameLen H(2)
RegionName S(RegionNameLen)
}
Example: 00000001690204000010011461173104xipu+MD5(32Bytes)
Response: Response Command Format
1.5. Delete Region/(0115)

Components
Command header
CommandType
CommandBody
MD5
Struct Commandbody
{
PostcalCode S(6)
}
Example: 0000000169020400000A0115611731+MD5(32Bytes)
1.6. Sync Region/(0116)

Components
Command header
CommandType
CommandBody
MD5
Struct Commandbody
{
LoopCnt H(2)
for(i=0; i<LoopCnt; i++)
{
PostcalCode D(6)
RegionNameLen H(2)
RegionName S(RegionNameLen)
}
}
Example: 0000000169020400002101150261173104xipu61401307yangwan
1.7. Get All Packages From ca(0117)

Components
Command header
CommandType
MD5
Example: 000000016902040000040117+MD5(32Bytes)
Response: Response 0122 protocal
1.8. Get blacklist From ca(0118)

Components
Command header
CommandType
CommandBody
MD5
Struct Commandbody
{
start_index H(8) from 1 start
count H(2) Number of requests, maximum 255 per request
}
Example:
000000016902040000040118+MD5(32Bytes)
000000016902040000040118+MD5(32Bytes)
000000016902040000040118+MD5(32Bytes)
Response: Success response:0109Command
1.9. Reponse blacklist From ca(0119)

Components
Command header
CommandType
CommandBody
MD5
Struct Commandbody
{
max_index H(8) all records count
respose_cnt H(2) The response number
for(int i=0; i< respose_cnt; i++)
{
ic_no D(8)
stb_id D(8)
}
}
Example:
0000000169020400002001190000006400020000000100000002+MD5(32Bytes)
Response:
1.10. Add blacklist(0120)

Components
Command header
CommandType
CommandBody
MD5
Struct Commandbody
{
ic_cnt H(2) max 255 per request
for(int i=0; i< ic_cnt; i++)
{
ic_no D(8)
stbid D(8)
}
}
Example:
000000016902040000160120020000000100000002+MD5(32Bytes)
1.11. Delete blacklist(0121)

Components
Command header
CommandType
CommandBody
MD5
Struct Commandbody
{
ic_cnt H(2) max 255 per request
for(int i=0; i< ic_cnt; i++)
{
ic_no D(8)
}
}
Example:
000000016902040000160121020000000100000002+MD5(32Bytes)
1.12. Response All Packages From ca(0122)

Components
Command header
CommandType
CommandBody
MD5
Struct Commandbody
{
PackageCnt H(4)
for(int i=0; i< PackageCnt; i++)
{
PackageNo H(4)
PackName S(40)
BaseProductCnt H(4)
for(int j=0; i< BaseProductCnt; j++)
{
BasicPackageNo H(4)
}
}
}
Example:000000016902040000B0012200030001pack1
0002000100020002pack2 0002000300040003pack3
000200050006+MD5(32Bytes)
Response:
1.13. Send channel/basicpackage list to ca (0123)

Components
Command header
CommandType
MD5
Struct Commandbody
{
package_cnt H(4)
for(int i=0; i< package_cnt; i++)
{
package_no H(4)
name_len H(2)
name S(name_len)
}
}
Example:
Response:
1.14. Send Package list to ca (0124)

Components
Command header
CommandType
CommandBody
MD5
Struct Commandbody
{
package_cnt H(4)
for(int i=0; i< package_cnt; i++)
{
package_no H(4)
name_len H(2)
name S(name_len)
Starttime D(14)
Endtime D(14)
{
Channel _cnt H(4)
for(int i=0; i< Channel _cnt; i++)
{
ACNo H(4)
}
}
}
}
Example:
Response:
2. User class
2.1. Enabling Smart Card(0201)

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
Group ID D(9) eg:000000001
Community D(9) eg:614013001
CASVer D(9) fixed:000000400
STBID D(9) eg:000000000
Custom signature 1 D(9) User-defined
NetworkID D(9)
}
Example:0000000191010400006A02011301010107777777700010000000000000642000000004000000000
00000036000000000000000000000000000000000000000+MD5(32Bytes)
2.2. Disable Smart Card(0202)

Components
Command header
CommandType
AddressCondition
MD5
Example:000000019101040000190202130101010777777770001+MD5(32Bytes)
2.3. STB- card pairing / Cancel(0203)

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
State D(1) 1:Pairing 0:Cancel pairing
}
Example:0000000191010400001A02031301010107777777700011+MD5(32Bytes)
2.4. Changing Card(0204)

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
NewCard D(8) eg:00000010
}
Remark:Changing the card only for a single card
Example:00000001910104000021020413010101077777777000100000010+MD5(32Bytes)
2.5. Conditions limit broadcast / Cancel(0206)

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
State D(1) 1:limit 0:Cancel limit

}
2.6. Reset the PIN code(0207)

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
PinCode D(6) eg:123456
}
Example:0000000191010400001F0207130101010777777770001123456+MD5(32Bytes)
2.7. Allow recording/ disable (0208)

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
State D(1) 1:Allow 0:Ban
}
2.8. Wallet recharge (0210)

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
Totalpoints H(8) eg:0x00000064
}
Example:0000000191010400001D02101301010107777777700010064+MD5(32Bytes)
2.9. Updated information on the smart card in a field ( 0212 )

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
FieldNum H(2)
For(i=0; i<FieldNum; i++)
{
AddressingCode H(2) 02-0E
Value D(9)
}
}
Example:000000019101040000260212130101010777777770001010E000001111+MD5(32Bytes)
2.10. Add EMM FingerPrint ( 0213 )

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
FPId H(8)
ShowType H(1) 0:hide 1:overt 2:covert
EncrptState H(1) 0: not encrypt 1: encrypt
ForceState H(1) 0: not force 1: force
Sparkle H(1) 0: not Sparkle 1:Sparkle
StartTime D(14) yyyymmddHHMMSS
Duration H(4) seconds
Repetitions H(4)
Interval H(4) seconds
FontSize H(2)
Layout H(1) 0:Absolute 1:Percentage
frame of reference H(1) 0:screen 1:video
XSize H(4) bkground width FFFF means auto
YSize H(4) bkground heigth FFFF means auto
XPos H(4) bkground x position FFFF means auto
YPos H(4) bkground y position FFFF means auto
FontColor H(6) eg:FF00FF
Bkground Color H(6) eg:FFFF00
Transparent H(2) max:0x64
ShowItem H(2) 01: show card number
02:show ird number
03:show card and ird number
ContentLen H(4) Byte Count
ContentCoding H(2) 00:ASCII 01:unicode 02:gbk 03:utf-8
Content S(ContentLen)
}
Example:0000000169020400006D02131301010100000000100010000000110002015011300000000640
010000A1600FFFFFFFFFFFFFFFFFF00FF00FF003201000403test+MD5(32Bytes)
2.11. Delete EMM FingerPrint ( 0214 )

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
FPId H(8)
}
Example:00000001910104000021021413010101077777777000100000001+MD5(32Bytes)
2.12. Add ECM FingerPrint ( 0215 )

Components
Command header
CommandType
CommandBody
MD5
Struct CommandBody
{
LoopCnt H(4) 0000: all channel
for(int i=0; i<LoopCnt; i++)
{
ProgramNo H(4)
LastCnt H(2)
}
ShowType H(1) 0:hide 1:overt 2:covert
EncrptState H(1) 0:not encrypt 1:encrypt
Sparkle H(1) 0:not Sparkle 1:Sparkle
Force H(1) 0:not force 1:force
Duration H(4) seconds
Interval H(4) seconds
EndTime D(14) yyyymmddHHMMSS
FontSize H(2)
Layout H(1) 0:Absolute 1:Percentage
frame of reference H(1) 0:screen 1:video
XSize H(4) bkground width FFFF means auto
YSize H(4) bkground heigth FFFF means auto

XPos H(4) bkground x position FFFF means auto
YPos H(4) bkground y position FFFF means auto
FontColor H(6) eg:FF00FF
Bkground Color H(6) eg:FFFF00
Transparent H(2) max:0x64
ShowItem H(2) 01: show card number
02:show ird number
03:show card and ird number
}
Example:
2.13. Delete ECM FingerPrint ( 0216 )

Components
Command header
CommandType
CommandBody
MD5
Struct CommandBody
{
LoopCnt H(4) 0000: all channel
for(int i=0; i<LoopCnt; i++)
{
ACNo H(4)
LastCnt H(2)
}
}
Example:
2.14. Pause Entitlement( 0217)

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
smsPackage Cnt H(2)
For(int i=0; i<smsPacketCnt; i++)
{
PackageNo &ChannelNo H(8)
OrderType H(2) 00:PPC 01:IPPV 02:IPPT
the start time of Authorization D(14) eg:20141121000000
the endtime of Authorization D(14) eg:20151121235959
}
}
Example:
2.15. Resume Entitlement ( 0218)

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
smsPackage Cnt H(2)
{
PackageNo &ChannelNo H(8)
}
}
Example:
3. Authorized class
3.1. Add Authorization(0301)

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
smsPackage Cnt H(2)
{
PackageNo&ChannelNo H(8)
}
}
Example:
Note:adding new authorization on the basis of the original authorization
3.2. Cancel Authorization(0302)

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
smsPackage Cnt H(2)
{
}
}
Example:
3.3. Suspend Authorization(0303)

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
Suspend type H(2) fixed:00
SuspendTime D(14) StartTime to Suspend eg:20141121000000
Month Num H(2) fixed:00
}
Example:0000000191010400002B0303130101010777777770001002014062009081600+MD5(32Bytes
)
3.4. Resume Authorization(0304)

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
ResumeTime eg:20140620090816
}
Example:00000001910104000027030413010101077777777000120140620090831+MD5(32Bytes)
3.5. Cancel all authorizations(0305)

Components
Command header
CommandType
AddressCondition
MD5
Example:000000019101040000190305130101010777777770001+MD5(32Bytes)
3.6. primary-secondary binding / Cancel(0306)
Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
Type H(1) 0: Cancel 1:Bind
BindCycle H(2) days eg:14
MotherCard D(8) eg:00000003
}
Example:00000001910104000024030613010101077777777000111400000003+MD5(32Bytes)
3.7. Authorization synchronization(0307)

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
smsPackage Cnt H(2)

{
}
}
Example:
Note:CA will clear all of the authorization and modified into new authorization
4. Message class
4.1. Send e-mail (0401)
Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
StartTime D(14) The start time to broadcast email
EndTime D(14) The end time to broadcast email
TitleLength H(2) <=40 bytes
Title S(TitleLength)
ContentLength H(3) <=800bytes
Content S(ContentLength)
TailLength H(2) <=20bytes
Tail S(TailLength)
}
Example:0000000191010400004004010200201406251921032014062619210305title00Ctesttesttest04ta
il+MD5(32Bytes)
4.2. Send OSD(0402)

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
OsdID D(12) eg:201411210001
StartTime D(14) eg:20141121000000
EndTime D(14) eg:20141122000000
TimeSection D(8) eg:08001700 Show from 08:00 to 17:00
Osd cycle H(2) minutes eg:14 means once every 20 minutes
Speed H(2) fixed:80
BasicPackageCnt H(2)
For(i=0; i<BasicPackageCnt; i++)
{
BasicPackageNo H(4)
}
ActionType D(1) fixed:1
Position1 D(3) fixed:000
Position2 D(3) 000:top show 001:bottom show
Lines D(2) fixed:01
Width D(3) fixed:000
FontColor D(1) see table below
BackGroundColor D(1) see table below
Type D(1) fixed:0
ContentLength H(3) <=510bytes
Content S(ContentLength)
}
Example:0000000191010400006204020200201408010001201408011210492014080212104900002359
015000000000101000910012this is a test osd+MD5(32Bytes)
Color definition：
0 Transparent color
1 White
2 Red
3 Orange
4 Yellow
5 Green
6 Cyan
7 Blue
8 Purple
9 Black
4.3. Delete OSD (0403)
Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
OsdId D(12)
}
Example:0000000191010400001404030200201408010001+MD5(32Bytes)
4.4. Modify OSD (0404)

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
OsdId D(12)
ContentLength H(3)
Content S(ContentLength) <=510bytes
}
Example:0000000191010400002904040200201408010001012this is a test osd+MD5(32Bytes)

4.5. User Message (0411)

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
MessageID H(8)
ShowType H(1) 0:hide 1:show
ForceType H(1) 0:not force 1:force
StartTime H(14) show starttime
EndTime H(14) show endtime
FontSize H(2) eg.:18
LayOut H(1) 0:absolute 1:percentage
Frame H(1) 0:screen 1:video
XPos H(4) FFFF means auto,only for PostionType=5
YPos H(4) FFFF means auto,only for PostionType=5
XSize H(4) FFFF means auto,only for PostionType=5
YSize H(4) FFFF means auto,only for PostionType=5
Fontcolor H(6) RGB eg.:FF00FF
BKColor H(6) RGB eg.:FF00FF
Transparent H(2) 00-64
ConentLen H(4) 0000-0400 hex(0400) = dec(1024)
Content S(ConentLen)
}
Example:
4.6. Delete User Message (0412)

Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
MessageID H(8)
}
Example:
4.7. User Message (0413)
Components
Command header
CommandType
AddressCondition
CommandBody
MD5
Struct CommandBody
{
MessageID H(8)
ChannelCnt H(4) if=0 mean all channels
for(int i=0; i<ChannelCnt; i++)
{
ACNo H(4)
}
ShowType H(1) 0:hide 1:show
ForceType H(1) 0:not force 1:force
StartTime H(14) show starttime
EndTime H(14) show endtime
FontSize H(2) eg.:18
LayOut H(1) 0:absolute 1:percentage
Frame H(1) 0:screen 1:video
XPos H(4) FFFF means auto,only for PostionType=5
YPos H(4) FFFF means auto,only for PostionType=5
XSize H(4) FFFF means auto,only for PostionType=5
YSize H(4) FFFF means auto,only for PostionType=5
Fontcolor H(6) RGB eg.:FF00FF
BKColor H(6) RGB eg.:FF00FF
Transparent H(2) 00-64
ConentLen H(4) 0000-0400 hex(0400) = dec(1024)
Content S(ConentLen)
}
Example:
5. test Command format

Components
Command header
CommandType
MD5
Send: fixed:000000009101040000040500+MD5(32Bytes)
Response:000000009101040000040501+MD5(32Bytes)
Notes:
When a message is sent in a special format, it contains a special meaning, which is as follows:
Used character ‘#command#:’start email content,means send command .

The command format is body + parameter (8 bytes),below :
Command Description
reco Factory reset
autosearch Auto search channels
forcetune Force turn to some channel
specificota Upgrade some special STB
Split between multiple STBID with”,”.

Example :
Reco command , full command format is below :
#command#:reco 00000000
Autosearch command , full command format is below:
#command#: autosearch 00000000
Forcetune command ,full command format is below:
#command#:forcetune 00000000##serviceid(the command send by boardcast way.)
Specificota command ,full command format is below:( the command send by boardcast way.)
#command#:specificota
00000000##operater_id@@hw_code@@sw_code@@frequency@@symbolrate@@modulation@@PID##STBID,STB
ID
Unit：MHz

KV CAS API PROTOCOL FOR SMS - Trigital Technologies

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

KV CAS API PROTOCOL FOR SMS - Trigital Technologies

Uploaded by

Copyright:

Available Formats

DTSS Technology Corporation Ptv. Ltd.

 Scope：The interface applies only between SMS and DTSSCAS。

version Modified Author Updates

3.5. Cancel all authorizations(0305)........................................................................................................ 25

 Data Type Description

 SMS to CA command format

Instances name Number of instances in command

MD5Include Header, Type, Address Condition AND Body.

MD5 TestKey = ‘08cf5af957043d91b8046fc4052bd63a’;

CmdType Request Type Description

0109 Setting for reminder fee

Add / modify one or more of the

0401 Send e-mail Send mail to specified users

0402 Send OSD Send OSD to specified users

0500 Test Command Cleint send a test Command, the server in

Addressing code definitions：

Addressing Name Format

Response Command Format(Except for some special Commands)

Number of instances in Command

Note:SMS uses the basic package combined product package

1.3. Send the reminders fee settings(0109)

1.4. Add/Update Region/(0114)

1.5. Delete Region/(0115)

1.6. Sync Region/(0116)

1.7. Get All Packages From ca(0117)

1.8. Get blacklist From ca(0118)

Response: Success response:0109Command

1.9. Reponse blacklist From ca(0119)

1.10. Add blacklist(0120)

1.11. Delete blacklist(0121)

1.12. Response All Packages From ca(0122)

1.13. Send channel/basicpackage list to ca (0123)

1.14. Send Package list to ca (0124)

2.1. Enabling Smart Card(0201)

2.2. Disable Smart Card(0202)

2.3. STB- card pairing / Cancel(0203)

2.4. Changing Card(0204)

2.5. Conditions limit broadcast / Cancel(0206)

State D(1) 1:limit 0:Cancel limit

2.6. Reset the PIN code(0207)

2.7. Allow recording/ disable (0208)

2.8. Wallet recharge (0210)

2.9. Updated information on the smart card in a field ( 0212 )

2.10. Add EMM FingerPrint ( 0213 )

2.11. Delete EMM FingerPrint ( 0214 )

2.12. Add ECM FingerPrint ( 0215 )

YSize H(4) bkground heigth FFFF means auto

2.13. Delete ECM FingerPrint ( 0216 )

2.14. Pause Entitlement( 0217)

2.15. Resume Entitlement ( 0218)

3.1. Add Authorization(0301)

3.2. Cancel Authorization(0302)

3.3. Suspend Authorization(0303)

3.4. Resume Authorization(0304)

3.5. Cancel all authorizations(0305)

3.6. primary-secondary binding / Cancel(0306)

3.7. Authorization synchronization(0307)

smsPackage Cnt H(2)

4.1. Send e-mail (0401)

4.2. Send OSD(0402)

4.3. Delete OSD (0403)

4.4. Modify OSD (0404)

Example:0000000191010400002904040200201408010001012this is a test osd+MD5(32Bytes)