Cellular Emulator Configuration
4/8/2010
A SIM/USIM file system is simulated in Cellular Emulator, and users can configure it at their will. In order to achieve this, users must compose a customized configuration XML file and then load it into AT Parser.
.jpg "Bb158493.6f7653e4-4a5b-462d-8e05-5b2e22c259fe(en-us,MSDN.10).jpg")
Note
By default emulator will load "USIM.xml" file under its working directory.
Compose Configuration XML File
Users should compose a custom XML file to configure the SIM/USIM file system.
The format of the sample files are described in the table below:
| Section | Comment |
|---|---|
<characteristic type="Config"> |
Root level |
<characteristic type="SIM"> |
SIM Component |
<characteristic type="SIMProperties"> |
//end SIMProperties |
<characteristic type="SIMFileSystem"> |
SIM Filesystem |
<characteristic type="[Application]"> |
USIM applications.** [Applicaion] = UICC or USIM. |
<characteristic type="SIMFile_[ParentID]_[FileID]"> |
One SIMFile characteristic should exist for each file. Note that each instance of SIMFile implies "create" or "update" file. [ParentID] = fileID of parent SIM DF (or 3F00 if no parent); [FileID] = SIM File ID. Example SIMFile characteristic: SIMFile_7F10_6F3A (note that each ID needs to be two bytes, i.e., 4 hex digits) |
<parm name="SIMFileACL"> |
Desc: file Access Control List Formatting: "[read],[write],[invalidate],[rehabilitate]" Where permissions ALW, PIN, PIN2, ADM Default: ADM (even if unrecognized entry found) |
<parm name="SIMFileType"> |
Desc: SIM file type Formatting: DF, LINEAR, CYCLIC, TRANSPARENT |
<parm name="SIMFileRecordLength"> |
Desc: Record length; required for LINEAR and CYCLIC file types Formatting: positive integer |
<parm name="SIMFileData"> |
Desc: file data Formatting: for example "A(Microsoft \(PPC\)) H(0xFF 0xFF) A(dog\\food)" A(…) = converts everything between parentheses into GSM 7-bit alphabet; H(…) = converts hex codes appropriately (0xFF, 0xff, FF, ff, Ff all equivalent). Note these special codes: "\)" = ")"; "\(" = "("; "\\" = "\" Quotation mark should be encoded per XML standards, i.e., """ Actual encoding of data up to GSM specs |
<parm name="SIMFileDataFile"> |
Desc: instead of using the above parm to define file contents, one can instead point the CSP to load SIM file data from a real file residing on device. Note this file must contain raw binary data; no interpreting of file contents will occur |
</characteristic> |
//End SIMFile |
</characteristic> |
// End [Application] |
</characteristic> |
//End SIMFileSystem |
<characteristic type="SIMSecurity"> |
SIM security*** |
</characteristic> |
//End SIMSecurity |
</characteristic> |
//End SIM |
<characteristic type="Network"> |
Network configuration* |
</characteristic> |
//end Network |
<characteristic type="Radio"> |
Radio configuration section* |
</characteristic> |
//end Radio |
</characteristic> |
//end Cellular Emulator |
*: Useless sections for compatibility to FakeSIM. |
**: USIM only sections. ***: Unsupported sections. |
Note
Two sample XML files are provided in the installation folder.
Loading Configuration XML File into Emulator
In the Configuration dialog, selecting Import will pop up a dialog to browse to the XML configuration file.
If the file load operation succeeds, Cellular Emulator will continue working without any additional message given.
If the file load operation fails, a message box will pop up to specify the error. The most likely reason for this may be that the file format is invalid.
.gif "Bb158493.7e856929-7db6-4697-807d-b1f6a842f51d(en-us,MSDN.10).gif")
Note
If the file loading operation fails, all subsequent operations related to SIM/USIM will fail and return an error code indicating "technical problem".
Filter Management
Filter DLLs are responsible for the execution of each AT command. The emulator will enumerate all the filters loaded when it receives an AT command in order of priority. Once the response of this AT command is generated by a specific filter, the AT Parser will stop querying more filters.
By default, there are six filters loaded and in use. The name and priority of filters are listed in the Filter Management section of the Configuration tab. By checking each filter, they are dynamically disabled or enabled. If a filter is disabled, the emulator will not feed the subsequent AT commands to it.
In the Configuration dialog, select the button "Add…" and a dialog will pop up to browse to the filter DLL files.
If the loading file operation succeeds, emulator will load the selected filter DLL dynamically, enable it and list its information in the table.
If the file loading operation fails, a message box will pop up to notify this error. The most possible reason for this may be that the DLL file format is not an invalid filter DLL, such as the DLL does not implement the right interface required by filter.
.gif "Bb158493.66635309-c7cb-494a-9281-cbb6b9e1ff5f(en-us,MSDN.10).gif")
See Also
Concepts
Security, GPS and Resolution Awareness Tools