RadioLib
Universal wireless communication library for Arduino
Loading...
Searching...
No Matches
Cryptography.h
1#if !defined(_RADIOLIB_CRYPTOGRAPHY_H)
2#define _RADIOLIB_CRYPTOGRAPHY_H
3
4#include "../TypeDef.h"
5#include "../Module.h"
6
7// AES-128 constants
8#define RADIOLIB_AES128_BLOCK_SIZE (16)
9#define RADIOLIB_AES128_KEY_SIZE (RADIOLIB_AES128_BLOCK_SIZE)
10#define RADIOLIB_AES128_N_K ((RADIOLIB_AES128_BLOCK_SIZE) / sizeof(uint32_t))
11#define RADIOLIB_AES128_N_B (4)
12#define RADIOLIB_AES128_N_R (10)
13#define RADIOLIB_AES128_KEY_EXP_SIZE (176)
14
15typedef struct {
16 uint8_t X[RADIOLIB_AES128_BLOCK_SIZE];
17 uint8_t buffer[RADIOLIB_AES128_BLOCK_SIZE];
18 size_t buffer_len;
19 uint8_t k1[RADIOLIB_AES128_BLOCK_SIZE];
20 uint8_t k2[RADIOLIB_AES128_BLOCK_SIZE];
21 bool subkeys_generated;
22} RadioLibCmacState;
23
24// helper type
25typedef uint8_t state_t[4][4];
26
27// AES lookup tables
28static const uint8_t aesSbox[] RADIOLIB_NONVOLATILE = {
29 0x63, 0x7c, 0x77, 0x7b, 0xf2, 0x6b, 0x6f, 0xc5,
30 0x30, 0x01, 0x67, 0x2b, 0xfe, 0xd7, 0xab, 0x76,
31 0xca, 0x82, 0xc9, 0x7d, 0xfa, 0x59, 0x47, 0xf0,
32 0xad, 0xd4, 0xa2, 0xaf, 0x9c, 0xa4, 0x72, 0xc0,
33 0xb7, 0xfd, 0x93, 0x26, 0x36, 0x3f, 0xf7, 0xcc,
34 0x34, 0xa5, 0xe5, 0xf1, 0x71, 0xd8, 0x31, 0x15,
35 0x04, 0xc7, 0x23, 0xc3, 0x18, 0x96, 0x05, 0x9a,
36 0x07, 0x12, 0x80, 0xe2, 0xeb, 0x27, 0xb2, 0x75,
37 0x09, 0x83, 0x2c, 0x1a, 0x1b, 0x6e, 0x5a, 0xa0,
38 0x52, 0x3b, 0xd6, 0xb3, 0x29, 0xe3, 0x2f, 0x84,
39 0x53, 0xd1, 0x00, 0xed, 0x20, 0xfc, 0xb1, 0x5b,
40 0x6a, 0xcb, 0xbe, 0x39, 0x4a, 0x4c, 0x58, 0xcf,
41 0xd0, 0xef, 0xaa, 0xfb, 0x43, 0x4d, 0x33, 0x85,
42 0x45, 0xf9, 0x02, 0x7f, 0x50, 0x3c, 0x9f, 0xa8,
43 0x51, 0xa3, 0x40, 0x8f, 0x92, 0x9d, 0x38, 0xf5,
44 0xbc, 0xb6, 0xda, 0x21, 0x10, 0xff, 0xf3, 0xd2,
45 0xcd, 0x0c, 0x13, 0xec, 0x5f, 0x97, 0x44, 0x17,
46 0xc4, 0xa7, 0x7e, 0x3d, 0x64, 0x5d, 0x19, 0x73,
47 0x60, 0x81, 0x4f, 0xdc, 0x22, 0x2a, 0x90, 0x88,
48 0x46, 0xee, 0xb8, 0x14, 0xde, 0x5e, 0x0b, 0xdb,
49 0xe0, 0x32, 0x3a, 0x0a, 0x49, 0x06, 0x24, 0x5c,
50 0xc2, 0xd3, 0xac, 0x62, 0x91, 0x95, 0xe4, 0x79,
51 0xe7, 0xc8, 0x37, 0x6d, 0x8d, 0xd5, 0x4e, 0xa9,
52 0x6c, 0x56, 0xf4, 0xea, 0x65, 0x7a, 0xae, 0x08,
53 0xba, 0x78, 0x25, 0x2e, 0x1c, 0xa6, 0xb4, 0xc6,
54 0xe8, 0xdd, 0x74, 0x1f, 0x4b, 0xbd, 0x8b, 0x8a,
55 0x70, 0x3e, 0xb5, 0x66, 0x48, 0x03, 0xf6, 0x0e,
56 0x61, 0x35, 0x57, 0xb9, 0x86, 0xc1, 0x1d, 0x9e,
57 0xe1, 0xf8, 0x98, 0x11, 0x69, 0xd9, 0x8e, 0x94,
58 0x9b, 0x1e, 0x87, 0xe9, 0xce, 0x55, 0x28, 0xdf,
59 0x8c, 0xa1, 0x89, 0x0d, 0xbf, 0xe6, 0x42, 0x68,
60 0x41, 0x99, 0x2d, 0x0f, 0xb0, 0x54, 0xbb, 0x16
61};
62
63static const uint8_t aesSboxInv[] RADIOLIB_NONVOLATILE = {
64 0x52, 0x09, 0x6a, 0xd5, 0x30, 0x36, 0xa5, 0x38,
65 0xbf, 0x40, 0xa3, 0x9e, 0x81, 0xf3, 0xd7, 0xfb,
66 0x7c, 0xe3, 0x39, 0x82, 0x9b, 0x2f, 0xff, 0x87,
67 0x34, 0x8e, 0x43, 0x44, 0xc4, 0xde, 0xe9, 0xcb,
68 0x54, 0x7b, 0x94, 0x32, 0xa6, 0xc2, 0x23, 0x3d,
69 0xee, 0x4c, 0x95, 0x0b, 0x42, 0xfa, 0xc3, 0x4e,
70 0x08, 0x2e, 0xa1, 0x66, 0x28, 0xd9, 0x24, 0xb2,
71 0x76, 0x5b, 0xa2, 0x49, 0x6d, 0x8b, 0xd1, 0x25,
72 0x72, 0xf8, 0xf6, 0x64, 0x86, 0x68, 0x98, 0x16,
73 0xd4, 0xa4, 0x5c, 0xcc, 0x5d, 0x65, 0xb6, 0x92,
74 0x6c, 0x70, 0x48, 0x50, 0xfd, 0xed, 0xb9, 0xda,
75 0x5e, 0x15, 0x46, 0x57, 0xa7, 0x8d, 0x9d, 0x84,
76 0x90, 0xd8, 0xab, 0x00, 0x8c, 0xbc, 0xd3, 0x0a,
77 0xf7, 0xe4, 0x58, 0x05, 0xb8, 0xb3, 0x45, 0x06,
78 0xd0, 0x2c, 0x1e, 0x8f, 0xca, 0x3f, 0x0f, 0x02,
79 0xc1, 0xaf, 0xbd, 0x03, 0x01, 0x13, 0x8a, 0x6b,
80 0x3a, 0x91, 0x11, 0x41, 0x4f, 0x67, 0xdc, 0xea,
81 0x97, 0xf2, 0xcf, 0xce, 0xf0, 0xb4, 0xe6, 0x73,
82 0x96, 0xac, 0x74, 0x22, 0xe7, 0xad, 0x35, 0x85,
83 0xe2, 0xf9, 0x37, 0xe8, 0x1c, 0x75, 0xdf, 0x6e,
84 0x47, 0xf1, 0x1a, 0x71, 0x1d, 0x29, 0xc5, 0x89,
85 0x6f, 0xb7, 0x62, 0x0e, 0xaa, 0x18, 0xbe, 0x1b,
86 0xfc, 0x56, 0x3e, 0x4b, 0xc6, 0xd2, 0x79, 0x20,
87 0x9a, 0xdb, 0xc0, 0xfe, 0x78, 0xcd, 0x5a, 0xf4,
88 0x1f, 0xdd, 0xa8, 0x33, 0x88, 0x07, 0xc7, 0x31,
89 0xb1, 0x12, 0x10, 0x59, 0x27, 0x80, 0xec, 0x5f,
90 0x60, 0x51, 0x7f, 0xa9, 0x19, 0xb5, 0x4a, 0x0d,
91 0x2d, 0xe5, 0x7a, 0x9f, 0x93, 0xc9, 0x9c, 0xef,
92 0xa0, 0xe0, 0x3b, 0x4d, 0xae, 0x2a, 0xf5, 0xb0,
93 0xc8, 0xeb, 0xbb, 0x3c, 0x83, 0x53, 0x99, 0x61,
94 0x17, 0x2b, 0x04, 0x7e, 0xba, 0x77, 0xd6, 0x26,
95 0xe1, 0x69, 0x14, 0x63, 0x55, 0x21, 0x0c, 0x7d
96};
97
98static const uint8_t aesRcon[] = { 0x8d, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, 0x1b, 0x36 };
99
106class RadioLibAES128 {
107 public:
111 RadioLibAES128();
112
117 void init(uint8_t* key);
118
127 size_t encryptECB(const uint8_t* in, size_t len, uint8_t* out);
128
137 size_t decryptECB(const uint8_t* in, size_t len, uint8_t* out);
138
145 void generateCMAC(const uint8_t* in, size_t len, uint8_t* cmac);
146
151 void initCMAC(RadioLibCmacState* st);
152
159 void updateCMAC(RadioLibCmacState* st, const uint8_t* data, size_t len);
160
166 void finishCMAC(RadioLibCmacState* st, uint8_t* out);
167
175 bool verifyCMAC(const uint8_t* in, size_t len, const uint8_t* cmac);
176
177 private:
178 uint8_t* keyPtr = nullptr;
179 uint8_t roundKey[RADIOLIB_AES128_KEY_EXP_SIZE] = { 0 };
180
181 void keyExpansion(uint8_t* roundKey, const uint8_t* key);
182 void cipher(state_t* state, uint8_t* roundKey);
183 void decipher(state_t* state, uint8_t* roundKey);
184
185 void subWord(uint8_t* word);
186 void rotWord(uint8_t* word);
187
188 void blockXor(uint8_t* dst, const uint8_t* a, const uint8_t* b);
189 void blockLeftshift(uint8_t* dst, const uint8_t* src);
190 void generateSubkeys(uint8_t* key1, uint8_t* key2);
191
192 void subBytes(state_t* state, const uint8_t* box);
193 void shiftRows(state_t* state, bool inv);
194 void mixColumns(state_t* state, bool inv);
195
196 // cppcheck seems convinced these are nut used, which is not true
197 uint8_t mul(uint8_t a, uint8_t b); // cppcheck-suppress unusedPrivateFunction
198 void addRoundKey(uint8_t round, state_t* state, const uint8_t* roundKey); // cppcheck-suppress unusedPrivateFunction
199};
200
201// the global singleton
202extern RadioLibAES128 RadioLibAES128Instance;
203
204#endif
RadioLibAES128
Class to perform AES encryption, decryption and CMAC.
Definition Cryptography.h:106
RadioLibAES128::RadioLibAES128
RadioLibAES128()
Default constructor.
Definition Cryptography.cpp:5
RadioLibAES128::generateCMAC
void generateCMAC(const uint8_t *in, size_t len, uint8_t *cmac)
Calculate message authentication code according to RFC4493.
Definition Cryptography.cpp:135
RadioLibAES128::init
void init(uint8_t *key)
Initialize the AES.
Definition Cryptography.cpp:9
RadioLibAES128::initCMAC
void initCMAC(RadioLibCmacState *st)
Initialize the CMAC state. This must be called before any updateCMAC calls.
Definition Cryptography.cpp:58
RadioLibAES128::encryptECB
size_t encryptECB(const uint8_t *in, size_t len, uint8_t *out)
Perform ECB-type AES encryption.
Definition Cryptography.cpp:14
RadioLibAES128::verifyCMAC
bool verifyCMAC(const uint8_t *in, size_t len, const uint8_t *cmac)
Verify the received CMAC. This just calculates the CMAC again and compares the results.
Definition Cryptography.cpp:142
RadioLibAES128::finishCMAC
void finishCMAC(RadioLibCmacState *st, uint8_t *out)
Finalize the CMAC calculation and save the result. This must be called after all updateCMAC calls are...
Definition Cryptography.cpp:106
RadioLibAES128::decryptECB
size_t decryptECB(const uint8_t *in, size_t len, uint8_t *out)
Perform ECB-type AES decryption.
Definition Cryptography.cpp:30
RadioLibAES128::updateCMAC
void updateCMAC(RadioLibCmacState *st, const uint8_t *data, size_t len)
Update the CMAC state with a chunk of data. This can be called multiple times to process the data in ...
Definition Cryptography.cpp:68
RadioLibCmacState
Definition Cryptography.h:15