Skip to content

Latest commit

 

History

History
54 lines (41 loc) · 2.61 KB

README.md

File metadata and controls

54 lines (41 loc) · 2.61 KB
Raw

SIMtrace v2.0

This is the repository for the next-generation SIMtrace devices, providing abilities to trace the communication between (U)SIM card and phone, remote (U)SIM card forward, (U)SIM man-in-the-middle, and more.

NOTE: Nothing in this repository applies to the SIMtrace v1.x hardware or its associated firmware. SIMtrace v1.x is based on a different CPU / microcontroller architecture and uses a completely different software stack and host software.

Supported Hardware

  • Osmocom SIMtrace2 with SAM3 controller
    • this is open hardware and schematics / PCB design is published
    • pre-built hardware available from sysmocom webshop
  • Osmocom ngff-cardem M.2/NGFF modem carrier with SAM3 controller
    • this is open hardware and schematics / PCB design is published
    • pre-built hardware available from sysmocom webshoo
  • sysmocom sysmoQMOD (with 4 Modems, 4 SIM slots and 2 SAM3)
    • this is a proprietary device, publicly available from sysmocom
    • hardware evaluation kit available from sysmocom webshop
  • sysmocom OWHW (with 2 Modems and 1 SAM3 onboard)
    • this is not publicly available hardware, but still supported

This Repository

This repository contains several directory

  • firmware - the firmware to run on the actual devices
  • hardware - some information related to the hardware
  • host - Programs to use on the USB host to interface with the hardware

The host software includes

  • libosmo-simtrace2 - a shared library to talk to devices running the simtrace2 firmware
  • simtrace2-list - list any USB-attached devices running simtrace2 firmware
  • simtrace2-sniff - interface the 'trace' firmware to obtain card protocol traces
  • simtrace2-cardem-pcsc - interface the 'cardem' fimrware to use a SIM in a PC/SC reader

Do not expect SIMtrace2 to work in VMs

We only support running SIMtrace2 together with a Linux system running "bare iron" on actual hardware (x86, x86_64, arm, ...). using VMs with USB pass-through for things with critical timing like SIMtrace2 is calling for trouble and we will not accept related bug reports or support you if you do. If you still want to use VMs: Feel free to do so, but understand that it's unsupported and you are on your own.