Boot Linux faster!

Check our new training course

Boot Linux faster!

Check our new training course
and Creative Commons CC-BY-SA
lecture and lab materials

Bootlin logo

Elixir Cross Referencer

 * Copyright (c) 2016 Jean-Paul Etienne <>
 * SPDX-License-Identifier: Apache-2.0

#include <irq.h>
#include <kernel_structs.h>
#include <offsets_short.h>

/* exports */

/* Use ABI name of registers for the sake of simplicity */

 * unsigned int __swap(unsigned int key)
 * Always called with interrupts locked
 * key is stored in a0 register
SECTION_FUNC(exception.other, __swap)

	/* Make a system call to perform context switch */
	addi sp, sp, -__NANO_ESF_SIZEOF

	sw ra, NANO_ESF_ra_OFFSET(__sp)
	sw gp, NANO_ESF_gp_OFFSET(__sp)
	sw tp, NANO_ESF_tp_OFFSET(__sp)
	sw t0, NANO_ESF_t0_OFFSET(__sp)
	sw t1, NANO_ESF_t1_OFFSET(__sp)
	sw t2, NANO_ESF_t2_OFFSET(__sp)
	sw t3, NANO_ESF_t3_OFFSET(__sp)
	sw t4, NANO_ESF_t4_OFFSET(__sp)
	sw t5, NANO_ESF_t5_OFFSET(__sp)
	sw t6, NANO_ESF_t6_OFFSET(__sp)
	sw a0, NANO_ESF_a0_OFFSET(__sp)
	sw a1, NANO_ESF_a1_OFFSET(__sp)
	sw a2, NANO_ESF_a2_OFFSET(__sp)
	sw a3, NANO_ESF_a3_OFFSET(__sp)
	sw a4, NANO_ESF_a4_OFFSET(__sp)
	sw a5, NANO_ESF_a5_OFFSET(__sp)
	sw a6, NANO_ESF_a6_OFFSET(__sp)
	sw a7, NANO_ESF_a7_OFFSET(__sp)

	call read_timer_start_of_swap

	lw ra, NANO_ESF_ra_OFFSET(__sp)
	lw gp, NANO_ESF_gp_OFFSET(__sp)
	lw tp, NANO_ESF_tp_OFFSET(__sp)
	lw t0, NANO_ESF_t0_OFFSET(__sp)
	lw t1, NANO_ESF_t1_OFFSET(__sp)
	lw t2, NANO_ESF_t2_OFFSET(__sp)
	lw t3, NANO_ESF_t3_OFFSET(__sp)
	lw t4, NANO_ESF_t4_OFFSET(__sp)
	lw t5, NANO_ESF_t5_OFFSET(__sp)
	lw t6, NANO_ESF_t6_OFFSET(__sp)
	lw a0, NANO_ESF_a0_OFFSET(__sp)
	lw a1, NANO_ESF_a1_OFFSET(__sp)
	lw a2, NANO_ESF_a2_OFFSET(__sp)
	lw a3, NANO_ESF_a3_OFFSET(__sp)
	lw a4, NANO_ESF_a4_OFFSET(__sp)
	lw a5, NANO_ESF_a5_OFFSET(__sp)
	lw a6, NANO_ESF_a6_OFFSET(__sp)
	lw a7, NANO_ESF_a7_OFFSET(__sp)

	/* Release stack space */
	addi sp, sp, __NANO_ESF_SIZEOF

	 * when thread is rescheduled, unlock irq and return.
	 * Restored register a0 contains IRQ lock state of thread.
	 * Prior to unlocking irq, load return value of
	 * __swap to temp register t2 (from
	 * _thread_offset_to_swap_return_value). Normally, it should be -EAGAIN,
	 * unless someone has previously called z_set_thread_return_value(..).
	la t0, _kernel

	/* Get pointer to _kernel.current */
	lw t1, _kernel_offset_to_current(t0)

	/* Load return value of __swap function in temp register t2 */
	lw t2, _thread_offset_to_swap_return_value(t1)

	 * Unlock irq, following IRQ lock state in a0 register.
	 * Use atomic instruction csrrs to do so.
	andi a0, a0, SOC_MSTATUS_IEN
	csrrs t0, mstatus, a0

	/* Set value of return register a0 to value of register t2 */
	addi a0, t2, 0

	/* Return */
	jalr x0, ra

 * void z_thread_entry_wrapper(k_thread_entry_t, void *, void *, void *)
SECTION_FUNC(TEXT, z_thread_entry_wrapper)
	 * z_thread_entry_wrapper is called for every new thread upon the return
	 * of __swap or ISR. Its address, as well as its input function
	 * arguments thread_entry_t, void *, void *, void * are restored from
	 * the thread stack (initialized via function _thread).
	 * In this case, thread_entry_t, * void *, void * and void * are stored
	 * in registers a0, a1, a2 and a3. These registers are used as arguments
	 * to function z_thread_entry. Hence, just call z_thread_entry with
	 * return address set to 0 to indicate a non-returning function call.

	jal x0, z_thread_entry