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

4 files changed, 606 insertions, 0 deletions

diff --git a/os/ports/cosmic/STM8/chcore.c b/os/ports/cosmic/STM8/chcore.c
new file mode 100644
index 000000000..a9a340d4b
--- /dev/null
+++ b/os/ports/cosmic/STM8/chcore.c
@@ -0,0 +1,70 @@
+/*

+    ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010 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    cosmic/STM8/chcore.c

+ * @brief   STM8 (Cosmic) architecture port code.

+ *

+ * @addtogroup STM8_COSMIC_CORE

+ * @{

+ */

+

+#include "ch.h"

+

+@tiny ReadyList rlist;

+

+/**

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

+ *

+ * @param otp   the thread to be switched out

+ */

+void _port_switch(Thread *otp) {

+

+  _asm("        xref    _rlist          \n"

+       "        ldw     y,sp            \n"

+       "        ldw     (5,x),y         \n"

+       "        ldw     x,_rlist+5      \n"

+       "        ldw     x,(5,x)         \n"

+       "        ldw     sp,x            \n", otp);

+}

+

+/**

+ * @brief   Thread start code.

+ */

+void _port_thread_start(void) {

+

+  _asm("        rim                     \n"

+       "        popw    x               \n");

+}

+

+/**

+ * @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/cosmic/STM8/chcore.h b/os/ports/cosmic/STM8/chcore.h
new file mode 100644
index 000000000..e04341c2e
--- /dev/null
+++ b/os/ports/cosmic/STM8/chcore.h
@@ -0,0 +1,320 @@
+/*

+    ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010 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    cosmic/STM8/chcore.h

+ * @brief   STM8 (Cosmic) architecture port macros and structures.

+ *

+ * @addtogroup STM8_COSMIC_CORE

+ * @{

+ */

+

+#ifndef _CHCORE_H_

+#define _CHCORE_H_

+

+/*===========================================================================*/

+/* Port configurable parameters.                                             */

+/*===========================================================================*/

+

+/**

+ * @brief   Enables the use of the WFI instruction in the idle thread loop.

+ */

+#ifndef STM8_ENABLE_WFI_IDLE

+#define STM8_ENABLE_WFI_IDLE    FALSE

+#endif

+

+/*===========================================================================*/

+/* Port exported info.                                                       */

+/*===========================================================================*/

+

+/**

+ * @brief   Unique macro for the implemented architecture.

+ */

+#define CH_ARCHITECTURE_STM8

+

+/**

+ * @brief   Name of the implemented architecture.

+ */

+#define CH_ARCHITECTURE_NAME    "STM8"

+

+/*===========================================================================*/

+/* Port implementation part.                                                 */

+/*===========================================================================*/

+

+/**

+ * @brief   Base type for stack alignment.

+ * @note    No alignment constraints so uint8_t.

+ */

+typedef uint8_t stkalign_t;

+

+/**

+ * @brief   Generic STM8 function pointer.

+ * @note    It is used to allocate the proper size for return addresses in

+ *          context-related structures.

+ */

+typedef void (*stm8func_t)(void);

+

+#if !defined(__DOXYGEN__)

+/**

+ * @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;

+  uint8_t       c_y[3];

+  uint8_t       c_x[3];

+  uint8_t       cc;

+  uint8_t       a;

+  uint16_t      x;

+  uint16_t      y;

+  uint8_t       pce;

+  uint8_t       pch;

+  uint8_t       pcl;

+};

+#endif

+

+#if !defined(__DOXYGEN__)

+/**

+ * @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;

+  stm8func_t    pc;             /* Function pointer sized return address.   */

+};

+#endif

+

+#if !defined(__DOXYGEN__)

+/**

+ * @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;

+};

+#endif

+

+/**

+ * @brief   Start context.

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

+ *          @p _port_thread_start().

+ */

+struct stm8_startctx {

+  uint8_t       _next;

+  stm8func_t    ts;             /* Trampoline address.                      */

+  void          *arg;           /* Thread argument.                         */

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

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

+};

+

+/**

+ * @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 stm8_startctx *scp;                                                \

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

+                                 sizeof(struct stm8_startctx));             \

+  scp->ts   = _port_thread_start;                                           \

+  scp->arg  = arg;                                                          \

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

+  scp->ret  = (stm8func_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 is a safe value, you may trim it down after reading the

+ *          right size in the map file.

+ */

+#ifndef INT_REQUIRED_STACK

+#define INT_REQUIRED_STACK          48

+#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) @far @interrupt void vector##id(void)

+

+/**

+ * @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() _asm("sim")

+

+/**

+ * @brief   Kernel-unlock action.

+ * @note    Implemented as global interrupts enable.

+ */

+#define port_unlock() _asm("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() _asm("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() _asm("sim")

+

+/**

+ * @brief   Enables all the interrupt sources.

+ * @note    Implemented as global interrupt enable.

+ */

+#define port_enable() _asm("rim")

+

+/**

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

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

+ */

+#if STM8_ENABLE_WFI_IDLE || defined(__DOXYGEN__)

+#define port_wait_for_interrupt() _asm("wfi")

+#else

+#define port_wait_for_interrupt()

+#endif

+

+/**

+ * @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 ntp   the thread to be switched in

+ * @param otp   the thread to be switched out

+ */

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

+

+#ifdef __cplusplus

+extern "C" {

+#endif

+  void _port_switch(Thread *otp);

+  void _port_thread_start(void);

+  void port_halt(void);

+#ifdef __cplusplus

+}

+#endif

+

+/*===========================================================================*/

+/* Scheduler captured code.                                                  */

+/*===========================================================================*/

+

+#define PORT_OPTIMIZED_RLIST_VAR

+#define PORT_OPTIMIZED_RLIST_EXT

+#define PORT_OPTIMIZED_READYLIST_STRUCT

+

+typedef struct {

+  ThreadsQueue          r_queue;

+  tprio_t               r_prio;

+  Thread                *r_current;

+#if CH_USE_REGISTRY

+  Thread                *r_newer;

+  Thread                *r_older;

+#endif

+  /* End of the fields shared with the Thread structure.*/

+#if CH_TIME_QUANTUM > 0

+  cnt_t                 r_preempt;

+#endif

+} ReadyList;

+

+@tiny extern ReadyList rlist;

+

+#endif /* _CHCORE_H_ */

+

+/** @} */

diff --git a/os/ports/cosmic/STM8/chtypes.h b/os/ports/cosmic/STM8/chtypes.h
new file mode 100644
index 000000000..3fe35570d
--- /dev/null
+++ b/os/ports/cosmic/STM8/chtypes.h
@@ -0,0 +1,130 @@
+/*

+    ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010 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    cosmic/STM8/chtypes.h

+ * @brief   STM8 (Cosmic) port system types.

+ *

+ * @addtogroup STM8_COSMIC_CORE

+ * @{

+ */

+

+#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;        /**< C99-style 8 bits unsigned.     */

+typedef signed char     int8_t;         /**< C99-style 8 bits signed.       */

+typedef unsigned int    uint16_t;       /**< C99-style 16 bits unsigned.    */

+typedef signed int      int16_t;        /**< C99-style 16 bits signed.      */

+typedef unsigned long   uint32_t;       /**< C99-style 32 bits unsigned.    */

+typedef signed long     int32_t;        /**< C99-style 32 bits signed.      */

+typedef uint8_t         uint_fast8_t;   /**< C99-style 8 bits unsigned.     */

+typedef uint16_t        uint_fast16_t;  /**< C99-style 16 bits unsigned.    */

+typedef uint32_t        uint_fast32_t;  /**< C99-style 32 bits unsigned.    */

+

+/**

+ * @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 int8_t          cnt_t;

+

+/**

+ * @brief   Inline function modifier.

+ */

+#define INLINE @inline

+

+/**

+ * @brief   ROM constant modifier.

+ * @note    Uses the "const" keyword in this port.

+ */

+#define ROMCONST const

+

+/**

+ * @brief   Packed structure modifier (within).

+ * @note    Empty in this port.

+ */

+#define PACK_STRUCT_STRUCT

+

+/**

+ * @brief   Packed structure modifier (before).

+ * @note    Empty in this port.

+ */

+#define PACK_STRUCT_BEGIN

+

+/**

+ * @brief   Packed structure modifier (after).

+ * @note    Empty in this port.

+ */

+#define PACK_STRUCT_END

+

+#endif /* _CHTYPES_H_ */

+

+/** @} */

diff --git a/os/ports/cosmic/STM8/port.dox b/os/ports/cosmic/STM8/port.dox
new file mode 100644
index 000000000..3fa2cdb39
--- /dev/null
+++ b/os/ports/cosmic/STM8/port.dox
@@ -0,0 +1,86 @@
+/*

+    ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010 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_COSMIC STM8

+ * @details STM8 port for the Cosmic C compiler.

+ *

+ * @section STM8_COSMIC_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_COSMIC_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>.

+ * - The kernel currently supports only the small memory model so the

+ *   kernel files should be loaded in the first 64K. Note that this is not

+ *   a problem because upper addresses can be used by the user code, the

+ *   kernel can context switch code running there.

+ * - The configuration option @p CH_OPTIMIZE_SPEED is not currently supported

+ *   because the missing support of the @p inline "C" keyword in the

+ *   compiler.

+ * .

+ * @ingroup cosmic

+ */

+

+/**

+ * @defgroup STM8_COSMIC_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/cosmic/STM8/chcore.h</b>.

+ * .

+ * @ingroup STM8_COSMIC

+ */

+

+/**

+ * @defgroup STM8_COSMIC_CORE Core Port Implementation

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

+ *

+ * @ingroup STM8_COSMIC

+ * @file cosmic/STM8/chtypes.h Port types.

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

+ * @file cosmic/STM8/chcore.c Port related code.

+ */