Sublime Text 2
==============

.. note::

	These instructions are written for Windows but should work similarly in Linux and Mac OS X

Aery32 Framework comes with the default `Sublime Text 2 <http://www.sublimetext.com/2>`_ project file which you can use straight away. The quickest way to start the project is to browse to the project directory and open ``aery32.sublime-project`` file using the right click and selecting *Open with Sublime Text 2*.

.. image:: ../images/st2_open_project_file.png
    :target: _images/st2_open_project_file.png
    :alt: Open ST2 project file with right click

After then change the default build system to *Aery32* from *Tools/Build System*.

.. image:: ../images/st2_select_build_system.png
    :target: _images/st2_select_build_system.png
    :alt: Change ST2 build system to Aery32

Shortcut keys
-------------

Use **Ctrl+B** and **Ctrl+Shift+B** shortcut keys to compile the project and to program the board, respectively.

.. image:: ../images/st2_board_flashing.png
    :target: _images/st2_board_flashing.png
    :alt: The board is programmed via ST2

For other make targets press **Ctrl+Shift+P** and write *build*. Then select the desired target from the list.

.. image:: ../images/st2_build_debug.png
    :target: _images/st2_build_debug.png
    :alt: Building with debug statements in ST2

When you want to open a file, let's say ``aery32/aery32/gpio.h``, press **Ctrl+P** and write *gpio*. Then select the file from the list. Of course you can also use the folder tree from the left-hand side if you like. Btw. it can be switched on and off with **Ctrl+K+B**.

.. image:: ../images/st2_open_file_quickly.png
    :target: _images/st2_open_file_quickly.png
    :alt: Open files quickly in ST2

Autocompletion with SublimeClang
--------------------------------

`SublimeClang <https://github.com/quarnster/SublimeClang>`_ provides a neat autocompletion for Aery32 project. With this plugin you don't have to remember all the function names and their parameters completely. Just write the beginning of the function, for example *gpio_t*, and you get a list of functions. Press **Ctrl+Space** to move on the list and **Tab** to select the function. When you have set the first param, you can press **Tab** again to jump to the next one.

.. image:: ../images/st2_autocompletion.png
    :target: _images/st2_autocompletion.png
    :alt: Example of ST2 autocompletion with SublimeClang

SublimeClang prerequisites for the clang static analyzer is to have clang installed and set in your path. The other functionality works without having the clang binaries installed. Here we only use the "other functionalities" and thus do not need clang. So install SublimeClang as instructed in its README without clang. In Linux you can also skip the additional prerequisities. Then open ``aery32.sublime-project`` and add the following in settings. If you are on Linux or Mac OS X, alter the AVR Toolchain installation directory appropriately.

.. code-block:: none

	"sublimeclang_enabled": true,
	"sublimeclang_options": [
		"-IC:/Program Files (x86)/Atmel/AVR Tools/AVR Toolchain/avr32/include",
		"-IC:/Program Files (x86)/Atmel/AVR Tools/AVR Toolchain/lib/gcc/avr32/4.4.3/include",
		"-IC:/Program Files (x86)/Atmel/AVR Tools/AVR Toolchain/lib/gcc/avr32/4.4.3/include-fixed",
		"-IC:/Program Files (x86)/Atmel/AVR Tools/AVR Toolchain/lib/gcc/avr32/4.4.3/include/c++",
		"-IC:/Program Files (x86)/Atmel/AVR Tools/AVR Toolchain/lib/gcc/avr32/4.4.3/include/c++/avr32",
		"-ccc-host-triple", "mips",
		"-D__AVR32_UC3A1128__",
		"-D__GNUC__=4",
		"-D__SCHAR_MAX__=127",
		"-D__INT_MAX__=2147483647",
		"-D__SHRT_MAX__=32767"
		"-I${this_file_path}/aery32",
		"-Wall"
	],
	"sublimeclang_dont_prepend_clang_includes": true,
	"sublimeclang_show_output_panel": false,
	"sublimeclang_show_status": false,
	"sublimeclang_show_visual_error_marks": true

.. image:: ../images/st2_sublimeclang_settings_for_avr32.png
    :target: _images/st2_sublimeclang_settings_for_avr32.png
    :alt: ST2 SublimeClang settings for AVR32 Toolchain