Content for TS 51.013 Word version: 16.1.0
6 API Test Plan
6.1 Package sim.access:
6.1.1 Interface SIMView
6.1.2 Class SIMSystem
6.1.3 Class SIMViewException
6.2 Package sim.toolkit
6.2.1 Interface ToolkitConstants
6.2.2 Interface ToolkitInterface
6.2.3 Class EditHandler
6.2.4 Class EnvelopeHandler
6.2.5 Class EnvelopeResponseHandler
6.2.6 Class MEProfile
6.2.7 Class ProactiveHandler
6.2.8 Class ProactiveResponseHandler
6.2.9 Class ToolkitRegistry
6.2.10 Class ViewHandler
6.2.11 Class ToolkitException
6.3 SIM Toolkit Framework
6.3.1 Minimum Handler Availability
6.3.2 Handler Integrity
6.3.3 Applet Triggering
6.3.4 Proactive Command Sending by the STF
6.3.5 Exception Handling
6.3.6 Framework Security Management
6.3.7 Envelope Response Posting
6.3.8 Toolkit Installation
6.3.9 File System Context
6.3.10 Other parts transferred to framework from API
6.3.11 Concatenated SMS
6 API Test Plan p. 19
6.1 Package sim.access: p. 19
6.1.1 Interface SIMView p. 19
6.1.1.1 Constants p. 19
6.1.1.2 Method select(short fid, byte[] fci, short fciOffset, short fciLength) p. 19
6.1.1.3 Method select (short fid) p. 23
6.1.1.4 Method status p. 25
6.1.1.5 Method readBinary p. 27
6.1.1.6 Method updateBinary p. 30
6.1.1.7 Method readRecord p. 33
6.1.1.8 Method updateRecord p. 39
6.1.1.9 Method seek p. 45
6.1.1.10 Method increase p. 49
6.1.1.11 Method invalidate p. 52
6.1.1.12 Method rehabilitate p. 53
6.1.2 Class SIMSystem p. 55
6.1.3 Class SIMViewException p. 56
6.2 Package sim.toolkit p. 58
6.2.1 Interface ToolkitConstants p. 58
6.2.1.1 Constants p. 58
6.2.2 Interface ToolkitInterface p. 59
6.2.3 Class EditHandler p. 60
6.2.4 Class EnvelopeHandler p. 60
6.2.4.1 Method getEnvelopeTag p. 60
6.2.4.2 Method getItemIdentifier p. 61
6.2.4.3 Method getSecuredDataLength p. 62
6.2.4.4 Method getSecuredDataOffset p. 66
6.2.4.5 Method getTheHandler p. 69
6.2.4.6 Method getTPUDLOffset p. 70
6.2.4.7 Method getLength p. 72
6.2.4.8 Method copy p. 73
6.2.4.9 Method findTLV p. 75
6.2.4.10 Method getValueLength p. 76
6.2.4.11 Method getValueByte p. 77
6.2.4.12 Method copyValue p. 79
6.2.4.13 Method compareValue p. 81
6.2.4.14 Method findAndCopyValue(byte tag, byte[] dstBuffer, short dstOffset) p. 84
6.2.4.15 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, byte[] dstBuffer, short dstOffset, short dstLength) p. 86
6.2.4.16 Method findAndCompareValue(byte tag, byte[] compareBuffer, short compareOffset) p. 89
6.2.4.17 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, byte[] compareBuffer, short compareOffset, short compareLength) p. 91
6.2.4.18 Method getCapacity p. 95
6.2.4.19 Method getUserDataLength p. 96
6.2.4.20 Method getChannelIdentifier p. 98
6.2.5 Class EnvelopeResponseHandler p. 100
6.2.5.1 Method getTheHandler p. 100
6.2.5.2 Method post p. 101
6.2.5.3 Method postAsBERTLV p. 103
6.2.5.4 Method getLength p. 104
6.2.5.5 Method copy p. 105
6.2.5.6 Method findTLV p. 107
6.2.5.7 Method getValueLength p. 109
6.2.5.8 Method getValueByte p. 110
6.2.5.9 Method copyValue p. 111
6.2.5.10 Method compareValue p. 114
6.2.5.11 Method findAndCopyValue(byte tag, byte[] dstBuffer, short valueOffset) p. 116
6.2.5.12 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, byte[] dstBuffer, short dstOffset, short dstLength) p. 119
6.2.5.13 Method findAndCompareValue(byte tag, byte[] compareBuffer, short compareOffset) p. 122
6.2.5.14 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, byte[] compareBuffer, short compareOffset, short compareLength) p. 124
6.2.5.15 Method appendArray p. 128
6.2.5.16 Method appendTLV(byte tag, byte value) p. 130
6.2.5.17 Method appendTLV(byte tag, byte value1, byte value2) p. 131
6.2.5.18 Method appendTLV(byte tag, byte[ ] value, short valueoffset, short valuelength) p. 133
6.2.5.19 Method appendTLV(byte tag, byte value1, byte[ ] value2, short value2offset, short value2length) p. 135
6.2.5.20 Method clear p. 138
6.2.5.21 Method getCapacity p. 139
6.2.6 Class MEProfile p. 140
6.2.6.1 Method check (byte index) p. 140
6.2.6.2 Method check (byte [ ] mask, short offset, short length) p. 141
6.2.6.3 Method check (short index) p. 142
6.2.6.4 Method getValue (short indexMSB, short indexLSB) p. 143
6.2.6.5 Method copy (short startOffset, byte[] dstBuffer, short dstOffset, short dstLength) p. 144
6.2.7 Class ProactiveHandler p. 146
6.2.7.1 Method getTheHandler p. 146
6.2.7.2 Method init p. 147
6.2.7.3 Method initDisplayText p. 148
6.2.7.4 Method initGetInkey p. 151
6.2.7.5 Method initGetInput p. 154
6.2.7.6 Method send p. 158
6.2.7.7 Method getLength p. 160
6.2.7.8 Method copy p. 161
6.2.7.9 Method findTLV p. 163
6.2.7.10 Method getValueLength p. 164
6.2.7.11 Method getValueByte p. 165
6.2.7.12 Method copyValue p. 167
6.2.7.13 Method compareValue p. 169
6.2.7.14 Method findAndCopyValue(byte tag, byte[] dstBuffer, short valueOffset) p. 172
6.2.7.15 Method findAndCopyValue(byte tag, byte occurence, short valueOffset, byte[] dstBuffer, short dstOffset, short dstLength) p. 174
6.2.7.16 Method findAndCompareValue(byte tag, byte[] compareBuffer, short compareOffset) p. 177
6.2.7.17 Method findAndCompareValue(byte tag, byte occurence, short valueOffset, byte[] compareBuffer, short compareOffset, short compareLength) p. 180
6.2.7.18 Method appendArray p. 183
6.2.7.19 Method appendTLV(byte tag, byte value) p. 185
6.2.7.20 Method appendTLV(byte tag, byte value1, byte value2) p. 187
6.2.7.21 Method appendTLV(byte tag, byte[] value, short valueoffset, short valuelength) p. 188
6.2.7.22 Method appendTLV(byte tag, byte value1, byte[] value2, short value2offset, short value2length) p. 191
6.2.7.23 Method clear p. 193
6.2.7.24 Method getCapacity p. 194
6.2.7.25 Method initCloseChannel p. 195
6.2.8 Class ProactiveResponseHandler p. 197
6.2.8.1 Method copyAdditionalInformation p. 197
6.2.8.2 Method copyTextString p. 200
6.2.8.3 Method getAdditionalInformationLength p. 204
6.2.8.4 Method getGeneralResult p. 206
6.2.8.5 Method getItemIdentifier p. 208
6.2.8.6 Method getTextStringCodingScheme p. 210
6.2.8.7 Method GetTextStringLength p. 212
6.2.8.8 Method getTheHandler p. 214
6.2.8.9 Method getLength p. 215
6.2.8.10 Method copy p. 216
6.2.8.11 Method findTLV p. 218
6.2.8.12 Method getValueLength p. 220
6.2.8.13 Method getValueByte p. 221
6.2.8.14 Method copyValue p. 222
6.2.8.15 Method compareValue p. 225
6.2.8.16 Method findAndCopyValue(byte tag, byte[] dstBuffer, short valueOffset) p. 227
6.2.8.17 Method findAndCopyValue(byte tag, byte occurence, short valueOffset, byte[] dstBuffer, short dstOffset, short dstLength) p. 230
6.2.8.18 Method findAndCompareValue(byte tag, byte[] compareBuffer, short compareOffset) p. 233
6.2.8.19 Method findAndCompareValue(byte tag, byte occurence, short valueOffset, byte[] compareBuffer, short compareOffset, short compareLength) p. 235
6.2.8.20 Method getCapacity p. 239
6.2.8.21 Method getChannelIdentifier p. 240
6.2.8.22 Method copyChannelData p. 243
6.2.9 Class ToolkitRegistry p. 247
6.2.9.1 Method allocateTimer p. 247
6.2.9.2 Method changeMenuEntry p. 248
6.2.9.3 Method clearEvent p. 255
6.2.9.4 Method disableMenuEntry p. 257
6.2.9.5 Method enableMenuEntry p. 258
6.2.9.6 Method getEntry p. 260
6.2.9.7 Method getPollInterval p. 261
6.2.9.8 Method initMenuEntry p. 263
6.2.9.9 Method isEventSet p. 268
6.2.9.10 Method releaseTimer p. 270
6.2.9.11 Method requestPollInterval p. 271
6.2.9.12 Method setEvent p. 273
6.2.9.13 Method setEventList p. 277
6.2.10 Class ViewHandler p. 282
6.2.11 Class ToolkitException p. 282
6.2.11.1 Exception Constants p. 282
6.2.11.2 Constructor ToolkitException p. 282
6.2.11.3 Method throwIt p. 283
6.3 SIM Toolkit Framework p. 284
6.3.1 Minimum Handler Availability p. 284
6.3.1.1 ProactiveHandler p. 284
6.3.1.2 ProactiveResponseHandler p. 292
6.3.1.3 EnvelopeHandler p. 304
6.3.1.4 EnvelopeResponseHandler p. 311
6.3.2 Handler Integrity p. 328
6.3.2.1 ProactiveHandler p. 328
6.3.2.2 ProactiveResponseHandler p. 330
6.3.2.3 EnvelopeHandler p. 332
6.3.2.4 EnvelopeResponseHandler p. 356
6.3.3 Applet Triggering p. 357
6.3.3.1 EVENT_PROFILE_DOWNLOAD p. 357
6.3.3.2 EVENT_MENU_SELECTION p. 358
6.3.3.3 EVENT_MENU_SELECTION_HELP_REQUEST p. 360
6.3.3.4 EVENT_FORMATTED_SMS_PP_ENV p. 364
6.3.3.5 EVENT_UNFORMATTED_SMS_PP_ENV p. 365
6.3.3.6 EVENT_CALL_CONTROL_BY_SIM p. 367
6.3.3.7 EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM p. 369
6.3.3.8 EVENT_TIMER_EXPIRATION p. 370
6.3.3.9 EVENT_UNFORMATTED_SMS_CB p. 372
6.3.3.10 EVENT_EVENT_DOWNLOAD_MT_CALL p. 373
6.3.3.11 EVENT_EVENT_DOWNLOAD_CALL_CONNECTED p. 374
6.3.3.12 EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED p. 376
6.3.3.13 EVENT_EVENT_DOWNLOAD_LOCATION_STATUS p. 377
6.3.3.14 EVENT_EVENT_DOWNLOAD_USER_ACTIVITY p. 378
6.3.3.15 EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE p. 380
6.3.3.16 EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS p. 381
6.3.3.17 EVENT_UNRECOGNIZED_ENVELOPE p. 383
6.3.3.18 EVENT_STATUS_COMMAND p. 384
6.3.3.19 EVENT_FORMATTED_SMS_CB p. 386
6.3.3.20 EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION p. 388
6.3.3.21 EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION p. 389
6.3.3.22 EVENT_FIRST_COMMAND_AFTER_SELECT p. 391
6.3.3.23 EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE p. 393
6.3.3.24 EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS p. 395
6.3.3.25 EVENT_FORMATTED_SMS_PP_UPD p. 398
6.3.3.26 EVENT_UNFORMATTED_SMS_PP_UPD p. 401
6.3.4 Proactive Command Sending by the STF p. 403
6.3.4.1 System Proactive Commands p. 403
6.3.4.2 Interaction with GSM commands p. 404
6.3.4.3 Proactive Command Control p. 406
6.3.5 Exception Handling p. 408
6.3.6 Framework Security Management p. 410
6.3.6.1 Input Data p. 411
6.3.6.2 Output Data p. 416
6.3.7 Envelope Response Posting p. 417
6.3.7.1 EVENT_CALL_CONTROL_BY_SIM p. 417
6.3.7.2 EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM p. 420
6.3.7.3 EVENT_UNRECOGNIZED_ENVELOPE p. 422
6.3.7.4 EVENT_FORMATTED_SMS_PP_ENV p. 422
6.3.8 Toolkit Installation p. 425
6.3.8.1 Timers Allocation p. 425
6.3.8.2 Item Identifier p. 427
6.3.8.3 Item Position p. 429
6.3.8.4 Maximum Text Length for a menu entry p. 430
6.3.8.5 Maximum number of menu entries p. 432
6.3.8.6 Access Domain p. 433
6.3.8.7 Priority Level p. 439
6.3.8.8 Channel Allocation p. 443
6.3.8.9 Minimum Security Level p. 445
6.3.9 File System Context p. 446
6.3.9.1 Initial Context p. 446
6.3.9.2 Context Preservation (current file) p. 447
6.3.9.3 Context Preservation (current record pointer) p. 449
6.3.10 Other parts transferred to framework from API p. 452
6.3.10.1 A handler is a temporary JCRE Entry Point object p. 452
6.3.10.2 Transaction p. 453
6.3.10.3 Timer Id between Applets p. 454
6.3.11 Concatenated SMS p. 455
