SK-AM62B-P1: Where exactly is the "callback function" in this example?

Shreyan Jain

Part Number: SK-AM62B-P1

I'm trying to enable graceful shutdown using this:
https://software-dl.ti.com/mcu-plus-sdk/esd/AM62X/09_02_00_38/exports/docs/api_guide_am62x/GRACEFUL_REMOTECORE_SHUTDOWN.html

Where exactly are these,in the mcu sdk directory:

On the callback unblock the RPMessage for all the RPMsg objects used in the code.

volatile uint8_t gbShutdown = 0u;

volatile uint8_t gbShutdownRemotecoreID = 0u;

void ipc_rp_mbox_callback(uint16_t remoteCoreId, uint16_t clientId, uint32_t msgValue, void *args)

{

if (clientId == IPC_NOTIFY_CLIENT_ID_RP_MBOX)

{

if (msgValue == IPC_NOTIFY_RP_MBOX_SHUTDOWN) /* Shutdown request from the remotecore */

{

gbShutdown = 1u;

gbShutdownRemotecoreID = remoteCoreId;

RPMessage_unblock(&gIpcRecvMsgObject[0]);

RPMessage_unblock(&gIpcRecvMsgObject[1]);

}

}

}
On the main thread where the IPC is happening, break all the loops when gbShutdown == 1

/* wait for messages forever in a loop */
while(1)
{
/* set 'recvMsgSize' to size of recv buffer,
 * after return `recvMsgSize` contains actual size of valid data in recv buffer
 */
recvMsgSize = IPC_RPMESSAGE_MAX_MSG_SIZE;
status = RPMessage_recv(pRpmsgObj,
recvMsg, &recvMsgSize,
&remoteCoreId, &remoteCoreEndPt,
SystemP_WAIT_FOREVER);
if (gbShutdown == 1u)
{
break;
}
DebugP_assert(status==SystemP_SUCCESS);
/* send ack to sender CPU at the sender end point */
status = RPMessage_send(
recvMsg, recvMsgSize,
remoteCoreId, remoteCoreEndPt,
RPMessage_getLocalEndPt(pRpmsgObj),
SystemP_WAIT_FOREVER);
DebugP_assert(status==SystemP_SUCCESS);
}

Then follow the below sequence to go to WFI
- Close all the dirvers used
- Send acknowledgement to Linux core that the core is ready for shutdown
- Deinit system (It will disable the interrupts and stops the tick timer)
- Go to WFI / IDLE

/* Close the drivers */
Drivers_close();
/* ACK the suspend message */
IpcNotify_sendMsg(gbShutdownRemotecoreID, IPC_NOTIFY_CLIENT_ID_RP_MBOX, IPC_NOTIFY_RP_MBOX_SHUTDOWN_ACK, 1u);
/* Deinit System */
System_deinit();
/* For ARM R and M cores*/
__asm__ __volatile__ ("wfi" "\n\t": : : "memory");

This is implemented on IPC RP Message Linux Echo

over 2 years ago

0 Nick Saulnier over 2 years ago

TI__Guru** 109910 points

Hello Shreyan,

I might be misunderstanding your question.

The IPC RPMsg Linux Echo example is exactly where the MCU+ SDK documentation says it is:
https://software-dl.ti.com/mcu-plus-sdk/esd/AM62X/09_02_00_38/exports/docs/api_guide_am62x/EXAMPLES_DRIVERS_IPC_RPMESSAGE_LINUX_ECHO.html
examples/drivers/ipc/ipc_rpmsg_echo_linux

You can use a search function to find the exact file that has the code. For example, on Linux, or with git bash on Windows:

mcu_plus_sdk_am62x_09_02_00_38/examples/drivers/ipc/ipc_rpmsg_echo_linux$ grep -r gbShutdownRemotecoreID
ipc_rpmsg_echo.c:volatile uint8_t gbShutdownRemotecoreID = 0u;
ipc_rpmsg_echo.c:        IpcNotify_sendMsg(gbShutdownRemotecoreID, IPC_NOTIFY_CLIENT_ID_RP_MBOX, IPC_NOTIFY_RP_MBOX_SHUTDOWN_ACK, 1u);
ipc_rpmsg_echo.c:            gbShutdownRemotecoreID = remoteCoreId;

Regards,

Nick

Processors

Processors forum

SK-AM62B-P1: Where exactly is the "callback function" in this example?