Establish Base Support For Sending Mailbox Messages Across XBUS/ABUS

This commit establishes base support for Secure Node Communications.
It creates a new device driver to operate the XBUS and ABUS Link
Mailboxes and adds base support for using these device drivers to
send and receive messages.  It also adds a test to perform a 2-chip
XBUS Link Mailbox operation.

Change-Id: I19510888c0922e5bb857cffc9426399e79e113ba
RTC:191008
Reviewed-on: http://ralgit01.raleigh.ibm.com/gerrit1/58376
Reviewed-by: Nicholas E. Bofferding <bofferdn@us.ibm.com>
Reviewed-by: ILYA SMIRNOV <ismirno@us.ibm.com>
Reviewed-by: Marshall J. Wilks <mjwilks@us.ibm.com>
Tested-by: Jenkins Server <pfd-jenkins+hostboot@us.ibm.com>
Tested-by: Jenkins OP Build CI <op-jenkins+hostboot@us.ibm.com>
Tested-by: Jenkins OP HW <op-hw-jenkins+hostboot@us.ibm.com>
Tested-by: FSP CI Jenkins <fsp-CI-jenkins+hostboot@us.ibm.com>
Reviewed-by: William G. Hoffa <wghoffa@us.ibm.com>

1 files changed, 22 insertions, 1 deletions

diff --git a/src/include/usr/devicefw/userif.H b/src/include/usr/devicefw/userif.H
index 286deabb1..4df37c8a8 100644
--- a/src/include/usr/devicefw/userif.H
+++ b/src/include/usr/devicefw/userif.H
@@ -5,7 +5,7 @@
 /*                                                                        */
 /* OpenPOWER HostBoot Project                                             */
 /*                                                                        */
-/* Contributors Listed Below - COPYRIGHT 2011,2017                        */
+/* Contributors Listed Below - COPYRIGHT 2011,2018                        */
 /* [+] Google Inc.                                                        */
 /* [+] International Business Machines Corp.                              */
 /*                                                                        */
@@ -68,6 +68,7 @@ namespace DeviceFW
         AHB_SIO,
         DVPD,      // Direct access memory VPD
         MEMD_VPD,
+        NODECOMM,
 
         LAST_ACCESS_TYPE,
     };
@@ -371,6 +372,26 @@ namespace DeviceFW
             static_cast<uint64_t>(( i_gpio_portAddr ))
 
     /**
+     * Construct the device addressing parameters for the Node Comm device ops.
+     * @param[in] i_mode        Either ABUS or XBUS mode - see node_comm_modes_t
+     *                          enum defined in nodecommif.H.
+     * @param[in] i_link_id     The Link Id used for routing the message.
+     *                          MAX values for ABUS and XBUS mode are defined in
+     *                          nodecommif.H.
+     * @param[in] i_mailbox_id  Tha Mailbox Id used for routing the message.
+     *                          NOTE: Only "0" or "1" are supported.
+     *
+     * @note      This interface only supports the reading and writing of
+     *            8 bytes (64 bits) per operation. Anything else will fail.
+     */
+    #define DEVICE_NODECOMM_ADDRESS( i_mode, i_link_id, i_mailbox_id )  \
+        DeviceFW::NODECOMM,\
+            static_cast<uint64_t>(( i_mode )),\
+            static_cast<uint64_t>(( i_link_id )),\
+            static_cast<uint64_t>(( i_mailbox_id ))
+
+
+    /**
      *  @brief Perform a hardware read operation.
      *
      *  @param[in]     i_target     Device target to operate on.