# Makefile for Sphinx documentation
#

# You can set these variables from the command line.
SPHINXOPTS    =
SPHINXBUILD   = sphinx-build
PAPER         =
BUILDDIR      = _build

# Internal variables.
PAPEROPT_a4     = -D latex_paper_size=a4
PAPEROPT_letter = -D latex_paper_size=letter
ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
# the i18n builder cannot share the environment and doctrees with the others
I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .

.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext

help:
	@echo "Please use \`make <target>' where <target> is one of"
	@echo "  html       to make standalone HTML files"
	@echo "  dirhtml    to make HTML files named index.html in directories"
	@echo "  singlehtml to make a single large HTML file"
	@echo "  pickle     to make pickle files"
	@echo "  json       to make JSON files"
	@echo "  htmlhelp   to make HTML files and a HTML help project"
	@echo "  qthelp     to make HTML files and a qthelp project"
	@echo "  devhelp    to make HTML files and a Devhelp project"
	@echo "  epub       to make an epub"
	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
	@echo "  text       to make text files"
	@echo "  man        to make manual pages"
	@echo "  texinfo    to make Texinfo files"
	@echo "  info       to make Texinfo files and run them through makeinfo"
	@echo "  gettext    to make PO message catalogs"
	@echo "  changes    to make an overview of all changed/added/deprecated items"
	@echo "  linkcheck  to check all external links for integrity"
	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"

clean:
	-rm -rf $(BUILDDIR)/*

html:
	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
	@echo
	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."

dirhtml:
	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
	@echo
	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."

singlehtml:
	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
	@echo
	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."

pickle:
	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
	@echo
	@echo "Build finished; now you can process the pickle files."

json:
	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
	@echo
	@echo "Build finished; now you can process the JSON files."

htmlhelp:
	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
	@echo
	@echo "Build finished; now you can run HTML Help Workshop with the" \
	      ".hhp project file in $(BUILDDIR)/htmlhelp."

qthelp:
	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
	@echo
	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/Cryptography.qhcp"
	@echo "To view the help file:"
	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/Cryptography.qhc"

devhelp:
	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
	@echo
	@echo "Build finished."
	@echo "To view the help file:"
	@echo "# mkdir -p $$HOME/.local/share/devhelp/Cryptography"
	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/Cryptography"
	@echo "# devhelp"

epub:
	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
	@echo
	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."

latex:
	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
	@echo
	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
	@echo "Run \`make' in that directory to run these through (pdf)latex" \
	      "(use \`make latexpdf' here to do that automatically)."

latexpdf:
	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
	@echo "Running LaTeX files through pdflatex..."
	$(MAKE) -C $(BUILDDIR)/latex all-pdf
	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."

text:
	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
	@echo
	@echo "Build finished. The text files are in $(BUILDDIR)/text."

man:
	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
	@echo
	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."

texinfo:
	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
	@echo
	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
	@echo "Run \`make' in that directory to run these through makeinfo" \
	      "(use \`make info' here to do that automatically)."

info:
	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
	@echo "Running Texinfo files through makeinfo..."
	make -C $(BUILDDIR)/texinfo info
	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."

gettext:
	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
	@echo
	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."

changes:
	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
	@echo
	@echo "The overview file is in $(BUILDDIR)/changes."

linkcheck:
	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
	@echo
	@echo "Link check complete; look for any errors in the above output " \
	      "or in $(BUILDDIR)/linkcheck/output.txt."

doctest:
	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
	@echo "Testing of doctests in the sources fi<style>pre { line-height: 125%; margin: 0; }
td.linenos pre { color: #000000; background-color: #f0f0f0; padding: 0 5px 0 5px; }
span.linenos { color: #000000; background-color: #f0f0f0; padding: 0 5px 0 5px; }
td.linenos pre.special { color: #000000; background-color: #ffffc0; padding: 0 5px 0 5px; }
span.linenos.special { color: #000000; background-color: #ffffc0; padding: 0 5px 0 5px; }
.highlight .hll { background-color: #ffffcc }
.highlight { background: #ffffff; }
.highlight .c { color: #888888 } /* Comment */
.highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */
.highlight .k { color: #008800; font-weight: bold } /* Keyword */
.highlight .ch { color: #888888 } /* Comment.Hashbang */
.highlight .cm { color: #888888 } /* Comment.Multiline */
.highlight .cp { color: #cc0000; font-weight: bold } /* Comment.Preproc */
.highlight .cpf { color: #888888 } /* Comment.PreprocFile */
.highlight .c1 { color: #888888 } /* Comment.Single */
.highlight .cs { color: #cc0000; font-weight: bold; background-color: #fff0f0 } /* Comment.Special */
.highlight .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */
.highlight .ge { font-style: italic } /* Generic.Emph */
.highlight .gr { color: #aa0000 } /* Generic.Error */
.highlight .gh { color: #333333 } /* Generic.Heading */
.highlight .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */
.highlight .go { color: #888888 } /* Generic.Output */
.highlight .gp { color: #555555 } /* Generic.Prompt */
.highlight .gs { font-weight: bold } /* Generic.Strong */
.highlight .gu { color: #666666 } /* Generic.Subheading */
.highlight .gt { color: #aa0000 } /* Generic.Traceback */
.highlight .kc { color: #008800; font-weight: bold } /* Keyword.Constant */
.highlight .kd { color: #008800; font-weight: bold } /* Keyword.Declaration */
.highlight .kn { color: #008800; font-weight: bold } /* Keyword.Namespace */
.highlight .kp { color: #008800 } /* Keyword.Pseudo */
.highlight .kr { color: #008800; font-weight: bold } /* Keyword.Reserved */
.highlight .kt { color: #888888; font-weight: bold } /* Keyword.Type */
.highlight .m { color: #0000DD; font-weight: bold } /* Literal.Number */
.highlight .s { color: #dd2200; background-color: #fff0f0 } /* Literal.String */
.highlight .na { color: #336699 } /* Name.Attribute */
.highlight .nb { color: #003388 } /* Name.Builtin */
.highlight .nc { color: #bb0066; font-weight: bold } /* Name.Class */
.highlight .no { color: #003366; font-weight: bold } /* Name.Constant */
.highlight .nd { color: #555555 } /* Name.Decorator */
.highlight .ne { color: #bb0066; font-weight: bold } /* Name.Exception */
.highlight .nf { color: #0066bb; font-weight: bold } /* Name.Function */
.highlight .nl { color: #336699; font-style: italic } /* Name.Label */
.highlight .nn { color: #bb0066; font-weight: bold } /* Name.Namespace */
.highlight .py { color: #336699; font-weight: bold } /* Name.Property */
.highlight .nt { color: #bb0066; font-weight: bold } /* Name.Tag */
.highlight .nv { color: #336699 } /* Name.Variable */
.highlight .ow { color: #008800 } /* Operator.Word */
.highlight .w { color: #bbbbbb } /* Text.Whitespace */
.highlight .mb { color: #0000DD; font-weight: bold } /* Literal.Number.Bin */
.highlight .mf { color: #0000DD; font-weight: bold } /* Literal.Number.Float */
.highlight .mh { color: #0000DD; font-weight: bold } /* Literal.Number.Hex */
.highlight .mi { color: #0000DD; font-weight: bold } /* Literal.Number.Integer */
.highlight .mo { color: #0000DD; font-weight: bold } /* Literal.Number.Oct */
.highlight .sa { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Affix */
.highlight .sb { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Backtick */
.highlight .sc { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Char */
.highlight .dl { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Delimiter */
.highlight .sd { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Doc */
.highlight .s2 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Double */
.highlight .se { color: #0044dd; background-color: #fff0f0 } /* Literal.String.Escape */
.highlight .sh { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Heredoc */
.highlight .si { color: #3333bb; background-color: #fff0f0 } /* Literal.String.Interpol */
.highlight .sx { color: #22bb22; background-color: #f0fff0 } /* Literal.String.Other */
.highlight .sr { color: #008800; background-color: #fff0ff } /* Literal.String.Regex */
.highlight .s1 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Single */
.highlight .ss { color: #aa6600; background-color: #fff0f0 } /* Literal.String.Symbol */
.highlight .bp { color: #003388 } /* Name.Builtin.Pseudo */
.highlight .fm { color: #0066bb; font-weight: bold } /* Name.Function.Magic */
.highlight .vc { color: #336699 } /* Name.Variable.Class */
.highlight .vg { color: #dd7700 } /* Name.Variable.Global */
.highlight .vi { color: #3333bb } /* Name.Variable.Instance */
.highlight .vm { color: #336699 } /* Name.Variable.Magic */
.highlight .il { color: #0000DD; font-weight: bold } /* Literal.Number.Integer.Long */</style><div class="highlight"><pre><span></span><span class="c">#</span>
<span class="c">#             LUFA Library</span>
<span class="c">#     Copyright (C) Dean Camera, 2017.</span>
<span class="c">#</span>
<span class="c">#  dean [at] fourwalledcubicle [dot] com</span>
<span class="c">#           www.lufa-lib.org</span>
<span class="c">#</span>
<span class="c"># --------------------------------------</span>
<span class="c">#         LUFA Project Makefile.</span>
<span class="c"># --------------------------------------</span>

<span class="c"># Run &quot;make help&quot; for target help.</span>

<span class="nv">MCU</span>          <span class="o">=</span> at90usb1287
<span class="nv">ARCH</span>         <span class="o">=</span> AVR8
<span class="nv">BOARD</span>        <span class="o">=</span> USBKEY
<span class="nv">F_CPU</span>        <span class="o">=</span> <span class="m">8000000</span>
<span class="nv">F_USB</span>        <span class="o">=</span> <span class="k">$(</span>F_CPU<span class="k">)</span>
<span class="nv">OPTIMIZATION</span> <span class="o">=</span> s
<span class="nv">TARGET</span>       <span class="o">=</span> BootloaderPrinter
<span class="nv">SRC</span>          <span class="o">=</span> <span class="k">$(</span>TARGET<span class="k">)</span>.c Descriptors.c BootloaderAPI.c BootloaderAPITable.S <span class="k">$(</span>LUFA_SRC_USB<span class="k">)</span> <span class="k">$(</span>LUFA_SRC_USBCLASS<span class="k">)</span>
<span class="nv">LUFA_PATH</span>    <span class="o">=</span> ../../LUFA
<span class="nv">CC_FLAGS</span>     <span class="o">=</span> -DUSE_LUFA_CONFIG_HEADER -IConfig/ -DBOOT_START_ADDR<span class="o">=</span><span class="k">$(</span>BOOT_START_OFFSET<span class="k">)</span>
<span class="nv">LD_FLAGS</span>     <span class="o">=</span> -Wl,--section-start<span class="o">=</span>.text<span class="o">=</span><span class="k">$(</span>BOOT_START_OFFSET<span class="k">)</span> <span class="k">$(</span>BOOT_API_LD_FLAGS<span class="k">)</span>

<span class="c"># Flash size and bootloader section sizes of the target, in KB. These must</span>
<span class="c"># match the target&#39;s total FLASH size and the bootloader size set in the</span>
<span class="c"># device&#39;s fuses.</span>
<span class="nv">FLASH_SIZE_KB</span>         <span class="o">=</span> <span class="m">128</span>
<span class="nv">BOOT_SECTION_SIZE_KB</span>  <span class="o">=</span> <span class="m">8</span>

<span class="c"># Bootloader address calculation formulas</span>
<span class="c"># Do not modify these macros, but rather modify the dependent values above.</span>
<span class="nv">CALC_ADDRESS_IN_HEX</span>   <span class="o">=</span> <span class="k">$(</span>shell <span class="nb">printf</span> <span class="s2">&quot;0x%X&quot;</span> <span class="nv">$$</span><span class="o">((</span> <span class="k">$(</span><span class="m">1</span><span class="k">)</span> <span class="k">)</span><span class="o">)</span> <span class="o">)</span>
<span class="nv">BOOT_START_OFFSET</span>     <span class="o">=</span> <span class="k">$(</span>call CALC_ADDRESS_IN_HEX, <span class="o">(</span><span class="k">$(</span>FLASH_SIZE_KB<span class="k">)</span> - <span class="k">$(</span>BOOT_SECTION_SIZE_KB<span class="k">))</span> * <span class="m">1024</span> <span class="o">)</span>
<span class="nv">BOOT_SEC_OFFSET</span>       <span class="o">=</span> <span class="k">$(</span>call CALC_ADDRESS_IN_HEX, <span class="o">(</span><span class="k">$(</span>FLASH_SIZE_KB<span class="k">)</span> * <span class="m">1024</span><span class="k">)</span> - <span class="o">(</span><span class="k">$(</span>strip <span class="k">$(</span><span class="m">1</span><span class="k">))</span><span class="o">)</span> <span class="o">)</span>

<span class="c"># Bootloader linker section flags for relocating the API table sections to</span>
<span class="c"># known FLASH addresses - these should not normally be user-edited.</span>
<span class="nv">BOOT_SECTION_LD_FLAG</span>  <span class="o">=</span> -Wl,--section-start<span class="o">=</span><span class="k">$(</span>strip <span class="k">$(</span><span class="m">1</span><span class="k">))</span><span class="o">=</span><span class="k">$(</span>call BOOT_SEC_OFFSET, <span class="k">$(</span><span class="m">3</span><span class="k">))</span> -Wl,--undefined<span class="o">=</span><span class="k">$(</span>strip <span class="k">$(</span><span class="m">2</span><span class="k">))</span>
<span class="nv">BOOT_API_LD_FLAGS</span>     <span class="o">=</span> <span class="k">$(</span>call BOOT_SECTION_LD_FLAG, .apitable_trampolines, BootloaderAPI_Trampolines, <span class="m">96</span><span class="k">)</span>
<span class="nv">BOOT_API_LD_FLAGS</span>    <span class="o">+=</span> <span class="k">$(</span>call BOOT_SECTION_LD_FLAG, .apitable_jumptable,   BootloaderAPI_JumpTable,   <span class="m">32</span><span class="k">)</span>
<span class="nv">BOOT_API_LD_FLAGS</span>    <span class="o">+=</span> <span class="k">$(</span>call BOOT_SECTION_LD_FLAG, .apitable_signatures,  BootloaderAPI_Signatures,  <span class="m">8</span><span class="k">)</span>

<span class="c"># Default target</span>
<span class="nf">all</span><span class="o">:</span>

<span class="c"># Include LUFA-specific DMBS extension modules</span>
<span class="nv">DMBS_LUFA_PATH</span> <span class="o">?=</span> <span class="k">$(</span>LUFA_PATH<span class="k">)</span>/Build/LUFA
<span class="cp">include $(DMBS_LUFA_PATH)/lufa-sources.mk</span>
<span class="cp">include $(DMBS_LUFA_PATH)/lufa-gcc.mk</span>

<span class="c"># Include common DMBS build system modules</span>
<span class="nv">DMBS_PATH</span>      <span class="o">?=</span> <span class="k">$(</span>LUFA_PATH<span class="k">)</span>/Build/DMBS/DMBS
<span class="cp">include $(DMBS_PATH)/core.mk</span>
<span class="cp">include $(DMBS_PATH)/cppcheck.mk</span>
<span class="cp">include $(DMBS_PATH)/doxygen.mk</span>
<span class="cp">include $(DMBS_PATH)/dfu.mk</span>
<span class="cp">include $(DMBS_PATH)/gcc.mk</span>
<span class="cp">include $(DMBS_PATH)/hid.mk</span>
<span class="cp">include $(DMBS_PATH)/avrdude.mk</span>
<span class="cp">include $(DMBS_PATH)/atprogram.mk</span>
</pre></div>
</code></pre></td></tr></table>
</div> <!-- class=content -->
<div class='footer'>generated by <a href='https://git.zx2c4.com/cgit/about/'>cgit v1.2.3</a> (<a href='https://git-scm.com/'>git 2.25.1</a>) at 2026-01-08 21:11:14 +0000</div>
</div> <!-- id=cgit -->
</body>
</html>