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-26 08:02:15 +10:00
parent 93bbc1af6f
commit d095aa79fc
291 changed files with 885 additions and 534 deletions

View File

@@ -551,147 +551,145 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
<div class="line"><a name="l00553"></a><span class="lineno"> 553</span>&#160;<span class="preprocessor"></span></div>
<div class="line"><a name="l00554"></a><span class="lineno"><a class="line" href="classAcorn128.html#a4273a0b1eb880d98e34f2f9123fa167b"> 554</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="classAcorn128.html#a4273a0b1eb880d98e34f2f9123fa167b">Acorn128::encrypt</a>(uint8_t *output, <span class="keyword">const</span> uint8_t *input, <span class="keywordtype">size_t</span> len)</div>
<div class="line"><a name="l00555"></a><span class="lineno"> 555</span>&#160;{</div>
<div class="line"><a name="l00556"></a><span class="lineno"> 556</span>&#160; uint32_t temp;</div>
<div class="line"><a name="l00557"></a><span class="lineno"> 557</span>&#160; <span class="keywordflow">if</span> (!state.authDone) {</div>
<div class="line"><a name="l00558"></a><span class="lineno"> 558</span>&#160; acornPad(&amp;state, CB_1);</div>
<div class="line"><a name="l00559"></a><span class="lineno"> 559</span>&#160; state.authDone = 1;</div>
<div class="line"><a name="l00560"></a><span class="lineno"> 560</span>&#160; }</div>
<div class="line"><a name="l00561"></a><span class="lineno"> 561</span>&#160; <span class="keywordflow">while</span> (len &gt;= 4) {</div>
<div class="line"><a name="l00562"></a><span class="lineno"> 562</span>&#160; uint32_t temp = ((uint32_t)input[0]) |</div>
<div class="line"><a name="l00563"></a><span class="lineno"> 563</span>&#160; (((uint32_t)input[1]) &lt;&lt; 8) |</div>
<div class="line"><a name="l00564"></a><span class="lineno"> 564</span>&#160; (((uint32_t)input[2]) &lt;&lt; 16) |</div>
<div class="line"><a name="l00565"></a><span class="lineno"> 565</span>&#160; (((uint32_t)input[3]) &lt;&lt; 24);</div>
<div class="line"><a name="l00566"></a><span class="lineno"> 566</span>&#160; temp = acornEncrypt32Fast(&amp;state, temp);</div>
<div class="line"><a name="l00567"></a><span class="lineno"> 567</span>&#160; output[0] = (uint8_t)temp;</div>
<div class="line"><a name="l00568"></a><span class="lineno"> 568</span>&#160; output[1] = (uint8_t)(temp &gt;&gt; 8);</div>
<div class="line"><a name="l00569"></a><span class="lineno"> 569</span>&#160; output[2] = (uint8_t)(temp &gt;&gt; 16);</div>
<div class="line"><a name="l00570"></a><span class="lineno"> 570</span>&#160; output[3] = (uint8_t)(temp &gt;&gt; 24);</div>
<div class="line"><a name="l00571"></a><span class="lineno"> 571</span>&#160; input += 4;</div>
<div class="line"><a name="l00572"></a><span class="lineno"> 572</span>&#160; output += 4;</div>
<div class="line"><a name="l00573"></a><span class="lineno"> 573</span>&#160; len -= 4;</div>
<div class="line"><a name="l00574"></a><span class="lineno"> 574</span>&#160; }</div>
<div class="line"><a name="l00575"></a><span class="lineno"> 575</span>&#160; <span class="keywordflow">while</span> (len &gt; 0) {</div>
<div class="line"><a name="l00576"></a><span class="lineno"> 576</span>&#160; *output++ = acornEncrypt8(&amp;state, *input++, CA_1_BYTE, CB_0_BYTE);</div>
<div class="line"><a name="l00577"></a><span class="lineno"> 577</span>&#160; --len;</div>
<div class="line"><a name="l00578"></a><span class="lineno"> 578</span>&#160; }</div>
<div class="line"><a name="l00579"></a><span class="lineno"> 579</span>&#160;}</div>
<div class="line"><a name="l00580"></a><span class="lineno"> 580</span>&#160;</div>
<div class="line"><a name="l00581"></a><span class="lineno"><a class="line" href="classAcorn128.html#a7eacfc496f19b691207f64ba58b4c14a"> 581</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="classAcorn128.html#a7eacfc496f19b691207f64ba58b4c14a">Acorn128::decrypt</a>(uint8_t *output, <span class="keyword">const</span> uint8_t *input, <span class="keywordtype">size_t</span> len)</div>
<div class="line"><a name="l00582"></a><span class="lineno"> 582</span>&#160;{</div>
<div class="line"><a name="l00583"></a><span class="lineno"> 583</span>&#160; uint32_t temp;</div>
<div class="line"><a name="l00584"></a><span class="lineno"> 584</span>&#160; <span class="keywordflow">if</span> (!state.authDone) {</div>
<div class="line"><a name="l00585"></a><span class="lineno"> 585</span>&#160; acornPad(&amp;state, CB_1);</div>
<div class="line"><a name="l00586"></a><span class="lineno"> 586</span>&#160; state.authDone = 1;</div>
<div class="line"><a name="l00587"></a><span class="lineno"> 587</span>&#160; }</div>
<div class="line"><a name="l00588"></a><span class="lineno"> 588</span>&#160; <span class="keywordflow">while</span> (len &gt;= 4) {</div>
<div class="line"><a name="l00589"></a><span class="lineno"> 589</span>&#160; uint32_t temp = ((uint32_t)input[0]) |</div>
<div class="line"><a name="l00590"></a><span class="lineno"> 590</span>&#160; (((uint32_t)input[1]) &lt;&lt; 8) |</div>
<div class="line"><a name="l00591"></a><span class="lineno"> 591</span>&#160; (((uint32_t)input[2]) &lt;&lt; 16) |</div>
<div class="line"><a name="l00592"></a><span class="lineno"> 592</span>&#160; (((uint32_t)input[3]) &lt;&lt; 24);</div>
<div class="line"><a name="l00593"></a><span class="lineno"> 593</span>&#160; temp = acornDecrypt32(&amp;state, temp);</div>
<div class="line"><a name="l00594"></a><span class="lineno"> 594</span>&#160; output[0] = (uint8_t)temp;</div>
<div class="line"><a name="l00595"></a><span class="lineno"> 595</span>&#160; output[1] = (uint8_t)(temp &gt;&gt; 8);</div>
<div class="line"><a name="l00596"></a><span class="lineno"> 596</span>&#160; output[2] = (uint8_t)(temp &gt;&gt; 16);</div>
<div class="line"><a name="l00597"></a><span class="lineno"> 597</span>&#160; output[3] = (uint8_t)(temp &gt;&gt; 24);</div>
<div class="line"><a name="l00598"></a><span class="lineno"> 598</span>&#160; input += 4;</div>
<div class="line"><a name="l00599"></a><span class="lineno"> 599</span>&#160; output += 4;</div>
<div class="line"><a name="l00600"></a><span class="lineno"> 600</span>&#160; len -= 4;</div>
<div class="line"><a name="l00601"></a><span class="lineno"> 601</span>&#160; }</div>
<div class="line"><a name="l00602"></a><span class="lineno"> 602</span>&#160; <span class="keywordflow">while</span> (len &gt; 0) {</div>
<div class="line"><a name="l00603"></a><span class="lineno"> 603</span>&#160; *output++ = acornDecrypt8(&amp;state, *input++);</div>
<div class="line"><a name="l00604"></a><span class="lineno"> 604</span>&#160; --len;</div>
<div class="line"><a name="l00605"></a><span class="lineno"> 605</span>&#160; }</div>
<div class="line"><a name="l00606"></a><span class="lineno"> 606</span>&#160;}</div>
<div class="line"><a name="l00607"></a><span class="lineno"> 607</span>&#160;</div>
<div class="line"><a name="l00608"></a><span class="lineno"><a class="line" href="classAcorn128.html#a9a893539010c729c7d93a7acfd76ae67"> 608</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="classAcorn128.html#a9a893539010c729c7d93a7acfd76ae67">Acorn128::addAuthData</a>(<span class="keyword">const</span> <span class="keywordtype">void</span> *data, <span class="keywordtype">size_t</span> len)</div>
<div class="line"><a name="l00609"></a><span class="lineno"> 609</span>&#160;{</div>
<div class="line"><a name="l00610"></a><span class="lineno"> 610</span>&#160; <span class="comment">// Cannot add any more auth data if we&#39;ve started to encrypt or decrypt.</span></div>
<div class="line"><a name="l00611"></a><span class="lineno"> 611</span>&#160; <span class="keywordflow">if</span> (state.authDone)</div>
<div class="line"><a name="l00612"></a><span class="lineno"> 612</span>&#160; <span class="keywordflow">return</span>;</div>
<div class="line"><a name="l00613"></a><span class="lineno"> 613</span>&#160;</div>
<div class="line"><a name="l00614"></a><span class="lineno"> 614</span>&#160; <span class="comment">// Encrypt the auth data with ca = 1, cb = 1.</span></div>
<div class="line"><a name="l00615"></a><span class="lineno"> 615</span>&#160; <span class="keyword">const</span> uint8_t *input = (<span class="keyword">const</span> uint8_t *)data;</div>
<div class="line"><a name="l00616"></a><span class="lineno"> 616</span>&#160; <span class="keywordflow">while</span> (len &gt;= 4) {</div>
<div class="line"><a name="l00617"></a><span class="lineno"> 617</span>&#160; uint32_t temp = ((uint32_t)input[0]) |</div>
<div class="line"><a name="l00618"></a><span class="lineno"> 618</span>&#160; (((uint32_t)input[1]) &lt;&lt; 8) |</div>
<div class="line"><a name="l00619"></a><span class="lineno"> 619</span>&#160; (((uint32_t)input[2]) &lt;&lt; 16) |</div>
<div class="line"><a name="l00620"></a><span class="lineno"> 620</span>&#160; (((uint32_t)input[3]) &lt;&lt; 24);</div>
<div class="line"><a name="l00621"></a><span class="lineno"> 621</span>&#160; acornEncrypt32(&amp;state, temp, CA_1, CB_1);</div>
<div class="line"><a name="l00622"></a><span class="lineno"> 622</span>&#160; input += 4;</div>
<div class="line"><a name="l00623"></a><span class="lineno"> 623</span>&#160; len -= 4;</div>
<div class="line"><a name="l00624"></a><span class="lineno"> 624</span>&#160; }</div>
<div class="line"><a name="l00625"></a><span class="lineno"> 625</span>&#160; <span class="keywordflow">while</span> (len &gt; 0) {</div>
<div class="line"><a name="l00626"></a><span class="lineno"> 626</span>&#160; acornEncrypt8(&amp;state, *input++, CA_1_BYTE, CB_1_BYTE);</div>
<div class="line"><a name="l00627"></a><span class="lineno"> 627</span>&#160; --len;</div>
<div class="line"><a name="l00628"></a><span class="lineno"> 628</span>&#160; }</div>
<div class="line"><a name="l00629"></a><span class="lineno"> 629</span>&#160;}</div>
<div class="line"><a name="l00630"></a><span class="lineno"> 630</span>&#160;</div>
<div class="line"><a name="l00631"></a><span class="lineno"> 631</span>&#160;<span class="preprocessor">#endif // CRYPTO_ACORN128_DEFAULT</span></div>
<div class="line"><a name="l00632"></a><span class="lineno"> 632</span>&#160;<span class="preprocessor"></span></div>
<div class="line"><a name="l00633"></a><span class="lineno"><a class="line" href="classAcorn128.html#a333c98509f0ba55dff684d54781c0242"> 633</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="classAcorn128.html#a333c98509f0ba55dff684d54781c0242">Acorn128::computeTag</a>(<span class="keywordtype">void</span> *tag, <span class="keywordtype">size_t</span> len)</div>
<div class="line"><a name="l00634"></a><span class="lineno"> 634</span>&#160;{</div>
<div class="line"><a name="l00635"></a><span class="lineno"> 635</span>&#160; <span class="comment">// Finalize the data and apply padding.</span></div>
<div class="line"><a name="l00636"></a><span class="lineno"> 636</span>&#160; <span class="keywordflow">if</span> (!state.authDone)</div>
<div class="line"><a name="l00637"></a><span class="lineno"> 637</span>&#160; acornPad(&amp;state, CB_1);</div>
<div class="line"><a name="l00638"></a><span class="lineno"> 638</span>&#160; acornPad(&amp;state, CB_0);</div>
<div class="line"><a name="l00639"></a><span class="lineno"> 639</span>&#160;</div>
<div class="line"><a name="l00640"></a><span class="lineno"> 640</span>&#160; <span class="comment">// Encrypt 768 zero bits and extract the last 128 for the tag.</span></div>
<div class="line"><a name="l00641"></a><span class="lineno"> 641</span>&#160; uint32_t temp[4];</div>
<div class="line"><a name="l00642"></a><span class="lineno"> 642</span>&#160; <span class="keywordflow">for</span> (uint8_t i = 0; i &lt; 20; ++i)</div>
<div class="line"><a name="l00643"></a><span class="lineno"> 643</span>&#160; acornEncrypt32(&amp;state, 0, CA_1, CB_1);</div>
<div class="line"><a name="l00644"></a><span class="lineno"> 644</span>&#160; temp[0] = acornEncrypt32(&amp;state, 0, CA_1, CB_1);</div>
<div class="line"><a name="l00645"></a><span class="lineno"> 645</span>&#160; temp[1] = acornEncrypt32(&amp;state, 0, CA_1, CB_1);</div>
<div class="line"><a name="l00646"></a><span class="lineno"> 646</span>&#160; temp[2] = acornEncrypt32(&amp;state, 0, CA_1, CB_1);</div>
<div class="line"><a name="l00647"></a><span class="lineno"> 647</span>&#160; temp[3] = acornEncrypt32(&amp;state, 0, CA_1, CB_1);</div>
<div class="line"><a name="l00648"></a><span class="lineno"> 648</span>&#160;<span class="preprocessor">#if !defined(CRYPTO_LITTLE_ENDIAN)</span></div>
<div class="line"><a name="l00649"></a><span class="lineno"> 649</span>&#160;<span class="preprocessor"></span> temp[0] = htole32(temp[0]);</div>
<div class="line"><a name="l00650"></a><span class="lineno"> 650</span>&#160; temp[1] = htole32(temp[1]);</div>
<div class="line"><a name="l00651"></a><span class="lineno"> 651</span>&#160; temp[2] = htole32(temp[2]);</div>
<div class="line"><a name="l00652"></a><span class="lineno"> 652</span>&#160; temp[3] = htole32(temp[3]);</div>
<div class="line"><a name="l00653"></a><span class="lineno"> 653</span>&#160;<span class="preprocessor">#endif</span></div>
<div class="line"><a name="l00654"></a><span class="lineno"> 654</span>&#160;<span class="preprocessor"></span></div>
<div class="line"><a name="l00655"></a><span class="lineno"> 655</span>&#160; <span class="comment">// Truncate to the requested length and return the value.</span></div>
<div class="line"><a name="l00656"></a><span class="lineno"> 656</span>&#160; <span class="keywordflow">if</span> (len &gt; 16)</div>
<div class="line"><a name="l00657"></a><span class="lineno"> 657</span>&#160; len = 16;</div>
<div class="line"><a name="l00658"></a><span class="lineno"> 658</span>&#160; memcpy(tag, temp, len);</div>
<div class="line"><a name="l00659"></a><span class="lineno"> 659</span>&#160; clean(temp);</div>
<div class="line"><a name="l00660"></a><span class="lineno"> 660</span>&#160;}</div>
<div class="line"><a name="l00661"></a><span class="lineno"> 661</span>&#160;</div>
<div class="line"><a name="l00662"></a><span class="lineno"><a class="line" href="classAcorn128.html#a0a1c914c76d15af00bbb348f160bbacb"> 662</a></span>&#160;<span class="keywordtype">bool</span> <a class="code" href="classAcorn128.html#a0a1c914c76d15af00bbb348f160bbacb">Acorn128::checkTag</a>(<span class="keyword">const</span> <span class="keywordtype">void</span> *tag, <span class="keywordtype">size_t</span> len)</div>
<div class="line"><a name="l00663"></a><span class="lineno"> 663</span>&#160;{</div>
<div class="line"><a name="l00664"></a><span class="lineno"> 664</span>&#160; <span class="comment">// Can never match if the expected tag length is too long.</span></div>
<div class="line"><a name="l00665"></a><span class="lineno"> 665</span>&#160; <span class="keywordflow">if</span> (len &gt; 16)</div>
<div class="line"><a name="l00666"></a><span class="lineno"> 666</span>&#160; <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a name="l00667"></a><span class="lineno"> 667</span>&#160;</div>
<div class="line"><a name="l00668"></a><span class="lineno"> 668</span>&#160; <span class="comment">// Compute the authentication tag and check it.</span></div>
<div class="line"><a name="l00669"></a><span class="lineno"> 669</span>&#160; uint8_t temp[16];</div>
<div class="line"><a name="l00670"></a><span class="lineno"> 670</span>&#160; <a class="code" href="classAcorn128.html#a333c98509f0ba55dff684d54781c0242">computeTag</a>(temp, len);</div>
<div class="line"><a name="l00671"></a><span class="lineno"> 671</span>&#160; <span class="keywordtype">bool</span> equal = secure_compare(temp, tag, len);</div>
<div class="line"><a name="l00672"></a><span class="lineno"> 672</span>&#160; clean(temp);</div>
<div class="line"><a name="l00673"></a><span class="lineno"> 673</span>&#160; <span class="keywordflow">return</span> equal;</div>
<div class="line"><a name="l00674"></a><span class="lineno"> 674</span>&#160;}</div>
<div class="line"><a name="l00675"></a><span class="lineno"> 675</span>&#160;</div>
<div class="line"><a name="l00679"></a><span class="lineno"><a class="line" href="classAcorn128.html#ac98fa6f3ad9f12b090d678d94ffff56f"> 679</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="classAcorn128.html#ac98fa6f3ad9f12b090d678d94ffff56f">Acorn128::clear</a>()</div>
<div class="line"><a name="l00680"></a><span class="lineno"> 680</span>&#160;{</div>
<div class="line"><a name="l00681"></a><span class="lineno"> 681</span>&#160; clean(state);</div>
<div class="line"><a name="l00682"></a><span class="lineno"> 682</span>&#160;}</div>
<div class="line"><a name="l00556"></a><span class="lineno"> 556</span>&#160; <span class="keywordflow">if</span> (!state.authDone) {</div>
<div class="line"><a name="l00557"></a><span class="lineno"> 557</span>&#160; acornPad(&amp;state, CB_1);</div>
<div class="line"><a name="l00558"></a><span class="lineno"> 558</span>&#160; state.authDone = 1;</div>
<div class="line"><a name="l00559"></a><span class="lineno"> 559</span>&#160; }</div>
<div class="line"><a name="l00560"></a><span class="lineno"> 560</span>&#160; <span class="keywordflow">while</span> (len &gt;= 4) {</div>
<div class="line"><a name="l00561"></a><span class="lineno"> 561</span>&#160; uint32_t temp = ((uint32_t)input[0]) |</div>
<div class="line"><a name="l00562"></a><span class="lineno"> 562</span>&#160; (((uint32_t)input[1]) &lt;&lt; 8) |</div>
<div class="line"><a name="l00563"></a><span class="lineno"> 563</span>&#160; (((uint32_t)input[2]) &lt;&lt; 16) |</div>
<div class="line"><a name="l00564"></a><span class="lineno"> 564</span>&#160; (((uint32_t)input[3]) &lt;&lt; 24);</div>
<div class="line"><a name="l00565"></a><span class="lineno"> 565</span>&#160; temp = acornEncrypt32Fast(&amp;state, temp);</div>
<div class="line"><a name="l00566"></a><span class="lineno"> 566</span>&#160; output[0] = (uint8_t)temp;</div>
<div class="line"><a name="l00567"></a><span class="lineno"> 567</span>&#160; output[1] = (uint8_t)(temp &gt;&gt; 8);</div>
<div class="line"><a name="l00568"></a><span class="lineno"> 568</span>&#160; output[2] = (uint8_t)(temp &gt;&gt; 16);</div>
<div class="line"><a name="l00569"></a><span class="lineno"> 569</span>&#160; output[3] = (uint8_t)(temp &gt;&gt; 24);</div>
<div class="line"><a name="l00570"></a><span class="lineno"> 570</span>&#160; input += 4;</div>
<div class="line"><a name="l00571"></a><span class="lineno"> 571</span>&#160; output += 4;</div>
<div class="line"><a name="l00572"></a><span class="lineno"> 572</span>&#160; len -= 4;</div>
<div class="line"><a name="l00573"></a><span class="lineno"> 573</span>&#160; }</div>
<div class="line"><a name="l00574"></a><span class="lineno"> 574</span>&#160; <span class="keywordflow">while</span> (len &gt; 0) {</div>
<div class="line"><a name="l00575"></a><span class="lineno"> 575</span>&#160; *output++ = acornEncrypt8(&amp;state, *input++, CA_1_BYTE, CB_0_BYTE);</div>
<div class="line"><a name="l00576"></a><span class="lineno"> 576</span>&#160; --len;</div>
<div class="line"><a name="l00577"></a><span class="lineno"> 577</span>&#160; }</div>
<div class="line"><a name="l00578"></a><span class="lineno"> 578</span>&#160;}</div>
<div class="line"><a name="l00579"></a><span class="lineno"> 579</span>&#160;</div>
<div class="line"><a name="l00580"></a><span class="lineno"><a class="line" href="classAcorn128.html#a7eacfc496f19b691207f64ba58b4c14a"> 580</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="classAcorn128.html#a7eacfc496f19b691207f64ba58b4c14a">Acorn128::decrypt</a>(uint8_t *output, <span class="keyword">const</span> uint8_t *input, <span class="keywordtype">size_t</span> len)</div>
<div class="line"><a name="l00581"></a><span class="lineno"> 581</span>&#160;{</div>
<div class="line"><a name="l00582"></a><span class="lineno"> 582</span>&#160; <span class="keywordflow">if</span> (!state.authDone) {</div>
<div class="line"><a name="l00583"></a><span class="lineno"> 583</span>&#160; acornPad(&amp;state, CB_1);</div>
<div class="line"><a name="l00584"></a><span class="lineno"> 584</span>&#160; state.authDone = 1;</div>
<div class="line"><a name="l00585"></a><span class="lineno"> 585</span>&#160; }</div>
<div class="line"><a name="l00586"></a><span class="lineno"> 586</span>&#160; <span class="keywordflow">while</span> (len &gt;= 4) {</div>
<div class="line"><a name="l00587"></a><span class="lineno"> 587</span>&#160; uint32_t temp = ((uint32_t)input[0]) |</div>
<div class="line"><a name="l00588"></a><span class="lineno"> 588</span>&#160; (((uint32_t)input[1]) &lt;&lt; 8) |</div>
<div class="line"><a name="l00589"></a><span class="lineno"> 589</span>&#160; (((uint32_t)input[2]) &lt;&lt; 16) |</div>
<div class="line"><a name="l00590"></a><span class="lineno"> 590</span>&#160; (((uint32_t)input[3]) &lt;&lt; 24);</div>
<div class="line"><a name="l00591"></a><span class="lineno"> 591</span>&#160; temp = acornDecrypt32(&amp;state, temp);</div>
<div class="line"><a name="l00592"></a><span class="lineno"> 592</span>&#160; output[0] = (uint8_t)temp;</div>
<div class="line"><a name="l00593"></a><span class="lineno"> 593</span>&#160; output[1] = (uint8_t)(temp &gt;&gt; 8);</div>
<div class="line"><a name="l00594"></a><span class="lineno"> 594</span>&#160; output[2] = (uint8_t)(temp &gt;&gt; 16);</div>
<div class="line"><a name="l00595"></a><span class="lineno"> 595</span>&#160; output[3] = (uint8_t)(temp &gt;&gt; 24);</div>
<div class="line"><a name="l00596"></a><span class="lineno"> 596</span>&#160; input += 4;</div>
<div class="line"><a name="l00597"></a><span class="lineno"> 597</span>&#160; output += 4;</div>
<div class="line"><a name="l00598"></a><span class="lineno"> 598</span>&#160; len -= 4;</div>
<div class="line"><a name="l00599"></a><span class="lineno"> 599</span>&#160; }</div>
<div class="line"><a name="l00600"></a><span class="lineno"> 600</span>&#160; <span class="keywordflow">while</span> (len &gt; 0) {</div>
<div class="line"><a name="l00601"></a><span class="lineno"> 601</span>&#160; *output++ = acornDecrypt8(&amp;state, *input++);</div>
<div class="line"><a name="l00602"></a><span class="lineno"> 602</span>&#160; --len;</div>
<div class="line"><a name="l00603"></a><span class="lineno"> 603</span>&#160; }</div>
<div class="line"><a name="l00604"></a><span class="lineno"> 604</span>&#160;}</div>
<div class="line"><a name="l00605"></a><span class="lineno"> 605</span>&#160;</div>
<div class="line"><a name="l00606"></a><span class="lineno"><a class="line" href="classAcorn128.html#a9a893539010c729c7d93a7acfd76ae67"> 606</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="classAcorn128.html#a9a893539010c729c7d93a7acfd76ae67">Acorn128::addAuthData</a>(<span class="keyword">const</span> <span class="keywordtype">void</span> *data, <span class="keywordtype">size_t</span> len)</div>
<div class="line"><a name="l00607"></a><span class="lineno"> 607</span>&#160;{</div>
<div class="line"><a name="l00608"></a><span class="lineno"> 608</span>&#160; <span class="comment">// Cannot add any more auth data if we&#39;ve started to encrypt or decrypt.</span></div>
<div class="line"><a name="l00609"></a><span class="lineno"> 609</span>&#160; <span class="keywordflow">if</span> (state.authDone)</div>
<div class="line"><a name="l00610"></a><span class="lineno"> 610</span>&#160; <span class="keywordflow">return</span>;</div>
<div class="line"><a name="l00611"></a><span class="lineno"> 611</span>&#160;</div>
<div class="line"><a name="l00612"></a><span class="lineno"> 612</span>&#160; <span class="comment">// Encrypt the auth data with ca = 1, cb = 1.</span></div>
<div class="line"><a name="l00613"></a><span class="lineno"> 613</span>&#160; <span class="keyword">const</span> uint8_t *input = (<span class="keyword">const</span> uint8_t *)data;</div>
<div class="line"><a name="l00614"></a><span class="lineno"> 614</span>&#160; <span class="keywordflow">while</span> (len &gt;= 4) {</div>
<div class="line"><a name="l00615"></a><span class="lineno"> 615</span>&#160; uint32_t temp = ((uint32_t)input[0]) |</div>
<div class="line"><a name="l00616"></a><span class="lineno"> 616</span>&#160; (((uint32_t)input[1]) &lt;&lt; 8) |</div>
<div class="line"><a name="l00617"></a><span class="lineno"> 617</span>&#160; (((uint32_t)input[2]) &lt;&lt; 16) |</div>
<div class="line"><a name="l00618"></a><span class="lineno"> 618</span>&#160; (((uint32_t)input[3]) &lt;&lt; 24);</div>
<div class="line"><a name="l00619"></a><span class="lineno"> 619</span>&#160; acornEncrypt32(&amp;state, temp, CA_1, CB_1);</div>
<div class="line"><a name="l00620"></a><span class="lineno"> 620</span>&#160; input += 4;</div>
<div class="line"><a name="l00621"></a><span class="lineno"> 621</span>&#160; len -= 4;</div>
<div class="line"><a name="l00622"></a><span class="lineno"> 622</span>&#160; }</div>
<div class="line"><a name="l00623"></a><span class="lineno"> 623</span>&#160; <span class="keywordflow">while</span> (len &gt; 0) {</div>
<div class="line"><a name="l00624"></a><span class="lineno"> 624</span>&#160; acornEncrypt8(&amp;state, *input++, CA_1_BYTE, CB_1_BYTE);</div>
<div class="line"><a name="l00625"></a><span class="lineno"> 625</span>&#160; --len;</div>
<div class="line"><a name="l00626"></a><span class="lineno"> 626</span>&#160; }</div>
<div class="line"><a name="l00627"></a><span class="lineno"> 627</span>&#160;}</div>
<div class="line"><a name="l00628"></a><span class="lineno"> 628</span>&#160;</div>
<div class="line"><a name="l00629"></a><span class="lineno"> 629</span>&#160;<span class="preprocessor">#endif // CRYPTO_ACORN128_DEFAULT</span></div>
<div class="line"><a name="l00630"></a><span class="lineno"> 630</span>&#160;<span class="preprocessor"></span></div>
<div class="line"><a name="l00631"></a><span class="lineno"><a class="line" href="classAcorn128.html#a333c98509f0ba55dff684d54781c0242"> 631</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="classAcorn128.html#a333c98509f0ba55dff684d54781c0242">Acorn128::computeTag</a>(<span class="keywordtype">void</span> *tag, <span class="keywordtype">size_t</span> len)</div>
<div class="line"><a name="l00632"></a><span class="lineno"> 632</span>&#160;{</div>
<div class="line"><a name="l00633"></a><span class="lineno"> 633</span>&#160; <span class="comment">// Finalize the data and apply padding.</span></div>
<div class="line"><a name="l00634"></a><span class="lineno"> 634</span>&#160; <span class="keywordflow">if</span> (!state.authDone)</div>
<div class="line"><a name="l00635"></a><span class="lineno"> 635</span>&#160; acornPad(&amp;state, CB_1);</div>
<div class="line"><a name="l00636"></a><span class="lineno"> 636</span>&#160; acornPad(&amp;state, CB_0);</div>
<div class="line"><a name="l00637"></a><span class="lineno"> 637</span>&#160;</div>
<div class="line"><a name="l00638"></a><span class="lineno"> 638</span>&#160; <span class="comment">// Encrypt 768 zero bits and extract the last 128 for the tag.</span></div>
<div class="line"><a name="l00639"></a><span class="lineno"> 639</span>&#160; uint32_t temp[4];</div>
<div class="line"><a name="l00640"></a><span class="lineno"> 640</span>&#160; <span class="keywordflow">for</span> (uint8_t i = 0; i &lt; 20; ++i)</div>
<div class="line"><a name="l00641"></a><span class="lineno"> 641</span>&#160; acornEncrypt32(&amp;state, 0, CA_1, CB_1);</div>
<div class="line"><a name="l00642"></a><span class="lineno"> 642</span>&#160; temp[0] = acornEncrypt32(&amp;state, 0, CA_1, CB_1);</div>
<div class="line"><a name="l00643"></a><span class="lineno"> 643</span>&#160; temp[1] = acornEncrypt32(&amp;state, 0, CA_1, CB_1);</div>
<div class="line"><a name="l00644"></a><span class="lineno"> 644</span>&#160; temp[2] = acornEncrypt32(&amp;state, 0, CA_1, CB_1);</div>
<div class="line"><a name="l00645"></a><span class="lineno"> 645</span>&#160; temp[3] = acornEncrypt32(&amp;state, 0, CA_1, CB_1);</div>
<div class="line"><a name="l00646"></a><span class="lineno"> 646</span>&#160;<span class="preprocessor">#if !defined(CRYPTO_LITTLE_ENDIAN)</span></div>
<div class="line"><a name="l00647"></a><span class="lineno"> 647</span>&#160;<span class="preprocessor"></span> temp[0] = htole32(temp[0]);</div>
<div class="line"><a name="l00648"></a><span class="lineno"> 648</span>&#160; temp[1] = htole32(temp[1]);</div>
<div class="line"><a name="l00649"></a><span class="lineno"> 649</span>&#160; temp[2] = htole32(temp[2]);</div>
<div class="line"><a name="l00650"></a><span class="lineno"> 650</span>&#160; temp[3] = htole32(temp[3]);</div>
<div class="line"><a name="l00651"></a><span class="lineno"> 651</span>&#160;<span class="preprocessor">#endif</span></div>
<div class="line"><a name="l00652"></a><span class="lineno"> 652</span>&#160;<span class="preprocessor"></span></div>
<div class="line"><a name="l00653"></a><span class="lineno"> 653</span>&#160; <span class="comment">// Truncate to the requested length and return the value.</span></div>
<div class="line"><a name="l00654"></a><span class="lineno"> 654</span>&#160; <span class="keywordflow">if</span> (len &gt; 16)</div>
<div class="line"><a name="l00655"></a><span class="lineno"> 655</span>&#160; len = 16;</div>
<div class="line"><a name="l00656"></a><span class="lineno"> 656</span>&#160; memcpy(tag, temp, len);</div>
<div class="line"><a name="l00657"></a><span class="lineno"> 657</span>&#160; clean(temp);</div>
<div class="line"><a name="l00658"></a><span class="lineno"> 658</span>&#160;}</div>
<div class="line"><a name="l00659"></a><span class="lineno"> 659</span>&#160;</div>
<div class="line"><a name="l00660"></a><span class="lineno"><a class="line" href="classAcorn128.html#a0a1c914c76d15af00bbb348f160bbacb"> 660</a></span>&#160;<span class="keywordtype">bool</span> <a class="code" href="classAcorn128.html#a0a1c914c76d15af00bbb348f160bbacb">Acorn128::checkTag</a>(<span class="keyword">const</span> <span class="keywordtype">void</span> *tag, <span class="keywordtype">size_t</span> len)</div>
<div class="line"><a name="l00661"></a><span class="lineno"> 661</span>&#160;{</div>
<div class="line"><a name="l00662"></a><span class="lineno"> 662</span>&#160; <span class="comment">// Can never match if the expected tag length is too long.</span></div>
<div class="line"><a name="l00663"></a><span class="lineno"> 663</span>&#160; <span class="keywordflow">if</span> (len &gt; 16)</div>
<div class="line"><a name="l00664"></a><span class="lineno"> 664</span>&#160; <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a name="l00665"></a><span class="lineno"> 665</span>&#160;</div>
<div class="line"><a name="l00666"></a><span class="lineno"> 666</span>&#160; <span class="comment">// Compute the authentication tag and check it.</span></div>
<div class="line"><a name="l00667"></a><span class="lineno"> 667</span>&#160; uint8_t temp[16];</div>
<div class="line"><a name="l00668"></a><span class="lineno"> 668</span>&#160; <a class="code" href="classAcorn128.html#a333c98509f0ba55dff684d54781c0242">computeTag</a>(temp, len);</div>
<div class="line"><a name="l00669"></a><span class="lineno"> 669</span>&#160; <span class="keywordtype">bool</span> equal = secure_compare(temp, tag, len);</div>
<div class="line"><a name="l00670"></a><span class="lineno"> 670</span>&#160; clean(temp);</div>
<div class="line"><a name="l00671"></a><span class="lineno"> 671</span>&#160; <span class="keywordflow">return</span> equal;</div>
<div class="line"><a name="l00672"></a><span class="lineno"> 672</span>&#160;}</div>
<div class="line"><a name="l00673"></a><span class="lineno"> 673</span>&#160;</div>
<div class="line"><a name="l00677"></a><span class="lineno"><a class="line" href="classAcorn128.html#ac98fa6f3ad9f12b090d678d94ffff56f"> 677</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="classAcorn128.html#ac98fa6f3ad9f12b090d678d94ffff56f">Acorn128::clear</a>()</div>
<div class="line"><a name="l00678"></a><span class="lineno"> 678</span>&#160;{</div>
<div class="line"><a name="l00679"></a><span class="lineno"> 679</span>&#160; clean(state);</div>
<div class="line"><a name="l00680"></a><span class="lineno"> 680</span>&#160;}</div>
<div class="ttc" id="classAcorn128_html_af13cffd088e6ec25f9f781bea22fba12"><div class="ttname"><a href="classAcorn128.html#af13cffd088e6ec25f9f781bea22fba12">Acorn128::keySize</a></div><div class="ttdeci">size_t keySize() const </div><div class="ttdoc">Gets the size of the Acorn128 key in bytes. </div><div class="ttdef"><b>Definition:</b> <a href="Acorn128_8cpp_source.html#l00064">Acorn128.cpp:64</a></div></div>
<div class="ttc" id="classAcorn128_html_a4273a0b1eb880d98e34f2f9123fa167b"><div class="ttname"><a href="classAcorn128.html#a4273a0b1eb880d98e34f2f9123fa167b">Acorn128::encrypt</a></div><div class="ttdeci">void encrypt(uint8_t *output, const uint8_t *input, size_t len)</div><div class="ttdoc">Encrypts an input buffer and writes the ciphertext to an output buffer. </div><div class="ttdef"><b>Definition:</b> <a href="Acorn128_8cpp_source.html#l00554">Acorn128.cpp:554</a></div></div>
<div class="ttc" id="classAcorn128_html_ac98fa6f3ad9f12b090d678d94ffff56f"><div class="ttname"><a href="classAcorn128.html#ac98fa6f3ad9f12b090d678d94ffff56f">Acorn128::clear</a></div><div class="ttdeci">void clear()</div><div class="ttdoc">Clears all security-sensitive state from this cipher object. </div><div class="ttdef"><b>Definition:</b> <a href="Acorn128_8cpp_source.html#l00679">Acorn128.cpp:679</a></div></div>
<div class="ttc" id="classAcorn128_html_a333c98509f0ba55dff684d54781c0242"><div class="ttname"><a href="classAcorn128.html#a333c98509f0ba55dff684d54781c0242">Acorn128::computeTag</a></div><div class="ttdeci">void computeTag(void *tag, size_t len)</div><div class="ttdoc">Finalizes the encryption process and computes the authentication tag. </div><div class="ttdef"><b>Definition:</b> <a href="Acorn128_8cpp_source.html#l00633">Acorn128.cpp:633</a></div></div>
<div class="ttc" id="classAcorn128_html_a7eacfc496f19b691207f64ba58b4c14a"><div class="ttname"><a href="classAcorn128.html#a7eacfc496f19b691207f64ba58b4c14a">Acorn128::decrypt</a></div><div class="ttdeci">void decrypt(uint8_t *output, const uint8_t *input, size_t len)</div><div class="ttdoc">Decrypts an input buffer and writes the plaintext to an output buffer. </div><div class="ttdef"><b>Definition:</b> <a href="Acorn128_8cpp_source.html#l00581">Acorn128.cpp:581</a></div></div>
<div class="ttc" id="classAcorn128_html_ac98fa6f3ad9f12b090d678d94ffff56f"><div class="ttname"><a href="classAcorn128.html#ac98fa6f3ad9f12b090d678d94ffff56f">Acorn128::clear</a></div><div class="ttdeci">void clear()</div><div class="ttdoc">Clears all security-sensitive state from this cipher object. </div><div class="ttdef"><b>Definition:</b> <a href="Acorn128_8cpp_source.html#l00677">Acorn128.cpp:677</a></div></div>
<div class="ttc" id="classAcorn128_html_a333c98509f0ba55dff684d54781c0242"><div class="ttname"><a href="classAcorn128.html#a333c98509f0ba55dff684d54781c0242">Acorn128::computeTag</a></div><div class="ttdeci">void computeTag(void *tag, size_t len)</div><div class="ttdoc">Finalizes the encryption process and computes the authentication tag. </div><div class="ttdef"><b>Definition:</b> <a href="Acorn128_8cpp_source.html#l00631">Acorn128.cpp:631</a></div></div>
<div class="ttc" id="classAcorn128_html_a7eacfc496f19b691207f64ba58b4c14a"><div class="ttname"><a href="classAcorn128.html#a7eacfc496f19b691207f64ba58b4c14a">Acorn128::decrypt</a></div><div class="ttdeci">void decrypt(uint8_t *output, const uint8_t *input, size_t len)</div><div class="ttdoc">Decrypts an input buffer and writes the plaintext to an output buffer. </div><div class="ttdef"><b>Definition:</b> <a href="Acorn128_8cpp_source.html#l00580">Acorn128.cpp:580</a></div></div>
<div class="ttc" id="classAcorn128_html_a170c189599a1cf332db5496dd6bc1df4"><div class="ttname"><a href="classAcorn128.html#a170c189599a1cf332db5496dd6bc1df4">Acorn128::~Acorn128</a></div><div class="ttdeci">virtual ~Acorn128()</div><div class="ttdoc">Destroys this Acorn128 authenticated cipher. </div><div class="ttdef"><b>Definition:</b> <a href="Acorn128_8cpp_source.html#l00054">Acorn128.cpp:54</a></div></div>
<div class="ttc" id="classAcorn128_html_a2a2b2285ffc4d0ed57d661d739d22302"><div class="ttname"><a href="classAcorn128.html#a2a2b2285ffc4d0ed57d661d739d22302">Acorn128::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="Acorn128_8cpp_source.html#l00477">Acorn128.cpp:477</a></div></div>
<div class="ttc" id="classAcorn128_html_a4141564021e8233727beb5b9f645dc4e"><div class="ttname"><a href="classAcorn128.html#a4141564021e8233727beb5b9f645dc4e">Acorn128::ivSize</a></div><div class="ttdeci">size_t ivSize() const </div><div class="ttdoc">Gets the size of the Acorn128 initialization vector in bytes. </div><div class="ttdef"><b>Definition:</b> <a href="Acorn128_8cpp_source.html#l00077">Acorn128.cpp:77</a></div></div>
<div class="ttc" id="classAcorn128_html_a0a1c914c76d15af00bbb348f160bbacb"><div class="ttname"><a href="classAcorn128.html#a0a1c914c76d15af00bbb348f160bbacb">Acorn128::checkTag</a></div><div class="ttdeci">bool checkTag(const void *tag, size_t len)</div><div class="ttdoc">Finalizes the decryption process and checks the authentication tag. </div><div class="ttdef"><b>Definition:</b> <a href="Acorn128_8cpp_source.html#l00662">Acorn128.cpp:662</a></div></div>
<div class="ttc" id="classAcorn128_html_a0a1c914c76d15af00bbb348f160bbacb"><div class="ttname"><a href="classAcorn128.html#a0a1c914c76d15af00bbb348f160bbacb">Acorn128::checkTag</a></div><div class="ttdeci">bool checkTag(const void *tag, size_t len)</div><div class="ttdoc">Finalizes the decryption process and checks the authentication tag. </div><div class="ttdef"><b>Definition:</b> <a href="Acorn128_8cpp_source.html#l00660">Acorn128.cpp:660</a></div></div>
<div class="ttc" id="classAcorn128_html_ae4e9ecf2030c4d2e3f32a19f937de845"><div class="ttname"><a href="classAcorn128.html#ae4e9ecf2030c4d2e3f32a19f937de845">Acorn128::setIV</a></div><div class="ttdeci">bool setIV(const uint8_t *iv, size_t len)</div><div class="ttdoc">Sets the initialization vector to use for future encryption and decryption operations. </div><div class="ttdef"><b>Definition:</b> <a href="Acorn128_8cpp_source.html#l00495">Acorn128.cpp:495</a></div></div>
<div class="ttc" id="classAcorn128_html_af42823fb01dcbdeb8a93fa4103edebf2"><div class="ttname"><a href="classAcorn128.html#af42823fb01dcbdeb8a93fa4103edebf2">Acorn128::Acorn128</a></div><div class="ttdeci">Acorn128()</div><div class="ttdoc">Constructs a new Acorn128 authenticated cipher. </div><div class="ttdef"><b>Definition:</b> <a href="Acorn128_8cpp_source.html#l00046">Acorn128.cpp:46</a></div></div>
<div class="ttc" id="classAcorn128_html_a75c8953cea6b9cd59aa5034dfe739889"><div class="ttname"><a href="classAcorn128.html#a75c8953cea6b9cd59aa5034dfe739889">Acorn128::tagSize</a></div><div class="ttdeci">size_t tagSize() const </div><div class="ttdoc">Gets the size of the Acorn128 authentication tag in bytes. </div><div class="ttdef"><b>Definition:</b> <a href="Acorn128_8cpp_source.html#l00087">Acorn128.cpp:87</a></div></div>
<div class="ttc" id="classAcorn128_html_a9a893539010c729c7d93a7acfd76ae67"><div class="ttname"><a href="classAcorn128.html#a9a893539010c729c7d93a7acfd76ae67">Acorn128::addAuthData</a></div><div class="ttdeci">void addAuthData(const void *data, size_t len)</div><div class="ttdoc">Adds extra data that will be authenticated but not encrypted. </div><div class="ttdef"><b>Definition:</b> <a href="Acorn128_8cpp_source.html#l00608">Acorn128.cpp:608</a></div></div>
<div class="ttc" id="classAcorn128_html_a9a893539010c729c7d93a7acfd76ae67"><div class="ttname"><a href="classAcorn128.html#a9a893539010c729c7d93a7acfd76ae67">Acorn128::addAuthData</a></div><div class="ttdeci">void addAuthData(const void *data, size_t len)</div><div class="ttdoc">Adds extra data that will be authenticated but not encrypted. </div><div class="ttdef"><b>Definition:</b> <a href="Acorn128_8cpp_source.html#l00606">Acorn128.cpp:606</a></div></div>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Thu Apr 26 2018 06:55:48 for Arduino Cryptography Library by &#160;<a href="http://www.doxygen.org/index.html">
Generated on Thu Apr 26 2018 08:02:03 for Arduino Cryptography Library by &#160;<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.6
</small></address>