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