drivers/mbox: Add mailbox framework and PL320 driver

Author: Jiaqi-YP7

drivers/Kconfig

@@ -16,6 +16,7 @@ source "drivers/i3c/Kconfig"
 source "drivers/spi/Kconfig"
 source "drivers/i2s/Kconfig"
 source "drivers/ipcc/Kconfig"
+source "drivers/mbox/Kconfig"
 source "drivers/timers/Kconfig"
 source "drivers/analog/Kconfig"
 source "drivers/audio/Kconfig"

drivers/Makefile

@@ -42,6 +42,7 @@ include i2c/Make.defs
 include i2s/Make.defs
 include i3c/Make.defs
 include ipcc/Make.defs
+include mbox/Make.defs
 include input/Make.defs
 include ioexpander/Make.defs
 include lcd/Make.defs

drivers/mbox/CMakeLists.txt

@@ -0,0 +1,31 @@
+# ##############################################################################
+# drivers/mbox/CMakeLists.txt
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more contributor
+# license agreements.  See the NOTICE file distributed with this work for
+# additional information regarding copyright ownership.  The ASF licenses this
+# file to you under the Apache License, Version 2.0 (the "License"); you may not
+# use this file except in compliance with the License.  You may obtain a copy of
+# the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations under
+# the License.
+#
+# ##############################################################################
+
+if(CONFIG_MBOX)
+  set(SRCS mbox.c)
+
+  if(CONFIG_MBOX_PL320)
+    list(APPEND SRCS pl320.c)
+  endif()
+
+  target_sources(drivers PRIVATE ${SRCS})
+endif()

drivers/mbox/Kconfig

@@ -0,0 +1,27 @@
+#
+# For a description of the syntax of this configuration file,
+# see the file kconfig-language.txt in the NuttX tools repository.
+#
+
+menuconfig MBOX
+	bool "MBOX Driver Support"
+	default n
+	---help---
+		This selection enables building of the "upper-half" MBOX driver.
+		See include/nuttx/mbox/mbox.h for further MBOX driver information.
+
+if MBOX
+
+config MBOX_TRACE
+	bool "Enable MBOX trace debug"
+	default n
+
+menuconfig MBOX_PL320
+	bool "PL320 Chip support"
+	default n
+	---help---
+		ARM PL320 Inter-Processor Communications Module (IPCM) driver.
+		The PL320 provides up to 32 mailbox channels for inter-core
+		messaging with interrupt-driven notification and acknowledgment.
+
+endif

drivers/mbox/Make.defs

@@ -0,0 +1,38 @@
+############################################################################
+# drivers/mbox/Make.defs
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.  The
+# ASF licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the
+# License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations
+# under the License.
+#
+############################################################################
+
+# Include mailbox drivers
+
+ifeq ($(CONFIG_MBOX),y)
+
+CSRCS += mbox.c
+
+ifeq ($(CONFIG_MBOX_PL320),y)
+CSRCS += pl320.c
+endif
+
+# Include mbox build support
+
+DEPPATH += --dep-path mbox
+VPATH += :mbox
+
+endif  # CONFIG_MBOX