sebastien-riou/SATL

support 3GPP TS 11.13 (aka ETSI TS 101 955) scripts

sebastien-riou opened this issue · 0 comments

ETSI TS 101 955 Annex B (normative):

Script file syntax and format description

CMD : Command to follow
RST : Resets and powers on the card
OFF : Powers off the card
INI : Performs the terminal profile with the following data. Afterwards, it shall perform all the
fetch and terminal response commands until there is no proactive session in progress.
REM : Used for comments
'\n': Empty lines are accepted
' ', '\t' : Can be used as separator
'\' : Continues on next line
XXX : each line beginning with 3 characters indicates other tool command.

[…] data to be checked, need to be present for an outgoing command. Bytes written as XX shall not be
checked by the APDU tool.
(…) status to be checked; when several status are valid they shall be separated by commas. Bytes
written as XX shall not be checked by the APDU tool.

REM this is an example

RST
INI FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF

REM Case 1 example
CMD A0 C2 00 00 00 (91 33 , 69 XX)
REM Case 2 example
CMD A0 C2 00 00 B0 \
 [XX XX XX 55 55 XX 55](91 33 , 69 XX)
CMD A0 C2 00 00 B0 [] (91 33 , 69 XX)

CMD A0 C0 00 00 1F \
 [10 A0 00 00 00 09 00 02 FF FF FF FF 89 28 A4 05 \
 02 0D CC CC CC CC CC CC CC CC CC CC CC CC CC ] \
 (90 00)

REM Case 3 example
CMD A0 C2 00 00 33 \
 D1 31 82 02 83 81 06 05 80 11 22 33 44 8B 24 40 \
 08 00 24 23 85 18 41 04 51 10 10 00 00 00 00 13 \
 02 70 00 00 0E 0D 00 00 00 00 28 A4 05 00 00 00 \
 00 00 00 \
 (90 00)

OFF

In order to show a common appearance all the scripts shall follow those format rules:

  • start always with a 'RST' followed by an 'INI' command.
  • The command, data to be checked and status to be checked shall be presented in the following order:
    CMD COMMAND [EXPECTED DATA] (EXPECTED STATUS)
  • APDU shall be presented with command (CLA INS P1 P2 P3) in one line and data (if present) in next line
    grouped 16 bytes per line (see example above).
  • The expected data (if present) shall be presented in 16 bytes groups per line (see example above).