Fix typo
[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 Note that this is completely optional step.  I don't know anyone other than me, do this.  Even for me, I only do that for a single device among multiple devices I use.  I do that to test the feature.
31
32 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.
33
34 The tool ``../tool/gnuk_put_binary_libusb.py`` examines  environment variable of ``EMAIL``, and writes corresponding serial number to Gnuk Token. ::
35
36   $ ../tool/gnuk_put_binary_libusb.py -s ../GNUK_SERIAL_NUMBER 
37   Writing serial number
38   Device:  
39   Configuration:  1
40   Interface:  0
41   d2 76 00 01 24 01 02 00 f5 17 00 00 00 01 00 00