Tutorial: CAS usage and settings

CAS usage and settings

Setting up Verimatrix CAS

For using Verimatrix CAS proceed as follows:

  1. Set the correct time, for example, from ntp server.
  2. Set initial parameters of the CAS server using one of the two methods:
  1. For MAG200, MAG250 and AuraHD set descrambling mode using gSTB.SetCASDescrambling function.
  2. Set the type of the CAS server after setting initial parameters.

Note. Since release of 0.1.66 software image version, file rootcert.pem is already in /flash folder.

Setting up SecureMedia CAS

For using SecureMedia CAS proceed as follows:

  1. Set the correct time, for example, from NTP server.
  2. Set initial parameters of the CAS server using gSTB.SetCASParam or/and gSTB.SetAdditionalCasParam functions.
  3. Set the type of the CAS server after setting initial parameters.

Note: In case when no additional parameters were set via gSTB.SetAdditionalCasParam, command line for smdaemon could be one of the following:

  • smdaemon -daemon -l 0 -auto_register
    if gSTB.SetCASParam was not called before gSTB.SetCASType.
  • smdaemon -daemon -l 0 -auto_register –rsurl serverAddr
    if via function gSTB.SetCASParam was set only server address but not server port.
  • smdaemon -daemon -l 0 -auto_register –rsurl serverAddr:port
    if via function gSTB.SetCASParam were set both server address and server port.

Setting additional CAS parameters

Some additional CAS parameters can be set by using SetAdditionalCasParam.

Verimatrix

The following list of additional parameters is implemented:

  • COMPANY
  • SERVERADDRESS
  • SERVERPORT
  • STOREPATH
  • KEEP_NULL_PACKETS
  • ERRORLEVEL
  • TIMEOUT
  • ENABLE_IPV6
  • DISABLELOG
  • CLEARLOG
  • ROOTCERT
  • MESSAGE_FORMAT
  • PREFERRED_VKS
  • CONNECTION_RETRIES
  • MIN_KEY_RETRY_INTERVAL
  • KEYMGR_DISABLED

Listed above parameters are the same parameters which can be set using verimatrix.ini config file with gSTB.LoadCASIniFile function.

Example:

// set connection timeout to 5 seconds
gSTB.SetAdditionalCasParam('TIMEOUT', 5);
// set connection retries count to 3
gSTB.SetAdditionalCasParam('CONNECTION_RETRIES', 3);

By default STOREPATH parameter is set to /flash and ROOTCERT to /flash/rootcert.pem. It is not recommended to change those values.

SecureMedia

The following list of additional parameters is implemented:

  • sm_add_cmd – value of this parameter is appended to command line arguments for /home/default/smd_start.sh script after all parameters from gSTB.SetCASParam function.
  • sm_full_cmd – value of this parameter completely overrides command line arguments for smdaemon. That is smdaemon starts only with specified in parameter value options.

Please pay attention that smdaemon starts in blocking mode so value for sm_full_cmd parameter should contain -daemon option.

Custom CAS plugin

Custom CAS plugin interface description can be found by the following link http://soft.infomir.com.ua/mag200/CAS/Readme_en.txt.

To use custom CAS plugin put plugin dynamic library into /home/default folder. Ensure that the plugin has the name in the following form:
/home/default/libCasCustom_x.so, where _x corresponds to given CAS type (see gSTB.SetCASType).

For example:

// force player to search /home/default/libCasCustom4.so library as a current CAS system
gSTB.SetCASType(4);