Refactor switch context ASM files to comply to Wizard.
[bertos.git] / bertos / kern / proc.h
index e9a910d4d5fbc466ae7bc217f7e651103b4532a5..7ac632ec1fb7fd3702d1dd4e8f20babfde3160f5 100644 (file)
  * Copyright 1999, 2000, 2001, 2008 Bernie Innocenti <bernie@codewiz.org>
  * -->
  *
- * \brief Process scheduler (public interface).
+ * \brief Bertos Kernel core (Process scheduler).
  *
  * \version $Id$
  * \author Bernie Innocenti <bernie@codewiz.org>
+ *
+ * $WIZ$ module_name = "kernel"
+ * $WIZ$ module_configuration = "bertos/cfg/cfg_proc.h"
+ * $WIZ$ module_depends = "switch_ctx"
  */
+
 #ifndef KERN_PROC_H
 #define KERN_PROC_H
 
-#include "cfg/cfg_kern.h"
+#include "cfg/cfg_proc.h"
+#include "cfg/cfg_monitor.h"
+
 #include <cfg/compiler.h>
 
 #if CONFIG_KERN_PREEMPT
@@ -54,9 +61,8 @@
  */
 struct Process;
 
-/* Task scheduling services */
 void proc_init(void);
-struct Process *proc_new_with_name(const charname, void (*entry)(void), iptr_t data, size_t stacksize, cpu_stack_t *stack);
+struct Process *proc_new_with_name(const char *name, void (*entry)(void), iptr_t data, size_t stacksize, cpu_stack_t *stack);
 
 #if !CONFIG_KERN_MONITOR
        #define proc_new(entry,data,size,stack) proc_new_with_name(NULL,(entry),(data),(size),(stack))
@@ -66,16 +72,27 @@ struct Process *proc_new_with_name(const char* name, void (*entry)(void), iptr_t
 
 void proc_exit(void);
 void proc_yield(void);
+void proc_rename(struct Process *proc, const char *name);
+const char *proc_name(struct Process *proc);
+const char *proc_currentName(void);
+iptr_t proc_currentUserData(void);
 
 int proc_testSetup(void);
 int proc_testRun(void);
 int proc_testTearDown(void);
 
-struct Process *proc_current(void);
-iptr_t proc_currentUserData(void);
-void proc_rename(struct Process *proc, const char *name);
-const char *proc_name(struct Process *proc);
-const char *proc_currentName(void);
+/**
+ * Return the context structure of the currently running process.
+ *
+ * The details of the Process structure are private to the scheduler.
+ * The address returned by this function is an opaque pointer that can
+ * be passed as an argument to other process-related functions.
+ */
+INLINE struct Process *proc_current(void)
+{
+       extern struct Process *CurrentProcess;
+       return CurrentProcess;
+}
 
 #if CONFIG_KERN_PRI
        void proc_setPri(struct Process *proc, int pri);
@@ -222,7 +239,7 @@ INLINE bool proc_allowed(void)
                 */
                #define CONFIG_KERN_MINSTACKSIZE  \
                    (CPU_SAVED_REGS_CNT * 2 * sizeof(cpu_stack_t) \
-                   + 32 * sizeof(int))
+                   + 48 * sizeof(int))
        #endif
 #endif