blob: 2d4a30b1e4a451715ef1687252cae5724e236dca [file]
(* Premptive.mod provides the Processes module with a premptive scheduler.
Copyright (C) 2020-2026 Free Software Foundation, Inc.
Contributed by Gaius Mulley <gaius.mulley@southwales.ac.uk>.
This file is part of GNU Modula-2.
GNU Modula-2 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 3, or (at your option)
any later version.
GNU Modula-2 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.
Under Section 7 of GPL version 3, you are granted additional
permissions described in the GCC Runtime Library Exception, version
3.1, as published by the Free Software Foundation.
You should have received a copy of the GNU General Public License and
a copy of the GCC Runtime Library Exception along with this program;
see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
<http://www.gnu.org/licenses/>. *)
IMPLEMENTATION MODULE Preemptive ;
FROM COROUTINES IMPORT TurnInterrupts, PROTECTION ;
FROM Processes IMPORT Wait, Attach, Detach, Create, ProcessId, Urgency, Activate, SuspendMe ;
FROM RTint IMPORT InitTimeVector, ReArmTimeVector, IncludeVector, ExcludeVector ;
FROM libc IMPORT printf ;
CONST
debugging = FALSE ;
(* The space we request becomes part of a stack request, which generally
has constraints on size and alignment. *)
extraWorkSpace = 10 * 1024 * 1024 ;
(*
timer - the timer process which runs at maximum scheduling priority with
interrupts off. It sleeps for a time quantum, performs a Wait
which will rotate the ready queue and then Waits again.
*)
PROCEDURE timer ;
VAR
vec,
currentUsec,
currentSec : CARDINAL ;
old : PROTECTION ;
BEGIN
IF debugging
THEN
printf ("timer\n");
END ;
old := TurnInterrupts (MAX (PROTECTION)) ;
vec := InitTimeVector (timeSliceUsec, timeSliceSec, MAX (PROTECTION)) ;
IF debugging
THEN
printf ("attach\n");
END ;
Attach (vec) ; (* attach vector to this process. *)
IF debugging
THEN
printf ("include vec\n");
END ;
IncludeVector (vec) ;
LOOP
currentSec := timeSliceSec ;
currentUsec := timeSliceUsec ;
IF debugging
THEN
printf ("timer process about to Wait\n");
END ;
Wait ;
(*
printf ("yes 2 seconds elapsed, suspending\n");
SuspendMe ;
*)
IF debugging
THEN
printf ("timer process wakes up, now calling ReArmTimeVector\n");
END ;
ReArmTimeVector (vec, timeSliceUsec, timeSliceSec) ;
IF debugging
THEN
printf ("ReArmTimeVector complete\n");
printf ("attach\n");
END ;
Attach (vec) ; (* attach vector to this process. *)
IF debugging
THEN
printf ("finished attach, now include vec\n");
END ;
IncludeVector (vec) ;
END
END timer ;
(*
initPreemptive - if millisecs > 0 then turn on preemptive scheduling.
if millisecs = 0 then preemptive scheduling is turned off.
*)
PROCEDURE initPreemptive (seconds, microsecs: CARDINAL) ;
BEGIN
timeSliceUsec := microsecs ;
timeSliceSec := seconds ;
IF NOT init
THEN
init := TRUE ;
Create (timer, extraWorkSpace, MAX (Urgency), NIL, timerId) ;
Activate (timerId)
END
END initPreemptive ;
VAR
init : BOOLEAN ;
timerId : ProcessId ;
timeSliceSec,
timeSliceUsec: CARDINAL ;
BEGIN
init := FALSE ;
timeSliceSec := 0 ;
timeSliceUsec := 0
END Preemptive.