------------------------------------------------------------------------------
------------------------------------------------------------------------------
-- Cheddar is a GNU GPL real-time scheduling analysis tool.
-- This program provides services to automatically check schedulability and
-- other performance criteria of real-time architecture models.
--
-- Copyright (C) 2002-2023, Frank Singhoff, Alain Plantec, Jerome Legrand,
--                          Hai Nam Tran, Stephane Rubini
--
-- The Cheddar project was started in 2002 by
-- Frank Singhoff, Lab-STICC UMR 6285, Université de Bretagne Occidentale
--
-- Cheddar has been published in the "Agence de Protection des Programmes/France" in 2008.
-- Since 2008, Ellidiss technologies also contributes to the development of
-- Cheddar and provides industrial support.
--
-- The full list of contributors and sponsors can be found in README.md
--
-- This program is free software; you can redistribute it and/or modify
-- it under the terms of the GNU General Public License as published by
-- the Free Software Foundation; either version 2 of the License, or
-- (at your option) any later version.
--
-- This program is distributed in the hope that it will be useful,
-- but WITHOUT ANY WARRANTY; without even the implied warranty of
-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-- GNU General Public License for more details.
--
-- You should have received a copy of the GNU General Public License
-- along with this program; if not, write to the Free Software
-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
--
--
-- Contact : cheddar@listes.univ-brest.fr
--
------------------------------------------------------------------------------
-- Last update :
--    $Rev$
--    $Date$
--    $Author: singhoff $
------------------------------------------------------------------------------
------------------------------------------------------------------------------

with translate; use translate;

package body scheduler.multiprocessor_specific.pfair is

   function build_tcb
     (my_scheduler : in multiprocessor_pfair_scheduler;
      a_task       :    generic_task_ptr) return tcb_ptr
   is
      a_tcb : pfair_tcb_ptr;
   begin
      a_tcb := new pfair_tcb;
      initialize (tcb (a_tcb.all), a_task);
      initialize (a_tcb.all);
      return tcb_ptr (a_tcb);
   end build_tcb;

   procedure initialize (a_tcb : in out pfair_tcb) is
   begin
      a_tcb.quantum_d := 0.0;
      a_tcb.quantum_r := 0.0;
   end initialize;

   procedure specific_scheduler_initialization
     (my_scheduler       : in out multiprocessor_pfair_scheduler;
      si                 : in out scheduling_information;
      processor_name     : in     Unbounded_String;
      address_space_name : in     Unbounded_String;
      my_tasks           : in out tasks_set;
      my_schedulers      : in     scheduler_table;
      my_resources       : in out resources_set;
      my_buffers         : in out buffers_set;
      my_messages        : in     messages_set;
      msg                : in out Unbounded_String)
   is
   begin
      null;
   end specific_scheduler_initialization;

   procedure check_before_scheduling
     (my_scheduler   : in multiprocessor_pfair_scheduler;
      my_tasks       : in tasks_set;
      processor_name : in Unbounded_String)
   is

   begin
      periodic_control (my_tasks, processor_name);
      have_deadlines_equal_than_periods_control (my_tasks, processor_name);
   end check_before_scheduling;

   procedure compute_quantum_scheduling_parameters
     (my_scheduler   : in     multiprocessor_pfair_scheduler;
      processor_name : in     Unbounded_String;
      si             : in out scheduling_information)
   is

      i : tasks_range;

   begin

      -- Compute PFair dynamic priorities
      --
      i := 0;
      loop

         if (si.tcbs (i).tsk.cpu_name = processor_name) then

            pfair_tcb_ptr (si.tcbs (i)).quantum_d :=
              Double (si.tcbs (i).wake_up_time) +
              Double'ceiling
                (Double (si.tcbs (i).used_capacity + 1) /
                 (Double (si.tcbs (i).tsk.capacity) /
                  Double (periodic_task_ptr (si.tcbs (i).tsk).period)));
            pfair_tcb_ptr (si.tcbs (i)).quantum_r :=
              Double (si.tcbs (i).wake_up_time) +
              Double'floor
                (Double (si.tcbs (i).used_capacity) /
                 (Double (si.tcbs (i).tsk.capacity) /
                  Double (periodic_task_ptr (si.tcbs (i).tsk).period)));
         end if;

         i := i + 1;
         exit when si.tcbs (i) = null;
      end loop;

   end compute_quantum_scheduling_parameters;

end scheduler.multiprocessor_specific.pfair;