Revision b74d5ee3 README.txt
README.txt | ||
---|---|---|
55 | 55 |
CONTENTS: |
56 | 56 |
|
57 | 57 |
1 Required software |
58 |
3 Building and flashing
|
|
58 |
2 Folder structure
|
|
59 | 59 |
|
60 | 60 |
================================================================================ |
61 | 61 |
|
... | ... | |
73 | 73 |
|
74 | 74 |
|
75 | 75 |
|
76 |
2 - BUILDING AND FLASHING |
|
77 |
------------------------- |
|
78 |
|
|
79 |
For building and flashing a specific setup, you must first define a |
|
80 |
configuration in the ./configurations folder (e.g. ./configurations/MyConf). |
|
81 |
Such a configuration must consist of a Makefile and a C header file with the |
|
82 |
name "osconf.h". Please copy the provided template files from the |
|
83 |
./configurations/template directory and modify them as required in order to |
|
84 |
minimize the risk of errors and for the sake of consistency. As a result you can |
|
85 |
build and flash all software using the Makefile. |
|
76 |
2 - FOLDER STRUCTURE |
|
77 |
-------------------- |
|
78 |
|
|
79 |
At its root, the AMiRo-Apps projects has six folders to distiquish between the |
|
80 |
most fundamental parts: |
|
81 |
. |
|
82 |
├── apps |
|
83 |
│ This folder includes individual applications, which can used by |
|
84 |
│ configigurations. Apps will usually be implemented as nodes for the |
|
85 |
│ middleware and provide acording interfaces via some message type(s). |
|
86 |
├── configurations |
|
87 |
│ Each configuration combines multiple apps and distributes them among any |
|
88 |
│ supported modules. Furthermore, configurations may modify parameters for |
|
89 |
│ each module individually. Finally, each configuration should come with a |
|
90 |
│ makefile, so a user can just use this to build and flash the whole setup. |
|
91 |
│ For better understanding, have a look at this example: |
|
92 |
│ - module A: using apps 1, 2 and 3 with parameters X and Y. |
|
93 |
│ - module B: using apps 1 and 4 with parameter X. |
|
94 |
│ - module C: using apps 1, 5, 6 and 7 with parameters X and Z. |
|
95 |
│ - Makefile: set and build everything. |
|
96 |
│ Note that each configuration needs to explicitely support a module and |
|
97 |
│ that there can never be an implicit default configuration. |
|
98 |
├── messagetypes |
|
99 |
│ Apps shoud take advantage of the middleware and thus implement nodes, |
|
100 |
│ which communicate via messages. Such messages may have payloads of |
|
101 |
│ arbitrary types, which can be defined in this folder. |
|
102 |
├── middleware |
|
103 |
│ This folder contains the µRtWare submodule and interface files. |
|
104 |
├── os |
|
105 |
│ This folder contains the AMiRo-OS submodule and interface files. |
|
106 |
└── tools |
|
107 |
Usable tools can be found in this dirctory. |
|
86 | 108 |
|
87 | 109 |
================================================================================ |
88 | 110 |
|
Also available in: Unified diff