ipc_service: Add ipc_rpmsg_deinit function

This function does the opposite of the ipc_rpmsg_init function and
allows the rpmsg instance to be torndown in the case that the application
wishes to do so. It is intended to be used by the ipc_service subsystem.

Signed-off-by: Jackson Cooper-Driver <[email protected]>

Author: jacksonc-xlnx

include/zephyr/ipc/ipc_rpmsg.h

@@ -113,6 +113,20 @@ int ipc_rpmsg_init(struct ipc_rpmsg_instance *instance,
 		   void *shb, size_t size,
 		   rpmsg_ns_bind_cb ns_bind_cb);
 
+
+/** @brief
+ *
+ * Deinit an RPMsg instance
+ *
+ * @param instance Pointer to the RPMsg instance struct.
+ * @param role Host / Remote role.
+ *
+ * @retval -EINVAL When some parameter is missing
+ * @retval 0 If successful
+ */
+int ipc_rpmsg_deinit(struct ipc_rpmsg_instance *instance,
+		   unsigned int role);
+
 /** @brief Register an endpoint.
  *
  *  Register an endpoint to a provided RPMsg instance.

subsys/ipc/ipc_service/lib/ipc_rpmsg.c

@@ -102,3 +102,19 @@ int ipc_rpmsg_init(struct ipc_rpmsg_instance *instance,
 		return rpmsg_init_vdev(&instance->rvdev, vdev, bind_cb, shm_io, NULL);
 	}
 }
+
+int ipc_rpmsg_deinit(struct ipc_rpmsg_instance *instance,
+		   unsigned int role)
+{
+	if (!instance) {
+		return -EINVAL;
+	}
+
+	rpmsg_deinit_vdev(&instance->rvdev);
+
+	if (role == RPMSG_HOST) {
+		memset(&instance->shm_pool, 0, sizeof(struct rpmsg_virtio_shm_pool));
+	}
+
+	return 0;
+}