Readers and tokens
==================

Obtaining readers
-----------------

The smart card readers (whether virtual of physical) can be obtained through the following means:

.. js:autoattribute:: SCWS.readers
.. js:autofunction:: SCWS.updateReaderList
.. js:autofunction:: SCWS.getReader

Reader events
-------------

Reader events can be monitored by providing the following callback functions:

.. js:autoattribute:: SCWS.onreaderadded
.. js:autoattribute:: SCWS.onreaderremoved
.. js:autoattribute:: SCWS.onreaderstatechanged

Manipulating readers
--------------------

The ``Reader`` class is described below:

.. js:autoclass:: SCWS.Reader()
.. js:autoattribute:: Reader#name
.. js:autoattribute:: Reader#cardPresent
.. js:autoattribute:: Reader#status
.. js:autoattribute:: Reader#dongle
.. js:autoattribute:: Reader#virtual
.. js:autofunction:: Reader#connect
.. js:autofunction:: Reader#requiresNfcTagReaderSession

Manipulating tokens
-------------------

The ``Token`` class is described below:

.. js:autoclass:: SCWS.Token()
.. js:autoattribute:: Token#reader
.. js:autoattribute:: Token#manufacturer
.. js:autoattribute:: Token#model
.. js:autoattribute:: Token#serialNumber
.. js:autoattribute:: Token#label
.. js:autoattribute:: Token#initialized
.. js:autoattribute:: Token#protectedAuthPath
.. js:autoattribute:: Token#pins
.. js:autofunction:: Token#disconnect
.. js:autofunction:: Token#updateInfos
.. js:autofunction:: Token#getObjects

Software token
--------------

A  virtual token associated to the software certificates available on the local machine can be obtained using this function:

.. js:autofunction:: SCWS.getSoftToken