summaryrefslogtreecommitdiff
path: root/taler-nfc-guide.rst
diff options
context:
space:
mode:
authorFlorian Dold <florian.dold@gmail.com>2019-09-13 01:37:04 +0200
committerFlorian Dold <florian.dold@gmail.com>2019-09-13 01:37:04 +0200
commit5b60b0bd27058efeec74fcccafda11d6a8d64116 (patch)
treef239ec0ae9a168eac93910fc3053350473a7cc73 /taler-nfc-guide.rst
parentea93851bdae9f5288f536d7324cfa7336bf64a9d (diff)
downloaddocs-5b60b0bd27058efeec74fcccafda11d6a8d64116.tar.gz
docs-5b60b0bd27058efeec74fcccafda11d6a8d64116.tar.bz2
docs-5b60b0bd27058efeec74fcccafda11d6a8d64116.zip
more documentation for request tunnelling
Diffstat (limited to 'taler-nfc-guide.rst')
-rw-r--r--taler-nfc-guide.rst22
1 files changed, 19 insertions, 3 deletions
diff --git a/taler-nfc-guide.rst b/taler-nfc-guide.rst
index ced30fb8..83da69af 100644
--- a/taler-nfc-guide.rst
+++ b/taler-nfc-guide.rst
@@ -131,14 +131,31 @@ are used:
:widths: 5 50
:header-rows: 1
- * - TID
+ * - TID (reader to wallet)
- Description
* - ``0x01``
- - Dereference ``taler://`` URI (UTF-8 encoded) in the remainder of the command data.
+ - Dereference the UTF-8 ecoded ``taler://`` URI in the remainder of the command data.
* - ``0x02``
- Accept the UTF-8 encoded JSON object in the remainder of the command data as a request tunneling response.
+The ``GET DATA (=0xCA)`` instruction (again with the instruction parameters ``0x0100`` is used to request
+a command from the wallet. The APDU with this instruction must be sent with a ``0x0000`` trailer to indicate
+that up to 65536 bytes of data are expected in the response from the wallet. Note that the wallet itself cannot
+initiate communication, and thus the reader must "poll" the wallet for commands.
+
+The response to the ``GET DATA`` instruction has a Taler instruction ID in the first byte. The rest of the
+body is interpreted depending on the TID.
+
+.. list-table::
+ :widths: 5 50
+ :header-rows: 1
+
+ * - TID (wallet to reader)
+ - Description
+ * - ``0x03``
+ - Accept the UTF-8 encoded JSON object in the remainder of the command data as a request tunneling request.
+
Sending taler:// URIs to the Wallet via NFC
===========================================
@@ -164,4 +181,3 @@ the ``taler://pay`` URI from the example above:
m<-w 9000
-