docs/chapters/using.xml


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

<?xml version="1.0" encoding="UTF-8"?>
<chapter id="chapter_using">
    <title>Sniffing your SIM</title>

    <section id="hw_setup">
        <title>Connecting your device</title>
        <para>You will need to put your SIM into the SIMtrace hardware, connect
        one of the four flex cables to the SIMtrace hardware, put the other side
        into the SIM socket of your phone. Use USB to connect the SIMtrace hardware
        to the PC. On your PC you should be able to see the USB device now.</para>

        <figure><title>Connecting the SIMtrace Hardware</title>
        <mediaobject>
          <imageobject>
            <imagedata fileref="images/simtrace_hw_setup.png" width="15cm"/>
          </imageobject>
          <textobject><phrase>SIMtrace being connected</phrase></textobject>
        </mediaobject>
        </figure>
    </section>

    <section id="launching_simtrace">
        <title>Launching SIMtrace</title>
        <screen>
$ <command>./simtrace</command>
simtrace - GSM SIM and smartcard tracing
(C) 2010 by Harald Welte &lt;laforge@gnumonks.org&gt;
        </screen>
        <para>Launching the <command>simtrace</command> will try to find
        the SIMtrace hardware and then try to claim the USB device. The
        application will send the received data encapsulated in the GSMTAP
        format on localhost and the IANA assigned GSMTAP port.</para>
    </section>

    <section id="launching_wireshark">
        <title>Launching Wireshark</title>
        <para>The <command>wireshark</command> application will start a GUI
        and given the right permissions you should be able listen to the
        localhost interface and filter for the GSMTAP port on 4729. You should
        be able to see the decoded messages like in the figure below.</para>

         <figure><title>GSMTAP in Wireshark</title>
         <mediaobject>
           <imageobject>
             <imagedata fileref="images/wireshark-sim.png" width="16cm"/>
           </imageobject>
           <textobject><phrase>SIMtrace sending data</phrase></textobject>
         </mediaobject>
         </figure>
    </section>
</chapter>