dexter has uploaded this change for review. ( https://gerrit.osmocom.org/c/pysim/+/38782?usp=email )
Change subject: docs: add topic about remote UICC/eUICC access ...................................................................... docs: add topic about remote UICC/eUICC access With osmo-remsim and Android APDU proxy we have two powerful solutions to allow remote acces to UICC/eUICC cards. Let's add a section where we give a brief overview about those solutions, so that pySim-shell users get awre of them. Related: OS#6367 Change-Id: I73de4de2e5d4a01d6d91989ee684cbdb680de8ef --- A docs/remote-access.rst M docs/shell.rst 2 files changed, 47 insertions(+), 1 deletion(-) git pull ssh://gerrit.osmocom.org:29418/pysim refs/changes/82/38782/1 diff --git a/docs/remote-access.rst b/docs/remote-access.rst new file mode 100644 index 0000000..33a7649 --- /dev/null +++ b/docs/remote-access.rst @@ -0,0 +1,46 @@ + +Remote access to an UICC/eUICC +============================== + +To access a card with pySim-shell, it is not strictly necessary to have physical +access to it. There are solutions that allow remote access to UICC/eUICC cards. +In this section we will give a brief overview. + + +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 +UICC/eUICC 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. + +To access remote cards with pySim-shell via osmo-remseim (RSPRO), the +provided libifd_remsim_client would be used to provide a virtual PC/SC reader +on the local machine. pySim-shell can then access this reader like any other +PC/SC reader. + +More information on osmo-remsim can be found under: + * https://osmocom.org/projects/osmo-remsim/wiki + * https://ftp.osmocom.org/docs/osmo-remsim/master/osmo-remsim-usermanual.pdf + + +Android APDU proxy +------------------ + +Android APDU proxy is an Android app that provides a bridge between a host +computer and the UICC/eUICC slot of an Android smartphone. + +The APDU proxy connects to VPCD server that runs on the remote host (in this +case the local machine where pySim-shell is running). The VPCD server then +provides a virtual PC/SC reader, that pySim-shell can access like any other +PC/SC reader. + +On the Android side the UICC/eUICC is accessed via OMAPI (Open Mobile API), +which is available in Android since API level Android 8 (API level 29). + +More information Android APDU proxy can be found under: + * https://gitea.osmocom.org/sim-card/android-apdu-proxy diff --git a/docs/shell.rst b/docs/shell.rst index 375e2d3..b70555d 100644 --- a/docs/shell.rst +++ b/docs/shell.rst @@ -76,7 +76,7 @@ :caption: Advanced pySIM-shell topics card-key-provider - + remote-access cmd2 basics ----------- -- To view, visit https://gerrit.osmocom.org/c/pysim/+/38782?usp=email To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings?usp=email Gerrit-MessageType: newchange Gerrit-Project: pysim Gerrit-Branch: master Gerrit-Change-Id: I73de4de2e5d4a01d6d91989ee684cbdb680de8ef Gerrit-Change-Number: 38782 Gerrit-PatchSet: 1 Gerrit-Owner: dexter <pma...@sysmocom.de>
