Project

General

Profile

osmo-remsim

osmo-remsim is a suite of software programs enabling physical/geographic separation of a cellular phone (or modem) on the one hand side and the SIM/USIM/ISIM card on the other side.

Using osmo-remsim, you can operate an entire fleet of modems/phones, as well as banks of SIM cards and dynamically establish or remove the connections between modems/phones and cards.

So in technical terms, it behaves like a proxy for the ISO 7816 smart card interface between the MS/UE and the UICC/SIM/USIM/ISIM.

While originally designed to be used in context of cellular networks, there is nothing cellular specific in the system. It can therefore also be used with other systems that use contact based smart cards according to ISO 7816. Currently only the T=0 protocol with standard (non-extended) APDUs is supported.

Both T=1 and extended APDU support can easily be added as a pure software update, should it be required at some future point.

Typical osmo-remsim deployment with 8 sim cards and two modems

Binary Packages

Osmocom provides binary packages for several flavors of Debian and Ubuntu GNU/Linux on a variety of architectures (i586, x86_64, armhf, armv7l). Unless you are a software developer interested in developing on Osmocom, it is recommended you use those packages instead of building from source.

For more details see Binary_Packages

User Manual

The latest user manual is available from https://ftp.osmocom.org/docs/latest/osmo-remsim-usermanual.pdf

Presentation / Video

An early presentation video recording is available:osmo-remsim: Remote SIM card Software

Please keep in mind that this video was done at a relatively early point in the development, so not everything may still be correct today.

Source code

The source code is available from git.osmocom.org (module osmo-remsim).

Public read-only access is available via

git clone git://git.osmocom.org/osmo-remsim.git

You can browse it via cgit: https://git.osmocom.org/osmo-remsim

Contributions are welcome via Gerrit.

Test Suite

We have a TTCN-3 test suite as part of our Titan_TTCN3_Testsuites

Supported Hardware

SIM card readers/banks

  • lab / small deployments (less than 8 slots)
  • medium size deployments (8 slots or multiple)
  • large size deployments (96 slots and up)
    • sysmoSIMBANK-96 and sysmoSIMBANK-192 (19" units with 95 and 192 slots, respectively

Support for other SIM bank hardware or card readers can of course be added by either contributing related patches or funding related development.

Interface to Phone/Modem

  • sysmoQMOD (board with four mPCIe modem slots and remote SIM support)

In theory, the simtrace2 hardware is also capable, but unfortuantely the software is currently not in a fully supported state, see https://osmocom.org/news/114 for an update. Any support is welcome to get this fulyl working again!

Contact / Getting Help

Contact us via the mailing list, see Mailing Lists.

You can file issues (bugs / feature requests) using the redmine project you're currently viewing.

Authors / Credit

osmo-remsim was mainly developed by Harald Welte, with contributions from Kevin Redon.

Further pages in this wiki

Commercial Support

Commercial support as well as development, system integration and training services for this project are available from sysmocom

Add picture from clipboard (Maximum size: 48.8 MB)