git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@1713 35acf78f-673a-0410-8e92-d51de3d6d3f4

5 files changed, 564 insertions, 0 deletions

diff --git a/os/ports/RC/STM8/chcore.c b/os/ports/RC/STM8/chcore.c
new file mode 100644
index 000000000..029756a53
--- /dev/null
+++ b/os/ports/RC/STM8/chcore.c
@@ -0,0 +1,48 @@
+/*

+    ChibiOS/RT - Copyright (C) 2006-2007 Giovanni Di Sirio.

+

+    This file is part of ChibiOS/RT.

+

+    ChibiOS/RT 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 of the License, or

+    (at your option) any later version.

+

+    ChibiOS/RT 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, see <http://www.gnu.org/licenses/>.

+*/

+

+/**

+ * @file    templates/chcore.c

+ * @brief   Port related template code.

+ * @details This file is a template of the system driver functions provided by

+ *          a port. Some of the following functions may be implemented as

+ *          macros in chcore.h if the implementer decides that there is an

+ *          advantage in doing so, as example because performance concerns.

+ *

+ * @addtogroup core

+ * @{

+ */

+

+#include "ch.h"

+

+/**

+ * @brief   Halts the system.

+ * @details This function is invoked by the operating system when an

+ *          unrecoverable error is detected (as example because a programming

+ *          error in the application code that triggers an assertion while in

+ *          debug mode).
+ */

+void port_halt(void) {

+

+  port_disable();

+  while (TRUE) {

+  }

+}

+

+/** @} */

diff --git a/os/ports/RC/STM8/chcore.h b/os/ports/RC/STM8/chcore.h
new file mode 100644
index 000000000..79bf96019
--- /dev/null
+++ b/os/ports/RC/STM8/chcore.h
@@ -0,0 +1,267 @@
+/*

+    ChibiOS/RT - Copyright (C) 2006-2007 Giovanni Di Sirio.

+

+    This file is part of ChibiOS/RT.

+

+    ChibiOS/RT 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 of the License, or

+    (at your option) any later version.

+

+    ChibiOS/RT 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, see <http://www.gnu.org/licenses/>.

+*/

+

+/**

+ * @file    templates/chcore.h

+ * @brief   Port related template macros and structures.

+ * @details This file is a template of the system driver macros provided by

+ *          a port.

+ *

+ * @addtogroup core

+ * @{

+ */

+

+#ifndef _CHCORE_H_

+#define _CHCORE_H_

+

+#include <intrins.h>

+

+/**

+ * @brief   Unique macro for the implemented architecture.

+ */

+#define CH_ARCHITECTURE_STM8

+

+/**

+ * @brief   Name of the implemented architecture.

+ */

+#define CH_ARCHITECTURE_NAME "STM8"

+

+/**

+ * @brief   Base type for stack alignment.

+ * @note    No alignment constraints so uint8_t.

+ */

+typedef uint8_t stkalign_t;

+

+/**

+ * @brief   Interrupt saved context.

+ * @details This structure represents the stack frame saved during a

+ *          preemption-capable interrupt handler.

+ * @note    The structure requires one dummy field at its start because the

+ *          stack is handled as preincremented/postdecremented.

+ */

+struct extctx {

+  uint8_t       _next;

+  uint16_t      cx;

+  uint16_t      bx;

+  uint8_t       cc;

+  uint8_t       a;

+  uint16_t      x;

+  uint16_t      y;

+  uint8_t       pce;

+  uint8_t       pch;

+  uint8_t       pcl;

+};

+

+/**

+ * @brief   System saved context.

+ * @details This structure represents the inner stack frame during a context

+ *          switching..

+ * @note    The structure requires one dummy field at its start because the

+ *          stack is handled as preincremented/postdecremented.

+ */

+struct intctx {

+  uint8_t       _next;

+  uint16_t      pc;

+};

+

+/**

+ * @brief   Start context.

+ * @details This context is the stack organization for the trampoline code

+ *          @p _port_thread_start().

+ */

+struct startctx {

+  uint8_t       _next;

+  uint16_t      ts;             /* Trampoline address.                      */

+  uint16_t      arg;            /* Thread argument.                         */

+  uint16_t      pc;             /* Thread function address.                 */

+  uint16_t      ret;            /* chThdExit() address.                     */

+};

+

+/**

+ * @brief   Platform dependent part of the @p Thread structure.

+ * @details This structure usually contains just the saved stack pointer

+ *          defined as a pointer to a @p intctx structure.

+ */

+struct context {

+  struct intctx *sp;

+};

+

+/**

+ * @brief   Platform dependent part of the @p chThdInit() API.

+ * @details This code usually setup the context switching frame represented

+ *          by an @p intctx structure.

+ */

+#define SETUP_CONTEXT(workspace, wsize, pf, arg) {                      \

+  struct startctx *scp;                                                 \

+  scp = (struct startctx *)((uint8_t *)workspace + wsize  -             \

+                            sizeof(struct startctx));                   \

+  scp->ts   = (uint16_t)_port_thread_start;                             \

+  scp->arg  = (uint16_t)arg;                                            \

+  scp->pc   = (uint16_t)pf;                                             \

+  scp->ret  = (uint16_t)chThdExit;                                      \

+  tp->p_ctx.sp = (struct intctx *)scp;                                  \

+}

+

+/**

+ * @brief   Stack size for the system idle thread.

+ * @details This size depends on the idle thread implementation, usually

+ *          the idle thread should take no more space than those reserved

+ *          by @p INT_REQUIRED_STACK.

+ */

+#ifndef IDLE_THREAD_STACK_SIZE

+#define IDLE_THREAD_STACK_SIZE  0

+#endif

+

+/**

+ * @brief   Per-thread stack overhead for interrupts servicing.

+ * @details This constant is used in the calculation of the correct working

+ *          area size.

+ *          This value can be zero on those architecture where there is a

+ *          separate interrupt stack and the stack space between @p intctx and

+ *          @p extctx is known to be zero.

+ */

+#ifndef INT_REQUIRED_STACK

+#define INT_REQUIRED_STACK      32

+#endif

+

+/**

+ * @brief   Enforces a correct alignment for a stack area size value.

+ */

+#define STACK_ALIGN(n) ((((n) - 1) | (sizeof(stkalign_t) - 1)) + 1)

+

+/**

+ * @brief   Computes the thread working area global size.

+ */

+#define THD_WA_SIZE(n) STACK_ALIGN(sizeof(Thread) +                     \

+                                   (sizeof(struct intctx) - 1) +        \

+                                   (sizeof(struct extctx) - 1) +        \

+                                   (n) + (INT_REQUIRED_STACK))

+

+/**

+ * @brief   Static working area allocation.

+ * @details This macro is used to allocate a static thread working area

+ *          aligned as both position and size.

+ */

+#define WORKING_AREA(s, n) stkalign_t s[THD_WA_SIZE(n) / sizeof(stkalign_t)]

+

+/**

+ * @brief   IRQ prologue code.

+ * @details This macro must be inserted at the start of all IRQ handlers

+ *          enabled to invoke system APIs.

+ */

+#define PORT_IRQ_PROLOGUE()

+

+/**

+ * @brief   IRQ epilogue code.

+ * @details This macro must be inserted at the end of all IRQ handlers

+ *          enabled to invoke system APIs.

+ */

+#define PORT_IRQ_EPILOGUE() {   \

+  if (chSchIsRescRequiredExI()) \

+      chSchDoRescheduleI();     \

+}

+

+/**

+ * @brief   IRQ handler function declaration.

+ * @note    @p id can be a function name or a vector number depending on the

+ *          port implementation.
+ */

+#define PORT_IRQ_HANDLER(id) void irq##id(void) interrupt id

+

+/**

+ * @brief   Port-related initialization code.

+ * @note    None in this port.

+ */

+#define port_init()

+

+/**

+ * @brief   Kernel-lock action.

+ * @note    Implemented as global interrupts disable.

+ */

+#define port_lock() _sim_()

+

+/**

+ * @brief   Kernel-unlock action.

+ * @note    Implemented as global interrupts enable.

+ */

+#define port_unlock() _rim_()

+

+/**

+ * @brief   Kernel-lock action from an interrupt handler.

+ * @note    This function is empty in this port.

+ */

+#define port_lock_from_isr()

+

+/**

+ * @brief   Kernel-unlock action from an interrupt handler.

+ * @note    This function is empty in this port.

+ */

+#define port_unlock_from_isr()

+

+/**

+ * @brief   Disables all the interrupt sources.

+ * @note    Implemented as global interrupts disable.

+ * @note    Of course non maskable interrupt sources are not included.

+ */

+#define port_disable() _sim_()

+

+/**

+ * @brief   Disables the interrupt sources that are not supposed to preempt

+ *          the kernel.

+ * @note    Same as @p port_disable() in this port, there is no difference

+ *          between the two states.

+ */

+#define port_suspend() _sim_()

+

+/**

+ * @brief   Enables all the interrupt sources.

+ * @note    Implemented as global interrupt enable.

+ */

+#define port_enable() _rim_()

+

+/**

+ * @brief   Enters an architecture-dependent halt mode.

+ * @note    Implemented with the specific "wfi" instruction.

+ */

+#define port_wait_for_interrupt() _wfi_()

+

+/**

+ * @brief   Performs a context switch between two threads.

+ * @details This is the most critical code in any port, this function

+ *          is responsible for the context switch between 2 threads.

+ * @note    Implemented as a call to a low level assembler routine.

+ *

+ * @param otp   the thread to be switched out

+ * @param ntp   the thread to be switched in

+ */

+#define port_switch(otp, ntp) _port_switch(otp)

+

+#ifdef __cplusplus

+extern "C" {

+#endif

+  void port_halt(void);

+  void _port_switch(Thread *otp);

+  void _port_thread_start(void);

+#ifdef __cplusplus

+}

+#endif

+

+#endif /* _CHCORE_H_ */

+

+/** @} */

diff --git a/os/ports/RC/STM8/chcoreasm.asm b/os/ports/RC/STM8/chcoreasm.asm
new file mode 100644
index 000000000..1e125df0e
--- /dev/null
+++ b/os/ports/RC/STM8/chcoreasm.asm
@@ -0,0 +1,44 @@
+; ChibiOS/RT - Copyright (C) 2006-2007 Giovanni Di Sirio.

+;

+; This file is part of ChibiOS/RT.

+;

+; ChibiOS/RT 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 of the License, or

+; (at your option) any later version.

+

+; ChibiOS/RT 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, see <http://www.gnu.org/licenses/>.

+

+        ?PR??_THREAD_START?CHCOREASM SEGMENT CODE

+

+        RSEG        ?PR??_THREAD_START?CHCOREASM

+

+        EXTRN       PAGE0(rlist)

+

+        ; Performs a context switch between two threads.

+        ; In this port swapping the stack pointers is enough, there are

+        ; no registers to be preserved across function calls and the

+        ; program counter is already in the stack.

+        PUBLIC      ?_port_switch

+?_port_switch:

+        LDW         Y,SP

+        LDW         (005H,X),Y      ; SP saved in otp->p_ctx.sp

+;        LDW         X,(003H,SP)     ; ntp

+        LDW         X,rlist + 0DH   ; rlist.r_current (currp)

+        LDW         X,(005H,X)

+        LDW         SP,X            ; SP restored from currp->p_ctx.sp

+        RET

+

+        PUBLIC      ?_port_thread_start

+?_port_thread_start:

+        RIM

+        POPW        X

+        RET

+

+        end

diff --git a/os/ports/RC/STM8/chtypes.h b/os/ports/RC/STM8/chtypes.h
new file mode 100644
index 000000000..48587c722
--- /dev/null
+++ b/os/ports/RC/STM8/chtypes.h
@@ -0,0 +1,125 @@
+/*

+    ChibiOS/RT - Copyright (C) 2006-2007 Giovanni Di Sirio.

+

+    This file is part of ChibiOS/RT.

+

+    ChibiOS/RT 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 of the License, or

+    (at your option) any later version.

+

+    ChibiOS/RT 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, see <http://www.gnu.org/licenses/>.

+*/

+

+/**

+ * @file    templates/chtypes.h

+ * @brief   System types template.

+ * @details The types defined in this file may change depending on the target

+ *          architecture. You may also try to optimize the size of the various

+ *          types in order to privilege size or performance, be careful in

+ *          doing so.

+ *

+ * @addtogroup types

+ * @{

+ */

+

+#ifndef _CHTYPES_H_

+#define _CHTYPES_H_

+

+#define __need_NULL

+#define __need_size_t

+#include <stddef.h>

+

+//#if !defined(_STDINT_H) && !defined(__STDINT_H_)

+//#include <stdint.h>

+//#endif

+

+typedef unsigned char   uint8_t;

+typedef signed char     int8_t;

+typedef unsigned int    uint16_t;

+typedef signed int      int16_t;

+typedef unsigned long   uint32_t;

+typedef signed long     int32_t;

+typedef uint8_t         uint_fast8_t;

+typedef uint16_t        uint_fast16_t;

+typedef uint32_t        uint_fast32_t;

+

+/**

+ * @brief   Boolean, recommended the fastest signed.

+ */

+typedef int8_t          bool_t;

+

+/**

+ * @brief   Thread mode flags, uint8_t is ok.

+ */

+typedef uint8_t         tmode_t;

+

+/**

+ * @brief   Thread state, uint8_t is ok.

+ */

+typedef uint8_t         tstate_t;

+

+/**

+ * @brief   Thread references counter, uint8_t is ok.

+ */

+typedef uint8_t         trefs_t;

+

+/**

+ * @brief   Priority, use the fastest unsigned type.

+ */

+typedef uint8_t         tprio_t;

+

+/**

+ * @brief   Message, use signed pointer equivalent.

+ */

+typedef int16_t         msg_t;

+

+/**

+ * @brief   Event Id, use fastest signed.

+ */

+typedef int8_t          eventid_t;

+

+/**

+ * @brief   Event Mask, recommended fastest unsigned.

+ */

+typedef uint8_t         eventmask_t;

+

+/**

+ * @brief   System Time, recommended fastest unsigned.

+ */

+typedef uint16_t        systime_t;

+

+/**

+ * @brief   Counter, recommended fastest signed.

+ */

+typedef int16_t         cnt_t;

+

+/**

+ * @brief   Inline function modifier.

+ */

+#define INLINE inline

+

+/**

+ * @brief   Packed structure modifier (within).

+ */

+#define PACK_STRUCT_STRUCT

+

+/**

+ * @brief   Packed structure modifier (before).

+ */

+#define PACK_STRUCT_BEGIN

+

+/**

+ * @brief   Packed structure modifier (after).

+ */

+#define PACK_STRUCT_END

+

+#endif /* _CHTYPES_H_ */

+

+/** @} */

diff --git a/os/ports/RC/STM8/port.dox b/os/ports/RC/STM8/port.dox
new file mode 100644
index 000000000..594fcd468
--- /dev/null
+++ b/os/ports/RC/STM8/port.dox
@@ -0,0 +1,80 @@
+/*

+    ChibiOS/RT - Copyright (C) 2006-2007 Giovanni Di Sirio.

+

+    This file is part of ChibiOS/RT.

+

+    ChibiOS/RT 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 of the License, or

+    (at your option) any later version.

+

+    ChibiOS/RT 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, see <http://www.gnu.org/licenses/>.

+*/

+

+/**

+ * @defgroup STM8 STM8

+ * @details STM8 port details. This section how the ChibiOS/RT features are

+ * implemented on this architecture.

+ *

+ * @section STM8_STATES Mapping of the System States in the STM8 port

+ * The ChibiOS/RT logical @ref system_states are mapped as follow in the STM8

+ * port:

+ * - <b>Init</b>. This state is represented by the startup code and the

+ *   initialization code before @p chSysInit() is executed. It has not a

+ *   special hardware state associated.

+ * - <b>Normal</b>. This is the state the system has after executing

+ *   @p chSysInit(). Interrupts are enabled.

+ * - <b>Suspended</b>. Interrupts are disabled.

+ * - <b>Disabled</b>. Interrupts are enabled. This state is equivalent to the

+ *   Suspended state because there are no fast interrupts in this architecture.

+ * - <b>Sleep</b>. Implemented with "wait" instruction insertion in the idle

+ *   loop.

+ * - <b>S-Locked</b>. Interrupts are disabled.

+ * - <b>I-Locked</b>. This state is equivalent to the SRI state, the

+ *   @p chSysLockI() and @p chSysUnlockI() APIs do nothing (still use them in

+ *   order to formally change state because this may change).

+ * - <b>Serving Regular Interrupt</b>. Normal interrupt service code.

+ * - <b>Serving Fast Interrupt</b>. Not present in this architecture.

+ * - <b>Serving Non-Maskable Interrupt</b>. The STM8 ha non

+ *   maskable interrupt sources that can be associated to this state.

+ * - <b>Halted</b>. Implemented as an infinite loop with interrupts disabled.

+ * .

+ * @section STM8_NOTES The STM8 port notes

+ * - The STM8 does not have a dedicated interrupt stack, make sure to reserve

+ *     enough stack space for interrupts in each thread stack. This can be done

+ *     by modifying the @p INT_REQUIRED_STACK macro into

+ *     <b>./os/ports/RC/STM8/chcore.h</b>.

+ * .

+ * @ingroup ports

+ */

+

+/**

+ * @defgroup STM8_CONF Configuration Options

+ * @brief STM8 Configuration Options.

+ * @details The STM8 port allows some architecture-specific configurations

+ * settings that can be specified externally, as example on the compiler

+ * command line:

+ * - @p INT_REQUIRED_STACK, this value represent the amount of stack space

+ *   used by the interrupt handlers.<br>

+ *   The default for this value is @p 32, this space is allocated for each

+ *   thread so be careful in order to not waste precious RAM space.<br>

+ *   The default value is set into <b>./os/ports/RC/STM8/chcore.h</b>.

+ * .

+ * @ingroup STM8

+ */

+

+/**

+ * @defgroup MSP430_CORE Core Port Implementation

+ * @brief MSP430 specific port code, structures and macros.

+ *

+ * @ingroup MSP430

+ * @file MSP430/chtypes.h Port types.

+ * @file MSP430/chcore.h Port related structures and macros.

+ * @file MSP430/chcore.c Port related code.

+ */