<p>Harald Welte has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.osmocom.org/13510">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">README.md: add 'osmo-' prefix to remsim-{server,bankd,client}<br><br>Change-Id: I42df660d8c7f696a12118d4e4c38f7ee9e48d2e8<br>---<br>M README.md<br>1 file changed, 21 insertions(+), 20 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.osmocom.org:29418/osmo-remsim refs/changes/10/13510/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/README.md b/README.md</span><br><span>index 8808338..8f2657f 100644</span><br><span>--- a/README.md</span><br><span>+++ b/README.md</span><br><span>@@ -4,22 +4,23 @@</span><br><span> This software suite is a work in progress.</span><br><span> </span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-remsim-client</span><br><span>--------------</span><br><span style="color: hsl(120, 100%, 40%);">+osmo-remsim-client</span><br><span style="color: hsl(120, 100%, 40%);">+------------------</span><br><span> </span><br><span> The client interfaces with GSM phones / modems via dedicated "Card</span><br><span> Emulation" devices such as the Osmocom SIMtrace2 or sysmocom sysmoQMOD</span><br><span> board + firmware.  This hardware implements the ISO7816-3 electrical</span><br><span> interface and protocol handling and  passes any TPDU headers received</span><br><span style="color: hsl(0, 100%, 40%);">-from the phone/modem to remsim-client for further processing of the</span><br><span style="color: hsl(120, 100%, 40%);">+from the phone/modem to osmo-remsim-client for further processing of the</span><br><span> TPDUs associated to the given APDU transfer.</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-remsim-client connects via a RSPRO control connection to remsim-server</span><br><span style="color: hsl(0, 100%, 40%);">-at startup and registers itself.  It will receive configuration data</span><br><span style="color: hsl(0, 100%, 40%);">-such as the remsim-bankd IP+Port and the ClientId from remsim-server.</span><br><span style="color: hsl(120, 100%, 40%);">+osmo-remsim-client connects via a RSPRO control connection to</span><br><span style="color: hsl(120, 100%, 40%);">+osmo-remsim-server at startup and registers itself.  It will receive</span><br><span style="color: hsl(120, 100%, 40%);">+configuration data such as the osmo-remsim-bankd IP+Port and the</span><br><span style="color: hsl(120, 100%, 40%);">+ClientId from osmo-remsim-server.</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-After receiving the configuration, remsim-client will establish a RSPRO</span><br><span style="color: hsl(0, 100%, 40%);">-data connection to the remsim-bankd IP:Port.</span><br><span style="color: hsl(120, 100%, 40%);">+After receiving the configuration, osmo-remsim-client will establish a</span><br><span style="color: hsl(120, 100%, 40%);">+RSPRO data connection to the osmo-remsim-bankd IP:Port.</span><br><span> </span><br><span> As the USB interface for remote SIM in simtrace2.git uses one interface</span><br><span> per slot, we can implement the client in blocking mode, i.e. use</span><br><span>@@ -27,22 +28,22 @@</span><br><span> to a more complex async implementation.</span><br><span> </span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-remsim-bankd</span><br><span>-------------</span><br><span style="color: hsl(120, 100%, 40%);">+osmo-remsim-bankd</span><br><span style="color: hsl(120, 100%, 40%);">+-----------------</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-The remsim-bankd (SIM Bank Daemon) manages one given SIM bank.  The</span><br><span style="color: hsl(120, 100%, 40%);">+The osmo-remsim-bankd (SIM Bank Daemon) manages one given SIM bank.  The</span><br><span> initial implementation supports a PC/SC driver to expose any PC/SC</span><br><span> compatible card readers as SIM bank.</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-remsim-bankd initially connects via a RSPRO control connection to</span><br><span style="color: hsl(0, 100%, 40%);">-remsim-server at startup, and will in turn receive a set of initial</span><br><span style="color: hsl(120, 100%, 40%);">+osmo-remsim-bankd initially connects via a RSPRO control connection to</span><br><span style="color: hsl(120, 100%, 40%);">+osmo-remsim-server at startup, and will in turn receive a set of initial</span><br><span> [client,slot]:[bankd,slot] mappings.  These mappings determine which</span><br><span> slot on the client (corresponding to a modem) is mapped to which slot on</span><br><span style="color: hsl(0, 100%, 40%);">-the SIM bank.  Mappings can be updated by remsim-server at any given</span><br><span style="color: hsl(120, 100%, 40%);">+the SIM bank.  Mappings can be updated by osmo-remsim-server at any given</span><br><span> point in time.</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-remsim-bankd implements a RSPRO server, where it listens to connections</span><br><span style="color: hsl(0, 100%, 40%);">-from remsim-clients.</span><br><span style="color: hsl(120, 100%, 40%);">+osmo-remsim-bankd implements a RSPRO server, where it listens to</span><br><span style="color: hsl(120, 100%, 40%);">+connections from osmo-remsim-clients.</span><br><span> </span><br><span> As PC/SC only offers a blocking API, there is one thread per PC/SC slot.</span><br><span> This thread will perform blocking I/O on the socket towards the client,</span><br><span>@@ -62,10 +63,10 @@</span><br><span> client has identified itself.  The advantage is that the entire bankd</span><br><span> can live without any non-blocking I/O.</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-The main thread handles the connection to remsim-server, where it can</span><br><span style="color: hsl(0, 100%, 40%);">-also use non-blocking I/O.  However, re-connection would be required, to</span><br><span style="color: hsl(0, 100%, 40%);">-avoid stalling all banks/cards in the event of a connection loss to the</span><br><span style="color: hsl(0, 100%, 40%);">-server.</span><br><span style="color: hsl(120, 100%, 40%);">+The main thread handles the connection to osmo-remsim-server, where it</span><br><span style="color: hsl(120, 100%, 40%);">+can also use non-blocking I/O.  However, re-connection would be</span><br><span style="color: hsl(120, 100%, 40%);">+required, to avoid stalling all banks/cards in the event of a connection</span><br><span style="color: hsl(120, 100%, 40%);">+loss to the server.</span><br><span> </span><br><span> worker threads have the following states:</span><br><span> * INIT (just started)</span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/13510">change 13510</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.osmocom.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://gerrit.osmocom.org/13510"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: osmo-remsim </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>
<div style="display:none"> Gerrit-Change-Id: I42df660d8c7f696a12118d4e4c38f7ee9e48d2e8 </div>
<div style="display:none"> Gerrit-Change-Number: 13510 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: Harald Welte <laforge@gnumonks.org> </div>