µracoli Manual  Version foo
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.