--- /dev/null
+\95 Brief description: \r
+ To port FRSH from MARTE to OSE, FOSA was introduced. Here are the \r
+ first increment of the implementation of FOSA on OSE.\r
+\r
+\95 Version: First increment EP3v1, in the FRESCOR project.\r
+\r
+\95 Status: Not complete version. Though running tests of the implemented\r
+ parts.\r
+\r
+\95 Authors: of this folder (src_ose) and its content are \r
+ erik.thorin@enea.com\r
+ malin.ling@enea.com\r
+\r
+\95 Most recent versions of the software: Contact Enea.\r
+\r
+--------------------------------------------------------------------------\r
+----------- Short User Guide ---------------------------------------------\r
+--------------------------------------------------------------------------\r
+To make FOSA work on OSE, first install and then run the test program.\r
+\r
+Content the user guide:\r
+ - To install from Enea Linköpings Subversion\r
+ - To run the test program on the soft kernel\r
+ - To install from FRESCOR Subversion\r
+\r
+-------------To install from Enea Linköpings Subversion-------------------\r
+\95 Install a clean OSE5.2 installation with the standard choice. \r
+\r
+\95 Replace your newly created refsys catalogue with the one from \r
+ svn+ssh://selinsrv01/proj/FRESCOR/Repository/ose_including_frsh/trunk.\r
+(Can only be made from within Enea)\r
+\r
+\r
+-------------To run the test program on the soft kernel-------------------\r
+\95 Start cygwin.\r
+\r
+\95 Type "make all" in OSE5.2/refsys/rtose/sfk-win32/.\r
+\r
+\95 Start ose by typing "obj/rtose_debug/rtose.exe -c rtose5.conf".\r
+\r
+\95 Run the test program by typing "fosa_test".\r
+\r
+\r
+-------------To install from FRESCOR Subversion---------------------------\r
+\95 Install a clean OSE5.2 installation with the standard choice. \r
+\r
+\95 Copy the folders to these paths:\r
+ {Repository} = http://www.frescor.org/private/svn/frescor/fosa/trunk\r
+ \r
+ {Repository}/ \r
+ -> OSE5.2/refsys/modules/frescor_fosa\r
+ \r
+ {Repository}/src_ose/frescor_fosa_handlers \r
+ -> OSE5.2/refsys/modules/frescor_fosa_handlers\r
+ \r
+ {Repository}/src_ose/frescor_fosa_test \r
+ -> OSE5.2/refsys/modules/frescor_fosa_test\r
+ \r
+ {Repository}/../../frsh/trunk \r
+ -> OSE5.2/refsys/modules/frescor_frsh\r
+ \r
+\95 Merge the OSE part of the following three files into its counterparts. \r
+ This point is due to the bad design of FRSH and FOSA. FOSA are not a \r
+ clean API, it also uses things from FRSH. The OSE parts are clearly \r
+ marked in the files with "////// OSE ///////" in the beginning and \r
+ "////// End of OSE ///////" in the end.\r
+\r
+ {Repository}/src_ose/copies_of_changed_files/fosa_opaque_types.h\r
+ -> OSE5.2/refsys/modules/frescor_fosa/include/fosa_opaque_types.h\r
+\r
+ {Repository}/src_ose/copies_of_changed_files/fosa_types.h\r
+ -> OSE5.2/refsys/modules/frescor_fosa/include/fosa_types.h\r
+ \r
+ {Repository}/src_ose/copies_of_changed_files/frsh_fosa_opaque.h\r
+ -> OSE5.2/refsys/modules/frescor_frsh/include/frsh_fosa_opaque.h\r
+ \r
+\r
+\95 Change the file krn.con in the OSE board catalogue \r
+ i.e. OSE5.2/refsys/rtose/sfk-win32/krn.con\r
+ Add the following lines:\r
+\r
+ /* Added by Erik Thorin in krn.con */\r
+ CREATE_HANDLER (fosa_ose_create_handler)\r
+ SWAP_IN_HANDLER (fosa_ose_swap_in_handler)\r
+ SWAP_OUT_HANDLER (fosa_ose_swap_out_handler)\r
+ SWAP_OUT_HANDLER (fosa_ose_swap_out_handler2)\r
+ KILL_HANDLER (fosa_ose_kill_handler)\r
+ USER_AREA (21) /* Size of per process user area. */\r
+ /* End added by Erik Thorin */\r
+\r
+\95 Add the following lines to the file rtose.mk in the same catalogue \r
+\r
+ #Added by Erik Thorin in rtose.mk\r
+ override MODS += frescor_fosa_handlers\r
+ override MODS += frescor_fosa\r
+ override MODS += frescor_fosa_test\r
+ #override MODS += frescor_frsh\r
+ #End added by Erik Thorin\r
+\r
+\r
+--------------------------------------------------------------------------\r
+----------- End of the User Guide ----------------------------------------\r
+--------------------------------------------------------------------------\r
+\r
+\r
+// -----------------------------------------------------------------------\r
+// Copyright (C) 2006 - 2007 by the FRESCOR consortium:\r
+//\r
+// Universidad de Cantabria, SPAIN\r
+// University of York, UK\r
+// Scuola Superiore Sant'Anna, ITALY\r
+// Kaiserslautern University, GERMANY\r
+// Univ. Politecnica Valencia, SPAIN\r
+// Czech Technical University in Prague, CZECH REPUBLIC\r
+// ENEA SWEDEN\r
+// Thales Communication S.A. FRANCE\r
+// Visual Tools S.A. SPAIN\r
+// Rapita Systems Ltd UK\r
+// Evidence ITALY\r
+//\r
+// See http://www.frescor.org\r
+//\r
+// The FRESCOR project (FP6/2005/IST/5-034026) is funded\r
+// in part by the European Union Sixth Framework Programme\r
+// The European Union is not liable of any use that may be\r
+// made of this code.\r
+//\r
+// All rights reserved.\r
+//\r
+// Redistribution and use in source and binary forms, with or \r
+// without modification, are permitted provided that the \r
+// following conditions are met:\r
+//\r
+// * Redistributions of source code must retain the above \r
+// copyright notice, this list of conditions and the \r
+// following disclaimer.\r
+// * Redistributions in binary form must reproduce the above \r
+// copyright notice, this list of conditions and the \r
+// following disclaimer in the documentation and/or other \r
+// materials provided with the distribution.\r
+// * Neither the name of FRESCOR nor the names of its \r
+// contributors may be used to endorse or promote products \r
+// derived from this software without specific prior \r
+// written permission.\r
+//\r
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND \r
+// CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, \r
+// INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF \r
+// MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE \r
+// DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR \r
+// CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, \r
+// INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES \r
+// (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE \r
+// GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR \r
+// BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF \r
+// LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT \r
+// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT \r
+// OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE \r
+// POSSIBILITY OF SUCH DAMAGE.\r
+// -----------------------------------------------------------------------\r
+\r
+This work has been funded in part by the European Community\92s Sixth\r
+Framework Programme under the FRESCOR project (FP6/2005/IST/5-034026).
\ No newline at end of file