Message Handling Unit for non secure channels (r_mhu_ns)

Functions
fsp_err_t	R_MHU_NS_Open (mhu_ctrl_t *p_ctrl, mhu_cfg_t const *const p_cfg)
fsp_err_t	R_MHU_NS_MsgSend (mhu_ctrl_t *const p_ctrl, uint32_t const msg)
fsp_err_t	R_MHU_NS_Close (mhu_ctrl_t *const p_ctrl)
fsp_err_t	R_MHU_NS_CallbackSet (mhu_ctrl_t *const p_api_ctrl, void(*p_callback)(mhu_callback_args_t *), void const *const p_context, mhu_callback_args_t *const p_callback_memory)
void	R_MHU_NS_IsrSub (uint32_t irq)

Detailed Description

Driver for the MHU peripherals on RZ MPUs. This module implements the MHU Interface (for secure and non secure channels).

Overview

MHU is a function for message communication between Cortex-A55 and Cortex-M33 cores incorporated in RZ/G2L. Message communication is done by shared RAM (On-chip RAM) for passing message and response between CPUs and the function (MHU) for notifying when messages and responses are stored in the memory.

Features

The MHU_NS module supports the following features:

• Generete interrupt to notify Cortex-A55 when the message/response is stored in shared RAM(On-chip RAM).
• Receive interrupt when the message/response is stored by Cortex-A55 in shared RAM(On-chip RAM).

Data Structures
struct	mhu_ns_instance_ctrl_t

---

Data Structure Documentation

mhu_ns_instance_ctrl_t

struct mhu_ns_instance_ctrl_t

Channel control block. DO NOT INITIALIZE. Initialization occurs when mhu_api_t::open is called.

Data Fields
uint32_t	open
	Indicates whether the open() API has been successfully called.
mhu_cfg_t const *	p_cfg
	Pointer to instance configuration.
R_MHU0_Type *	p_regs
	Base register for this channel.
uint32_t	channel
	channel
mhu_send_type_t	send_type
	Send Type: Message or Response.
uint32_t *	p_shared_memory_tx
	Pointer to send data area.
uint32_t *	p_shared_memory_rx
	Pointer to recv data area.

Function Documentation

R_MHU_NS_Open()

fsp_err_t R_MHU_NS_Open	(	mhu_ctrl_t *const	p_ctrl,
		mhu_cfg_t const *const	p_cfg
	)

Initializes the MHU_NS module instance. Implements mhu_api_t::open.

Return values

FSP_SUCCESS	Initialization was successful.
FSP_ERR_ASSERTION	A required input pointer is NULL.
FSP_ERR_ALREADY_OPEN	R_MHU_NS_Open has already been called for this p_ctrl.
FSP_ERR_INVALID_ARGUMENT	The specified IRQ number is invalid.
FSP_ERR_INVALID_CHANNEL	Requested channel number is not available on MHU_NS.

R_MHU_NS_MsgSend()

fsp_err_t R_MHU_NS_MsgSend	(	mhu_ctrl_t *const	p_ctrl,
		uint32_t const	msg
	)

Send message via MHU. Implements mhu_api_t::msgSend.

Return values

FSP_SUCCESS	Send message successfully.
FSP_ERR_ASSERTION	A required pointer was NULL.
FSP_ERR_NOT_OPEN	The instance control structure is not opened.

R_MHU_NS_Close()

fsp_err_t R_MHU_NS_Close

(

mhu_ctrl_t *const

p_ctrl

)

Disables interrupts, clears internal driver data. mhu_api_t::close.

Return values

FSP_SUCCESS	MHU_NS closed.
FSP_ERR_ASSERTION	p_ctrl is NULL.
FSP_ERR_NOT_OPEN	The instance control structure is not opened.

R_MHU_NS_CallbackSet()

fsp_err_t R_MHU_NS_CallbackSet	(	mhu_ctrl_t *const	p_api_ctrl,
		void(*)(mhu_callback_args_t *)	p_callback,
		void const *const	p_context,
		mhu_callback_args_t *const	p_callback_memory
	)

Updates the user callback with the option to provide memory for the callback argument structure. Implements mhu_api_t::callbackSet.

Return values

FSP_SUCCESS	Callback updated successfully.
FSP_ERR_ASSERTION	A required pointer is NULL.
FSP_ERR_NOT_OPEN	The control block has not been opened.
FSP_ERR_NO_CALLBACK_MEMORY	p_callback is non-secure and p_callback_memory is either secure or NULL.

R_MHU_NS_IsrSub()

void R_MHU_NS_IsrSub

(

uint32_t

irq

)

MHU_NS receive interrupt sub function (for OpenAMP)

Parameters

[in]

irq

irq number for inter-core interrupt