1
0
mirror of https://github.com/taigrr/arduinolibs synced 2025-01-18 04:33:12 -08:00

Update docs

This commit is contained in:
Rhys Weatherley
2018-04-07 02:43:29 +10:00
parent c81350fcbe
commit f46b005926
446 changed files with 3398 additions and 783 deletions

View File

@@ -89,7 +89,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
</div><!--header-->
<div class="contents">
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span>&#160;<span class="comment">/*</span></div>
<div class="line"><a name="l00002"></a><span class="lineno"> 2</span>&#160;<span class="comment"> * Copyright (C) 2015 Southern Storm Software, Pty Ltd.</span></div>
<div class="line"><a name="l00002"></a><span class="lineno"> 2</span>&#160;<span class="comment"> * Copyright (C) 2015,2018 Southern Storm Software, Pty Ltd.</span></div>
<div class="line"><a name="l00003"></a><span class="lineno"> 3</span>&#160;<span class="comment"> *</span></div>
<div class="line"><a name="l00004"></a><span class="lineno"> 4</span>&#160;<span class="comment"> * Permission is hereby granted, free of charge, to any person obtaining a</span></div>
<div class="line"><a name="l00005"></a><span class="lineno"> 5</span>&#160;<span class="comment"> * copy of this software and associated documentation files (the &quot;Software&quot;),</span></div>
@@ -176,13 +176,249 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
<div class="line"><a name="l00103"></a><span class="lineno"> 103</span>&#160;</div>
<div class="line"><a name="l00104"></a><span class="lineno"> 104</span>&#160; <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a name="l00105"></a><span class="lineno"> 105</span>&#160;}</div>
<div class="line"><a name="l00106"></a><span class="lineno"> 106</span>&#160;</div>
<div class="line"><a name="l00132"></a><span class="lineno"> 132</span>&#160;<span class="comment">// Helper macros.</span></div>
<div class="line"><a name="l00133"></a><span class="lineno"> 133</span>&#160;<span class="preprocessor">#define LEFT 0</span></div>
<div class="line"><a name="l00134"></a><span class="lineno"> 134</span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define RIGHT 16</span></div>
<div class="line"><a name="l00135"></a><span class="lineno"> 135</span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define ENCRYPT(phase) \</span></div>
<div class="line"><a name="l00136"></a><span class="lineno"> 136</span>&#160;<span class="preprocessor"> do { \</span></div>
<div class="line"><a name="l00137"></a><span class="lineno"> 137</span>&#160;<span class="preprocessor"> AESCommon::subBytesAndShiftRows(state2, state1); \</span></div>
<div class="line"><a name="l00138"></a><span class="lineno"> 138</span>&#160;<span class="preprocessor"> AESCommon::mixColumn(state1, state2); \</span></div>
<div class="line"><a name="l00139"></a><span class="lineno"> 139</span>&#160;<span class="preprocessor"> AESCommon::mixColumn(state1 + 4, state2 + 4); \</span></div>
<div class="line"><a name="l00140"></a><span class="lineno"> 140</span>&#160;<span class="preprocessor"> AESCommon::mixColumn(state1 + 8, state2 + 8); \</span></div>
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span>&#160;<span class="preprocessor"> AESCommon::mixColumn(state1 + 12, state2 + 12); \</span></div>
<div class="line"><a name="l00142"></a><span class="lineno"> 142</span>&#160;<span class="preprocessor"> for (posn = 0; posn &lt; 16; ++posn) \</span></div>
<div class="line"><a name="l00143"></a><span class="lineno"> 143</span>&#160;<span class="preprocessor"> state1[posn] ^= schedule[posn + (phase)]; \</span></div>
<div class="line"><a name="l00144"></a><span class="lineno"> 144</span>&#160;<span class="preprocessor"> } while (0)</span></div>
<div class="line"><a name="l00145"></a><span class="lineno"> 145</span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define DECRYPT(phase) \</span></div>
<div class="line"><a name="l00146"></a><span class="lineno"> 146</span>&#160;<span class="preprocessor"> do { \</span></div>
<div class="line"><a name="l00147"></a><span class="lineno"> 147</span>&#160;<span class="preprocessor"> for (posn = 0; posn &lt; 16; ++posn) \</span></div>
<div class="line"><a name="l00148"></a><span class="lineno"> 148</span>&#160;<span class="preprocessor"> state2[posn] ^= schedule[posn + (phase)]; \</span></div>
<div class="line"><a name="l00149"></a><span class="lineno"> 149</span>&#160;<span class="preprocessor"> AESCommon::inverseMixColumn(state1, state2); \</span></div>
<div class="line"><a name="l00150"></a><span class="lineno"> 150</span>&#160;<span class="preprocessor"> AESCommon::inverseMixColumn(state1 + 4, state2 + 4); \</span></div>
<div class="line"><a name="l00151"></a><span class="lineno"> 151</span>&#160;<span class="preprocessor"> AESCommon::inverseMixColumn(state1 + 8, state2 + 8); \</span></div>
<div class="line"><a name="l00152"></a><span class="lineno"> 152</span>&#160;<span class="preprocessor"> AESCommon::inverseMixColumn(state1 + 12, state2 + 12); \</span></div>
<div class="line"><a name="l00153"></a><span class="lineno"> 153</span>&#160;<span class="preprocessor"> AESCommon::inverseShiftRowsAndSubBytes(state2, state1); \</span></div>
<div class="line"><a name="l00154"></a><span class="lineno"> 154</span>&#160;<span class="preprocessor"> } while (0)</span></div>
<div class="line"><a name="l00155"></a><span class="lineno"> 155</span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define KCORE(n) \</span></div>
<div class="line"><a name="l00156"></a><span class="lineno"> 156</span>&#160;<span class="preprocessor"> do { \</span></div>
<div class="line"><a name="l00157"></a><span class="lineno"> 157</span>&#160;<span class="preprocessor"> AESCommon::keyScheduleCore(temp, schedule + 28, (n)); \</span></div>
<div class="line"><a name="l00158"></a><span class="lineno"> 158</span>&#160;<span class="preprocessor"> schedule[0] ^= temp[0]; \</span></div>
<div class="line"><a name="l00159"></a><span class="lineno"> 159</span>&#160;<span class="preprocessor"> schedule[1] ^= temp[1]; \</span></div>
<div class="line"><a name="l00160"></a><span class="lineno"> 160</span>&#160;<span class="preprocessor"> schedule[2] ^= temp[2]; \</span></div>
<div class="line"><a name="l00161"></a><span class="lineno"> 161</span>&#160;<span class="preprocessor"> schedule[3] ^= temp[3]; \</span></div>
<div class="line"><a name="l00162"></a><span class="lineno"> 162</span>&#160;<span class="preprocessor"> } while (0)</span></div>
<div class="line"><a name="l00163"></a><span class="lineno"> 163</span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define KXOR(a, b) \</span></div>
<div class="line"><a name="l00164"></a><span class="lineno"> 164</span>&#160;<span class="preprocessor"> do { \</span></div>
<div class="line"><a name="l00165"></a><span class="lineno"> 165</span>&#160;<span class="preprocessor"> schedule[(a) * 4] ^= schedule[(b) * 4]; \</span></div>
<div class="line"><a name="l00166"></a><span class="lineno"> 166</span>&#160;<span class="preprocessor"> schedule[(a) * 4 + 1] ^= schedule[(b) * 4 + 1]; \</span></div>
<div class="line"><a name="l00167"></a><span class="lineno"> 167</span>&#160;<span class="preprocessor"> schedule[(a) * 4 + 2] ^= schedule[(b) * 4 + 2]; \</span></div>
<div class="line"><a name="l00168"></a><span class="lineno"> 168</span>&#160;<span class="preprocessor"> schedule[(a) * 4 + 3] ^= schedule[(b) * 4 + 3]; \</span></div>
<div class="line"><a name="l00169"></a><span class="lineno"> 169</span>&#160;<span class="preprocessor"> } while (0)</span></div>
<div class="line"><a name="l00170"></a><span class="lineno"> 170</span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define KSBOX() \</span></div>
<div class="line"><a name="l00171"></a><span class="lineno"> 171</span>&#160;<span class="preprocessor"> do { \</span></div>
<div class="line"><a name="l00172"></a><span class="lineno"> 172</span>&#160;<span class="preprocessor"> AESCommon::applySbox(temp, schedule + 12); \</span></div>
<div class="line"><a name="l00173"></a><span class="lineno"> 173</span>&#160;<span class="preprocessor"> schedule[16] ^= temp[0]; \</span></div>
<div class="line"><a name="l00174"></a><span class="lineno"> 174</span>&#160;<span class="preprocessor"> schedule[17] ^= temp[1]; \</span></div>
<div class="line"><a name="l00175"></a><span class="lineno"> 175</span>&#160;<span class="preprocessor"> schedule[18] ^= temp[2]; \</span></div>
<div class="line"><a name="l00176"></a><span class="lineno"> 176</span>&#160;<span class="preprocessor"> schedule[19] ^= temp[3]; \</span></div>
<div class="line"><a name="l00177"></a><span class="lineno"> 177</span>&#160;<span class="preprocessor"> } while (0)</span></div>
<div class="line"><a name="l00178"></a><span class="lineno"> 178</span>&#160;<span class="preprocessor"></span></div>
<div class="line"><a name="l00187"></a><span class="lineno"><a class="line" href="classAESTiny256.html#a7af85adfdbd0a3bb68ef5a8f76102043"> 187</a></span>&#160;<a class="code" href="classAESTiny256.html#a7af85adfdbd0a3bb68ef5a8f76102043">AESTiny256::AESTiny256</a>()</div>
<div class="line"><a name="l00188"></a><span class="lineno"> 188</span>&#160;{</div>
<div class="line"><a name="l00189"></a><span class="lineno"> 189</span>&#160;}</div>
<div class="line"><a name="l00190"></a><span class="lineno"> 190</span>&#160;</div>
<div class="line"><a name="l00191"></a><span class="lineno"> 191</span>&#160;AESTiny256::~AESTiny256()</div>
<div class="line"><a name="l00192"></a><span class="lineno"> 192</span>&#160;{</div>
<div class="line"><a name="l00193"></a><span class="lineno"> 193</span>&#160; clean(schedule);</div>
<div class="line"><a name="l00194"></a><span class="lineno"> 194</span>&#160;}</div>
<div class="line"><a name="l00195"></a><span class="lineno"> 195</span>&#160;</div>
<div class="line"><a name="l00200"></a><span class="lineno"><a class="line" href="classAESTiny256.html#a3f48f55b7600dfc672acda899928de76"> 200</a></span>&#160;<span class="keywordtype">size_t</span> <a class="code" href="classAESTiny256.html#a3f48f55b7600dfc672acda899928de76">AESTiny256::blockSize</a>()<span class="keyword"> const</span></div>
<div class="line"><a name="l00201"></a><span class="lineno"> 201</span>&#160;<span class="keyword"></span>{</div>
<div class="line"><a name="l00202"></a><span class="lineno"> 202</span>&#160; <span class="keywordflow">return</span> 16;</div>
<div class="line"><a name="l00203"></a><span class="lineno"> 203</span>&#160;}</div>
<div class="line"><a name="l00204"></a><span class="lineno"> 204</span>&#160;</div>
<div class="line"><a name="l00209"></a><span class="lineno"><a class="line" href="classAESTiny256.html#a7b5a2ba4829e79283c53248d3d8a7a06"> 209</a></span>&#160;<span class="keywordtype">size_t</span> <a class="code" href="classAESTiny256.html#a7b5a2ba4829e79283c53248d3d8a7a06">AESTiny256::keySize</a>()<span class="keyword"> const</span></div>
<div class="line"><a name="l00210"></a><span class="lineno"> 210</span>&#160;<span class="keyword"></span>{</div>
<div class="line"><a name="l00211"></a><span class="lineno"> 211</span>&#160; <span class="keywordflow">return</span> 32;</div>
<div class="line"><a name="l00212"></a><span class="lineno"> 212</span>&#160;}</div>
<div class="line"><a name="l00213"></a><span class="lineno"> 213</span>&#160;</div>
<div class="line"><a name="l00214"></a><span class="lineno"><a class="line" href="classAESTiny256.html#abc162075b181bfca34144f4eec6deec7"> 214</a></span>&#160;<span class="keywordtype">bool</span> <a class="code" href="classAESTiny256.html#abc162075b181bfca34144f4eec6deec7">AESTiny256::setKey</a>(<span class="keyword">const</span> uint8_t *key, <span class="keywordtype">size_t</span> len)</div>
<div class="line"><a name="l00215"></a><span class="lineno"> 215</span>&#160;{</div>
<div class="line"><a name="l00216"></a><span class="lineno"> 216</span>&#160; <span class="keywordflow">if</span> (len == 32) {</div>
<div class="line"><a name="l00217"></a><span class="lineno"> 217</span>&#160; <span class="comment">// Make a copy of the key - it will be expanded in encryptBlock().</span></div>
<div class="line"><a name="l00218"></a><span class="lineno"> 218</span>&#160; memcpy(schedule, key, 32);</div>
<div class="line"><a name="l00219"></a><span class="lineno"> 219</span>&#160; <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a name="l00220"></a><span class="lineno"> 220</span>&#160; }</div>
<div class="line"><a name="l00221"></a><span class="lineno"> 221</span>&#160; <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a name="l00222"></a><span class="lineno"> 222</span>&#160;}</div>
<div class="line"><a name="l00223"></a><span class="lineno"> 223</span>&#160;</div>
<div class="line"><a name="l00224"></a><span class="lineno"><a class="line" href="classAESTiny256.html#a36e4ffc85f7d7604d01a5629c185d0ef"> 224</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="classAESTiny256.html#a36e4ffc85f7d7604d01a5629c185d0ef">AESTiny256::encryptBlock</a>(uint8_t *output, <span class="keyword">const</span> uint8_t *input)</div>
<div class="line"><a name="l00225"></a><span class="lineno"> 225</span>&#160;{</div>
<div class="line"><a name="l00226"></a><span class="lineno"> 226</span>&#160; uint8_t schedule[32];</div>
<div class="line"><a name="l00227"></a><span class="lineno"> 227</span>&#160; uint8_t posn;</div>
<div class="line"><a name="l00228"></a><span class="lineno"> 228</span>&#160; uint8_t round;</div>
<div class="line"><a name="l00229"></a><span class="lineno"> 229</span>&#160; uint8_t state1[16];</div>
<div class="line"><a name="l00230"></a><span class="lineno"> 230</span>&#160; uint8_t state2[16];</div>
<div class="line"><a name="l00231"></a><span class="lineno"> 231</span>&#160; uint8_t temp[4];</div>
<div class="line"><a name="l00232"></a><span class="lineno"> 232</span>&#160;</div>
<div class="line"><a name="l00233"></a><span class="lineno"> 233</span>&#160; <span class="comment">// Start with the key in the schedule buffer.</span></div>
<div class="line"><a name="l00234"></a><span class="lineno"> 234</span>&#160; memcpy(schedule, this-&gt;schedule, 32);</div>
<div class="line"><a name="l00235"></a><span class="lineno"> 235</span>&#160;</div>
<div class="line"><a name="l00236"></a><span class="lineno"> 236</span>&#160; <span class="comment">// Copy the input into the state and perform the first round.</span></div>
<div class="line"><a name="l00237"></a><span class="lineno"> 237</span>&#160; <span class="keywordflow">for</span> (posn = 0; posn &lt; 16; ++posn)</div>
<div class="line"><a name="l00238"></a><span class="lineno"> 238</span>&#160; state1[posn] = input[posn] ^ schedule[posn];</div>
<div class="line"><a name="l00239"></a><span class="lineno"> 239</span>&#160; ENCRYPT(RIGHT);</div>
<div class="line"><a name="l00240"></a><span class="lineno"> 240</span>&#160;</div>
<div class="line"><a name="l00241"></a><span class="lineno"> 241</span>&#160; <span class="comment">// Perform the next 12 rounds of the cipher two at a time.</span></div>
<div class="line"><a name="l00242"></a><span class="lineno"> 242</span>&#160; <span class="keywordflow">for</span> (round = 1; round &lt;= 6; ++round) {</div>
<div class="line"><a name="l00243"></a><span class="lineno"> 243</span>&#160; <span class="comment">// Expand the next 32 bytes of the key schedule.</span></div>
<div class="line"><a name="l00244"></a><span class="lineno"> 244</span>&#160; KCORE(round);</div>
<div class="line"><a name="l00245"></a><span class="lineno"> 245</span>&#160; KXOR(1, 0);</div>
<div class="line"><a name="l00246"></a><span class="lineno"> 246</span>&#160; KXOR(2, 1);</div>
<div class="line"><a name="l00247"></a><span class="lineno"> 247</span>&#160; KXOR(3, 2);</div>
<div class="line"><a name="l00248"></a><span class="lineno"> 248</span>&#160; KSBOX();</div>
<div class="line"><a name="l00249"></a><span class="lineno"> 249</span>&#160; KXOR(5, 4);</div>
<div class="line"><a name="l00250"></a><span class="lineno"> 250</span>&#160; KXOR(6, 5);</div>
<div class="line"><a name="l00251"></a><span class="lineno"> 251</span>&#160; KXOR(7, 6);</div>
<div class="line"><a name="l00252"></a><span class="lineno"> 252</span>&#160;</div>
<div class="line"><a name="l00253"></a><span class="lineno"> 253</span>&#160; <span class="comment">// Encrypt using the left and right halves of the key schedule.</span></div>
<div class="line"><a name="l00254"></a><span class="lineno"> 254</span>&#160; ENCRYPT(LEFT);</div>
<div class="line"><a name="l00255"></a><span class="lineno"> 255</span>&#160; ENCRYPT(RIGHT);</div>
<div class="line"><a name="l00256"></a><span class="lineno"> 256</span>&#160; }</div>
<div class="line"><a name="l00257"></a><span class="lineno"> 257</span>&#160;</div>
<div class="line"><a name="l00258"></a><span class="lineno"> 258</span>&#160; <span class="comment">// Expand the final 16 bytes of the key schedule.</span></div>
<div class="line"><a name="l00259"></a><span class="lineno"> 259</span>&#160; KCORE(7);</div>
<div class="line"><a name="l00260"></a><span class="lineno"> 260</span>&#160; KXOR(1, 0);</div>
<div class="line"><a name="l00261"></a><span class="lineno"> 261</span>&#160; KXOR(2, 1);</div>
<div class="line"><a name="l00262"></a><span class="lineno"> 262</span>&#160; KXOR(3, 2);</div>
<div class="line"><a name="l00263"></a><span class="lineno"> 263</span>&#160;</div>
<div class="line"><a name="l00264"></a><span class="lineno"> 264</span>&#160; <span class="comment">// Perform the final round.</span></div>
<div class="line"><a name="l00265"></a><span class="lineno"> 265</span>&#160; AESCommon::subBytesAndShiftRows(state2, state1);</div>
<div class="line"><a name="l00266"></a><span class="lineno"> 266</span>&#160; <span class="keywordflow">for</span> (posn = 0; posn &lt; 16; ++posn)</div>
<div class="line"><a name="l00267"></a><span class="lineno"> 267</span>&#160; output[posn] = state2[posn] ^ schedule[posn];</div>
<div class="line"><a name="l00268"></a><span class="lineno"> 268</span>&#160;}</div>
<div class="line"><a name="l00269"></a><span class="lineno"> 269</span>&#160;</div>
<div class="line"><a name="l00270"></a><span class="lineno"><a class="line" href="classAESTiny256.html#abdf72a52c37c060a9089693c118585bc"> 270</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="classAESTiny256.html#abdf72a52c37c060a9089693c118585bc">AESTiny256::decryptBlock</a>(uint8_t *output, <span class="keyword">const</span> uint8_t *input)</div>
<div class="line"><a name="l00271"></a><span class="lineno"> 271</span>&#160;{</div>
<div class="line"><a name="l00272"></a><span class="lineno"> 272</span>&#160; <span class="comment">// Decryption is not supported by AESTiny256.</span></div>
<div class="line"><a name="l00273"></a><span class="lineno"> 273</span>&#160;}</div>
<div class="line"><a name="l00274"></a><span class="lineno"> 274</span>&#160;</div>
<div class="line"><a name="l00275"></a><span class="lineno"><a class="line" href="classAESTiny256.html#ae4cac6af2e78cbf399b7f6d0e613a578"> 275</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="classAESTiny256.html#ae4cac6af2e78cbf399b7f6d0e613a578">AESTiny256::clear</a>()</div>
<div class="line"><a name="l00276"></a><span class="lineno"> 276</span>&#160;{</div>
<div class="line"><a name="l00277"></a><span class="lineno"> 277</span>&#160; clean(schedule);</div>
<div class="line"><a name="l00278"></a><span class="lineno"> 278</span>&#160;}</div>
<div class="line"><a name="l00279"></a><span class="lineno"> 279</span>&#160;</div>
<div class="line"><a name="l00306"></a><span class="lineno"><a class="line" href="classAESSmall256.html#aa343b59af73ad6c86541907f53f5572b"> 306</a></span>&#160;<a class="code" href="classAESSmall256.html#aa343b59af73ad6c86541907f53f5572b">AESSmall256::AESSmall256</a>()</div>
<div class="line"><a name="l00307"></a><span class="lineno"> 307</span>&#160;{</div>
<div class="line"><a name="l00308"></a><span class="lineno"> 308</span>&#160;}</div>
<div class="line"><a name="l00309"></a><span class="lineno"> 309</span>&#160;</div>
<div class="line"><a name="l00310"></a><span class="lineno"> 310</span>&#160;AESSmall256::~AESSmall256()</div>
<div class="line"><a name="l00311"></a><span class="lineno"> 311</span>&#160;{</div>
<div class="line"><a name="l00312"></a><span class="lineno"> 312</span>&#160; clean(reverse);</div>
<div class="line"><a name="l00313"></a><span class="lineno"> 313</span>&#160;}</div>
<div class="line"><a name="l00314"></a><span class="lineno"> 314</span>&#160;</div>
<div class="line"><a name="l00315"></a><span class="lineno"><a class="line" href="classAESSmall256.html#ae7e05119a6183d5f7fc520206f97c0e0"> 315</a></span>&#160;<span class="keywordtype">bool</span> <a class="code" href="classAESSmall256.html#ae7e05119a6183d5f7fc520206f97c0e0">AESSmall256::setKey</a>(<span class="keyword">const</span> uint8_t *key, <span class="keywordtype">size_t</span> len)</div>
<div class="line"><a name="l00316"></a><span class="lineno"> 316</span>&#160;{</div>
<div class="line"><a name="l00317"></a><span class="lineno"> 317</span>&#160; uint8_t *schedule;</div>
<div class="line"><a name="l00318"></a><span class="lineno"> 318</span>&#160; uint8_t round;</div>
<div class="line"><a name="l00319"></a><span class="lineno"> 319</span>&#160; uint8_t temp[4];</div>
<div class="line"><a name="l00320"></a><span class="lineno"> 320</span>&#160;</div>
<div class="line"><a name="l00321"></a><span class="lineno"> 321</span>&#160; <span class="comment">// Set the encryption key first.</span></div>
<div class="line"><a name="l00322"></a><span class="lineno"> 322</span>&#160; <span class="keywordflow">if</span> (!<a class="code" href="classAESTiny256.html#abc162075b181bfca34144f4eec6deec7">AESTiny256::setKey</a>(key, len))</div>
<div class="line"><a name="l00323"></a><span class="lineno"> 323</span>&#160; <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a name="l00324"></a><span class="lineno"> 324</span>&#160;</div>
<div class="line"><a name="l00325"></a><span class="lineno"> 325</span>&#160; <span class="comment">// Expand the key schedule up to the last round which gives</span></div>
<div class="line"><a name="l00326"></a><span class="lineno"> 326</span>&#160; <span class="comment">// us the round keys to use for the final two rounds. We can</span></div>
<div class="line"><a name="l00327"></a><span class="lineno"> 327</span>&#160; <span class="comment">// then work backwards from there in decryptBlock().</span></div>
<div class="line"><a name="l00328"></a><span class="lineno"> 328</span>&#160; schedule = reverse;</div>
<div class="line"><a name="l00329"></a><span class="lineno"> 329</span>&#160; memcpy(schedule, key, 32);</div>
<div class="line"><a name="l00330"></a><span class="lineno"> 330</span>&#160; <span class="keywordflow">for</span> (round = 1; round &lt;= 6; ++round) {</div>
<div class="line"><a name="l00331"></a><span class="lineno"> 331</span>&#160; KCORE(round);</div>
<div class="line"><a name="l00332"></a><span class="lineno"> 332</span>&#160; KXOR(1, 0);</div>
<div class="line"><a name="l00333"></a><span class="lineno"> 333</span>&#160; KXOR(2, 1);</div>
<div class="line"><a name="l00334"></a><span class="lineno"> 334</span>&#160; KXOR(3, 2);</div>
<div class="line"><a name="l00335"></a><span class="lineno"> 335</span>&#160; KSBOX();</div>
<div class="line"><a name="l00336"></a><span class="lineno"> 336</span>&#160; KXOR(5, 4);</div>
<div class="line"><a name="l00337"></a><span class="lineno"> 337</span>&#160; KXOR(6, 5);</div>
<div class="line"><a name="l00338"></a><span class="lineno"> 338</span>&#160; KXOR(7, 6);</div>
<div class="line"><a name="l00339"></a><span class="lineno"> 339</span>&#160; }</div>
<div class="line"><a name="l00340"></a><span class="lineno"> 340</span>&#160; KCORE(7);</div>
<div class="line"><a name="l00341"></a><span class="lineno"> 341</span>&#160; KXOR(1, 0);</div>
<div class="line"><a name="l00342"></a><span class="lineno"> 342</span>&#160; KXOR(2, 1);</div>
<div class="line"><a name="l00343"></a><span class="lineno"> 343</span>&#160; KXOR(3, 2);</div>
<div class="line"><a name="l00344"></a><span class="lineno"> 344</span>&#160;</div>
<div class="line"><a name="l00345"></a><span class="lineno"> 345</span>&#160; <span class="comment">// Key is ready to go.</span></div>
<div class="line"><a name="l00346"></a><span class="lineno"> 346</span>&#160; <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a name="l00347"></a><span class="lineno"> 347</span>&#160;}</div>
<div class="line"><a name="l00348"></a><span class="lineno"> 348</span>&#160;</div>
<div class="line"><a name="l00349"></a><span class="lineno"><a class="line" href="classAESSmall256.html#aaba6d59d07d2f40efa8c962375c15888"> 349</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="classAESSmall256.html#aaba6d59d07d2f40efa8c962375c15888">AESSmall256::decryptBlock</a>(uint8_t *output, <span class="keyword">const</span> uint8_t *input)</div>
<div class="line"><a name="l00350"></a><span class="lineno"> 350</span>&#160;{</div>
<div class="line"><a name="l00351"></a><span class="lineno"> 351</span>&#160; uint8_t schedule[32];</div>
<div class="line"><a name="l00352"></a><span class="lineno"> 352</span>&#160; uint8_t round;</div>
<div class="line"><a name="l00353"></a><span class="lineno"> 353</span>&#160; uint8_t posn;</div>
<div class="line"><a name="l00354"></a><span class="lineno"> 354</span>&#160; uint8_t state1[16];</div>
<div class="line"><a name="l00355"></a><span class="lineno"> 355</span>&#160; uint8_t state2[16];</div>
<div class="line"><a name="l00356"></a><span class="lineno"> 356</span>&#160; uint8_t temp[4];</div>
<div class="line"><a name="l00357"></a><span class="lineno"> 357</span>&#160;</div>
<div class="line"><a name="l00358"></a><span class="lineno"> 358</span>&#160; <span class="comment">// Start with the end of the decryption schedule.</span></div>
<div class="line"><a name="l00359"></a><span class="lineno"> 359</span>&#160; memcpy(schedule, reverse, 32);</div>
<div class="line"><a name="l00360"></a><span class="lineno"> 360</span>&#160;</div>
<div class="line"><a name="l00361"></a><span class="lineno"> 361</span>&#160; <span class="comment">// Copy the input into the state and reverse the final round.</span></div>
<div class="line"><a name="l00362"></a><span class="lineno"> 362</span>&#160; <span class="keywordflow">for</span> (posn = 0; posn &lt; 16; ++posn)</div>
<div class="line"><a name="l00363"></a><span class="lineno"> 363</span>&#160; state1[posn] = input[posn] ^ schedule[posn];</div>
<div class="line"><a name="l00364"></a><span class="lineno"> 364</span>&#160; AESCommon::inverseShiftRowsAndSubBytes(state2, state1);</div>
<div class="line"><a name="l00365"></a><span class="lineno"> 365</span>&#160; KXOR(3, 2);</div>
<div class="line"><a name="l00366"></a><span class="lineno"> 366</span>&#160; KXOR(2, 1);</div>
<div class="line"><a name="l00367"></a><span class="lineno"> 367</span>&#160; KXOR(1, 0);</div>
<div class="line"><a name="l00368"></a><span class="lineno"> 368</span>&#160; KCORE(7);</div>
<div class="line"><a name="l00369"></a><span class="lineno"> 369</span>&#160;</div>
<div class="line"><a name="l00370"></a><span class="lineno"> 370</span>&#160; <span class="comment">// Perform the next 12 rounds of the decryption process two at a time.</span></div>
<div class="line"><a name="l00371"></a><span class="lineno"> 371</span>&#160; <span class="keywordflow">for</span> (round = 6; round &gt;= 1; --round) {</div>
<div class="line"><a name="l00372"></a><span class="lineno"> 372</span>&#160; <span class="comment">// Decrypt using the right and left halves of the key schedule.</span></div>
<div class="line"><a name="l00373"></a><span class="lineno"> 373</span>&#160; DECRYPT(RIGHT);</div>
<div class="line"><a name="l00374"></a><span class="lineno"> 374</span>&#160; DECRYPT(LEFT);</div>
<div class="line"><a name="l00375"></a><span class="lineno"> 375</span>&#160;</div>
<div class="line"><a name="l00376"></a><span class="lineno"> 376</span>&#160; <span class="comment">// Expand the next 32 bytes of the key schedule in reverse.</span></div>
<div class="line"><a name="l00377"></a><span class="lineno"> 377</span>&#160; KXOR(7, 6);</div>
<div class="line"><a name="l00378"></a><span class="lineno"> 378</span>&#160; KXOR(6, 5);</div>
<div class="line"><a name="l00379"></a><span class="lineno"> 379</span>&#160; KXOR(5, 4);</div>
<div class="line"><a name="l00380"></a><span class="lineno"> 380</span>&#160; KSBOX();</div>
<div class="line"><a name="l00381"></a><span class="lineno"> 381</span>&#160; KXOR(3, 2);</div>
<div class="line"><a name="l00382"></a><span class="lineno"> 382</span>&#160; KXOR(2, 1);</div>
<div class="line"><a name="l00383"></a><span class="lineno"> 383</span>&#160; KXOR(1, 0);</div>
<div class="line"><a name="l00384"></a><span class="lineno"> 384</span>&#160; KCORE(round);</div>
<div class="line"><a name="l00385"></a><span class="lineno"> 385</span>&#160; }</div>
<div class="line"><a name="l00386"></a><span class="lineno"> 386</span>&#160;</div>
<div class="line"><a name="l00387"></a><span class="lineno"> 387</span>&#160; <span class="comment">// Reverse the initial round and create the output words.</span></div>
<div class="line"><a name="l00388"></a><span class="lineno"> 388</span>&#160; DECRYPT(RIGHT);</div>
<div class="line"><a name="l00389"></a><span class="lineno"> 389</span>&#160; <span class="keywordflow">for</span> (posn = 0; posn &lt; 16; ++posn)</div>
<div class="line"><a name="l00390"></a><span class="lineno"> 390</span>&#160; output[posn] = state2[posn] ^ schedule[posn];</div>
<div class="line"><a name="l00391"></a><span class="lineno"> 391</span>&#160;}</div>
<div class="line"><a name="l00392"></a><span class="lineno"> 392</span>&#160;</div>
<div class="line"><a name="l00393"></a><span class="lineno"><a class="line" href="classAESSmall256.html#ac63bf2dff7de8a73ba57f4bb0f1df444"> 393</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="classAESSmall256.html#ac63bf2dff7de8a73ba57f4bb0f1df444">AESSmall256::clear</a>()</div>
<div class="line"><a name="l00394"></a><span class="lineno"> 394</span>&#160;{</div>
<div class="line"><a name="l00395"></a><span class="lineno"> 395</span>&#160; clean(reverse);</div>
<div class="line"><a name="l00396"></a><span class="lineno"> 396</span>&#160; <a class="code" href="classAESTiny256.html#ae4cac6af2e78cbf399b7f6d0e613a578">AESTiny256::clear</a>();</div>
<div class="line"><a name="l00397"></a><span class="lineno"> 397</span>&#160;}</div>
<div class="ttc" id="classAESTiny256_html_ae4cac6af2e78cbf399b7f6d0e613a578"><div class="ttname"><a href="classAESTiny256.html#ae4cac6af2e78cbf399b7f6d0e613a578">AESTiny256::clear</a></div><div class="ttdeci">void clear()</div><div class="ttdoc">Clears all security-sensitive state from this block cipher. </div><div class="ttdef"><b>Definition:</b> <a href="AES256_8cpp_source.html#l00275">AES256.cpp:275</a></div></div>
<div class="ttc" id="classAESTiny256_html_a7b5a2ba4829e79283c53248d3d8a7a06"><div class="ttname"><a href="classAESTiny256.html#a7b5a2ba4829e79283c53248d3d8a7a06">AESTiny256::keySize</a></div><div class="ttdeci">size_t keySize() const </div><div class="ttdoc">Size of a 256-bit AES key in bytes. </div><div class="ttdef"><b>Definition:</b> <a href="AES256_8cpp_source.html#l00209">AES256.cpp:209</a></div></div>
<div class="ttc" id="classAESSmall256_html_aa343b59af73ad6c86541907f53f5572b"><div class="ttname"><a href="classAESSmall256.html#aa343b59af73ad6c86541907f53f5572b">AESSmall256::AESSmall256</a></div><div class="ttdeci">AESSmall256()</div><div class="ttdoc">Constructs an AES 256-bit block cipher with no initial key. </div><div class="ttdef"><b>Definition:</b> <a href="AES256_8cpp_source.html#l00306">AES256.cpp:306</a></div></div>
<div class="ttc" id="classAESTiny256_html_abdf72a52c37c060a9089693c118585bc"><div class="ttname"><a href="classAESTiny256.html#abdf72a52c37c060a9089693c118585bc">AESTiny256::decryptBlock</a></div><div class="ttdeci">void decryptBlock(uint8_t *output, const uint8_t *input)</div><div class="ttdoc">Decrypts a single block using this cipher. </div><div class="ttdef"><b>Definition:</b> <a href="AES256_8cpp_source.html#l00270">AES256.cpp:270</a></div></div>
<div class="ttc" id="classAESTiny256_html_a36e4ffc85f7d7604d01a5629c185d0ef"><div class="ttname"><a href="classAESTiny256.html#a36e4ffc85f7d7604d01a5629c185d0ef">AESTiny256::encryptBlock</a></div><div class="ttdeci">void encryptBlock(uint8_t *output, const uint8_t *input)</div><div class="ttdoc">Encrypts a single block using this cipher. </div><div class="ttdef"><b>Definition:</b> <a href="AES256_8cpp_source.html#l00224">AES256.cpp:224</a></div></div>
<div class="ttc" id="classAESSmall256_html_aaba6d59d07d2f40efa8c962375c15888"><div class="ttname"><a href="classAESSmall256.html#aaba6d59d07d2f40efa8c962375c15888">AESSmall256::decryptBlock</a></div><div class="ttdeci">void decryptBlock(uint8_t *output, const uint8_t *input)</div><div class="ttdoc">Decrypts a single block using this cipher. </div><div class="ttdef"><b>Definition:</b> <a href="AES256_8cpp_source.html#l00349">AES256.cpp:349</a></div></div>
<div class="ttc" id="classAES256_html_a3b2cbe56f03a87ec4260be4f8914fb02"><div class="ttname"><a href="classAES256.html#a3b2cbe56f03a87ec4260be4f8914fb02">AES256::AES256</a></div><div class="ttdeci">AES256()</div><div class="ttdoc">Constructs an AES 256-bit block cipher with no initial key. </div><div class="ttdef"><b>Definition:</b> <a href="AES256_8cpp_source.html#l00040">AES256.cpp:40</a></div></div>
<div class="ttc" id="classAES256_html_a6af085d2d6a730ff1e025f982121bbda"><div class="ttname"><a href="classAES256.html#a6af085d2d6a730ff1e025f982121bbda">AES256::setKey</a></div><div class="ttdeci">bool setKey(const uint8_t *key, size_t len)</div><div class="ttdoc">Sets the key to use for future encryption and decryption operations. </div><div class="ttdef"><b>Definition:</b> <a href="AES256_8cpp_source.html#l00060">AES256.cpp:60</a></div></div>
<div class="ttc" id="classAESTiny256_html_abc162075b181bfca34144f4eec6deec7"><div class="ttname"><a href="classAESTiny256.html#abc162075b181bfca34144f4eec6deec7">AESTiny256::setKey</a></div><div class="ttdeci">bool setKey(const uint8_t *key, size_t len)</div><div class="ttdoc">Sets the key to use for future encryption and decryption operations. </div><div class="ttdef"><b>Definition:</b> <a href="AES256_8cpp_source.html#l00214">AES256.cpp:214</a></div></div>
<div class="ttc" id="classAESSmall256_html_ac63bf2dff7de8a73ba57f4bb0f1df444"><div class="ttname"><a href="classAESSmall256.html#ac63bf2dff7de8a73ba57f4bb0f1df444">AESSmall256::clear</a></div><div class="ttdeci">void clear()</div><div class="ttdoc">Clears all security-sensitive state from this block cipher. </div><div class="ttdef"><b>Definition:</b> <a href="AES256_8cpp_source.html#l00393">AES256.cpp:393</a></div></div>
<div class="ttc" id="classAESTiny256_html_a7af85adfdbd0a3bb68ef5a8f76102043"><div class="ttname"><a href="classAESTiny256.html#a7af85adfdbd0a3bb68ef5a8f76102043">AESTiny256::AESTiny256</a></div><div class="ttdeci">AESTiny256()</div><div class="ttdoc">Constructs an AES 256-bit block cipher with no initial key. </div><div class="ttdef"><b>Definition:</b> <a href="AES256_8cpp_source.html#l00187">AES256.cpp:187</a></div></div>
<div class="ttc" id="classAES256_html_af8ed6412bae6fc78274f60344899366a"><div class="ttname"><a href="classAES256.html#af8ed6412bae6fc78274f60344899366a">AES256::keySize</a></div><div class="ttdeci">size_t keySize() const </div><div class="ttdoc">Size of a 256-bit AES key in bytes. </div><div class="ttdef"><b>Definition:</b> <a href="AES256_8cpp_source.html#l00055">AES256.cpp:55</a></div></div>
<div class="ttc" id="classAESSmall256_html_ae7e05119a6183d5f7fc520206f97c0e0"><div class="ttname"><a href="classAESSmall256.html#ae7e05119a6183d5f7fc520206f97c0e0">AESSmall256::setKey</a></div><div class="ttdeci">bool setKey(const uint8_t *key, size_t len)</div><div class="ttdoc">Sets the key to use for future encryption and decryption operations. </div><div class="ttdef"><b>Definition:</b> <a href="AES256_8cpp_source.html#l00315">AES256.cpp:315</a></div></div>
<div class="ttc" id="classAESTiny256_html_a3f48f55b7600dfc672acda899928de76"><div class="ttname"><a href="classAESTiny256.html#a3f48f55b7600dfc672acda899928de76">AESTiny256::blockSize</a></div><div class="ttdeci">size_t blockSize() const </div><div class="ttdoc">Size of an AES block in bytes. </div><div class="ttdef"><b>Definition:</b> <a href="AES256_8cpp_source.html#l00200">AES256.cpp:200</a></div></div>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Mon Apr 2 2018 18:36:52 for ArduinoLibs by &#160;<a href="http://www.doxygen.org/index.html">
Generated on Sat Apr 7 2018 02:43:13 for ArduinoLibs by &#160;<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.6
</small></address>