µracoli Manual Version foo

- µracoli
- User Guide
- Reference Guide

uracoli-as6.md
1 # Atmel Studio 6 Project Template {#md_as6}
2
3 ## Introduction
4
5 It might of some help, if a preconfigured Atmel Studio 6 template can be used
6 as base for an the own µracoli software project.
7
8 Therefore we added the _halimbawa_ to the source code package
9 The tagalog word _Halimbawa_ means _example_ according to the
10 [Tagalog Dictionary](http://www.tagalog-dictionary.com/cgi-bin/search.pl?s=halimbawa Tagalog Dictionary)
11
12 ## Using the Template
13
14 ### Step 1: copy the project and rename it.
15
16 - Change into the directory `uracoli-src-<version>/as6/`
17 - Copy the entire directory `halimbawa` and rename it to e.g. `testproject`
18 - Change to the directory `testproject` and rename the file
19 `halimbawa.cproj` to `testproject.cproj`
20
21 ![Copy the Project](Doc/Images/as6_copy_project.png)
22
23 ### Step 2: open the copied project with AS6
24
25 - Double click on `testproject.cproj` and wait until Atmel-Studio has started.
26
27 ![Snapshot of the solution explorer window in AS6](Doc/Images/as6_solexp.png)
28
29 - Do a right click on _testproject_ in the _solution explorer window_ and
30 choose _Properties_.
31
32 ![Property selection](Doc/Images/as6_contextprop.png)
33
34 ### Step 3: Configure the project
35
36 - Find your board on <http://uracoli.nongnu.org/hwlist.html>.
37 - The yellow marked text is needed to update the AS6 configuration.
38
39 ![Board Info Page](Doc/Images/as6_boardinfo.png)
40
41 - In the properties dialogue select the _Toolchain_ tab.
42 - Adapt the the F_CPU value and enter the _target name_ of the board.
43 The preconfigured values are `F_CPU` set to 8MHz and target name `rbb128rfa1`.
44
45 ![GCC Symbols - add the target name and F_CPU](Doc/Images/as6_symbols.png)
46
47 - Select the _Device_ tab in the _Properties_ dialogue.
48 - Press the _Change Device_ button to select the MCU for your board.
49
50 ![Select the MCU of your board](Doc/Images/as6_selectmcu.png)
51
52 ### Step 4: add your code
53
54 Finally you can start with programming your own project.
55 Just edit in the file `main.c`, and leave the other source files untouched
56 ... unless you find a bug.