1 \95 Brief description:
\r
2 To port FRSH from MARTE to OSE, FOSA was introduced. Here are the
\r
3 first increment of the implementation of FOSA on OSE.
\r
5 \95 Version: First increment EP3v1, in the FRESCOR project.
\r
7 \95 Status: Not complete version. Though running tests of the implemented
\r
10 \95 Authors: of this folder (src_ose) and its content are
\r
11 erik.thorin@enea.com
\r
14 \95 Most recent versions of the software: Contact Enea.
\r
16 --------------------------------------------------------------------------
\r
17 ----------- Short User Guide ---------------------------------------------
\r
18 --------------------------------------------------------------------------
\r
19 To make FOSA work on OSE, first install and then run the test program.
\r
21 Content the user guide:
\r
22 - To install from Enea Linköpings Subversion
\r
23 - To run the test program on the soft kernel
\r
24 - To install from FRESCOR Subversion
\r
26 -------------To install from Enea Linköpings Subversion-------------------
\r
27 \95 Install a clean OSE5.2 installation with the standard choice.
\r
29 \95 Replace your newly created refsys catalogue with the one from
\r
30 svn+ssh://selinsrv01/proj/FRESCOR/Repository/ose_including_frsh/trunk.
\r
31 (Can only be made from within Enea)
\r
34 -------------To run the test program on the soft kernel-------------------
\r
37 \95 Type "make all" in OSE5.2/refsys/rtose/sfk-win32/.
\r
39 \95 Start ose by typing "obj/rtose_debug/rtose.exe -c rtose5.conf".
\r
41 \95 Run the test program by typing "fosa_test".
\r
44 -------------To install from FRESCOR Subversion---------------------------
\r
45 \95 Install a clean OSE5.2 installation with the standard choice.
\r
47 \95 Copy the folders to these paths:
\r
48 {Repository} = http://www.frescor.org/private/svn/frescor/fosa/trunk
\r
51 -> OSE5.2/refsys/modules/frescor_fosa
\r
53 {Repository}/src_ose/frescor_fosa_handlers
\r
54 -> OSE5.2/refsys/modules/frescor_fosa_handlers
\r
56 {Repository}/src_ose/frescor_fosa_test
\r
57 -> OSE5.2/refsys/modules/frescor_fosa_test
\r
59 {Repository}/../../frsh/trunk
\r
60 -> OSE5.2/refsys/modules/frescor_frsh
\r
62 \95 Merge the OSE part of the following three files into its counterparts.
\r
63 This point is due to the bad design of FRSH and FOSA. FOSA are not a
\r
64 clean API, it also uses things from FRSH. The OSE parts are clearly
\r
65 marked in the files with "////// OSE ///////" in the beginning and
\r
66 "////// End of OSE ///////" in the end.
\r
68 {Repository}/src_ose/copies_of_changed_files/fosa_opaque_types.h
\r
69 -> OSE5.2/refsys/modules/frescor_fosa/include/fosa_opaque_types.h
\r
71 {Repository}/src_ose/copies_of_changed_files/fosa_types.h
\r
72 -> OSE5.2/refsys/modules/frescor_fosa/include/fosa_types.h
\r
74 {Repository}/src_ose/copies_of_changed_files/frsh_fosa_opaque.h
\r
75 -> OSE5.2/refsys/modules/frescor_frsh/include/frsh_fosa_opaque.h
\r
78 \95 Change the file krn.con in the OSE board catalogue
\r
79 i.e. OSE5.2/refsys/rtose/sfk-win32/krn.con
\r
80 Add the following lines:
\r
82 /* Added by Erik Thorin in krn.con */
\r
83 CREATE_HANDLER (fosa_ose_create_handler)
\r
84 SWAP_IN_HANDLER (fosa_ose_swap_in_handler)
\r
85 SWAP_OUT_HANDLER (fosa_ose_swap_out_handler)
\r
86 SWAP_OUT_HANDLER (fosa_ose_swap_out_handler2)
\r
87 KILL_HANDLER (fosa_ose_kill_handler)
\r
88 USER_AREA (21) /* Size of per process user area. */
\r
89 /* End added by Erik Thorin */
\r
91 \95 Add the following lines to the file rtose.mk in the same catalogue
\r
93 #Added by Erik Thorin in rtose.mk
\r
94 override MODS += frescor_fosa_handlers
\r
95 override MODS += frescor_fosa
\r
96 override MODS += frescor_fosa_test
\r
97 #override MODS += frescor_frsh
\r
98 #End added by Erik Thorin
\r
101 --------------------------------------------------------------------------
\r
102 ----------- End of the User Guide ----------------------------------------
\r
103 --------------------------------------------------------------------------
\r
106 // -----------------------------------------------------------------------
\r
107 // Copyright (C) 2006 - 2007 by the FRESCOR consortium:
\r
109 // Universidad de Cantabria, SPAIN
\r
110 // University of York, UK
\r
111 // Scuola Superiore Sant'Anna, ITALY
\r
112 // Kaiserslautern University, GERMANY
\r
113 // Univ. Politecnica Valencia, SPAIN
\r
114 // Czech Technical University in Prague, CZECH REPUBLIC
\r
116 // Thales Communication S.A. FRANCE
\r
117 // Visual Tools S.A. SPAIN
\r
118 // Rapita Systems Ltd UK
\r
121 // See http://www.frescor.org
\r
123 // The FRESCOR project (FP6/2005/IST/5-034026) is funded
\r
124 // in part by the European Union Sixth Framework Programme
\r
125 // The European Union is not liable of any use that may be
\r
126 // made of this code.
\r
128 // All rights reserved.
\r
130 // Redistribution and use in source and binary forms, with or
\r
131 // without modification, are permitted provided that the
\r
132 // following conditions are met:
\r
134 // * Redistributions of source code must retain the above
\r
135 // copyright notice, this list of conditions and the
\r
136 // following disclaimer.
\r
137 // * Redistributions in binary form must reproduce the above
\r
138 // copyright notice, this list of conditions and the
\r
139 // following disclaimer in the documentation and/or other
\r
140 // materials provided with the distribution.
\r
141 // * Neither the name of FRESCOR nor the names of its
\r
142 // contributors may be used to endorse or promote products
\r
143 // derived from this software without specific prior
\r
144 // written permission.
\r
146 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
\r
147 // CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
\r
148 // INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
\r
149 // MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
\r
150 // DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
\r
151 // CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
\r
152 // INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
\r
153 // (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
\r
154 // GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
\r
155 // BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
\r
156 // LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
\r
157 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
\r
158 // OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
\r
159 // POSSIBILITY OF SUCH DAMAGE.
\r
160 // -----------------------------------------------------------------------
\r
162 This work has been funded in part by the European Community
\92s Sixth
\r
163 Framework Programme under the FRESCOR project (FP6/2005/IST/5-034026).