.. _chapter:prog:

Writing extensions
==================

.. TODO: copypaste

This chapter contains some bits and pieces of information about
programming yosys extensions. Also consult the section on programming in
the "Yosys Presentation" (can be downloaded from the Yosys website as
PDF) and don't be afraid to ask questions on the YosysHQ Slack.

Guidelines
----------

The guidelines directory contains notes on various aspects of Yosys
development. The files GettingStarted and CodingStyle may be of
particular interest, and are reproduced here.

.. literalinclude:: ../temp/GettingStarted
	:language: none
	:caption: guidelines/GettingStarted

.. literalinclude:: ../temp/CodingStyle
	:language: none
	:caption: guidelines/CodingStyle

The "stubsnets" example module
------------------------------

The following is the complete code of the "stubsnets" example module. It
is included in the Yosys source distribution as
docs/source/CHAPTER_Prog/stubnets.cc.

.. literalinclude:: ../CHAPTER_Prog/stubnets.cc
	:language: c++
	:linenos:
	:caption: docs/source/CHAPTER_Prog/stubnets.cc

.. literalinclude:: ../CHAPTER_Prog/Makefile
	:language: makefile
	:linenos:
	:caption: docs/source/CHAPTER_Prog/Makefile

.. literalinclude:: ../CHAPTER_Prog/test.v
	:language: verilog
	:linenos:
	:caption: docs/source/CHAPTER_Prog/test.v