From 0714092deac9b2ca99ef9e39995d28e7195beecd Mon Sep 17 00:00:00 2001
From: Weiyi Wang <wwylele@gmail.com>
Date: Fri, 21 Sep 2018 16:14:20 -0400
Subject: [PATCH] Created AES Keys (markdown)

---
 AES-Keys.md | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 AES-Keys.md

diff --git a/AES-Keys.md b/AES-Keys.md
new file mode 100644
index 0000000..e6164a2
--- /dev/null
+++ b/AES-Keys.md
@@ -0,0 +1,38 @@
+Users can provide some additional crypto keys to enable some advanced features in citra. These keys are not officially provided by citra due to legal considerations.
+
+The keys are supplied by filling the file `sysdata/aes_keys.txt` (located in the [[User Directory]]) in the following format:
+```
+generator=0123456789ABCDEF0123456789ABCDEF
+slot0x0DKeyX=0123456789ABCDEF0123456789ABCDEF
+slot0x0DKeyY=0123456789ABCDEF0123456789ABCDEF
+slot0x0DKeyN=0123456789ABCDEF0123456789ABCDEF
+slot0x18KeyX=0123456789ABCDEF0123456789ABCDEF
+slot0x1BKeyX=0123456789ABCDEF0123456789ABCDEF
+slot0x25KeyX=0123456789ABCDEF0123456789ABCDEF
+slot0x2CKeyX=0123456789ABCDEF0123456789ABCDEF
+slot0x2DKeyX=0123456789ABCDEF0123456789ABCDEF
+slot0x2DKeyY=0123456789ABCDEF0123456789ABCDEF
+slot0x2DKeyN=0123456789ABCDEF0123456789ABCDEF
+slot0x31KeyX=0123456789ABCDEF0123456789ABCDEF
+slot0x31KeyY=0123456789ABCDEF0123456789ABCDEF
+slot0x31KeyN=0123456789ABCDEF0123456789ABCDEF
+slot0x3DKeyX=0123456789ABCDEF0123456789ABCDEF
+common0=0123456789ABCDEF0123456789ABCDEF
+common1=0123456789ABCDEF0123456789ABCDEF
+```
+The strings `0123456789ABCDEF0123456789ABCDEF` in the example above are all placeholder and should be replaced by correct 32-digit hex values of keys. Not all lines in the example are required at the same time. Please read the explanation below about which key enables which feature
+
+## Loading encrypted games
+Required keys: `generator`, `slot0x25KeyX` and `slot0x2CKeyX`. If loading encrypted New 3DS games, `slot0x18KeyX` and `slot0x1BKeyX` are also required. 
+
+## Sharing Mii via QR code between citra and 3DS
+Required keys: single `slot0x2DKeyN`, OR `slot0x2DKeyX`, `slot0x2DKeyY` and `generator` together.
+
+## Generating accurate UDS data frame
+Required keys: single `slot0x31KeyN`, OR `slot0x31KeyX`, `slot0x31KeyY` and `generator` together.
+
+## Using client cert dumped from 3DS
+Required keys: single `slot0x0DKeyN`, OR `slot0x0DKeyX`, `slot0x0DKeyY` and `generator` together.
+
+## Installing encrypted CIA
+Required keys: `generator`, `slot0x3DKeyX` and `common0`. `common1`~`5`are probably also required for some unsual CIA.
\ No newline at end of file