Repository files navigation

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

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

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

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

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