[DM/FEATURE] Support hardware mailbox

Communication in AMP.

Signed-off-by: GuEe-GUI <[email protected]>

Author: GuEe-GUI

components/drivers/Kconfig

@@ -21,6 +21,7 @@ rsource "touch/Kconfig"
 rsource "graphic/Kconfig"
 rsource "hwcrypto/Kconfig"
 rsource "wlan/Kconfig"
+rsource "mailbox/Kconfig"
 rsource "virtio/Kconfig"
 rsource "ofw/Kconfig"
 rsource "pci/Kconfig"

components/drivers/include/drivers/mailbox.h

@@ -0,0 +1,77 @@
+/*
+ * Copyright (c) 2006-2023, RT-Thread Development Team
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Change Logs:
+ * Date           Author       Notes
+ * 2023-09-23     GuEe-GUI     first version
+ */
+
+#ifndef __MAILBOX_H__
+#define __MAILBOX_H__
+
+#include <rtdef.h>
+#include <drivers/ofw.h>
+
+struct rt_mbox_chan;
+struct rt_mbox_client;
+struct rt_mbox_controller_ops;
+
+struct rt_mbox_controller
+{
+    rt_list_t list;
+
+    struct rt_device *dev;
+
+    const struct rt_mbox_controller_ops *ops;
+
+    rt_size_t num_chans;
+    struct rt_mbox_chan *chans;
+};
+
+struct rt_mbox_controller_ops
+{
+    rt_err_t (*request)(struct rt_mbox_chan *);
+    void (*release)(struct rt_mbox_chan *);
+    rt_err_t (*send)(struct rt_mbox_chan *, const void *data);
+    rt_bool_t (*peek)(struct rt_mbox_chan *);
+    int (*ofw_parse)(struct rt_mbox_controller *, struct rt_ofw_cell_args *);
+};
+
+struct rt_mbox_chan
+{
+    struct rt_mbox_controller *ctrl;
+    struct rt_mbox_client *client;
+
+    void *data;
+    rt_bool_t complete;
+    struct rt_timer timer;
+    struct rt_spinlock lock;
+
+    void *priv;
+};
+
+struct rt_mbox_client
+{
+    struct rt_device *dev;
+
+    void (*rx_callback)(struct rt_mbox_client *, void *data);
+    void (*tx_prepare)(struct rt_mbox_client *, const void *data);
+    void (*tx_done)(struct rt_mbox_client *, const void *data, rt_err_t err);
+};
+
+rt_err_t rt_mbox_controller_register(struct rt_mbox_controller *ctrl);
+rt_err_t rt_mbox_controller_unregister(struct rt_mbox_controller *ctrl);
+
+rt_err_t rt_mbox_send(struct rt_mbox_chan *chan, const void *data,
+        rt_uint32_t timeout_ms);
+void rt_mbox_send_done(struct rt_mbox_chan *chan, rt_err_t err);
+rt_bool_t rt_mbox_peek(struct rt_mbox_chan *chan);
+rt_err_t rt_mbox_recv(struct rt_mbox_chan *chan, void *data);
+
+struct rt_mbox_chan *rt_mbox_request_by_index(struct rt_mbox_client *client, int index);
+struct rt_mbox_chan *rt_mbox_request_by_name(struct rt_mbox_client *client, char *name);
+rt_err_t rt_mbox_release(struct rt_mbox_chan *chan);
+
+#endif /* __MAILBOX_H__ */

components/drivers/include/rtdevice.h

@@ -45,6 +45,10 @@ extern "C" {
 #include "drivers/core/power_domain.h"
 #include "drivers/platform.h"
 
+#ifdef RT_USING_MBOX
+#include "drivers/mailbox.h"
+#endif
+
 #ifdef RT_USING_OFW
 #include "drivers/ofw.h"
 #include "drivers/ofw_fdt.h"

components/drivers/mailbox/Kconfig

@@ -0,0 +1,10 @@
+menuconfig RT_USING_MBOX
+    bool "Using Hardware Mailbox device drivers"
+    depends on RT_USING_DM
+    depends on RT_USING_OFW
+    default n
+
+if RT_USING_MBOX && SOC_DM_MBOX
+comment "SoC Device Drivers"
+source "$(SOC_DM_DIR)/mailbox/Kconfig"
+endif

components/drivers/mailbox/SConscript

@@ -0,0 +1,15 @@
+from building import *
+
+group = []
+
+if not GetDepend(['RT_USING_MBOX']):
+    Return('group')
+
+cwd = GetCurrentDir()
+CPPPATH = [cwd + '/../include']
+
+src = ['mailbox.c']
+
+group = DefineGroup('DeviceDrivers', src, depend = [''], CPPPATH = CPPPATH)
+
+Return('group')