path: root/mboxd_msg.h
diff options
authorSuraj Jitindar Singh <>2017-03-28 10:47:43 +1100
committerSuraj Jitindar Singh <>2017-04-11 11:41:54 +1000
commite39c91637337fc1afc54fe8e215f1493395601a3 (patch)
tree0af6bb466ed1ca0afcb03e568a3a98da5723c06d /mboxd_msg.h
parent2dff340a846068f33a0de171a75d4187bc189ea3 (diff)
mboxd: Update mboxd to implement protocol V2 and add dbus support
Version 2 of the mbox protocol contains a few changes such as: - All sizes are in block size - Adds an erase command - Adds new response codes - Adds new BMC events - Open windows commands now take a size directive Update the mailbox daemon to support version 2 of the protocol which includes implementing all of the V2 functionality. Also entirely refactor the mboxd.c code to make it more modular improving readability and maintainability. At the same time improve the functionality by adding: - Multiple windows in the daemon (still only one active window) to cache flash contents - Implement a dbus interface to allow interaction with the daemon - Handle sigterm and sigint and terminate cleanly The previous implementation utilised the entire reserved memory region. Update the daemon so that on the command line the number of windows and the size of each which the reserved memory region will be split into can be specified. The reserved memory region is then divided between the windows, however there can still only be one "active" window at a time. The daemon uses these windows to cache the flash contents meaning the flash doesn't have to be copied when the host requests access assuming the daemon already has a copy. A dbus interface is added so that commands can be sent to the daemon to control it's operation from the bmc. These include suspending and resuming the daemon to synchronise flash access, telling the daemon to point the lpc mapping back to flash and telling the daemon when the flash has been modified out from under it. Signed-off-by: Suraj Jitindar Singh <> Change-Id: I10be01a395c2bec437cf2c825fdd144580b60dbc
Diffstat (limited to 'mboxd_msg.h')
1 files changed, 44 insertions, 0 deletions
diff --git a/mboxd_msg.h b/mboxd_msg.h
new file mode 100644
index 0000000..44a2f91
--- /dev/null
+++ b/mboxd_msg.h
@@ -0,0 +1,44 @@
+ * Copyright 2016 IBM
+ *
+ * Licensed 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
+ *
+ *
+ *
+ * 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.
+ *
+ */
+#ifndef MBOXD_MSG_H
+#define MBOXD_MSG_H
+#define NO_BMC_EVENT false
+#define SET_BMC_EVENT true
+struct mbox_msg {
+ uint8_t command;
+ uint8_t seq;
+ uint8_t args[MBOX_ARGS_BYTES];
+ uint8_t response;
+union mbox_regs {
+ char raw[MBOX_REG_BYTES];
+ struct mbox_msg msg;
+int set_bmc_events(struct mbox_context *context, uint8_t bmc_event,
+ bool write_back);
+int clr_bmc_events(struct mbox_context *context, uint8_t bmc_event,
+ bool write_back);
+int dispatch_mbox(struct mbox_context *context);
+int init_mbox_dev(struct mbox_context *context);
+void free_mbox_dev(struct mbox_context *context);
+#endif /* MBOXD_MSG_H */
OpenPOWER on IntegriCloud