Skip to content

Commit

Permalink
virtualsmartcard: distribute install instructions for Windows
Browse files Browse the repository at this point in the history
  • Loading branch information
frankmorgner committed Oct 1, 2023
1 parent 5db58fe commit 00f1508
Show file tree
Hide file tree
Showing 32 changed files with 69 additions and 69 deletions.
1 change: 1 addition & 0 deletions .appveyor.yml
Expand Up @@ -54,6 +54,7 @@ build_script:
- msbuild virtualsmartcard\win32\BixVReader.sln /p:Configuration=Release;Platform=%MSBUILD_PLATFORM%
- move virtualsmartcard\win32\BixVReaderInstaller\bin\%X64%Release\BixVReaderInstaller.msi %ARTIFACT%
- move virtualsmartcard\win32\%X64%Release\*.cer %ARTIFACT%
- copy virtualsmartcard\doc\install.txt %ARTIFACT%

- cl /Ivirtualsmartcard\src\vpcd virtualsmartcard\src\vpcd-config\vpcd-config.c /NODEFAULTLIB:MSVCRTD /NODEFAULTLIB:MSVCRT virtualsmartcard\src\vpcd-config\local-ip.c ws2_32.lib
- move vpcd-config.exe %ARTIFACT%
Expand Down
2 changes: 1 addition & 1 deletion docs/.buildinfo
@@ -1,4 +1,4 @@
# Sphinx build info version 1
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
config: f2fa73baf7fec385947ac770039aeef0
config: 970a58e8ea9411b84c5926de29b702fb
tags: 645f666f9bcd5a90fca523b33c5a78b7
2 changes: 1 addition & 1 deletion docs/ACardEmulator/README.html
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Android Smart Card Emulator &#8212; vsmartcard 2023-09-30 documentation</title>
<title>Android Smart Card Emulator &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css" />
Expand Down
2 changes: 1 addition & 1 deletion docs/TCardEmulator/README.html
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Tizen Smart Card Emulator &#8212; vsmartcard 2023-09-30 documentation</title>
<title>Tizen Smart Card Emulator &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css" />
Expand Down
21 changes: 4 additions & 17 deletions docs/_sources/virtualsmartcard/README.txt
Expand Up @@ -136,7 +136,7 @@ card reader with an :file:`Info.plist`::
make install

================================================================================
Building and installing |vpcd| on Windows
Building |vpcd| on Windows
================================================================================

.. versionadded:: 0.7
Expand Down Expand Up @@ -170,22 +170,6 @@ requires the `WiX Toolset 3.10`_ to be installed.
the installer (:file:`BixVReaderInstaller.msi`) in
:file:`virtualsmartcard\\win32\\BixVReaderInstaller\\bin\\*Release`

4. To import the installer's test signing certificate, double click
:file:`BixVReader.cer` and add it to the *Trusted Root Certification
Authority* and the *Trusted Publishers* at the *Local Computer" (not the
*Current User*).

On the commandline, you could do this :ref:`as follows<Using CertMgr to
Install Test Certificates on a Test Computer>`::

CertMgr.exe /add BixVReader.cer /s /r localMachine root /all
CertMgr.exe /add BixVReader.cer /s /r localMachine trustedpublisher

Feel free to remove the certificate from the certificate stores once the
device is installed.

5. To install |vpcd|, double click :file:`BixVReaderInstaller.msi`.

For debugging |vpcd| and building the driver with an older version of Visual
Studio or WDK please see `Fabio Ottavi's UMDF Driver for a Virtual Smart Card
Reader`_ for details.
Expand All @@ -194,6 +178,9 @@ All of Fabio's card connectors are still available, but inactive by default
(see `Configuring vpcd on Windows`_ below).


.. include:: install.txt


********************************************************************************
Using the Virtual Smart Card
********************************************************************************
Expand Down
2 changes: 1 addition & 1 deletion docs/_static/documentation_options.js
@@ -1,6 +1,6 @@
var DOCUMENTATION_OPTIONS = {
URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
VERSION: '2023-09-30',
VERSION: '2023-10-01',
LANGUAGE: 'None',
COLLAPSE_INDEX: false,
BUILDER: 'html',
Expand Down
2 changes: 1 addition & 1 deletion docs/ccid/README.html
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>USB CCID Emulator &#8212; vsmartcard 2023-09-30 documentation</title>
<title>USB CCID Emulator &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css" />
Expand Down
2 changes: 1 addition & 1 deletion docs/index.html
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Welcome to the Virtual Smart Card Architecture documentation! &#8212; vsmartcard 2023-09-30 documentation</title>
<title>Welcome to the Virtual Smart Card Architecture documentation! &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="_static/graphviz.css" />
Expand Down
Binary file modified docs/objects.inv
Binary file not shown.
2 changes: 1 addition & 1 deletion docs/pcsc-relay/README.html
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>PC/SC Relay &#8212; vsmartcard 2023-09-30 documentation</title>
<title>PC/SC Relay &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css" />
Expand Down
2 changes: 1 addition & 1 deletion docs/remote-reader/README.html
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Remote Smart Card Reader &#8212; vsmartcard 2023-09-30 documentation</title>
<title>Remote Smart Card Reader &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css" />
Expand Down
2 changes: 1 addition & 1 deletion docs/search.html
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Search &#8212; vsmartcard 2023-09-30 documentation</title>
<title>Search &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="_static/graphviz.css" />
Expand Down
2 changes: 1 addition & 1 deletion docs/searchindex.js

Large diffs are not rendered by default.

24 changes: 15 additions & 9 deletions docs/virtualsmartcard/README.html
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Virtual Smart Card &#8212; vsmartcard 2023-09-30 documentation</title>
<title>Virtual Smart Card &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css" />
Expand Down Expand Up @@ -96,7 +96,8 @@
<li><a class="reference internal" href="#installation">Installation</a><ul>
<li><a class="reference internal" href="#installation-on-linux-unix-and-similar">Installation on Linux, Unix and similar</a></li>
<li><a class="reference internal" href="#building-and-installing-vpcd-on-mac-os-x">Building and installing <abbr title="virtual smart card reader">vpcd</abbr> on Mac OS X</a></li>
<li><a class="reference internal" href="#building-and-installing-vpcd-on-windows">Building and installing <abbr title="virtual smart card reader">vpcd</abbr> on Windows</a></li>
<li><a class="reference internal" href="#building-vpcd-on-windows">Building <abbr title="virtual smart card reader">vpcd</abbr> on Windows</a></li>
<li><a class="reference internal" href="#istalling-vpcd-on-windows">Istalling <abbr title="virtual smart card reader">vpcd</abbr> on Windows</a></li>
</ul>
</li>
<li><a class="reference internal" href="#using-the-virtual-smart-card">Using the Virtual Smart Card</a><ul>
Expand Down Expand Up @@ -266,8 +267,8 @@ <h3>Building and installing <abbr title="virtual smart card reader">vpcd</abbr>
</pre></div>
</div>
</div>
<div class="section" id="building-and-installing-vpcd-on-windows">
<h3>Building and installing <abbr title="virtual smart card reader">vpcd</abbr> on Windows<a class="headerlink" href="#building-and-installing-vpcd-on-windows" title="Permalink to this headline"></a></h3>
<div class="section" id="building-vpcd-on-windows">
<h3>Building <abbr title="virtual smart card reader">vpcd</abbr> on Windows<a class="headerlink" href="#building-vpcd-on-windows" title="Permalink to this headline"></a></h3>
<div class="versionadded">
<p><span class="versionmodified added">New in version 0.7: </span>We implemented <abbr title="virtual smart card reader">vpcd</abbr> as user mode device driver for Windows so that
<abbr title="virtual smart card">vpicc</abbr> can directly be used in Windows’ smart card applications that use
Expand Down Expand Up @@ -297,6 +298,16 @@ <h3>Building and installing <abbr title="virtual smart card reader">vpcd</abbr>
<li><p>If you can successfully <span class="guilabel">Build the solution</span>, you can find
the installer (<code class="file docutils literal notranslate"><span class="pre">BixVReaderInstaller.msi</span></code>) in
<code class="file docutils literal notranslate"><span class="pre">virtualsmartcard\win32\BixVReaderInstaller\bin\*Release</span></code></p></li>
</ol>
<p>For debugging <abbr title="virtual smart card reader">vpcd</abbr> and building the driver with an older version of Visual
Studio or WDK please see <a class="reference external" href="http://www.codeproject.com/Articles/134010/An-UMDF-Driver-for-a-Virtual-Smart-Card-Reader">Fabio Ottavi’s UMDF Driver for a Virtual Smart Card
Reader</a> <a class="footnote-reference brackets" href="#id23" id="id25">11</a> for details.</p>
<p>All of Fabio’s card connectors are still available, but inactive by default
(see <a class="reference internal" href="#configuring-vpcd-on-windows">Configuring vpcd on Windows</a> below).</p>
</div>
<div class="section" id="istalling-vpcd-on-windows">
<h3>Istalling <abbr title="virtual smart card reader">vpcd</abbr> on Windows<a class="headerlink" href="#istalling-vpcd-on-windows" title="Permalink to this headline"></a></h3>
<ol class="arabic">
<li><p>To import the installer’s test signing certificate, double click
<code class="file docutils literal notranslate"><span class="pre">BixVReader.cer</span></code> and add it to the <em>Trusted Root Certification
Authority</em> and the <em>Trusted Publishers</em> at the <em>Local Computer” (not the
Expand All @@ -311,11 +322,6 @@ <h3>Building and installing <abbr title="virtual smart card reader">vpcd</abbr>
</li>
<li><p>To install <abbr title="virtual smart card reader">vpcd</abbr>, double click <code class="file docutils literal notranslate"><span class="pre">BixVReaderInstaller.msi</span></code>.</p></li>
</ol>
<p>For debugging <abbr title="virtual smart card reader">vpcd</abbr> and building the driver with an older version of Visual
Studio or WDK please see <a class="reference external" href="http://www.codeproject.com/Articles/134010/An-UMDF-Driver-for-a-Virtual-Smart-Card-Reader">Fabio Ottavi’s UMDF Driver for a Virtual Smart Card
Reader</a> <a class="footnote-reference brackets" href="#id23" id="id25">11</a> for details.</p>
<p>All of Fabio’s card connectors are still available, but inactive by default
(see <a class="reference internal" href="#configuring-vpcd-on-windows">Configuring vpcd on Windows</a> below).</p>
</div>
</div>
<div class="section" id="using-the-virtual-smart-card">
Expand Down
2 changes: 1 addition & 1 deletion docs/virtualsmartcard/api.html
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Creating a Virtual Smart Card &#8212; vsmartcard 2023-09-30 documentation</title>
<title>Creating a Virtual Smart Card &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css" />
Expand Down
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>CardGenerator Module &#8212; vsmartcard 2023-09-30 documentation</title>
<title>CardGenerator Module &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../../_static/graphviz.css" />
Expand Down
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>ConstantDefinitions Module &#8212; vsmartcard 2023-09-30 documentation</title>
<title>ConstantDefinitions Module &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../../_static/graphviz.css" />
Expand Down
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>CryptoUtils Module &#8212; vsmartcard 2023-09-30 documentation</title>
<title>CryptoUtils Module &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../../_static/graphviz.css" />
Expand Down
2 changes: 1 addition & 1 deletion docs/virtualsmartcard/api/virtualsmartcard.SEutils.html
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>SEutils Module &#8212; vsmartcard 2023-09-30 documentation</title>
<title>SEutils Module &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../../_static/graphviz.css" />
Expand Down
2 changes: 1 addition & 1 deletion docs/virtualsmartcard/api/virtualsmartcard.SWutils.html
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>SWutils Module &#8212; vsmartcard 2023-09-30 documentation</title>
<title>SWutils Module &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../../_static/graphviz.css" />
Expand Down
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>SmartcardFilesystem Module &#8212; vsmartcard 2023-09-30 documentation</title>
<title>SmartcardFilesystem Module &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../../_static/graphviz.css" />
Expand Down
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>SmartcardSAM Module &#8212; vsmartcard 2023-09-30 documentation</title>
<title>SmartcardSAM Module &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../../_static/graphviz.css" />
Expand Down
2 changes: 1 addition & 1 deletion docs/virtualsmartcard/api/virtualsmartcard.TLVutils.html
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>TLVutils Module &#8212; vsmartcard 2023-09-30 documentation</title>
<title>TLVutils Module &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../../_static/graphviz.css" />
Expand Down
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>VirtualSmartcard Module &#8212; vsmartcard 2023-09-30 documentation</title>
<title>VirtualSmartcard Module &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../../_static/graphviz.css" />
Expand Down
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>cryptoflex Module &#8212; vsmartcard 2023-09-30 documentation</title>
<title>cryptoflex Module &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../../_static/graphviz.css" />
Expand Down
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>ePass Module &#8212; vsmartcard 2023-09-30 documentation</title>
<title>ePass Module &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../../_static/graphviz.css" />
Expand Down
2 changes: 1 addition & 1 deletion docs/virtualsmartcard/api/virtualsmartcard.cards.html
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>cards Package &#8212; vsmartcard 2023-09-30 documentation</title>
<title>cards Package &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../../_static/graphviz.css" />
Expand Down
2 changes: 1 addition & 1 deletion docs/virtualsmartcard/api/virtualsmartcard.cards.nPA.html
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>nPA Module &#8212; vsmartcard 2023-09-30 documentation</title>
<title>nPA Module &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../../_static/graphviz.css" />
Expand Down
2 changes: 1 addition & 1 deletion docs/virtualsmartcard/api/virtualsmartcard.html
Expand Up @@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>virtualsmartcard Package &#8212; vsmartcard 2023-09-30 documentation</title>
<title>virtualsmartcard Package &#8212; vsmartcard 2023-10-01 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../../_static/graphviz.css" />
Expand Down

0 comments on commit 00f1508

Please sign in to comment.