Osmocom Remote SIM Software Suite https://osmocom.org/projects/osmo-remsim
Go to file
Harald Welte 81b8aa467d Add funding link to github mirror
see https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/displaying-a-sponsor-button-in-your-repository

Change-Id: Ieedad968300828acd23a398ea088c3e2d8a336be
2024-03-23 12:57:30 +01:00
.github Add funding link to github mirror 2024-03-23 12:57:30 +01:00
asn1 server: Detect duplicate client/bankd connection; drop new ones 2022-05-03 18:09:14 +02:00
contrib systemd: depend on networking-online.target 2023-05-26 14:10:48 +02:00
debian debian/rules: don't compress pdfs 2024-03-19 18:42:29 +01:00
doc bankd: Don't use 127.0.0.1 as default IP address for the server 2023-07-21 11:10:15 +00:00
ffasn1c add ffasn1c example for RSPRO 2018-09-24 17:46:05 +02:00
include server: Detect duplicate client/bankd connection; drop new ones 2022-05-03 18:09:14 +02:00
src bankd: Use gsmtap_inst_fd2() 2023-10-30 12:13:10 +01:00
.checkpatch.conf checkpatch.conf: ignore rspro generated files 2023-07-17 11:52:58 +02:00
.gitignore ignore libtool artifacts from cross-compile environments 2022-11-14 10:45:01 +00:00
.gitreview Add git-review config 2019-02-14 19:07:32 +01:00
COPYING add missing copyright / license headers everywhere 2019-03-09 13:11:56 +01:00
Makefile.am Install + package remsim-apitool as separate sub-package 2022-07-13 07:21:37 +00:00
README.md README.md: Major update / meaningful content 2024-03-23 12:57:30 +01:00
TODO-RELEASE bankd: Use gsmtap_inst_fd2() 2023-10-30 12:13:10 +01:00
configure.ac Depend on libosmo-simtrace >= 0.8.0 2021-12-09 08:18:46 +01:00
git-version-gen initial checkin of osmo-remsim 2018-08-15 08:54:50 +02:00
libosmo-rspro.pc.in Add libosmo-rspro.pc.in for pkg-config integration 2019-04-03 09:35:48 +02:00
move-asn1-header-files.sh initial checkin of osmo-remsim 2018-08-15 08:54:50 +02:00

README.md

osmo-remsim - Osmocom remote SIM software suite

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.

Homepage

Please visit the official homepage for usage instructions, manual and examples.

GIT Repository

You can clone from the official osmo-remsim.git repository using

    git clone https://gitea.osmocom.org/sim-card/osmo-remsim

There is a web interface at https://gitea.osmocom.org/sim-card/osmo-remsim.

Documentation

The User Manual is [optionally] built in PDF form as part of the build process.

A pre-rendered PDF version of the current master can be found at User Manual.

Forum

We welcome any osmo-remsim related discussions in the SIM Card Technology section of the osmocom discourse (web based Forum).

Mailing List

There is no separate mailing list for this project. However, discussions related to pySim are happening on the simtrace simtrace@lists.osmocom.org mailing list, please see https://lists.osmocom.org/mailman/listinfo/simtrace for subscription options and the list archive.

Please observe the Osmocom Mailing List Rules when posting.

Issue Tracker

We use the issue tracker of the osmo-remsim project on osmocom.org for tracking the state of bug reports and feature requests. Feel free to submit any issues you may find, or help us out by resolving existing issues.

Contributing

Our coding standards are described at https://osmocom.org/projects/cellular-infrastructure/wiki/Coding_standards

We are using a gerrit-based patch review process explained at https://osmocom.org/projects/cellular-infrastructure/wiki/Gerrit