.. /*
    * This file is part of the SavaPage project <https://www.savapage.org>.
    * Copyright (c) 2026 Datraverse B.V.
    * Author: Rijk Ravestein.
    *
    * SPDX-FileCopyrightText: (c) 2020 Datraverse B.V. <info@datraverse.com>
    * SPDX-License-Identifier: CC-BY-SA-4.0
    *
    * For more information, please contact Datraverse B.V. at this
    * address: info@datraverse.com
    */

.. _app-nfc-reader-network-service:

Network Card Reader Service
---------------------------

SavaPage ships with a Network Card Reader Service to be deployed on
a Raspberry Pi®. The service works with
`CCID <https://en.wikipedia.org/wiki/CCID_(protocol)>`__ compatible NFC
readers. The `ACS ACR122U <https://www.acs.com.hk/en/products/3/acr122u-usb-nfc-reader/>`__ 
and `ACR1252U <https://www.acs.com.hk/en/products/342/acr1252u-usb-nfc-reader-iii-nfc-forum-certified-reader/>`__ 
readers are popular choices, but other CCID readers work just as well  [3]_. The
installation instructions can be found in:
``/opt/savapage/providers/nfc/linux-armv6/README``

Any deployed service must be entered as SavaPage Device. See
:ref:`Network Card Reader <ch-webapp-admin-devices-card-reader>`. At each
card swipe the UID of the card is read and send to the central
SavaPage server, where it is handled in context of the device
definition.

You can link sounds and scrips to various events. Sample files are
provided for your own customization, for example to communicate with
`PiGlow <https://www.pimoroni.com/>`__,
`Pibrella <https://github.com/pimoroni/pibrella/>`__ or 
`PiFace Control & Display <https://piface.github.io/>`__ add-on boards.


.. [3]
   A list of compatible NFC readers is available at `CCID free software
   driver <https://ccid.apdu.fr/>`__.