Revision b74d5ee3 README.txt

View differences:

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