ELEC2645 (2018/19) / Mbed 2 deprecated el17dg

Initial publish

Dependencies:   mbed

Fork of el17dg by Dmitrijs Griskovs

mbed-rtos/rtx/TARGET_ARM7/HAL_CM.c@40:e3bbda7444fa, 2019-05-07 (annotated)

Committer:
Noximilien
Date:
Tue May 07 15:22:35 2019 +0000
Revision:
40:e3bbda7444fa
Parent:
1:5aa2312d3e94 
The Final, Submission Version. I have read and agreed to the academic integrity. SID:201160286

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Noximilien 1:5aa2312d3e94 1 /*----------------------------------------------------------------------------
Noximilien 1:5aa2312d3e94 2 * RL-ARM - RTX
Noximilien 1:5aa2312d3e94 3 *----------------------------------------------------------------------------
Noximilien 1:5aa2312d3e94 4 * Name: HAL_CM.C
Noximilien 1:5aa2312d3e94 5 * Purpose: Hardware Abstraction Layer for ARM7TDMI
Noximilien 1:5aa2312d3e94 6 * Rev.: V1.0
Noximilien 1:5aa2312d3e94 7 *----------------------------------------------------------------------------
Noximilien 1:5aa2312d3e94 8 *
Noximilien 1:5aa2312d3e94 9 * Copyright (c) 1999-2009 KEIL, 2009-2015 ARM Germany GmbH
Noximilien 1:5aa2312d3e94 10 * All rights reserved.
Noximilien 1:5aa2312d3e94 11 * Redistribution and use in source and binary forms, with or without
Noximilien 1:5aa2312d3e94 12 * modification, are permitted provided that the following conditions are met:
Noximilien 1:5aa2312d3e94 13 * - Redistributions of source code must retain the above copyright
Noximilien 1:5aa2312d3e94 14 * notice, this list of conditions and the following disclaimer.
Noximilien 1:5aa2312d3e94 15 * - Redistributions in binary form must reproduce the above copyright
Noximilien 1:5aa2312d3e94 16 * notice, this list of conditions and the following disclaimer in the
Noximilien 1:5aa2312d3e94 17 * documentation and/or other materials provided with the distribution.
Noximilien 1:5aa2312d3e94 18 * - Neither the name of ARM nor the names of its contributors may be used
Noximilien 1:5aa2312d3e94 19 * to endorse or promote products derived from this software without
Noximilien 1:5aa2312d3e94 20 * specific prior written permission.
Noximilien 1:5aa2312d3e94 21 *
Noximilien 1:5aa2312d3e94 22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
Noximilien 1:5aa2312d3e94 23 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
Noximilien 1:5aa2312d3e94 24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
Noximilien 1:5aa2312d3e94 25 * ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE
Noximilien 1:5aa2312d3e94 26 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
Noximilien 1:5aa2312d3e94 27 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
Noximilien 1:5aa2312d3e94 28 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
Noximilien 1:5aa2312d3e94 29 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
Noximilien 1:5aa2312d3e94 30 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
Noximilien 1:5aa2312d3e94 31 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
Noximilien 1:5aa2312d3e94 32 * POSSIBILITY OF SUCH DAMAGE.
Noximilien 1:5aa2312d3e94 33 *---------------------------------------------------------------------------*/
Noximilien 1:5aa2312d3e94 34
Noximilien 1:5aa2312d3e94 35 #include "rt_TypeDef.h"
Noximilien 1:5aa2312d3e94 36 #include "RTX_Conf.h"
Noximilien 1:5aa2312d3e94 37 #include "rt_HAL_CM.h"
Noximilien 1:5aa2312d3e94 38
Noximilien 1:5aa2312d3e94 39
Noximilien 1:5aa2312d3e94 40 /*----------------------------------------------------------------------------
Noximilien 1:5aa2312d3e94 41 * Global Variables
Noximilien 1:5aa2312d3e94 42 *---------------------------------------------------------------------------*/
Noximilien 1:5aa2312d3e94 43
Noximilien 1:5aa2312d3e94 44 #ifdef DBG_MSG
Noximilien 1:5aa2312d3e94 45 BIT dbg_msg;
Noximilien 1:5aa2312d3e94 46 #endif
Noximilien 1:5aa2312d3e94 47
Noximilien 1:5aa2312d3e94 48 /*----------------------------------------------------------------------------
Noximilien 1:5aa2312d3e94 49 * Functions
Noximilien 1:5aa2312d3e94 50 *---------------------------------------------------------------------------*/
Noximilien 1:5aa2312d3e94 51
Noximilien 1:5aa2312d3e94 52
Noximilien 1:5aa2312d3e94 53 /*--------------------------- rt_init_stack ---------------------------------*/
Noximilien 1:5aa2312d3e94 54
Noximilien 1:5aa2312d3e94 55 void rt_init_stack (P_TCB p_TCB, FUNCP task_body) {
Noximilien 1:5aa2312d3e94 56 /* Prepare TCB and saved context for a first time start of a task. */
Noximilien 1:5aa2312d3e94 57 U32 *stk,i,size;
Noximilien 1:5aa2312d3e94 58
Noximilien 1:5aa2312d3e94 59 /* Prepare a complete interrupt frame for first task start */
Noximilien 1:5aa2312d3e94 60 size = p_TCB->priv_stack >> 2;
Noximilien 1:5aa2312d3e94 61
Noximilien 1:5aa2312d3e94 62 /* Write to the top of stack. */
Noximilien 1:5aa2312d3e94 63 stk = &p_TCB->stack[size];
Noximilien 1:5aa2312d3e94 64
Noximilien 1:5aa2312d3e94 65 /* Auto correct to 8-byte ARM stack alignment. */
Noximilien 1:5aa2312d3e94 66 if ((U32)stk & 0x04) {
Noximilien 1:5aa2312d3e94 67 stk--;
Noximilien 1:5aa2312d3e94 68 }
Noximilien 1:5aa2312d3e94 69
Noximilien 1:5aa2312d3e94 70 stk -= 16;
Noximilien 1:5aa2312d3e94 71
Noximilien 1:5aa2312d3e94 72 /* Default xPSR and initial PC */
Noximilien 1:5aa2312d3e94 73 stk[15] = (U32)task_body + 4; /* add 4 byte offset because SUB PC, LR - 4 */
Noximilien 1:5aa2312d3e94 74 stk[0] = INITIAL_xPSR;
Noximilien 1:5aa2312d3e94 75
Noximilien 1:5aa2312d3e94 76 /* Clear R0-R13/LR registers. */
Noximilien 1:5aa2312d3e94 77 for (i = 1; i < 14; i++) {
Noximilien 1:5aa2312d3e94 78 stk[i] = 0;
Noximilien 1:5aa2312d3e94 79 }
Noximilien 1:5aa2312d3e94 80
Noximilien 1:5aa2312d3e94 81 /* Assign a void pointer to R0. */
Noximilien 1:5aa2312d3e94 82 stk[TCB_STACK_R0_OFFSET_DWORDS] = (U32)p_TCB->msg;
Noximilien 1:5aa2312d3e94 83
Noximilien 1:5aa2312d3e94 84 /* Initial Task stack pointer. */
Noximilien 1:5aa2312d3e94 85 p_TCB->tsk_stack = (U32)stk;
Noximilien 1:5aa2312d3e94 86
Noximilien 1:5aa2312d3e94 87 /* Task entry point. */
Noximilien 1:5aa2312d3e94 88 p_TCB->ptask = task_body;
Noximilien 1:5aa2312d3e94 89
Noximilien 1:5aa2312d3e94 90 /* Set a magic word for checking of stack overflow.
Noximilien 1:5aa2312d3e94 91 For the main thread (ID: 0x01) the stack is in a memory area shared with the
Noximilien 1:5aa2312d3e94 92 heap, therefore the last word of the stack is a moving target.
Noximilien 1:5aa2312d3e94 93 We want to do stack/heap collision detection instead.
Noximilien 1:5aa2312d3e94 94 */
Noximilien 1:5aa2312d3e94 95 if (p_TCB->task_id != 0x01)
Noximilien 1:5aa2312d3e94 96 p_TCB->stack[0] = MAGIC_WORD;
Noximilien 1:5aa2312d3e94 97 }
Noximilien 1:5aa2312d3e94 98
Noximilien 1:5aa2312d3e94 99
Noximilien 1:5aa2312d3e94 100 /*--------------------------- rt_ret_val ----------------------------------*/
Noximilien 1:5aa2312d3e94 101
Noximilien 1:5aa2312d3e94 102 static __inline U32 *rt_ret_regs (P_TCB p_TCB) {
Noximilien 1:5aa2312d3e94 103 /* Get pointer to task return value registers (R0..R3) in Stack */
Noximilien 1:5aa2312d3e94 104
Noximilien 1:5aa2312d3e94 105 /* Stack Frame: CPSR,R0-R13,PC */
Noximilien 1:5aa2312d3e94 106 return (U32 *)(p_TCB->tsk_stack + TCB_STACK_R0_OFFSET_BYTES);
Noximilien 1:5aa2312d3e94 107 }
Noximilien 1:5aa2312d3e94 108
Noximilien 1:5aa2312d3e94 109 void rt_ret_val (P_TCB p_TCB, U32 v0) {
Noximilien 1:5aa2312d3e94 110 U32 *ret;
Noximilien 1:5aa2312d3e94 111
Noximilien 1:5aa2312d3e94 112 ret = rt_ret_regs(p_TCB);
Noximilien 1:5aa2312d3e94 113 ret[0] = v0;
Noximilien 1:5aa2312d3e94 114 }
Noximilien 1:5aa2312d3e94 115
Noximilien 1:5aa2312d3e94 116 void rt_ret_val2(P_TCB p_TCB, U32 v0, U32 v1) {
Noximilien 1:5aa2312d3e94 117 U32 *ret;
Noximilien 1:5aa2312d3e94 118
Noximilien 1:5aa2312d3e94 119 ret = rt_ret_regs(p_TCB);
Noximilien 1:5aa2312d3e94 120 ret[0] = v0;
Noximilien 1:5aa2312d3e94 121 ret[1] = v1;
Noximilien 1:5aa2312d3e94 122 }
Noximilien 1:5aa2312d3e94 123
Noximilien 1:5aa2312d3e94 124
Noximilien 1:5aa2312d3e94 125 /*--------------------------- dbg_init --------------------------------------*/
Noximilien 1:5aa2312d3e94 126
Noximilien 1:5aa2312d3e94 127 #ifdef DBG_MSG
Noximilien 1:5aa2312d3e94 128 void dbg_init (void) {
Noximilien 1:5aa2312d3e94 129 if ((DEMCR & DEMCR_TRCENA) &&
Noximilien 1:5aa2312d3e94 130 (ITM_CONTROL & ITM_ITMENA) &&
Noximilien 1:5aa2312d3e94 131 (ITM_ENABLE & (1UL << 31))) {
Noximilien 1:5aa2312d3e94 132 dbg_msg = __TRUE;
Noximilien 1:5aa2312d3e94 133 }
Noximilien 1:5aa2312d3e94 134 }
Noximilien 1:5aa2312d3e94 135 #endif
Noximilien 1:5aa2312d3e94 136
Noximilien 1:5aa2312d3e94 137 /*--------------------------- dbg_task_notify -------------------------------*/
Noximilien 1:5aa2312d3e94 138
Noximilien 1:5aa2312d3e94 139 #ifdef DBG_MSG
Noximilien 1:5aa2312d3e94 140 void dbg_task_notify (P_TCB p_tcb, BOOL create) {
Noximilien 1:5aa2312d3e94 141 while (ITM_PORT31_U32 == 0);
Noximilien 1:5aa2312d3e94 142 ITM_PORT31_U32 = (U32)p_tcb->ptask;
Noximilien 1:5aa2312d3e94 143 while (ITM_PORT31_U32 == 0);
Noximilien 1:5aa2312d3e94 144 ITM_PORT31_U16 = (create << 8) | p_tcb->task_id;
Noximilien 1:5aa2312d3e94 145 }
Noximilien 1:5aa2312d3e94 146 #endif
Noximilien 1:5aa2312d3e94 147
Noximilien 1:5aa2312d3e94 148 /*--------------------------- dbg_task_switch -------------------------------*/
Noximilien 1:5aa2312d3e94 149
Noximilien 1:5aa2312d3e94 150 #ifdef DBG_MSG
Noximilien 1:5aa2312d3e94 151 void dbg_task_switch (U32 task_id) {
Noximilien 1:5aa2312d3e94 152 while (ITM_PORT31_U32 == 0);
Noximilien 1:5aa2312d3e94 153 ITM_PORT31_U8 = task_id;
Noximilien 1:5aa2312d3e94 154 }
Noximilien 1:5aa2312d3e94 155 #endif
Noximilien 1:5aa2312d3e94 156
Noximilien 1:5aa2312d3e94 157
Noximilien 1:5aa2312d3e94 158 /*----------------------------------------------------------------------------
Noximilien 1:5aa2312d3e94 159 * end of file
Noximilien 1:5aa2312d3e94 160 *---------------------------------------------------------------------------*/
Noximilien 1:5aa2312d3e94 161