nrf_semmc_init()

nrf_semmc_error_t nrf_semmc_init	(	nrf_semmc_t const *	p_semmc,
		nrf_semmc_event_handler_t	handler,
		void *	p_context )

#include <nrf_semmc.h>

Initialize the eMMC controller driver for a given instance.

The data buffer pointed by p_semmc is managed by the API user. It must be valid as long as the device driver is initialized and used. After the device driver finishes all its operations and the controller is disabled, the buffer can be freed.

Note

The GPIO pins required for eMMC operation must be properly configured by the API user before calling this function.

Parameters

[out]	p_semmc	Pointer to the eMMC driver instance to initialize.
[in]	handler	Event handler callback function.
[in]	p_context	User context passed to the event handler.

Return values

NRF_SEMMC_SUCCESS	Initialization successful.
NRF_SEMMC_ERROR_INVALID_PARAM	Invalid or NULL parameter provided.
NRF_SEMMC_ERROR_HW_FAULT	Hardware initialization failed.
NRF_SEMMC_ERROR_INTERNAL	Internal error during initialization.

Note

Initialization restores the default DPPI task/role map and clears every subscription permission: the soft peripheral applies the reset value of its SPSYNC.DPPIMAP register while starting, and this driver resets the matching host-side state. Anything published with nrf_semmc_dppi_role_map_set or nrf_semmc_dppi_subscribe_enable therefore does not survive an uninit/init cycle and has to be published again afterwards, before the first request. Nothing has to be undone before uninit.