Require Export prosa.model.priority.classes.
[Loading ML file ssrmatching_plugin.cmxs (using legacy method) ... done]
[Loading ML file ssreflect_plugin.cmxs (using legacy method) ... done]
[Loading ML file ring_plugin.cmxs (using legacy method) ... done]
[Loading ML file coq-elpi.elpi ... done]
[Loading ML file zify_plugin.cmxs (using legacy method) ... done]
[Loading ML file micromega_plugin.cmxs (using legacy method) ... done]
[Loading ML file btauto_plugin.cmxs (using legacy method) ... done]
Notation "_ + _" was already used in scope nat_scope.
[notation-overridden,parsing,default]
Notation "_ - _" was already used in scope nat_scope.
[notation-overridden,parsing,default]
Notation "_ <= _" was already used in scope nat_scope.
[notation-overridden,parsing,default]
Notation "_ < _" was already used in scope nat_scope.
[notation-overridden,parsing,default]
Notation "_ >= _" was already used in scope nat_scope.
[notation-overridden,parsing,default]
Notation "_ > _" was already used in scope nat_scope.
[notation-overridden,parsing,default]
Notation "_ <= _ <= _" was already used in scope
nat_scope. [notation-overridden,parsing,default]
Notation "_ < _ <= _" was already used in scope
nat_scope. [notation-overridden,parsing,default]
Notation "_ <= _ < _" was already used in scope
nat_scope. [notation-overridden,parsing,default]
Notation "_ < _ < _" was already used in scope
nat_scope. [notation-overridden,parsing,default]
Notation "_ * _" was already used in scope nat_scope.
[notation-overridden,parsing,default]

(** * Numeric Fixed Task Priorities *)

(** We define the notion of arbitrary numeric fixed task priorities, i.e.,
    tasks are prioritized in order of user-provided numeric priority values,
    where numerically smaller values indicate lower priorities (as for instance
    it is the case in Linux). *)

(** First, we define a new task parameter [task_priority] that maps each task
    to a numeric priority value. *)
Class TaskPriority (Task : TaskType) := task_priority : Task -> nat.

(** Based on this parameter, we define two corresponding FP policies. In one
    instance, a lower numeric value indicates lower priority, while in the other
    instance, a lower numeric value indicates higher priority. Both these
    interpretations can be found in practice and in the literature. For example,
    Linux uses "higher numeric value <-> higher priority", whereas many papers
    assume "lower numeric value <-> higher priority". *)

(** In this section, we define ascending numeric fixed priorities, where a
    larger numeric value indicates higher priority, and note some trivial facts
    about this interpretation of priority values. *)
Section PropertiesNFPA.

  (** The instance [NumericFPAscending] assigns higher priority to tasks with
      higher numeric [task_priority] value. *)
  #[local] Instance NumericFPAscending (Task : TaskType) `{TaskPriority Task} : FP_policy Task :=
    {
      hep_task (tsk1 tsk2 : Task) := task_priority tsk1 >= task_priority tsk2
    }.

  (**  Consider any kind of tasks with specified priorities... *)
  Context {Task : TaskType}.
  Context `{TaskPriority Task}.

  (** ...and jobs stemming from these tasks. *)
  Context {Job : JobType}.
  Context `{JobTask Job Task}.

  (** The resulting priority policy is reflexive. *)
  Lemma NFPA_is_reflexive : reflexive_task_priorities (NumericFPAscending Task).
Task: TaskType
H: TaskPriority Task
Job: JobType
H0: JobTask Job Task
reflexive_task_priorities (NumericFPAscending Task)
  Proof.
Task: TaskType
H: TaskPriority Task
Job: JobType
H0: JobTask Job Task
reflexive_task_priorities (NumericFPAscending Task)  by move=> ?; rewrite /hep_task /NumericFPAscending. Qed.

  (** The resulting priority policy is transitive. *)
  Lemma NFPA_is_transitive : transitive_task_priorities (NumericFPAscending Task).
Task: TaskType
H: TaskPriority Task
Job: JobType
H0: JobTask Job Task
transitive_task_priorities (NumericFPAscending Task)
  Proof.
Task: TaskType
H: TaskPriority Task
Job: JobType
H0: JobTask Job Task
transitive_task_priorities (NumericFPAscending Task)
    move=> y x z.
Task: TaskType
H: TaskPriority Task
Job: JobType
H0: JobTask Job Task
y, x, z: Task
hep_task x y -> hep_task y z -> hep_task x z
    by rewrite /hep_task /NumericFPAscending => PRIO_yx PRIO_xy; lia.
  Qed.

  (** The resulting priority policy is total. *)
  Lemma NFPA_is_total : total_task_priorities (NumericFPAscending Task).
Task: TaskType
H: TaskPriority Task
Job: JobType
H0: JobTask Job Task
total_task_priorities (NumericFPAscending Task)
  Proof.
Task: TaskType
H: TaskPriority Task
Job: JobType
H0: JobTask Job Task
total_task_priorities (NumericFPAscending Task) by move=> j1 j2; apply: leq_total. Qed.

End PropertiesNFPA.

(** Next, we define descending numeric fixed priorities, where a larger numeric
    value indicates lower priority, and again note some trivial facts about this
    alternate interpretation of priority values. *)
Section PropertiesNFPD.

  (** The instance [NumericFPDescending] assigns lower priority to tasks with
      higher numeric [task_priority] value. *)
  #[local] Instance NumericFPDescending (Task : TaskType) `{TaskPriority Task} : FP_policy Task :=
    {
      hep_task (tsk1 tsk2 : Task) := task_priority tsk1 <= task_priority tsk2
    }.

  (**  Consider any kind of tasks with specified priorities... *)
  Context {Task : TaskType}.
  Context `{TaskPriority Task}.

  (** ...and jobs stemming from these tasks. *)
  Context {Job : JobType}.
  Context `{JobTask Job Task}.

  (** The resulting priority policy is reflexive. *)
  Lemma NFPD_is_reflexive : reflexive_task_priorities (NumericFPDescending Task).
Task: TaskType
H: TaskPriority Task
Job: JobType
H0: JobTask Job Task
reflexive_task_priorities (NumericFPDescending Task)
  Proof.
Task: TaskType
H: TaskPriority Task
Job: JobType
H0: JobTask Job Task
reflexive_task_priorities (NumericFPDescending Task) by  move=> ?; rewrite /hep_task /NumericFPDescending. Qed.

  (** The resulting priority policy is transitive. *)
  Lemma NFPD_is_transitive : transitive_task_priorities (NumericFPDescending Task).
Task: TaskType
H: TaskPriority Task
Job: JobType
H0: JobTask Job Task
transitive_task_priorities (NumericFPDescending Task)
  Proof.
Task: TaskType
H: TaskPriority Task
Job: JobType
H0: JobTask Job Task
transitive_task_priorities (NumericFPDescending Task)
    move=> y x z.
Task: TaskType
H: TaskPriority Task
Job: JobType
H0: JobTask Job Task
y, x, z: Task
hep_task x y -> hep_task y z -> hep_task x z
    by rewrite /hep_task /NumericFPDescending => PRIO_yx PRIO_xy; lia.
  Qed.

  (** The resulting priority policy is total. *)
  Lemma NFPD_is_total : total_task_priorities (NumericFPDescending Task).
Task: TaskType
H: TaskPriority Task
Job: JobType
H0: JobTask Job Task
total_task_priorities (NumericFPDescending Task)
  Proof.
Task: TaskType
H: TaskPriority Task
Job: JobType
H0: JobTask Job Task
total_task_priorities (NumericFPDescending Task) by move=> j1 j2; apply: leq_total. Qed.

End PropertiesNFPD.

(** We add the above lemmas into a "Hint Database" basic_rt_facts, so Coq
    will be able to apply them automatically. *)
Global Hint Resolve
     NFPA_is_reflexive
     NFPA_is_transitive
     NFPA_is_total
     NFPD_is_reflexive
     NFPD_is_transitive
     NFPD_is_total
  : basic_rt_facts.