.. _tools_guide: XTC Tools Guide =============== The XTC tools are required by anyone developing or deploying applications on an XCore processor. The tools include: * "Tile-level" toolchain (Compiler, assembler, etc) * System libraries * "Network-level" tools (Multi-tile mapper etc) * XSIM simulator * XGDB debugger * Deployment tools The tools as delivered are to be used within a command line environment, though may also be :ref:`integrated with your preferred IDE `. Ultra quick start ----------------- #. :ref:`Install ` the tools and :ref:`configure ` the command line environment #. Write a short program: .. code-block:: :caption: main.c #include int main(void) { printf("Hello world\n"); } #. Build your application: .. code-block:: bash $ xcc -target=XCORE-200-EXPLORER main.c -o hello.xe #. Run it in the simulator (requires no hardware): .. code-block:: bash $ xsim hello.xe #. Run it on hardware (requires XTAG adapter and target board): .. code-block:: bash $ xrun hello.xe .. note:: Your target board will be accompanied by advice on the correct value to supply for :option:`xcc -target` in step 3. Support ------- For all support relating to the XTC tools, `raise a ticket `_. Be sure to supply the :ref:`toolkit version ` within your ticket. --------------------------------------------------------------------------- Full table of contents ---------------------- .. toctree:: :maxdepth: 2 install-configure/index quick-start/index tutorials/index tools-ref/index