VivoKey/vsmartcard
7
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

updated docs about vpcd's msi

Browse Source
This commit is contained in:
Frank Morgner
2017-01-05 00:13:05 +01:00
parent df2bb0312b
commit c0d979975d
1 changed files with 29 additions and 46 deletions
Download Patch File Download Diff File Expand all files Collapse all files

75
virtualsmartcard/doc/README.txt.in
View File

@@ -146,50 +146,37 @@ Building and installing |vpcd| on Windows
For the Windows integration we extended `Fabio Ottavi's UMDF Driver for a For the Windows integration we extended `Fabio Ottavi's UMDF Driver for a
Virtual Smart Card Reader`_ with a |vpcd| interface. To build |vpcd| for Virtual Smart Card Reader`_ with a |vpcd| interface. To build |vpcd| for
Windows we use `Windows Driver Kit 8.1 and Visual Studio 2013`_. If you choose Windows we use `Windows Driver Kit 10 and Visual Studio 2015`_. The vpcd
to download the `Windows binaries`_, you may directly jump to step 3. installer requires the `WiX Toolset 3.10`_. If you choose
to download the `Windows binaries`_, you may directly jump to step 4.
1. Clone the git repository and make sure it is initialized with all
submodules::
1. In Visual Studio select :menuselection:`File --> Open --> Convert git clone https://github.com/frankmorgner/vsmartcard.git
Sources/Dirs...` and choose the vpcd's :file:`sources` either in the cd vsmartcard
:file:`WinXP` [#footnote1]_ or :file:`Win7` folder. git submodule update --init --recursive
When successfully imported, ensure with the configuration manager, that both 2. In Visual Studio open |vpcd|'s solution
of the created projects are built for the same platform (x64 or Win32). :file:`virtualsmartcard\\win32\\BixVReader.sln` and ensure with the
configuration manager, that the project is built for your platform (i.e.
``x64`` or ``x82``).
2. If you can successfully :guilabel:`Build the solution`, you can find the 3. If you can successfully :guilabel:`Build the solution`, you can find
install package in :file:`BixVReader-package`. It contains `BixVReader.inf` the installer (:file:`BixVReaderInstaller.msi`) in
and the required libraries, especially `BixVReader.dll` and :file:`virtualsmartcard\\win32\\BixVReaderInstaller\\bin\\*Release`
`WudfUpdate_01009.dll` [#footnote2]_.
3. Copy :file:`win32\\BixVReader\\BixVReader.ini` into the :envvar:`%SystemRoot%` 4. To install |vpcd|, double click :file:`BixVReaderInstaller.msi`. Since we
directory. are currently not signing the Installer, this will yield a warning about an
unverified driver software publisher on Windows 8 and later. Click
4. In a console with administrator rights go to :file:`BixVReader-package` and :guilabel:`Install this driver software anyway`.
install the driver::
"C:\Program Files\Windows Kits\8.1\Tools\x86\devcon.exe" install BixVReader.inf root\BixVirtualReader
You can adjust the path to ``devcon.exe`` with your version of the WDK and
your target architecture (e.g., use ``...\x64\devcon.exe`` for a 64 bit
driver). You can also download `DevCon's source code`_ and compile it
yourself.
For Win7 and older, code signing is optional and will yield a warning during
installation when missing. Simply click continue to install the driver anyway.
To activate the WDK test signing, use VS build-in Driver Signing settings.
Right click :guilabel:`BixVReader-package` :menuselection:`Properties -->
Driver Signing --> Sign Mode --> Test Sign`. Import the WDKTestCert
certificate :file:`BixVReader-package.cer` into your windows keystore (e.g.
on local computer) and then install the driver. See
`Microsoft's Kernel-Mode Code Signing Walkthrough`_ for
details.
For debugging |vpcd| and building the driver with an older version of Visual 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 Studio or WDK please see `Fabio Ottavi's UMDF Driver for a Virtual Smart Card
Reader`_ for details. All of Fabio's card connectors (pipe reader/TCP/IP Reader`_ for details.
reader) are still active by default.
All of Fabio's card connectors are still available, but inactive by default
(see `Configuring vpcd on Windows`_ below).
******************************************************************************** ********************************************************************************
@@ -262,14 +249,14 @@ stopped when you unplug the device.
Configuring |vpcd| on Windows Configuring |vpcd| on Windows
================================================================================ ================================================================================
The configuration file `BixVReader.ini` of |vpcd| is usually placed into The configuration file :file:`BixVReader.ini` of |vpcd| is installed to
:file:`C:\\Windows` (:envvar:`SystemRoot`). The user mode device driver :file:`C:\\Windows` (:envvar:`%SystemRoot%`). The user mode device driver
framework (:command:`WUDFHost.exe`) should read it automatically and load the framework (:command:`WUDFHost.exe`) should read it automatically and load the
|vpcd| on startup. The Windows Device Manager :command:`mmc devmgmt.msc` should |vpcd| on startup. The Windows Device Manager :command:`mmc devmgmt.msc` should
list the :guilabel:`Bix Virtual Smart Card Reader`. list the :guilabel:`Bix Virtual Smart Card Reader`.
|vpcd| opens a socket for |vpicc| and waits for incoming |vpcd| opens a socket for |vpicc| and waits for incoming connections. The port
connections. The port to open should be specified in ``TCP_PORT``: to open should be specified in ``TCP_PORT``:
.. literalinclude:: ../../virtualsmartcard/win32/BixVReader/BixVReader.ini .. literalinclude:: ../../virtualsmartcard/win32/BixVReader/BixVReader.ini
:emphasize-lines: 8 :emphasize-lines: 8
@@ -314,9 +301,6 @@ Notes and References
.. target-notes:: .. target-notes::
.. [#footnote1] With VS 2013 and WDK 8.1 no Windows XP driver can be build. You need to use an older version of VS with WDK 7.1.0.
.. [#footnote2] Note that WudfUpdate_01009.dll for 32 bit will be around 1795 KB and for 64 bit around 2102 KB big.
.. _cyberflex-shell: https://github.com/henryk/cyberflex-shell .. _cyberflex-shell: https://github.com/henryk/cyberflex-shell
.. _PCSC-lite: http://pcsclite.alioth.debian.org/ .. _PCSC-lite: http://pcsclite.alioth.debian.org/
.. _Python: http://www.python.org/ .. _Python: http://www.python.org/
@@ -329,8 +313,7 @@ Notes and References
.. _OpenPACE: https://github.com/frankmorgner/openpace .. _OpenPACE: https://github.com/frankmorgner/openpace
.. _libqrencode: https://fukuchi.org/works/qrencode/ .. _libqrencode: https://fukuchi.org/works/qrencode/
.. _`Fabio Ottavi's UMDF Driver for a Virtual Smart Card Reader`: 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`: http://www.codeproject.com/Articles/134010/An-UMDF-Driver-for-a-Virtual-Smart-Card-Reader
.. _`Windows Driver Kit 8.1 and Visual Studio 2013`: http://msdn.microsoft.com/en-us/windows/hardware/hh852365.aspx .. _`Windows Driver Kit 10 and Visual Studio 2015`: https://msdn.microsoft.com/en-us/library/windows/hardware/ff557573
.. _`DevCon's source code`: https://github.com/Microsoft/Windows-driver-samples/tree/master/setup/devcon .. _`WiX Toolset 3.10`: https://wixtoolset.org/releases/v3.10/stable
.. _`Microsoft's Kernel-Mode Code Signing Walkthrough`: http://msdn.microsoft.com/en-us/library/windows/hardware/dn653569%28v=vs.85%29.aspx
.. _`Windows binaries`: https://github.com/frankmorgner/vsmartcard/releases/download/virtualsmartcard-0.7/virtualsmartcard-0.7_win32.zip .. _`Windows binaries`: https://github.com/frankmorgner/vsmartcard/releases/download/virtualsmartcard-0.7/virtualsmartcard-0.7_win32.zip
.. _npa-tool: https://github.com/frankmorgner/OpenSC .. _npa-tool: https://github.com/frankmorgner/OpenSC