remove PC/SC tools
[gnuk/gnuk.git] / doc / gnuk-token-initial-configuration.rst
1 ===================================
2 Initial Configuration of Gnuk Token
3 ===================================
4
5 This is optional step.
6
7 You don't need to setup the serial number of Gnuk Token,
8 as it comes with its default serial number based on MCU's chip ID.
9
10 You can setup the serial number of Gnuk Token only once.
11
12
13 Conditions
14 ==========
15
16 I assume you are using GNU/Linux.
17
18
19 Preparation
20 ===========
21
22 Make sure there is no ``scdaemon`` for configuring Gnuk Token.  You can  kill ``scdaemon`` by: ::
23
24   $ gpg-connect-agent "SCD KILLSCD" "SCD BYE" /bye
25
26
27 Serial Number (optional)
28 ========================
29
30 In the file ``GNUK_SERIAL_NUMBER``, each line has email and 6-byte serial number.  The first two bytes are organization number (F5:17 is for FSIJ).  Last four bytes are number for tokens.
31
32 The tool ``../tool/gnuk_put_binary_libusb.py`` examines  environment variable of ``EMAIL``, and writes corresponding serial number to Gnuk Token. ::
33
34   $ ../tool/gnuk_put_binary_libusb.py -s ../GNUK_SERIAL_NUMBER 
35   Writing serial number
36   Device:  006
37   Configuration:  1
38   Interface:  0
39   d2 76 00 01 24 01 02 00 f5 17 00 00 00 01 00 00