Osmo-remsim » History » Version 2
roh, 07/10/2019 05:31 PM
1 | 1 | laforge | {{>toc}} |
---|---|---|---|
2 | |||
3 | h1. osmo-remsim |
||
4 | |||
5 | osmo-remsim is a suite of software programs enabling physical/geographic |
||
6 | separation of a cellular phone (or modem) on the one hand side and the |
||
7 | SIM/USIM/ISIM card on the other side. |
||
8 | |||
9 | Using osmo-remsim, you can operate an entire fleet of modems/phones, as |
||
10 | well as banks of SIM cards and dynamically establish or remove the |
||
11 | connections between modems/phones and cards. |
||
12 | |||
13 | So in technical terms, it behaves like a proxy for the ISO 7816 smart |
||
14 | card interface between the MS/UE and the UICC/SIM/USIM/ISIM. |
||
15 | |||
16 | While originally designed to be used in context of cellular networks, |
||
17 | there is nothing cellular specific in the system. It can therefore also |
||
18 | be used with other systems that use contact based smart cards according |
||
19 | to ISO 7816. Currently only the T=0 protocol with standard |
||
20 | (non-extended) APDUs is supported. Both T=1 and extended APDU support |
||
21 | can easily be added as a pure software update, should it be required at |
||
22 | some future point. |
||
23 | |||
24 | |||
25 | {{include(cellular-infrastructure:MacroBinaryPackages)}} |
||
26 | |||
27 | h2. User Manual |
||
28 | |||
29 | h2. Source code |
||
30 | |||
31 | The source code is available from @git.osmocom.org@ (module @osmo-remsim@). |
||
32 | |||
33 | Public read-only access is available via |
||
34 | <pre> |
||
35 | git clone git://git.osmocom.org/osmo-remsim.git |
||
36 | </pre> |
||
37 | |||
38 | You can browse it via cgit: https://git.osmocom.org/osmo-remsim |
||
39 | |||
40 | Contributions are welcome via [[Cellular-Infrastructure:Gerrit]]. |
||
41 | |||
42 | h2. Test Suite |
||
43 | |||
44 | 2 | roh | There is a testbed designed for CI and longterm tests of the whole suite of components(server, bankd, clients). |
45 | It is a small but not minimal configuration: |
||
46 | * 1x host with 2 x virtual machines, all running debian stable, virt is provided by kvm and libvirt |
||
47 | * 1x sysmoQMOD board with 4 modems connected via usb |
||
48 | * 1x SIM card reader with 5 slots using USB CCID |
||
49 | * bankd vm: |
||
50 | ** runs osmo-remsim-bankd |
||
51 | ** has a forwarded usb device (5slot cardreader) |
||
52 | * server vm: |
||
53 | ** runs osmo-remsim-server |
||
54 | ** has a netem script in the network sending path - limiting the delay/latency/jitter/bandwith to 'good' VSAT values |
||
55 | * hostsystem: |
||
56 | ** runs 4 instances of osmo-remsim-client-st2 |
||
57 | ** this cannot be done inside a kvm vm due to bugs/limitations forwarding complex usb devices/hubs (sysmoQMOD is a hub with multiple devices behind) |
||
58 | 1 | laforge | |
59 | 2 | roh | !remsim-tesbed.png! |
60 | FIXME: add tests/description |
||
61 | |||
62 | h2. Contact / Getting Help |
||
63 | 1 | laforge | |
64 | Contact us via the simtrace@lists.osmocom.org mailing list, see [[Cellular-Infrastructure:Mailing Lists]]. |
||
65 | |||
66 | You can file issues (bugs / feature requests) using the redmine project you're currently viewing. |
||
67 | |||
68 | h2. Authors / Credit |
||
69 | |||
70 | osmo-remsim was mainly developed by Harald Welte, with contributions from Kevin Redon. |