1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
RIOT/cpu/riscv_common/include/context_frame.h
2021-08-13 19:50:38 +02:00

131 lines
3.7 KiB
C

/*
* Copyright (C) 2017, 2019 JP Bonn, Ken Rabold
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup cpu_riscv_common
* @{
*
* @file
* @brief Thread context frame stored on stack.
*
* @author JP Bonn
*/
#ifndef CONTEXT_FRAME_H
#define CONTEXT_FRAME_H
#if !defined(__ASSEMBLER__)
#include <stdint.h>
#endif /* __ASSEMBLER__ */
#ifdef __cplusplus
extern "C" {
#endif
#if !defined(__ASSEMBLER__)
/**
* @brief Stores the registers and PC for a context switch.
*
* This also defines context_switch_frame offsets for assembly language. The
* structure is sized to maintain 16 byte stack alignment per the ABI.
* https://github.com/riscv/riscv-elf-psabi-doc
*
*/
struct context_switch_frame {
/* Callee saved registers */
uint32_t s0; /**< s0 register */
uint32_t s1; /**< s1 register */
uint32_t s2; /**< s2 register */
uint32_t s3; /**< s3 register */
uint32_t s4; /**< s4 register */
uint32_t s5; /**< s5 register */
uint32_t s6; /**< s6 register */
uint32_t s7; /**< s7 register */
uint32_t s8; /**< s8 register */
uint32_t s9; /**< s9 register */
uint32_t s10; /**< s10 register */
uint32_t s11; /**< s11 register */
/* Caller saved registers */
uint32_t ra; /**< ra register */
uint32_t t0; /**< t0 register */
uint32_t t1; /**< t1 register */
uint32_t t2; /**< t2 register */
uint32_t t3; /**< t3 register */
uint32_t t4; /**< t4 register */
uint32_t t5; /**< t5 register */
uint32_t t6; /**< t6 register */
uint32_t a0; /**< a0 register */
uint32_t a1; /**< a1 register */
uint32_t a2; /**< a2 register */
uint32_t a3; /**< a3 register */
uint32_t a4; /**< a4 register */
uint32_t a5; /**< a5 register */
uint32_t a6; /**< a6 register */
uint32_t a7; /**< a7 register */
/* Saved PC for return from ISR */
uint32_t pc; /**< program counter */
uint32_t pad[3]; /**< padding to maintain 16 byte alignment */
};
#endif /* __ASSEMBLER__ */
/**
* @name Register offsets
* @{
*/
/* These values are checked for correctness in context_frame.c */
#define s0_OFFSET 0
#define s1_OFFSET 4
#define s2_OFFSET 8
#define s3_OFFSET 12
#define s4_OFFSET 16
#define s5_OFFSET 20
#define s6_OFFSET 24
#define s7_OFFSET 28
#define s8_OFFSET 32
#define s9_OFFSET 36
#define s10_OFFSET 40
#define s11_OFFSET 44
#define ra_OFFSET 48
#define t0_OFFSET 52
#define t1_OFFSET 56
#define t2_OFFSET 60
#define t3_OFFSET 64
#define t4_OFFSET 68
#define t5_OFFSET 72
#define t6_OFFSET 76
#define a0_OFFSET 80
#define a1_OFFSET 84
#define a2_OFFSET 88
#define a3_OFFSET 92
#define a4_OFFSET 96
#define a5_OFFSET 100
#define a6_OFFSET 104
#define a7_OFFSET 108
#define pc_OFFSET 112
#define pad_OFFSET 116
/** @} */
/**
* @brief Size of context switch frame
*/
#define CONTEXT_FRAME_SIZE (pad_OFFSET + 12)
/**
* @brief Offset of stack pointer in struct _thread
*/
#define SP_OFFSET_IN_THREAD 0
#ifdef __cplusplus
}
#endif
#endif /* CONTEXT_FRAME_H */
/** @} */