doc: Add images, add introduction, add usage system
This commit is contained in:
parent
ebbc9bef4f
commit
86323174e2
|
@ -4,7 +4,9 @@
|
||||||
<para><application>SIMtrace</application> will need a patched version of
|
<para><application>SIMtrace</application> will need a patched version of
|
||||||
<application>wireshark</application> and the <command>simtrace</command>
|
<application>wireshark</application> and the <command>simtrace</command>
|
||||||
host utility to fully operate. The installation might be possible from
|
host utility to fully operate. The installation might be possible from
|
||||||
binary packages or will require building from source.</para>
|
binary packages or will require building from source. The following
|
||||||
|
sections provide some hints how to achieve this on the various Linux
|
||||||
|
distributions</para>
|
||||||
|
|
||||||
<section id="install_ubuntu_natty">
|
<section id="install_ubuntu_natty">
|
||||||
<title>Installation Ubuntu Natty</title>
|
<title>Installation Ubuntu Natty</title>
|
||||||
|
|
|
@ -2,7 +2,43 @@
|
||||||
<chapter id="chapter_introduction">
|
<chapter id="chapter_introduction">
|
||||||
<title>Introduction</title>
|
<title>Introduction</title>
|
||||||
<section id="intro_overview">
|
<section id="intro_overview">
|
||||||
|
<title>History</title>
|
||||||
|
<para>SIMtrace was created out of necessity. Harald Welte wanted
|
||||||
|
to see the communication between a GSM Mobile Station (or
|
||||||
|
what we call a cellphone) and the SIM. He was not able to
|
||||||
|
find an existing solution, or the existing ones had mayor
|
||||||
|
drawbacks that made using them very time consuming and slow.
|
||||||
|
The Atmel AT91SAM7 came to the rescue. This microcontroller
|
||||||
|
has hardware support for the ISO7816 T0/T1 Smart Card
|
||||||
|
specification. Using this hardware with the clock coming from
|
||||||
|
the normal connection we are able to read bytes coming from
|
||||||
|
and going to the SIM.
|
||||||
|
The next step in the project was taken by Kevin Redon
|
||||||
|
that started to modify an existing AT91SAM7 design, started
|
||||||
|
to use the Free Software KiCAD CAD Software. In 2011 the project
|
||||||
|
went from having Schematics to having routed circuits, prototypes
|
||||||
|
and the final product. The first production run was in August.</para>
|
||||||
|
</section>
|
||||||
|
<section id="intro_picture">
|
||||||
<title>Overview</title>
|
<title>Overview</title>
|
||||||
<para></para>
|
<para>The setup of SIMtrace consists out of a Hardware and a
|
||||||
|
Software part. The SIM card needs to be put into the SIMtrace
|
||||||
|
Hardware, the flex cable needs to be connected to the SIMtrace
|
||||||
|
Hardware and the SIM end needs to be placed in the SIM socket
|
||||||
|
of the phone. The SIMtrace hardware can be seen as a USB device
|
||||||
|
from the host, the SIMtrace software will try to find this device
|
||||||
|
and claim it. The SIMtrace software will receive packets from the
|
||||||
|
SIMtrace hardware and can forward them using the GSMTAP protocol
|
||||||
|
to the IANA assigned GSMTAP port (4729). A modified version of Wireshark
|
||||||
|
can be used to analyze the data.</para>
|
||||||
|
|
||||||
|
<figure><title>Schematic Overview</title>
|
||||||
|
<mediaobject>
|
||||||
|
<imageobject>
|
||||||
|
<imagedata fileref="images/setup_overview.png" width="6cm"/>
|
||||||
|
</imageobject>
|
||||||
|
<textobject><phrase>SIMtrace being connected</phrase></textobject>
|
||||||
|
</mediaobject>
|
||||||
|
</figure>
|
||||||
</section>
|
</section>
|
||||||
</chapter>
|
</chapter>
|
||||||
|
|
|
@ -2,19 +2,50 @@
|
||||||
<chapter id="chapter_using">
|
<chapter id="chapter_using">
|
||||||
<title>Sniffing your SIM</title>
|
<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">
|
<section id="launching_simtrace">
|
||||||
<title>Launching SIMtrace</title>
|
<title>Launching SIMtrace</title>
|
||||||
<para></para>
|
|
||||||
<screen>
|
<screen>
|
||||||
$ <command>simtrace</command>
|
$ <command>./simtrace</command>
|
||||||
|
simtrace - GSM SIM and smartcard tracing
|
||||||
|
(C) 2010 by Harald Welte <laforge@gnumonks.org>
|
||||||
</screen>
|
</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>
|
||||||
|
|
||||||
<section id="launching_wireshark">
|
<section id="launching_wireshark">
|
||||||
<title>Launching Wireshark</title>
|
<title>Launching Wireshark</title>
|
||||||
<para></para>
|
<para>The <command>wireshark</command> application will start a GUI
|
||||||
<screen>
|
and given the right permissions you should be able listen to the
|
||||||
$ <command>wireshark</command>
|
localhost interface and filter for the GSMTAP port on 4729. You should
|
||||||
</screen>
|
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>
|
</section>
|
||||||
</chapter>
|
</chapter>
|
||||||
|
|
Binary file not shown.
After Width: | Height: | Size: 19 KiB |
Binary file not shown.
After Width: | Height: | Size: 833 KiB |
Binary file not shown.
After Width: | Height: | Size: 68 KiB |
Loading…
Reference in New Issue