/* do not edit automatically generated by mc from RTco.  */
/* RTco.def provides minimal access to thread primitives.

Copyright (C) 2019-2023 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/>.  */


#if !defined (_RTco_H)
#   define _RTco_H

#include "config.h"
#include "system.h"
#   ifdef __cplusplus
extern "C" {
#   endif
#include <stdbool.h>
#   if !defined (PROC_D)
#      define PROC_D
       typedef void (*PROC_t) (void);
       typedef struct { PROC_t proc; } PROC;
#   endif

#   include "GSYSTEM.h"
#   include "GRTentity.h"

#   if defined (_RTco_C)
#      define EXTERN
#   else
#      define EXTERN extern
#   endif


/*
 init initializes the module and allows the application to lazily invoke threads.  */

EXTERN int RTco_init (void);

/*
 init initializes the module and allows the application to lazily invoke threads.  */

EXTERN int RTco_initThread (PROC p, unsigned int stackSize, unsigned int interruptLevel);

/*
 init initializes the module and allows the application to lazily invoke threads.  */

EXTERN int RTco_initSemaphore (unsigned int value);

/*
 init initializes the module and allows the application to lazily invoke threads.  */

EXTERN void RTco_wait (int semaphore);

/*
 init initializes the module and allows the application to lazily invoke threads.  */

EXTERN void RTco_signal (int semaphore);

/*
 init initializes the module and allows the application to lazily invoke threads.  */

EXTERN void RTco_transfer (int *p1, int p2);

/*
 init initializes the module and allows the application to lazily invoke threads.  */

EXTERN void RTco_waitThread (int tid);

/*
 init initializes the module and allows the application to lazily invoke threads.  */

EXTERN void RTco_signalThread (int tid);

/*
 init initializes the module and allows the application to lazily invoke threads.  */

EXTERN int RTco_currentThread (void);

/*
 currentInterruptLevel returns the interrupt level of the current thread.  */

EXTERN unsigned int RTco_currentInterruptLevel (void);
EXTERN unsigned int RTco_turnInterrupts (unsigned int newLevel);

/*
   select access to the select system call which will be thread safe.
   This is typically called from the idle process to wait for an interrupt.
*/

EXTERN int RTco_select (int p1, void * p2, void * p3, void * p4, void * p5);
#   ifdef __cplusplus
}
#   endif

#   undef EXTERN
#endif