esp_ipc_call_nonblocking() function

Execute a callback on a given CPU without any blocking operations for the caller Since it does not have any blocking operations it is suitable to be run from interrupts or even when the Scheduler on the current core is suspended. The function: - does not wait for the callback to begin or complete execution, - does not change the IPC priority. The function returns after sending a notification to the IPC task to execute the callback.

Syntax

Show:

Summary

Declaration

Definition

from esp_ipc.h:41

esp_err_t esp_ipc_call_nonblocking(uint32_t cpu_id, esp_ipc_func_t func, void* arg);

Implemented in esp_ipc.c:178

Arguments

Argument

Description

cpu_id

CPU where the given function should be executed (0 or 1)

func

Pointer to a function of type void func(void* arg) to be executed

arg

Arbitrary argument of type void* to be passed into the function

Return value

- ESP_ERR_INVALID_ARG if cpu_id is invalid - ESP_ERR_INVALID_STATE 1. IPC tasks have not been initialized yet, 2. cpu_id requests IPC on the current core, but the FreeRTOS scheduler is not running on it (the IPC task cannot be executed). - ESP_FAIL IPC is busy due to a previous call was not completed. - ESP_OK otherwise